@vantageos/convex-doc-forge 0.1.0

package/dist/src/_generated/server.js

@@ -0,0 +1,8 @@
+import { actionGeneric, httpActionGeneric, queryGeneric, mutationGeneric, internalActionGeneric, internalMutationGeneric, internalQueryGeneric, } from "convex/server";
+export const query = queryGeneric;
+export const internalQuery = internalQueryGeneric;
+export const mutation = mutationGeneric;
+export const internalMutation = internalMutationGeneric;
+export const action = actionGeneric;
+export const internalAction = internalActionGeneric;
+export const httpAction = httpActionGeneric;

package/dist/src/actions.d.ts

@@ -0,0 +1,20 @@
+export declare function renderNowHandler(ctx: any, args: {
+    template_id: string;
+    context: unknown;
+    output_format: string;
+    actor: string;
+    source?: "manual" | "workflow" | "agent";
+}): Promise<{
+    output_url: string;
+    render_job_id: string;
+    duration_ms: number;
+    pages?: number;
+}>;
+export declare const render_now: import("convex/server").RegisteredAction<"public", {
+    source?: "manual" | "workflow" | "agent" | undefined;
+    template_id: import("convex/values").GenericId<"templates">;
+    context: any;
+    output_format: string;
+    actor: string;
+}, any>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/src/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AAgCA,wBAAsB,gBAAgB,CAEpC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CAC1C,GACA,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAoID;AAMD,eAAO,MAAM,UAAU;;;;;;OAsBrB,CAAC"}

package/dist/src/actions.js

@@ -0,0 +1,176 @@
+"use node";
+import { v } from "convex/values";
+import { action } from "./_generated/server";
+import { internal } from "./_generated/api";
+// ---------------------------------------------------------------------------
+// SHA-256 helper (Node built-in crypto)
+// ---------------------------------------------------------------------------
+async function sha256hex(input) {
+    const { createHash } = await import("node:crypto");
+    return createHash("sha256").update(input).digest("hex");
+}
+// ---------------------------------------------------------------------------
+// renderNowHandler — exported for unit testing
+// ---------------------------------------------------------------------------
+const SIGNED_URL_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+export async function renderNowHandler(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+ctx, args) {
+    const rendererUrl = process.env.CONVEX_DOC_FORGE_RENDERER_URL;
+    const rendererKey = process.env.CONVEX_DOC_FORGE_RENDERER_KEY;
+    if (!rendererUrl)
+        throw new Error("CONVEX_DOC_FORGE_RENDERER_URL not set");
+    if (!rendererKey)
+        throw new Error("CONVEX_DOC_FORGE_RENDERER_KEY not set");
+    // 1. Load template
+    const template = await ctx.runQuery(internal.queries.get_template, {
+        template_id: args.template_id,
+    });
+    if (template === null)
+        throw new Error("Template not found");
+    if (!template.output_formats.includes(args.output_format)) {
+        throw new Error(`output_format '${args.output_format}' not supported. ` +
+            `Supported: ${template.output_formats.join(", ")}`);
+    }
+    // 2. Get signed URL for the binary asset
+    const assetUrl = await ctx.storage.getUrl(template.asset_storage_id);
+    if (!assetUrl)
+        throw new Error("Asset storage URL unavailable");
+    // 3. Create a queued job
+    const jobId = await ctx.runMutation(internal.mutations.queue_render, {
+        template_id: args.template_id,
+        context: args.context,
+        output_format: args.output_format,
+        createdBy: args.actor,
+    });
+    // 4. Transition to rendering
+    await ctx.runMutation(internal.mutations._set_job_rendering, {
+        job_id: jobId,
+    });
+    const contextHash = await sha256hex(JSON.stringify(args.context));
+    const startTs = Date.now();
+    try {
+        // 5. Call renderer Railway
+        const rendererRes = await fetch(`${rendererUrl}/v1/render`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${rendererKey}`,
+            },
+            body: JSON.stringify({
+                template_url: assetUrl,
+                context: args.context,
+                output_format: args.output_format,
+            }),
+        });
+        if (!rendererRes.ok) {
+            const errText = await rendererRes.text().catch(() => "<no body>");
+            throw new Error(`Renderer returned ${rendererRes.status}: ${errText}`);
+        }
+        const rendererJson = (await rendererRes.json());
+        const duration_ms = rendererJson.duration_ms ?? Date.now() - startTs;
+        // 6. Store output in Convex storage
+        let outputStorageId;
+        let signedUrl;
+        if (rendererJson.output_bytes) {
+            const binaryStr = atob(rendererJson.output_bytes);
+            const bytes = new Uint8Array(binaryStr.length);
+            for (let i = 0; i < binaryStr.length; i++) {
+                bytes[i] = binaryStr.charCodeAt(i);
+            }
+            const mimeType = mimeForFormat(args.output_format);
+            const blob = new Blob([bytes], { type: mimeType });
+            outputStorageId = await ctx.storage.store(blob);
+            const url = await ctx.storage.getUrl(outputStorageId);
+            if (!url)
+                throw new Error("Failed to get signed URL after storage");
+            signedUrl = url;
+        }
+        else if (rendererJson.output_url) {
+            const downloadRes = await fetch(rendererJson.output_url);
+            if (!downloadRes.ok)
+                throw new Error(`Failed to download output from renderer URL: ${downloadRes.status}`);
+            const mimeType = mimeForFormat(args.output_format);
+            const blob = new Blob([await downloadRes.arrayBuffer()], {
+                type: mimeType,
+            });
+            outputStorageId = await ctx.storage.store(blob);
+            const url = await ctx.storage.getUrl(outputStorageId);
+            if (!url)
+                throw new Error("Failed to get signed URL after storage");
+            signedUrl = url;
+        }
+        else {
+            throw new Error("Renderer response missing both output_bytes and output_url");
+        }
+        // 7. Mark job done
+        await ctx.runMutation(internal.mutations._complete_render_job, {
+            job_id: jobId,
+            output_storage_id: outputStorageId,
+        });
+        // 8. Write audit record
+        const expiresAt = Date.now() + SIGNED_URL_TTL_MS;
+        await ctx.runMutation(internal.mutations._write_audit, {
+            render_job_id: jobId,
+            tenant_id: template.tenant_id,
+            template_id: args.template_id,
+            template_version: template.version,
+            context_hash: contextHash,
+            output_signed_url: signedUrl,
+            expires_at: expiresAt,
+            actor: args.actor,
+            source: args.source ?? "manual",
+        });
+        return {
+            output_url: signedUrl,
+            render_job_id: jobId,
+            duration_ms,
+            pages: rendererJson.pages,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        await ctx.runMutation(internal.mutations._fail_render_job, {
+            job_id: jobId,
+            error: message,
+        });
+        throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// Convex registration
+// ---------------------------------------------------------------------------
+export const render_now = action({
+    args: {
+        template_id: v.id("templates"),
+        context: v.any(),
+        output_format: v.string(),
+        actor: v.string(),
+        source: v.optional(v.union(v.literal("manual"), v.literal("workflow"), v.literal("agent"))),
+    },
+    returns: v.object({
+        output_url: v.string(),
+        render_job_id: v.id("render_jobs"),
+        duration_ms: v.number(),
+        pages: v.optional(v.number()),
+    }),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    handler: renderNowHandler,
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function mimeForFormat(format) {
+    switch (format.toLowerCase()) {
+        case "pdf":
+            return "application/pdf";
+        case "docx":
+            return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+        case "pptx":
+            return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+        case "doc":
+            return "application/msword";
+        default:
+            return "application/octet-stream";
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @vantageos/convex-doc-forge — public re-exports.
+ *
+ * Consumer apps import functions via the component API object, not directly.
+ * This barrel is provided for type-only imports.
+ */
+export * from "./queries";
+export * from "./mutations";
+export * from "./actions";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,9 @@
+/**
+ * @vantageos/convex-doc-forge — public re-exports.
+ *
+ * Consumer apps import functions via the component API object, not directly.
+ * This barrel is provided for type-only imports.
+ */
+export * from "./queries";
+export * from "./mutations";
+export * from "./actions";

package/dist/src/mutations.d.ts

@@ -0,0 +1,84 @@
+import type { Id } from "./_generated/dataModel";
+type AnyCtx = any;
+export declare function upsertTemplateHandler(ctx: AnyCtx, args: {
+    name: string;
+    team: string;
+    tenant_id: string;
+    renderer_kind: "docxtpl" | "python-pptx" | "jinja2-html";
+    input_schema: unknown;
+    asset_storage_id: Id<"_storage">;
+    output_formats: string[];
+    metadata?: Record<string, string>;
+    version: string;
+    createdBy: string;
+}): Promise<Id<"templates">>;
+export declare function queueRenderHandler(ctx: AnyCtx, args: {
+    template_id: Id<"templates">;
+    context: unknown;
+    output_format: string;
+    createdBy: string;
+}): Promise<Id<"render_jobs">>;
+export declare function setJobRenderingHandler(ctx: AnyCtx, args: {
+    job_id: Id<"render_jobs">;
+}): Promise<null>;
+export declare function completeRenderJobHandler(ctx: AnyCtx, args: {
+    job_id: Id<"render_jobs">;
+    output_storage_id: Id<"_storage">;
+}): Promise<null>;
+export declare function failRenderJobHandler(ctx: AnyCtx, args: {
+    job_id: Id<"render_jobs">;
+    error: string;
+}): Promise<null>;
+export declare function writeAuditHandler(ctx: AnyCtx, args: {
+    render_job_id: Id<"render_jobs">;
+    tenant_id: string;
+    template_id: Id<"templates">;
+    template_version: string;
+    context_hash: string;
+    output_signed_url: string;
+    expires_at: number;
+    actor: string;
+    source: "manual" | "workflow" | "agent";
+}): Promise<Id<"render_audit">>;
+export declare const upsert_template: import("convex/server").RegisteredMutation<"public", {
+    name: string;
+    team: string;
+    tenant_id: string;
+    renderer_kind: "docxtpl" | "python-pptx" | "jinja2-html";
+    input_schema: unknown;
+    asset_storage_id: Id<"_storage">;
+    output_formats: string[];
+    metadata?: Record<string, string>;
+    version: string;
+    createdBy: string;
+}, Promise<Id<"templates">>>;
+export declare const queue_render: import("convex/server").RegisteredMutation<"public", {
+    template_id: Id<"templates">;
+    context: unknown;
+    output_format: string;
+    createdBy: string;
+}, Promise<Id<"render_jobs">>>;
+export declare const _set_job_rendering: import("convex/server").RegisteredMutation<"internal", {
+    job_id: Id<"render_jobs">;
+}, Promise<null>>;
+export declare const _complete_render_job: import("convex/server").RegisteredMutation<"internal", {
+    job_id: Id<"render_jobs">;
+    output_storage_id: Id<"_storage">;
+}, Promise<null>>;
+export declare const _fail_render_job: import("convex/server").RegisteredMutation<"internal", {
+    job_id: Id<"render_jobs">;
+    error: string;
+}, Promise<null>>;
+export declare const _write_audit: import("convex/server").RegisteredMutation<"internal", {
+    render_job_id: Id<"render_jobs">;
+    tenant_id: string;
+    template_id: Id<"templates">;
+    template_version: string;
+    context_hash: string;
+    output_signed_url: string;
+    expires_at: number;
+    actor: string;
+    source: "manual" | "workflow" | "agent";
+}, Promise<Id<"render_audit">>>;
+export {};
+//# sourceMappingURL=mutations.d.ts.map

package/dist/src/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/mutations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAIjD,KAAK,MAAM,GAAG,GAAG,CAAC;AAMlB,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CA2C1B;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAoB5B;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAA;CAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IAAC,iBAAiB,EAAE,EAAE,CAAC,UAAU,CAAC,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CACzC,GACA,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAK7B;AAMD,eAAO,MAAM,eAAe;UApJlB,MAAM;UACN,MAAM;eACD,MAAM;mBACF,SAAS,GAAG,aAAa,GAAG,aAAa;kBAC1C,OAAO;sBACH,EAAE,CAAC,UAAU,CAAC;oBAChB,MAAM,EAAE;eACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;aACxB,MAAM;eACJ,MAAM;4BA8JnB,CAAC;AAEH,eAAO,MAAM,YAAY;iBA9GR,EAAE,CAAC,WAAW,CAAC;aACnB,OAAO;mBACD,MAAM;eACV,MAAM;8BAoHnB,CAAC;AAEH,eAAO,MAAM,kBAAkB;YA5Fb,EAAE,CAAC,aAAa,CAAC;iBAgGjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;YAxFf,EAAE,CAAC,aAAa,CAAC;uBAAqB,EAAE,CAAC,UAAU,CAAC;iBA+FpE,CAAC;AAEH,eAAO,MAAM,gBAAgB;YAnFX,EAAE,CAAC,aAAa,CAAC;WAAS,MAAM;iBA0FhD,CAAC;AAEH,eAAO,MAAM,YAAY;mBA7EN,EAAE,CAAC,aAAa,CAAC;eACrB,MAAM;iBACJ,EAAE,CAAC,WAAW,CAAC;sBACV,MAAM;kBACV,MAAM;uBACD,MAAM;gBACb,MAAM;WACX,MAAM;YACL,QAAQ,GAAG,UAAU,GAAG,OAAO;+BAuFzC,CAAC"}

package/dist/src/mutations.js

@@ -0,0 +1,166 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { v } from "convex/values";
+import { mutation, internalMutation } from "./_generated/server";
+// ---------------------------------------------------------------------------
+// Handler functions — exported separately for unit testing
+// ---------------------------------------------------------------------------
+export async function upsertTemplateHandler(ctx, args) {
+    if (!args.tenant_id)
+        throw new Error("tenant_id is required");
+    if (!args.name.trim())
+        throw new Error("name must not be empty");
+    if (args.output_formats.length === 0)
+        throw new Error("output_formats must have at least one entry");
+    const existing = await ctx.db
+        .query("templates")
+        .withIndex("by_tenant_team", (q) => q.eq("tenant_id", args.tenant_id).eq("team", args.team))
+        .filter((q) => q.eq(q.field("name"), args.name))
+        .first();
+    const now = Date.now();
+    if (existing !== null) {
+        await ctx.db.patch(existing._id, {
+            renderer_kind: args.renderer_kind,
+            input_schema: args.input_schema,
+            asset_storage_id: args.asset_storage_id,
+            output_formats: args.output_formats,
+            metadata: args.metadata,
+            version: args.version,
+            updatedAt: now,
+        });
+        return existing._id;
+    }
+    return await ctx.db.insert("templates", {
+        name: args.name,
+        team: args.team,
+        tenant_id: args.tenant_id,
+        template_type: "doc-binary",
+        renderer_kind: args.renderer_kind,
+        input_schema: args.input_schema,
+        asset_storage_id: args.asset_storage_id,
+        output_formats: args.output_formats,
+        metadata: args.metadata,
+        version: args.version,
+        createdAt: now,
+        updatedAt: now,
+    });
+}
+export async function queueRenderHandler(ctx, args) {
+    const template = await ctx.db.get(args.template_id);
+    if (template === null)
+        throw new Error("Template not found");
+    if (!args.output_format.trim())
+        throw new Error("output_format required");
+    if (!template.output_formats.includes(args.output_format)) {
+        throw new Error(`output_format '${args.output_format}' not supported by this template. ` +
+            `Supported: ${template.output_formats.join(", ")}`);
+    }
+    return await ctx.db.insert("render_jobs", {
+        template_id: args.template_id,
+        tenant_id: template.tenant_id,
+        context: args.context,
+        output_format: args.output_format,
+        status: "queued",
+        createdAt: Date.now(),
+        createdBy: args.createdBy,
+    });
+}
+export async function setJobRenderingHandler(ctx, args) {
+    const job = await ctx.db.get(args.job_id);
+    if (job === null)
+        throw new Error("render_job not found");
+    await ctx.db.patch(args.job_id, { status: "rendering" });
+    return null;
+}
+export async function completeRenderJobHandler(ctx, args) {
+    const job = await ctx.db.get(args.job_id);
+    if (job === null)
+        throw new Error("render_job not found");
+    await ctx.db.patch(args.job_id, {
+        status: "done",
+        output_storage_id: args.output_storage_id,
+        completedAt: Date.now(),
+    });
+    return null;
+}
+export async function failRenderJobHandler(ctx, args) {
+    const job = await ctx.db.get(args.job_id);
+    if (job === null)
+        throw new Error("render_job not found");
+    await ctx.db.patch(args.job_id, {
+        status: "failed",
+        error: args.error,
+        completedAt: Date.now(),
+    });
+    return null;
+}
+export async function writeAuditHandler(ctx, args) {
+    return await ctx.db.insert("render_audit", {
+        ...args,
+        createdAt: Date.now(),
+    });
+}
+// ---------------------------------------------------------------------------
+// Convex registrations
+// ---------------------------------------------------------------------------
+export const upsert_template = mutation({
+    args: {
+        name: v.string(),
+        team: v.string(),
+        tenant_id: v.string(),
+        renderer_kind: v.union(v.literal("docxtpl"), v.literal("python-pptx"), v.literal("jinja2-html")),
+        input_schema: v.any(),
+        asset_storage_id: v.id("_storage"),
+        output_formats: v.array(v.string()),
+        metadata: v.optional(v.record(v.string(), v.string())),
+        version: v.string(),
+        createdBy: v.string(),
+    },
+    returns: v.id("templates"),
+    handler: upsertTemplateHandler,
+});
+export const queue_render = mutation({
+    args: {
+        template_id: v.id("templates"),
+        context: v.any(),
+        output_format: v.string(),
+        createdBy: v.string(),
+    },
+    returns: v.id("render_jobs"),
+    handler: queueRenderHandler,
+});
+export const _set_job_rendering = internalMutation({
+    args: { job_id: v.id("render_jobs") },
+    returns: v.null(),
+    handler: setJobRenderingHandler,
+});
+export const _complete_render_job = internalMutation({
+    args: {
+        job_id: v.id("render_jobs"),
+        output_storage_id: v.id("_storage"),
+    },
+    returns: v.null(),
+    handler: completeRenderJobHandler,
+});
+export const _fail_render_job = internalMutation({
+    args: {
+        job_id: v.id("render_jobs"),
+        error: v.string(),
+    },
+    returns: v.null(),
+    handler: failRenderJobHandler,
+});
+export const _write_audit = internalMutation({
+    args: {
+        render_job_id: v.id("render_jobs"),
+        tenant_id: v.string(),
+        template_id: v.id("templates"),
+        template_version: v.string(),
+        context_hash: v.string(),
+        output_signed_url: v.string(),
+        expires_at: v.number(),
+        actor: v.string(),
+        source: v.union(v.literal("manual"), v.literal("workflow"), v.literal("agent")),
+    },
+    returns: v.id("render_audit"),
+    handler: writeAuditHandler,
+});

package/dist/src/queries.d.ts

@@ -0,0 +1,30 @@
+import type { Id } from "./_generated/dataModel";
+type AnyCtx = any;
+export declare function listTemplatesHandler(ctx: AnyCtx, args: {
+    tenant_id: string;
+    team?: string;
+    type?: "doc-binary";
+}): Promise<any[]>;
+export declare function getTemplateHandler(ctx: AnyCtx, args: {
+    template_id: Id<"templates">;
+}): Promise<any>;
+export declare function listRenderHistoryHandler(ctx: AnyCtx, args: {
+    tenant_id: string;
+    template_id?: Id<"templates">;
+    since?: number;
+}): Promise<any[]>;
+export declare const list_templates: import("convex/server").RegisteredQuery<"public", {
+    tenant_id: string;
+    team?: string;
+    type?: "doc-binary";
+}, Promise<any[]>>;
+export declare const get_template: import("convex/server").RegisteredQuery<"public", {
+    template_id: Id<"templates">;
+}, Promise<any>>;
+export declare const list_render_history: import("convex/server").RegisteredQuery<"public", {
+    tenant_id: string;
+    template_id?: Id<"templates">;
+    since?: number;
+}, Promise<any[]>>;
+export {};
+//# sourceMappingURL=queries.d.ts.map

package/dist/src/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/queries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAGjD,KAAK,MAAM,GAAG,GAAG,CAAC;AAMlB,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,kBAsBhE;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,CAAA;CAAE,gBAGvC;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,kBA0B3E;AAMD,eAAO,MAAM,cAAc;eAjEN,MAAM;WAAS,MAAM;WAAS,YAAY;kBA8F7D,CAAC;AAEH,eAAO,MAAM,YAAY;iBAtEF,EAAE,CAAC,WAAW,CAAC;gBAgGpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;eA3FX,MAAM;kBAAgB,EAAE,CAAC,WAAW,CAAC;YAAU,MAAM;kBAsHxE,CAAC"}

package/dist/src/queries.js

@@ -0,0 +1,117 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { v } from "convex/values";
+import { query } from "./_generated/server";
+// ---------------------------------------------------------------------------
+// Handler functions — exported separately for unit testing
+// ---------------------------------------------------------------------------
+export async function listTemplatesHandler(ctx, args) {
+    let results;
+    if (args.team !== undefined) {
+        results = await ctx.db
+            .query("templates")
+            .withIndex("by_tenant_team", (q) => q.eq("tenant_id", args.tenant_id).eq("team", args.team))
+            .collect();
+    }
+    else {
+        results = await ctx.db
+            .query("templates")
+            .withIndex("by_tenant", (q) => q.eq("tenant_id", args.tenant_id))
+            .collect();
+    }
+    if (args.type !== undefined) {
+        return results.filter((t) => t.template_type === args.type);
+    }
+    return results;
+}
+export async function getTemplateHandler(ctx, args) {
+    return await ctx.db.get(args.template_id);
+}
+export async function listRenderHistoryHandler(ctx, args) {
+    if (args.template_id !== undefined) {
+        const rows = await ctx.db
+            .query("render_audit")
+            .withIndex("by_template", (q) => q.eq("template_id", args.template_id))
+            .order("desc")
+            .collect();
+        const since = args.since ?? 0;
+        return rows.filter((r) => r.tenant_id === args.tenant_id && r.createdAt >= since);
+    }
+    const rows = await ctx.db
+        .query("render_audit")
+        .withIndex("by_tenant", (q) => q.eq("tenant_id", args.tenant_id))
+        .order("desc")
+        .collect();
+    if (args.since !== undefined) {
+        return rows.filter((r) => r.createdAt >= args.since);
+    }
+    return rows;
+}
+// ---------------------------------------------------------------------------
+// Convex registrations
+// ---------------------------------------------------------------------------
+export const list_templates = query({
+    args: {
+        tenant_id: v.string(),
+        team: v.optional(v.string()),
+        type: v.optional(v.literal("doc-binary")),
+    },
+    returns: v.array(v.object({
+        _id: v.id("templates"),
+        _creationTime: v.number(),
+        name: v.string(),
+        team: v.string(),
+        tenant_id: v.string(),
+        template_type: v.literal("doc-binary"),
+        renderer_kind: v.union(v.literal("docxtpl"), v.literal("python-pptx"), v.literal("jinja2-html")),
+        input_schema: v.any(),
+        asset_storage_id: v.id("_storage"),
+        output_formats: v.array(v.string()),
+        metadata: v.optional(v.record(v.string(), v.string())),
+        version: v.string(),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })),
+    handler: listTemplatesHandler,
+});
+export const get_template = query({
+    args: { template_id: v.id("templates") },
+    returns: v.union(v.object({
+        _id: v.id("templates"),
+        _creationTime: v.number(),
+        name: v.string(),
+        team: v.string(),
+        tenant_id: v.string(),
+        template_type: v.literal("doc-binary"),
+        renderer_kind: v.union(v.literal("docxtpl"), v.literal("python-pptx"), v.literal("jinja2-html")),
+        input_schema: v.any(),
+        asset_storage_id: v.id("_storage"),
+        output_formats: v.array(v.string()),
+        metadata: v.optional(v.record(v.string(), v.string())),
+        version: v.string(),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    }), v.null()),
+    handler: getTemplateHandler,
+});
+export const list_render_history = query({
+    args: {
+        tenant_id: v.string(),
+        template_id: v.optional(v.id("templates")),
+        since: v.optional(v.number()),
+    },
+    returns: v.array(v.object({
+        _id: v.id("render_audit"),
+        _creationTime: v.number(),
+        render_job_id: v.id("render_jobs"),
+        tenant_id: v.string(),
+        template_id: v.id("templates"),
+        template_version: v.string(),
+        context_hash: v.string(),
+        output_signed_url: v.string(),
+        expires_at: v.number(),
+        actor: v.string(),
+        source: v.union(v.literal("manual"), v.literal("workflow"), v.literal("agent")),
+        createdAt: v.number(),
+    })),
+    handler: listRenderHistoryHandler,
+});