zodvex 0.7.7-beta.2 → 0.7.8-beta.0

package/README.md

@@ -167,6 +167,21 @@ The same wrapped `ctx.db` carries per-row security and observability — both op
 
 Guide: [Rules & Audit](./docs/guide/rules-and-audit.md)
 
+### Composable with Triggers
+
+The codec wrapper can delegate to an underlying db you supply, so `ctx.db`-wrapping libraries like `convex-helpers/server/triggers` compose instead of colliding — codec on top, triggers underneath, real db at the bottom:
+
+```ts
+const triggers = new Triggers<DataModel>()
+export const { zq, zm, zim /* ... */ } = initZodvex(schema, server, {
+  underlyingDb: { mutation: (ctx) => triggers.wrapDB(ctx).db },
+})
+```
+
+Triggers fire inside zodvex mutations and observe native wire-format writes — which unlocks the aggregate component's table-trigger mode, model-bound cascades, and similar reactive patterns. `ctx.db.unwrap()` is the matching escape hatch for direct access to the underlying db.
+
+Guide: [Builders — Composing with triggers](./docs/guide/builders.md#composing-with-convex-helpers-triggers-underlyingdb)
+
 ### Codegen & Client-Side Schema Sharing
 
 zodvex includes an optional CLI that generates typed client code:

package/dist/cli/index.js

@@ -2405,19 +2405,29 @@ ${dtsDeclarations.join("\n")}
 async function generate(convexDir2, options) {
   const resolved = resolveConvexDir(convexDir2);
   const zodvexDir = path4.join(resolved, "_zodvex");
-  writeStubApi(zodvexDir);
-  const result = await discoverModules(resolved);
-  const schemaContent = generateSchemaFile(result.models);
-  const apiContent = generateApiFile(
-    result.functions,
-    result.models,
-    result.codecs,
-    result.modelCodecs,
-    result.functionCodecs,
-    { mini: options?.mini }
-  );
-  const clientContent = generateClientFile({ mini: options?.mini });
-  const serverContent = generateServerFile();
+  const restoreStubbedApi = writeStubApi(zodvexDir);
+  let result;
+  let schemaContent;
+  let apiContent;
+  let clientContent;
+  let serverContent;
+  try {
+    result = await discoverModules(resolved);
+    schemaContent = generateSchemaFile(result.models);
+    apiContent = generateApiFile(
+      result.functions,
+      result.models,
+      result.codecs,
+      result.modelCodecs,
+      result.functionCodecs,
+      { mini: options?.mini }
+    );
+    clientContent = generateClientFile({ mini: options?.mini });
+    serverContent = generateServerFile();
+  } catch (err) {
+    restoreStubbedApi();
+    throw err;
+  }
   fs3.mkdirSync(zodvexDir, { recursive: true });
   writeIfChanged(path4.join(zodvexDir, "schema.js"), schemaContent.js);
   writeIfChanged(path4.join(zodvexDir, "schema.d.ts"), schemaContent.dts);
@@ -2471,6 +2481,16 @@ function regenerate(resolved, options) {
   });
 }
 function writeStubApi(zodvexDir) {
+  const stubTargets = ["api.js", "api.d.ts"].map((name) => {
+    const filePath = path4.join(zodvexDir, name);
+    let original;
+    try {
+      original = fs3.readFileSync(filePath, "utf-8");
+    } catch {
+      original = null;
+    }
+    return { filePath, original };
+  });
   fs3.mkdirSync(zodvexDir, { recursive: true });
   fs3.writeFileSync(
     path4.join(zodvexDir, "api.js"),
@@ -2480,6 +2500,18 @@ function writeStubApi(zodvexDir) {
     path4.join(zodvexDir, "api.d.ts"),
     "// AUTO-GENERATED by zodvex \u2014 do not edit\n// Stub created for codegen bootstrap\n\nexport declare const zodvexRegistry: Record<string, any>\n"
   );
+  return () => {
+    for (const { filePath, original } of stubTargets) {
+      try {
+        if (original !== null) {
+          fs3.writeFileSync(filePath, original);
+        } else {
+          fs3.unlinkSync(filePath);
+        }
+      } catch {
+      }
+    }
+  };
 }
 function writeIfChanged(filePath, content) {
   try {