@rippledb/zod 0.1.4 → 0.2.0

package/dist/index.d.ts

@@ -1,4 +1,97 @@
 import { z } from 'zod';
+import type { SchemaDescriptor, DescriptorSchema } from '@rippledb/core';
+/**
+ * Helper type to validate that overrides only contain valid entities and fields.
+ * When used with `as const`, this helps catch extra properties even when assigned to variables.
+ */
+type ValidateOverrides<S extends DescriptorSchema, O> = [
+    keyof O
+] extends [never] ? O : keyof O extends keyof S ? {
+    [E in keyof O]: E extends keyof S ? keyof O[E] extends keyof S[E] ? unknown : never : never;
+}[keyof O] extends never ? never : O : never;
+/**
+ * Typed overrides for Zod schemas - constrained to valid entities and fields.
+ */
+export type ZodOverrides<S extends DescriptorSchema> = {
+    [E in keyof S]?: {
+        [F in keyof S[E]]?: z.ZodTypeAny;
+    };
+};
+/**
+ * Generated Zod schemas for each entity.
+ */
+export type ZodSchemas<S extends DescriptorSchema> = {
+    [E in keyof S]: z.ZodObject<{
+        [F in keyof S[E]]: z.ZodTypeAny;
+    }>;
+};
+/**
+ * Schema descriptor with typed Zod schema access.
+ */
+export type SchemaDescriptorWithZod<S extends DescriptorSchema> = SchemaDescriptor<S> & {
+    /**
+     * Auto-generated Zod schemas for each entity.
+     * Access via `schema.zod.entityName.parse(data)`.
+     */
+    readonly zod: ZodSchemas<S>;
+};
+/**
+ * Wraps a SchemaDescriptor with auto-generated Zod schemas.
+ *
+ * The Zod schemas are generated from the field descriptors in the schema.
+ * You can optionally provide overrides to customize individual field schemas
+ * (e.g., to add refinements like `.min()`, `.max()`, `.email()`, etc.).
+ *
+ * @param schema - The schema descriptor to wrap
+ * @param overrides - Optional Zod schema overrides for specific fields
+ * @returns A schema descriptor with typed `.zod` access
+ *
+ * @example
+ * ```ts
+ * import { defineSchema, s } from '@rippledb/core';
+ * import { withZod } from '@rippledb/zod';
+ * import { z } from 'zod';
+ *
+ * const schema = defineSchema({
+ *   todos: {
+ *     id: s.string(),
+ *     title: s.string(),
+ *     done: s.boolean(),
+ *   },
+ *   users: {
+ *     id: s.string(),
+ *     name: s.string(),
+ *     email: s.string(),
+ *   },
+ * });
+ *
+ * // Basic usage - auto-generate all Zod schemas
+ * const schemaWithZod = withZod(schema);
+ *
+ * // Validate data
+ * const todo = schemaWithZod.zod.todos.parse({ id: '1', title: 'Test', done: false });
+ *
+ * // With overrides - add refinements
+ * const schemaWithRefinements = withZod(schema, {
+ *   todos: {
+ *     title: z.string().min(1).max(100),
+ *   },
+ *   users: {
+ *     email: z.string().email(),
+ *   },
+ * });
+ * ```
+ */
+export declare function withZod<S extends DescriptorSchema, O extends ZodOverrides<S>>(schema: SchemaDescriptor<S>, overrides?: O & ValidateOverrides<S, O>): SchemaDescriptorWithZod<S>;
+/**
+ * Generates Zod schemas from a schema descriptor without wrapping it.
+ * Use this if you only need the Zod schemas without the extended descriptor.
+ *
+ * @param schema - The schema descriptor
+ * @param overrides - Optional Zod schema overrides
+ * @returns Generated Zod schemas for each entity
+ */
+export declare function generateZodSchemas<S extends DescriptorSchema, O extends ZodOverrides<S>>(schema: SchemaDescriptor<S>, overrides?: O & ValidateOverrides<S, O>): ZodSchemas<S>;
 /**
  * Zod schema for HLC (Hybrid Logical Clock) timestamps.
  * Format: "{wallTimeMs}:{counter}:{nodeId}"
@@ -257,4 +350,5 @@ export type PullRequestInput = z.infer<typeof pullRequestSchema>;
 export type PullResponseInput = z.infer<typeof pullResponseSchema>;
 export type AppendRequestInput = z.infer<typeof appendRequestSchema>;
 export type AppendResultInput = z.infer<typeof appendResultSchema>;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAyD,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,gBAAgB,iCAA+B,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUtF;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;;;;;;;;;GAK/E;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;;;;;;;;;;;;GAMhF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAGH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,68 @@
 // src/index.ts
 import { z } from "zod";
+function fieldDescriptorToZod(field) {
+  let schema;
+  switch (field._type) {
+    case "string":
+      schema = z.string();
+      break;
+    case "number":
+      schema = z.number();
+      break;
+    case "boolean":
+      schema = z.boolean();
+      break;
+    case "enum": {
+      const enumField = field;
+      if (!enumField.values || enumField.values.length === 0) {
+        schema = z.never();
+      } else if (enumField.values.length === 1) {
+        schema = z.literal(enumField.values[0]);
+      } else {
+        schema = z.enum(enumField.values);
+      }
+      break;
+    }
+    default:
+      schema = z.unknown();
+  }
+  if (field._optional) {
+    schema = schema.optional();
+  }
+  return schema;
+}
+function withZod(schema, overrides) {
+  const zodSchemas = {};
+  for (const entityName of schema.entities) {
+    const entityDescriptor = schema.schema[entityName];
+    const entityOverridesObj = overrides?.[entityName];
+    const shape = {};
+    for (const fieldName of Object.keys(entityDescriptor)) {
+      const fieldDescriptor = entityDescriptor[fieldName];
+      shape[fieldName] = entityOverridesObj?.[fieldName] ?? fieldDescriptorToZod(fieldDescriptor);
+    }
+    zodSchemas[entityName] = z.object(shape);
+  }
+  const extendedSchema = schema.extend("zod", zodSchemas);
+  return {
+    ...extendedSchema,
+    zod: zodSchemas
+  };
+}
+function generateZodSchemas(schema, overrides) {
+  const zodSchemas = {};
+  for (const entityName of schema.entities) {
+    const entityDescriptor = schema.schema[entityName];
+    const entityOverridesObj = overrides?.[entityName];
+    const shape = {};
+    for (const fieldName of Object.keys(entityDescriptor)) {
+      const fieldDescriptor = entityDescriptor[fieldName];
+      shape[fieldName] = entityOverridesObj?.[fieldName] ?? fieldDescriptorToZod(fieldDescriptor);
+    }
+    zodSchemas[entityName] = z.object(shape);
+  }
+  return zodSchemas;
+}
 var hlcSchema = z.string().regex(/^\d+:\d+:.+$/, "Invalid HLC format");
 var changeKindSchema = z.enum(["upsert", "delete"]);
 function createChangeSchema(patchSchema) {
@@ -54,8 +117,10 @@ export {
   createAppendRequestSchema,
   createChangeSchema,
   createPullResponseSchema,
+  generateZodSchemas,
   hlcSchema,
   pullRequestSchema,
-  pullResponseSchema
+  pullResponseSchema,
+  withZod
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Zod schema for HLC (Hybrid Logical Clock) timestamps.\n * Format: \"{wallTimeMs}:{counter}:{nodeId}\"\n */\nexport const hlcSchema = z.string().regex(/^\\d+:\\d+:.+$/, 'Invalid HLC format');\n\n/**\n * Zod schema for change kind (upsert or delete).\n */\nexport const changeKindSchema = z.enum(['upsert', 'delete']);\n\n/**\n * Creates a Zod schema for a Change object.\n * \n * @example\n * ```ts\n * const todoChangeSchema = createChangeSchema(z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   done: z.boolean().optional(),\n * }));\n * ```\n */\nexport function createChangeSchema<T extends z.ZodObject<z.ZodRawShape>>(patchSchema: T) {\n  return z.object({\n    stream: z.string(),\n    entity: z.string(),\n    entityId: z.string(),\n    kind: changeKindSchema,\n    patch: patchSchema.partial(),\n    tags: z.record(z.string(), hlcSchema),\n    hlc: hlcSchema,\n  });\n}\n\n/**\n * Generic change schema when patch structure is unknown.\n */\nexport const changeSchema = z.object({\n  stream: z.string(),\n  entity: z.string(),\n  entityId: z.string(),\n  kind: changeKindSchema,\n  patch: z.record(z.string(), z.unknown()),\n  tags: z.record(z.string(), hlcSchema),\n  hlc: hlcSchema,\n});\n\n/**\n * Zod schema for PullRequest.\n */\nexport const pullRequestSchema = z.object({\n  stream: z.string(),\n  cursor: z.string().nullable(),\n  limit: z.number().int().positive().optional(),\n});\n\n/**\n * Creates a Zod schema for PullResponse with typed changes.\n */\nexport function createPullResponseSchema<T extends z.ZodTypeAny>(changeSchema: T) {\n  return z.object({\n    changes: z.array(changeSchema),\n    nextCursor: z.string().nullable(),\n  });\n}\n\n/**\n * Generic pull response schema.\n */\nexport const pullResponseSchema = createPullResponseSchema(changeSchema);\n\n/**\n * Creates a Zod schema for AppendRequest with typed changes.\n */\nexport function createAppendRequestSchema<T extends z.ZodTypeAny>(changeSchema: T) {\n  return z.object({\n    stream: z.string(),\n    idempotencyKey: z.string().optional(),\n    changes: z.array(changeSchema),\n  });\n}\n\n/**\n * Generic append request schema.\n */\nexport const appendRequestSchema = createAppendRequestSchema(changeSchema);\n\n/**\n * Zod schema for AppendResult.\n */\nexport const appendResultSchema = z.object({\n  accepted: z.number().int().nonnegative(),\n  hlc: hlcSchema.optional(),\n});\n\n// Re-export zod types for convenience\nexport type HlcInput = z.infer<typeof hlcSchema>;\nexport type ChangeKindInput = z.infer<typeof changeKindSchema>;\nexport type ChangeInput = z.infer<typeof changeSchema>;\nexport type PullRequestInput = z.infer<typeof pullRequestSchema>;\nexport type PullResponseInput = z.infer<typeof pullResponseSchema>;\nexport type AppendRequestInput = z.infer<typeof appendRequestSchema>;\nexport type AppendResultInput = z.infer<typeof appendResultSchema>;\n"],"mappings":";AAAA,SAAS,SAAS;AAMX,IAAM,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,oBAAoB;AAKvE,IAAM,mBAAmB,EAAE,KAAK,CAAC,UAAU,QAAQ,CAAC;AAcpD,SAAS,mBAAyD,aAAgB;AACvF,SAAO,EAAE,OAAO;AAAA,IACd,QAAQ,EAAE,OAAO;AAAA,IACjB,QAAQ,EAAE,OAAO;AAAA,IACjB,UAAU,EAAE,OAAO;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,YAAY,QAAQ;AAAA,IAC3B,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS;AAAA,IACpC,KAAK;AAAA,EACP,CAAC;AACH;AAKO,IAAM,eAAe,EAAE,OAAO;AAAA,EACnC,QAAQ,EAAE,OAAO;AAAA,EACjB,QAAQ,EAAE,OAAO;AAAA,EACjB,UAAU,EAAE,OAAO;AAAA,EACnB,MAAM;AAAA,EACN,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAAA,EACvC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS;AAAA,EACpC,KAAK;AACP,CAAC;AAKM,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,QAAQ,EAAE,OAAO;AAAA,EACjB,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAC9C,CAAC;AAKM,SAAS,yBAAiDA,eAAiB;AAChF,SAAO,EAAE,OAAO;AAAA,IACd,SAAS,EAAE,MAAMA,aAAY;AAAA,IAC7B,YAAY,EAAE,OAAO,EAAE,SAAS;AAAA,EAClC,CAAC;AACH;AAKO,IAAM,qBAAqB,yBAAyB,YAAY;AAKhE,SAAS,0BAAkDA,eAAiB;AACjF,SAAO,EAAE,OAAO;AAAA,IACd,QAAQ,EAAE,OAAO;AAAA,IACjB,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,IACpC,SAAS,EAAE,MAAMA,aAAY;AAAA,EAC/B,CAAC;AACH;AAKO,IAAM,sBAAsB,0BAA0B,YAAY;AAKlE,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACvC,KAAK,UAAU,SAAS;AAC1B,CAAC;","names":["changeSchema"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { z } from 'zod';\nimport type {\n  SchemaDescriptor,\n  DescriptorSchema,\n  FieldDescriptorLike,\n} from '@rippledb/core';\n\n// ============================================================================\n// withZod - Auto-generate Zod schemas from field descriptors\n// ============================================================================\n\n/**\n * Helper type to validate that overrides only contain valid entities and fields.\n * When used with `as const`, this helps catch extra properties even when assigned to variables.\n */\ntype ValidateOverrides<S extends DescriptorSchema, O> =\n  // Special case: empty overrides object is always valid\n  [keyof O] extends [never]\n    ? O\n    : // Check that all entity keys in O are valid entities in S\n      keyof O extends keyof S\n      ? // For each entity, check that all field keys are valid\n        {\n          [E in keyof O]: E extends keyof S\n            ? keyof O[E] extends keyof S[E]\n              ? unknown // Valid\n              : never // Invalid - has extra fields\n            : never; // Invalid - entity doesn't exist\n        }[keyof O] extends never\n        ? never // At least one entity has invalid fields\n        : O // All valid\n      : never; // Has extra entities\n\n/**\n * Typed overrides for Zod schemas - constrained to valid entities and fields.\n */\nexport type ZodOverrides<S extends DescriptorSchema> = {\n  [E in keyof S]?: {\n    [F in keyof S[E]]?: z.ZodTypeAny;\n  };\n};\n\n/**\n * Generated Zod schemas for each entity.\n */\nexport type ZodSchemas<S extends DescriptorSchema> = {\n  [E in keyof S]: z.ZodObject<{\n    [F in keyof S[E]]: z.ZodTypeAny;\n  }>;\n};\n\n/**\n * Schema descriptor with typed Zod schema access.\n */\nexport type SchemaDescriptorWithZod<S extends DescriptorSchema> = SchemaDescriptor<S> & {\n  /**\n   * Auto-generated Zod schemas for each entity.\n   * Access via `schema.zod.entityName.parse(data)`.\n   */\n  readonly zod: ZodSchemas<S>;\n};\n\n/**\n * Converts a field descriptor to a Zod schema.\n */\nfunction fieldDescriptorToZod(field: FieldDescriptorLike): z.ZodTypeAny {\n  let schema: z.ZodTypeAny;\n\n  switch (field._type) {\n    case 'string':\n      schema = z.string();\n      break;\n    case 'number':\n      schema = z.number();\n      break;\n    case 'boolean':\n      schema = z.boolean();\n      break;\n    case 'enum': {\n      // Cast to access the values property on enum fields\n      const enumField = field as unknown as { values: readonly string[] };\n      if (!enumField.values || enumField.values.length === 0) {\n        schema = z.never();\n      } else if (enumField.values.length === 1) {\n        schema = z.literal(enumField.values[0]);\n      } else {\n        schema = z.enum(enumField.values as [string, ...string[]]);\n      }\n      break;\n    }\n    default:\n      schema = z.unknown();\n  }\n\n  if (field._optional) {\n    schema = schema.optional();\n  }\n\n  return schema;\n}\n\n/**\n * Wraps a SchemaDescriptor with auto-generated Zod schemas.\n * \n * The Zod schemas are generated from the field descriptors in the schema.\n * You can optionally provide overrides to customize individual field schemas\n * (e.g., to add refinements like `.min()`, `.max()`, `.email()`, etc.).\n * \n * @param schema - The schema descriptor to wrap\n * @param overrides - Optional Zod schema overrides for specific fields\n * @returns A schema descriptor with typed `.zod` access\n * \n * @example\n * ```ts\n * import { defineSchema, s } from '@rippledb/core';\n * import { withZod } from '@rippledb/zod';\n * import { z } from 'zod';\n * \n * const schema = defineSchema({\n *   todos: {\n *     id: s.string(),\n *     title: s.string(),\n *     done: s.boolean(),\n *   },\n *   users: {\n *     id: s.string(),\n *     name: s.string(),\n *     email: s.string(),\n *   },\n * });\n * \n * // Basic usage - auto-generate all Zod schemas\n * const schemaWithZod = withZod(schema);\n * \n * // Validate data\n * const todo = schemaWithZod.zod.todos.parse({ id: '1', title: 'Test', done: false });\n * \n * // With overrides - add refinements\n * const schemaWithRefinements = withZod(schema, {\n *   todos: {\n *     title: z.string().min(1).max(100),\n *   },\n *   users: {\n *     email: z.string().email(),\n *   },\n * });\n * ```\n */\nexport function withZod<S extends DescriptorSchema, O extends ZodOverrides<S>>(\n  schema: SchemaDescriptor<S>,\n  overrides?: O & ValidateOverrides<S, O>,\n): SchemaDescriptorWithZod<S> {\n  const zodSchemas = {} as Record<string, z.ZodObject<Record<string, z.ZodTypeAny>>>;\n\n  for (const entityName of schema.entities) {\n    const entityDescriptor = schema.schema[entityName];\n    const entityOverridesObj = overrides?.[entityName as keyof S] as Record<string, z.ZodTypeAny> | undefined;\n    const shape: Record<string, z.ZodTypeAny> = {};\n\n    for (const fieldName of Object.keys(entityDescriptor)) {\n      const fieldDescriptor = entityDescriptor[fieldName];\n      // Use override if provided, otherwise generate from descriptor\n      shape[fieldName] = entityOverridesObj?.[fieldName] ?? fieldDescriptorToZod(fieldDescriptor);\n    }\n\n    zodSchemas[entityName] = z.object(shape);\n  }\n\n  // Extend the schema with the zod extension\n  const extendedSchema = schema.extend('zod', zodSchemas);\n\n  return {\n    ...extendedSchema,\n    zod: zodSchemas as ZodSchemas<S>,\n  };\n}\n\n/**\n * Generates Zod schemas from a schema descriptor without wrapping it.\n * Use this if you only need the Zod schemas without the extended descriptor.\n * \n * @param schema - The schema descriptor\n * @param overrides - Optional Zod schema overrides\n * @returns Generated Zod schemas for each entity\n */\nexport function generateZodSchemas<S extends DescriptorSchema, O extends ZodOverrides<S>>(\n  schema: SchemaDescriptor<S>,\n  overrides?: O & ValidateOverrides<S, O>,\n): ZodSchemas<S> {\n  const zodSchemas = {} as Record<string, z.ZodObject<Record<string, z.ZodTypeAny>>>;\n\n  for (const entityName of schema.entities) {\n    const entityDescriptor = schema.schema[entityName];\n    const entityOverridesObj = overrides?.[entityName as keyof S] as Record<string, z.ZodTypeAny> | undefined;\n    const shape: Record<string, z.ZodTypeAny> = {};\n\n    for (const fieldName of Object.keys(entityDescriptor)) {\n      const fieldDescriptor = entityDescriptor[fieldName];\n      shape[fieldName] = entityOverridesObj?.[fieldName] ?? fieldDescriptorToZod(fieldDescriptor);\n    }\n\n    zodSchemas[entityName] = z.object(shape);\n  }\n\n  return zodSchemas as ZodSchemas<S>;\n}\n\n// ============================================================================\n// Existing schemas for RippleDB protocol types\n// ============================================================================\n\n/**\n * Zod schema for HLC (Hybrid Logical Clock) timestamps.\n * Format: \"{wallTimeMs}:{counter}:{nodeId}\"\n */\nexport const hlcSchema = z.string().regex(/^\\d+:\\d+:.+$/, 'Invalid HLC format');\n\n/**\n * Zod schema for change kind (upsert or delete).\n */\nexport const changeKindSchema = z.enum(['upsert', 'delete']);\n\n/**\n * Creates a Zod schema for a Change object.\n * \n * @example\n * ```ts\n * const todoChangeSchema = createChangeSchema(z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   done: z.boolean().optional(),\n * }));\n * ```\n */\nexport function createChangeSchema<T extends z.ZodObject<z.ZodRawShape>>(patchSchema: T) {\n  return z.object({\n    stream: z.string(),\n    entity: z.string(),\n    entityId: z.string(),\n    kind: changeKindSchema,\n    patch: patchSchema.partial(),\n    tags: z.record(z.string(), hlcSchema),\n    hlc: hlcSchema,\n  });\n}\n\n/**\n * Generic change schema when patch structure is unknown.\n */\nexport const changeSchema = z.object({\n  stream: z.string(),\n  entity: z.string(),\n  entityId: z.string(),\n  kind: changeKindSchema,\n  patch: z.record(z.string(), z.unknown()),\n  tags: z.record(z.string(), hlcSchema),\n  hlc: hlcSchema,\n});\n\n/**\n * Zod schema for PullRequest.\n */\nexport const pullRequestSchema = z.object({\n  stream: z.string(),\n  cursor: z.string().nullable(),\n  limit: z.number().int().positive().optional(),\n});\n\n/**\n * Creates a Zod schema for PullResponse with typed changes.\n */\nexport function createPullResponseSchema<T extends z.ZodTypeAny>(changeSchema: T) {\n  return z.object({\n    changes: z.array(changeSchema),\n    nextCursor: z.string().nullable(),\n  });\n}\n\n/**\n * Generic pull response schema.\n */\nexport const pullResponseSchema = createPullResponseSchema(changeSchema);\n\n/**\n * Creates a Zod schema for AppendRequest with typed changes.\n */\nexport function createAppendRequestSchema<T extends z.ZodTypeAny>(changeSchema: T) {\n  return z.object({\n    stream: z.string(),\n    idempotencyKey: z.string().optional(),\n    changes: z.array(changeSchema),\n  });\n}\n\n/**\n * Generic append request schema.\n */\nexport const appendRequestSchema = createAppendRequestSchema(changeSchema);\n\n/**\n * Zod schema for AppendResult.\n */\nexport const appendResultSchema = z.object({\n  accepted: z.number().int().nonnegative(),\n  hlc: hlcSchema.optional(),\n});\n\n// Re-export zod types for convenience\nexport type HlcInput = z.infer<typeof hlcSchema>;\nexport type ChangeKindInput = z.infer<typeof changeKindSchema>;\nexport type ChangeInput = z.infer<typeof changeSchema>;\nexport type PullRequestInput = z.infer<typeof pullRequestSchema>;\nexport type PullResponseInput = z.infer<typeof pullResponseSchema>;\nexport type AppendRequestInput = z.infer<typeof appendRequestSchema>;\nexport type AppendResultInput = z.infer<typeof appendResultSchema>;\n"],"mappings":"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","names":["changeSchema"]}

package/dist/index.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test-d.d.ts.map

package/dist/index.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test-d.d.ts","sourceRoot":"","sources":["../src/index.test-d.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rippledb/zod",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "Zod schemas for runtime validation of RippleDB types",
   "private": false,
@@ -32,7 +32,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@rippledb/core": "0.1.1"
+    "@rippledb/core": "0.2.0"
   },
   "peerDependencies": {
     "zod": "^3.0.0"
@@ -43,7 +43,7 @@
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
     "zod": "^3.24.0",
-    "@rippledb/server": "0.1.1"
+    "@rippledb/server": "0.1.2"
   },
   "tsup": {
     "entry": [