@softr/sdk 0.0.97-alpha.1 → 0.0.97-alpha.2

package/dist/core/email.d.ts

@@ -1,7 +1,7 @@
 import { EmailAction } from "../action.js";
 
 //#region src/core/email.d.ts
-declare const EMAIL_ERROR_CODES: readonly ["NOT_FOUND", "INVALID_INPUT", "PLAN_RESTRICTED", "CREDITS_EXHAUSTED", "RATE_LIMITED", "PROVIDER_REJECTED", "UNAVAILABLE", "TIMEOUT"];
+declare const EMAIL_ERROR_CODES: readonly ["NOT_FOUND", "INVALID_INPUT", "PLAN_RESTRICTED", "CREDITS_EXHAUSTED", "RATE_LIMITED", "DAILY_LIMIT_REACHED", "SENDER_UNAVAILABLE", "PROVIDER_REJECTED", "UNAVAILABLE", "TIMEOUT"];
 type EmailErrorCode = (typeof EMAIL_ERROR_CODES)[number];
 interface EmailSendInit {
   /** Ignored when the action declares its own. */
@@ -28,6 +28,8 @@ interface EmailSent {
  * - `PLAN_RESTRICTED`: the workspace's plan does not include sending this email.
  * - `CREDITS_EXHAUSTED`: the workspace has no workflow credits left.
  * - `RATE_LIMITED`: the app sent too many emails lately; try again later.
+ * - `DAILY_LIMIT_REACHED`: Softr's own address sent the workspace's emails for today.
+ * - `SENDER_UNAVAILABLE`: the chosen sender is missing or not confirmed, or the action leaves `to` open and would send from Softr's address.
  * - `PROVIDER_REJECTED`: the mail provider refused the email.
  * - `UNAVAILABLE`: Softr could not send it right now, or could not be reached.
  * - `TIMEOUT`: no answer in time. It may still have been sent.

package/dist/core/email.js

@@ -13,6 +13,8 @@ const EMAIL_ERROR_CODES = [
 	"PLAN_RESTRICTED",
 	"CREDITS_EXHAUSTED",
 	"RATE_LIMITED",
+	"DAILY_LIMIT_REACHED",
+	"SENDER_UNAVAILABLE",
 	"PROVIDER_REJECTED",
 	"UNAVAILABLE",
 	"TIMEOUT"
@@ -25,6 +27,8 @@ const EMAIL_ERROR_CODES = [
 * - `PLAN_RESTRICTED`: the workspace's plan does not include sending this email.
 * - `CREDITS_EXHAUSTED`: the workspace has no workflow credits left.
 * - `RATE_LIMITED`: the app sent too many emails lately; try again later.
+* - `DAILY_LIMIT_REACHED`: Softr's own address sent the workspace's emails for today.
+* - `SENDER_UNAVAILABLE`: the chosen sender is missing or not confirmed, or the action leaves `to` open and would send from Softr's address.
 * - `PROVIDER_REJECTED`: the mail provider refused the email.
 * - `UNAVAILABLE`: Softr could not send it right now, or could not be reached.
 * - `TIMEOUT`: no answer in time. It may still have been sent.

package/dist/default-error-overlay.d.ts

@@ -1,4 +1,4 @@
-import * as react0 from "react";
+import * as react6 from "react";
 
 //#region src/default-error-overlay.d.ts
 type Props = {
@@ -8,6 +8,6 @@ type Props = {
 declare function DefaultErrorOverlay({
   error,
   reset
-}: Props): react0.JSX.Element;
+}: Props): react6.JSX.Element;
 //#endregion
 export { DefaultErrorOverlay };

package/dist/formatting.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import * as react3 from "react";
+import * as react0 from "react";
 import { ReactNode } from "react";
 
 //#region src/formatting.d.ts
@@ -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;
-}): react3.FunctionComponentElement<react3.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;
-}): react3.FunctionComponentElement<react3.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_start7 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_start7.RequestMiddlewareAfterServer<{}, undefined, undefined>;
 //#endregion
 export { softrMcpMiddleware };

package/dist/package.js

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

package/dist/pwa.d.ts

@@ -1,4 +1,4 @@
-import * as react1 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(): react1.FunctionComponentElement<react1.FragmentProps>;
+declare function SoftrPwaHead(): react4.FunctionComponentElement<react4.FragmentProps>;
 type PwaPlatform = "ios" | "android" | "desktop";
 type PwaInstall = {
   available: false;

package/package.json

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

package/skills/softr-sdk/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: core
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 # Softr SDK core

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

@@ -13,7 +13,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **Boundary.** `ai` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineAiAction` and every type come from `@softr/sdk` and can be imported anywhere.

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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 # The current user

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

@@ -12,14 +12,14 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **Boundary.** `email` and `EmailError` live on `@softr/sdk/server` and run only inside a `createServerFn` handler — importing them into a component fails the build. `defineEmailAction` and every type come from `@softr/sdk` and can be imported anywhere.
 
 # Email
 
-An app sends an email through an email action. Softr sends it from the app's email sender and bills the workspace's **workflow credits**, so there is no mail service to connect and no workflow to build. Use it for every email the app sends while it handles something a person does in it: a form submitted, a button pressed, a record saved through the app.
+An app sends an email through an email action. Softr sends it and bills the workspace's **workflow credits**, so there is no mail service to connect and no workflow to build. Use it for every email the app sends while it handles something a person does in it: a form submitted, a button pressed, a record saved through the app.
 
 A workflow is still the answer for an email on a schedule ("every Monday") or on a change made outside the app (a record edited in the table): load `automate-with-workflows` for those. A connected Gmail or Outlook is the answer only when the user wants the email to come from their own mailbox, through the `integrations` sub-skill.
 
@@ -31,15 +31,20 @@ The action's `permissions` is its audience: everyone in it can send an email thr
 
 - **Fix the recipients whenever the use case allows.** A contact form that emails the owner fixes `to` to the owner. "Email me this report" fixes `to` to `{LOGGED_IN_USER:EMAIL}`. Then nobody can send the app's email to anyone else.
 - **When people pick the recipients, narrow the audience.** "Staff email a client" leaves `to` open and keeps the action to the staff group with `customGroups`. An action with open recipients for all signed-in users lets anyone who signs up send any email to anyone from the app's address, up to the workspace's credits. Build that only when the user asks for it, and tell them so in one line. An action open to visitors must fix `to`: one that fixes only `cc` or `bcc` is not stored.
+- **Recipients the person picks need the workspace's own sender.** An action that leaves `to` open must send from a confirmed sender, as its `senderId` or as the app's sender. From Softr's address every send fails with `SENDER_UNAVAILABLE`. Set the sender up before you write such an action, or ask the user which one to use.
 
 ## The sender
 
-Every email comes from the app's email sender, unless the action names one of the workspace's senders with `senderId`. With no sender set, they come from the app's default `@softr.app` address, the one its sign-in emails use.
+An email comes from the action's `senderId`, else from the app's email sender. With neither, it comes from Softr's own address, `"<workspace name>" <workspaceId@softr-email.com>`, the one workflows' "Send email with Softr" uses. That address is for testing: at most 30 emails a day per workspace, and the next one fails with `DAILY_LIMIT_REACHED`. The app's default `@softr.app` address sends only its sign-in emails.
 
-- Read the app's sender with `application_get` before you say where the emails come from, and name it. Never write "if no sender is set": read it. With no sender set, that tool shows the app's default `@softr.app` address: name that one. Say in your closing message when no sender is set, and that the app should get its own sender before real users rely on its emails.
-- When the app has no sender of its own, list the workspace's senders with `workspace_list_email_senders` and offer the confirmed ones by name: for this email (`senderId`, nothing else changes) or as the app's sender. Never pick one yourself.
-- Changing the app's sender also changes the address its sign-in emails come from. Ask the user before you call `application_configure_email_sender`, and name both effects. A workspace whose plan has no custom senders is refused; then say that sending from their own address needs the Professional plan.
-- Set `senderId` only when the user wants this email from a specific address, such as `billing@`. Pick it from `workspace_list_email_senders`, copied exactly. A sender the mail provider has not confirmed makes every send fail until it is confirmed. That confirmation is all an email action needs; the domain's DNS records (DKIM, Return-Path) are needed only before Studio lets the app pick the address as its own sender, and they help the emails stay out of spam.
+A chosen sender that is missing or not confirmed fails every send with `SENDER_UNAVAILABLE`. Softr never falls back to its own address.
+
+- While you build, list the workspace's senders with `workspace_list_email_senders`, and say which are confirmed, or that there are none.
+- With confirmed senders, and a plan that allows custom senders, ask the user which one the email comes from and set it as the action's `senderId`, copied exactly. Nothing else changes, sign-in emails included. Never pick one yourself.
+- With none, say the emails come from Softr's address, for testing and at most 30 a day. To send from their own address, they add one under the workspace's email senders and confirm the email it receives. Custom senders need the Professional or Business plan.
+- Read the app's sender with `application_get` before you say where the emails come from. Your closing message names the actual From address: the `senderId`'s, else the app's, else `<workspaceId>@softr-email.com` with the real id. Never write "if no sender is set": read it.
+- Changing the app's sender also changes the address its sign-in emails come from. Call `application_configure_email_sender` only when the user wants the app's sender changed, after naming both effects.
+- Confirming the email is all an email action needs. The domain's DNS records (DKIM, Return-Path) are needed only before Studio lets the app pick the address as its own sender, and they help the emails stay out of spam.
 
 ## What it costs
 
@@ -114,7 +119,9 @@ Every call is a new email. Disable the button while the request runs, so a doubl
 | `PLAN_RESTRICTED` | The workspace's plan does not allow this email |
 | `CREDITS_EXHAUSTED` | The workspace has no workflow credits left |
 | `RATE_LIMITED` | The app sent too often lately. Tell the person to try again later |
-| `PROVIDER_REJECTED` | The mail provider refused the email, for example from an unconfirmed sender |
+| `DAILY_LIMIT_REACHED` | Softr's own address sent its 30 emails for today. Tell the person the email could not be sent today; the owner fixes it by choosing their own sender |
+| `SENDER_UNAVAILABLE` | The chosen sender is missing or not confirmed, or the action leaves `to` open and has no sender of the workspace's own. Tell the person the email could not be sent; the owner fixes the sender |
+| `PROVIDER_REJECTED` | The mail provider refused the email |
 | `UNAVAILABLE` | Softr could not send it right now or could not be reached |
 | `TIMEOUT` | No answer in time. It may still have been sent, so never send it again by yourself |
 

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

@@ -7,7 +7,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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

@@ -8,7 +8,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 # Dates, times and numbers

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

@@ -7,7 +7,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 # Installing the app

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

@@ -8,7 +8,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **Boundary.** `Audience` and `defineVisibility` come from `@softr/sdk` and work anywhere.

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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **Boundary.** `definePage`, `pageHead`, 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.97-alpha.1
+  library_version: 0.0.97-alpha.2
 ---
 
 **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.