@softr/sdk 0.0.76 → 0.0.77

package/dist/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softr/sdk",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "type": "module",
   "exports": {
     ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },

package/skills/softr-sdk/SKILL.md

@@ -1,18 +1,14 @@
 ---
 name: softr-sdk
 description: >-
-  Entry point for @softr/sdk, the layer a Softr app uses to reach Softr: the
-  four entrypoints (@softr/sdk, /server, /client, /vite) and the client-server
-  boundary between them, softrAuthMiddleware, getSoftrContext,
-  initialSoftrContext, SoftrContext, and which sub-skill to load for route
-  visibility, the current user, reading records, charts and metrics, writing
-  records, auth, or showing dates and numbers. Load this when unsure which
-  sub-skill applies, or when touching the wiring; each sub-skill stands alone
-  for its own task.
+  Entry point for @softr/sdk: its four entrypoints (@softr/sdk, /server,
+  /client, /vite) and their client-server boundary, softrAuthMiddleware and the
+  Softr context, and which sub-skill covers each task. Load it when unsure which
+  sub-skill applies, or when touching the wiring.
 metadata:
   type: core
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 # Softr SDK core

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

@@ -1,24 +1,15 @@
 ---
 name: auth
 description: >-
-  Sign a Softr visitor in, out or up from a server function: auth.signIn,
-  signInWithCode, signInWithGoogle, signInWithMagicLink, signUp, confirmSignUp
-  and signOut from @softr/sdk/server, the authenticator-app calls that finish a
-  sign-in (verifyAuthenticator, startAuthenticatorSetup,
-  confirmAuthenticatorSetup, skipAuthenticatorSetup) and the ones that change an
-  authenticator from a settings page (sendAuthenticatorResetCode,
-  resetAuthenticator, removeAuthenticator), updateProfile for the visitor's own
-  name and photo, the emailed password links (requestPasswordReset,
-  checkPasswordLink, setPasswordWithLink), and getAuthSettings,
-  AuthSettingsProvider and useAuthSettings for which sign-in and sign-up methods
-  the app has enabled. Covers the Result shape they answer with and its error
-  codes (invalidCredentials, emailTaken, notAuthenticated, notAnImage and the
-  rest), the two-step sign-up, why a successful sign-in does not always mean the
-  visitor is signed in, and toReturnPath for where to land after signing in.
+  Sign a visitor in, out or up from a server function with auth from
+  @softr/sdk/server: password, code, Google and magic link, sign-up and its
+  confirmation, the authenticator-app steps, password reset links,
+  updateProfile, and getAuthSettings and useAuthSettings for the methods the app
+  enables. Covers the Result shape, its error codes, and toReturnPath.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **Boundary.** `auth` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build.

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

@@ -1,18 +1,15 @@
 ---
 name: charts-and-metrics
 description: >-
-  Aggregate Softr datasource records inside a server function: ds.chart with
-  groupBy, metrics, where and orderBy for chart rows, ds.metric for a single
-  headline number, date bucket intervals, which aggregations each kind of field
-  offers, the two-group-column ceiling, and distinct values for filter controls.
-  Use when drawing a chart, a stat tile or any counted, summed or averaged
-  number, when filling a dropdown from a real column, or when a chart comes back
-  scrambled or with the wrong rows. Aggregation only: fetching individual
-  records is record-queries, and changing them is record-mutations.
+  Aggregate records in a server function: ds.chart with groupBy, metrics, where,
+  orderBy and date buckets for chart rows, ds.metric for one number, and
+  distinct values for filter controls. Use for a chart, a stat tile or any
+  counted, summed or averaged number, or when a chart comes back wrong. Single
+  records are record-queries.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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/comments/SKILL.md

@@ -1,17 +1,14 @@
 ---
 name: comments
 description: >-
-  Comment threads on records: defineComments from @softr/sdk declares which
-  datasource has comments; comments.list, create, update, delete, react,
-  subscription, setSubscription and searchMentions from @softr/sdk/server read
-  and write one record's thread inside a server function; useCommentComposer
-  and useFileUpload from @softr/sdk/client keep a textarea's text, its
-  @mentions and its attachments in step. Bodies come back as sanitised
-  bodyHtml. A null thread means render nothing.
+  Comment threads on records: defineComments, the comments calls from
+  @softr/sdk/server to list, write, react to and mention in one record's thread,
+  and useCommentComposer and useFileUpload from @softr/sdk/client for the
+  composer. Bodies come back as sanitised bodyHtml.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **Boundary.** `comments` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler. Importing it into a component fails the build. `useCommentComposer` lives on `@softr/sdk/client` and runs in components. `defineComments` comes 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.76
+  library_version: 0.0.77
 ---
 
 # The current user

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

@@ -1,16 +1,13 @@
 ---
 name: file-uploads
 description: >-
-  Upload files from a form or edit view: useFileUpload(action) from @softr/sdk
-  does everything — XHR upload with real progress, per-upload cancel, and
-  isUploading to block form submission. No route registration needed; the SDK
-  ships its own server function. For server-side uploads or plain forms, use
-  upload(actionId, file) from @softr/sdk/server. For edit forms pass
-  initialAttachments to pre-load existing attachments.
+  Upload files from a form or edit view: useFileUpload from @softr/sdk, with
+  progress, cancel and isUploading to hold the submit, and initialAttachments
+  for an edit form; upload from @softr/sdk/server for a server-side upload.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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

@@ -2,15 +2,13 @@
 name: formatting
 description: >-
   Show dates, times and numbers in the app's format without hydration
-  mismatches: FormattedDate in JSX, useFormatting with formatDate,
-  formatDateTime and formatNumber in code, FormattingScope and the timeZone
-  option for a zone or locale the user names, parts for a partial date, and why
-  toLocaleDateString, toLocaleString and Intl formatters with the runtime's
-  defaults must never run in render.
+  mismatches: FormattedDate, useFormatting with formatDate, formatDateTime and
+  formatNumber, FormattingScope and timeZone, and why toLocaleDateString and
+  Intl defaults must never run in render.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 # Dates, times and numbers

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

@@ -1,16 +1,13 @@
 ---
 name: integrations
 description: >-
-  Call a third-party service connected to the app as an integration:
-  defineIntegration from @softr/sdk declares the action with its integrationId,
-  the one HTTP method and endpoint url it allows, and permissions;
-  integration.createFetcher from @softr/sdk/server binds it and returns a
-  fetcher function you call with optional params, query, headers, and body.
-  Check res.ok before res.json().
+  Call a third-party service connected as an integration: defineIntegration from
+  @softr/sdk declares the one method and endpoint it allows, and
+  integration.createFetcher from @softr/sdk/server calls it.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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.76
+  library_version: 0.0.77
 ---
 
 **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.76
+  library_version: 0.0.77
 ---
 
 # Installing the app

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

@@ -1,17 +1,14 @@
 ---
 name: record-mutations
 description: >-
-  Create, update and delete records in a Softr datasource with defineMutation,
-  ds.create, ds.update and ds.delete: one declaration per operation, the data
-  payload keyed by your own field names, what each field type accepts on a
-  write, and the record each call returns. Use when submitting a form, saving an
-  edit or deleting a record, or when a write throws, writes the wrong field or
-  silently changes nothing. Writes only: fetching records is record-queries, and
-  aggregating them is charts-and-metrics.
+  Create, update and delete records with defineMutation, ds.create, ds.update
+  and ds.delete: the payload keyed by your own field names and what each field
+  type accepts. Use when submitting a form, saving an edit or deleting a record,
+  or when a write fails or changes nothing. Reads are record-queries.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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.

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

@@ -1,19 +1,15 @@
 ---
 name: record-queries
 description: >-
-  Fetch records from a Softr datasource with defineQuery, ds.list and ds.get:
-  the where and orderBy callbacks, field names of your own choosing, the
-  20-record default and 100-record cap, nextOffset pagination, and scoping a
-  read to the signed-in visitor. Use when putting datasource records on a page,
-  in a table, a list or a detail view, when filtering or sorting them, when
-  filling a filter or form dropdown with all options from a linked table, or
-  when a read comes back empty, unsorted or missing a field. Reads only:
-  creating, updating and deleting records is record-mutations, and aggregating
-  them into totals or chart rows is charts-and-metrics.
+  Fetch records with defineQuery, ds.list and ds.get: where and orderBy, field
+  names of your own choosing, pagination and its limits, and scoping a read to
+  the signed-in visitor. Use to put records on a page or fill a dropdown, or
+  when a read comes back empty, unsorted or missing a field. Writes are
+  record-mutations; totals and chart rows are charts-and-metrics.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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.

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

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

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

@@ -1,19 +1,14 @@
 ---
 name: routes-and-visibility
 description: >-
-  Add a route file to a Softr app and declare who may see it: defineVisibility
-  with a userGroupTypes set naming LOGGED_IN_USERS and/or NON_LOGGED_IN_USERS,
-  customGroups, and the ways to apply a rule: guardRoute and assertRouteAccess
-  in a route, isAuthorized and checkAccess anywhere. Covers per-reason
-  overrides, the redirect and throw strategies, rendering an access error with
-  isAccessError, isUnauthenticatedError, isForbiddenError and
-  isAlreadyAuthenticatedError, guarding a layout, and the lint rule that
-  requires a declaration alongside the rules that reject a duplicate, computed
-  or root-level one.
+  Add a route file and declare who may see it: defineVisibility with
+  LOGGED_IN_USERS, NON_LOGGED_IN_USERS and customGroups, guardRoute and
+  assertRouteAccess in a route, isAuthorized and checkAccess anywhere, rendering
+  an access error, and the lint rule that requires the declaration.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.76
+  library_version: 0.0.77
 ---
 
 **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.76
+  library_version: 0.0.77
 ---
 
 **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.