@voyantjs/legal 0.46.0 → 0.47.0

package/README.md

@@ -50,6 +50,24 @@ and fallback languages in order, prefers channel-specific defaults over global
 defaults, ignores inactive templates, and falls back to the newest active
 matching template only when no explicit default exists for that selector.
 
+## Contract Document Operations
+
+The contracts route surface exposes stable operations for storefront previews
+and stored document handling:
+
+- `POST /v1/public/legal/contracts/templates/:id/render-preview`
+- `POST /v1/public/legal/contracts/templates/by-slug/:slug/render-preview`
+- `POST /v1/admin/legal/contracts/templates/:id/render-preview`
+- `POST /v1/admin/legal/contracts/:id/attach-document`
+- `POST /v1/admin/legal/contracts/:id/regenerate-pdf`
+
+Preview routes accept `{ variables }` and return only the rendered text. Public
+preview routes require the template to be active. `attach-document` expects a
+multipart `file` field plus optional `name` and `kind`, uploads through the
+configured `documentStorage`, and persists a contract attachment. `regenerate-pdf`
+uses the configured contract document generator and replaces the canonical
+generated document artifact.
+
 ### Policies
 
 - **Policies** (`pol`) — policy definitions by kind (cancellation, payment, T&C, etc.)

package/dist/contracts/routes.d.ts

@@ -258,6 +258,48 @@ export declare function createContractsAdminRoutes(options?: ContractsRouteOptio
             status: 404;
         };
     };
+} & {
+    "/templates/:id/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/templates/:id/versions": {
         $get: {
@@ -1260,6 +1302,85 @@ export declare function createContractsAdminRoutes(options?: ContractsRouteOptio
             status: import("hono/utils/http-status").ContentfulStatusCode;
         };
     };
+} & {
+    "/:id/regenerate-pdf": {
+        $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: 409;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    status: "not_found" | "not_draft" | "render_unavailable" | "generator_failed";
+                } | {
+                    status: "generated";
+                    contractId: string;
+                    contractStatus: "executed" | "void" | "draft" | "issued" | "sent" | "signed" | "expired";
+                    renderedBodyFormat: "markdown" | "html" | "lexical_json";
+                    renderedBody: string;
+                    attachment: {
+                        metadata: import("hono/utils/types").JSONValue;
+                        name: string;
+                        id: string;
+                        createdAt: string;
+                        kind: string;
+                        mimeType: string | null;
+                        fileSize: number | null;
+                        storageKey: string | null;
+                        checksum: string | null;
+                        contractId: string;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
 } & {
     "/:id/signatures": {
         $get: {
@@ -1385,6 +1506,37 @@ export declare function createContractsAdminRoutes(options?: ContractsRouteOptio
             status: import("hono/utils/http-status").StatusCode;
         };
     };
+} & {
+    "/:id/attach-document": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: Promise<void>;
+            outputFormat: "json";
+            status: import("hono/utils/http-status").StatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+        };
+    };
 } & {
     "/attachments/:attachmentId": {
         $patch: {
@@ -1753,6 +1905,48 @@ export declare const contractsAdminRoutes: import("hono/hono-base").HonoBase<Env
             status: 404;
         };
     };
+} & {
+    "/templates/:id/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/templates/:id/versions": {
         $get: {
@@ -2755,6 +2949,85 @@ export declare const contractsAdminRoutes: import("hono/hono-base").HonoBase<Env
             status: import("hono/utils/http-status").ContentfulStatusCode;
         };
     };
+} & {
+    "/:id/regenerate-pdf": {
+        $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: 409;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 502;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    status: "not_found" | "not_draft" | "render_unavailable" | "generator_failed";
+                } | {
+                    status: "generated";
+                    contractId: string;
+                    contractStatus: "executed" | "void" | "draft" | "issued" | "sent" | "signed" | "expired";
+                    renderedBodyFormat: "markdown" | "html" | "lexical_json";
+                    renderedBody: string;
+                    attachment: {
+                        metadata: import("hono/utils/types").JSONValue;
+                        name: string;
+                        id: string;
+                        createdAt: string;
+                        kind: string;
+                        mimeType: string | null;
+                        fileSize: number | null;
+                        storageKey: string | null;
+                        checksum: string | null;
+                        contractId: string;
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
 } & {
     "/:id/signatures": {
         $get: {
@@ -2880,6 +3153,37 @@ export declare const contractsAdminRoutes: import("hono/hono-base").HonoBase<Env
             status: import("hono/utils/http-status").StatusCode;
         };
     };
+} & {
+    "/:id/attach-document": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: Promise<void>;
+            outputFormat: "json";
+            status: import("hono/utils/http-status").StatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+        };
+    };
 } & {
     "/attachments/:attachmentId": {
         $patch: {
@@ -3085,6 +3389,48 @@ export declare function createContractsPublicRoutes(): import("hono/hono-base").
             status: 404;
         };
     };
+} & {
+    "/templates/:id/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/templates/by-slug/:slug/preview": {
         $post: {
@@ -3127,6 +3473,48 @@ export declare function createContractsPublicRoutes(): import("hono/hono-base").
             status: 404;
         };
     };
+} & {
+    "/templates/by-slug/:slug/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/:id": {
         $get: {
@@ -3309,6 +3697,48 @@ export declare const contractsPublicRoutes: import("hono/hono-base").HonoBase<En
             status: 404;
         };
     };
+} & {
+    "/templates/:id/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/templates/by-slug/:slug/preview": {
         $post: {
@@ -3351,6 +3781,48 @@ export declare const contractsPublicRoutes: import("hono/hono-base").HonoBase<En
             status: 404;
         };
     };
+} & {
+    "/templates/by-slug/:slug/render-preview": {
+        $post: {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+                issues: {
+                    message: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                data: {
+                    rendered: string;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
 } & {
     "/:id": {
         $get: {

package/dist/contracts/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/contracts/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAUjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAoB/C,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,yBAAyB,GAAG,UAAU,CAChD,OAAO,gBAAgB,CAAC,wBAAwB,CACjD,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;AAEjB,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,yBAAyB,CAAA;IAC7C,wBAAwB,CAAC,EAAE,CACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,yBAAyB,GAAG,SAAS,CAAA;IAC1C,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACxC,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;IAClG,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;CAC9E;AAkHD,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6V7E;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAA+B,CAAA;AAEhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6D1C;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAgC,CAAA;AAElE,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAC9D,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/contracts/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAUjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAoB/C,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,yBAAyB,GAAG,UAAU,CAChD,OAAO,gBAAgB,CAAC,wBAAwB,CACjD,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;AAEjB,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,yBAAyB,CAAA;IAC7C,wBAAwB,CAAC,EAAE,CACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,yBAAyB,GAAG,SAAS,CAAA;IAC1C,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACxC,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;IAClG,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;CAC9E;AA+ND,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA+S7E;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAA+B,CAAA;AAEhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmC1C;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAgC,CAAA;AAElE,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAC9D,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}

package/dist/contracts/routes.js

@@ -87,6 +87,93 @@ async function parseAttachmentUploadRequest(c) {
     }
     return { form, file };
 }
+async function renderAdminTemplatePreview(c) {
+    const id = c.req.param("id");
+    if (!id)
+        return c.json({ error: "Template not found" }, 404);
+    const input = await parseJsonBody(c, renderTemplateInputSchema);
+    const template = await contractsService.getTemplateById(c.get("db"), id);
+    if (!template)
+        return c.json({ error: "Template not found" }, 404);
+    const body = input.body ?? template.body;
+    return renderPreviewResponse(c, { ...input, body });
+}
+async function renderPublicTemplatePreview(c) {
+    const id = c.req.param("id");
+    if (!id)
+        return c.json({ error: "Template not found" }, 404);
+    const input = await parseJsonBody(c, publicRenderTemplatePreviewInputSchema);
+    const template = await contractsService.getTemplateById(c.get("db"), id);
+    if (!template?.active)
+        return c.json({ error: "Template not found" }, 404);
+    return renderPreviewResponse(c, {
+        variables: input.variables,
+        body: template.body,
+    });
+}
+async function renderPublicTemplatePreviewBySlug(c) {
+    const slug = c.req.param("slug");
+    if (!slug)
+        return c.json({ error: "Template not found" }, 404);
+    const input = await parseJsonBody(c, publicRenderTemplatePreviewInputSchema);
+    const template = await contractsService.findTemplateBySlug(c.get("db"), slug);
+    if (!template?.active)
+        return c.json({ error: "Template not found" }, 404);
+    return renderPreviewResponse(c, {
+        variables: input.variables,
+        body: template.body,
+    }, {
+        template: {
+            id: template.id,
+            slug: template.slug,
+            name: template.name,
+            language: template.language,
+            scope: template.scope,
+        },
+    });
+}
+async function uploadContractAttachment(c, options, contractId) {
+    const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
+    const storage = runtime.documentStorage;
+    if (!storage) {
+        return c.json({ error: "Contract document storage is not configured" }, 501);
+    }
+    const contract = await contractsService.getContractById(c.get("db"), contractId);
+    if (!contract)
+        return c.json({ error: "Contract not found" }, 404);
+    const parsed = await parseAttachmentUploadRequest(c);
+    if ("error" in parsed)
+        return parsed.error;
+    const row = await contractsService.createAttachment(c.get("db"), contractId, await buildUploadedAttachmentInput({
+        storage,
+        contractId,
+        form: parsed.form,
+        file: parsed.file,
+    }));
+    if (!row)
+        return c.json({ error: "Contract not found" }, 404);
+    return c.json({ data: row }, 201);
+}
+async function regenerateContractDocument(c, options, contractId) {
+    const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
+    const generator = runtime.documentGenerator;
+    if (!generator) {
+        return c.json({ error: "Contract document generator is not configured" }, 501);
+    }
+    const result = await contractsService.regenerateContractDocument(c.get("db"), contractId, await parseOptionalJsonBody(c, generateContractDocumentInputSchema), { generator, bindings: c.env, eventBus: runtime.eventBus });
+    if (result.status === "not_found")
+        return c.json({ error: "Contract not found" }, 404);
+    if (result.status === "not_draft") {
+        return c.json({ error: "Only draft contracts can be auto-issued for document generation" }, 409);
+    }
+    if (result.status === "render_unavailable") {
+        return c.json({ error: "Contract has no renderable body or template version" }, 409);
+    }
+    if (result.status === "generator_failed") {
+        return c.json({ error: "Contract document generation failed" }, 502);
+    }
+    return c.json({ data: result });
+}
 export function createContractsAdminRoutes(options = {}) {
     return new Hono()
         .get("/templates", async (c) => {
@@ -122,14 +209,8 @@ export function createContractsAdminRoutes(options = {}) {
             return c.json({ error: "Template not found" }, 404);
         return c.json({ success: true });
     })
-        .post("/templates/:id/preview", async (c) => {
-        const input = await parseJsonBody(c, renderTemplateInputSchema);
-        const template = await contractsService.getTemplateById(c.get("db"), c.req.param("id"));
-        if (!template)
-            return c.json({ error: "Template not found" }, 404);
-        const body = input.body ?? template.body;
-        return renderPreviewResponse(c, { ...input, body });
-    })
+        .post("/templates/:id/preview", renderAdminTemplatePreview)
+        .post("/templates/:id/render-preview", renderAdminTemplatePreview)
         .get("/templates/:id/versions", async (c) => {
         const rows = await contractsService.listTemplateVersions(c.get("db"), c.req.param("id"));
         return c.json({ data: rows });
@@ -275,24 +356,10 @@ export function createContractsAdminRoutes(options = {}) {
         return c.json({ data: result }, 201);
     })
         .post("/:id/regenerate-document", async (c) => {
-        const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
-        const generator = runtime.documentGenerator;
-        if (!generator) {
-            return c.json({ error: "Contract document generator is not configured" }, 501);
-        }
-        const result = await contractsService.regenerateContractDocument(c.get("db"), c.req.param("id"), await parseOptionalJsonBody(c, generateContractDocumentInputSchema), { generator, bindings: c.env, eventBus: runtime.eventBus });
-        if (result.status === "not_found")
-            return c.json({ error: "Contract not found" }, 404);
-        if (result.status === "not_draft") {
-            return c.json({ error: "Only draft contracts can be auto-issued for document generation" }, 409);
-        }
-        if (result.status === "render_unavailable") {
-            return c.json({ error: "Contract has no renderable body or template version" }, 409);
-        }
-        if (result.status === "generator_failed") {
-            return c.json({ error: "Contract document generation failed" }, 502);
-        }
-        return c.json({ data: result });
+        return regenerateContractDocument(c, options, c.req.param("id"));
+    })
+        .post("/:id/regenerate-pdf", async (c) => {
+        return regenerateContractDocument(c, options, c.req.param("id"));
     })
         .get("/:id/signatures", async (c) => {
         const rows = await contractsService.listSignatures(c.get("db"), c.req.param("id"));
@@ -309,23 +376,10 @@ export function createContractsAdminRoutes(options = {}) {
         return c.json({ data: row }, 201);
     })
         .post("/:id/attachments/upload", async (c) => {
-        const runtime = getRuntime(options, c.env, (key) => c.var.container?.resolve(key));
-        const storage = runtime.documentStorage;
-        if (!storage) {
-            return c.json({ error: "Contract document storage is not configured" }, 501);
-        }
-        const parsed = await parseAttachmentUploadRequest(c);
-        if ("error" in parsed)
-            return parsed.error;
-        const row = await contractsService.createAttachment(c.get("db"), c.req.param("id"), await buildUploadedAttachmentInput({
-            storage,
-            contractId: c.req.param("id"),
-            form: parsed.form,
-            file: parsed.file,
-        }));
-        if (!row)
-            return c.json({ error: "Contract not found" }, 404);
-        return c.json({ data: row }, 201);
+        return uploadContractAttachment(c, options, c.req.param("id"));
+    })
+        .post("/:id/attach-document", async (c) => {
+        return uploadContractAttachment(c, options, c.req.param("id"));
     })
         .patch("/attachments/:attachmentId", async (c) => {
         const row = await contractsService.updateAttachment(c.get("db"), c.req.param("attachmentId"), await parseJsonBody(c, updateContractAttachmentSchema));
@@ -397,40 +451,16 @@ export function createContractsPublicRoutes() {
             return c.json({ error: "Template not found" }, 404);
         return c.json({ data: row });
     })
-        .post("/templates/:id/preview", async (c) => {
-        const input = await parseJsonBody(c, publicRenderTemplatePreviewInputSchema);
-        const template = await contractsService.getTemplateById(c.get("db"), c.req.param("id"));
-        if (!template?.active)
-            return c.json({ error: "Template not found" }, 404);
-        return renderPreviewResponse(c, {
-            variables: input.variables,
-            body: template.body,
-        });
-    })
+        .post("/templates/:id/preview", renderPublicTemplatePreview)
+        .post("/templates/:id/render-preview", renderPublicTemplatePreview)
         /**
          * Slug-based variant — storefronts wire products to a contract
          * template via slug at config time, not id, so they can render the
          * preview in the booking journey before any contract row exists.
          * The dialog at /shop/book/... POSTs here with the draft variables.
          */
-        .post("/templates/by-slug/:slug/preview", async (c) => {
-        const input = await parseJsonBody(c, publicRenderTemplatePreviewInputSchema);
-        const template = await contractsService.findTemplateBySlug(c.get("db"), c.req.param("slug"));
-        if (!template?.active)
-            return c.json({ error: "Template not found" }, 404);
-        return renderPreviewResponse(c, {
-            variables: input.variables,
-            body: template.body,
-        }, {
-            template: {
-                id: template.id,
-                slug: template.slug,
-                name: template.name,
-                language: template.language,
-                scope: template.scope,
-            },
-        });
-    })
+        .post("/templates/by-slug/:slug/preview", renderPublicTemplatePreviewBySlug)
+        .post("/templates/by-slug/:slug/render-preview", renderPublicTemplatePreviewBySlug)
         .get("/:id", async (c) => {
         const row = await contractsService.getContractById(c.get("db"), c.req.param("id"));
         if (!row)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/legal",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -59,14 +59,14 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/bookings": "0.46.0",
-    "@voyantjs/core": "0.46.0",
-    "@voyantjs/crm": "0.46.0",
-    "@voyantjs/db": "0.46.0",
-    "@voyantjs/hono": "0.46.0",
-    "@voyantjs/suppliers": "0.46.0",
-    "@voyantjs/utils": "0.46.0",
-    "@voyantjs/storage": "0.46.0"
+    "@voyantjs/bookings": "0.47.0",
+    "@voyantjs/core": "0.47.0",
+    "@voyantjs/crm": "0.47.0",
+    "@voyantjs/db": "0.47.0",
+    "@voyantjs/hono": "0.47.0",
+    "@voyantjs/suppliers": "0.47.0",
+    "@voyantjs/utils": "0.47.0",
+    "@voyantjs/storage": "0.47.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",