@rippledb/zod 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,260 @@
+import { z } from 'zod';
+/**
+ * Zod schema for HLC (Hybrid Logical Clock) timestamps.
+ * Format: "{wallTimeMs}:{counter}:{nodeId}"
+ */
+export declare const hlcSchema: z.ZodString;
+/**
+ * Zod schema for change kind (upsert or delete).
+ */
+export declare const changeKindSchema: z.ZodEnum<["upsert", "delete"]>;
+/**
+ * Creates a Zod schema for a Change object.
+ *
+ * @example
+ * ```ts
+ * const todoChangeSchema = createChangeSchema(z.object({
+ *   id: z.string(),
+ *   title: z.string(),
+ *   done: z.boolean().optional(),
+ * }));
+ * ```
+ */
+export declare function createChangeSchema<T extends z.ZodObject<z.ZodRawShape>>(patchSchema: T): z.ZodObject<{
+    stream: z.ZodString;
+    entity: z.ZodString;
+    entityId: z.ZodString;
+    kind: z.ZodEnum<["upsert", "delete"]>;
+    patch: z.ZodObject<{
+        [x: string]: z.ZodOptional<z.ZodTypeAny>;
+    }, z.UnknownKeysParam, z.ZodTypeAny, {
+        [x: string]: any;
+    }, {
+        [x: string]: any;
+    }>;
+    tags: z.ZodRecord<z.ZodString, z.ZodString>;
+    hlc: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    stream: string;
+    entity: string;
+    entityId: string;
+    kind: "upsert" | "delete";
+    patch: {
+        [x: string]: any;
+    };
+    tags: Record<string, string>;
+    hlc: string;
+}, {
+    stream: string;
+    entity: string;
+    entityId: string;
+    kind: "upsert" | "delete";
+    patch: {
+        [x: string]: any;
+    };
+    tags: Record<string, string>;
+    hlc: string;
+}>;
+/**
+ * Generic change schema when patch structure is unknown.
+ */
+export declare const changeSchema: z.ZodObject<{
+    stream: z.ZodString;
+    entity: z.ZodString;
+    entityId: z.ZodString;
+    kind: z.ZodEnum<["upsert", "delete"]>;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    tags: z.ZodRecord<z.ZodString, z.ZodString>;
+    hlc: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    stream: string;
+    entity: string;
+    entityId: string;
+    kind: "upsert" | "delete";
+    patch: Record<string, unknown>;
+    tags: Record<string, string>;
+    hlc: string;
+}, {
+    stream: string;
+    entity: string;
+    entityId: string;
+    kind: "upsert" | "delete";
+    patch: Record<string, unknown>;
+    tags: Record<string, string>;
+    hlc: string;
+}>;
+/**
+ * Zod schema for PullRequest.
+ */
+export declare const pullRequestSchema: z.ZodObject<{
+    stream: z.ZodString;
+    cursor: z.ZodNullable<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    stream: string;
+    cursor: string | null;
+    limit?: number | undefined;
+}, {
+    stream: string;
+    cursor: string | null;
+    limit?: number | undefined;
+}>;
+/**
+ * Creates a Zod schema for PullResponse with typed changes.
+ */
+export declare function createPullResponseSchema<T extends z.ZodTypeAny>(changeSchema: T): z.ZodObject<{
+    changes: z.ZodArray<T, "many">;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    changes: T["_output"][];
+    nextCursor: string | null;
+}, {
+    changes: T["_input"][];
+    nextCursor: string | null;
+}>;
+/**
+ * Generic pull response schema.
+ */
+export declare const pullResponseSchema: z.ZodObject<{
+    changes: z.ZodArray<z.ZodObject<{
+        stream: z.ZodString;
+        entity: z.ZodString;
+        entityId: z.ZodString;
+        kind: z.ZodEnum<["upsert", "delete"]>;
+        patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        tags: z.ZodRecord<z.ZodString, z.ZodString>;
+        hlc: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }, {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }>, "many">;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    changes: {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }[];
+    nextCursor: string | null;
+}, {
+    changes: {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }[];
+    nextCursor: string | null;
+}>;
+/**
+ * Creates a Zod schema for AppendRequest with typed changes.
+ */
+export declare function createAppendRequestSchema<T extends z.ZodTypeAny>(changeSchema: T): z.ZodObject<{
+    stream: z.ZodString;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    changes: z.ZodArray<T, "many">;
+}, "strip", z.ZodTypeAny, {
+    stream: string;
+    changes: T["_output"][];
+    idempotencyKey?: string | undefined;
+}, {
+    stream: string;
+    changes: T["_input"][];
+    idempotencyKey?: string | undefined;
+}>;
+/**
+ * Generic append request schema.
+ */
+export declare const appendRequestSchema: z.ZodObject<{
+    stream: z.ZodString;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    changes: z.ZodArray<z.ZodObject<{
+        stream: z.ZodString;
+        entity: z.ZodString;
+        entityId: z.ZodString;
+        kind: z.ZodEnum<["upsert", "delete"]>;
+        patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        tags: z.ZodRecord<z.ZodString, z.ZodString>;
+        hlc: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }, {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    stream: string;
+    changes: {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }[];
+    idempotencyKey?: string | undefined;
+}, {
+    stream: string;
+    changes: {
+        stream: string;
+        entity: string;
+        entityId: string;
+        kind: "upsert" | "delete";
+        patch: Record<string, unknown>;
+        tags: Record<string, string>;
+        hlc: string;
+    }[];
+    idempotencyKey?: string | undefined;
+}>;
+/**
+ * Zod schema for AppendResult.
+ */
+export declare const appendResultSchema: z.ZodObject<{
+    accepted: z.ZodNumber;
+    hlc: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accepted: number;
+    hlc?: string | undefined;
+}, {
+    accepted: number;
+    hlc?: string | undefined;
+}>;
+export type HlcInput = z.infer<typeof hlcSchema>;
+export type ChangeKindInput = z.infer<typeof changeKindSchema>;
+export type ChangeInput = z.infer<typeof changeSchema>;
+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>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,61 @@
+// src/index.ts
+import { z } from "zod";
+var hlcSchema = z.string().regex(/^\d+:\d+:.+$/, "Invalid HLC format");
+var changeKindSchema = z.enum(["upsert", "delete"]);
+function createChangeSchema(patchSchema) {
+  return z.object({
+    stream: z.string(),
+    entity: z.string(),
+    entityId: z.string(),
+    kind: changeKindSchema,
+    patch: patchSchema.partial(),
+    tags: z.record(z.string(), hlcSchema),
+    hlc: hlcSchema
+  });
+}
+var changeSchema = z.object({
+  stream: z.string(),
+  entity: z.string(),
+  entityId: z.string(),
+  kind: changeKindSchema,
+  patch: z.record(z.string(), z.unknown()),
+  tags: z.record(z.string(), hlcSchema),
+  hlc: hlcSchema
+});
+var pullRequestSchema = z.object({
+  stream: z.string(),
+  cursor: z.string().nullable(),
+  limit: z.number().int().positive().optional()
+});
+function createPullResponseSchema(changeSchema2) {
+  return z.object({
+    changes: z.array(changeSchema2),
+    nextCursor: z.string().nullable()
+  });
+}
+var pullResponseSchema = createPullResponseSchema(changeSchema);
+function createAppendRequestSchema(changeSchema2) {
+  return z.object({
+    stream: z.string(),
+    idempotencyKey: z.string().optional(),
+    changes: z.array(changeSchema2)
+  });
+}
+var appendRequestSchema = createAppendRequestSchema(changeSchema);
+var appendResultSchema = z.object({
+  accepted: z.number().int().nonnegative(),
+  hlc: hlcSchema.optional()
+});
+export {
+  appendRequestSchema,
+  appendResultSchema,
+  changeKindSchema,
+  changeSchema,
+  createAppendRequestSchema,
+  createChangeSchema,
+  createPullResponseSchema,
+  hlcSchema,
+  pullRequestSchema,
+  pullResponseSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@rippledb/zod",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@rippledb/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@rippledb/server": "workspace:*",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "zod": "^3.24.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "test": "vitest run --pool=threads",
+    "test:watch": "vitest --pool=threads",
+    "lint": "eslint ."
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "esm"
+    ],
+    "dts": false,
+    "sourcemap": true,
+    "clean": true
+  }
+}