@vantageos/convex-doc-forge 0.1.0

package/dist/src/schema.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Internal schema for the @vantageos/convex-doc-forge component.
+ *
+ * Three tables:
+ *  - templates   : template metadata + asset reference
+ *  - render_jobs : per-render job tracking (status machine)
+ *  - render_audit: immutable audit log (who/when/what)
+ */
+declare const _default: import("convex/server").SchemaDefinition<{
+    templates: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        metadata?: Record<string, string> | undefined;
+        name: string;
+        team: string;
+        tenant_id: string;
+        template_type: "doc-binary";
+        renderer_kind: "docxtpl" | "python-pptx" | "jinja2-html";
+        input_schema: any;
+        asset_storage_id: import("convex/values").GenericId<"_storage">;
+        output_formats: string[];
+        version: string;
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        name: import("convex/values").VString<string, "required">;
+        team: import("convex/values").VString<string, "required">;
+        tenant_id: import("convex/values").VString<string, "required">;
+        template_type: import("convex/values").VLiteral<"doc-binary", "required">;
+        renderer_kind: import("convex/values").VUnion<"docxtpl" | "python-pptx" | "jinja2-html", [import("convex/values").VLiteral<"docxtpl", "required">, import("convex/values").VLiteral<"python-pptx", "required">, import("convex/values").VLiteral<"jinja2-html", "required">], "required", never>;
+        input_schema: import("convex/values").VAny<any, "required", string>;
+        asset_storage_id: import("convex/values").VId<import("convex/values").GenericId<"_storage">, "required">;
+        output_formats: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        metadata: import("convex/values").VRecord<Record<string, string> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "optional", string>;
+        version: import("convex/values").VString<string, "required">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "name" | "team" | "tenant_id" | "template_type" | "renderer_kind" | "input_schema" | "asset_storage_id" | "output_formats" | "metadata" | "version" | "createdAt" | "updatedAt" | `input_schema.${string}` | `metadata.${string}`>, {
+        by_tenant: ["tenant_id", "_creationTime"];
+        by_tenant_team: ["tenant_id", "team", "_creationTime"];
+        by_tenant_type: ["tenant_id", "template_type", "_creationTime"];
+    }, {}, {}>;
+    render_jobs: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        output_storage_id?: import("convex/values").GenericId<"_storage"> | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+        tenant_id: string;
+        createdAt: number;
+        template_id: import("convex/values").GenericId<"templates">;
+        context: any;
+        output_format: string;
+        status: "queued" | "rendering" | "done" | "failed";
+        createdBy: string;
+    }, {
+        template_id: import("convex/values").VId<import("convex/values").GenericId<"templates">, "required">;
+        tenant_id: import("convex/values").VString<string, "required">;
+        context: import("convex/values").VAny<any, "required", string>;
+        output_format: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"queued" | "rendering" | "done" | "failed", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"rendering", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+        output_storage_id: import("convex/values").VId<import("convex/values").GenericId<"_storage"> | undefined, "optional">;
+        error: import("convex/values").VString<string | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        completedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdBy: import("convex/values").VString<string, "required">;
+    }, "required", "tenant_id" | "createdAt" | "template_id" | "context" | "output_format" | "status" | "output_storage_id" | "error" | "completedAt" | "createdBy" | `context.${string}`>, {
+        by_tenant: ["tenant_id", "_creationTime"];
+        by_template: ["template_id", "createdAt", "_creationTime"];
+        by_tenant_status: ["tenant_id", "status", "_creationTime"];
+    }, {}, {}>;
+    render_audit: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        tenant_id: string;
+        createdAt: number;
+        template_id: import("convex/values").GenericId<"templates">;
+        render_job_id: import("convex/values").GenericId<"render_jobs">;
+        template_version: string;
+        context_hash: string;
+        output_signed_url: string;
+        expires_at: number;
+        actor: string;
+        source: "manual" | "workflow" | "agent";
+    }, {
+        render_job_id: import("convex/values").VId<import("convex/values").GenericId<"render_jobs">, "required">;
+        tenant_id: import("convex/values").VString<string, "required">;
+        template_id: import("convex/values").VId<import("convex/values").GenericId<"templates">, "required">;
+        template_version: import("convex/values").VString<string, "required">;
+        context_hash: import("convex/values").VString<string, "required">;
+        output_signed_url: import("convex/values").VString<string, "required">;
+        expires_at: import("convex/values").VFloat64<number, "required">;
+        actor: import("convex/values").VString<string, "required">;
+        source: import("convex/values").VUnion<"manual" | "workflow" | "agent", [import("convex/values").VLiteral<"manual", "required">, import("convex/values").VLiteral<"workflow", "required">, import("convex/values").VLiteral<"agent", "required">], "required", never>;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "tenant_id" | "createdAt" | "template_id" | "render_job_id" | "template_version" | "context_hash" | "output_signed_url" | "expires_at" | "actor" | "source">, {
+        by_tenant: ["tenant_id", "_creationTime"];
+        by_template: ["template_id", "createdAt", "_creationTime"];
+        by_job: ["render_job_id", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACH,wBA+DG"}

package/dist/src/schema.js

@@ -0,0 +1,59 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+/**
+ * Internal schema for the @vantageos/convex-doc-forge component.
+ *
+ * Three tables:
+ *  - templates   : template metadata + asset reference
+ *  - render_jobs : per-render job tracking (status machine)
+ *  - render_audit: immutable audit log (who/when/what)
+ */
+export default defineSchema({
+    templates: defineTable({
+        name: v.string(),
+        team: v.string(),
+        tenant_id: v.string(), // Clerk org ID
+        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(), // JSON Schema object — validated at runtime
+        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(),
+    })
+        .index("by_tenant", ["tenant_id"])
+        .index("by_tenant_team", ["tenant_id", "team"])
+        .index("by_tenant_type", ["tenant_id", "template_type"]),
+    render_jobs: defineTable({
+        template_id: v.id("templates"),
+        tenant_id: v.string(),
+        context: v.any(), // Caller-supplied JSON matching template.input_schema
+        output_format: v.string(),
+        status: v.union(v.literal("queued"), v.literal("rendering"), v.literal("done"), v.literal("failed")),
+        output_storage_id: v.optional(v.id("_storage")),
+        error: v.optional(v.string()),
+        createdAt: v.number(),
+        completedAt: v.optional(v.number()),
+        createdBy: v.string(), // Clerk subject (user or service account)
+    })
+        .index("by_tenant", ["tenant_id"])
+        .index("by_template", ["template_id", "createdAt"])
+        .index("by_tenant_status", ["tenant_id", "status"]),
+    render_audit: defineTable({
+        render_job_id: v.id("render_jobs"),
+        tenant_id: v.string(),
+        template_id: v.id("templates"),
+        template_version: v.string(),
+        context_hash: v.string(), // SHA-256 hex of JSON.stringify(context)
+        output_signed_url: v.string(),
+        expires_at: v.number(), // epoch ms
+        actor: v.string(), // Clerk subject
+        source: v.union(v.literal("manual"), v.literal("workflow"), v.literal("agent")),
+        createdAt: v.number(),
+    })
+        .index("by_tenant", ["tenant_id"])
+        .index("by_template", ["template_id", "createdAt"])
+        .index("by_job", ["render_job_id"]),
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vantageos/convex-doc-forge",
+  "version": "0.1.0",
+  "description": "Convex component — data layer for VantageDocForge (templates, render jobs, audit)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./convex.config": {
+      "import": "./dist/convex.config.js",
+      "types": "./dist/convex.config.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "convex.config.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && tsc --project tsconfig.convex.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "convex": ">=1.17.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "convex": "^1.41.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9"
+  },
+  "license": "FSL-1.1-Apache-2.0",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elpiarthera/vantage-doc-forge"
+  }
+}