@voyant-travel/inventory 0.5.4 → 0.5.6

package/dist/routes-brochure.js

@@ -17,25 +17,85 @@
  * Keeping these injected means inventory never imports the deployment's R2
  * binding or cloud client.
  */
-import { Hono } from "hono";
+import { createRoute, OpenAPIHono, z } from "@hono/zod-openapi";
+import { openApiValidationHook } from "@voyant-travel/hono";
 import { emitProductContentChanged } from "./events.js";
 import { createDefaultProductBrochureTemplate, generateAndStoreProductBrochure, } from "./tasks/index.js";
 /** 5 MiB cap on a generated brochure PDF before it's rejected with 413. */
 const DEFAULT_MAX_BROCHURE_PDF_BYTES = 5 * 1024 * 1024;
+const errorResponseSchema = z.object({ error: z.string() });
+/**
+ * Generated-brochure row schema, authored from the `product_media`
+ * `$inferSelect` shape (the brochure is persisted via `upsertBrochure`). §17:
+ * timestamp columns serialize to strings over the wire.
+ */
+const brochureMediaSchema = z.object({
+    id: z.string(),
+    productId: z.string(),
+    dayId: z.string().nullable(),
+    mediaType: z.enum(["image", "video", "document"]),
+    name: z.string(),
+    url: z.string(),
+    storageKey: z.string().nullable(),
+    mimeType: z.string().nullable(),
+    fileSize: z.number().nullable(),
+    altText: z.string().nullable(),
+    sortOrder: z.number(),
+    isCover: z.boolean(),
+    isBrochure: z.boolean(),
+    isBrochureCurrent: z.boolean(),
+    brochureVersion: z.number().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+const generateBrochureRoute = createRoute({
+    method: "post",
+    path: "/{id}/brochure/generate",
+    request: { params: z.object({ id: z.string() }) },
+    responses: {
+        200: {
+            description: "The generated + stored brochure with upload metadata",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        data: brochureMediaSchema,
+                        metadata: z.object({
+                            filename: z.string(),
+                            sizeBytes: z.number(),
+                            storageKey: z.string(),
+                            url: z.string(),
+                        }),
+                    }),
+                },
+            },
+        },
+        400: {
+            description: "id route param is required",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
+        413: {
+            description: "Generated brochure exceeds the configured size cap",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
+        503: {
+            description: "Storage not configured",
+            content: { "application/json": { schema: errorResponseSchema } },
+        },
+    },
+});
 /**
  * Build the product brochure route (relative path; mount at
  * `/v1/admin/products`). Storage + the optional printer are injected via
  * `options`.
  */
 export function createProductBrochureRoutes(options) {
-    const hono = new Hono();
     const maxSizeBytes = options.maxSizeBytes ?? DEFAULT_MAX_BROCHURE_PDF_BYTES;
-    hono.post("/:id/brochure/generate", async (c) => {
+    return new OpenAPIHono({ defaultHook: openApiValidationHook }).openapi(generateBrochureRoute, async (c) => {
         const storage = options.resolveStorage(c);
         if (!storage) {
             return c.json({ error: "Storage not configured" }, 503);
         }
-        const productId = c.req.param("id");
+        const productId = c.req.valid("param").id;
         if (!productId)
             return c.json({ error: "id route param is required" }, 400);
         const printer = options.resolvePrinter?.(c) ?? null;
@@ -67,7 +127,6 @@ export function createProductBrochureRoutes(options) {
                 storageKey: generated.storageKey,
                 url: generated.url,
             },
-        });
+        }, 200);
     });
-    return hono;
 }

package/dist/routes-brochure.test.js

@@ -43,7 +43,7 @@ describe("product brochure routes", () => {
             filename: "brochure-prod_1.pdf",
             sizeBytes: 1234,
             storageKey: "brochures/products/prod_1/brochure-prod_1.pdf",
-            url: "/api/v1/media/brochures/products/prod_1/brochure-prod_1.pdf",
+            url: "/api/v1/admin/media/brochures/products/prod_1/brochure-prod_1.pdf",
         });
         const storage = storageStub();
         const app = mountApp(() => storage);