@bb-labs/convex-cache 0.0.1

package/dist/convex-cache/index.d.ts

@@ -0,0 +1 @@
+export * from "./types/schema-map";

package/dist/convex-cache/index.js

@@ -0,0 +1 @@
+export * from "./types/schema-map";

package/dist/convex-cache/types/schema-map.d.ts

@@ -0,0 +1,4 @@
+import type { ValidatorJSON } from "convex/values";
+export type T_SchemaMap = Record<string, {
+    returns: ValidatorJSON;
+}>;

package/dist/convex-cache/types/schema-map.js

@@ -0,0 +1 @@
+export {};

package/dist/validation/index.d.ts

@@ -0,0 +1,10 @@
+import { type GenericValidator } from "convex/values";
+import type { ValidatorJSON } from "convex/values";
+/**
+ * Serialize a Convex validator to its canonical JSON representation.
+ */
+export declare function validatorToJSON(validator: GenericValidator): ValidatorJSON;
+/**
+ * Rebuild a Convex validator from its ValidatorJSON representation.
+ */
+export declare function validatorFromJSON(json: ValidatorJSON): GenericValidator;

package/dist/validation/index.js

@@ -0,0 +1,83 @@
+// convexValidatorCodec.ts
+import { jsonToConvex, v } from "convex/values";
+/**
+ * Serialize a Convex validator to its canonical JSON representation.
+ */
+export function validatorToJSON(validator) {
+    return validator.json;
+}
+/**
+ * Rebuild a Convex validator from its ValidatorJSON representation.
+ */
+export function validatorFromJSON(json) {
+    switch (json.type) {
+        case "null":
+            return v.null();
+        case "number":
+            return v.number();
+        case "bigint":
+            return v.int64(); // or v.bigint(), depending on your style
+        case "boolean":
+            return v.boolean();
+        case "string":
+            return v.string();
+        case "bytes":
+            return v.bytes();
+        case "any":
+            return v.any();
+        case "literal":
+            // json.value is a JSONValue; Convex used convexToJson to serialize it.
+            // If you have jsonToConvex, use it here; otherwise assume value is already fine.
+            return v.literal(jsonToConvex(json.value));
+        case "id":
+            return v.id(json.tableName);
+        case "array": {
+            const elementValidator = validatorFromJSON(json.value);
+            return v.array(elementValidator);
+        }
+        case "union": {
+            const members = json.value.map((j) => validatorFromJSON(j));
+            // v.union expects required validators
+            return v.union(...members);
+        }
+        case "object": {
+            const fields = {};
+            for (const [name, field] of Object.entries(json.value)) {
+                const base = validatorFromJSON(field.fieldType);
+                const maybeOptional = field.optional ? v.optional(base) : base;
+                fields[name] = maybeOptional;
+            }
+            return v.object(fields);
+        }
+        case "record": {
+            const keyValidator = recordKeyFromJSON(json.keys);
+            const valueValidator = recordValueFromJSON(json.values);
+            return v.record(keyValidator, valueValidator);
+        }
+        default: {
+            const _exhaustive = json;
+            throw new Error(`Unknown validator JSON type: ${_exhaustive.type}`);
+        }
+    }
+}
+function recordKeyFromJSON(json) {
+    switch (json.type) {
+        case "string":
+            return v.string();
+        case "id":
+            return v.id(json.tableName);
+        case "union": {
+            const members = json.value.map((j) => recordKeyFromJSON(j));
+            return v.union(...members);
+        }
+        default: {
+            const _exhaustive = json;
+            throw new Error(`Unknown record key validator JSON type: ${_exhaustive.type}`);
+        }
+    }
+}
+function recordValueFromJSON(json) {
+    // json.optional is always false by type, but we’ll respect it anyway.
+    const base = validatorFromJSON(json.fieldType);
+    return json.optional ? v.optional(base) : base;
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@bb-labs/convex-cache",
+  "version": "0.0.1",
+  "description": "A library for caching Convex queries on the client and server",
+  "homepage": "https://github.com/beepbop-labs/convex-cache",
+  "keywords": [
+    "convex-cache",
+    "convex",
+    "react",
+    "nextjs"
+  ],
+  "author": "Beepbop",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/beepbop-labs/convex-cache.git"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/convex-cache/index.js",
+    "./core/*": "./dist/convex-cache/core/*.js",
+    "./react": "./dist/convex-cache/adapters/react/index.js",
+    "./next": "./dist/convex-cache/adapters/next/index.js",
+    "./next/server": "./dist/convex-cache/adapters/next/server.js",
+    "./validation": "./dist/validation/index.js"
+  },
+  "bin": {
+    "convex-cache": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "archive": "rm -rf archive && mkdir -p archive && bun run build && npm pack --pack-destination ./archive/"
+  },
+  "dependencies": {
+    "@bb-labs/deep-equal": "^0.0.1",
+    "@bb-labs/deep-sort": "^0.0.1",
+    "@bb-labs/local-db": "^0.0.1",
+    "commander": "^14.0.2",
+    "convex": "^1.29.3",
+    "convex-helpers": "^0.1.106",
+    "fast-glob": "^3.3.3",
+    "superjson": "^2.2.6",
+    "zod": "^4.1.13"
+  },
+  "peerDependencies": {
+    "next": "^16.0.4",
+    "react": "^19"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
+    "typescript": "^5.9.3"
+  }
+}