@softr/sdk 0.0.74-alpha.0 → 0.0.74

package/dist/auth/methods/profile.d.ts

@@ -5,7 +5,7 @@ import { AuthError, Result } from "./utils.js";
 
 /**
  * Changes the signed-in visitor's own name, photo, or both. A field left out
- * stays as it is, and `avatar: null` removes the photo.
+ * stays as it is. {@link removeAvatar} removes the photo.
  *
  * The photo can change only where `user.avatarEditable` is true. Elsewhere a
  * photo answers `avatarNotSupported`, so hide the photo controls instead.
@@ -20,7 +20,16 @@ import { AuthError, Result } from "./utils.js";
  */
 declare function updateProfile(changes: {
   fullName?: string;
-  avatar?: File | null;
+  avatar?: File;
 }): Promise<Result<User, AuthError>>;
+/**
+ * Removes the signed-in visitor's own photo. Like {@link updateProfile}, it
+ * works only where `user.avatarEditable` is true, and answers with the visitor
+ * as they are now.
+ *
+ * @example
+ * const result = await auth.removeAvatar()
+ */
+declare function removeAvatar(): Promise<Result<User, AuthError>>;
 //#endregion
-export { updateProfile };
+export { removeAvatar, updateProfile };

package/dist/auth/methods/profile.js

@@ -7,7 +7,7 @@ import { authError } from "./utils.js";
 //#region src/auth/methods/profile.ts
 /**
 * Changes the signed-in visitor's own name, photo, or both. A field left out
-* stays as it is, and `avatar: null` removes the photo.
+* stays as it is. {@link removeAvatar} removes the photo.
 *
 * The photo can change only where `user.avatarEditable` is true. Elsewhere a
 * photo answers `avatarNotSupported`, so hide the photo controls instead.
@@ -26,9 +26,23 @@ async function updateProfile(changes) {
 	if (token === null) return authError("notAuthenticated", "Nobody is signed in.");
 	const form = new FormData();
 	if (changes.fullName !== void 0) form.set("fullName", changes.fullName);
-	if (changes.avatar === null) form.set("removeAvatar", "true");
 	if (changes.avatar) form.set("avatar", changes.avatar);
-	const result = await makePlatform(sessionConfig().applicationId).updateProfile(token, form);
+	return answer(await makePlatform(sessionConfig().applicationId).updateProfile(token, form));
+}
+/**
+* Removes the signed-in visitor's own photo. Like {@link updateProfile}, it
+* works only where `user.avatarEditable` is true, and answers with the visitor
+* as they are now.
+*
+* @example
+* const result = await auth.removeAvatar()
+*/
+async function removeAvatar() {
+	const token = readSessionToken();
+	if (token === null) return authError("notAuthenticated", "Nobody is signed in.");
+	return answer(await makePlatform(sessionConfig().applicationId).removeAvatar(token));
+}
+function answer(result) {
 	if (!result.ok) {
 		switch (result.status) {
 			case 400: return authError("invalidName", result.message);
@@ -49,4 +63,4 @@ async function updateProfile(changes) {
 }
 
 //#endregion
-export { updateProfile };
+export { removeAvatar, updateProfile };

package/dist/auth/platform.js

@@ -272,6 +272,10 @@ function makePlatform(applicationId) {
 			token,
 			form
 		}, userSchema),
+		removeAvatar: (token) => request(`/v1/vibe/applications/${applicationId}/users/me/profile/avatar`, {
+			method: "DELETE",
+			token
+		}, userSchema),
 		signOut: (token) => request(`/v1/applications/${applicationId}/users/sign-out`, {
 			method: "POST",
 			token

package/dist/auth/server.d.ts

@@ -6,7 +6,7 @@ import { checkPasswordLink, requestPasswordReset, setPasswordWithLink } from "./
 import { settings } from "./methods/settings.js";
 import { confirmSignUp, signUp } from "./methods/signup.js";
 import { signInWithGoogle } from "./methods/social.js";
-import { updateProfile } from "./methods/profile.js";
+import { removeAvatar, updateProfile } from "./methods/profile.js";
 import { currentUserRow } from "./current-user-row.js";
 import "@tanstack/react-start/server-only";
 
@@ -36,6 +36,7 @@ declare const auth: {
   removeAuthenticator: typeof removeAuthenticator;
   settings: typeof settings;
   updateProfile: typeof updateProfile;
+  removeAvatar: typeof removeAvatar;
   currentUserRow: typeof currentUserRow;
 };
 //#endregion

package/dist/auth/server.js

@@ -6,7 +6,7 @@ import { signIn, signOut } from "./methods/password.js";
 import { checkPasswordLink, requestPasswordReset, setPasswordWithLink } from "./methods/passwordLink.js";
 import { confirmSignUp, signUp } from "./methods/signup.js";
 import { signInWithGoogle } from "./methods/social.js";
-import { updateProfile } from "./methods/profile.js";
+import { removeAvatar, updateProfile } from "./methods/profile.js";
 import { currentUserRow } from "./current-user-row.js";
 import "@tanstack/react-start/server-only";
 
@@ -35,6 +35,7 @@ const auth = {
 	removeAuthenticator,
 	settings,
 	updateProfile,
+	removeAvatar,
 	currentUserRow
 };
 

package/dist/codegen/datasource-types.js

@@ -161,7 +161,7 @@ function writeValue(shape, context) {
 		case "UPDATED_AT": return "IsoDateTime";
 		case "TIME": return "IsoTime";
 		case "DATE_RANGE": return "{ from: IsoDate; to: IsoDate }";
-		case "SELECT": return "SelectChoiceInput";
+		case "SELECT": return selectInput(shape.options);
 		case "ATTACHMENT": return "AttachmentInput";
 		case "LINKED_RECORD": return "LinkedRecordInput";
 		case "USER": return "WorkspaceUser";
@@ -208,6 +208,19 @@ function selectValue(options) {
 	if (choices === null) return "SelectChoice";
 	return union(choices.map(({ id, label }) => `{ id: ${quote(id)}; label: ${quote(label)} }`));
 }
+/**
+* A write carries the id alone. The API resolves it against the choice list and writes that
+* choice's own label, so a label sent alongside is dropped.
+*
+* The API also takes `{ label }` with no id, and a label matching nothing creates a choice.
+* The union omits that: it would make every misspelling type-check, and the cost of one is a
+* new choice in the field rather than an error.
+*/
+function selectInput(options) {
+	const choices = choiceEntries(options);
+	if (choices === null) return "SelectChoiceInput";
+	return union(choices.map(({ id }) => `{ id: ${quote(id)} }`));
+}
 function datePrecision(options) {
 	const precision = option(options, "precision");
 	return typeof precision === "string" ? precision : null;

package/dist/core/options.d.ts

@@ -1,22 +1,7 @@
-import { ActionShape, DatasourceAction, ReadShape } from "../action.js";
+import { DatasourceAction, ReadShape } from "../action.js";
 import "@tanstack/react-start/server-only";
 
 //#region src/core/options.d.ts
-/** One choice of a SELECT field, as the field holds it now. */
-type FieldChoice = {
-  id: string;
-  label: string;
-  color: string | null;
-};
-/**
- * The choices a SELECT field holds right now, read from Softr on every call. A choice the
- * builder adds or renames later shows up without a new build. The field must be one the
- * action declares. Any query or mutation over the table works.
- *
- * @example
- * const loadStatuses = createServerFn().handler(() => ds.choices(listProjects, 'status'))
- */
-declare function listChoices<TShape extends ActionShape>(action: DatasourceAction<TShape>, field: keyof TShape["fields"] & string): Promise<Array<FieldChoice>>;
 /** One row a linked-record picker offers. */
 type RecordOption = {
   id: string;
@@ -48,4 +33,4 @@ declare function listOptions<TShape extends ReadShape>(query: DatasourceAction<T
   limit?: number;
 }): Promise<RecordOptions>;
 //#endregion
-export { FieldChoice, RecordOption, RecordOptions, listChoices, listOptions };
+export { RecordOption, RecordOptions, listOptions };

package/dist/core/options.js

@@ -1,37 +1,9 @@
-import { assert } from "../assertions.js";
-import { fetch } from "../fetch.js";
-import { readSessionToken } from "../auth/session.js";
 import { makeChain } from "../datasource/fields.js";
-import { describeFailure, dsUrl, listRecords, refererHeader, resolveTarget } from "../datasource/record.js";
+import { listRecords } from "../datasource/record.js";
 import "@tanstack/react-start/server-only";
 
 //#region src/core/options.ts
 /**
-* The choices a SELECT field holds right now, read from Softr on every call. A choice the
-* builder adds or renames later shows up without a new build. The field must be one the
-* action declares. Any query or mutation over the table works.
-*
-* @example
-* const loadStatuses = createServerFn().handler(() => ds.choices(listProjects, 'status'))
-*/
-async function listChoices(action, field) {
-	const { actionId, select } = resolveTarget(action, action.resource.operation);
-	const fieldId = select[field];
-	assert(fieldId, () => `action "${actionId}" declares no field "${field}"`);
-	const res = await fetch(`${dsUrl(actionId)}/metadata`, { headers: {
-		Authorization: `Bearer ${readSessionToken()}`,
-		...refererHeader()
-	} });
-	if (!res.ok) throw new Error(`datasource metadata failed for "${actionId}": ${await describeFailure(res)}`);
-	const metadataField = (await res.json()).fields.find(({ id }) => id === fieldId);
-	assert(metadataField?.type === "SELECT", () => `"${field}" on action "${actionId}" is not a SELECT field`);
-	return (metadataField.options?.choices ?? []).map(({ id, label, color }) => ({
-		id,
-		label,
-		color: color ?? 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.
 *
@@ -64,4 +36,4 @@ function labelOf(value) {
 }
 
 //#endregion
-export { listChoices, listOptions };
+export { listOptions };

package/dist/datasource/datasource.d.ts

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

package/dist/datasource/datasource.js

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

package/dist/datasource/fields.d.ts

@@ -19,21 +19,17 @@ type NumberChain = EmptyChain & {
   lte(value: number): ConstructableFilter;
   between(start: number, end: number): ConstructableFilter;
 };
-type ArrayChain = EmptyChain & {
-  is(values: Array<string>): ConstructableFilter;
-  isOneOf(values: Array<string>): ConstructableFilter;
-  isNoneOf(values: Array<string>): ConstructableFilter;
-  hasAllOf(values: Array<string>): ConstructableFilter;
+type ArrayChain<TMember$1 extends string> = EmptyChain & {
+  is(values: Array<TMember$1>): ConstructableFilter;
+  isOneOf(values: Array<TMember$1>): ConstructableFilter;
+  isNoneOf(values: Array<TMember$1>): ConstructableFilter;
+  hasAllOf(values: Array<TMember$1>): ConstructableFilter;
 };
-/**
- * Compares choice ids as plain strings. A select's choices change in Studio after the build,
- * and an id read at runtime from ds.choices has to be a valid filter value.
- */
-type ChoiceChain = EmptyChain & {
-  is(value: string): ConstructableFilter;
-  isNot(value: string): ConstructableFilter;
-  isOneOf(values: Array<string>): ConstructableFilter;
-  isNoneOf(values: Array<string>): ConstructableFilter;
+type ChoiceChain<TId$1 extends string> = EmptyChain & {
+  is(value: TId$1): ConstructableFilter;
+  isNot(value: TId$1): ConstructableFilter;
+  isOneOf(values: Array<TId$1>): ConstructableFilter;
+  isNoneOf(values: Array<TId$1>): ConstructableFilter;
 };
 /** What DSv2 filters generically: matched whole or scanned, never against a set. */
 type GenericChain = EmptyChain & {
@@ -77,20 +73,32 @@ type AnyChain = EmptyChain & {
   between(start: number | string, end: number | string): ConstructableFilter;
   isNotBetween(start: number | string, end: number | string): ConstructableFilter;
 };
+type IdOf<TValue> = TValue extends {
+  id: infer TId extends string;
+} ? TId : string;
+/**
+ * What a choice-shaped field compares against: its own ids where codegen read the choice
+ * list, and any string where it did not. A linked record is the open case, and it is the
+ * only thing distinguishing one from a select at the type level.
+ */
+type ChoiceIds<TValue> = string extends IdOf<TValue> ? string : IdOf<TValue>;
 type TextFieldType = 'SINGLE_LINE_TEXT' | 'LONG_TEXT' | 'URL' | 'EMAIL' | 'PHONE' | 'ADDRESS' | 'RECORD_ID' | 'LOCATION' | 'TIME' | 'BUTTON';
 type NumberFieldType = 'NUMBER' | 'PERCENT' | 'CURRENCY' | 'PROGRESS' | 'RATING' | 'DURATION' | 'COUNT' | 'AUTONUMBER';
 type DateFieldType = 'DATE' | 'DATETIME' | 'CREATED_AT' | 'UPDATED_AT';
 type ChoiceFieldType = 'SELECT' | 'LINKED_RECORD' | 'CREATED_BY' | 'UPDATED_BY';
 /** The types with no single value to compare: only whether the field holds one. */
 type EmptyFieldType = 'ATTACHMENT' | 'DATE_RANGE';
+type ElementOf<TValue> = TValue extends Array<infer TMember> ? TMember : TValue;
 /**
  * The operators one alias offers, chosen from the type codegen declared for the field rather
  * than from what it reads as: a `DATETIME` and a text field both read as `string`, and only
  * the declared type tells them apart.
  *
- * A field with no declared type lands on the permissive chain rather than on none.
+ * `TValue` is still needed for the literal choice ids, which live on the read type and
+ * nowhere else. A field with no declared type lands on the permissive chain rather than on
+ * none.
  */
-type ChainFor<TFieldType, TValue> = [TFieldType] extends [never] ? AnyChain : TFieldType extends `${infer TBase}[]` ? TBase extends EmptyFieldType ? EmptyChain : ArrayChain : TFieldType extends TextFieldType ? TextChain<TValue & string> : TFieldType extends NumberFieldType ? NumberChain : TFieldType extends 'USER' ? GenericChain : TFieldType extends 'CHECKBOX' ? BooleanChain : TFieldType extends DateFieldType ? DateChain : TFieldType extends ChoiceFieldType ? ChoiceChain : TFieldType extends EmptyFieldType ? EmptyChain : AnyChain;
+type ChainFor<TFieldType, TValue> = [TFieldType] extends [never] ? AnyChain : TFieldType extends `${infer TBase}[]` ? TBase extends EmptyFieldType ? EmptyChain : ArrayChain<ChoiceIds<ElementOf<TValue>>> : TFieldType extends TextFieldType ? TextChain<TValue & string> : TFieldType extends NumberFieldType ? NumberChain : TFieldType extends 'USER' ? GenericChain : TFieldType extends 'CHECKBOX' ? BooleanChain : TFieldType extends DateFieldType ? DateChain : TFieldType extends ChoiceFieldType ? ChoiceChain<ChoiceIds<TValue>> : TFieldType extends EmptyFieldType ? EmptyChain : AnyChain;
 type Combinators = {
   $and(...members: Array<AnyConstructable>): ConstructableFilterGroup;
   $or(...members: Array<AnyConstructable>): ConstructableFilterGroup;

package/dist/formatting.d.ts

@@ -1,4 +1,4 @@
-import * as react2 from "react";
+import * as react0 from "react";
 import { ReactNode } from "react";
 import { z } from "zod";
 
@@ -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/mcp.d.ts

@@ -1,5 +1,5 @@
 import { DatasourceAction } from "./action.js";
-import * as _tanstack_react_start0 from "@tanstack/react-start";
+import * as _tanstack_react_start5 from "@tanstack/react-start";
 
 //#region src/mcp.d.ts
 
@@ -31,6 +31,6 @@ type SoftrMcpOptions = {
  *   ],
  * }))
  */
-declare function softrMcpMiddleware(options?: SoftrMcpOptions): _tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>;
+declare function softrMcpMiddleware(options?: SoftrMcpOptions): _tanstack_react_start5.RequestMiddlewareAfterServer<{}, undefined, undefined>;
 //#endregion
 export { softrMcpMiddleware };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.0.74-alpha.0";
+var version = "0.0.74";
 
 //#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/server.d.ts

@@ -1,8 +1,8 @@
 import { upload } from "./core/file-upload.js";
 import { auth } from "./auth/server.js";
-import { FieldChoice, RecordOption, RecordOptions } from "./core/options.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 { type FieldChoice, type RecordOption, type RecordOptions, auth, ds, integration, upload, workflow };
+export { type RecordOption, type RecordOptions, auth, ds, integration, upload, workflow };

package/package.json

@@ -1,37 +1,16 @@
 {
   "name": "@softr/sdk",
-  "version": "0.0.74-alpha.0",
+  "version": "0.0.74",
   "type": "module",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.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"
-    }
-  },
-  "bin": {
-    "softr-sdk": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "schema",
-    "skills",
-    "!skills/_artifacts"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.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" }
+  },
+  "bin": { "softr-sdk": "./dist/cli.js" },
+  "files": ["dist", "schema", "skills", "!skills/_artifacts"],
+  "publishConfig": { "access": "public" },
   "scripts": {
     "build": "tsdown",
     "test": "node --import ./src/test-utils/setup.ts --test",
@@ -63,9 +42,7 @@
       "optional": true
     }
   },
-  "keywords": [
-    "tanstack-intent"
-  ],
+  "keywords": ["tanstack-intent"],
   "intent": {
     "version": 1,
     "repo": "@softr/sdk",

package/skills/softr-sdk/SKILL.md

@@ -12,7 +12,7 @@ description: >-
 metadata:
   type: core
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 # Softr SDK core

package/skills/softr-sdk/auth/SKILL.md

@@ -18,7 +18,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `auth` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build.
@@ -85,7 +85,8 @@ Changing the visitor's own profile:
 
 | Call | Does |
 | --- | --- |
-| `auth.updateProfile({ fullName?, avatar? })` | Changes their name, their photo, or both. `avatar: null` removes the photo |
+| `auth.updateProfile({ fullName?, avatar? })` | Changes their name, their photo, or both |
+| `auth.removeAvatar()` | Removes their photo |
 
 ## Setup
 
@@ -461,7 +462,7 @@ After a reset, enrol the new app with `startAuthenticatorSetup` and `confirmAuth
 ```ts
 const result = await auth.updateProfile({ fullName: 'Ann Lee' })
 const result = await auth.updateProfile({ avatar: file })   // a File from an <input type="file">
-const result = await auth.updateProfile({ avatar: null })   // removes the photo
+const result = await auth.removeAvatar()                   // removes the photo
 ```
 
 It answers with the updated `User`. Pass the file through a server function that takes `FormData`. The photo must be a PNG, JPEG or GIF of at most 5 MB, or it answers `notAnImage` or `fileTooLarge`. A blank or unacceptable name answers `invalidName`.

package/skills/softr-sdk/charts-and-metrics/SKILL.md

@@ -12,7 +12,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler or a server-side route hook — importing it into a component fails the build. `defineQuery` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/current-user/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 # The current user

package/skills/softr-sdk/file-uploads/SKILL.md

@@ -10,7 +10,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `upload` lives on `@softr/sdk/server` and runs inside server functions. `useFileUpload` and `FileItem` live on `@softr/sdk` and run in components. `FileAttachment` comes from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/formatting/SKILL.md

@@ -10,7 +10,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 # Dates, times and numbers

package/skills/softr-sdk/integrations/SKILL.md

@@ -10,7 +10,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `integration` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineIntegration` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/mcp/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `softrMcpMiddleware` lives on `@softr/sdk` and is registered once, in `src/start.ts`. The actions you hand it are the same `defineQuery` / `defineMutation` values the app's own pages use — declared wherever they already live, not duplicated for MCP.

package/skills/softr-sdk/pwa/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 # Installing the app

package/skills/softr-sdk/record-mutations/SKILL.md

@@ -11,7 +11,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineMutation` and every type come from `@softr/sdk` and can be imported anywhere.
@@ -155,7 +155,7 @@ A form select for a `LINKED_RECORD` field needs its options from the linked tabl
 
 Each key of `data` accepts exactly what its field takes (see [record-queries](../record-queries/SKILL.md#typing)):
 
-- SELECT and LINKED_RECORD take `{ id }`. Not a bare string, and not the `{ id, label }` a read returns; the label is display data and a write does not accept it. For a form select that should follow the field's choices in Studio, read them with `ds.choices` (see [record-queries](../record-queries/SKILL.md)).
+- SELECT and LINKED_RECORD take `{ id }`. Not a bare string, and not the `{ id, label }` a read returns; the label is display data and a write does not accept it. A generated SELECT narrows the id to the field's own choices.
 - CHECKBOX takes a boolean. Dates take ISO strings, never `Date` instances.
 - ATTACHMENT takes `{ url }`, optionally with `filename`, `id` and `type`.
 - A multi-entry field takes an array of the value.

package/skills/softr-sdk/record-queries/SKILL.md

@@ -13,7 +13,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler or a server-side route hook — importing it into a component fails the build. The same holds for any helper that calls `ds`: declare it inside the handler. A function at module level that calls `ds` keeps the server-only import in the browser bundle, and every page stops loading until it moves. `defineQuery` and every type come from `@softr/sdk` and can be imported anywhere.
@@ -200,12 +200,6 @@ const loadProductStatuses = createServerFn()
 
 Skip this request when the options are predefined and fixed — hardcode them instead.
 
-A `SELECT` field's options are its choices, and the builder can add and rename them in Studio after the app is built. When a dropdown should follow those changes, read them with `ds.choices`. When the app means a fixed choice, such as a "Done" tab, use its id directly. A mistyped id is not caught at compile time, and a write with an id the field lacks adds it as a new choice. `ds.choices` takes any query or mutation that declares the field and answers `[{ id, label, color }]` as the field holds them now. Each `id` is what a `where` and a write take, for a filter dropdown and a form select alike:
-
-```ts
-const loadStatuses = createServerFn().handler(() => ds.choices(listProjects, 'status'))
-```
-
 A read the datasource turns down throws rather than coming back empty, and it throws a plain `Error` carrying the status, followed by the reason the datasource gives when it sends one. There is no typed predicate to narrow it with. Handle it where you would handle any other failed fetch: an `errorComponent` on the route, or a check in the handler.
 
 ## Typing

package/skills/softr-sdk/record-queries/references/filters-and-sorting.md

@@ -83,7 +83,7 @@ Every value is an ISO date string, either `'2026-01-31'` or a full timestamp. A
 | `.isOneOf(values)` / `.isNoneOf(values)` | Any of / none of |
 | `.isEmpty()` / `.isNotEmpty()` | No value / has a value |
 
-Values are choice ids, never labels. A SELECT takes any choice id as a string, so a filter dropdown can pass the ids `ds.choices` returns. A label still matches nothing. A LINKED_RECORD compares against the linked record's id.
+Values are choice ids, never labels. A generated SELECT narrows the argument to the field's own choice ids, so a label or a typo is a type error. A LINKED_RECORD compares against the linked record's id.
 
 ### Multi-value fields
 

package/skills/softr-sdk/region-visibility/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `Audience` and `defineVisibility` come from `@softr/sdk` and work anywhere.

package/skills/softr-sdk/routes-and-visibility/SKILL.md

@@ -13,7 +13,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `defineVisibility`, the access functions and the error predicates come from `@softr/sdk` and work anywhere.

package/skills/softr-sdk/workflows/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.71
+  library_version: 0.0.74
 ---
 
 **Boundary.** `workflow` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineWorkflow` and every type come from `@softr/sdk` and can be imported anywhere.