@softr/sdk 0.0.7 → 0.0.11

package/dist/vite.js

@@ -1,8 +1,9 @@
+import { randomUUID } from "node:crypto";
 import * as nodeFs from "node:fs/promises";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { Generator, getConfig, inferFullPath } from "@tanstack/router-generator";
-import { randomUUID } from "node:crypto";
 import os from "node:os";
 import { parse } from "@babel/parser";
 import babelTraverse from "@babel/traverse";
@@ -428,8 +429,15 @@ async function writeManifest(root, contents) {
 async function generateManifest(root) {
 	return writeManifest(root, await renderManifest(root));
 }
-/** Plugin order does not matter: this puts nothing into the module graph. */
+/**
+* Everything Softr adds to an app's Vite config: the build-time routes manifest, plus the studio
+* edit engine when the pod supplies one.
+*/
 function softr() {
+	return [routesManifest(), editEngine()];
+}
+/** Plugin order does not matter: this puts nothing into the module graph. */
+function routesManifest() {
 	let root = process.cwd();
 	let rendered = null;
 	return {
@@ -444,6 +452,24 @@ function softr() {
 		}
 	};
 }
+/**
+* The edit engine is provided by the pod runtime rather than an app dependency: it is never in the
+* app's `package.json` and never in its `node_modules`. The pod points `SOFTR_EDIT_ENGINE_DIR` at
+* the copy baked into its image, and this function loads it from there.
+*
+* If the env var is unset, this plugin is a no-op. It's only loaded in the preview mode
+*/
+async function editEngine() {
+	const dir = process.env.SOFTR_EDIT_ENGINE_DIR;
+	if (!dir) return false;
+	const entry = pathToFileURL(path.join(dir, "dist", "vite.js")).href;
+	try {
+		return (await import(entry)).editEngineStudio();
+	} catch (error) {
+		console.error(`[softr] could not load the edit engine from ${entry}:`, error);
+		return false;
+	}
+}
 
 //#endregion
 export { MANIFEST_RELATIVE_PATH, generateManifest, softr };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@softr/sdk",
-  "version": "0.0.7",
+  "version": "0.0.11",
   "type": "module",
   "exports": {
     ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
-    "./vite": { "types": "./dist/vite.d.ts", "import": "./dist/vite.js" },
-    "./tanstack": { "types": "./dist/tanstack.d.ts", "import": "./dist/tanstack.js" },
-    "./react": { "types": "./dist/react.d.ts", "import": "./dist/react.js" }
+    "./client": { "types": "./dist/client.d.ts", "import": "./dist/client.js" },
+    "./server": { "types": "./dist/server.d.ts", "import": "./dist/server.js" },
+    "./vite": { "types": "./dist/vite.d.ts", "import": "./dist/vite.js" }
   },
   "files": ["dist"],
   "publishConfig": { "access": "public" },
@@ -19,7 +19,8 @@
     "@babel/parser": "^7.28.0",
     "@babel/traverse": "^7.28.0",
     "@babel/types": "^7.28.0",
-    "@tanstack/router-generator": "1.167.23"
+    "@tanstack/router-generator": "1.167.23",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@tanstack/react-router": "^1.168.0",

package/dist/query-C6022JhD.js

@@ -1,528 +0,0 @@
-//#region src/core/query.ts
-const INTERNAL_KIND = Symbol("KIND");
-/**
-* Query builder for filter queries. This exist to alleviate the (LLM?) mental overhead. API filter schema is a bit
-* verbose and confusing, even when dealing with very basic queries. So to fall into the pit of success, aim here
-* is to simplify filtering as much as possible.
-*
-* @example
-* single filter
-* ```tsx
-* const query = q.text("title").contains("hello");
-*
-* const json = buildFilterCriteria(query);
-* // result
-* {
-*   "filterCriteria": {
-*     "filterConditionGroup": {
-*       "logicalOperator": "AND"
-*       "filterGroups": [{
-*         "logicalOperator": "AND",
-*         "filters": [{
-*           "subject": "title",
-*           "type": "TEXT",
-*           "operator": "CONTAINS",
-*           "value": "hello"
-*         }],
-*       }]
-*     }
-*   }
-*  }
-*
-* ```
-*
-* @example
-* combining multiple filters
-* ```tsx
-* const query = q.and(
-*   q.text("title").contains("hello"),
-*   q.number("views").is(100),
-*   q.or(
-*     q.text("author").is("John"),
-*     q.boolean("isPublished").is(true)
-*   )
-* );
-* ```
-*/
-const q = {
-	select(mapping) {
-		return mapping;
-	},
-	and(...filters) {
-		return {
-			logicalOperator: "AND",
-			filters,
-			[INTERNAL_KIND]: "LOGICAL_GROUP"
-		};
-	},
-	or(...filters) {
-		return {
-			logicalOperator: "OR",
-			filters,
-			[INTERNAL_KIND]: "LOGICAL_GROUP"
-		};
-	},
-	text(subject) {
-		const filter = {
-			subject,
-			type: "TEXT",
-			[INTERNAL_KIND]: "FILTER"
-		};
-		return {
-			is(value) {
-				return {
-					...filter,
-					operator: "IS",
-					value
-				};
-			},
-			isNot(value) {
-				return {
-					...filter,
-					operator: "IS_NOT",
-					value
-				};
-			},
-			contains(value) {
-				return {
-					...filter,
-					operator: "CONTAINS",
-					value
-				};
-			},
-			isOneOf(value) {
-				return {
-					...filter,
-					operator: "IS_ONE_OF",
-					value
-				};
-			},
-			isNoneOf(value) {
-				return {
-					...filter,
-					operator: "IS_NONE_OF",
-					value
-				};
-			},
-			startsWith(value) {
-				return {
-					...filter,
-					operator: "STARTS_WITH",
-					value
-				};
-			},
-			endsWith(value) {
-				return {
-					...filter,
-					operator: "ENDS_WITH",
-					value
-				};
-			},
-			hasAllOf(value) {
-				return {
-					...filter,
-					operator: "HAS_ALL_OF",
-					value
-				};
-			},
-			isEmpty() {
-				return {
-					...filter,
-					operator: "IS_EMPTY"
-				};
-			},
-			isNotEmpty() {
-				return {
-					...filter,
-					operator: "IS_NOT_EMPTY"
-				};
-			}
-		};
-	},
-	boolean(subject) {
-		const filter = {
-			subject,
-			type: "BOOLEAN",
-			[INTERNAL_KIND]: "FILTER"
-		};
-		return {
-			is(value) {
-				return {
-					...filter,
-					operator: "IS",
-					value
-				};
-			},
-			isNot(value) {
-				return {
-					...filter,
-					operator: "IS_NOT",
-					value
-				};
-			},
-			isEmpty() {
-				return {
-					...filter,
-					operator: "IS_EMPTY"
-				};
-			},
-			isNotEmpty() {
-				return {
-					...filter,
-					operator: "IS_NOT_EMPTY"
-				};
-			}
-		};
-	},
-	number(subject) {
-		const filter = {
-			subject,
-			type: "NUMERIC",
-			[INTERNAL_KIND]: "FILTER"
-		};
-		return {
-			is(value) {
-				return {
-					...filter,
-					operator: "IS",
-					value: value.toString()
-				};
-			},
-			isNot(value) {
-				return {
-					...filter,
-					operator: "IS_NOT",
-					value: value.toString()
-				};
-			},
-			gt(value) {
-				return {
-					...filter,
-					operator: "GT",
-					value: value.toString()
-				};
-			},
-			gte(value) {
-				return {
-					...filter,
-					operator: "GTE",
-					value: value.toString()
-				};
-			},
-			lt(value) {
-				return {
-					...filter,
-					operator: "LT",
-					value: value.toString()
-				};
-			},
-			lte(value) {
-				return {
-					...filter,
-					operator: "LTE",
-					value: value.toString()
-				};
-			},
-			between(start, end) {
-				return {
-					...filter,
-					operator: "BETWEEN",
-					value: [start.toString(), end.toString()]
-				};
-			},
-			isEmpty() {
-				return {
-					...filter,
-					operator: "IS_EMPTY"
-				};
-			},
-			isNotEmpty() {
-				return {
-					...filter,
-					operator: "IS_NOT_EMPTY"
-				};
-			}
-		};
-	},
-	array(subject) {
-		const filter = {
-			subject,
-			type: "ARRAY",
-			[INTERNAL_KIND]: "FILTER"
-		};
-		return {
-			is(value) {
-				return {
-					...filter,
-					operator: "IS",
-					value
-				};
-			},
-			isOneOf(value) {
-				return {
-					...filter,
-					operator: "IS_ONE_OF",
-					value
-				};
-			},
-			isNoneOf(value) {
-				return {
-					...filter,
-					operator: "IS_NONE_OF",
-					value
-				};
-			},
-			hasAllOf(value) {
-				return {
-					...filter,
-					operator: "HAS_ALL_OF",
-					value
-				};
-			},
-			isEmpty() {
-				return {
-					...filter,
-					operator: "IS_EMPTY"
-				};
-			},
-			isNotEmpty() {
-				return {
-					...filter,
-					operator: "IS_NOT_EMPTY"
-				};
-			}
-		};
-	},
-	date(subject) {
-		const filter = {
-			subject,
-			type: "DATE",
-			[INTERNAL_KIND]: "FILTER"
-		};
-		return {
-			is(value) {
-				return {
-					...filter,
-					operator: "IS",
-					value
-				};
-			},
-			isNot(value) {
-				return {
-					...filter,
-					operator: "IS_NOT",
-					value
-				};
-			},
-			gt(value) {
-				return {
-					...filter,
-					operator: "GT",
-					value
-				};
-			},
-			gte(value) {
-				return {
-					...filter,
-					operator: "GTE",
-					value
-				};
-			},
-			lt(value) {
-				return {
-					...filter,
-					operator: "LT",
-					value
-				};
-			},
-			lte(value) {
-				return {
-					...filter,
-					operator: "LTE",
-					value
-				};
-			},
-			between(start, end) {
-				return {
-					...filter,
-					operator: "BETWEEN",
-					value: [start, end]
-				};
-			},
-			isNotBetween(start, end) {
-				return {
-					...filter,
-					operator: "IS_NOT_BETWEEN",
-					value: [start, end]
-				};
-			},
-			isEmpty() {
-				return {
-					...filter,
-					operator: "IS_EMPTY"
-				};
-			},
-			isNotEmpty() {
-				return {
-					...filter,
-					operator: "IS_NOT_EMPTY"
-				};
-			}
-		};
-	},
-	asc(subject) {
-		return {
-			sortingField: subject,
-			sortType: "ASC",
-			[INTERNAL_KIND]: "ORDER_BY"
-		};
-	},
-	desc(subject) {
-		return {
-			sortingField: subject,
-			sortType: "DESC",
-			[INTERNAL_KIND]: "ORDER_BY"
-		};
-	}
-};
-/**
-* Converts filter utility conditions to a format our backend supports
-*
-* @example
-* ```tsx
-* const query = q.text("title").contains("hello");
-*
-* const json = buildFilterCriteria(query);
-* // result
-* {
-*   "filterCriteria": {
-*     "filterConditionGroup": {
-*       "logicalOperator": "AND"
-*       "filterGroups": [{
-*         "logicalOperator": "AND",
-*         "filters": [{
-*           "subject": "title",
-*           "type": "TEXT",
-*           "operator": "CONTAINS",
-*           "value": "hello"
-*         }],
-*       }]
-*     }
-*   }
-*  }
-*
-* ```
-*/
-function buildFilterCriteria(input) {
-	if (!(INTERNAL_KIND in input)) throw new Error("Filters cannot be constructed manually. Use the 'q' helper.");
-	if (isFilter(input)) return { filterConditionGroup: {
-		logicalOperator: "AND",
-		filterGroups: [{
-			logicalOperator: "AND",
-			filters: [stripInternalKind(input)]
-		}]
-	} };
-	if (isFilterGroup(input)) {
-		if (input.filters.length === 0) return { filterConditionGroup: {
-			logicalOperator: input.logicalOperator,
-			filterGroups: []
-		} };
-		return { filterConditionGroup: {
-			logicalOperator: input.logicalOperator,
-			filterGroups: input.filters.map((inner) => {
-				if (isFilter(inner)) return {
-					logicalOperator: "AND",
-					filters: [stripInternalKind(inner)]
-				};
-				if (!inner.filters.every(isFilter)) throw new Error("Cannot nest filter groups more than three levels deep.");
-				return {
-					logicalOperator: inner.logicalOperator,
-					filters: inner.filters.map(stripInternalKind)
-				};
-			})
-		} };
-	}
-	throw new Error("Unknown filter kind: " + input[INTERNAL_KIND]);
-}
-/**
-* Converts order-by utility conditions to a format our backend supports
-*
-* @example
-* single orderBy
-* ```tsx
-* const orderBy = buildOrderBy(q.asc("title"));
-* // result: [{ sortingField: "title", sortType: "ASC" }]
-* ```
-*
-* @example
-* multiple orderBys
-* ```tsx
-* const orderBy = buildOrderBy([q.desc("createdAt"), q.asc("title")]);
-* // result: [
-* //   { sortingField: "createdAt", sortType: "DESC" },
-* //   { sortingField: "title", sortType: "ASC" }
-* // ]
-* ```
-*/
-function buildOrderBy(input) {
-	const orderBys = Array.isArray(input) ? input : [input];
-	if (!orderBys.every((ob) => ob[INTERNAL_KIND] === "ORDER_BY")) throw new Error("orderBy conditions cannot be constructed manually. Use the 'q' helper.");
-	return orderBys.map((orderBy) => ({
-		sortingField: orderBy.sortingField,
-		sortType: orderBy.sortType
-	}));
-}
-function dealiasOrderBy(orderbys, aliases) {
-	return orderbys.map((orderBy) => {
-		const subject = aliases[orderBy.sortingField];
-		if (!subject) throw new Error(`Could not find an alias for subject "${orderBy.sortingField}"`);
-		return {
-			...orderBy,
-			sortingField: subject
-		};
-	});
-}
-/**
-* Replaces filter subjects with their aliased values.
-*
-* Throws an error if any filter subject does not have a corresponding alias in the provided mapping.
-*
-* @example
-* ```tsx
-* const criteria = buildFilterCriteria(q.text("name").contains("John"));
-* const aliases = { name: "abcxy123" };
-* const dealiased = dealiasFilterCriteria(criteria, aliases);
-* // Result: filter subject is now "abcxyz123" instead of "name"
-* ```
-*/
-function dealiasFilterCriteria(criteria, aliases) {
-	if (!criteria.filterConditionGroup) return criteria;
-	return { filterConditionGroup: {
-		...criteria.filterConditionGroup,
-		filterGroups: criteria.filterConditionGroup.filterGroups.map((group) => ({
-			...group,
-			filters: group.filters.map(dealiasFilter)
-		}))
-	} };
-	function dealiasFilter(filter) {
-		const subject = aliases[filter.subject];
-		if (!subject) throw new Error(`Could not find an alias for subject "${subject}"`);
-		return {
-			...filter,
-			subject
-		};
-	}
-}
-function stripInternalKind(item) {
-	const { [INTERNAL_KIND]: _,...rest } = item;
-	return rest;
-}
-function isFilterGroup(item) {
-	return item[INTERNAL_KIND] === "LOGICAL_GROUP";
-}
-function isFilter(item) {
-	return item[INTERNAL_KIND] === "FILTER";
-}
-
-//#endregion
-export { q as a, dealiasOrderBy as i, buildOrderBy as n, dealiasFilterCriteria as r, buildFilterCriteria as t };

package/dist/react.d.ts

@@ -1,4 +0,0 @@
-//#region src/react.d.ts
-declare function useUserTimezone(): void;
-//#endregion
-export { useUserTimezone };

package/dist/tanstack.d.ts

@@ -1,18 +0,0 @@
-import { _ as SoftrSDK } from "./types-CjB4xUg-.js";
-
-//#region src/tanstack.d.ts
-
-/**
- * TanStack Start middleware. Injects a per-request Softr SDK instance with
- * cookies forwarded automatically. The base URL is read from VITE_SOFTR_BASE_URL.
- *
- * @example
- * import { withSDK } from '@softr/sdk/tanstack'
- *
- * export const getProjects = createServerFn()
- *   .middleware([withSDK])
- *   .handler(({ context }) => context.sdk.datasource('ds_projects').list())
- */
-declare const withSDK: any;
-//#endregion
-export { type SoftrSDK, withSDK };