zodvex 0.7.7 → 0.7.8-beta.0

package/dist/public/server/index.d.ts

@@ -13,7 +13,7 @@ export { customCtx } from 'convex-helpers/server/customFunctions';
 export { createZodvexActionCtx } from '../../internal/actionCtx';
 export { zActionBuilder, zCustomActionBuilder, zCustomMutationBuilder, zCustomQueryBuilder, zMutationBuilder, zQueryBuilder } from '../../internal/builders';
 export { type CustomBuilder, zCustomAction, zCustomMutation, zCustomQuery } from '../../internal/custom';
-export { createZodvexCustomization } from '../../internal/customization';
+export { createZodvexCustomization, type ZodvexUnderlyingDb } from '../../internal/customization';
 export { createZodDbReader, createZodDbWriter, ZodvexDatabaseReader, ZodvexDatabaseWriter, type ZodvexExpression, type ZodvexExpressionOrValue, type ZodvexFilterBuilder, type ZodvexIndexFieldValue, type ZodvexIndexRangeBuilder, type ZodvexLowerBoundBuilder, ZodvexQueryChain, type ZodvexUpperBoundBuilder } from '../../internal/db';
 export { defineContext, initZodvex, type ZodvexActionCtx, type ZodvexBuilder, type ZodvexCustomization, type ZodvexMutationCtx, type ZodvexQueryCtx } from '../../internal/init';
 export type { DeleteRule, InsertRule, PatchRule, ReaderAuditConfig, ReadRule, ReplaceRule, TableRules, WriteEvent, WriterAuditConfig, ZodvexRules, ZodvexRulesConfig } from '../../internal/rules';

package/dist/public/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACd,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,KAAK,aAAa,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA;AAExE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,aAAa,EACb,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAI5B,YAAY,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAE7B,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACd,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,KAAK,aAAa,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,aAAa,EACb,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAI5B,YAAY,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAE7B,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/server/index.js

@@ -1674,6 +1674,17 @@ var ZodvexDatabaseReader = class {
   get _internals() {
     return { db: this.db, tableMap: this.tableMap };
   }
+  /**
+   * Escape hatch (#85/#92): returns the database this codec wrapper delegates
+   * to — the composed underlying stack when `underlyingDb` is configured (e.g.
+   * a trigger-wrapped writer), the bare Convex db otherwise.
+   *
+   * The returned db is native-shape: reads are undecoded wire documents and it
+   * bypasses codec, `.withRules()`, and `.audit()` layers entirely.
+   */
+  unwrap() {
+    return this.db;
+  }
   normalizeId(tableName, id2) {
     return this.db.normalizeId(tableName, id2);
   }
@@ -1733,6 +1744,17 @@ var ZodvexDatabaseWriter = class extends ZodvexDatabaseReader {
   get _internals() {
     return { db: this.writerDb, tableMap: this.tableMap, reader: this };
   }
+  /**
+   * Escape hatch (#85/#92): returns the writer this codec wrapper delegates
+   * to — the composed underlying stack when `underlyingDb` is configured (e.g.
+   * a trigger-wrapped writer), the bare Convex db otherwise.
+   *
+   * The returned db is native-shape: writes must be wire-format and it
+   * bypasses codec, `.withRules()`, and `.audit()` layers entirely.
+   */
+  unwrap() {
+    return this.writerDb;
+  }
   async insert(table, value) {
     const schemas = this.tableMap[table];
     const wireValue = schemas ? encodeDoc(schemas.insert, value) : value;
@@ -1817,19 +1839,25 @@ installRulesSubclasses({
 });
 
 // src/internal/customization.ts
-function createZodvexCustomization(tableMap) {
+function createZodvexCustomization(tableMap, options) {
+  const resolveReaderDb = options?.underlyingDb?.query;
+  const resolveWriterDb = options?.underlyingDb?.mutation;
   return {
     query: {
       args: {},
       input: async (ctx, _args, _extra) => ({
-        ctx: { db: new ZodvexDatabaseReader(ctx.db, tableMap) },
+        ctx: {
+          db: new ZodvexDatabaseReader(resolveReaderDb ? resolveReaderDb(ctx) : ctx.db, tableMap)
+        },
         args: {}
       })
     },
     mutation: {
       args: {},
       input: async (ctx, _args, _extra) => ({
-        ctx: { db: new ZodvexDatabaseWriter(ctx.db, tableMap) },
+        ctx: {
+          db: new ZodvexDatabaseWriter(resolveWriterDb ? resolveWriterDb(ctx) : ctx.db, tableMap)
+        },
         args: {}
       })
     }
@@ -1839,9 +1867,16 @@ function defineContext(_builder, customization) {
   return customization;
 }
 function initZodvex(schema, server, options) {
-  const codec2 = createZodvexCustomization(schema.__zodTableMap);
-  const noOp = createNoOpCustomization();
   const wrap = options?.wrapDb !== false;
+  if (!wrap && options?.underlyingDb) {
+    throw new Error(
+      "[zodvex] initZodvex: `underlyingDb` requires the codec db wrapper \u2014 remove `wrapDb: false` or drop `underlyingDb`."
+    );
+  }
+  const codec2 = createZodvexCustomization(schema.__zodTableMap, {
+    underlyingDb: options?.underlyingDb
+  });
+  const noOp = createNoOpCustomization();
   const registryThunk = options?.registry;
   const actionCust = createActionCustomization(registryThunk, noOp);
   const customizations = {