Skip to content

Commit

Permalink
updated timestamp comment
Browse files Browse the repository at this point in the history
  • Loading branch information
mo-c4t committed Oct 17, 2024
1 parent 4dbd259 commit ecf9056
Show file tree
Hide file tree
Showing 29 changed files with 140 additions and 35 deletions.
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v1/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,10 @@ message AccommodationProductInfoRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;

// Languages
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v1/list.proto
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ message AccommodationProductListRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v1/property_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,10 @@ import "google/protobuf/timestamp.proto";
message Property {
// Ex: "2023-08-28T12:03:50", specifying when the static data of a product was
// last updated
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 1;

// Supplier product Code
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v2/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,10 @@ message AccommodationProductInfoRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;

// Languages
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v2/list.proto
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ message AccommodationProductListRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/accommodation/v2/property_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,10 @@ import "google/protobuf/timestamp.proto";
message Property {
// Ex: "2023-08-28T12:03:50", specifying when the static data of a product was
// last updated
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 1;

// Supplier product Code
Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/services/activity/v1/activity_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,10 @@ message Activity {

// Ex: "2023-08-28T12:03:50", specifying when the static data of a product was
// last updated
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 2;

// An identifier for external sessions, aiding in tracking and continuity across
Expand Down Expand Up @@ -91,7 +94,10 @@ message PickupDropoffEvent {
string other_info = 4;

// Datetime of the pickup dropoff event as Unix timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp date_time = 5;

// Longitude and Latitude of the location
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/activity/v1/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,10 @@ message ActivityProductInfoRequest {

// Only respond with the products that are new, modified or deactivated after this
// timestamp.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;

// Languages to be included in the response for descriptions. Null means all
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/activity/v1/list.proto
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ message ActivityProductListRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;
}

Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/services/activity/v2/activity_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,10 @@ message Activity {

// Ex: "2023-08-28T12:03:50", specifying when the static data of a product was
// last updated
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 2;

// An identifier for external sessions, aiding in tracking and continuity across
Expand Down Expand Up @@ -91,7 +94,10 @@ message PickupDropoffEvent {
string other_info = 4;

// Datetime of the pickup dropoff event as Unix timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp date_time = 5;

// Longitude and Latitude of the location
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/activity/v2/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,10 @@ message ActivityProductInfoRequest {

// Only respond with the products that are new, modified or deactivated after this
// timestamp.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;

// Languages to be included in the response for descriptions. Null means all
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/activity/v2/list.proto
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ message ActivityProductListRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;
}

Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/services/book/v1/mint.proto
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,10 @@ message MintResponse {
string provider_booking_reference = 4;

// Timestamp of the booking in the inventory system of the supplier.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp provider_booking_timestamp = 5;

// Price of the `BookingToken`. This field is meant to be populated by the
Expand All @@ -74,7 +77,10 @@ message MintResponse {

// On chain booking token should be only buyable until this timestamp and should
// expire after that.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp buyable_until = 9;

// Transaction ID of the buy operation. This field is populated by the distributor
Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/services/book/v2/mint.proto
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,10 @@ message MintResponse {
string provider_booking_reference = 4;

// Timestamp of the booking in the inventory system of the supplier.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp provider_booking_timestamp = 5;

// Price of the `BookingToken`. This field is meant to be populated by the
Expand All @@ -79,7 +82,10 @@ message MintResponse {

// On chain booking token should be only buyable until this timestamp and should
// expire after that.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp buyable_until = 10;

// Transaction ID of the buy operation. This field is populated by the distributor
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/info/v1/entry_requirements.proto
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,10 @@ message CountryEntryRequirementItem {
cmp.services.info.v1.ItemStatus status = 3;

// Significant update date
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_significant_update = 4;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/info/v2/entry_requirements.proto
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,10 @@ message CountryEntryRequirementItem {
cmp.services.info.v2.ItemStatus status = 3;

// Significant update date
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_significant_update = 4;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/insurance/v1/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,10 @@ message InsuranceProductInfoRequest {

// Only respond with the products that are new, modified or deactivated after this
// timestamp.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;

// Languages to be included in the response for descriptions. Null means all
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/insurance/v1/insurance_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,10 @@ message Policy {

// Ex: "2023-08-28T12:03:50", specifying when the static data of a product was
// last updated
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 3;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/insurance/v1/list.proto
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ message InsuranceProductListRequest {
cmp.types.v1.RequestHeader header = 1;

// Only respond with the products that are modified after this timestamp
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp modified_after = 2;
}

Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/services/ping/v1/ping.proto
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,10 @@ message PingRequest {
string ping_message = 2;

// DateTime of the ping request
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp timestamp = 3;
}

Expand All @@ -29,7 +32,10 @@ message PingResponse {
string ping_message = 2;

// DateTime of the ping response
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp timestamp = 3;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/transport/v1/trip_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,10 @@ message Trip {
// Represents a departure or arrival event
message TransitEvent {
// Date time of the event
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp date_time = 1;

// Event location
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/services/transport/v2/trip_types.proto
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,10 @@ message Trip {
// Represents a departure or arrival event
message TransitEvent {
// Date time of the event
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp date_time = 1;

// Event location
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/types/v1/cancel_policy.proto
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,10 @@ message CancelPolicy {

// The "free cancellation upto" identifier specifies the exact DateTime upto when
// this booking can be cancelled free of charge.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp free_cancellation_upto = 2;

// Full cancellation policies can be complex and extensive. Inclusion in search
Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/types/v1/change_policy.proto
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,10 @@ message ChangePolicy {

// The "free change upto" identifier specifies the exact DateTime upto when
// this search result can be changed free of charge.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp free_change_upto = 2;

// Full change policies can be complex and extensive. Inclusion in search
Expand Down
10 changes: 8 additions & 2 deletions proto/cmp/types/v1/datetime_range.proto
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,14 @@ import "google/protobuf/timestamp.proto";
//
// [Open Message Diagram](https://storage.googleapis.com/docs-cmp-files/diagrams/proto/cmp/types/v1/datetime_range.proto.dot.svg)
message DateTimeRange {
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp start_datetime = 1;
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp end_datetime = 2;
}
5 changes: 4 additions & 1 deletion proto/cmp/types/v1/file.proto
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,10 @@ message File {
string url = 2;

// Last modification time
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp last_modified = 3;
}

Expand Down
5 changes: 4 additions & 1 deletion proto/cmp/types/v2/cancel_policy.proto
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,10 @@ message CancelPolicy {

// The "free cancellation upto" identifier specifies the exact DateTime upto when
// this booking can be cancelled free of charge.
// For any on-chain transactions, if applicable, nanoseconds will be ignored
//
// Timestamps may be used for both off-chain and on-chain operations.
// For on-chain operations, only seconds are supported, and nanoseconds
// will be ignored.
google.protobuf.Timestamp free_cancellation_upto = 2;

// Full cancellation policies can be complex and extensive. Inclusion in search
Expand Down
Loading

0 comments on commit ecf9056

Please sign in to comment.