@voyantjs/legal 0.3.0 → 0.4.0

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,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAoBjE,KAAK,GAAG,GAAG;IACT,SAAS,EAAE;QACT,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAMD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAqP7B,CAAA;AAEJ,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAO9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAkB9B,CAAA;AAEJ,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,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,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,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;CAC3C;AASD,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA+Q7E;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAA+B,CAAA;AAEhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoC1C;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

@@ -1,224 +1,282 @@
 import { Hono } from "hono";
 import { contractsService } from "./service.js";
-import { contractListQuerySchema, contractTemplateListQuerySchema, insertContractAttachmentSchema, insertContractNumberSeriesSchema, insertContractSchema, insertContractSignatureSchema, insertContractTemplateSchema, insertContractTemplateVersionSchema, renderTemplateInputSchema, updateContractAttachmentSchema, updateContractNumberSeriesSchema, updateContractSchema, updateContractTemplateSchema, } from "./validation.js";
-// ============================================================================
-// Contracts admin routes — `/v1/admin/contracts/*`
-// ============================================================================
-export const contractsAdminRoutes = new Hono()
-    // ---------- templates ----------
-    .get("/templates", async (c) => {
-    const query = contractTemplateListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
-    return c.json(await contractsService.listTemplates(c.get("db"), query));
-})
-    .post("/templates", async (c) => {
-    const row = await contractsService.createTemplate(c.get("db"), insertContractTemplateSchema.parse(await c.req.json()));
-    return c.json({ data: row }, 201);
-})
-    .get("/templates/:id", async (c) => {
-    const row = await contractsService.getTemplateById(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Template not found" }, 404);
-    return c.json({ data: row });
-})
-    .patch("/templates/:id", async (c) => {
-    const row = await contractsService.updateTemplate(c.get("db"), c.req.param("id"), updateContractTemplateSchema.parse(await c.req.json()));
-    if (!row)
-        return c.json({ error: "Template not found" }, 404);
-    return c.json({ data: row });
-})
-    .delete("/templates/:id", async (c) => {
-    const row = await contractsService.deleteTemplate(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Template not found" }, 404);
-    return c.json({ success: true });
-})
-    .post("/templates/:id/preview", async (c) => {
-    const input = renderTemplateInputSchema.parse(await c.req.json());
-    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;
-    const bodyFormat = input.bodyFormat ?? template.bodyFormat;
-    const rendered = contractsService.renderPreview({ ...input, body, bodyFormat });
-    return c.json({ data: { rendered, bodyFormat } });
-})
-    // ---------- template versions ----------
-    .get("/templates/:id/versions", async (c) => {
-    const rows = await contractsService.listTemplateVersions(c.get("db"), c.req.param("id"));
-    return c.json({ data: rows });
-})
-    .post("/templates/:id/versions", async (c) => {
-    const version = await contractsService.createTemplateVersion(c.get("db"), c.req.param("id"), insertContractTemplateVersionSchema.parse(await c.req.json()));
-    if (!version)
-        return c.json({ error: "Template not found" }, 404);
-    return c.json({ data: version }, 201);
-})
-    .get("/template-versions/:id", async (c) => {
-    const row = await contractsService.getTemplateVersionById(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Template version not found" }, 404);
-    return c.json({ data: row });
-})
-    // ---------- number series ----------
-    .get("/number-series", async (c) => {
-    const rows = await contractsService.listSeries(c.get("db"));
-    return c.json({ data: rows });
-})
-    .post("/number-series", async (c) => {
-    const row = await contractsService.createSeries(c.get("db"), insertContractNumberSeriesSchema.parse(await c.req.json()));
-    return c.json({ data: row }, 201);
-})
-    .get("/number-series/:id", async (c) => {
-    const row = await contractsService.getSeriesById(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Series not found" }, 404);
-    return c.json({ data: row });
-})
-    .patch("/number-series/:id", async (c) => {
-    const row = await contractsService.updateSeries(c.get("db"), c.req.param("id"), updateContractNumberSeriesSchema.parse(await c.req.json()));
-    if (!row)
-        return c.json({ error: "Series not found" }, 404);
-    return c.json({ data: row });
-})
-    .delete("/number-series/:id", async (c) => {
-    const row = await contractsService.deleteSeries(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Series not found" }, 404);
-    return c.json({ success: true });
-})
-    // ---------- contracts ----------
-    .get("/", async (c) => {
-    const query = contractListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
-    return c.json(await contractsService.listContracts(c.get("db"), query));
-})
-    .post("/", async (c) => {
-    const row = await contractsService.createContract(c.get("db"), insertContractSchema.parse(await c.req.json()));
-    return c.json({ data: row }, 201);
-})
-    .get("/:id", async (c) => {
-    const row = await contractsService.getContractById(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Contract not found" }, 404);
-    return c.json({ data: row });
-})
-    .patch("/:id", async (c) => {
-    const row = await contractsService.updateContract(c.get("db"), c.req.param("id"), updateContractSchema.parse(await c.req.json()));
-    if (!row)
-        return c.json({ error: "Contract not found" }, 404);
-    return c.json({ data: row });
-})
-    .delete("/:id", async (c) => {
-    const result = await contractsService.deleteContract(c.get("db"), c.req.param("id"));
-    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 deleted" }, 409);
-    }
-    return c.json({ success: true });
-})
-    // ---------- lifecycle ----------
-    .post("/:id/issue", async (c) => {
-    const result = await contractsService.issueContract(c.get("db"), c.req.param("id"));
-    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 issued" }, 409);
-    }
-    return c.json({ data: result.contract });
-})
-    .post("/:id/send", async (c) => {
-    const result = await contractsService.sendContract(c.get("db"), c.req.param("id"));
-    if (result.status === "not_found")
-        return c.json({ error: "Contract not found" }, 404);
-    if (result.status === "not_issued") {
-        return c.json({ error: "Only issued/sent contracts can be sent" }, 409);
-    }
-    return c.json({ data: result.contract });
-})
-    .post("/:id/sign", async (c) => {
-    const input = insertContractSignatureSchema.parse(await c.req.json());
-    const result = await contractsService.signContract(c.get("db"), c.req.param("id"), input);
-    if (result.status === "not_found")
-        return c.json({ error: "Contract not found" }, 404);
-    if (result.status === "not_signable") {
-        return c.json({ error: "Contract is not in a signable state" }, 409);
-    }
-    return c.json({ data: { contract: result.contract, signature: result.signature } });
-})
-    .post("/:id/execute", async (c) => {
-    const result = await contractsService.executeContract(c.get("db"), c.req.param("id"));
-    if (result.status === "not_found")
-        return c.json({ error: "Contract not found" }, 404);
-    if (result.status === "not_signed") {
-        return c.json({ error: "Only signed contracts can be executed" }, 409);
-    }
-    return c.json({ data: result.contract });
-})
-    .post("/:id/void", async (c) => {
-    const result = await contractsService.voidContract(c.get("db"), c.req.param("id"));
-    if (result.status === "not_found")
-        return c.json({ error: "Contract not found" }, 404);
-    if (result.status === "already_void") {
-        return c.json({ error: "Contract is already void" }, 409);
-    }
-    return c.json({ data: result.contract });
-})
-    .post("/:id/render", async (c) => {
-    const input = renderTemplateInputSchema.parse(await c.req.json());
-    const contract = await contractsService.getContractById(c.get("db"), c.req.param("id"));
-    if (!contract)
-        return c.json({ error: "Contract not found" }, 404);
-    const rendered = contractsService.renderPreview(input);
-    return c.json({ data: { rendered } });
-})
-    // ---------- signatures ----------
-    .get("/:id/signatures", async (c) => {
-    const rows = await contractsService.listSignatures(c.get("db"), c.req.param("id"));
-    return c.json({ data: rows });
-})
-    // ---------- attachments ----------
-    .get("/:id/attachments", async (c) => {
-    const rows = await contractsService.listAttachments(c.get("db"), c.req.param("id"));
-    return c.json({ data: rows });
-})
-    .post("/:id/attachments", async (c) => {
-    const row = await contractsService.createAttachment(c.get("db"), c.req.param("id"), insertContractAttachmentSchema.parse(await c.req.json()));
-    if (!row)
-        return c.json({ error: "Contract not found" }, 404);
-    return c.json({ data: row }, 201);
-})
-    .patch("/attachments/:attachmentId", async (c) => {
-    const row = await contractsService.updateAttachment(c.get("db"), c.req.param("attachmentId"), updateContractAttachmentSchema.parse(await c.req.json()));
-    if (!row)
-        return c.json({ error: "Attachment not found" }, 404);
-    return c.json({ data: row });
-})
-    .delete("/attachments/:attachmentId", async (c) => {
-    const row = await contractsService.deleteAttachment(c.get("db"), c.req.param("attachmentId"));
-    if (!row)
-        return c.json({ error: "Attachment not found" }, 404);
-    return c.json({ success: true });
-});
-// ============================================================================
-// Contracts public routes — `/v1/public/contracts/*`
-// Customer-facing: fetch own contract + self-sign
-// ============================================================================
-export const contractsPublicRoutes = new Hono()
-    .get("/:id", async (c) => {
-    const row = await contractsService.getContractById(c.get("db"), c.req.param("id"));
-    if (!row)
-        return c.json({ error: "Contract not found" }, 404);
-    // Public view: omit sensitive metadata
-    const { metadata: _metadata, ...publicContract } = row;
-    return c.json({ data: publicContract });
-})
-    .post("/:id/sign", async (c) => {
-    const input = insertContractSignatureSchema.parse(await c.req.json());
-    const result = await contractsService.signContract(c.get("db"), c.req.param("id"), input);
-    if (result.status === "not_found")
-        return c.json({ error: "Contract not found" }, 404);
-    if (result.status === "not_signable") {
-        return c.json({ error: "Contract is not in a signable state" }, 409);
-    }
-    return c.json({ data: { signature: result.signature } });
-});
+import { contractListQuerySchema, contractTemplateDefaultQuerySchema, contractTemplateListQuerySchema, generateContractDocumentInputSchema, insertContractAttachmentSchema, insertContractNumberSeriesSchema, insertContractSchema, insertContractSignatureSchema, insertContractTemplateSchema, insertContractTemplateVersionSchema, publicRenderTemplatePreviewInputSchema, renderTemplateInputSchema, updateContractAttachmentSchema, updateContractNumberSeriesSchema, updateContractSchema, updateContractTemplateSchema, } from "./validation.js";
+function resolveDocumentGenerator(options, bindings) {
+    return options?.resolveDocumentGenerator?.(bindings) ?? options?.documentGenerator;
+}
+export function createContractsAdminRoutes(options = {}) {
+    return new Hono()
+        .get("/templates", async (c) => {
+        const query = contractTemplateListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+        return c.json(await contractsService.listTemplates(c.get("db"), query));
+    })
+        .get("/templates/default", async (c) => {
+        const query = contractTemplateDefaultQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+        const row = await contractsService.getDefaultTemplate(c.get("db"), query);
+        if (!row)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ data: row });
+    })
+        .post("/templates", async (c) => {
+        const row = await contractsService.createTemplate(c.get("db"), insertContractTemplateSchema.parse(await c.req.json()));
+        return c.json({ data: row }, 201);
+    })
+        .get("/templates/:id", async (c) => {
+        const row = await contractsService.getTemplateById(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ data: row });
+    })
+        .patch("/templates/:id", async (c) => {
+        const row = await contractsService.updateTemplate(c.get("db"), c.req.param("id"), updateContractTemplateSchema.parse(await c.req.json()));
+        if (!row)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ data: row });
+    })
+        .delete("/templates/:id", async (c) => {
+        const row = await contractsService.deleteTemplate(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ success: true });
+    })
+        .post("/templates/:id/preview", async (c) => {
+        const input = renderTemplateInputSchema.parse(await c.req.json());
+        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;
+        const bodyFormat = input.bodyFormat ?? template.bodyFormat;
+        const rendered = contractsService.renderPreview({ ...input, body, bodyFormat });
+        return c.json({ data: { rendered, bodyFormat } });
+    })
+        .get("/templates/:id/versions", async (c) => {
+        const rows = await contractsService.listTemplateVersions(c.get("db"), c.req.param("id"));
+        return c.json({ data: rows });
+    })
+        .post("/templates/:id/versions", async (c) => {
+        const version = await contractsService.createTemplateVersion(c.get("db"), c.req.param("id"), insertContractTemplateVersionSchema.parse(await c.req.json()));
+        if (!version)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ data: version }, 201);
+    })
+        .get("/template-versions/:id", async (c) => {
+        const row = await contractsService.getTemplateVersionById(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Template version not found" }, 404);
+        return c.json({ data: row });
+    })
+        .get("/number-series", async (c) => {
+        const rows = await contractsService.listSeries(c.get("db"));
+        return c.json({ data: rows });
+    })
+        .post("/number-series", async (c) => {
+        const row = await contractsService.createSeries(c.get("db"), insertContractNumberSeriesSchema.parse(await c.req.json()));
+        return c.json({ data: row }, 201);
+    })
+        .get("/number-series/:id", async (c) => {
+        const row = await contractsService.getSeriesById(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Series not found" }, 404);
+        return c.json({ data: row });
+    })
+        .patch("/number-series/:id", async (c) => {
+        const row = await contractsService.updateSeries(c.get("db"), c.req.param("id"), updateContractNumberSeriesSchema.parse(await c.req.json()));
+        if (!row)
+            return c.json({ error: "Series not found" }, 404);
+        return c.json({ data: row });
+    })
+        .delete("/number-series/:id", async (c) => {
+        const row = await contractsService.deleteSeries(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Series not found" }, 404);
+        return c.json({ success: true });
+    })
+        .get("/", async (c) => {
+        const query = contractListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+        return c.json(await contractsService.listContracts(c.get("db"), query));
+    })
+        .post("/", async (c) => {
+        const row = await contractsService.createContract(c.get("db"), insertContractSchema.parse(await c.req.json()));
+        return c.json({ data: row }, 201);
+    })
+        .get("/:id", async (c) => {
+        const row = await contractsService.getContractById(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Contract not found" }, 404);
+        return c.json({ data: row });
+    })
+        .patch("/:id", async (c) => {
+        const row = await contractsService.updateContract(c.get("db"), c.req.param("id"), updateContractSchema.parse(await c.req.json()));
+        if (!row)
+            return c.json({ error: "Contract not found" }, 404);
+        return c.json({ data: row });
+    })
+        .delete("/:id", async (c) => {
+        const result = await contractsService.deleteContract(c.get("db"), c.req.param("id"));
+        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 deleted" }, 409);
+        }
+        return c.json({ success: true });
+    })
+        .post("/:id/issue", async (c) => {
+        const result = await contractsService.issueContract(c.get("db"), c.req.param("id"));
+        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 issued" }, 409);
+        }
+        return c.json({ data: result.contract });
+    })
+        .post("/:id/send", async (c) => {
+        const result = await contractsService.sendContract(c.get("db"), c.req.param("id"));
+        if (result.status === "not_found")
+            return c.json({ error: "Contract not found" }, 404);
+        if (result.status === "not_issued") {
+            return c.json({ error: "Only issued/sent contracts can be sent" }, 409);
+        }
+        return c.json({ data: result.contract });
+    })
+        .post("/:id/sign", async (c) => {
+        const input = insertContractSignatureSchema.parse(await c.req.json());
+        const result = await contractsService.signContract(c.get("db"), c.req.param("id"), input);
+        if (result.status === "not_found")
+            return c.json({ error: "Contract not found" }, 404);
+        if (result.status === "not_signable") {
+            return c.json({ error: "Contract is not in a signable state" }, 409);
+        }
+        return c.json({ data: { contract: result.contract, signature: result.signature } });
+    })
+        .post("/:id/execute", async (c) => {
+        const result = await contractsService.executeContract(c.get("db"), c.req.param("id"));
+        if (result.status === "not_found")
+            return c.json({ error: "Contract not found" }, 404);
+        if (result.status === "not_signed") {
+            return c.json({ error: "Only signed contracts can be executed" }, 409);
+        }
+        return c.json({ data: result.contract });
+    })
+        .post("/:id/void", async (c) => {
+        const result = await contractsService.voidContract(c.get("db"), c.req.param("id"));
+        if (result.status === "not_found")
+            return c.json({ error: "Contract not found" }, 404);
+        if (result.status === "already_void") {
+            return c.json({ error: "Contract is already void" }, 409);
+        }
+        return c.json({ data: result.contract });
+    })
+        .post("/:id/render", async (c) => {
+        const input = renderTemplateInputSchema.parse(await c.req.json());
+        const contract = await contractsService.getContractById(c.get("db"), c.req.param("id"));
+        if (!contract)
+            return c.json({ error: "Contract not found" }, 404);
+        const rendered = contractsService.renderPreview(input);
+        return c.json({ data: { rendered } });
+    })
+        .post("/:id/generate-document", async (c) => {
+        const generator = resolveDocumentGenerator(options, c.env);
+        if (!generator) {
+            return c.json({ error: "Contract document generator is not configured" }, 501);
+        }
+        const result = await contractsService.generateContractDocument(c.get("db"), c.req.param("id"), generateContractDocumentInputSchema.parse(await c.req.json().catch(() => ({}))), { generator, bindings: c.env });
+        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 }, 201);
+    })
+        .post("/:id/regenerate-document", async (c) => {
+        const generator = resolveDocumentGenerator(options, c.env);
+        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"), generateContractDocumentInputSchema.parse(await c.req.json().catch(() => ({}))), { generator, bindings: c.env });
+        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 });
+    })
+        .get("/:id/signatures", async (c) => {
+        const rows = await contractsService.listSignatures(c.get("db"), c.req.param("id"));
+        return c.json({ data: rows });
+    })
+        .get("/:id/attachments", async (c) => {
+        const rows = await contractsService.listAttachments(c.get("db"), c.req.param("id"));
+        return c.json({ data: rows });
+    })
+        .post("/:id/attachments", async (c) => {
+        const row = await contractsService.createAttachment(c.get("db"), c.req.param("id"), insertContractAttachmentSchema.parse(await c.req.json()));
+        if (!row)
+            return c.json({ error: "Contract not found" }, 404);
+        return c.json({ data: row }, 201);
+    })
+        .patch("/attachments/:attachmentId", async (c) => {
+        const row = await contractsService.updateAttachment(c.get("db"), c.req.param("attachmentId"), updateContractAttachmentSchema.parse(await c.req.json()));
+        if (!row)
+            return c.json({ error: "Attachment not found" }, 404);
+        return c.json({ data: row });
+    })
+        .delete("/attachments/:attachmentId", async (c) => {
+        const row = await contractsService.deleteAttachment(c.get("db"), c.req.param("attachmentId"));
+        if (!row)
+            return c.json({ error: "Attachment not found" }, 404);
+        return c.json({ success: true });
+    });
+}
+export const contractsAdminRoutes = createContractsAdminRoutes();
+export function createContractsPublicRoutes() {
+    return new Hono()
+        .get("/templates/default", async (c) => {
+        const query = contractTemplateDefaultQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+        const row = await contractsService.getDefaultTemplate(c.get("db"), query);
+        if (!row)
+            return c.json({ error: "Template not found" }, 404);
+        return c.json({ data: row });
+    })
+        .post("/templates/:id/preview", async (c) => {
+        const input = publicRenderTemplatePreviewInputSchema.parse(await c.req.json());
+        const template = await contractsService.getTemplateById(c.get("db"), c.req.param("id"));
+        if (!template?.active)
+            return c.json({ error: "Template not found" }, 404);
+        const rendered = contractsService.renderPreview({
+            variables: input.variables,
+            body: template.body,
+            bodyFormat: template.bodyFormat,
+        });
+        return c.json({ data: { rendered, bodyFormat: template.bodyFormat } });
+    })
+        .get("/:id", async (c) => {
+        const row = await contractsService.getContractById(c.get("db"), c.req.param("id"));
+        if (!row)
+            return c.json({ error: "Contract not found" }, 404);
+        const { metadata: _metadata, ...publicContract } = row;
+        return c.json({ data: publicContract });
+    })
+        .post("/:id/sign", async (c) => {
+        const input = insertContractSignatureSchema.parse(await c.req.json());
+        const result = await contractsService.signContract(c.get("db"), c.req.param("id"), input);
+        if (result.status === "not_found")
+            return c.json({ error: "Contract not found" }, 404);
+        if (result.status === "not_signable") {
+            return c.json({ error: "Contract is not in a signable state" }, 409);
+        }
+        return c.json({ data: { signature: result.signature } });
+    });
+}
+export const contractsPublicRoutes = createContractsPublicRoutes();

package/dist/contracts/service-documents.d.ts

@@ -0,0 +1,66 @@
+import type { StorageProvider, StorageUploadBody } from "@voyantjs/voyant-storage";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { contractAttachments, contracts, contractTemplateVersions } from "./schema.js";
+import type { GenerateContractDocumentInput } from "./validation.js";
+export interface GeneratedContractDocumentArtifact {
+    kind?: string | null;
+    name: string;
+    mimeType?: string | null;
+    fileSize?: number | null;
+    storageKey?: string | null;
+    checksum?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+export interface ContractDocumentGeneratorContext {
+    db: PostgresJsDatabase;
+    contract: typeof contracts.$inferSelect;
+    templateVersion: typeof contractTemplateVersions.$inferSelect | null;
+    renderedBody: string;
+    renderedBodyFormat: "markdown" | "html" | "lexical_json";
+    variables: Record<string, unknown>;
+    bindings: Record<string, unknown>;
+}
+export type ContractDocumentGenerator = (context: ContractDocumentGeneratorContext) => Promise<GeneratedContractDocumentArtifact>;
+export interface ContractDocumentRuntimeOptions {
+    bindings?: Record<string, unknown>;
+    generator: ContractDocumentGenerator;
+}
+export interface StorageBackedContractDocumentUpload {
+    body: StorageUploadBody;
+    name?: string | null;
+    mimeType?: string | null;
+    key?: string | null;
+    metadata?: Record<string, unknown> | null;
+    kind?: string | null;
+}
+export type StorageBackedContractDocumentSerializer = (context: ContractDocumentGeneratorContext) => Promise<StorageBackedContractDocumentUpload> | StorageBackedContractDocumentUpload;
+export interface StorageBackedContractDocumentGeneratorOptions {
+    storage: StorageProvider;
+    keyPrefix?: string | ((context: ContractDocumentGeneratorContext) => Promise<string> | string);
+    serializer?: StorageBackedContractDocumentSerializer;
+    signedUrlExpiresIn?: number;
+}
+export interface GeneratedContractDocumentRecord {
+    contractId: string;
+    contractStatus: (typeof contracts.$inferSelect)["status"];
+    renderedBodyFormat: "markdown" | "html" | "lexical_json";
+    renderedBody: string;
+    attachment: typeof contractAttachments.$inferSelect;
+}
+export declare function defaultStorageBackedContractDocumentSerializer(context: ContractDocumentGeneratorContext): StorageBackedContractDocumentUpload;
+export declare function defaultPdfContractDocumentSerializer(context: ContractDocumentGeneratorContext): Promise<StorageBackedContractDocumentUpload>;
+export declare function createStorageBackedContractDocumentGenerator(options: StorageBackedContractDocumentGeneratorOptions): ContractDocumentGenerator;
+export declare function createPdfContractDocumentGenerator(options: Omit<StorageBackedContractDocumentGeneratorOptions, "serializer">): ContractDocumentGenerator;
+export declare const contractDocumentsService: {
+    generateContractDocument(db: PostgresJsDatabase, contractId: string, input: GenerateContractDocumentInput, runtime: ContractDocumentRuntimeOptions): Promise<{
+        status: "not_found" | "not_draft" | "render_unavailable" | "generator_failed";
+    } | ({
+        status: "generated";
+    } & GeneratedContractDocumentRecord)>;
+    regenerateContractDocument(db: PostgresJsDatabase, contractId: string, input: GenerateContractDocumentInput, runtime: ContractDocumentRuntimeOptions): Promise<{
+        status: "not_found" | "not_draft" | "render_unavailable" | "generator_failed";
+    } | ({
+        status: "generated";
+    } & GeneratedContractDocumentRecord)>;
+};
+//# sourceMappingURL=service-documents.d.ts.map

package/dist/contracts/service-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-documents.d.ts","sourceRoot":"","sources":["../../src/contracts/service-documents.ts"],"names":[],"mappings":"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"}