@rebasepro/codegen 0.0.1-canary.4829d6e

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rebase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @rebasepro/codegen
+
+Generates typed TypeScript definitions from Rebase collection definitions — produces `Database` interface with `Row`, `Insert`, and `Update` types for each collection.
+
+## Installation
+
+```bash
+pnpm add @rebasepro/codegen
+```
+
+### Peer Dependencies
+
+- `@rebasepro/common`
+- `@rebasepro/types`
+
+## What This Package Does
+
+`@rebasepro/codegen` takes an array of `CollectionConfig` definitions and produces TypeScript type files that provide full autocompletion when used with `@rebasepro/client`. It handles property types, enums, relations, maps, arrays, geopoints, vectors, and validation-based optionality.
+
+This is typically invoked via the CLI (`npx rebase generate-sdk`) rather than called directly.
+
+## Key Exports
+
+| Export | Type | Description |
+|---|---|---|
+| `generateSDK` | Function | Main entry — returns array of `GeneratedFile` objects |
+| `generateTypedefs` | Function | Generates the `database.types.ts` content string |
+| `GeneratedFile` | Interface | `{ path: string; content: string }` |
+| `GenerateSDKOptions` | Interface | `{ includeReadme?: boolean }` (default: `true`) |
+| `toPascalCase` | Function | `"my_collection"` → `"MyCollection"` |
+| `toCamelCase` | Function | `"my_collection"` → `"myCollection"` |
+| `toSafeIdentifier` | Function | Converts slugs to valid JS identifiers |
+| `indent` | Function | Indent text by N spaces |
+
+## Generated Output
+
+`generateSDK()` produces:
+
+1. **`database.types.ts`** — A `Database` interface where each collection slug is a key containing:
+   - `Row` — Full snapshot type (read operations)
+   - `Insert` — Type for creating snapshots (auto-ID fields are optional)
+   - `Update` — All-optional partial type for updates
+
+2. **`README.md`** — Usage instructions (opt out with `includeReadme: false`)
+
+### Property Type Mapping
+
+| Rebase Type | TypeScript Type |
+|---|---|
+| `string` | `string` (or union of enum values) |
+| `number` | `number` (or union of enum values) |
+| `boolean` | `boolean` |
+| `date` | `string` (ISO 8601) |
+| `geopoint` | `{ latitude: number; longitude: number }` |
+| `reference` | `string \| number` |
+| `relation` | Relation object type |
+| `map` | Inline object type or `Record<string, any>` |
+| `array` | `Array<T>` with inferred inner type |
+| `vector` | `number[]` |
+| `binary` | `string` |
+
+## Quick Start
+
+```typescript
+import { generateSDK } from "@rebasepro/codegen";
+import type { CollectionConfig } from "@rebasepro/types";
+
+const collections: CollectionConfig[] = [/* your collections */];
+
+const files = generateSDK(collections);
+// files = [
+//   { path: "database.types.ts", content: "..." },
+//   { path: "README.md", content: "..." }
+// ]
+
+for (const file of files) {
+    fs.writeFileSync(path.join(outputDir, file.path), file.content);
+}
+```
+
+## Related Packages
+
+- `@rebasepro/client` — Consumes the generated types for typed API calls
+- `@rebasepro/types` — Provides `CollectionConfig`, `Property`, and related type definitions
+- `@rebasepro/common` — Provides `resolveCollectionRelations` used during generation

package/dist/generate-types.d.ts

@@ -0,0 +1,2 @@
+import { CollectionConfig } from "@rebasepro/types";
+export declare function generateTypedefs(collections: CollectionConfig[]): string;

package/dist/index.cjs

@@ -0,0 +1,227 @@
+(function(global, factory) {
+	typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("@rebasepro/common")) : typeof define === "function" && define.amd ? define(["exports", "@rebasepro/common"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.RebaseSDKGenerator = {}, global._rebasepro_common));
+})(this, function(exports, _rebasepro_common) {
+	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+	//#region src/utils.ts
+	/**
+	* Utility functions for the SDK generator
+	*/
+	/**
+	* Convert a slug/snake_case string to PascalCase
+	* e.g. "private_notes" → "PrivateNotes"
+	*/
+	function toPascalCase(str) {
+		return str.split(/[_\-\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+	}
+	/**
+	* Convert a slug/snake_case string to camelCase
+	* e.g. "private_notes" → "privateNotes"
+	*/
+	function toCamelCase(str) {
+		if (!/[_\-\s]/.test(str)) return str.charAt(0).toLowerCase() + str.slice(1);
+		const pascal = toPascalCase(str);
+		return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+	}
+	/**
+	* Convert a slug to a safe JS identifier
+	* e.g. "private-notes" → "privateNotes"
+	*/
+	function toSafeIdentifier(str) {
+		return toCamelCase(str.replace(/[^a-zA-Z0-9_]/g, "_"));
+	}
+	/**
+	* Indent a block of text by a given number of spaces
+	*/
+	function indent(text, spaces) {
+		const pad = " ".repeat(spaces);
+		return text.split("\n").map((line) => line.trim() ? pad + line : line).join("\n");
+	}
+	//#endregion
+	//#region src/generate-types.ts
+	function propertyToTypeScriptType(prop) {
+		switch (prop.type) {
+			case "string": {
+				const sp = prop;
+				if (sp.enum) return (Array.isArray(sp.enum) ? sp.enum.map((e) => typeof e === "object" ? String(e.id) : String(e)) : Object.keys(sp.enum)).map((v) => `"${v}"`).join(" | ");
+				return "string";
+			}
+			case "number": {
+				const np = prop;
+				if (np.enum) return (Array.isArray(np.enum) ? np.enum.map((e) => typeof e === "object" ? String(e.id) : String(e)) : Object.keys(np.enum)).join(" | ");
+				return "number";
+			}
+			case "boolean": return "boolean";
+			case "date": return "string";
+			case "geopoint": return "{ latitude: number; longitude: number; }";
+			case "reference": return "string | number";
+			case "relation": return "string | number";
+			case "map": {
+				const mapProp = prop;
+				if (mapProp.properties) return `{ ${Object.entries(mapProp.properties).map(([k, v]) => `${toSafeIdentifier(k)}: ${propertyToTypeScriptType(v)};`).join(" ")} }`;
+				return "Record<string, unknown>";
+			}
+			case "array": {
+				const arrProp = prop;
+				if (arrProp.of) return `Array<${propertyToTypeScriptType(arrProp.of)}>`;
+				return "Array<unknown>";
+			}
+			case "vector": return "number[]";
+			case "binary": return "string";
+			default: return "unknown";
+		}
+	}
+	function generateTypedefs(collections) {
+		const lines = [
+			"/**",
+			" * This file was auto-generated by Rebase.",
+			" * Do not make direct changes to the file.",
+			" */",
+			"",
+			"export interface Database {"
+		];
+		for (const collection of collections) {
+			toPascalCase(collection.slug);
+			const properties = collection.properties ?? {};
+			let resolvedRelations = {};
+			try {
+				resolvedRelations = (0, _rebasepro_common.resolveCollectionRelations)(collection);
+			} catch {}
+			lines.push(`  ${toSafeIdentifier(collection.slug)}: {`);
+			lines.push("    Row: {");
+			const emittedKeys = /* @__PURE__ */ new Set();
+			for (const [key, rawProp] of Object.entries(properties)) {
+				const prop = rawProp;
+				if (prop.type === "relation") continue;
+				const tsType = propertyToTypeScriptType(prop);
+				const isRequired = prop.validation?.required;
+				lines.push(`      ${toSafeIdentifier(key)}${isRequired ? "" : "?"}: ${tsType};`);
+				emittedKeys.add(key);
+			}
+			for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+				const fkKey = relation.localKey;
+				if (emittedKeys.has(fkKey)) continue;
+				let fkType = "string | number";
+				try {
+					let target = relation.target();
+					if (target && (target.default || target.__esModule)) target = target.default || target;
+					if (target && target.properties) {
+						const idProp = Object.entries(target.properties).find(([_, p]) => p.isId);
+						if (idProp) fkType = idProp[1].type === "number" ? "number" : "string";
+					}
+				} catch {}
+				const isRequired = relation.validation?.required;
+				lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? "" : "?"}: ${fkType};`);
+				emittedKeys.add(fkKey);
+			}
+			for (const [key, rawProp] of Object.entries(properties)) if (rawProp.type === "relation") {
+				if (emittedKeys.has(key)) continue;
+				const isArray = resolvedRelations[key]?.cardinality === "many";
+				const relType = "{ id: string | number; path: string; __type: \"relation\"; data?: unknown }";
+				const tsType = isArray ? `Array<${relType}>` : relType;
+				lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);
+				emittedKeys.add(key);
+			}
+			lines.push("    };");
+			lines.push("    Insert: {");
+			emittedKeys.clear();
+			for (const [key, rawProp] of Object.entries(properties)) {
+				const prop = rawProp;
+				if (prop.type === "relation") continue;
+				const tsType = propertyToTypeScriptType(prop);
+				const isRequired = prop.validation?.required;
+				const typedProp = prop;
+				const isAutoId = "isId" in prop && typedProp.isId && typedProp.isId !== "manual" && typedProp.isId !== true;
+				const isOptional = !isRequired || isAutoId;
+				lines.push(`      ${toSafeIdentifier(key)}${isOptional ? "?" : ""}: ${tsType};`);
+				emittedKeys.add(key);
+			}
+			for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+				const fkKey = relation.localKey;
+				if (emittedKeys.has(fkKey)) continue;
+				const fkType = "string | number";
+				const isRequired = relation.validation?.required;
+				lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? "" : "?"}: ${fkType};`);
+				emittedKeys.add(fkKey);
+			}
+			lines.push("    };");
+			lines.push("    Update: {");
+			emittedKeys.clear();
+			for (const [key, rawProp] of Object.entries(properties)) {
+				const prop = rawProp;
+				if (prop.type === "relation") continue;
+				const tsType = propertyToTypeScriptType(prop);
+				lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);
+				emittedKeys.add(key);
+			}
+			for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+				const fkKey = relation.localKey;
+				if (emittedKeys.has(fkKey)) continue;
+				lines.push(`      ${toSafeIdentifier(fkKey)}?: string | number;`);
+				emittedKeys.add(fkKey);
+			}
+			lines.push("    };");
+			lines.push("  };");
+		}
+		lines.push("}");
+		lines.push("");
+		lines.push("export type CollectionName = keyof Database;");
+		lines.push("export type CollectionsDictionary = { [K in CollectionName]: K };");
+		lines.push("");
+		lines.push("export const collectionsDictionary = {");
+		for (const collection of collections) lines.push(`  ${toSafeIdentifier(collection.slug)}: "${collection.slug}",`);
+		lines.push("} as const;");
+		lines.push("");
+		return lines.join("\n");
+	}
+	//#endregion
+	//#region src/index.ts
+	function generateSDK(collections, options = {}) {
+		const files = [];
+		files.push({
+			path: "database.types.ts",
+			content: generateTypedefs(collections)
+		});
+		if (options.includeReadme !== false) files.push({
+			path: "README.md",
+			content: `# Rebase SDK
+
+> Auto-generated by \`rebase generate-sdk\`. Do not edit manually.
+
+## Usage
+
+1. Install the client package:
+   \`\`\`bash
+   npm install @rebasepro/client
+   \`\`\`
+
+2. Initialize with your generated types:
+   \`\`\`typescript
+    import { createRebaseClient } from '@rebasepro/client';
+    import { Database, collectionsDictionary } from './database.types';
+
+    const rebase = createRebaseClient<Database>({
+        baseUrl: 'http://localhost:3001',
+        collections: collectionsDictionary,
+    });
+
+   // Both syntax styles are fully typed!
+   const { data: users } = await rebase.data.users.find();
+   console.log(users[0].email); // flat access — no .values wrapper
+
+   const { data: posts } = await rebase.data.collection('posts').find();
+   console.log(posts[0].title); // just post.title, not post.values.title
+   \`\`\`
+`
+		});
+		return files;
+	}
+	//#endregion
+	exports.generateSDK = generateSDK;
+	exports.generateTypedefs = generateTypedefs;
+	exports.indent = indent;
+	exports.toCamelCase = toCamelCase;
+	exports.toPascalCase = toPascalCase;
+	exports.toSafeIdentifier = toSafeIdentifier;
+});
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/utils.ts","../src/generate-types.ts","../src/index.ts"],"sourcesContent":["/**\n * Utility functions for the SDK generator\n */\n\n/**\n * Convert a slug/snake_case string to PascalCase\n * e.g. \"private_notes\" → \"PrivateNotes\"\n */\nexport function toPascalCase(str: string): string {\n    return str\n        .split(/[_\\-\\s]+/)\n        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n        .join(\"\");\n}\n\n/**\n * Convert a slug/snake_case string to camelCase\n * e.g. \"private_notes\" → \"privateNotes\"\n */\nexport function toCamelCase(str: string): string {\n    if (!/[_\\-\\s]/.test(str)) {\n        return str.charAt(0).toLowerCase() + str.slice(1);\n    }\n    const pascal = toPascalCase(str);\n    return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/**\n * Convert a slug to a safe JS identifier\n * e.g. \"private-notes\" → \"privateNotes\"\n */\nexport function toSafeIdentifier(str: string): string {\n    return toCamelCase(str.replace(/[^a-zA-Z0-9_]/g, \"_\"));\n}\n\n/**\n * Indent a block of text by a given number of spaces\n */\nexport function indent(text: string, spaces: number): string {\n    const pad = \" \".repeat(spaces);\n    return text\n        .split(\"\\n\")\n        .map(line => (line.trim() ? pad + line : line))\n        .join(\"\\n\");\n}\n","import { CollectionConfig, PostgresCollectionConfig, Property, Properties, MapProperty, ArrayProperty, Relation, RelationProperty, StringProperty, NumberProperty } from \"@rebasepro/types\";\nimport { resolveCollectionRelations } from \"@rebasepro/common\";\nimport { toPascalCase, toSafeIdentifier } from \"./utils\";\n\nfunction propertyToTypeScriptType(prop: Property): string {\n    switch (prop.type) {\n        case \"string\": {\n            const sp = prop as StringProperty;\n            if (sp.enum) {\n                const ids = Array.isArray(sp.enum)\n                    ? sp.enum.map((e: string | number | { id: string | number }) => typeof e === \"object\" ? String(e.id) : String(e))\n                    : Object.keys(sp.enum);\n                return ids.map(v => `\"${v}\"`).join(\" | \");\n            }\n            return \"string\";\n        }\n        case \"number\": {\n            const np = prop as NumberProperty;\n            if (np.enum) {\n                const ids = Array.isArray(np.enum)\n                    ? np.enum.map((e: string | number | { id: string | number }) => typeof e === \"object\" ? String(e.id) : String(e))\n                    : Object.keys(np.enum);\n                return ids.join(\" | \");\n            }\n            return \"number\";\n        }\n        case \"boolean\":\n            return \"boolean\";\n        case \"date\":\n            return \"string\"; // ISO 8601 string over the wire\n        case \"geopoint\":\n            return \"{ latitude: number; longitude: number; }\";\n        case \"reference\":\n            return \"string | number\";\n        case \"relation\":\n            return \"string | number\";\n        case \"map\": {\n            const mapProp = prop as MapProperty;\n            if (mapProp.properties) {\n                const inner = Object.entries(mapProp.properties)\n                    .map(([k, v]) => `${toSafeIdentifier(k)}: ${propertyToTypeScriptType(v as Property)};`)\n                    .join(\" \");\n                return `{ ${inner} }`;\n            }\n            return \"Record<string, unknown>\";\n        }\n        case \"array\": {\n            const arrProp = prop as ArrayProperty;\n            if (arrProp.of) {\n                return `Array<${propertyToTypeScriptType(arrProp.of as Property)}>`;\n            }\n            return \"Array<unknown>\";\n        }\n        case \"vector\":\n            return \"number[]\";\n        case \"binary\":\n            return \"string\";\n        default:\n            return \"unknown\";\n    }\n}\n\nexport function generateTypedefs(collections: CollectionConfig[]): string {\n    const lines: string[] = [\n        \"/**\",\n        \" * This file was auto-generated by Rebase.\",\n        \" * Do not make direct changes to the file.\",\n        \" */\",\n        \"\",\n        \"export interface Database {\"\n    ];\n\n    for (const collection of collections) {\n        const typeName = toPascalCase(collection.slug);\n        const properties = (collection.properties ?? {}) as Properties;\n\n        // Resolve relations\n        let resolvedRelations: Record<string, Relation> = {};\n        try {\n            resolvedRelations = resolveCollectionRelations(collection);\n        } catch { /* ignore */ }\n\n        lines.push(`  ${toSafeIdentifier(collection.slug)}: {`);\n\n        // ── Row Type ──\n        lines.push(\"    Row: {\");\n        const emittedKeys = new Set<string>();\n\n        // 1. Direct properties\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n\n            const tsType = propertyToTypeScriptType(prop);\n            const isRequired = prop.validation?.required;\n            lines.push(`      ${toSafeIdentifier(key)}${isRequired ? \"\" : \"?\"}: ${tsType};`);\n            emittedKeys.add(key);\n        }\n\n        // 2. FK columns from relations\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n\n                let fkType = \"string | number\";\n                try {\n                    let target = relation.target();\n                    if (target && (target.default || target.__esModule)) {\n                        target = target.default || target;\n                    }\n                    if (target && target.properties) {\n                        const idProp = Object.entries(target.properties).find(([_, p]) => (p as Record<string, unknown>).isId);\n                        if (idProp) {\n                            fkType = (idProp[1] as Property).type === \"number\" ? \"number\" : \"string\";\n                        }\n                    }\n                } catch { /* ignore */ }\n\n                const isRequired = relation.validation?.required;\n                lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? \"\" : \"?\"}: ${fkType};`);\n                emittedKeys.add(fkKey);\n            }\n        }\n\n        // 3. Relation fields\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") {\n                if (emittedKeys.has(key)) continue;\n                const relation = resolvedRelations[key];\n                const isArray = relation?.cardinality === \"many\";\n                const relType = \"{ id: string | number; path: string; __type: \\\"relation\\\"; data?: unknown }\";\n                const tsType = isArray ? `Array<${relType}>` : relType;\n                lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);\n                emittedKeys.add(key);\n            }\n        }\n        lines.push(\"    };\");\n\n        // ── Insert Type ──\n        lines.push(\"    Insert: {\");\n        emittedKeys.clear();\n\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n            const tsType = propertyToTypeScriptType(prop);\n            const isRequired = prop.validation?.required;\n            const typedProp = prop as StringProperty | NumberProperty;\n            const isAutoId = \"isId\" in prop && typedProp.isId && typedProp.isId !== \"manual\" && typedProp.isId !== true;\n            const isOptional = !isRequired || isAutoId;\n            lines.push(`      ${toSafeIdentifier(key)}${isOptional ? \"?\" : \"\"}: ${tsType};`);\n            emittedKeys.add(key);\n        }\n\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n                const fkType = \"string | number\";\n                // simple fallback\n                const isRequired = relation.validation?.required;\n                lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? \"\" : \"?\"}: ${fkType};`);\n                emittedKeys.add(fkKey);\n            }\n        }\n        lines.push(\"    };\");\n\n        // ── Update Type ──\n        lines.push(\"    Update: {\");\n        emittedKeys.clear();\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n            const tsType = propertyToTypeScriptType(prop);\n            lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);\n            emittedKeys.add(key);\n        }\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n                lines.push(`      ${toSafeIdentifier(fkKey)}?: string | number;`);\n                emittedKeys.add(fkKey);\n            }\n        }\n        lines.push(\"    };\");\n\n        lines.push(\"  };\");\n    }\n\n    lines.push(\"}\");\n    lines.push(\"\");\n    lines.push(\"export type CollectionName = keyof Database;\");\n    lines.push(\"export type CollectionsDictionary = { [K in CollectionName]: K };\");\n    lines.push(\"\");\n    lines.push(\"export const collectionsDictionary = {\");\n    for (const collection of collections) {\n        lines.push(`  ${toSafeIdentifier(collection.slug)}: \"${collection.slug}\",`);\n    }\n    lines.push(\"} as const;\");\n    lines.push(\"\");\n\n    return lines.join(\"\\n\");\n}\n","/**\n * @rebasepro/codegen\n *\n * Generates a purely typed Typescript database definition.\n */\n\nimport { CollectionConfig } from \"@rebasepro/types\";\nimport { generateTypedefs } from \"./generate-types\";\n\nexport { generateTypedefs } from \"./generate-types\";\nexport { toPascalCase, toCamelCase, toSafeIdentifier, indent } from \"./utils\";\n\n// ─── Public API ────────────────────────────────────────────────────\n\nexport interface GeneratedFile {\n    /** Relative file path within the output directory */\n    path: string;\n    /** File content */\n    content: string;\n}\n\nexport interface GenerateSDKOptions {\n    /** Whether to include a README file (default: true) */\n    includeReadme?: boolean;\n}\n\nexport function generateSDK(\n    collections: CollectionConfig[],\n    options: GenerateSDKOptions = {}\n): GeneratedFile[] {\n    const files: GeneratedFile[] = [];\n\n    files.push({\n        path: \"database.types.ts\",\n        content: generateTypedefs(collections)\n    });\n\n    if (options.includeReadme !== false) {\n        files.push({\n            path: \"README.md\",\n            content: `# Rebase SDK\n\n> Auto-generated by \\`rebase generate-sdk\\`. Do not edit manually.\n\n## Usage\n\n1. Install the client package:\n   \\`\\`\\`bash\n   npm install @rebasepro/client\n   \\`\\`\\`\n\n2. Initialize with your generated types:\n   \\`\\`\\`typescript\n    import { createRebaseClient } from '@rebasepro/client';\n    import { Database, collectionsDictionary } from './database.types';\n\n    const rebase = createRebaseClient<Database>({\n        baseUrl: 'http://localhost:3001',\n        collections: collectionsDictionary,\n    });\n\n   // Both syntax styles are fully typed!\n   const { data: users } = await rebase.data.users.find();\n   console.log(users[0].email); // flat access — no .values wrapper\n\n   const { data: posts } = await rebase.data.collection('posts').find();\n   console.log(posts[0].title); // just post.title, not post.values.title\n   \\`\\`\\`\n`\n        });\n    }\n\n    return files;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @rebasepro/codegen
+ *
+ * Generates a purely typed Typescript database definition.
+ */
+import { CollectionConfig } from "@rebasepro/types";
+export { generateTypedefs } from "./generate-types";
+export { toPascalCase, toCamelCase, toSafeIdentifier, indent } from "./utils";
+export interface GeneratedFile {
+    /** Relative file path within the output directory */
+    path: string;
+    /** File content */
+    content: string;
+}
+export interface GenerateSDKOptions {
+    /** Whether to include a README file (default: true) */
+    includeReadme?: boolean;
+}
+export declare function generateSDK(collections: CollectionConfig[], options?: GenerateSDKOptions): GeneratedFile[];

package/dist/index.es.js

@@ -0,0 +1,218 @@
+import { resolveCollectionRelations } from "@rebasepro/common";
+//#region src/utils.ts
+/**
+* Utility functions for the SDK generator
+*/
+/**
+* Convert a slug/snake_case string to PascalCase
+* e.g. "private_notes" → "PrivateNotes"
+*/
+function toPascalCase(str) {
+	return str.split(/[_\-\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+}
+/**
+* Convert a slug/snake_case string to camelCase
+* e.g. "private_notes" → "privateNotes"
+*/
+function toCamelCase(str) {
+	if (!/[_\-\s]/.test(str)) return str.charAt(0).toLowerCase() + str.slice(1);
+	const pascal = toPascalCase(str);
+	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+* Convert a slug to a safe JS identifier
+* e.g. "private-notes" → "privateNotes"
+*/
+function toSafeIdentifier(str) {
+	return toCamelCase(str.replace(/[^a-zA-Z0-9_]/g, "_"));
+}
+/**
+* Indent a block of text by a given number of spaces
+*/
+function indent(text, spaces) {
+	const pad = " ".repeat(spaces);
+	return text.split("\n").map((line) => line.trim() ? pad + line : line).join("\n");
+}
+//#endregion
+//#region src/generate-types.ts
+function propertyToTypeScriptType(prop) {
+	switch (prop.type) {
+		case "string": {
+			const sp = prop;
+			if (sp.enum) return (Array.isArray(sp.enum) ? sp.enum.map((e) => typeof e === "object" ? String(e.id) : String(e)) : Object.keys(sp.enum)).map((v) => `"${v}"`).join(" | ");
+			return "string";
+		}
+		case "number": {
+			const np = prop;
+			if (np.enum) return (Array.isArray(np.enum) ? np.enum.map((e) => typeof e === "object" ? String(e.id) : String(e)) : Object.keys(np.enum)).join(" | ");
+			return "number";
+		}
+		case "boolean": return "boolean";
+		case "date": return "string";
+		case "geopoint": return "{ latitude: number; longitude: number; }";
+		case "reference": return "string | number";
+		case "relation": return "string | number";
+		case "map": {
+			const mapProp = prop;
+			if (mapProp.properties) return `{ ${Object.entries(mapProp.properties).map(([k, v]) => `${toSafeIdentifier(k)}: ${propertyToTypeScriptType(v)};`).join(" ")} }`;
+			return "Record<string, unknown>";
+		}
+		case "array": {
+			const arrProp = prop;
+			if (arrProp.of) return `Array<${propertyToTypeScriptType(arrProp.of)}>`;
+			return "Array<unknown>";
+		}
+		case "vector": return "number[]";
+		case "binary": return "string";
+		default: return "unknown";
+	}
+}
+function generateTypedefs(collections) {
+	const lines = [
+		"/**",
+		" * This file was auto-generated by Rebase.",
+		" * Do not make direct changes to the file.",
+		" */",
+		"",
+		"export interface Database {"
+	];
+	for (const collection of collections) {
+		toPascalCase(collection.slug);
+		const properties = collection.properties ?? {};
+		let resolvedRelations = {};
+		try {
+			resolvedRelations = resolveCollectionRelations(collection);
+		} catch {}
+		lines.push(`  ${toSafeIdentifier(collection.slug)}: {`);
+		lines.push("    Row: {");
+		const emittedKeys = /* @__PURE__ */ new Set();
+		for (const [key, rawProp] of Object.entries(properties)) {
+			const prop = rawProp;
+			if (prop.type === "relation") continue;
+			const tsType = propertyToTypeScriptType(prop);
+			const isRequired = prop.validation?.required;
+			lines.push(`      ${toSafeIdentifier(key)}${isRequired ? "" : "?"}: ${tsType};`);
+			emittedKeys.add(key);
+		}
+		for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+			const fkKey = relation.localKey;
+			if (emittedKeys.has(fkKey)) continue;
+			let fkType = "string | number";
+			try {
+				let target = relation.target();
+				if (target && (target.default || target.__esModule)) target = target.default || target;
+				if (target && target.properties) {
+					const idProp = Object.entries(target.properties).find(([_, p]) => p.isId);
+					if (idProp) fkType = idProp[1].type === "number" ? "number" : "string";
+				}
+			} catch {}
+			const isRequired = relation.validation?.required;
+			lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? "" : "?"}: ${fkType};`);
+			emittedKeys.add(fkKey);
+		}
+		for (const [key, rawProp] of Object.entries(properties)) if (rawProp.type === "relation") {
+			if (emittedKeys.has(key)) continue;
+			const isArray = resolvedRelations[key]?.cardinality === "many";
+			const relType = "{ id: string | number; path: string; __type: \"relation\"; data?: unknown }";
+			const tsType = isArray ? `Array<${relType}>` : relType;
+			lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);
+			emittedKeys.add(key);
+		}
+		lines.push("    };");
+		lines.push("    Insert: {");
+		emittedKeys.clear();
+		for (const [key, rawProp] of Object.entries(properties)) {
+			const prop = rawProp;
+			if (prop.type === "relation") continue;
+			const tsType = propertyToTypeScriptType(prop);
+			const isRequired = prop.validation?.required;
+			const typedProp = prop;
+			const isAutoId = "isId" in prop && typedProp.isId && typedProp.isId !== "manual" && typedProp.isId !== true;
+			const isOptional = !isRequired || isAutoId;
+			lines.push(`      ${toSafeIdentifier(key)}${isOptional ? "?" : ""}: ${tsType};`);
+			emittedKeys.add(key);
+		}
+		for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+			const fkKey = relation.localKey;
+			if (emittedKeys.has(fkKey)) continue;
+			const fkType = "string | number";
+			const isRequired = relation.validation?.required;
+			lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? "" : "?"}: ${fkType};`);
+			emittedKeys.add(fkKey);
+		}
+		lines.push("    };");
+		lines.push("    Update: {");
+		emittedKeys.clear();
+		for (const [key, rawProp] of Object.entries(properties)) {
+			const prop = rawProp;
+			if (prop.type === "relation") continue;
+			const tsType = propertyToTypeScriptType(prop);
+			lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);
+			emittedKeys.add(key);
+		}
+		for (const [relKey, relation] of Object.entries(resolvedRelations)) if (relation.direction === "owning" && relation.cardinality === "one" && relation.localKey) {
+			const fkKey = relation.localKey;
+			if (emittedKeys.has(fkKey)) continue;
+			lines.push(`      ${toSafeIdentifier(fkKey)}?: string | number;`);
+			emittedKeys.add(fkKey);
+		}
+		lines.push("    };");
+		lines.push("  };");
+	}
+	lines.push("}");
+	lines.push("");
+	lines.push("export type CollectionName = keyof Database;");
+	lines.push("export type CollectionsDictionary = { [K in CollectionName]: K };");
+	lines.push("");
+	lines.push("export const collectionsDictionary = {");
+	for (const collection of collections) lines.push(`  ${toSafeIdentifier(collection.slug)}: "${collection.slug}",`);
+	lines.push("} as const;");
+	lines.push("");
+	return lines.join("\n");
+}
+//#endregion
+//#region src/index.ts
+function generateSDK(collections, options = {}) {
+	const files = [];
+	files.push({
+		path: "database.types.ts",
+		content: generateTypedefs(collections)
+	});
+	if (options.includeReadme !== false) files.push({
+		path: "README.md",
+		content: `# Rebase SDK
+
+> Auto-generated by \`rebase generate-sdk\`. Do not edit manually.
+
+## Usage
+
+1. Install the client package:
+   \`\`\`bash
+   npm install @rebasepro/client
+   \`\`\`
+
+2. Initialize with your generated types:
+   \`\`\`typescript
+    import { createRebaseClient } from '@rebasepro/client';
+    import { Database, collectionsDictionary } from './database.types';
+
+    const rebase = createRebaseClient<Database>({
+        baseUrl: 'http://localhost:3001',
+        collections: collectionsDictionary,
+    });
+
+   // Both syntax styles are fully typed!
+   const { data: users } = await rebase.data.users.find();
+   console.log(users[0].email); // flat access — no .values wrapper
+
+   const { data: posts } = await rebase.data.collection('posts').find();
+   console.log(posts[0].title); // just post.title, not post.values.title
+   \`\`\`
+`
+	});
+	return files;
+}
+//#endregion
+export { generateSDK, generateTypedefs, indent, toCamelCase, toPascalCase, toSafeIdentifier };
+
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","names":[],"sources":["../src/utils.ts","../src/generate-types.ts","../src/index.ts"],"sourcesContent":["/**\n * Utility functions for the SDK generator\n */\n\n/**\n * Convert a slug/snake_case string to PascalCase\n * e.g. \"private_notes\" → \"PrivateNotes\"\n */\nexport function toPascalCase(str: string): string {\n    return str\n        .split(/[_\\-\\s]+/)\n        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n        .join(\"\");\n}\n\n/**\n * Convert a slug/snake_case string to camelCase\n * e.g. \"private_notes\" → \"privateNotes\"\n */\nexport function toCamelCase(str: string): string {\n    if (!/[_\\-\\s]/.test(str)) {\n        return str.charAt(0).toLowerCase() + str.slice(1);\n    }\n    const pascal = toPascalCase(str);\n    return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/**\n * Convert a slug to a safe JS identifier\n * e.g. \"private-notes\" → \"privateNotes\"\n */\nexport function toSafeIdentifier(str: string): string {\n    return toCamelCase(str.replace(/[^a-zA-Z0-9_]/g, \"_\"));\n}\n\n/**\n * Indent a block of text by a given number of spaces\n */\nexport function indent(text: string, spaces: number): string {\n    const pad = \" \".repeat(spaces);\n    return text\n        .split(\"\\n\")\n        .map(line => (line.trim() ? pad + line : line))\n        .join(\"\\n\");\n}\n","import { CollectionConfig, PostgresCollectionConfig, Property, Properties, MapProperty, ArrayProperty, Relation, RelationProperty, StringProperty, NumberProperty } from \"@rebasepro/types\";\nimport { resolveCollectionRelations } from \"@rebasepro/common\";\nimport { toPascalCase, toSafeIdentifier } from \"./utils\";\n\nfunction propertyToTypeScriptType(prop: Property): string {\n    switch (prop.type) {\n        case \"string\": {\n            const sp = prop as StringProperty;\n            if (sp.enum) {\n                const ids = Array.isArray(sp.enum)\n                    ? sp.enum.map((e: string | number | { id: string | number }) => typeof e === \"object\" ? String(e.id) : String(e))\n                    : Object.keys(sp.enum);\n                return ids.map(v => `\"${v}\"`).join(\" | \");\n            }\n            return \"string\";\n        }\n        case \"number\": {\n            const np = prop as NumberProperty;\n            if (np.enum) {\n                const ids = Array.isArray(np.enum)\n                    ? np.enum.map((e: string | number | { id: string | number }) => typeof e === \"object\" ? String(e.id) : String(e))\n                    : Object.keys(np.enum);\n                return ids.join(\" | \");\n            }\n            return \"number\";\n        }\n        case \"boolean\":\n            return \"boolean\";\n        case \"date\":\n            return \"string\"; // ISO 8601 string over the wire\n        case \"geopoint\":\n            return \"{ latitude: number; longitude: number; }\";\n        case \"reference\":\n            return \"string | number\";\n        case \"relation\":\n            return \"string | number\";\n        case \"map\": {\n            const mapProp = prop as MapProperty;\n            if (mapProp.properties) {\n                const inner = Object.entries(mapProp.properties)\n                    .map(([k, v]) => `${toSafeIdentifier(k)}: ${propertyToTypeScriptType(v as Property)};`)\n                    .join(\" \");\n                return `{ ${inner} }`;\n            }\n            return \"Record<string, unknown>\";\n        }\n        case \"array\": {\n            const arrProp = prop as ArrayProperty;\n            if (arrProp.of) {\n                return `Array<${propertyToTypeScriptType(arrProp.of as Property)}>`;\n            }\n            return \"Array<unknown>\";\n        }\n        case \"vector\":\n            return \"number[]\";\n        case \"binary\":\n            return \"string\";\n        default:\n            return \"unknown\";\n    }\n}\n\nexport function generateTypedefs(collections: CollectionConfig[]): string {\n    const lines: string[] = [\n        \"/**\",\n        \" * This file was auto-generated by Rebase.\",\n        \" * Do not make direct changes to the file.\",\n        \" */\",\n        \"\",\n        \"export interface Database {\"\n    ];\n\n    for (const collection of collections) {\n        const typeName = toPascalCase(collection.slug);\n        const properties = (collection.properties ?? {}) as Properties;\n\n        // Resolve relations\n        let resolvedRelations: Record<string, Relation> = {};\n        try {\n            resolvedRelations = resolveCollectionRelations(collection);\n        } catch { /* ignore */ }\n\n        lines.push(`  ${toSafeIdentifier(collection.slug)}: {`);\n\n        // ── Row Type ──\n        lines.push(\"    Row: {\");\n        const emittedKeys = new Set<string>();\n\n        // 1. Direct properties\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n\n            const tsType = propertyToTypeScriptType(prop);\n            const isRequired = prop.validation?.required;\n            lines.push(`      ${toSafeIdentifier(key)}${isRequired ? \"\" : \"?\"}: ${tsType};`);\n            emittedKeys.add(key);\n        }\n\n        // 2. FK columns from relations\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n\n                let fkType = \"string | number\";\n                try {\n                    let target = relation.target();\n                    if (target && (target.default || target.__esModule)) {\n                        target = target.default || target;\n                    }\n                    if (target && target.properties) {\n                        const idProp = Object.entries(target.properties).find(([_, p]) => (p as Record<string, unknown>).isId);\n                        if (idProp) {\n                            fkType = (idProp[1] as Property).type === \"number\" ? \"number\" : \"string\";\n                        }\n                    }\n                } catch { /* ignore */ }\n\n                const isRequired = relation.validation?.required;\n                lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? \"\" : \"?\"}: ${fkType};`);\n                emittedKeys.add(fkKey);\n            }\n        }\n\n        // 3. Relation fields\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") {\n                if (emittedKeys.has(key)) continue;\n                const relation = resolvedRelations[key];\n                const isArray = relation?.cardinality === \"many\";\n                const relType = \"{ id: string | number; path: string; __type: \\\"relation\\\"; data?: unknown }\";\n                const tsType = isArray ? `Array<${relType}>` : relType;\n                lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);\n                emittedKeys.add(key);\n            }\n        }\n        lines.push(\"    };\");\n\n        // ── Insert Type ──\n        lines.push(\"    Insert: {\");\n        emittedKeys.clear();\n\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n            const tsType = propertyToTypeScriptType(prop);\n            const isRequired = prop.validation?.required;\n            const typedProp = prop as StringProperty | NumberProperty;\n            const isAutoId = \"isId\" in prop && typedProp.isId && typedProp.isId !== \"manual\" && typedProp.isId !== true;\n            const isOptional = !isRequired || isAutoId;\n            lines.push(`      ${toSafeIdentifier(key)}${isOptional ? \"?\" : \"\"}: ${tsType};`);\n            emittedKeys.add(key);\n        }\n\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n                const fkType = \"string | number\";\n                // simple fallback\n                const isRequired = relation.validation?.required;\n                lines.push(`      ${toSafeIdentifier(fkKey)}${isRequired ? \"\" : \"?\"}: ${fkType};`);\n                emittedKeys.add(fkKey);\n            }\n        }\n        lines.push(\"    };\");\n\n        // ── Update Type ──\n        lines.push(\"    Update: {\");\n        emittedKeys.clear();\n        for (const [key, rawProp] of Object.entries(properties)) {\n            const prop = rawProp as Property;\n            if (prop.type === \"relation\") continue;\n            const tsType = propertyToTypeScriptType(prop);\n            lines.push(`      ${toSafeIdentifier(key)}?: ${tsType};`);\n            emittedKeys.add(key);\n        }\n        for (const [relKey, relation] of Object.entries(resolvedRelations)) {\n            if (relation.direction === \"owning\" && relation.cardinality === \"one\" && relation.localKey) {\n                const fkKey = relation.localKey;\n                if (emittedKeys.has(fkKey)) continue;\n                lines.push(`      ${toSafeIdentifier(fkKey)}?: string | number;`);\n                emittedKeys.add(fkKey);\n            }\n        }\n        lines.push(\"    };\");\n\n        lines.push(\"  };\");\n    }\n\n    lines.push(\"}\");\n    lines.push(\"\");\n    lines.push(\"export type CollectionName = keyof Database;\");\n    lines.push(\"export type CollectionsDictionary = { [K in CollectionName]: K };\");\n    lines.push(\"\");\n    lines.push(\"export const collectionsDictionary = {\");\n    for (const collection of collections) {\n        lines.push(`  ${toSafeIdentifier(collection.slug)}: \"${collection.slug}\",`);\n    }\n    lines.push(\"} as const;\");\n    lines.push(\"\");\n\n    return lines.join(\"\\n\");\n}\n","/**\n * @rebasepro/codegen\n *\n * Generates a purely typed Typescript database definition.\n */\n\nimport { CollectionConfig } from \"@rebasepro/types\";\nimport { generateTypedefs } from \"./generate-types\";\n\nexport { generateTypedefs } from \"./generate-types\";\nexport { toPascalCase, toCamelCase, toSafeIdentifier, indent } from \"./utils\";\n\n// ─── Public API ────────────────────────────────────────────────────\n\nexport interface GeneratedFile {\n    /** Relative file path within the output directory */\n    path: string;\n    /** File content */\n    content: string;\n}\n\nexport interface GenerateSDKOptions {\n    /** Whether to include a README file (default: true) */\n    includeReadme?: boolean;\n}\n\nexport function generateSDK(\n    collections: CollectionConfig[],\n    options: GenerateSDKOptions = {}\n): GeneratedFile[] {\n    const files: GeneratedFile[] = [];\n\n    files.push({\n        path: \"database.types.ts\",\n        content: generateTypedefs(collections)\n    });\n\n    if (options.includeReadme !== false) {\n        files.push({\n            path: \"README.md\",\n            content: `# Rebase SDK\n\n> Auto-generated by \\`rebase generate-sdk\\`. Do not edit manually.\n\n## Usage\n\n1. Install the client package:\n   \\`\\`\\`bash\n   npm install @rebasepro/client\n   \\`\\`\\`\n\n2. Initialize with your generated types:\n   \\`\\`\\`typescript\n    import { createRebaseClient } from '@rebasepro/client';\n    import { Database, collectionsDictionary } from './database.types';\n\n    const rebase = createRebaseClient<Database>({\n        baseUrl: 'http://localhost:3001',\n        collections: collectionsDictionary,\n    });\n\n   // Both syntax styles are fully typed!\n   const { data: users } = await rebase.data.users.find();\n   console.log(users[0].email); // flat access — no .values wrapper\n\n   const { data: posts } = await rebase.data.collection('posts').find();\n   console.log(posts[0].title); // just post.title, not post.values.title\n   \\`\\`\\`\n`\n        });\n    }\n\n    return files;\n}\n"],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utility functions for the SDK generator
+ */
+/**
+ * Convert a slug/snake_case string to PascalCase
+ * e.g. "private_notes" → "PrivateNotes"
+ */
+export declare function toPascalCase(str: string): string;
+/**
+ * Convert a slug/snake_case string to camelCase
+ * e.g. "private_notes" → "privateNotes"
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Convert a slug to a safe JS identifier
+ * e.g. "private-notes" → "privateNotes"
+ */
+export declare function toSafeIdentifier(str: string): string;
+/**
+ * Indent a block of text by a given number of spaces
+ */
+export declare function indent(text: string, spaces: number): string;

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@rebasepro/codegen",
+  "version": "0.0.1-canary.4829d6e",
+  "description": "Generate a typed JS SDK from Rebase collection definitions",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "source": "src/index.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sdk",
+    "codegen",
+    "rebase",
+    "rest-api"
+  ],
+  "author": "rebase.pro",
+  "license": "MIT",
+  "peerDependencies": {
+    "@rebasepro/common": "0.0.1-canary.4829d6e",
+    "@rebasepro/types": "0.0.1-canary.4829d6e"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.4.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.3",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.16",
+    "@rebasepro/common": "0.0.1-canary.4829d6e",
+    "@rebasepro/types": "0.0.1-canary.4829d6e"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "gitHead": "d935eefa5aa8d1009a2398cfac2c1e4ee9aeb6b6",
+  "dependencies": {
+    "@rebasepro/client": "0.0.1-canary.4829d6e"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rebasepro/rebase.git",
+    "directory": "packages/codegen"
+  },
+  "scripts": {
+    "test": "jest --config jest.config.cjs",
+    "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.prod.json",
+    "clean": "rm -rf dist && find ./src -name '*.js' -type f | xargs rm -f"
+  }
+}