@voyant-travel/inventory 0.1.0

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

@@ -0,0 +1,254 @@
+/**
+ * Extras sourced-content cache. Sibling to the products / cruises /
+ * accommodations / 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/extras/schema-sourced-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sourced-content.d.ts","sourceRoot":"","sources":["../../src/extras/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/extras/schema-sourced-content.js

@@ -0,0 +1,45 @@
+/**
+ * Extras sourced-content cache. Sibling to the products / cruises /
+ * accommodations / 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),
+]);