@softr/sdk 0.0.68-props.0 → 0.0.68

package/dist/core/options.d.ts

@@ -0,0 +1,36 @@
+import { DatasourceAction, ReadShape } from "../action.js";
+import "@tanstack/react-start/server-only";
+
+//#region src/core/options.d.ts
+/** One row a linked-record picker offers. */
+type RecordOption = {
+  id: string;
+  label: string;
+};
+/** A page of a picker's rows, in the shape `LinkedRecordPicker`'s `load` answers with. */
+type RecordOptions = {
+  options: RecordOption[];
+  nextOffset: number | null;
+};
+/**
+ * The rows a linked field can point at, for a picker: each record of the query as its id and the text
+ * of one field, searched on that field when a term is given, a page at a time.
+ *
+ * @example
+ * const loadCompanies = createServerFn()
+ *   .validator(z.object({ term: z.string(), offset: z.number().nullable() }))
+ *   .handler(({ data }) => ds.options(companiesQuery, { label: 'name', ...data }))
+ */
+declare function listOptions<TShape extends ReadShape>(query: DatasourceAction<TShape>, {
+  label,
+  term,
+  offset,
+  limit
+}: {
+  label: keyof TShape["fields"] & string;
+  term?: string;
+  offset?: number | null;
+  limit?: number;
+}): Promise<RecordOptions>;
+//#endregion
+export { RecordOption, RecordOptions, listOptions };

package/dist/core/options.js

@@ -0,0 +1,39 @@
+import { makeChain } from "../datasource/fields.js";
+import { listRecords } from "../datasource/record.js";
+import "@tanstack/react-start/server-only";
+
+//#region src/core/options.ts
+/**
+* The rows a linked field can point at, for a picker: each record of the query as its id and the text
+* of one field, searched on that field when a term is given, a page at a time.
+*
+* @example
+* const loadCompanies = createServerFn()
+*   .validator(z.object({ term: z.string(), offset: z.number().nullable() }))
+*   .handler(({ data }) => ds.options(companiesQuery, { label: 'name', ...data }))
+*/
+async function listOptions(query, { label, term = "", offset = null, limit = 20 }) {
+	let list = listRecords(query).limit(limit).offset(offset);
+	const needle = term.trim();
+	if (needle !== "") list = list.where(() => makeChain(label).contains(needle));
+	const page = await list;
+	return {
+		options: page.records.map((record) => ({
+			id: record.id,
+			label: labelOf(record.fields[label])
+		})),
+		nextOffset: page.nextOffset
+	};
+}
+/** The text a label field holds: its own text, or the label of the choice or record it names. */
+function labelOf(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "object") {
+		const label = value.label;
+		return typeof label === "string" ? label : "";
+	}
+	return String(value);
+}
+
+//#endregion
+export { listOptions };

package/dist/core/use-overrides.d.ts

@@ -0,0 +1,17 @@
+//#region src/core/use-overrides.d.ts
+/**
+ * The edits a page has saved that its loader has not re-run for, keyed by record id: what a drawer or
+ * an inline control wrote, merged over the loader's rows until a fresh read replaces them.
+ *
+ * `onSaved` is the shape a drawer's `onSaved` callback takes: it fires before the write, and again
+ * with the old value if the write fails, so the row moves at once and moves back on failure.
+ */
+declare function useOverrides<TPatch extends object>(): {
+  /** What is pending for one record, or undefined when nobody has touched it. */
+  of: (recordId: string) => TPatch | undefined;
+  onSaved: (recordId: string, patch: TPatch) => void;
+  /** Drops what is pending for one record, once a fresh read of it has replaced the row. */
+  clear: (recordId: string) => void;
+};
+//#endregion
+export { useOverrides };

package/dist/core/use-overrides.js

@@ -0,0 +1,30 @@
+import { useState } from "react";
+
+//#region src/core/use-overrides.ts
+/**
+* The edits a page has saved that its loader has not re-run for, keyed by record id: what a drawer or
+* an inline control wrote, merged over the loader's rows until a fresh read replaces them.
+*
+* `onSaved` is the shape a drawer's `onSaved` callback takes: it fires before the write, and again
+* with the old value if the write fails, so the row moves at once and moves back on failure.
+*/
+function useOverrides() {
+	const [pending, setPending] = useState({});
+	return {
+		of: (recordId) => pending[recordId],
+		onSaved: (recordId, patch) => setPending((current) => ({
+			...current,
+			[recordId]: {
+				...current[recordId],
+				...patch
+			}
+		})),
+		clear: (recordId) => setPending((current) => ({
+			...current,
+			[recordId]: void 0
+		}))
+	};
+}
+
+//#endregion
+export { useOverrides };

package/dist/datasource/datasource.d.ts

@@ -1,4 +1,5 @@
 import { createRecord, deleteRecord, getRecord, listRecords, updateRecord } from "./record.js";
+import { listOptions } from "../core/options.js";
 import { chart, metric } from "./chart.js";
 import "@tanstack/react-start/server-only";
 
@@ -11,6 +12,7 @@ declare const ds: {
   delete: typeof deleteRecord;
   metric: typeof metric;
   chart: typeof chart;
+  options: typeof listOptions;
 };
 //#endregion
 export { ds };

package/dist/datasource/datasource.js

@@ -1,5 +1,6 @@
 import { createRecord, deleteRecord, getRecord, listRecords, updateRecord } from "./record.js";
 import { chart, metric } from "./chart.js";
+import { listOptions } from "../core/options.js";
 import "@tanstack/react-start/server-only";
 
 //#region src/datasource/datasource.ts
@@ -10,7 +11,8 @@ const ds = {
 	update: updateRecord,
 	delete: deleteRecord,
 	metric,
-	chart
+	chart,
+	options: listOptions
 };
 
 //#endregion

package/dist/datasource/fields.js

@@ -46,7 +46,8 @@ function group(logicalOperator, filters) {
 /**
 * One chain per alias, carrying every operator whatever the alias reads as. Only the types
 * narrow: a call the types reject cannot reach here, so there is nothing for a per-type
-* runtime chain to catch.
+* runtime chain to catch. Exported for a filter built on an alias the caller named, where no
+* type stands behind the chain.
 */
 function makeChain(subject) {
 	return {
@@ -87,4 +88,4 @@ function leaf(subject, operator, value) {
 }
 
 //#endregion
-export { andAll, makeFieldSet, makeSortSet };
+export { andAll, makeChain, makeFieldSet, makeSortSet };

package/dist/datasource/record.d.ts

@@ -68,6 +68,7 @@ interface ListResult<TRecord extends SoftrRecord = SoftrRecord> {
   total: number;
   nextOffset: number | null;
 }
+type GetRecord<TShape extends ReadShape> = SoftrRecord<ActionRecord<TShape>> | null;
 /**
  * Queries a list of records from the datasource.
  *
@@ -135,4 +136,4 @@ declare function deleteRecord<TShape extends ActionShape & {
   id: string;
 }): Promise<void>;
 //#endregion
-export { WhereCallback, createRecord, deleteRecord, getRecord, listRecords, updateRecord };
+export { GetRecord, WhereCallback, createRecord, deleteRecord, getRecord, listRecords, updateRecord };

package/dist/fields/format.d.ts

@@ -0,0 +1,45 @@
+import { Formatting } from "../formatting.js";
+
+//#region src/fields/format.d.ts
+
+/**
+ * A field's type and options, which is all its text depends on. The generated `src/softr-fields.ts`
+ * holds one per field of every registered datasource.
+ */
+type FieldShape = {
+  type: string;
+  options?: Record<string, unknown> | null;
+  /** True when the field holds several values, which read back as an array. */
+  allowMultipleEntries?: boolean;
+};
+/** The fields of every registered datasource, by datasource id then field id. */
+type SoftrFieldRegistry = Record<string, Record<string, FieldShape>>;
+/**
+ * Makes the app's fields known to `fieldShape` and `formatValue`. The generated `src/softr-fields.ts`
+ * calls it once as a side effect of being imported; the root route imports that file.
+ */
+declare function registerSoftrFields(fields: SoftrFieldRegistry): void;
+/**
+ * The shape of a field a query reads, by the alias the query holds it under. Throws when the app has
+ * not registered its fields: the generated `src/softr-fields.ts` is not imported.
+ */
+declare function fieldShape(query: {
+  datasourceId: string;
+  fields: Record<string, string>;
+}, alias: string): FieldShape;
+/**
+ * A value a query read, as the text a page shows it as, by the field's own type and options: money with
+ * its symbol, a date in the app's format, a choice or a linked record by its label, a rating out of its
+ * scale, a duration in hours and minutes, a checkbox as Yes or No. '' for a value the record does not
+ * hold. Several values read joined by a comma.
+ */
+declare function formatValue(query: {
+  datasourceId: string;
+  fields: Record<string, string>;
+}, alias: string, value: unknown, formatting: Formatting): string;
+/** `formatValue` for a shape in hand, such as one from `src/softr-fields.ts` or a `returnedField`. */
+declare function formatField(shape: FieldShape, value: unknown, formatting: Formatting): string;
+/** A duration, which the datasource holds in milliseconds, as hours and minutes; seconds only under an hour. */
+declare function formatDuration(milliseconds: number): string;
+//#endregion
+export { FieldShape, SoftrFieldRegistry, fieldShape, formatDuration, formatField, formatValue, registerSoftrFields };

package/dist/fields/format.js

@@ -0,0 +1,140 @@
+import { formatDate, formatDateTime, formatNumber } from "../formatting.js";
+
+//#region src/fields/format.ts
+let registry = {};
+/**
+* Makes the app's fields known to `fieldShape` and `formatValue`. The generated `src/softr-fields.ts`
+* calls it once as a side effect of being imported; the root route imports that file.
+*/
+function registerSoftrFields(fields) {
+	registry = {
+		...registry,
+		...fields
+	};
+}
+/**
+* The shape of a field a query reads, by the alias the query holds it under. Throws when the app has
+* not registered its fields: the generated `src/softr-fields.ts` is not imported.
+*/
+function fieldShape(query, alias) {
+	const fieldId = query.fields[alias];
+	if (fieldId === void 0) throw new Error(`The query has no field "${alias}"; it reads ${Object.keys(query.fields).join(", ")}.`);
+	const shape = registry[query.datasourceId]?.[fieldId];
+	if (shape === void 0) throw new Error(`No shape is registered for field ${fieldId} of datasource ${query.datasourceId}. Import the generated src/softr-fields.ts once, in the root route, and run the SDK's codegen after a schema change.`);
+	return shape;
+}
+/**
+* A value a query read, as the text a page shows it as, by the field's own type and options: money with
+* its symbol, a date in the app's format, a choice or a linked record by its label, a rating out of its
+* scale, a duration in hours and minutes, a checkbox as Yes or No. '' for a value the record does not
+* hold. Several values read joined by a comma.
+*/
+function formatValue(query, alias, value, formatting) {
+	return formatField(fieldShape(query, alias), value, formatting);
+}
+/** `formatValue` for a shape in hand, such as one from `src/softr-fields.ts` or a `returnedField`. */
+function formatField(shape, value, formatting) {
+	if (value === null || value === void 0) return "";
+	if (Array.isArray(value)) return value.map((entry) => formatField({
+		...shape,
+		allowMultipleEntries: false
+	}, entry, formatting)).filter((text$1) => text$1 !== "").join(", ");
+	const returned = computedReturns(shape);
+	if (returned !== null) return formatField(returned, value, formatting);
+	const options = shape.options ?? {};
+	switch (shape.type) {
+		case "CHECKBOX": return value === true ? "Yes" : "No";
+		case "NUMBER":
+		case "COUNT":
+		case "PROGRESS": return typeof value === "number" ? formatNumber(value, formatting, digits(precisionOf(options))) : text(value);
+		case "AUTONUMBER": return text(value);
+		case "CURRENCY": {
+			if (typeof value !== "number") return text(value);
+			const code = options.isoCode;
+			const precision = precisionOf(options) ?? 2;
+			const cents = {
+				minimumFractionDigits: Number.isInteger(value) ? 0 : precision,
+				maximumFractionDigits: precision
+			};
+			if (typeof code === "string" && /^[A-Z]{3}$/.test(code)) return formatNumber(value, formatting, {
+				style: "currency",
+				currency: code,
+				...cents
+			});
+			const amount = formatNumber(value, formatting, cents);
+			const symbol = typeof options.customSymbol === "string" ? options.customSymbol : "";
+			if (symbol === "") return amount;
+			return options.symbolOrCodePosition === "AFTER" ? `${amount} ${symbol}` : `${symbol}${amount}`;
+		}
+		case "PERCENT": return typeof value === "number" ? `${formatNumber(value, formatting, digits(precisionOf(options)))}%` : text(value);
+		case "RATING": return typeof value === "number" ? `${value}/${numberOption(options, "max") ?? 5}` : text(value);
+		case "DURATION": return typeof value === "number" ? formatDuration(value) : text(value);
+		case "DATE":
+		case "DATETIME": return isDateValue(value) ? formatDateTime(value, formatting, { dateStyle: "medium" }) : text(value);
+		case "CREATED_AT":
+		case "UPDATED_AT":
+			if (!isDateValue(value)) return text(value);
+			return options.precision === "DATE" ? formatDate(value, formatting, { dateStyle: "medium" }) : formatDateTime(value, formatting, { dateStyle: "medium" });
+		case "DATE_RANGE": {
+			const range = value;
+			return [isDateValue(range.from) ? formatDateTime(range.from, formatting, { dateStyle: "medium" }) : "", isDateValue(range.to) ? formatDateTime(range.to, formatting, { dateStyle: "medium" }) : ""].filter((part) => part !== "").join(" – ");
+		}
+		case "USER": {
+			const person = value;
+			return text(person.name ?? person.email);
+		}
+		case "ATTACHMENT": {
+			const file = value;
+			return typeof file.filename === "string" && file.filename !== "" ? file.filename : "File";
+		}
+		default:
+			if (typeof value === "object" && "label" in value) return text(value.label);
+			return text(value);
+	}
+}
+/** The shape a FORMULA, LOOKUP or ROLLUP reads as, when its options say; null for any other field. */
+function computedReturns(shape) {
+	if (shape.type !== "FORMULA" && shape.type !== "LOOKUP" && shape.type !== "ROLLUP") return null;
+	const returned = shape.options?.returnedField;
+	if (typeof returned !== "object" || returned === null || !("type" in returned) || typeof returned.type !== "string") return null;
+	const options = "options" in returned && typeof returned.options === "object" ? returned.options : null;
+	return {
+		type: returned.type,
+		options
+	};
+}
+function text(value) {
+	return value === null || value === void 0 ? "" : String(value);
+}
+function isDateValue(value) {
+	return typeof value === "string" && value !== "" || typeof value === "number" || value instanceof Date;
+}
+function numberOption(options, key) {
+	const value = options[key];
+	return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : void 0;
+}
+function precisionOf(options) {
+	return numberOption(options, "precision");
+}
+function digits(precision) {
+	return precision === void 0 ? void 0 : {
+		minimumFractionDigits: precision,
+		maximumFractionDigits: precision
+	};
+}
+/** A duration, which the datasource holds in milliseconds, as hours and minutes; seconds only under an hour. */
+function formatDuration(milliseconds) {
+	const total = Math.round(milliseconds / 1e3);
+	const hours = Math.floor(total / 3600);
+	const minutes = Math.floor(total % 3600 / 60);
+	const rest = total % 60;
+	const parts = [
+		hours > 0 ? `${hours}h` : "",
+		minutes > 0 ? `${minutes}m` : "",
+		hours === 0 && rest > 0 ? `${rest}s` : ""
+	].filter((part) => part !== "");
+	return parts.length === 0 ? "0m" : parts.join(" ");
+}
+
+//#endregion
+export { fieldShape, formatDuration, formatField, formatValue, registerSoftrFields };

package/dist/formatting.d.ts

@@ -1,6 +1,6 @@
-import { z } from "zod";
-import * as react2 from "react";
+import * as react0 from "react";
 import { ReactNode } from "react";
+import { z } from "zod";
 
 //#region src/formatting.d.ts
 type FixedDateFormat = "FRIENDLY" | "DD-MM-YYYY" | "MM-DD-YYYY" | "YYYY-MM-DD";
@@ -94,7 +94,7 @@ declare function FormattingScope({
   /** A BCP 47 locale, such as `de-DE`. It drops the app's fixed date format inside the scope. */
   locale?: string;
   children?: ReactNode;
-}): react2.FunctionComponentElement<react2.ProviderProps<Scope>>;
+}): react0.FunctionComponentElement<react0.ProviderProps<Scope>>;
 /**
  * A date in the app's format, safe to render on the server. A timestamp whose
  * zone is not known yet renders `fallback` until the browser supplies it, so
@@ -115,6 +115,6 @@ declare function FormattedDate({
   time?: boolean;
   /** What renders while the visitor's zone is unknown. */
   fallback?: ReactNode;
-}): react2.FunctionComponentElement<react2.FragmentProps>;
+}): react0.FunctionComponentElement<react0.FragmentProps>;
 //#endregion
 export { DateOptions, DateParts, DateSeparator, DateValue, FixedDateFormat, FormattedDate, Formatting, FormattingScope, WeekDay, formatDate, formatDateTime, formatNumber, useFormatting };

package/dist/formatting.js

@@ -1,6 +1,6 @@
 import { logger } from "./logger.js";
-import { z } from "zod";
 import { Fragment, createContext, createElement, useContext, useMemo, useSyncExternalStore } from "react";
+import { z } from "zod";
 import { rootRouteId, useRouteContext } from "@tanstack/react-router";
 
 //#region src/formatting.ts

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { SoftrUserGroupId, SoftrUserGroups, SoftrUserProperties, User } from "./auth/user.js";
+import { SoftrUserGroupId, SoftrUserGroups, User } from "./auth/user.js";
 import { ActionPermissions, SoftrDatasources, defineIntegration, defineMutation, defineQuery, defineWorkflow } from "./action.js";
 import { FileAttachment } from "./core/file-upload.js";
 import { FileItem, useFileUpload } from "./core/use-file-upload.js";
@@ -10,8 +10,10 @@ import { assertRouteAccess, guardRoute, isAccessError, isAlreadyAuthenticatedErr
 import { toReturnPath } from "./auth/returnPath.js";
 import { AuthOptions, AuthSettingsProvider, getAuthSettings, getSoftrContext, initialSoftrContext, softrAuthMiddleware, useAuthSettings, useCurrentUser } from "./auth/isomorphic.js";
 import { softrMcpMiddleware } from "./mcp.js";
+import { FieldShape, SoftrFieldRegistry, fieldShape, formatDuration, formatField, formatValue, registerSoftrFields } from "./fields/format.js";
+import { useOverrides } from "./core/use-overrides.js";
 import { useUserTimezone } from "./timezone.js";
 import { PwaInstall, PwaPlatform, SoftrPwaHead, usePwaInstall } from "./pwa.js";
 import { DefaultErrorOverlay } from "./default-error-overlay.js";
 import { Audience } from "./visibility/audience.js";
-export { type ActionPermissions, Audience, type AuthOptions, type AuthSettings, AuthSettingsProvider, type DateOptions, type DateParts, type DateSeparator, type DateValue, DefaultErrorOverlay, type FileAttachment, type FileItem, type FixedDateFormat, FormattedDate, type Formatting, FormattingScope, type PwaInstall, type PwaPlatform, type SoftrContext, type SoftrDatasources, SoftrPwaHead, type SoftrUserGroupId, type SoftrUserGroups, type SoftrUserProperties, type User, type WeekDay, assertRouteAccess, checkAccess, defineIntegration, defineMutation, defineQuery, defineVisibility, defineWorkflow, formatDate, formatDateTime, formatNumber, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, usePwaInstall, useUserTimezone };
+export { type ActionPermissions, Audience, type AuthOptions, type AuthSettings, AuthSettingsProvider, type DateOptions, type DateParts, type DateSeparator, type DateValue, DefaultErrorOverlay, type FieldShape, type FileAttachment, type FileItem, type FixedDateFormat, FormattedDate, type Formatting, FormattingScope, type PwaInstall, type PwaPlatform, type SoftrContext, type SoftrDatasources, type SoftrFieldRegistry, SoftrPwaHead, type SoftrUserGroupId, type SoftrUserGroups, type User, type WeekDay, assertRouteAccess, checkAccess, defineIntegration, defineMutation, defineQuery, defineVisibility, defineWorkflow, fieldShape, formatDate, formatDateTime, formatDuration, formatField, formatNumber, formatValue, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, registerSoftrFields, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, useOverrides, usePwaInstall, useUserTimezone };

package/dist/index.js

@@ -7,8 +7,10 @@ import { FormattedDate, FormattingScope, formatDate, formatDateTime, formatNumbe
 import { SoftrPwaHead, usePwaInstall } from "./pwa.js";
 import { AuthSettingsProvider, getAuthSettings, getSoftrContext, initialSoftrContext, softrAuthMiddleware, useAuthSettings, useCurrentUser } from "./auth/isomorphic.js";
 import { softrMcpMiddleware } from "./mcp.js";
+import { fieldShape, formatDuration, formatField, formatValue, registerSoftrFields } from "./fields/format.js";
+import { useOverrides } from "./core/use-overrides.js";
 import { useUserTimezone } from "./timezone.js";
 import { DefaultErrorOverlay } from "./default-error-overlay.js";
 import { Audience } from "./visibility/audience.js";
 
-export { Audience, AuthSettingsProvider, DefaultErrorOverlay, FormattedDate, FormattingScope, SoftrPwaHead, assertRouteAccess, checkAccess, defineIntegration, defineMutation, defineQuery, defineVisibility, defineWorkflow, formatDate, formatDateTime, formatNumber, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, usePwaInstall, useUserTimezone };
+export { Audience, AuthSettingsProvider, DefaultErrorOverlay, FormattedDate, FormattingScope, SoftrPwaHead, assertRouteAccess, checkAccess, defineIntegration, defineMutation, defineQuery, defineVisibility, defineWorkflow, fieldShape, formatDate, formatDateTime, formatDuration, formatField, formatNumber, formatValue, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, registerSoftrFields, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, useOverrides, usePwaInstall, useUserTimezone };

package/dist/mcp.js

@@ -2,12 +2,12 @@ import { assert } from "./assertions.js";
 import { fetch } from "./fetch.js";
 import { sessionConfig } from "./auth/config.js";
 import { readSessionToken, withSessionToken } from "./auth/session.js";
-import { softrConfig } from "./softr-config.js";
 import { makePlatform, platformApiUrl } from "./auth/platform.js";
 import { isDatasourceAction } from "./action.js";
+import { softrConfig } from "./softr-config.js";
 import { ds } from "./datasource/datasource.js";
-import { z } from "zod";
 import { createMiddleware } from "@tanstack/react-start";
+import { z } from "zod";
 
 //#region src/mcp.ts
 const MCP_PATH = "/_softr/mcp";

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.0.68-props.0";
+var version = "0.0.68";
 
 //#endregion
 export { version };

package/dist/pwa.d.ts

@@ -1,4 +1,4 @@
-import * as react0 from "react";
+import * as react4 from "react";
 import "@tanstack/react-start";
 
 //#region src/pwa.d.ts
@@ -23,7 +23,7 @@ import "@tanstack/react-start";
  *   )
  * }
  */
-declare function SoftrPwaHead(): react0.FunctionComponentElement<react0.FragmentProps>;
+declare function SoftrPwaHead(): react4.FunctionComponentElement<react4.FragmentProps>;
 type PwaPlatform = "ios" | "android" | "desktop";
 type PwaInstall = {
   available: false;

package/dist/pwa.js

@@ -2,9 +2,9 @@ import { logger } from "./logger.js";
 import { fetch } from "./fetch.js";
 import { sessionConfig } from "./auth/config.js";
 import { platformApiUrl } from "./auth/platform.js";
-import { z } from "zod";
 import { Fragment, createElement, useEffect, useState } from "react";
 import { createMiddleware } from "@tanstack/react-start";
+import { z } from "zod";
 
 //#region src/pwa.ts
 const MANIFEST_PATH = "/manifest.webmanifest";

package/dist/server.d.ts

@@ -1,7 +1,8 @@
 import { upload } from "./core/file-upload.js";
 import { auth } from "./auth/server.js";
+import { RecordOption, RecordOptions } from "./core/options.js";
 import { ds } from "./datasource/datasource.js";
 import { workflow } from "./core/workflow.js";
 import { integration } from "./core/integration.js";
 import "@tanstack/react-start/server-only";
-export { auth, ds, integration, upload, workflow };
+export { type RecordOption, type RecordOptions, auth, ds, integration, upload, workflow };

package/dist/softr-config.schema.js

@@ -1,10 +1,6 @@
-import { assert, panic } from "./assertions.js";
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
 import { z } from "zod";
 
 //#region src/softr-config.schema.ts
-const SOFTR_CONFIG_FILE = "softr.json";
 const AccessBehaviour = z.union([
 	z.string(),
 	z.object({
@@ -13,49 +9,32 @@ const AccessBehaviour = z.union([
 	}),
 	z.object({ strategy: z.literal("throw") })
 ], { error: "must be a path like \"/login\", { \"strategy\": \"redirect\", \"to\": \"/login\" } or { \"strategy\": \"throw\" }" });
-const AppPath = z.string().refine((path$1) => path$1.startsWith("/") && !path$1.includes("?") && !path$1.includes("#") && new URL(path$1, "https://app.invalid").origin === "https://app.invalid", { error: "must be a path on this app like \"/login\", with no \"?\" or \"#\"" });
-const SoftrConfigSchema = z.object({
-	auth: z.strictObject({
-		routes: z.strictObject({
-			login: z.strictObject({
-				path: AppPath,
-				redirectParam: z.string()
-			}),
-			resetPassword: z.strictObject({
-				path: AppPath,
-				tokenParam: z.string()
-			}),
-			acceptInvitation: z.strictObject({
-				path: AppPath,
-				tokenParam: z.string()
-			}),
-			magicLink: z.strictObject({
-				path: AppPath,
-				tokenParam: z.string()
-			})
+const AppPath = z.string().refine((path) => path.startsWith("/") && !path.includes("?") && !path.includes("#") && new URL(path, "https://app.invalid").origin === "https://app.invalid", { error: "must be a path on this app like \"/login\", with no \"?\" or \"#\"" });
+const SoftrConfigSchema = z.object({ auth: z.strictObject({
+	routes: z.strictObject({
+		login: z.strictObject({
+			path: AppPath,
+			redirectParam: z.string()
 		}),
-		guard: z.strictObject({
-			unauthenticated: AccessBehaviour,
-			forbidden: AccessBehaviour,
-			alreadyAuthenticated: AccessBehaviour
+		resetPassword: z.strictObject({
+			path: AppPath,
+			tokenParam: z.string()
+		}),
+		acceptInvitation: z.strictObject({
+			path: AppPath,
+			tokenParam: z.string()
+		}),
+		magicLink: z.strictObject({
+			path: AppPath,
+			tokenParam: z.string()
 		})
 	}),
-	user: z.strictObject({ properties: z.record(z.string(), z.string()) }).optional()
-});
-function loadSoftrConfig(root) {
-	const file = path.join(root, SOFTR_CONFIG_FILE);
-	assert(existsSync(file), `${SOFTR_CONFIG_FILE} is missing from ${root}`);
-	const source = readFileSync(file, "utf8");
-	let parsed;
-	try {
-		parsed = JSON.parse(source);
-	} catch (error) {
-		panic(`${SOFTR_CONFIG_FILE} is not valid JSON: ${error instanceof Error ? error.message : error}`);
-	}
-	const result = SoftrConfigSchema.safeParse(parsed);
-	if (!result.success) panic(`${SOFTR_CONFIG_FILE} does not match the schema:\n\n${z.prettifyError(result.error)}`);
-	return result.data;
-}
+	guard: z.strictObject({
+		unauthenticated: AccessBehaviour,
+		forbidden: AccessBehaviour,
+		alreadyAuthenticated: AccessBehaviour
+	})
+}) });
 
 //#endregion
-export { SOFTR_CONFIG_FILE, loadSoftrConfig };
+export { SoftrConfigSchema };

package/dist/visibility/route.js

@@ -1,5 +1,5 @@
-import { softrConfig } from "../softr-config.js";
 import { ACCESS_REASONS, checkAccess } from "./visibility.js";
+import { softrConfig } from "../softr-config.js";
 import { redirect } from "@tanstack/react-router";
 
 //#region src/visibility/route.ts

package/dist/vite.js

@@ -1,8 +1,12 @@
-import { SOFTR_CONFIG_FILE, loadSoftrConfig } from "./softr-config.schema.js";
+import { assert, panic } from "./assertions.js";
+import { SoftrConfigSchema } from "./softr-config.schema.js";
+import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { z } from "zod";
 import { pathToFileURL } from "node:url";
 
 //#region src/vite.ts
+const SOFTR_CONFIG_FILE = "softr.json";
 function softr() {
 	return [softrConfig(), editEngine()];
 }
@@ -23,6 +27,20 @@ function softrConfig() {
 		}
 	};
 }
+function loadSoftrConfig(root) {
+	const file = path.join(root, SOFTR_CONFIG_FILE);
+	assert(existsSync(file), `${SOFTR_CONFIG_FILE} is missing from ${root}`);
+	const source = readFileSync(file, "utf8");
+	let parsed;
+	try {
+		parsed = JSON.parse(source);
+	} catch (error) {
+		panic(`${SOFTR_CONFIG_FILE} is not valid JSON: ${error instanceof Error ? error.message : error}`);
+	}
+	const result = SoftrConfigSchema.safeParse(parsed);
+	if (!result.success) panic(`${SOFTR_CONFIG_FILE} does not match the schema:\n\n${z.prettifyError(result.error)}`);
+	return result.data;
+}
 /**
 * 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