@voyant-travel/finance 0.119.5

package/dist/routes-documents.d.ts

@@ -0,0 +1,195 @@
+import type { EventBus, ModuleContainer } from "@voyant-travel/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { financeDocumentsService } from "./service-documents.js";
+type Env = {
+    Bindings: Record<string, unknown>;
+    Variables: {
+        container: ModuleContainer;
+        db: PostgresJsDatabase;
+        userId?: string;
+    };
+};
+export type InvoiceDocumentGenerator = Parameters<typeof financeDocumentsService.generateInvoiceDocument>[3]["generator"];
+export interface FinanceDocumentRouteOptions {
+    invoiceDocumentGenerator?: InvoiceDocumentGenerator;
+    resolveInvoiceDocumentGenerator?: (bindings: Record<string, unknown>) => InvoiceDocumentGenerator | undefined;
+    resolveDocumentDownloadUrl?: (bindings: unknown, storageKey: string) => Promise<string | null> | string | null;
+    eventBus?: EventBus;
+    resolveEventBus?: (bindings: Record<string, unknown>) => EventBus | undefined;
+}
+export declare function createFinanceAdminDocumentRoutes(options?: FinanceDocumentRouteOptions): import("hono/hono-base").HonoBase<Env, {
+    "/invoices/:id/generate-document": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    status: "generated";
+                    invoiceId: string;
+                    renderedBodyFormat: "html" | "markdown" | "lexical_json";
+                    renderedBody: string;
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        errorMessage: string | null;
+                        invoiceId: string;
+                        templateId: string | null;
+                        language: string | null;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        generatedAt: string | null;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/invoices/:id/regenerate-document": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    status: "generated";
+                    invoiceId: string;
+                    renderedBodyFormat: "html" | "markdown" | "lexical_json";
+                    renderedBody: string;
+                    rendition: {
+                        format: "json" | "html" | "pdf" | "xml";
+                        id: string;
+                        createdAt: string;
+                        updatedAt: string;
+                        metadata: import("hono/utils/types").JSONValue;
+                        status: "failed" | "pending" | "ready" | "stale";
+                        errorMessage: string | null;
+                        invoiceId: string;
+                        templateId: string | null;
+                        language: string | null;
+                        storageKey: string | null;
+                        fileSize: number | null;
+                        checksum: string | null;
+                        generatedAt: string | null;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/invoice-renditions/:id/download": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: undefined;
+            outputFormat: "redirect";
+            status: 302;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 501;
+        };
+    };
+}, "/", "/invoice-renditions/:id/download">;
+export {};
+//# sourceMappingURL=routes-documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes-documents.d.ts","sourceRoot":"","sources":["../src/routes-documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAMpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAUjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGhE,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,SAAS,EAAE,eAAe,CAAA;QAC1B,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAC/C,OAAO,uBAAuB,CAAC,uBAAuB,CACvD,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;AAEjB,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,+BAA+B,CAAC,EAAE,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,wBAAwB,GAAG,SAAS,CAAA;IACzC,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;CAC9E;AAaD,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,2BAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAwEzF"}

package/dist/routes-documents.js

@@ -0,0 +1,93 @@
+import { createDrizzlePublicDocumentDeliveryGrantStore, createPublicDocumentDeliveryGrant, parseOptionalJsonBody, } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { resolveStoredDocumentDownload } from "./document-download.js";
+import { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
+import { financeService } from "./service.js";
+import { financeDocumentsService } from "./service-documents.js";
+import { generateInvoiceDocumentInputSchema } from "./validation.js";
+function getRuntime(options, bindings, resolveFromContainer) {
+    return (resolveFromContainer?.(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY) ??
+        buildFinanceRouteRuntime(bindings, options));
+}
+export function createFinanceAdminDocumentRoutes(options = {}) {
+    return new Hono()
+        .post("/invoices/:id/generate-document", async (c) => {
+        const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
+        const generator = runtime.invoiceDocumentGenerator;
+        if (!generator) {
+            return c.json({ error: "Invoice document generator is not configured" }, 501);
+        }
+        const input = await parseOptionalJsonBody(c, generateInvoiceDocumentInputSchema);
+        const result = await financeDocumentsService.generateInvoiceDocument(c.get("db"), c.req.param("id"), input, { generator, bindings: c.env, eventBus: runtime.eventBus });
+        if (result.status === "not_found")
+            return c.json({ error: "Invoice not found" }, 404);
+        if (result.status === "generator_failed") {
+            return c.json({ error: "Invoice document generation failed" }, 502);
+        }
+        if (!("rendition" in result)) {
+            return c.json({ error: "Invoice document generation failed" }, 502);
+        }
+        return c.json({ data: await attachDownloadEnvelope(c, runtime, result, input) }, 201);
+    })
+        .post("/invoices/:id/regenerate-document", async (c) => {
+        const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
+        const generator = runtime.invoiceDocumentGenerator;
+        if (!generator) {
+            return c.json({ error: "Invoice document generator is not configured" }, 501);
+        }
+        const input = await parseOptionalJsonBody(c, generateInvoiceDocumentInputSchema);
+        const result = await financeDocumentsService.regenerateInvoiceDocument(c.get("db"), c.req.param("id"), input, { generator, bindings: c.env, eventBus: runtime.eventBus });
+        if (result.status === "not_found")
+            return c.json({ error: "Invoice not found" }, 404);
+        if (result.status === "generator_failed") {
+            return c.json({ error: "Invoice document generation failed" }, 502);
+        }
+        if (!("rendition" in result)) {
+            return c.json({ error: "Invoice document generation failed" }, 502);
+        }
+        return c.json({ data: await attachDownloadEnvelope(c, runtime, result, input) });
+    })
+        .get("/invoice-renditions/:id/download", async (c) => {
+        const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
+        const rendition = await financeService.getInvoiceRenditionById(c.get("db"), c.req.param("id"));
+        if (!rendition) {
+            return c.json({ error: "Invoice rendition not found" }, 404);
+        }
+        const download = await resolveStoredDocumentDownload(rendition, {
+            bindings: c.env,
+            resolveDocumentDownloadUrl: runtime.resolveDocumentDownloadUrl,
+        });
+        if (download.status === "resolver_not_configured") {
+            return c.json({ error: "Document download resolver is not configured" }, 501);
+        }
+        if (download.status !== "ready") {
+            return c.json({ error: "Invoice document is not available" }, 404);
+        }
+        return c.redirect(download.download.url, 302);
+    });
+}
+async function attachDownloadEnvelope(c, runtime, result, input) {
+    const download = await resolveStoredDocumentDownload(result.rendition, {
+        bindings: c.env,
+        resolveDocumentDownloadUrl: runtime.resolveDocumentDownloadUrl,
+    });
+    const withAdminDownload = download.status === "ready" ? { ...result, download: download.download } : result;
+    if (!input.publicDelivery || !result.rendition.storageKey) {
+        return withAdminDownload;
+    }
+    const publicDownload = await createPublicDocumentDeliveryGrant(createDrizzlePublicDocumentDeliveryGrantStore(c.get("db")), {
+        storageKey: result.rendition.storageKey,
+        publicBaseUrl: new URL(c.req.url).origin,
+        ttlSeconds: input.publicDeliveryTtlSeconds,
+        filename: download.status === "ready" ? download.download.filename : null,
+        contentType: result.rendition.format === "pdf" ? "application/pdf" : null,
+        source: {
+            module: "finance",
+            entity: "invoice_rendition",
+            id: result.rendition.id ?? null,
+        },
+        createdBy: c.get("userId") ?? null,
+        createdByType: c.get("userId") ? "staff" : null,
+    });
+    return { ...withAdminDownload, publicDownload };
+}