@rebasepro/server-core 0.7.0 → 0.9.0

package/dist/schema-editor-routes-D3ef8zu1.js

@@ -0,0 +1,219 @@
+import { createRequire as __createRequire } from "module";
+import "process";
+__createRequire(import.meta.url);
+import { errorHandler } from "./index.es.js";
+import * as fs$1 from "fs";
+import * as path$1 from "path";
+import { Hono } from "hono";
+import { IndentationText, Project, SyntaxKind } from "ts-morph";
+//#region src/api/ast-schema-editor.ts
+var AstSchemaEditor = class {
+	project;
+	collectionsDir;
+	constructor(collectionsDir) {
+		this.project = new Project({ manipulationSettings: { indentationText: IndentationText.FourSpaces } });
+		if (fs$1.existsSync(collectionsDir)) this.project.addSourceFilesAtPaths(`${collectionsDir}/**/*.ts`);
+		this.collectionsDir = path$1.resolve(collectionsDir);
+	}
+	/**
+	* Sanitize collectionId to prevent path traversal attacks.
+	* Only allows alphanumeric characters, underscores, and hyphens.
+	*/
+	sanitizeCollectionId(collectionId) {
+		const sanitized = collectionId.replace(/[^a-zA-Z0-9_-]/g, "");
+		if (!sanitized || sanitized !== collectionId) throw new Error(`Invalid collection ID: "${collectionId}". Only alphanumeric characters, underscores, and hyphens are allowed.`);
+		return sanitized;
+	}
+	/**
+	* Resolve a file path and ensure it falls within the collectionsDir.
+	*/
+	safePath(filename) {
+		const resolved = path$1.resolve(this.collectionsDir, filename);
+		if (!resolved.startsWith(this.collectionsDir + path$1.sep) && resolved !== this.collectionsDir) throw new Error("Path traversal detected: resolved path is outside the collections directory.");
+		return resolved;
+	}
+	getCollectionFile(collectionId) {
+		const safeId = this.sanitizeCollectionId(collectionId);
+		const filePath = this.safePath(`${safeId}.ts`);
+		let file = this.project.getSourceFile(filePath);
+		if (!file && fs$1.existsSync(filePath)) {
+			this.project.addSourceFilesAtPaths(`${this.collectionsDir}/**/*.ts`);
+			file = this.project.getSourceFile(filePath);
+		}
+		return file;
+	}
+	getCollectionObject(collectionId) {
+		const file = this.getCollectionFile(collectionId);
+		if (!file) return null;
+		const defaultExport = file.getDefaultExportSymbol();
+		if (defaultExport) {
+			const declaration = defaultExport.getDeclarations()[0];
+			if (declaration && declaration.getKind() === SyntaxKind.ExportAssignment) {
+				const expr = declaration.asKind(SyntaxKind.ExportAssignment)?.getExpression();
+				if (expr && expr.getKind() === SyntaxKind.Identifier) {
+					const varName = expr.getText();
+					return file.getVariableDeclaration(varName)?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression) || null;
+				}
+			}
+		}
+		const varDecls = file.getVariableDeclarations();
+		for (const varDecl of varDecls) {
+			const init = varDecl.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+			if (init) return init;
+		}
+		return null;
+	}
+	convertJsonToAstString(obj, indentLevel = 0, oldAstNode) {
+		const indentStr = "    ";
+		const indent = indentStr.repeat(indentLevel);
+		const innerIndent = indentStr.repeat(indentLevel + 1);
+		if (obj === null || obj === void 0) return "undefined";
+		if (typeof obj === "string") return JSON.stringify(obj);
+		if (typeof obj === "number" || typeof obj === "boolean") return String(obj);
+		if (Array.isArray(obj)) {
+			if (obj.length === 0) return "[]";
+			return `[\n${innerIndent}${obj.map((item) => this.convertJsonToAstString(item, indentLevel + 1)).join(`,\n${innerIndent}`)}\n${indent}]`;
+		}
+		if (typeof obj === "object") {
+			const record = obj;
+			const keys = Object.keys(record);
+			const preservedProps = [];
+			if (oldAstNode) {
+				const oldProps = oldAstNode.getProperties();
+				for (const oldProp of oldProps) if (oldProp.isKind(SyntaxKind.PropertyAssignment)) {
+					let name = oldProp.getNameNode().getText();
+					if (name.startsWith("\"") && name.endsWith("\"")) name = name.slice(1, -1);
+					if (name.startsWith("'") && name.endsWith("'")) name = name.slice(1, -1);
+					if (!(name in record)) {
+						const init = oldProp.getInitializer();
+						if (init) {
+							const kind = init.getKind();
+							if (kind === SyntaxKind.ArrowFunction || kind === SyntaxKind.FunctionExpression || kind === SyntaxKind.Identifier || kind === SyntaxKind.CallExpression || kind === SyntaxKind.JsxElement || name === "target" || name === "callbacks" || name === "permissions" || name === "securityRules") {
+								const keyStr = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
+								preservedProps.push(`${keyStr}: ${init.getText()}`);
+							}
+						}
+					}
+				}
+			}
+			if (keys.length === 0 && preservedProps.length === 0) return "{}";
+			return `{\n${innerIndent}${[...keys.map((key) => {
+				const keyStr = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+				let childAstNode;
+				if (oldAstNode && typeof record[key] === "object" && record[key] !== null && !Array.isArray(record[key])) {
+					const oldProp = oldAstNode.getProperty((p) => "getName" in p && typeof p.getName === "function" && (p.getName() === key || p.getName() === `"${key}"` || p.getName() === `'${key}'`));
+					if (oldProp && oldProp.isKind(SyntaxKind.PropertyAssignment)) childAstNode = oldProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+				}
+				return `${keyStr}: ${this.convertJsonToAstString(record[key], indentLevel + 1, childAstNode)}`;
+			}), ...preservedProps].join(`,\n${innerIndent}`)}\n${indent}}`;
+		}
+		return "undefined";
+	}
+	async saveProperty(collectionId, propertyKey, propertyConfig) {
+		const collectionObj = this.getCollectionObject(collectionId);
+		if (!collectionObj) throw new Error(`Collection ${collectionId} not found in ATS workspace.`);
+		let propertiesProp = collectionObj.getProperty("properties");
+		if (!propertiesProp) propertiesProp = collectionObj.addPropertyAssignment({
+			name: "properties",
+			initializer: "{}"
+		});
+		const propsObj = propertiesProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+		if (propsObj) {
+			const existingProp = propsObj.getProperty((p) => "getName" in p && typeof p.getName === "function" && (p.getName() === propertyKey || p.getName() === `"${propertyKey}"`));
+			let oldPropAstNode;
+			if (existingProp && existingProp.isKind(SyntaxKind.PropertyAssignment)) oldPropAstNode = existingProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+			const newInitializer = this.convertJsonToAstString(propertyConfig, 2, oldPropAstNode);
+			if (existingProp) {
+				if (existingProp.isKind(SyntaxKind.PropertyAssignment)) existingProp.setInitializer(newInitializer);
+			} else propsObj.addPropertyAssignment({
+				name: /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(propertyKey) ? propertyKey : JSON.stringify(propertyKey),
+				initializer: newInitializer
+			});
+			const file = this.getCollectionFile(collectionId);
+			if (file) file.formatText();
+			await this.project.save();
+		}
+	}
+	async deleteProperty(collectionId, propertyKey) {
+		const collectionObj = this.getCollectionObject(collectionId);
+		if (!collectionObj) return;
+		const propertiesProp = collectionObj.getProperty("properties");
+		if (propertiesProp) {
+			const propsObj = propertiesProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+			if (propsObj) {
+				const existingProp = propsObj.getProperty((p) => "getName" in p && typeof p.getName === "function" && (p.getName() === propertyKey || p.getName() === `"${propertyKey}"`));
+				if (existingProp) {
+					existingProp.remove();
+					const file = this.getCollectionFile(collectionId);
+					if (file) file.formatText();
+					await this.project.save();
+				}
+			}
+		}
+	}
+	async saveCollection(collectionId, collectionData) {
+		let file = this.getCollectionFile(collectionId);
+		const collectionObj = this.getCollectionObject(collectionId);
+		if (!file || !collectionObj) {
+			const safeId = this.sanitizeCollectionId(collectionId);
+			const newFilePath = this.safePath(`${safeId}.ts`);
+			file = this.project.createSourceFile(newFilePath, `import { CollectionConfig } from "@rebasepro/types";\n\nconst ${safeId}Collection: CollectionConfig = ${this.convertJsonToAstString(collectionData)};\n\nexport default ${safeId}Collection;\n`, { overwrite: true });
+		} else {
+			if (!("securityRules" in collectionData) || collectionData.securityRules === void 0 || Array.isArray(collectionData.securityRules) && collectionData.securityRules.length === 0) {
+				const srProp = collectionObj.getProperty("securityRules");
+				if (srProp) srProp.remove();
+				delete collectionData["securityRules"];
+			}
+			for (const key of Object.keys(collectionData)) {
+				if (key === "relations") continue;
+				const prop = collectionObj.getProperty(key);
+				let oldAstNode;
+				if (prop && prop.isKind(SyntaxKind.PropertyAssignment)) oldAstNode = prop.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+				const newInit = this.convertJsonToAstString(collectionData[key], 1, oldAstNode);
+				if (prop) prop.setInitializer(newInit);
+				else collectionObj.addPropertyAssignment({
+					name: key,
+					initializer: newInit
+				});
+			}
+		}
+		if (file) file.formatText();
+		await this.project.save();
+	}
+	async deleteCollection(collectionId) {
+		const file = this.getCollectionFile(collectionId);
+		if (file) file.deleteImmediatelySync();
+	}
+};
+//#endregion
+//#region src/api/schema-editor-routes.ts
+function createSchemaEditorRoutes(collectionsDir) {
+	const router = new Hono();
+	router.onError(errorHandler);
+	const editor = new AstSchemaEditor(collectionsDir);
+	router.post("/property/save", async (c) => {
+		const { collectionId, propertyKey, propertyConfig } = await c.req.json();
+		await editor.saveProperty(collectionId, propertyKey, propertyConfig);
+		return c.json({ success: true });
+	});
+	router.post("/property/delete", async (c) => {
+		const { collectionId, propertyKey } = await c.req.json();
+		await editor.deleteProperty(collectionId, propertyKey);
+		return c.json({ success: true });
+	});
+	router.post("/collection/save", async (c) => {
+		const { collectionId, collectionData } = await c.req.json();
+		await editor.saveCollection(collectionId, collectionData);
+		return c.json({ success: true });
+	});
+	router.post("/collection/delete", async (c) => {
+		const { collectionId } = await c.req.json();
+		await editor.deleteCollection(collectionId);
+		return c.json({ success: true });
+	});
+	return router;
+}
+//#endregion
+export { createSchemaEditorRoutes };
+
+//# sourceMappingURL=schema-editor-routes-D3ef8zu1.js.map

package/dist/schema-editor-routes-D3ef8zu1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-editor-routes-D3ef8zu1.js","names":[],"sources":["../src/api/ast-schema-editor.ts","../src/api/schema-editor-routes.ts"],"sourcesContent":["import { Project, SyntaxKind, ObjectLiteralExpression, ObjectLiteralElementLike, PropertyAssignment, VariableDeclaration, IndentationText } from \"ts-morph\";\nimport * as path from \"path\";\nimport * as fs from \"fs\";\n\nexport class AstSchemaEditor {\n    private project: Project;\n    private collectionsDir: string;\n\n    constructor(collectionsDir: string) {\n        this.project = new Project({\n            manipulationSettings: {\n                indentationText: IndentationText.FourSpaces\n            }\n        });\n        if (fs.existsSync(collectionsDir)) {\n            this.project.addSourceFilesAtPaths(`${collectionsDir}/**/*.ts`);\n        }\n        this.collectionsDir = path.resolve(collectionsDir);\n    }\n\n    /**\n     * Sanitize collectionId to prevent path traversal attacks.\n     * Only allows alphanumeric characters, underscores, and hyphens.\n     */\n    private sanitizeCollectionId(collectionId: string): string {\n        const sanitized = collectionId.replace(/[^a-zA-Z0-9_-]/g, \"\");\n        if (!sanitized || sanitized !== collectionId) {\n            throw new Error(`Invalid collection ID: \"${collectionId}\". Only alphanumeric characters, underscores, and hyphens are allowed.`);\n        }\n        return sanitized;\n    }\n\n    /**\n     * Resolve a file path and ensure it falls within the collectionsDir.\n     */\n    private safePath(filename: string): string {\n        const resolved = path.resolve(this.collectionsDir, filename);\n        if (!resolved.startsWith(this.collectionsDir + path.sep) && resolved !== this.collectionsDir) {\n            throw new Error(\"Path traversal detected: resolved path is outside the collections directory.\");\n        }\n        return resolved;\n    }\n\n    private getCollectionFile(collectionId: string) {\n        const safeId = this.sanitizeCollectionId(collectionId);\n        const filePath = this.safePath(`${safeId}.ts`);\n        let file = this.project.getSourceFile(filePath);\n        if (!file && fs.existsSync(filePath)) {\n            this.project.addSourceFilesAtPaths(`${this.collectionsDir}/**/*.ts`);\n            file = this.project.getSourceFile(filePath);\n        }\n        return file;\n    }\n\n    private getCollectionObject(collectionId: string): ObjectLiteralExpression | null {\n        const file = this.getCollectionFile(collectionId);\n        if (!file) return null;\n\n        const defaultExport = file.getDefaultExportSymbol();\n        if (defaultExport) {\n            const declaration = defaultExport.getDeclarations()[0];\n            if (declaration && declaration.getKind() === SyntaxKind.ExportAssignment) {\n                const expr = declaration.asKind(SyntaxKind.ExportAssignment)?.getExpression();\n                if (expr && expr.getKind() === SyntaxKind.Identifier) {\n                    const varName = expr.getText();\n                    const varDecl = file.getVariableDeclaration(varName);\n                    return varDecl?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression) || null;\n                }\n            }\n        }\n        // Fallback: Just get the first exported VariableDeclaration with an ObjectLiteral\n        const varDecls = file.getVariableDeclarations();\n        for (const varDecl of varDecls) {\n            const init = varDecl.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n            if (init) return init;\n        }\n        return null;\n    }\n\n    private convertJsonToAstString(obj: unknown, indentLevel = 0, oldAstNode?: ObjectLiteralExpression): string {\n        // Base TS-morph parses arrays as 2 levels deep from the property key:\n        // PropertiesObject = level 1, PropertyConfig = level 2.\n        // We calibrate the spacing multiples to keep the items flush with standard TS format.\n        const indentStr = \"    \";\n        const indent = indentStr.repeat(indentLevel);\n        const innerIndent = indentStr.repeat(indentLevel + 1);\n\n        if (obj === null || obj === undefined) {\n            return \"undefined\";\n        }\n        if (typeof obj === \"string\") {\n            return JSON.stringify(obj);\n        }\n        if (typeof obj === \"number\" || typeof obj === \"boolean\") {\n            return String(obj);\n        }\n        if (Array.isArray(obj)) {\n            if (obj.length === 0) return \"[]\";\n            const items = obj.map(item => this.convertJsonToAstString(item, indentLevel + 1));\n            return `[\\n${innerIndent}${items.join(`,\\n${innerIndent}`)}\\n${indent}]`;\n        }\n        if (typeof obj === \"object\") {\n            const record = obj as Record<string, unknown>;\n            const keys = Object.keys(record);\n\n            // Collect preserved AST properties\n            const preservedProps: string[] = [];\n            if (oldAstNode) {\n                const oldProps = oldAstNode.getProperties();\n                for (const oldProp of oldProps) {\n                    if (oldProp.isKind(SyntaxKind.PropertyAssignment)) {\n                        const nameNode = oldProp.getNameNode();\n                        let name = nameNode.getText();\n                        if (name.startsWith('\"') && name.endsWith('\"')) name = name.slice(1, -1);\n                        if (name.startsWith(\"'\") && name.endsWith(\"'\")) name = name.slice(1, -1);\n\n                        // If the JSON object doesn't have this key, check if we should preserve it\n                        if (!(name in record)) {\n                            const init = oldProp.getInitializer();\n                            if (init) {\n                                const kind = init.getKind();\n                                const isCode = kind === SyntaxKind.ArrowFunction ||\n                                    kind === SyntaxKind.FunctionExpression ||\n                                    kind === SyntaxKind.Identifier ||\n                                    kind === SyntaxKind.CallExpression ||\n                                    kind === SyntaxKind.JsxElement;\n\n                                if (isCode || name === \"target\" || name === \"callbacks\" || name === \"permissions\" || name === \"securityRules\") {\n                                    // Preserve this property exactly as it was\n                                    const keyStr = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n                                    preservedProps.push(`${keyStr}: ${init.getText()}`);\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n\n            if (keys.length === 0 && preservedProps.length === 0) return \"{}\";\n\n            const props = keys.map(key => {\n                const keyStr = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);\n\n                // If the value is an object, pass the old AST node to recurse\n                let childAstNode: ObjectLiteralExpression | undefined;\n                if (oldAstNode && typeof record[key] === \"object\" && record[key] !== null && !Array.isArray(record[key])) {\n                    const oldProp = oldAstNode.getProperty(\n                        (p: ObjectLiteralElementLike) => \"getName\" in p && typeof (p as PropertyAssignment).getName === \"function\" && ((p as PropertyAssignment).getName() === key || (p as PropertyAssignment).getName() === `\"${key}\"` || (p as PropertyAssignment).getName() === `'${key}'`)\n                    );\n                    if (oldProp && oldProp.isKind(SyntaxKind.PropertyAssignment)) {\n                        childAstNode = oldProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n                    }\n                }\n\n                return `${keyStr}: ${this.convertJsonToAstString(record[key], indentLevel + 1, childAstNode)}`;\n            });\n\n            const allProps = [...props, ...preservedProps];\n            return `{\\n${innerIndent}${allProps.join(`,\\n${innerIndent}`)}\\n${indent}}`;\n        }\n        return \"undefined\";\n    }\n\n    public async saveProperty(collectionId: string, propertyKey: string, propertyConfig: Record<string, unknown>) {\n        const collectionObj = this.getCollectionObject(collectionId);\n        if (!collectionObj) throw new Error(`Collection ${collectionId} not found in ATS workspace.`);\n\n        let propertiesProp = collectionObj.getProperty(\"properties\") as PropertyAssignment;\n        if (!propertiesProp) {\n            propertiesProp = collectionObj.addPropertyAssignment({\n                name: \"properties\",\n                initializer: \"{}\"\n            });\n        }\n\n        const propsObj = propertiesProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n        if (propsObj) {\n            const existingProp = propsObj.getProperty(\n                (p: ObjectLiteralElementLike) => \"getName\" in p && typeof (p as PropertyAssignment).getName === \"function\" && ((p as PropertyAssignment).getName() === propertyKey || (p as PropertyAssignment).getName() === `\"${propertyKey}\"`)\n            );\n\n            let oldPropAstNode: ObjectLiteralExpression | undefined;\n            if (existingProp && existingProp.isKind(SyntaxKind.PropertyAssignment)) {\n                oldPropAstNode = existingProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n            }\n\n            const newInitializer = this.convertJsonToAstString(propertyConfig, 2, oldPropAstNode);\n\n            if (existingProp) {\n                if (existingProp.isKind(SyntaxKind.PropertyAssignment)) {\n                    existingProp.setInitializer(newInitializer);\n                }\n            } else {\n                propsObj.addPropertyAssignment({\n                    name: /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(propertyKey) ? propertyKey : JSON.stringify(propertyKey),\n                    initializer: newInitializer\n                });\n            }\n\n            const file = this.getCollectionFile(collectionId);\n            if (file) {\n                file.formatText();\n            }\n            await this.project.save();\n        }\n    }\n\n    public async deleteProperty(collectionId: string, propertyKey: string) {\n        const collectionObj = this.getCollectionObject(collectionId);\n        if (!collectionObj) return;\n\n        const propertiesProp = collectionObj.getProperty(\"properties\") as PropertyAssignment;\n        if (propertiesProp) {\n            const propsObj = propertiesProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n            if (propsObj) {\n                const existingProp = propsObj.getProperty(\n                    (p: ObjectLiteralElementLike) => \"getName\" in p && typeof (p as PropertyAssignment).getName === \"function\" && ((p as PropertyAssignment).getName() === propertyKey || (p as PropertyAssignment).getName() === `\"${propertyKey}\"`)\n                );\n                if (existingProp) {\n                    existingProp.remove();\n                    const file = this.getCollectionFile(collectionId);\n                    if (file) {\n                        file.formatText();\n                    }\n                    await this.project.save();\n                }\n            }\n        }\n    }\n\n    public async saveCollection(collectionId: string, collectionData: Record<string, unknown>) {\n        let file = this.getCollectionFile(collectionId);\n        const collectionObj = this.getCollectionObject(collectionId);\n\n        if (!file || !collectionObj) {\n            // Create a new file\n            const safeId = this.sanitizeCollectionId(collectionId);\n            const newFilePath = this.safePath(`${safeId}.ts`);\n            file = this.project.createSourceFile(newFilePath, `import { CollectionConfig } from \"@rebasepro/types\";\\n\\nconst ${safeId}Collection: CollectionConfig = ${this.convertJsonToAstString(collectionData)};\\n\\nexport default ${safeId}Collection;\\n`, { overwrite: true });\n        } else {\n            // Update root level properties gracefully\n\n            // Force delete securityRules if empty or undefined to handle Formex / serialization stripping\n            if (!(\"securityRules\" in collectionData) || collectionData.securityRules === undefined || (Array.isArray(collectionData.securityRules) && collectionData.securityRules.length === 0)) {\n                const srProp = collectionObj.getProperty(\"securityRules\");\n                if (srProp) {\n                    srProp.remove();\n                }\n\n                // If it was in collectionData as an empty array, delete it so the loop below doesn't add it back as \"[]\"\n                // Actually, if it's \"[]\", omitting it entirely from the TS file achieves the same logical effect (no RLS rules)\n                // and correctly triggers \"unmapped policies\" if the DB still has them.\n                delete collectionData[\"securityRules\"];\n            }\n\n            for (const key of Object.keys(collectionData)) {\n                if (key === \"relations\") continue; // Kept via other AST functions or handled separately.\n\n                const prop = collectionObj.getProperty(key) as PropertyAssignment;\n\n                let oldAstNode: ObjectLiteralExpression | undefined;\n                if (prop && prop.isKind(SyntaxKind.PropertyAssignment)) {\n                    oldAstNode = prop.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n                }\n\n                const newInit = this.convertJsonToAstString(collectionData[key], 1, oldAstNode);\n                if (prop) {\n                    prop.setInitializer(newInit);\n                } else {\n                    collectionObj.addPropertyAssignment({\n                        name: key,\n                        initializer: newInit\n                    });\n                }\n            }\n        }\n        if (file) {\n            file.formatText();\n        }\n        await this.project.save();\n    }\n\n    public async deleteCollection(collectionId: string) {\n        const file = this.getCollectionFile(collectionId);\n        if (file) {\n            file.deleteImmediatelySync();\n        }\n    }\n}\n","import { Hono } from \"hono\";\nimport { AstSchemaEditor } from \"./ast-schema-editor\";\nimport { errorHandler } from \"./errors\";\nimport { HonoEnv } from \"./types\";\n\nexport function createSchemaEditorRoutes(collectionsDir: string): Hono<HonoEnv> {\n    const router = new Hono<HonoEnv>();\n    router.onError(errorHandler);\n    const editor = new AstSchemaEditor(collectionsDir);\n\n    router.post(\"/property/save\", async (c) => {\n        const body = await c.req.json();\n        const { collectionId, propertyKey, propertyConfig } = body;\n        await editor.saveProperty(collectionId, propertyKey, propertyConfig);\n        return c.json({ success: true });\n    });\n\n    router.post(\"/property/delete\", async (c) => {\n        const body = await c.req.json();\n        const { collectionId, propertyKey } = body;\n        await editor.deleteProperty(collectionId, propertyKey);\n        return c.json({ success: true });\n    });\n\n    router.post(\"/collection/save\", async (c) => {\n        const body = await c.req.json();\n        const { collectionId, collectionData } = body;\n        await editor.saveCollection(collectionId, collectionData);\n        return c.json({ success: true });\n    });\n\n    router.post(\"/collection/delete\", async (c) => {\n        const body = await c.req.json();\n        const { collectionId } = body;\n        await editor.deleteCollection(collectionId);\n        return c.json({ success: true });\n    });\n\n    return router;\n}\n\n"],"mappings":"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"}

package/dist/serve-spa.d.ts

@@ -0,0 +1,36 @@
+import { Hono } from "hono";
+/**
+ * Configuration for serving a Single Page Application
+ */
+export interface ServeSPAConfig {
+    /**
+     * Absolute path to the frontend build directory
+     * @example path.join(__dirname, "../../frontend/dist")
+     */
+    frontendPath: string;
+    /**
+     * Base path for API routes (default: "/api")
+     * Requests to this path will be passed through to API handlers
+     */
+    apiBasePath?: string;
+    /**
+     * Additional paths to exclude from SPA handling
+     * These paths will be passed through to other handlers
+     * @example ["/health", "/ws", "/metrics"]
+     */
+    excludePaths?: string[];
+    /**
+     * Index file to serve for SPA routes (default: "index.html")
+     */
+    indexFile?: string;
+}
+/**
+ * Serve a Single Page Application from an Hono app.
+ *
+ * @internal Not part of the stable public API. Exported only because the
+ * official app template (`packages/cli/templates/template/backend/src/index.ts`
+ * and `app/backend/src/index.ts`) calls it to serve the built frontend in
+ * production. Its request-handling behavior is an implementation detail and
+ * may change without a major version bump.
+ */
+export declare function serveSPA<E extends import("hono").Env>(app: Hono<E>, config: ServeSPAConfig): void;

package/dist/services/driver-registry.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Driver Registry
+ *
+ * Manages multiple driver delegates for Rebase backend.
+ * Allows different databases for different collections.
+ *
+ * Usage:
+ * - Single DB: Pass a single DataDriver → maps to "(default)"
+ * - Multiple DBs: Pass a map of { dbId: DataDriver }
+ * - Collections use `databaseId` property to specify which driver to use
+ * - Collections without `databaseId` fallback to "(default)"
+ */
+import { DataDriver } from "@rebasepro/types";
+/**
+ * The default driver identifier used when:
+ * - A single driver is provided (not a map)
+ * - A collection doesn't specify a databaseId
+ */
+export declare const DEFAULT_DRIVER_ID = "(default)";
+/**
+ * Registry for managing multiple driver delegates
+ */
+export interface DriverRegistry {
+    /**
+     * Register a driver delegate with an ID
+     * @param id - Unique identifier for this driver (e.g., "analytics", "users")
+     * @param delegate - The DataDriver instance
+     */
+    register(id: string, delegate: DataDriver): void;
+    /**
+     * Get the default driver delegate (id = "(default)")
+     * @throws Error if no default driver is registered
+     */
+    getDefault(): DataDriver;
+    /**
+     * Get a driver delegate by ID
+     * @param id - Driver identifier, or undefined/null for default
+     * @returns The DataDriver, or undefined if not found
+     */
+    get(id: string | undefined | null): DataDriver | undefined;
+    /**
+     * Get a driver delegate by ID, with fallback to default
+     * @param id - Driver identifier, or undefined/null for default
+     * @returns The DataDriver (falls back to default if id not found)
+     * @throws Error if neither the specified nor default driver exists
+     */
+    getOrDefault(id: string | undefined | null): DataDriver;
+    /**
+     * Check if a driver with the given ID exists
+     */
+    has(id: string): boolean;
+    /**
+     * List all registered driver IDs
+     */
+    list(): string[];
+    /**
+     * Get the number of registered drivers
+     */
+    size(): number;
+}
+/**
+ * Default implementation of DriverRegistry
+ */
+export declare class DefaultDriverRegistry implements DriverRegistry {
+    private delegates;
+    /**
+     * Create a DriverRegistry from either a single delegate or a map
+     * @param input - Single DataDriver (maps to "(default)") or Record<string, DataDriver>
+     */
+    static create(input: DataDriver | Record<string, DataDriver>): DefaultDriverRegistry;
+    register(id: string, delegate: DataDriver): void;
+    getDefault(): DataDriver;
+    get(id: string | undefined | null): DataDriver | undefined;
+    getOrDefault(id: string | undefined | null): DataDriver;
+    has(id: string): boolean;
+    list(): string[];
+    size(): number;
+}

package/dist/services/routed-realtime-service.d.ts

@@ -0,0 +1,43 @@
+import { RealtimeProvider } from "@rebasepro/types";
+/**
+ * A realtime client message as forwarded by the WebSocket server.
+ */
+interface ClientMessage {
+    type: string;
+    payload?: Record<string, unknown>;
+    subscriptionId?: string;
+}
+/**
+ * The concrete realtime service surface the WebSocket server drives — the
+ * typed {@link RealtimeProvider} plus the client-connection methods that
+ * every engine's realtime service implements.
+ */
+export interface WsRealtimeService extends RealtimeProvider {
+    addClient(clientId: string, ws: unknown): void;
+    handleClientMessage(clientId: string, message: ClientMessage, authContext?: unknown): Promise<void> | void;
+}
+export interface RoutedRealtimeOptions {
+    /** Per-engine realtime providers, keyed by data-source key. */
+    providers: Record<string, RealtimeProvider>;
+    /** Key of the default provider (handles channels/presence/broadcast). */
+    defaultKey: string;
+    /** Resolve a collection path to its data-source key. */
+    resolveKey: (collectionPath: string) => string;
+}
+/**
+ * Compose multiple per-engine {@link RealtimeProvider}s into one that routes
+ * each subscription to the provider owning the subscribed collection — the
+ * realtime counterpart of `buildRoutedRebaseData`.
+ *
+ * The WebSocket server stays single and engine-agnostic; this composite is
+ * passed in its place. Routing rules:
+ * - `subscribe_collection` / `subscribe_entity` → the provider for the
+ *   collection's data source (by `payload.path`).
+ * - `unsubscribe` → forwarded to all providers (a no-op on non-owners).
+ * - channel / presence / broadcast → the default provider (these are global
+ *   pub/sub, not bound to an engine).
+ * - `addClient` and lifecycle (`onServerReady`/`destroy`/`stopListening`) →
+ *   all providers (each registers its own ws close handler for cleanup).
+ */
+export declare function createRoutedRealtimeService(opts: RoutedRealtimeOptions): WsRealtimeService;
+export {};

package/dist/services/webhook-service.d.ts

@@ -0,0 +1,29 @@
+export interface WebhookConfig {
+    id: string;
+    url: string;
+    secret?: string;
+    headers?: Record<string, string>;
+    events: string[];
+    table: string;
+    enabled: boolean;
+}
+export interface WebhookDeliveryResult {
+    webhookId: string;
+    event: string;
+    payload: Record<string, unknown>;
+    statusCode: number;
+    responseBody: string;
+    success: boolean;
+    attemptNumber: number;
+}
+export declare class WebhookDispatcher {
+    private webhooks;
+    private maxRetries;
+    private retryDelays;
+    /** Register webhooks to watch */
+    setWebhooks(webhooks: WebhookConfig[]): void;
+    /** Called when a entity changes — checks if any webhook matches */
+    onEntityChange(table: string, event: "INSERT" | "UPDATE" | "DELETE", id: string, entity: Record<string, unknown> | null, previousEntity?: Record<string, unknown> | null): Promise<WebhookDeliveryResult[]>;
+    private deliverWithRetry;
+    private deliver;
+}

package/dist/singleton.d.ts

@@ -0,0 +1,51 @@
+import type { RebaseServerClient } from "@rebasepro/types";
+/**
+ * @internal Called once during server initialization to set the backing instance.
+ * This is invoked by `initializeRebaseBackend()` — never call it manually.
+ */
+export declare function _initRebase(client: RebaseServerClient): void;
+/**
+ * @internal Allows overriding the underlying instance for unit testing.
+ * Throws an error if used in a non-test environment to prevent production abuse.
+ */
+export declare function _setRebaseMock(mockInstance: Partial<RebaseServerClient>): void;
+/**
+ * @internal Resets the singleton instance, useful for afterEach() in test suites.
+ */
+export declare function _resetRebaseMock(): void;
+/**
+ * The server-side Rebase singleton.
+ *
+ * Initialized automatically during server startup. Provides access to all
+ * app-scoped services: **data**, **auth**, **storage**, and **email**.
+ *
+ * **Admin data plane** (`rebase.dataAsAdmin`):
+ * Backed by the native DataDriver — calls go directly to the database without
+ * JSON serialization, HTTP dispatch, or middleware overhead. The driver is
+ * scoped as `{ uid: "service", roles: ["admin"] }`, so **every read and write
+ * bypasses row-level-security policies**. No `REBASE_SERVICE_KEY` is required.
+ *
+ * ⚠️ Because it bypasses RLS, `rebase.dataAsAdmin` is for trusted background
+ * work (cron jobs, migrations, service tasks) — **not** for serving user-facing
+ * data. Inside a request handler, run user-scoped queries through the
+ * request-scoped driver (`c.var.driver`), which carries the caller's identity
+ * so RLS applies.
+ *
+ * `rebase.data` is a **deprecated alias** for `rebase.dataAsAdmin` — identical
+ * admin scope at runtime. Prefer `dataAsAdmin` so the privilege is explicit.
+ *
+ * **Control plane** (`rebase.auth`, `rebase.admin`, `rebase.storage`, etc.):
+ * Routes through the Hono app's internal request handler. An internal per-boot
+ * credential is generated automatically when `REBASE_SERVICE_KEY` is not set,
+ * so control-plane calls always authenticate.
+ *
+ * @example
+ * ```typescript
+ * import { rebase } from "@rebasepro/server-core";
+ *
+ * // In a cron job, hook, or trusted service file (admin scope, bypasses RLS):
+ * await rebase.email.send({ to: "admin@co.com", subject: "Alert", html: "<p>Hi</p>" });
+ * const jobs = await rebase.dataAsAdmin.jobs.find({ limit: 10 });
+ * ```
+ */
+export declare const rebase: RebaseServerClient;