@danceiny/gotry 0.0.1-rc.16 → 0.0.1-rc.18

package/dist/src/booking-surface/canonical-schema.js

@@ -0,0 +1,113 @@
+/**
+ * Runtime projection of the canonical booking.surface.v1 JSON Schema.
+ *
+ * dsh tools need self-contained JSON Schemas, while the canonical document is
+ * organized with local $refs. This helper derives each action branch directly
+ * from those canonical bytes and recursively inlines local references. No
+ * model-facing action schema is maintained by hand.
+ */
+
+import { readFileSync } from 'node:fs'
+
+const schemaUrl = new URL('../../../schemas/booking.surface.v1.schema.json', import.meta.url)
+export const canonicalBookingSurfaceSchemaV1 = JSON.parse(readFileSync(schemaUrl, 'utf8'))
+const schemaV2Url = new URL('../../../schemas/booking.surface.v2.schema.json', import.meta.url)
+export const canonicalBookingSurfaceSchemaV2 = JSON.parse(readFileSync(schemaV2Url, 'utf8'))
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value))
+}
+
+function definitionFromRef(ref, schema) {
+  const prefix = '#/$defs/'
+  if (typeof ref !== 'string') {
+    throw new Error(`booking_schema_external_ref_forbidden:${String(ref)}`)
+  }
+  const externalV1 = 'https://gotry.dev/schemas/booking.surface.v1.schema.json#/$defs/'
+  const definitionSchema = ref.startsWith(prefix) ? schema : ref.startsWith(externalV1) ? canonicalBookingSurfaceSchemaV1 : undefined
+  if (!definitionSchema) throw new Error(`booking_schema_external_ref_forbidden:${String(ref)}`)
+  const name = ref.startsWith(prefix) ? ref.slice(prefix.length) : ref.slice(externalV1.length)
+  const definition = definitionSchema.$defs?.[name]
+  if (!definition) throw new Error(`booking_schema_missing_definition:${name}`)
+  return definition
+}
+
+function inlineLocalRefs(value, schema, stack = []) {
+  if (Array.isArray(value)) return value.map((item) => inlineLocalRefs(item, schema, stack))
+  if (typeof value !== 'object' || value === null) return value
+  if (typeof value.$ref === 'string') {
+    if (stack.includes(value.$ref)) throw new Error(`booking_schema_recursive_ref:${value.$ref}`)
+    const { $ref, ...siblings } = value
+    const definitionSchema = typeof $ref === 'string' && $ref.startsWith('https://gotry.dev/schemas/booking.surface.v1.schema.json#/$defs/') ? canonicalBookingSurfaceSchemaV1 : schema
+    return {
+      ...inlineLocalRefs(definitionFromRef($ref, schema), definitionSchema, [...stack, $ref]),
+      ...inlineLocalRefs(siblings, schema, stack),
+    }
+  }
+  return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, inlineLocalRefs(item, schema, stack)]))
+}
+
+function canonicalActionSchemaForKind(kind, schema, definitionName) {
+  const action = schema.$defs?.[definitionName]
+  if (!action) throw new Error('booking_schema_action_union_missing')
+  if (Array.isArray(action.allOf)) {
+    const branch = action.allOf.find((candidate) => candidate?.if?.properties?.kind?.const === kind)
+    const input = branch?.then?.properties?.input
+    if (!input) throw new Error(`booking_schema_action_kind_missing:${kind}`)
+    return clone(inlineLocalRefs({
+      type: action.type,
+      required: action.required,
+      properties: { ...action.properties, kind: { type: 'string', const: kind }, input },
+      additionalProperties: action.additionalProperties,
+    }, schema))
+  }
+  if (!Array.isArray(action.oneOf)) throw new Error('booking_schema_action_union_missing')
+  const branch = action.oneOf.find((candidate) => candidate?.allOf?.some((part) => part?.properties?.kind?.const === kind))
+  const base = schema.$defs?.ActionBase
+  const input = branch?.allOf?.find((part) => part?.properties?.input)?.properties?.input
+  if (!base || !input) throw new Error(`booking_schema_action_kind_missing:${kind}`)
+  return clone(inlineLocalRefs({
+    ...base,
+    properties: { ...base.properties, kind: { type: 'string', const: kind }, input },
+  }, schema))
+}
+
+export function canonicalBookingActionSchemaForKind(kind) {
+  return canonicalActionSchemaForKind(kind, canonicalBookingSurfaceSchemaV1, 'BookingReadActionV1')
+}
+
+export function canonicalBookingActionSchemaForKindV2(kind) {
+  return canonicalActionSchemaForKind(kind, canonicalBookingSurfaceSchemaV2, 'Action')
+}
+
+const DSH_JSON_SCHEMA_KEYS = new Set([
+  'type', 'oneOf', 'properties', 'required', 'additionalProperties', 'items',
+  'enum', 'const', 'description', 'title', 'default', 'examples',
+])
+
+function projectDshSchema(value) {
+  if (Array.isArray(value)) return value.map(projectDshSchema)
+  if (typeof value !== 'object' || value === null) return value
+  return Object.fromEntries(Object.entries(value)
+    .filter(([key]) => DSH_JSON_SCHEMA_KEYS.has(key))
+    .map(([key, item]) => {
+      if (key === 'properties') {
+        return [key, Object.fromEntries(Object.entries(item).map(([name, property]) => [name, projectDshSchema(property)]))]
+      }
+      return [key, projectDshSchema(item)]
+    }))
+}
+
+/**
+ * dsh-tools intentionally supports a smaller enforced JSON-Schema vocabulary.
+ * Keep the canonical shape/type/enum/closure guarantees at the model seam;
+ * the full canonical AJV validator remains the runtime authority for numeric,
+ * pattern, size and uniqueness constraints before an operation can be issued.
+ */
+export function dshBookingActionSchemaForKind(kind) {
+  return projectDshSchema(canonicalBookingActionSchemaForKind(kind))
+}
+
+export function dshBookingActionSchemaForKindV2(kind) {
+  return projectDshSchema(canonicalBookingActionSchemaForKindV2(kind))
+}

package/dist/src/booking-surface/contracts-v2.js

@@ -0,0 +1,89 @@
+export const BOOKING_SURFACE_SCHEMA_VERSION_V2 = 'booking.surface.v2';
+export const BOOKING_COPILOT_V2_INGRESS_MODES = [
+    'bff-bound-turn-only',
+    'bff-ingress-binding'
+];
+export const BOOKING_COPILOT_V2_ACCEPTED_TURN_KINDS = [
+    'user.turn',
+    'action.receipt.continuation'
+];
+export const BOOKING_COPILOT_V2_INGRESS_TURN_KIND = 'user.turn.ingress';
+export const BOOKING_COPILOT_MAX_OPERATIONS_V2 = 20;
+export const BOOKING_SURFACE_SCHEMA_V2_SHA256 = '45df62db1b19d30a4fd22ddc94eb550e8ff32d8a225558b5ff13ba303588fc03';
+export const BOOKING_READ_ACTION_KINDS_V2 = [
+    'search.patch',
+    'search.run',
+    'results.view.patch',
+    'hotel.focus',
+    'hotel.select',
+    'offers.query',
+    'offers.view.patch',
+    'offers.compare',
+    'offer.select',
+    'offer.check',
+    'checkout.prepare',
+    'order.observe'
+];
+export const BOOKING_SURFACE_ALLOWED_ACTIONS_V2 = {
+    tenant: BOOKING_READ_ACTION_KINDS_V2,
+    customer_portal: BOOKING_READ_ACTION_KINDS_V2,
+    storefront: [
+        'search.patch',
+        'search.run',
+        'results.view.patch',
+        'hotel.focus'
+    ],
+    payment_link: [
+        'search.patch',
+        'search.run',
+        'results.view.patch',
+        'hotel.focus',
+        'hotel.select'
+    ]
+};
+export function bookingSurfaceAllowedActionsV2(surface) {
+    return [
+        ...BOOKING_SURFACE_ALLOWED_ACTIONS_V2[surface]
+    ];
+}
+export const BOOKING_V2_BLOCKER_CODES = [
+    'no_hotels_matched',
+    'hotel_not_visible',
+    'hotel_rates_failed',
+    'criterion_must_not_met',
+    'offer_target_not_reached',
+    'offer_unavailable'
+];
+export const BOOKING_V2_GAP_CODES = [
+    'byos_mapped_risk',
+    'check_avail_failed',
+    'check_avail_unverified',
+    'component_executor_unavailable',
+    'hotel_not_visible',
+    'hotel_rates_failed',
+    'offer_facts_changed',
+    'offer_not_loaded',
+    'offer_unavailable',
+    'order_not_found',
+    'order_outcome_not_observed',
+    'order_state_unknown',
+    'order_status_unavailable',
+    'requested_offers_not_loaded',
+    'search_failed',
+    'search_form_invalid',
+    'search_session_expired',
+    'search_terminal_timeout',
+    'stale_revision',
+    'surface_adapter_failed',
+    'undo_token_not_found',
+    'unhandled',
+    'unsupported',
+    'verified_offer_required',
+    'workspace_changed_during_action',
+    'criterion_must_not_met',
+    'no_hotels_matched',
+    'offer_target_not_reached'
+];
+
+
+//# sourceURL=ts/src/booking-surface/contracts-v2.ts

package/dist/src/booking-surface/contracts.js

@@ -0,0 +1,46 @@
+export const BOOKING_SURFACE_SCHEMA_VERSION = 'booking.surface.v1';
+export const BOOKING_SURFACE_SCHEMA_SHA256 = 'd9c2194ec839bd1168e70e8a201581addc005039d9b299660e20650bbb65df81';
+export const BOOKING_SURFACE_VERSION_HEADER = 'x-booking-surface-version';
+export const BOOKING_SURFACE_SCHEMA_SHA256_HEADER = 'x-booking-surface-schema-sha256';
+export const BOOKING_SURFACES = [
+    'tenant',
+    'customer_portal',
+    'storefront',
+    'payment_link'
+];
+export const BOOKING_READ_ACTION_KINDS = [
+    'search.patch',
+    'search.run',
+    'results.view.patch',
+    'hotel.focus',
+    'hotel.select',
+    'offers.query',
+    'offers.view.patch',
+    'offers.compare',
+    'offer.select',
+    'offer.check',
+    'checkout.prepare',
+    'order.observe'
+];
+export const BOOKING_RECEIPT_STATUSES = [
+    'applied',
+    'needs_input',
+    'partial',
+    'no_match',
+    'unavailable',
+    'changed',
+    'stale',
+    'unsupported',
+    'failed'
+];
+export const BOOKING_SURFACE_EVENT_KINDS = [
+    'status',
+    'question',
+    'operation',
+    'explanation',
+    'terminal',
+    'error'
+];
+
+
+//# sourceURL=ts/src/booking-surface/contracts.ts