@caronashow/api 0.14.0 → 0.15.0

package/dist/gen/caronashow/service/v1/home_pb.d.ts

@@ -172,9 +172,9 @@ export type MapRideSuggestion = Message<"caronashow.service.v1.MapRideSuggestion
     driverEndpointLocation?: LatLng | undefined;
     /**
      * Safe route path and cache identity used by the map renderer. For the first
-     * outbound release, the path runs from the coarse driver area toward the
-     * organization area. It must not expose the passenger's exact origin or a
-     * raw Pooler stop sequence.
+     * organization-origin release, the path starts at the organization area and
+     * ends at coarse participant home areas. It must not expose any participant's
+     * exact home address or a raw Pooler stop sequence.
      *
      * @generated from field: caronashow.service.v1.RouteGeometry route_geometry = 4;
      */
@@ -355,9 +355,11 @@ export type RankedRideSuggestion = Message<"caronashow.service.v1.RankedRideSugg
      */
     seats?: SeatAvailability | undefined;
     /**
-     * Optional exact organization time when a trusted Backend calculation exists
-     * for a custom schedule. Clients must prefer organization_arrival_window and
-     * hide the schedule when both are absent.
+     * Optional exact organization-local time when a trusted Backend calculation
+     * exists for a custom schedule. For COMMUTE_DIRECTION_FROM_ORGANIZATION,
+     * this is departure from the organization; for TO_ORGANIZATION, it is
+     * arrival at the organization. Clients must prefer
+     * organization_arrival_window and hide the schedule when both are absent.
      *
      * @generated from field: caronashow.types.v1.TimeOfDay organization_time = 7;
      */
@@ -370,11 +372,14 @@ export type RankedRideSuggestion = Message<"caronashow.service.v1.RankedRideSugg
      */
     restrictedToVulnerableGroup: boolean;
     /**
-     * Arrival window associated with the driver's named organization shift. It
-     * is interpreted using organization_time_zone and is the preferred schedule
-     * display for the first outbound release. It is absent for a custom schedule
-     * unless the Backend can derive a meaningful window; clients may use the
-     * exact-time field as a fallback.
+     * Direction-specific organization window associated with the driver's named
+     * organization shift. For COMMUTE_DIRECTION_FROM_ORGANIZATION, this carries
+     * the shift's departure window; for TO_ORGANIZATION, it carries the arrival
+     * window. It is interpreted using organization_time_zone and is the preferred
+     * schedule display for the first organization-origin release. The historical
+     * field name is retained for wire and source compatibility. It is absent for
+     * a custom schedule unless the Backend can derive a meaningful window;
+     * clients may use the exact-time field as a fallback.
      *
      * @generated from field: caronashow.service.v1.TimeWindow organization_arrival_window = 10;
      */
@@ -397,9 +402,11 @@ export type RankedRideSuggestion = Message<"caronashow.service.v1.RankedRideSugg
     routeDurationSeconds?: number | undefined;
     /**
      * Optional finite, nonnegative additional duration incurred by the driver
-     * for this passenger, relative to the driver's direct baseline route to the
-     * organization. The Backend derives it from the same published snapshot; the
-     * browser must not calculate it.
+     * for this passenger, relative to the driver's direct baseline route for the
+     * requested commute direction. For the first supported direction, that route
+     * starts at the organization and ends at the driver's home. The Backend
+     * derives it from the same published snapshot; the browser must not calculate
+     * it.
      *
      * @generated from field: optional double driver_detour_duration_seconds = 13;
      */
@@ -510,15 +517,15 @@ export declare enum CommuteDirection {
      */
     UNSPECIFIED = 0,
     /**
-     * Driver and passenger travel toward the organization. Supported by the
-     * first Backend recommendation release.
+     * Driver and passenger travel toward the organization. Kept in the enum for
+     * forward compatibility; not supported by the first Backend release.
      *
      * @generated from enum value: COMMUTE_DIRECTION_TO_ORGANIZATION = 1;
      */
     TO_ORGANIZATION = 1,
     /**
-     * Driver and passenger leave the organization for their return trip. Kept
-     * for the shared Home model; not supported by the first Backend release.
+     * Driver and passenger leave the organization toward participant home
+     * addresses. Supported by the first Backend recommendation release.
      *
      * @generated from enum value: COMMUTE_DIRECTION_FROM_ORGANIZATION = 2;
      */
@@ -584,9 +591,11 @@ export declare const MatchingService: GenService<{
      * saved Search setup are inferred from the session token.
      *
      * The first Backend recommendation release supports only
-     * COMMUTE_DIRECTION_TO_ORGANIZATION. FROM_ORGANIZATION remains in the enum
-     * for forward compatibility and returns UNIMPLEMENTED until the Backend
-     * dataset and projection support the return direction.
+     * COMMUTE_DIRECTION_FROM_ORGANIZATION. Pooler's production routes start at
+     * the organization and end at participant home addresses. TO_ORGANIZATION
+     * remains in the enum for forward compatibility and returns UNIMPLEMENTED
+     * until the Backend dataset and projection support the toward-organization
+     * direction.
      *
      * Returns UNAUTHENTICATED without a valid session, FAILED_PRECONDITION when
      * the caller has no eligible Search setup, and INVALID_ARGUMENT for an

package/package.json

@@ -3,7 +3,7 @@
   "module": "src/index.ts",
   "main": "dist/index.cjs",
   "types": "dist/index.d.ts",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "CaronaShow API definitions",
   "author": "Lucas Santos <zerowhy.server@protonmail.com>",
   "license": "MIT",