npm - @vantageos/convex-doc-forge - Versions diffs - 0.1.1 → 0.1.3 - Mend

@vantageos/convex-doc-forge 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -2,6 +2,38 @@
 All notable changes to this package follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) + [SemVer](https://semver.org/spec/v2.0.0.html).
+## [0.1.3] - 2026-06-19
+### Fixed
+- **GAP 1 (data)** `input_schema` changed from `v.any()` to `v.string()` in `schema.ts`, `mutations.ts` (arg + handler type), and `queries.ts` (returns validators for both `list_templates` and `get_template`). JSON Schemas containing `$schema`/`$ref`/`$defs` keys (which start with `$`, reserved by Convex) now round-trip correctly — callers `JSON.stringify()` before upsert, `JSON.parse()` after retrieval. No handler logic change; store-as-is.
+- **GAP 2 (BLOCKER)** `render_now` no longer reads `process.env.CONVEX_DOC_FORGE_RENDERER_URL` / `CONVEX_DOC_FORGE_RENDERER_KEY`. Convex components cannot access the host deployment's env vars (`convex env set` has no `--component` flag). Config is now passed as args: `renderer_url: v.string()` + `renderer_key: v.string()`. The host app reads its own env and threads these values when calling `ctx.runAction(components.docForge.actions.render_now, { ..., renderer_url, renderer_key })`.
+### Tests
+- `actions.test.ts`: removed `process.env.*RENDERER*` setup/teardown; all `renderNowHandler` calls now pass `renderer_url`/`renderer_key` as args; guard tests updated accordingly; added `$schema` round-trip test.
+- `mutations.test.ts`: `baseArgs.input_schema` changed to `JSON.stringify(...)` throughout; added `$schema`/`$ref`/`$defs` round-trip test.
+### Notes
+- tsc: 0 errors. V8-pure: zero `"use node"` or `node:*` in src/. `peerDependencies.convex` unchanged (`>=1.17.0`).
+- Breaking change for callers of `render_now`: must now pass `renderer_url` + `renderer_key` as args. See README + `scripts/smoke-render.md` for updated call pattern.
+## [0.1.2] - 2026-06-19
+### Added
+- `mutations.ts`: public `generate_upload_url` mutation — enables host apps / consumers to upload a template binary into the component storage namespace, then register it via `upsert_template`. Unblocks `render_now` E2E and template upload (Marie/Iris RH critical path).
+  - Takes no args, returns `v.string()` (signed upload URL).
+  - Pure addition, no breaking change, `peerDependencies.convex` unchanged (`>=1.17.0`).
+  - V8-pure: no `"use node"`, no `node:*` imports (component constraint).
+- `scripts/smoke-render.md`: canonical, reusable fleet smoke harness documenting the full upload→upsert→render CLI sequence.
+### Notes
+- Discovered via consumer-1 dogfood (Omega install on vibrant-ibex-858): `upsert_template` required `asset_storage_id: v.id("_storage")` but there was no public path for a consumer to obtain a storage ID in the component namespace.
+- tsc: 0 errors. Test ratio: 31/31 PASS.
 ## [0.1.1] - 2026-06-19
 ### Fixed

package/README.md CHANGED Viewed

@@ -44,7 +44,19 @@ export default app;
 ---
-## Required env vars (set in Convex dashboard)
+## Renderer config (passed as args by the host app)
+`render_now` does **not** read env vars from the Convex dashboard — Convex components cannot access the host deployment's env vars (`convex env set` has no `--component` flag). The host app reads its own env and passes config as args on every call:
+```ts
+const result = await ctx.runAction(components.docForge.actions.render_now, {
+  // ...
+  renderer_url: process.env.CONVEX_DOC_FORGE_RENDERER_URL!,
+  renderer_key: process.env.CONVEX_DOC_FORGE_RENDERER_KEY!,
+});
+```
+Set these in the **host** deployment's Convex dashboard (not inside the component):
 | Variable | Description |
 |---|---|
@@ -64,7 +76,7 @@ export default app;
 | `tenant_id` | string | Clerk org ID |
 | `template_type` | `"doc-binary"` | Always `doc-binary` (V1) |
 | `renderer_kind` | `"docxtpl" \| "python-pptx" \| "jinja2-html"` | Which renderer to use |
-| `input_schema` | object | JSON Schema for context validation |
+| `input_schema` | string | JSON Schema serialized as a JSON string (`JSON.stringify(schema)`) — avoids Convex `$`-key rejection |
 | `asset_storage_id` | Id<"_storage"> | Convex file storage reference to the .docx/.pptx asset |
 | `output_formats` | string[] | e.g. `["docx", "pdf"]` |
 | `version` | string | SemVer |
@@ -115,13 +127,79 @@ docForge.mutations.queue_render({ template_id, context, output_format, createdBy
 docForge.actions.render_now({
   template_id, context, output_format,
   actor,           // Clerk subject
-  source?          // "manual" | "workflow" | "agent"  (default "manual")
+  source?,         // "manual" | "workflow" | "agent"  (default "manual")
+  renderer_url,    // host app reads from its own env (e.g. process.env.CONVEX_DOC_FORGE_RENDERER_URL)
+  renderer_key,    // host app reads from its own env (e.g. process.env.CONVEX_DOC_FORGE_RENDERER_KEY)
 })
 // → { output_url, render_job_id, duration_ms, pages? }
 ```
 ---
+## Asset ingestion
+Before calling `upsert_template`, the host app must upload the `.docx`/`.pptx` binary into the component's isolated storage namespace and obtain a `storageId`. The three-step flow:
+**Step 1 — get a signed upload URL** (from a host app action):
+```ts
+// convex/myActions.ts
+import { action } from "./_generated/server";
+import { components } from "./_generated/api";
+export const getDocForgeUploadUrl = action({
+  args: {},
+  handler: async (ctx) =>
+    await ctx.runMutation(components.docForge.mutations.generate_upload_url, {}),
+});
+```
+**Step 2 — POST the raw bytes to the signed URL**:
+```bash
+curl -X POST "<uploadUrl>" \
+  -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
+  --data-binary @template.docx
+# → { "storageId": "kg2abc..." }
+```
+**Step 3 — register the asset as a template** and then render:
+```ts
+const templateId = await ctx.runMutation(
+  components.docForge.mutations.upsert_template,
+  {
+    name: "proposition-audit",
+    team: "iris-rh",
+    tenant_id: "org_clerk_abc",
+    renderer_kind: "docxtpl",
+    // input_schema must be a JSON-stringified string — Convex rejects $-prefixed keys (e.g. $schema, $ref)
+    input_schema: JSON.stringify({ type: "object", properties: { client_name: { type: "string" } } }),
+    asset_storage_id: storageId,   // from step 2
+    output_formats: ["pdf", "docx"],
+    version: "1.0.0",
+    createdBy: "clerk_user_id",
+  },
+);
+// Now render_now works end-to-end:
+// renderer_url + renderer_key are read from the host app's env and passed as args
+const result = await ctx.runAction(components.docForge.actions.render_now, {
+  template_id: templateId,
+  context: { client_name: "Iris RH" },
+  output_format: "pdf",
+  actor: "clerk_user_id",
+  source: "manual",
+  renderer_url: process.env.CONVEX_DOC_FORGE_RENDERER_URL!,
+  renderer_key: process.env.CONVEX_DOC_FORGE_RENDERER_KEY!,
+});
+// → { output_url, render_job_id, duration_ms }
+```
+See `scripts/smoke-render.md` in this repo for the full copy-paste fleet smoke harness.
+---
 ## Renderer contract
 `render_now` calls the sidecar:

package/dist/actions.d.ts CHANGED Viewed

@@ -4,6 +4,8 @@ export declare function renderNowHandler(ctx: any, args: {
     output_format: string;
     actor: string;
     source?: "manual" | "workflow" | "agent";
+    renderer_url: string;
+    renderer_key: string;
 }): Promise<{
     output_url: string;
     render_job_id: string;
@@ -16,5 +18,7 @@ export declare const render_now: import("convex/server").RegisteredAction<"publi
     context: any;
     output_format: string;
     actor: string;
+    renderer_url: string;
+    renderer_key: string;
 }, any>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAiCA,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"}
1	+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAiCA,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;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,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;;;;;;;;OAwBrB,CAAC"}

package/dist/actions.js CHANGED Viewed

@@ -18,12 +18,12 @@ 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;
+    const rendererUrl = args.renderer_url;
+    const rendererKey = args.renderer_key;
     if (!rendererUrl)
-        throw new Error("CONVEX_DOC_FORGE_RENDERER_URL not set");
+        throw new Error("renderer_url arg is required");
     if (!rendererKey)
-        throw new Error("CONVEX_DOC_FORGE_RENDERER_KEY not set");
+        throw new Error("renderer_key arg is required");
     // 1. Load template
     const template = await ctx.runQuery(internal.queries.get_template, {
         template_id: args.template_id,
@@ -149,6 +149,8 @@ export const render_now = action({
         output_format: v.string(),
         actor: v.string(),
         source: v.optional(v.union(v.literal("manual"), v.literal("workflow"), v.literal("agent"))),
+        renderer_url: v.string(),
+        renderer_key: v.string(),
     },
     returns: v.object({
         output_url: v.string(),

package/dist/mutations.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ export declare function upsertTemplateHandler(ctx: AnyCtx, args: {
     team: string;
     tenant_id: string;
     renderer_kind: "docxtpl" | "python-pptx" | "jinja2-html";
-    input_schema: unknown;
+    input_schema: string;
     asset_storage_id: Id<"_storage">;
     output_formats: string[];
     metadata?: Record<string, string>;
@@ -29,6 +29,7 @@ export declare function failRenderJobHandler(ctx: AnyCtx, args: {
     job_id: Id<"render_jobs">;
     error: string;
 }): Promise<null>;
+export declare function generateUploadUrlHandler(ctx: AnyCtx): Promise<string>;
 export declare function writeAuditHandler(ctx: AnyCtx, args: {
     render_job_id: Id<"render_jobs">;
     tenant_id: string;
@@ -40,12 +41,13 @@ export declare function writeAuditHandler(ctx: AnyCtx, args: {
     actor: string;
     source: "manual" | "workflow" | "agent";
 }): Promise<Id<"render_audit">>;
+export declare const generate_upload_url: import("convex/server").RegisteredMutation<"public", {}, Promise<string>>;
 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;
+    input_schema: string;
     asset_storage_id: Id<"_storage">;
     output_formats: string[];
     metadata?: Record<string, string>;

package/dist/mutations.d.ts.map CHANGED Viewed

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

package/dist/mutations.js CHANGED Viewed

@@ -93,6 +93,9 @@ export async function failRenderJobHandler(ctx, args) {
     });
     return null;
 }
+export async function generateUploadUrlHandler(ctx) {
+    return await ctx.storage.generateUploadUrl();
+}
 export async function writeAuditHandler(ctx, args) {
     return await ctx.db.insert("render_audit", {
         ...args,
@@ -102,13 +105,18 @@ export async function writeAuditHandler(ctx, args) {
 // ---------------------------------------------------------------------------
 // Convex registrations
 // ---------------------------------------------------------------------------
+export const generate_upload_url = mutation({
+    args: {},
+    returns: v.string(),
+    handler: generateUploadUrlHandler,
+});
 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(),
+        input_schema: v.string(),
         asset_storage_id: v.id("_storage"),
         output_formats: v.array(v.string()),
         metadata: v.optional(v.record(v.string(), v.string())),

package/dist/queries.js CHANGED Viewed

@@ -63,7 +63,7 @@ export const list_templates = query({
         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(),
+        input_schema: v.string(),
         asset_storage_id: v.id("_storage"),
         output_formats: v.array(v.string()),
         metadata: v.optional(v.record(v.string(), v.string())),
@@ -83,7 +83,7 @@ export const get_template = query({
         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(),
+        input_schema: v.string(),
         asset_storage_id: v.id("_storage"),
         output_formats: v.array(v.string()),
         metadata: v.optional(v.record(v.string(), v.string())),

package/dist/schema.d.ts CHANGED Viewed

@@ -14,7 +14,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         tenant_id: string;
         template_type: "doc-binary";
         renderer_kind: "docxtpl" | "python-pptx" | "jinja2-html";
-        input_schema: any;
+        input_schema: string;
         asset_storage_id: import("convex/values").GenericId<"_storage">;
         output_formats: string[];
         version: string;
@@ -26,14 +26,14 @@ declare const _default: import("convex/server").SchemaDefinition<{
         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>;
+        input_schema: import("convex/values").VString<string, "required">;
         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}`>, {
+    }, "required", "name" | "team" | "tenant_id" | "template_type" | "renderer_kind" | "input_schema" | "asset_storage_id" | "output_formats" | "metadata" | "version" | "createdAt" | "updatedAt" | `metadata.${string}`>, {
         by_tenant: ["tenant_id", "_creationTime"];
         by_tenant_team: ["tenant_id", "team", "_creationTime"];
         by_tenant_type: ["tenant_id", "template_type", "_creationTime"];

package/dist/schema.js CHANGED Viewed

@@ -15,7 +15,7 @@ export default defineSchema({
         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
+        input_schema: v.string(), // JSON Schema serialized as a JSON string (avoids $-key rejection)
         asset_storage_id: v.id("_storage"),
         output_formats: v.array(v.string()),
         metadata: v.optional(v.record(v.string(), v.string())),

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@vantageos/convex-doc-forge",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Convex component — data layer for VantageDocForge (templates, render jobs, audit)",
   "type": "module",
   "main": "./dist/index.js",