@voyantjs/extras 0.20.0 → 0.21.0

package/dist/schema-sourced-content.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Extras sourced-content cache. Sibling to the products / cruises /
+ * hospitality / charters variants — same shape, different vertical.
+ *
+ * One row per sourced extra × locale × market. Stores the content the
+ * upstream adapter served via `getContent`, plus the SWR metadata the
+ * read service needs.
+ *
+ * Extras are booking add-ons (optional line items layered on a parent
+ * product). Per `catalog-policy.ts`, extras are a partial-adoption
+ * vertical: they don't appear in the search index, but sourced extras
+ * (e.g. a TUI excursion add-on) still need rich content for the
+ * booking-flow's add-on selection UI. The sourced-content cache covers
+ * exactly that surface.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.2.
+ */
+export type ExtrasSourcedContentFetchStatus = "ok" | "stale" | "error" | "unsupported";
+export declare const EXTRAS_CONTENT_MARKET_ANY = "*";
+export declare const extrasSourcedContentTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "extras_sourced_content";
+    schema: undefined;
+    columns: {
+        entity_id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "entity_id";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        locale: import("drizzle-orm/pg-core").PgColumn<{
+            name: "locale";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        market: import("drizzle-orm/pg-core").PgColumn<{
+            name: "market";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "extras_sourced_content";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        content_schema_version: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content_schema_version";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        returned_locale: import("drizzle-orm/pg-core").PgColumn<{
+            name: "returned_locale";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        machine_translated: import("drizzle-orm/pg-core").PgColumn<{
+            name: "machine_translated";
+            tableName: "extras_sourced_content";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        source_updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source_updated_at";
+            tableName: "extras_sourced_content";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fetched_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetched_at";
+            tableName: "extras_sourced_content";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fresh_until: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fresh_until";
+            tableName: "extras_sourced_content";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        etag: import("drizzle-orm/pg-core").PgColumn<{
+            name: "etag";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fetch_status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetch_status";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: ExtrasSourcedContentFetchStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: ExtrasSourcedContentFetchStatus;
+        }>;
+        fetch_error: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetch_error";
+            tableName: "extras_sourced_content";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type InsertExtrasSourcedContent = typeof extrasSourcedContentTable.$inferInsert;
+export type SelectExtrasSourcedContent = typeof extrasSourcedContentTable.$inferSelect;
+//# sourceMappingURL=schema-sourced-content.d.ts.map

package/dist/schema-sourced-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sourced-content.d.ts","sourceRoot":"","sources":["../src/schema-sourced-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,MAAM,+BAA+B,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAA;AAEtF,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCrC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA;AACtF,MAAM,MAAM,0BAA0B,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA"}

package/dist/schema-sourced-content.js

@@ -0,0 +1,45 @@
+/**
+ * Extras sourced-content cache. Sibling to the products / cruises /
+ * hospitality / charters variants — same shape, different vertical.
+ *
+ * One row per sourced extra × locale × market. Stores the content the
+ * upstream adapter served via `getContent`, plus the SWR metadata the
+ * read service needs.
+ *
+ * Extras are booking add-ons (optional line items layered on a parent
+ * product). Per `catalog-policy.ts`, extras are a partial-adoption
+ * vertical: they don't appear in the search index, but sourced extras
+ * (e.g. a TUI excursion add-on) still need rich content for the
+ * booking-flow's add-on selection UI. The sourced-content cache covers
+ * exactly that surface.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.2.
+ */
+import { boolean, index, jsonb, pgTable, primaryKey, text, timestamp } from "drizzle-orm/pg-core";
+export const EXTRAS_CONTENT_MARKET_ANY = "*";
+export const extrasSourcedContentTable = pgTable("extras_sourced_content", {
+    /** TypeID matching the extras module — `pxtr_*` (product_extras). */
+    entity_id: text("entity_id").notNull(),
+    /** BCP 47 language tag. */
+    locale: text("locale").notNull(),
+    /** Market id, or `'*'` for all-markets. */
+    market: text("market").notNull().default(EXTRAS_CONTENT_MARKET_ANY),
+    payload: jsonb("payload").$type().notNull(),
+    content_schema_version: text("content_schema_version").notNull(),
+    returned_locale: text("returned_locale").notNull(),
+    machine_translated: boolean("machine_translated").notNull().default(false),
+    source_updated_at: timestamp("source_updated_at", { withTimezone: true }),
+    fetched_at: timestamp("fetched_at", { withTimezone: true }).notNull().defaultNow(),
+    fresh_until: timestamp("fresh_until", { withTimezone: true }),
+    etag: text("etag"),
+    fetch_status: text("fetch_status")
+        .$type()
+        .notNull()
+        .default("ok"),
+    fetch_error: text("fetch_error"),
+}, (table) => [
+    primaryKey({ columns: [table.entity_id, table.locale, table.market] }),
+    index("extras_sourced_content_locale_fresh_idx").on(table.locale, table.fresh_until),
+    index("extras_sourced_content_returned_locale_idx").on(table.entity_id, table.returned_locale),
+    index("extras_sourced_content_schema_version_idx").on(table.content_schema_version),
+]);

package/dist/schema.d.ts

@@ -39,6 +39,23 @@ export declare const productExtras: import("drizzle-orm/pg-core").PgTableWithCol
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        supplierId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "supplier_id";
+            tableName: "product_extras";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         code: import("drizzle-orm/pg-core").PgColumn<{
             name: "code";
             tableName: "product_extras";
@@ -95,7 +112,7 @@ export declare const productExtras: import("drizzle-orm/pg-core").PgTableWithCol
             tableName: "product_extras";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "optional" | "required" | "default_selected" | "unavailable";
+            data: "unavailable" | "optional" | "default_selected" | "required";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -342,7 +359,7 @@ export declare const optionExtraConfigs: import("drizzle-orm/pg-core").PgTableWi
             tableName: "option_extra_configs";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "optional" | "required" | "default_selected" | "unavailable";
+            data: "unavailable" | "optional" | "default_selected" | "required";
             driverParam: string;
             notNull: false;
             hasDefault: false;
@@ -674,7 +691,7 @@ export declare const bookingExtras: import("drizzle-orm/pg-core").PgTableWithCol
             tableName: "booking_extras";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "draft" | "selected" | "confirmed" | "cancelled" | "fulfilled";
+            data: "confirmed" | "cancelled" | "draft" | "selected" | "fulfilled";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -930,4 +947,5 @@ export declare const bookingExtrasRelations: import("drizzle-orm").Relations<"bo
     productExtra: import("drizzle-orm").One<"product_extras", false>;
     optionExtraConfig: import("drizzle-orm").One<"option_extra_configs", false>;
 }>;
+export { EXTRAS_CONTENT_MARKET_ANY, type ExtrasSourcedContentFetchStatus, extrasSourcedContentTable, type InsertExtrasSourcedContent, type SelectExtrasSourcedContent, } from "./schema-sourced-content.js";
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,sBAAsB,mGAKjC,CAAA;AAEF,eAAO,MAAM,oBAAoB,yHAO/B,CAAA;AAEF,eAAO,MAAM,sBAAsB,oGAMjC,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BzB,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC9B,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCzB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC5D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC/D,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAA;AACtE,MAAM,MAAM,oBAAoB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAA;AACzE,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC5D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAE/D,eAAO,MAAM,sBAAsB;;;EAGhC,CAAA;AAEH,eAAO,MAAM,2BAA2B;;;EAMrC,CAAA;AAEH,eAAO,MAAM,sBAAsB;;;EAShC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,sBAAsB,mGAKjC,CAAA;AAEF,eAAO,MAAM,oBAAoB,yHAO/B,CAAA;AAEF,eAAO,MAAM,sBAAsB,oGAMjC,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCzB,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC9B,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCzB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC5D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC/D,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAA;AACtE,MAAM,MAAM,oBAAoB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAA;AACzE,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAC5D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAA;AAE/D,eAAO,MAAM,sBAAsB;;;EAGhC,CAAA;AAEH,eAAO,MAAM,2BAA2B;;;EAMrC,CAAA;AAEH,eAAO,MAAM,sBAAsB;;;EAShC,CAAA;AAKH,OAAO,EACL,yBAAyB,EACzB,KAAK,+BAA+B,EACpC,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAA"}

package/dist/schema.js

@@ -25,6 +25,7 @@ export const bookingExtraStatusEnum = pgEnum("booking_extra_status", [
 export const productExtras = pgTable("product_extras", {
     id: typeId("product_extras"),
     productId: text("product_id").notNull(),
+    supplierId: text("supplier_id"),
     code: text("code"),
     name: text("name").notNull(),
     description: text("description"),
@@ -42,6 +43,7 @@ export const productExtras = pgTable("product_extras", {
 }, (table) => [
     index("idx_product_extras_sort_name").on(table.sortOrder, table.name),
     index("idx_product_extras_product_sort_name").on(table.productId, table.sortOrder, table.name),
+    index("idx_product_extras_supplier_sort_name").on(table.supplierId, table.sortOrder, table.name),
     index("idx_product_extras_active_sort_name").on(table.active, table.sortOrder, table.name),
     uniqueIndex("uidx_product_extras_product_code").on(table.productId, table.code),
 ]);
@@ -124,3 +126,7 @@ export const bookingExtrasRelations = relations(bookingExtras, ({ one }) => ({
         references: [optionExtraConfigs.id],
     }),
 }));
+// ─── Sourced-content cache ──────────────────────────────────────────
+// Re-exported here so templates pick it up via the package's `./schema`
+// entry without needing a separate config entry.
+export { EXTRAS_CONTENT_MARKET_ANY, extrasSourcedContentTable, } from "./schema-sourced-content.js";

package/dist/service-catalog-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-catalog-plane.d.ts","sourceRoot":"","sources":["../src/service-catalog-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAU3C;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,aAAa,CAAC,YAAY,EACtC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B9B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,aAAa,CAAC,YAAY,EACvC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,UAAU,CAMZ;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,aAAa,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,aAAa,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,EACtD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,0BAA0B,GAAG;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GACpE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,CAUzD;AAMD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,eAAe,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,CAarD;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,eAAe,CAYjB;AAED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,GACd,CAAA"}
+{"version":3,"file":"service-catalog-plane.d.ts","sourceRoot":"","sources":["../src/service-catalog-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAU3C;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,aAAa,CAAC,YAAY,EACtC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA6B9B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,aAAa,CAAC,YAAY,EACvC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,UAAU,CAMZ;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,aAAa,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,aAAa,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,EACtD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,0BAA0B,GAAG;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GACpE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,CAUzD;AAMD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,eAAe,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,CAarD;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,eAAe,CAYjB;AAED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,GACd,CAAA"}

package/dist/service-catalog-plane.js

@@ -43,6 +43,7 @@ export function productExtraRowToProjection(row, context) {
         ["id", row.id],
         ["code", row.code],
         ["productId", row.productId],
+        ["supplierId", row.supplierId],
         ["createdAt", row.createdAt],
         ["updatedAt", row.updatedAt],
         // Snapshot-relevant managed fields

package/dist/service-content-synthesizer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Extras content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `ExtraContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Sub-options render as a typed
+ * empty state unless the projection genuinely carries them.
+ *
+ * Per §3.6: never invents plausible-but-unverified fields, never
+ * machine-translates, never mines snapshots, never caches its own
+ * output.
+ */
+import { type ProvenanceReadResult } from "@voyantjs/catalog";
+import type { AnyDrizzleDb } from "@voyantjs/db";
+import { type ExtraContent } from "./content-shape.js";
+export interface SynthesizeExtraContentOptions {
+    provenance: Extract<ProvenanceReadResult, {
+        kind: "sourced";
+    }>;
+    overlays?: ReadonlyArray<{
+        field_path: string;
+        value: unknown;
+    }>;
+}
+export interface SynthesizedExtraContent {
+    content: ExtraContent;
+    content_schema_version: string;
+    served_locale: string;
+    source_kind: string;
+    source_provider?: string;
+}
+export declare function synthesizeExtraContent(scope: {
+    locale: string;
+}, options: SynthesizeExtraContentOptions): SynthesizedExtraContent;
+export declare function synthesizeExtraContentFromDb(db: AnyDrizzleDb, scope: {
+    locale: string;
+}, provenance: Extract<ProvenanceReadResult, {
+    kind: "sourced";
+}>): Promise<SynthesizedExtraContent>;
+//# sourceMappingURL=service-content-synthesizer.d.ts.map

package/dist/service-content-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content-synthesizer.d.ts","sourceRoot":"","sources":["../src/service-content-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,YAAY,CAAA;IACrB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,OAAO,EAAE,6BAA6B,GACrC,uBAAuB,CAiCzB;AAED,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7D,OAAO,CAAC,uBAAuB,CAAC,CAOlC"}

package/dist/service-content-synthesizer.js

@@ -0,0 +1,138 @@
+/**
+ * Extras content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `ExtraContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Sub-options render as a typed
+ * empty state unless the projection genuinely carries them.
+ *
+ * Per §3.6: never invents plausible-but-unverified fields, never
+ * machine-translates, never mines snapshots, never caches its own
+ * output.
+ */
+import { fetchOverlaysForEntity, mergeOverlaysIntoContent, } from "@voyantjs/catalog";
+import { EXTRAS_CONTENT_SCHEMA_VERSION, extraContentSchema, } from "./content-shape.js";
+export function synthesizeExtraContent(scope, options) {
+    const projection = options.provenance.projection;
+    const extra = pickExtraSummary(projection, options.provenance);
+    const media = pickMedia(projection);
+    const policies = pickPolicies(projection);
+    const baseContent = {
+        extra,
+        options: [],
+        media,
+        policies,
+    };
+    let merged = baseContent;
+    if (options.overlays && options.overlays.length > 0) {
+        const result = mergeOverlaysIntoContent(baseContent, options.overlays, {
+            validate(p) {
+                const r = extraContentSchema.safeParse(p);
+                return r.success
+                    ? { valid: true }
+                    : { valid: false, reason: r.error.issues[0]?.message ?? "invalid" };
+            },
+        });
+        merged = extraContentSchema.parse(result);
+    }
+    return {
+        content: merged,
+        content_schema_version: EXTRAS_CONTENT_SCHEMA_VERSION,
+        served_locale: scope.locale,
+        source_kind: options.provenance.provenance.source_kind,
+        source_provider: options.provenance.provenance.source_provider,
+    };
+}
+export async function synthesizeExtraContentFromDb(db, scope, provenance) {
+    const entityId = entityIdFromProvenance(provenance);
+    const overlays = await fetchOverlaysForEntity(db, "extras", entityId);
+    return synthesizeExtraContent(scope, {
+        provenance,
+        overlays: overlays.map((o) => ({ field_path: o.field_path, value: o.value })),
+    });
+}
+function entityIdFromProvenance(provenance) {
+    const fromProjection = provenance.projection.id;
+    if (typeof fromProjection === "string" && fromProjection.length > 0) {
+        return fromProjection;
+    }
+    return provenance.entry_id;
+}
+function pickExtraSummary(projection, provenance) {
+    return {
+        id: stringOr(projection.id, "") || provenance.entry_id,
+        name: stringOr(projection.name, "") || stringOr(projection.title, "") || "Unnamed extra",
+        status: stringOr(projection.status, undefined),
+        description: stringOr(projection.description, null),
+        selection_type: stringOr(projection.selection_type, "optional"),
+        pricing_mode: stringOr(projection.pricing_mode, "per_booking"),
+        priced_per_person: typeof projection.priced_per_person === "boolean" ? projection.priced_per_person : undefined,
+        category: stringOr(projection.category, null),
+        hero_image_url: stringOr(projection.hero_image_url, null),
+        highlights: stringArrayOr(projection.highlights, []),
+        supplier: stringOr(projection.supplier, null) ??
+            stringOr(projection.supplier_name, null) ??
+            provenance.provenance.source_provider ??
+            null,
+        duration_minutes: numberOr(projection.duration_minutes, null),
+        requirements_summary: stringOr(projection.requirements_summary, null),
+    };
+}
+function pickMedia(projection) {
+    const heroUrl = stringOr(projection.hero_image_url, null);
+    const out = [];
+    if (heroUrl) {
+        out.push({ url: heroUrl, type: "image", caption: null, alt: null });
+    }
+    const additional = projection.media;
+    if (Array.isArray(additional)) {
+        for (const item of additional) {
+            if (item && typeof item === "object") {
+                const obj = item;
+                const url = stringOr(obj.url, null);
+                if (!url)
+                    continue;
+                out.push({
+                    url,
+                    type: pickMediaType(obj.type),
+                    caption: stringOr(obj.caption, null),
+                    alt: stringOr(obj.alt, null),
+                });
+            }
+        }
+    }
+    return out;
+}
+function pickMediaType(value) {
+    if (value === "video")
+        return "video";
+    if (value === "document")
+        return "document";
+    return "image";
+}
+function pickPolicies(projection) {
+    const out = [];
+    const cancel = stringOr(projection.cancellation_policy, null);
+    if (cancel)
+        out.push({ kind: "cancellation", body: cancel });
+    const payment = stringOr(projection.payment_terms, null);
+    if (payment)
+        out.push({ kind: "payment", body: payment });
+    const requirements = stringOr(projection.requirements, null);
+    if (requirements)
+        out.push({ kind: "requirements", body: requirements });
+    return out;
+}
+function stringOr(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function numberOr(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function stringArrayOr(value, fallback) {
+    if (!Array.isArray(value))
+        return fallback;
+    const out = value.filter((v) => typeof v === "string");
+    return out.length > 0 ? out : fallback;
+}

package/dist/service-content.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Extras content service — `getExtraContent` with locale-resolved
+ * cache reads, SWR refresh, and synthesizer fallback.
+ *
+ * Mirrors `service-content.ts` in the products / cruises / hospitality
+ * / charters packages but extras-shaped. The extras content aggregate
+ * (§3.2 / §3.6) is `{ extra, options[], media[], policies[] }` — one
+ * payload returned by a single getContent. Pricing stays out (volatile-
+ * live, flows through `liveResolve`).
+ *
+ * Extras don't appear in the search index (per the vertical's catalog-
+ * policy.ts), but sourced extras still need rich content for the
+ * booking-flow's add-on selection UI. The cache layer covers exactly
+ * that surface.
+ */
+import { type ContentLocaleResolution, type InvalidateOnDrift, type SourceAdapter, type SourceAdapterContext } from "@voyantjs/catalog";
+import type { SourceAdapterRegistry } from "@voyantjs/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyantjs/db";
+import { type ExtraContent } from "./content-shape.js";
+export interface ExtraContentScope {
+    preferredLocales: ReadonlyArray<string>;
+    market?: string;
+    currency?: string;
+    acceptMachineTranslated?: boolean;
+}
+export interface GetExtraContentOptions {
+    registry: SourceAdapterRegistry;
+    buildAdapterContext?: (adapter: SourceAdapter) => SourceAdapterContext;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+}
+export interface ResolvedExtraContent {
+    content: ExtraContent;
+    resolution: ContentLocaleResolution<{
+        locale: string;
+        payload: ExtraContent;
+    }>;
+    source: "sourced-cache" | "sourced-fresh" | "synthesized";
+    served_stale: boolean;
+    synthesized: boolean;
+    machine_translated: boolean;
+}
+export declare function getExtraContent(db: AnyDrizzleDb, entityId: string, scope: ExtraContentScope, options: GetExtraContentOptions): Promise<ResolvedExtraContent | null>;
+/** Drift event consumer for the extras content cache. Per §3.4.1. */
+export declare const invalidateExtraContentOnDrift: InvalidateOnDrift;
+//# sourceMappingURL=service-content.d.ts.map

package/dist/service-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content.d.ts","sourceRoot":"","sources":["../src/service-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAK5B,KAAK,iBAAiB,EAKtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAA;AAc3B,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,oBAAoB,CAAA;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACzE;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,EAAE,uBAAuB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAA;IAC9E,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,aAAa,CAAA;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA0FtC;AA2ND,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,EAAE,iBAG3C,CAAA"}