syncorejs 0.2.1 → 0.2.3

package/dist/_vendor/core/runtime/devtools.mjs

@@ -1,10 +1,11 @@
+import { parseCanonicalComponentFunctionName, parseComponentScopedIdentifier, quoteIdentifier, safeReadRecurringSchedule } from "./internal/engines/shared.mjs";
 import { createFunctionReference } from "./runtime.mjs";
 import { describeValidator } from "../../schema/index.js";
 //#region src/runtime/devtools.ts
 function createDevtoolsCommandHandler(deps) {
-	const { driver, runtime, sql } = deps;
+	const { driver, admin, sql } = deps;
 	return async (payload) => {
-		await runtime.prepareForDirectAccess();
+		await admin.prepareForDirectAccess();
 		switch (payload.kind) {
 			case "fn.run": {
 				const start = performance.now();
@@ -12,13 +13,13 @@ function createDevtoolsCommandHandler(deps) {
 					let result;
 					switch (payload.functionType) {
 						case "query":
-							result = await runtime.runQuery(createFunctionReference("query", payload.functionName), payload.args, { origin: "dashboard" });
+							result = await admin.runQuery(createFunctionReference("query", payload.functionName), payload.args, { origin: "dashboard" });
 							break;
 						case "mutation":
-							result = await runtime.runMutation(createFunctionReference("mutation", payload.functionName), payload.args, { origin: "dashboard" });
+							result = await admin.runMutation(createFunctionReference("mutation", payload.functionName), payload.args, { origin: "dashboard" });
 							break;
 						case "action":
-							result = await runtime.runAction(createFunctionReference("action", payload.functionName), payload.args, { origin: "dashboard" });
+							result = await admin.runAction(createFunctionReference("action", payload.functionName), payload.args, { origin: "dashboard" });
 							break;
 					}
 					return {
@@ -35,10 +36,12 @@ function createDevtoolsCommandHandler(deps) {
 				}
 			}
 			case "data.insert": try {
+				const id = await runDevtoolsMutation(admin, async (ctx) => ctx.db.insert(payload.table, payload.document), { origin: "dashboard" });
+				notifyDataMutationScopes(admin, payload.table);
 				return {
 					kind: "data.mutate.result",
 					success: true,
-					id: await runDevtoolsMutation(runtime, async (ctx) => ctx.db.insert(payload.table, payload.document), { origin: "dashboard" })
+					id
 				};
 			} catch (error) {
 				return {
@@ -48,10 +51,11 @@ function createDevtoolsCommandHandler(deps) {
 				};
 			}
 			case "data.patch": try {
-				await runDevtoolsMutation(runtime, async (ctx) => {
+				await runDevtoolsMutation(admin, async (ctx) => {
 					await ctx.db.patch(payload.table, payload.id, payload.fields);
 					return null;
 				}, { origin: "dashboard" });
+				notifyDataMutationScopes(admin, payload.table);
 				return {
 					kind: "data.mutate.result",
 					success: true,
@@ -65,10 +69,11 @@ function createDevtoolsCommandHandler(deps) {
 				};
 			}
 			case "data.delete": try {
-				await runDevtoolsMutation(runtime, async (ctx) => {
+				await runDevtoolsMutation(admin, async (ctx) => {
 					await ctx.db.delete(payload.table, payload.id);
 					return null;
 				}, { origin: "dashboard" });
+				notifyDataMutationScopes(admin, payload.table);
 				return {
 					kind: "data.mutate.result",
 					success: true
@@ -80,9 +85,54 @@ function createDevtoolsCommandHandler(deps) {
 					error: error instanceof Error ? error.message : String(error)
 				};
 			}
+			case "data.export": try {
+				const requestedTables = payload.tables && payload.tables.length > 0 ? payload.tables : deps.schema.tableNames();
+				return {
+					kind: "data.export.result",
+					tables: await Promise.all(requestedTables.map(async (name) => {
+						const result = await queryTable(driver, name);
+						return {
+							name,
+							rows: result.rows,
+							totalCount: result.totalCount
+						};
+					}))
+				};
+			} catch (error) {
+				return {
+					kind: "data.export.result",
+					tables: [],
+					error: error instanceof Error ? error.message : String(error)
+				};
+			}
+			case "data.referenceOptions": {
+				const limit = Math.min(Math.max(payload.limit ?? 100, 1), 200);
+				const offset = Math.max(payload.offset ?? 0, 0);
+				try {
+					const result = await queryReferenceOptions(driver, payload.table, payload.search, limit, offset);
+					return {
+						kind: "data.referenceOptions.result",
+						table: payload.table,
+						rows: result.rows,
+						totalCount: result.totalCount,
+						offset,
+						hasMore: offset + result.rows.length < result.totalCount
+					};
+				} catch (error) {
+					return {
+						kind: "data.referenceOptions.result",
+						table: payload.table,
+						rows: [],
+						totalCount: 0,
+						offset,
+						hasMore: false,
+						error: error instanceof Error ? error.message : String(error)
+					};
+				}
+			}
 			case "sql.read": try {
 				const sqlSupport = requireDevtoolsSqlSupport(sql);
-				const databasePath = runtime.getDriverDatabasePath();
+				const databasePath = admin.getDriverDatabasePath();
 				if (!databasePath) throw new Error("SQL Read requires a file-backed database path.");
 				const { columns, rows } = sqlSupport.runReadonlyQuery(databasePath, payload.query);
 				return {
@@ -102,8 +152,8 @@ function createDevtoolsCommandHandler(deps) {
 				const analysis = requireDevtoolsSqlSupport(sql).analyzeSqlStatement(payload.query);
 				if (analysis.mode === "read") throw new Error("Use SQL Read or SQL Live for read-only statements.");
 				const result = await driver.run(payload.query);
-				runtime.notifyDevtoolsScopes(analysis.observedScopes);
-				await runtime.forceRefreshDevtools("SQL write executed from devtools dashboard.", { origin: "dashboard" });
+				admin.notifyDevtoolsScopes(analysis.observedScopes);
+				await admin.forceRefreshDevtools("SQL write executed from devtools dashboard.", analysis.observedScopes.flatMap((scope) => scope === "all" ? [] : [scope]), { origin: "dashboard" });
 				return {
 					kind: "sql.write.result",
 					rowsAffected: result.changes,
@@ -121,7 +171,7 @@ function createDevtoolsCommandHandler(deps) {
 				return {
 					kind: "scheduler.cancel.result",
 					success: true,
-					cancelled: await runtime.cancelScheduledJob(payload.jobId)
+					cancelled: await admin.cancelScheduledJob(payload.jobId)
 				};
 			} catch (error) {
 				return {
@@ -132,11 +182,11 @@ function createDevtoolsCommandHandler(deps) {
 				};
 			}
 			case "scheduler.update": try {
-				const updated = await runtime.updateScheduledJob({
+				const updated = await admin.updateScheduledJob({
 					id: payload.jobId,
-					schedule: payload.schedule,
 					args: payload.args,
-					misfirePolicy: payload.misfirePolicy,
+					...payload.schedule ? { schedule: payload.schedule } : {},
+					...payload.misfirePolicy ? { misfirePolicy: payload.misfirePolicy } : {},
 					...payload.runAt !== void 0 ? { runAt: payload.runAt } : {}
 				});
 				const updatedJob = (updated ? await listSchedulerJobs(driver) : []).find((job) => job.id === payload.jobId);
@@ -162,14 +212,14 @@ function createDevtoolsCommandHandler(deps) {
 	};
 }
 function createDevtoolsSubscriptionHost(deps) {
-	const { driver, schema, functions, runtime } = deps;
+	const { driver, schema, functions, admin } = deps;
 	const subscriptions = /* @__PURE__ */ new Map();
 	const emit = async (payload, listener) => {
 		listener(await resolveSubscriptionPayload(payload, {
 			driver,
 			schema,
 			functions,
-			runtime,
+			admin,
 			...deps.sql ? { sql: deps.sql } : {}
 		}));
 	};
@@ -190,7 +240,7 @@ function createDevtoolsSubscriptionHost(deps) {
 					});
 					return;
 				}
-				const watch = runtime.createClient().watchQuery(createFunctionReference("query", payload.functionName), payload.args);
+				const watch = admin.createClient().watchQuery(createFunctionReference("query", payload.functionName), payload.args);
 				const emitWatchResult = () => {
 					const error = watch.localQueryError();
 					listener({
@@ -211,10 +261,10 @@ function createDevtoolsSubscriptionHost(deps) {
 				emitWatchResult();
 				return;
 			}
-			const unsubscribeRuntime = runtime.subscribeToDevtoolsInvalidations((scopes) => {
+			const unsubscribeRuntime = admin.subscribeToDevtoolsInvalidations((scopes) => {
 				handleInvalidation(scopes);
 			});
-			const unsubscribeEvents = runtime.subscribeToDevtoolsEvents((event) => {
+			const unsubscribeEvents = admin.subscribeToDevtoolsEvents((event) => {
 				if (event.type === "runtime.disconnected") emit(payload, listener);
 			});
 			subscriptions.set(subscriptionId, {
@@ -243,22 +293,22 @@ function createDevtoolsSubscriptionHost(deps) {
 	};
 }
 async function resolveSubscriptionPayload(payload, deps) {
-	const { driver, schema, functions, runtime } = deps;
-	await runtime.prepareForDirectAccess();
+	const { driver, schema, functions, admin } = deps;
+	await admin.prepareForDirectAccess();
 	switch (payload.kind) {
 		case "runtime.summary": return {
 			kind: "runtime.summary.result",
-			summary: runtime.getRuntimeSummary()
+			summary: admin.getRuntimeSummary()
 		};
 		case "runtime.activeQueries": return {
 			kind: "runtime.activeQueries.result",
-			activeQueries: runtime.getActiveQueryInfos()
+			activeQueries: admin.getActiveQueryInfos()
 		};
 		case "fn.watch": throw new Error("Function watches are pushed incrementally and have no snapshot payload.");
 		case "schema.tables": {
 			const tables = await getSchemaTables(driver, schema);
 			console.debug("[devtools] schema.tables", {
-				runtimeId: runtime.getRuntimeId(),
+				runtimeId: admin.getRuntimeId(),
 				tables: tables.map((table) => ({
 					name: table.name,
 					documentCount: table.documentCount
@@ -272,7 +322,7 @@ async function resolveSubscriptionPayload(payload, deps) {
 		case "data.table": {
 			const result = await queryTable(driver, payload.table, payload.filters, payload.limit);
 			console.debug("[devtools] data.table", {
-				runtimeId: runtime.getRuntimeId(),
+				runtimeId: admin.getRuntimeId(),
 				table: payload.table,
 				filters: payload.filters ?? [],
 				limit: payload.limit,
@@ -297,7 +347,7 @@ async function resolveSubscriptionPayload(payload, deps) {
 		};
 		case "sql.watch": {
 			const sqlSupport = requireDevtoolsSqlSupport(deps.sql);
-			const databasePath = runtime.getDriverDatabasePath();
+			const databasePath = admin.getDriverDatabasePath();
 			if (!databasePath) throw new Error("SQL Live requires a file-backed database path.");
 			const { columns, rows, observedTables } = sqlSupport.runReadonlyQuery(databasePath, payload.query);
 			return {
@@ -310,12 +360,16 @@ async function resolveSubscriptionPayload(payload, deps) {
 	}
 }
 async function queryTable(driver, table, filters, limit) {
-	let sql = `SELECT _id, _creationTime, _json FROM "${table}"`;
+	let sql = `SELECT _id, _creationTime, _json FROM ${quoteIdentifier(table)}`;
 	const params = [];
-	if (filters && filters.length > 0) sql += ` WHERE ${filters.map((filter) => {
-		params.push(normalizeFilterValue(filter));
-		return `json_extract(_json, '$.${filter.field}') ${filterOperatorToSql(filter.operator)} ?`;
-	}).join(" AND ")}`;
+	const whereClauses = [];
+	if (filters && filters.length > 0) {
+		for (const filter of filters) {
+			whereClauses.push(filterToSql(filter));
+			params.push(normalizeFilterValue(filter));
+		}
+		sql += ` WHERE ${whereClauses.join(" AND ")}`;
+	}
 	sql += " ORDER BY _creationTime DESC";
 	if (limit) sql += ` LIMIT ${limit}`;
 	return {
@@ -324,7 +378,30 @@ async function queryTable(driver, table, filters, limit) {
 			_creationTime: row._creationTime,
 			...JSON.parse(row._json)
 		})),
-		totalCount: (await driver.get(`SELECT COUNT(*) as count FROM "${table}"`))?.count ?? 0
+		totalCount: (await driver.get(`SELECT COUNT(*) as count FROM ${quoteIdentifier(table)}${whereClauses.length > 0 ? ` WHERE ${whereClauses.join(" AND ")}` : ""}`, params))?.count ?? 0
+	};
+}
+async function queryReferenceOptions(driver, table, search, limit, offset) {
+	let sql = `SELECT _id, _creationTime, _json FROM ${quoteIdentifier(table)}`;
+	const params = [];
+	const trimmedSearch = search?.trim();
+	const whereClause = trimmedSearch ? " WHERE _id LIKE ? OR _json LIKE ?" : "";
+	if (trimmedSearch) {
+		const like = `%${trimmedSearch}%`;
+		params.push(like, like);
+	}
+	sql += `${whereClause} ORDER BY _creationTime DESC LIMIT ? OFFSET ?`;
+	return {
+		rows: (await driver.all(sql, [
+			...params,
+			limit,
+			offset
+		])).map((row) => ({
+			_id: row._id,
+			_creationTime: row._creationTime,
+			...JSON.parse(row._json)
+		})),
+		totalCount: (await driver.get(`SELECT COUNT(*) as count FROM ${quoteIdentifier(table)}${whereClause}`, params))?.count ?? 0
 	};
 }
 async function getSchemaTables(driver, schema) {
@@ -332,12 +409,12 @@ async function getSchemaTables(driver, schema) {
 		const table = schema.getTable(name);
 		const validatorDesc = describeValidator(table.validator);
 		const fields = validatorDesc.kind === "object" ? Object.entries(validatorDesc.shape).map(([fieldName, fieldDesc]) => {
-			const desc = fieldDesc;
-			const optional = desc.kind === "optional";
+			const field = fieldDesc;
 			return {
 				name: fieldName,
-				type: optional ? desc.inner?.kind ?? "any" : desc.kind,
-				optional
+				type: field.validator.kind,
+				optional: field.optional,
+				...field.validator.kind === "id" && field.validator.tableName ? { referenceTable: field.validator.tableName } : {}
 			};
 		}) : [];
 		fields.unshift({
@@ -349,14 +426,13 @@ async function getSchemaTables(driver, schema) {
 			type: "number",
 			optional: false
 		});
-		let documentCount = 0;
-		try {
-			documentCount = (await driver.get(`SELECT COUNT(*) as count FROM "${name}"`))?.count ?? 0;
-		} catch {
-			documentCount = 0;
-		}
+		const documentCount = await driver.get(`SELECT COUNT(*) as count FROM "${name}"`).then((countRow) => countRow?.count ?? 0).catch(() => 0);
 		return {
 			name,
+			...table.options.tableName ? { displayName: table.options.tableName } : {},
+			owner: table.options.componentPath ? "component" : "root",
+			...table.options.componentPath ? { componentPath: table.options.componentPath } : {},
+			...table.options.componentName ? { componentName: table.options.componentName } : {},
 			fields,
 			indexes: table.indexes.map((index) => ({
 				name: index.name,
@@ -370,11 +446,15 @@ async function getSchemaTables(driver, schema) {
 async function listSchedulerJobs(driver) {
 	try {
 		return (await driver.all(`SELECT * FROM "_scheduled_functions" ORDER BY run_at DESC LIMIT 200`)).map((row) => {
-			const schedule = safeReadSchedule(row.schedule_json);
+			const schedule = safeReadRecurringSchedule(row.schedule_json);
 			const scheduleLabel = schedule ? formatScheduleLabel(schedule) : void 0;
+			const functionComponent = parseCanonicalComponentFunctionName(row.function_name);
+			const idComponent = parseComponentScopedIdentifier(row.id);
 			return {
 				id: row.id,
 				functionName: row.function_name,
+				owner: functionComponent || idComponent ? "component" : "root",
+				...functionComponent ? { componentPath: functionComponent.componentPath } : idComponent ? { componentPath: idComponent.componentPath } : {},
 				args: JSON.parse(row.args_json),
 				scheduledAt: row.created_at,
 				runAt: row.run_at,
@@ -398,10 +478,23 @@ async function listSchedulerJobs(driver) {
 }
 function listFunctions(functions) {
 	return Object.entries(functions).filter((entry) => entry[1] !== void 0).map(([name, fn]) => {
+		const componentFunction = parseCanonicalComponentFunctionName(name);
 		const descriptor = {
 			name,
 			type: fn.kind,
-			file: inferFileFromFunctionName(name)
+			owner: componentFunction ? "component" : "root",
+			namespace: inferFunctionNamespace(name),
+			metadataAvailable: componentFunction !== null || name.includes(":"),
+			...componentFunction ? {
+				file: `components/${componentFunction.componentPath}`,
+				modulePath: componentFunction.componentPath,
+				componentPath: componentFunction.componentPath,
+				visibility: componentFunction.visibility,
+				localName: componentFunction.localName
+			} : inferFileFromFunctionName(name) ? {
+				file: inferFileFromFunctionName(name),
+				modulePath: inferFunctionNamespace(name)
+			} : {}
 		};
 		const argsDesc = describeValidator(fn.argsValidator);
 		if (argsDesc.kind === "object") descriptor.args = argsDesc.shape;
@@ -409,17 +502,45 @@ function listFunctions(functions) {
 	});
 }
 function inferFileFromFunctionName(name) {
+	const componentFunction = parseCanonicalComponentFunctionName(name);
+	if (componentFunction) return `components/${componentFunction.componentPath}`;
 	const parts = name.split(":");
 	if (parts.length > 1) return `${parts[0]}.ts`;
-	return "unknown";
+	return "";
+}
+function inferFunctionNamespace(name) {
+	const componentFunction = parseCanonicalComponentFunctionName(name);
+	if (componentFunction) return componentFunction.componentPath;
+	if (name.includes(":")) return name.split(":")[0] ?? "root";
+	if (name.includes("/")) return name.split("/")[0] ?? "root";
+	return "root";
 }
 function normalizeFilterValue(filter) {
+	const value = coerceFilterValue(filter.value);
 	switch (filter.operator) {
-		case "contains": return `%${String(filter.value)}%`;
-		case "startsWith": return `${String(filter.value)}%`;
-		default: return filter.value;
+		case "contains": return `%${String(value)}%`;
+		case "startsWith": return `${String(value)}%`;
+		default: return value;
 	}
 }
+function filterToSql(filter) {
+	const operator = filterOperatorToSql(filter.operator);
+	if (filter.field === "_id") return `_id ${operator} ?`;
+	if (filter.field === "_creationTime") return `_creationTime ${operator} ?`;
+	return `json_extract(_json, ${JSON.stringify(`$.${filter.field}`)}) ${operator} ?`;
+}
+function coerceFilterValue(value) {
+	if (typeof value !== "string") return value;
+	const trimmed = value.trim();
+	if (trimmed === "true") return true;
+	if (trimmed === "false") return false;
+	if (trimmed === "null") return null;
+	if (/^-?\d+(?:\.\d+)?$/.test(trimmed)) {
+		const numberValue = Number(trimmed);
+		if (Number.isFinite(numberValue)) return numberValue;
+	}
+	return value;
+}
 function filterOperatorToSql(operator) {
 	switch (operator) {
 		case "eq": return "=";
@@ -443,14 +564,6 @@ function mapJobStatus(status) {
 		default: return "pending";
 	}
 }
-function safeReadSchedule(scheduleJson) {
-	if (!scheduleJson) return;
-	try {
-		return JSON.parse(scheduleJson);
-	} catch {
-		return;
-	}
-}
 function formatScheduleLabel(schedule) {
 	switch (schedule.type) {
 		case "interval": {
@@ -462,6 +575,7 @@ function formatScheduleLabel(schedule) {
 		}
 		case "daily": return `Daily ${padNumber(schedule.hour)}:${padNumber(schedule.minute)}${schedule.timezone ? ` ${schedule.timezone}` : ""}`;
 		case "weekly": return `Weekly ${capitalize(schedule.dayOfWeek)} ${padNumber(schedule.hour)}:${padNumber(schedule.minute)}${schedule.timezone ? ` ${schedule.timezone}` : ""}`;
+		default: return "Recurring";
 	}
 }
 function readMisfirePolicy(type, windowMs) {
@@ -478,8 +592,11 @@ function padNumber(value) {
 function capitalize(value) {
 	return value.slice(0, 1).toUpperCase() + value.slice(1);
 }
-async function runDevtoolsMutation(runtime, callback, meta) {
-	return runtime.runDevtoolsMutation(callback, meta);
+async function runDevtoolsMutation(admin, callback, meta) {
+	return admin.runDevtoolsMutation(callback, meta);
+}
+function notifyDataMutationScopes(admin, tableName) {
+	admin.notifyDevtoolsScopes(["schema.tables", `table:${tableName}`]);
 }
 function scopesForSubscription(payload, sql) {
 	switch (payload.kind) {
@@ -498,6 +615,7 @@ function scopesForSubscription(payload, sql) {
 		} catch {
 			return new Set(["all"]);
 		}
+		default: return new Set(["all"]);
 	}
 }
 function intersects(a, b) {
@@ -506,7 +624,7 @@ function intersects(a, b) {
 	return false;
 }
 function requireDevtoolsSqlSupport(sql) {
-	if (!sql) throw new Error("SQL devtools are only available in Node-hosted runtimes.");
+	if (!sql) throw new Error("SQL Console is not available for this runtime.");
 	return sql;
 }
 //#endregion