@voyant-travel/inventory 0.1.0

package/dist/routes-core.d.ts

@@ -0,0 +1,331 @@
+import type { Env } from "./route-env.js";
+export declare const productCoreRoutes: import("hono/hono-base").HonoBase<Env, {
+    "/aggregates": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    total: number;
+                    countsByStatus: {
+                        status: "draft" | "active" | "archived";
+                        count: number;
+                    }[];
+                    active: number;
+                    publicActive: number;
+                    monthlyCreatedCounts: {
+                        yearMonth: string;
+                        count: number;
+                    }[];
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    status: "draft" | "active" | "archived";
+                    description: string | null;
+                    inclusionsHtml: string | null;
+                    exclusionsHtml: string | null;
+                    termsHtml: string | null;
+                    termsShowOnContract: boolean;
+                    bookingMode: "date" | "date_time" | "open" | "stay" | "transfer" | "itinerary" | "other";
+                    capacityMode: "free_sale" | "limited" | "on_request";
+                    timezone: string | null;
+                    defaultLanguageTag: string | null;
+                    visibility: "public" | "private" | "hidden";
+                    activated: boolean;
+                    reservationTimeoutMinutes: number | null;
+                    sellCurrency: string;
+                    sellAmountCents: number | null;
+                    costAmountCents: number | null;
+                    marginPercent: number | null;
+                    facilityId: string | null;
+                    supplierId: string | null;
+                    startDate: string | null;
+                    endDate: string | null;
+                    pax: number | null;
+                    productTypeId: string | null;
+                    contractTemplateId: string | null;
+                    taxClassId: string | null;
+                    customerPaymentPolicy: import("hono/utils/types").JSONValue;
+                    tags: string[] | null;
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/": {
+        $post: {
+            input: {};
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    status: "draft" | "active" | "archived";
+                    description: string | null;
+                    inclusionsHtml: string | null;
+                    exclusionsHtml: string | null;
+                    termsHtml: string | null;
+                    termsShowOnContract: boolean;
+                    bookingMode: "date" | "date_time" | "open" | "stay" | "transfer" | "itinerary" | "other";
+                    capacityMode: "free_sale" | "limited" | "on_request";
+                    timezone: string | null;
+                    defaultLanguageTag: string | null;
+                    visibility: "public" | "private" | "hidden";
+                    activated: boolean;
+                    reservationTimeoutMinutes: number | null;
+                    sellCurrency: string;
+                    sellAmountCents: number | null;
+                    costAmountCents: number | null;
+                    marginPercent: number | null;
+                    facilityId: string | null;
+                    supplierId: string | null;
+                    startDate: string | null;
+                    endDate: string | null;
+                    pax: number | null;
+                    productTypeId: string | null;
+                    contractTemplateId: string | null;
+                    taxClassId: string | null;
+                    customerPaymentPolicy: import("hono/utils/types").JSONValue;
+                    tags: string[] | null;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    productType: {
+                        id: string;
+                        name: string;
+                        code: string;
+                    } | null;
+                    id: string;
+                    name: string;
+                    status: "draft" | "active" | "archived";
+                    description: string | null;
+                    inclusionsHtml: string | null;
+                    exclusionsHtml: string | null;
+                    termsHtml: string | null;
+                    termsShowOnContract: boolean;
+                    bookingMode: "date" | "date_time" | "open" | "stay" | "transfer" | "itinerary" | "other";
+                    capacityMode: "free_sale" | "limited" | "on_request";
+                    timezone: string | null;
+                    defaultLanguageTag: string | null;
+                    visibility: "public" | "private" | "hidden";
+                    activated: boolean;
+                    reservationTimeoutMinutes: number | null;
+                    sellCurrency: string;
+                    sellAmountCents: number | null;
+                    costAmountCents: number | null;
+                    marginPercent: number | null;
+                    facilityId: string | null;
+                    supplierId: string | null;
+                    startDate: string | null;
+                    endDate: string | null;
+                    pax: number | null;
+                    productTypeId: string | null;
+                    contractTemplateId: string | null;
+                    taxClassId: string | null;
+                    customerPaymentPolicy: import("hono/utils/types").JSONValue;
+                    tags: string[] | null;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:id/action-ledger": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    principalSubtype: string | null;
+                    sessionId: string | null;
+                    apiTokenId: string | null;
+                    callerType: string | null;
+                    organizationId: string | null;
+                    workflowRunId: string | null;
+                    workflowStepId: string | null;
+                    id: string;
+                    status: "requested" | "awaiting_approval" | "approved" | "denied" | "succeeded" | "failed" | "reversed" | "compensated" | "expired" | "cancelled" | "superseded";
+                    actionName: string;
+                    actionVersion: string;
+                    actionKind: "create" | "update" | "delete" | "duplicate" | "read" | "execute" | "approve" | "reject" | "reverse" | "compensate";
+                    evaluatedRisk: "low" | "medium" | "high" | "critical";
+                    actorType: string | null;
+                    principalType: "user" | "api_key" | "agent" | "workflow" | "system";
+                    principalId: string;
+                    internalRequest: boolean;
+                    delegatedByPrincipalType: "user" | "api_key" | "agent" | "workflow" | "system" | null;
+                    delegatedByPrincipalId: string | null;
+                    delegationId: string | null;
+                    routeOrToolName: string | null;
+                    correlationId: string | null;
+                    causationActionId: string | null;
+                    idempotencyScope: string | null;
+                    idempotencyKey: string | null;
+                    idempotencyFingerprint: string | null;
+                    targetType: string;
+                    targetId: string;
+                    capabilityId: string | null;
+                    capabilityVersion: string | null;
+                    authorizationSource: string | null;
+                    approvalId: string | null;
+                    amendsActionId: string | null;
+                    occurredAt: string;
+                    createdAt: string;
+                    mutationSummary: string | null;
+                }[];
+                pageInfo: {
+                    nextCursor: {
+                        occurredAt: string;
+                        id: string;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:id": {
+        $patch: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    name: string;
+                    status: "draft" | "active" | "archived";
+                    description: string | null;
+                    inclusionsHtml: string | null;
+                    exclusionsHtml: string | null;
+                    termsHtml: string | null;
+                    termsShowOnContract: boolean;
+                    bookingMode: "date" | "date_time" | "open" | "stay" | "transfer" | "itinerary" | "other";
+                    capacityMode: "free_sale" | "limited" | "on_request";
+                    timezone: string | null;
+                    defaultLanguageTag: string | null;
+                    visibility: "public" | "private" | "hidden";
+                    activated: boolean;
+                    reservationTimeoutMinutes: number | null;
+                    sellCurrency: string;
+                    sellAmountCents: number | null;
+                    costAmountCents: number | null;
+                    marginPercent: number | null;
+                    facilityId: string | null;
+                    supplierId: string | null;
+                    startDate: string | null;
+                    endDate: string | null;
+                    pax: number | null;
+                    productTypeId: string | null;
+                    contractTemplateId: string | null;
+                    taxClassId: string | null;
+                    customerPaymentPolicy: import("hono/utils/types").JSONValue;
+                    tags: string[] | null;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:id": {
+        $delete: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                success: true;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/", "/:id">;
+//# sourceMappingURL=routes-core.d.ts.map

package/dist/routes-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-core.d.ts","sourceRoot":"","sources":["../src/routes-core.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAiBzC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6F1B,CAAA"}

package/dist/routes-core.js

@@ -0,0 +1,95 @@
+import { aggregateSnapshotKey, readThroughAggregateSnapshot, } from "@voyant-travel/db/aggregate-snapshots";
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { appendProductMutationLedgerEntry, changedProductFields, listProductActionLedger, } from "./action-ledger.js";
+import { emitProductContentChanged } from "./events.js";
+import { productsService } from "./service.js";
+import * as validation from "./validation.js";
+const DASHBOARD_AGGREGATES_CACHE_CONTROL = "private, max-age=30";
+/** Server-side snapshot TTL — see readThroughAggregateSnapshot (#1629). */
+const DASHBOARD_AGGREGATES_TTL_SECONDS = 60;
+function cacheDashboardAggregates(c) {
+    c.header("Cache-Control", DASHBOARD_AGGREGATES_CACHE_CONTROL);
+    c.header("Vary", "Authorization", { append: true });
+    c.header("Vary", "Cookie", { append: true });
+}
+export const productCoreRoutes = new Hono()
+    // GET /aggregates — dashboard KPIs (before /:id so the matcher doesn't
+    // swallow it). Served from a read-through TTL snapshot (#1629).
+    .get("/aggregates", async (c) => {
+    const query = parseQuery(c, validation.productAggregatesQuerySchema);
+    cacheDashboardAggregates(c);
+    const snapshot = await readThroughAggregateSnapshot(c.get("db"), {
+        key: aggregateSnapshotKey("products", "aggregates", query),
+        ttlSeconds: DASHBOARD_AGGREGATES_TTL_SECONDS,
+        compute: () => productsService.getProductAggregates(c.get("db"), query),
+    });
+    return c.json({ data: snapshot.data });
+})
+    // GET / — List products
+    .get("/", async (c) => {
+    const query = parseQuery(c, validation.productListQuerySchema);
+    return c.json(await productsService.listProducts(c.get("db"), query));
+})
+    // POST / — Create product
+    .post("/", async (c) => {
+    const input = await parseJsonBody(c, validation.insertProductSchema);
+    const row = await productsService.createProduct(c.get("db"), input);
+    await appendProductMutationLedgerEntry(c, {
+        action: "create",
+        productId: row.id,
+        changedFields: changedProductFields(input, null, row),
+    });
+    await c.get("eventBus")?.emit("product.created", { id: row.id });
+    return c.json({ data: row }, 201);
+})
+    // GET /:id — Get single product
+    .get("/:id", async (c) => {
+    const row = await productsService.getProductByIdWithType(c.get("db"), c.req.param("id"));
+    if (!row) {
+        return c.json({ error: "Product not found" }, 404);
+    }
+    return c.json({ data: row });
+})
+    // GET /:id/action-ledger — Product-scoped action timeline
+    .get("/:id/action-ledger", listProductActionLedger)
+    // PATCH /:id — Update product
+    .patch("/:id", async (c) => {
+    const productId = c.req.param("id");
+    const before = await productsService.getProductById(c.get("db"), productId);
+    if (!before) {
+        return c.json({ error: "Product not found" }, 404);
+    }
+    const input = await parseJsonBody(c, validation.updateProductSchema);
+    const row = await productsService.updateProduct(c.get("db"), productId, input);
+    if (!row) {
+        return c.json({ error: "Product not found" }, 404);
+    }
+    await appendProductMutationLedgerEntry(c, {
+        action: "update",
+        productId: row.id,
+        changedFields: changedProductFields(input, before, row),
+    });
+    await c.get("eventBus")?.emit("product.updated", { id: row.id });
+    await emitProductContentChanged(c.get("eventBus"), { id: row.id, axis: "product" });
+    return c.json({ data: row });
+})
+    // DELETE /:id — Delete product
+    .delete("/:id", async (c) => {
+    const productId = c.req.param("id");
+    const before = await productsService.getProductById(c.get("db"), productId);
+    if (!before) {
+        return c.json({ error: "Product not found" }, 404);
+    }
+    const row = await productsService.deleteProduct(c.get("db"), productId);
+    if (!row) {
+        return c.json({ error: "Product not found" }, 404);
+    }
+    await appendProductMutationLedgerEntry(c, {
+        action: "delete",
+        productId: row.id,
+        changedFields: [],
+    });
+    await c.get("eventBus")?.emit("product.deleted", { id: row.id });
+    return c.json({ success: true }, 200);
+});