@softr/sdk 0.0.97-alpha.2 → 0.0.98-anonsession.0

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

@@ -4,12 +4,12 @@ description: >-
   Read the signed-in Softr visitor: useCurrentUser and the User type,
   context.user in a route's beforeLoad, and context.user inside a server
   function handler, where Start types it from the app's registered request
-  middleware. Covers the null guest and the generated SoftrUserGroups that
-  narrows group ids to the app's own.
+  middleware. Covers the null guest, the generated SoftrUserGroups that narrows
+  group ids to the app's own, and reading the visitor's role on the server.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.97-alpha.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 # The current user
@@ -92,6 +92,19 @@ const getMyInvoices = createServerFn().handler(async ({ context }) => {
 
 `context.user` is typed. Start derives a handler's context from the app's registered request middleware as well as the server function's own, so there is nothing to import and nothing to cast.
 
+### The visitor's role, in a server function
+
+A server function that answers by role reads the role from `context.user.userGroupIds`, never from an argument. Use it to pick which query and which scope the role reads, as [record-queries](../record-queries/SKILL.md#keep-each-visitor-to-their-own-records) shows:
+
+```ts
+if (!context.user) throw new Error('Not signed in')
+if (context.user.userGroupIds.includes('00000000-0000-0000-0000-00000000000a')) {
+  // read with the staff query and the staff scope
+}
+```
+
+`context.user.id` is the visitor's account id, not their row in the Users table. A link to Users holds the row id, so a filter on such a link takes the row that `auth.currentUserRow` finds.
+
 ### Group ids are the app's own
 
 For every group's name and id, read `docs/user-groups.md`. It lists every group the app has, the predefined ones included. Copy an id from there; never derive one from a group's name.

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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 # 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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.
@@ -16,8 +16,6 @@ metadata:
 
 `integration.createFetcher` calls a third-party API through Softr's authenticated proxy. It adds the connected account's credentials automatically — you never set API keys or auth headers yourself. **Every call acts as that one account, whoever the visitor is**, so take what a call reaches, such as a customer or a channel, from the session or a record the server read, never from the arguments the browser sends.
 
-An email the app sends is the `email` sub-skill, with nothing to connect. Send through a connected Gmail or Outlook only when the user wants the email to come from their own mailbox.
-
 ## Setup
 
 ```ts

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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 # Installing the app

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

@@ -2,13 +2,14 @@
 name: record-mutations
 description: >-
   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.
+  and ds.delete: the payload keyed by your own field names, what each field type
+  accepts, and keeping an update or a delete to the records the visitor may
+  read. 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.97-alpha.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.
@@ -111,6 +112,42 @@ const removeProject = createServerFn({ method: 'POST' })
 
 Resolves to nothing. A record that cannot be deleted throws.
 
+### Change only the records the visitor may read
+
+When a role reads only some records of a table, it updates and deletes only those records. `permissions` decides who may run the mutation, not which record. The id comes from the browser, so it can name any record. Before the write, read the record through the same query and scope as every read of the table (see [record-queries](../record-queries/SKILL.md#keep-each-visitor-to-their-own-records)). Refuse the write when that read answers `null`, with the same error as a missing record, so the visitor cannot find out which ids exist. Keep the field that the scope filters on, such as the owner, out of the update's `fields`. If it is in `fields`, a visitor can move a record to another person.
+
+Below, `bookings` is the query every read of bookings uses, and `usersQuery` is the app's query on the Users table. `updateBooking` declares `status` only, not `client`.
+
+```ts
+import { auth, ds } from '@softr/sdk/server'
+
+const cancelBooking = createServerFn({ method: 'POST' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ context, data }) => {
+    const me = await auth.currentUserRow(context.user, usersQuery, 'email')
+    if (me === null) throw new Error('Booking not found')
+    const booking = await ds.get(bookings, { id: data.id }).where((q) => q.client.isOneOf([me.id]))
+    if (booking === null) throw new Error('Booking not found')
+    await ds.update(updateBooking, { id: booking.id, data: { status: { id: 'cancelled' } } })
+  })
+```
+
+A delete takes the same read before `ds.delete`. A create into a table that takes its parent's scope, such as a message in a chat, reads the parent through its scope before `ds.create` (see [record-queries](../record-queries/SKILL.md#a-table-with-no-link-to-users-takes-its-parents-scope)).
+
+### Only the roles that change a table
+
+Often fewer roles change a table than read it. A mutation's `customGroups` names only the roles that may change the table, also when more roles read it. In a barber app, every client reads the free hours, but only barbers open or close them. So the slot update names the barbers' group only, and a barber still changes only their own slots, through the read above:
+
+```ts
+const updateSlot = defineMutation({
+  id: 'updateSlot',
+  datasourceId: '00000000-0000-0000-0000-000000000004',
+  operation: 'update',
+  fields: { open: 'Wd5nKp2xRb8Tc3' },
+  permissions: { userGroupTypes: ['LOGGED_IN_USERS'], customGroups: ['00000000-0000-0000-0000-00000000000b'] },
+})
+```
+
 ### Edit an existing record
 
 An edit form needs both halves: a `defineQuery` to load the record and a `defineMutation` to save it. They are separate declarations over the same table, so give both the fields the form touches, and read the loaded values off the query's names.

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

@@ -2,14 +2,15 @@
 name: record-queries
 description: >-
   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.
+  names of your own choosing, pagination and its limits, and keeping each
+  visitor to their own records and to the fields their role may see. Use to put
+  records on a page or fill a dropdown, to write any server function that reads
+  a table, 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.97-alpha.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.
@@ -125,37 +126,6 @@ if (first.nextOffset !== null) {
 
 `nextOffset` is `null` when there are no more pages. `total` is the count of all matching records, not the count returned.
 
-### Scope the read to the visitor
-
-```ts
-const myInvoices = defineQuery({
-  id: 'myInvoices',
-  datasourceId: '00000000-0000-0000-0000-000000000001',
-  fields: { owner: 'Gq5wNt8rJy3Hb1', amount: 'Vk9cXm2pSz6Ld4' },
-  permissions: { userGroupTypes: ['LOGGED_IN_USERS'] },
-})
-
-const listMyInvoices = createServerFn().handler(async ({ context }) => {
-  if (!context.user) throw new Error('Not signed in')
-  const userId = context.user.id
-  return await ds.list(myInvoices).where((q) => q.owner.is(userId))
-})
-```
-
-When the owner is a link to the Users table, the row to match is the visitor's own row there, not `context.user.id`. `auth.currentUserRow(context.user, usersQuery, 'email')` finds it by email, or answers `null` when they are signed out or have no row:
-
-```ts
-import { auth, ds } from '@softr/sdk/server'
-
-const listMyDeals = createServerFn().handler(async ({ context }) => {
-  const me = await auth.currentUserRow(context.user, usersQuery, 'email')
-  if (me === null) return { records: [], nextOffset: null }
-  return await ds.list(deals).where((q) => q.owner.isOneOf([me.id]))
-})
-```
-
-The SDK enforces `permissions`, so a visitor outside the declared audience never reaches the records. Which of those records belong to one visitor is a separate question, and the `where` above answers it: a group says nothing about who owns a row, so a per-visitor read filters on `context.user`. See [current-user](../current-user/SKILL.md) for how the visitor gets onto `context`.
-
 ### Populate a control from a linked table
 
 A `LINKED_RECORD` field on a record answers with `{ id, label }` — the label is the linked record's primary field, and the id is what a write or a `where` filter takes. To fill a filter dropdown or form select with **all** options from the linked table (not just the values already referenced by existing records), query the linked table's own datasource:
@@ -194,6 +164,8 @@ const loadProductStatuses = createServerFn()
   .handler(({ data }) => ds.options(productStatuses, { label: 'name', ...data }))
 ```
 
+`ds.options` takes no `where`, so use it only over a table with no scope. A picker over a scoped table reads with `ds.list` and the scope: see [A picker over a scoped table](#a-picker-over-a-scoped-table).
+
 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:
@@ -205,6 +177,130 @@ const loadCategories = createServerFn().handler(() => ds.choices(products, 'cate
 
 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.
 
+## Keep each visitor to their own records
+
+`permissions` decides who may run a query. It does not decide which rows they get, and it does not hide a field the query declares. A visitor can call every server function with any arguments, so one read that skips a rule opens the table to them. The examples below use `bookings`, a query over a table where a client sees only their own bookings, and `usersQuery`, the app's query on the Users table.
+
+### One scope per table, in every read
+
+A privacy rule from the builder's prompt, such as "clients see only their own bookings", belongs to the table, not to the page where it came up. Every server function that reads the table applies the same `where`: the list, the get by id, a search, a picker, a count and a chart. Keep these server functions beside the table's queries, so the copies of the filter stay together and a new read is written next to them. A get by id takes the same `where`, so an id outside the scope reads as `null`.
+
+```ts
+// Bookings are private: a client reads only the bookings linked to their own Users row.
+// Every read of bookings applies this filter.
+const getMyBooking = createServerFn()
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ context, data }) => {
+    const me = await auth.currentUserRow(context.user, usersQuery, 'email')
+    if (me === null) return null
+    return await ds.get(bookings, { id: data.id }).where((q) => q.client.isOneOf([me.id]))
+  })
+```
+
+The filter matches the field that holds the owner. A link to the Users table holds the visitor's row there, not `context.user.id`. `auth.currentUserRow(context.user, usersQuery, 'email')` finds that row by email, or answers `null` when they are signed out or have no row. A `USER` field holds the account itself, so it filters on `context.user.id` after a check for a signed-out visitor. See [current-user](../current-user/SKILL.md) for how the visitor gets onto `context`.
+
+### A picker over a scoped table
+
+`ds.options` takes no `where`, so a picker over a scoped table reads with `ds.list` and the scope, and maps the records to the `{ id, label }` the picker takes. Here `title` is the field of `bookings` the picker shows:
+
+```ts
+const loadMyBookings = createServerFn()
+  .validator(z.object({ term: z.string(), offset: z.number().nullable() }))
+  .handler(async ({ context, data }) => {
+    const me = await auth.currentUserRow(context.user, usersQuery, 'email')
+    if (me === null) return { options: [], nextOffset: null }
+    const term = data.term.trim()
+    let list = ds.list(bookings).where((q) => q.client.isOneOf([me.id]))
+    if (term !== '') list = list.where((q) => q.title.contains(term))
+    const page = await list.offset(data.offset).limit(20)
+    return {
+      options: page.records.map((record) => ({ id: record.id, label: record.fields.title ?? '' })),
+      nextOffset: page.nextOffset,
+    }
+  })
+```
+
+### Server functions you add use the same scope
+
+A server function you write for a new page or widget applies the table's scope too. When it needs other fields, it may declare its own query over the table, but every query over a scoped table takes the same scope. A query read without it is a second path to the same rows.
+
+```ts
+const nextBookings = defineQuery({
+  id: 'nextBookings',
+  datasourceId: '00000000-0000-0000-0000-000000000002',
+  fields: { date: 'Xp2dLh6vKz9Fa3', client: 'Pc8vNm3kTq6Wz2' },
+  permissions: { userGroupTypes: ['LOGGED_IN_USERS'] },
+})
+
+// Wrong: read with no scope. Every client sees every booking.
+const loadNext = createServerFn().handler(() => ds.list(nextBookings).limit(3))
+
+// Right: the same scope as every other read of bookings.
+const loadNext = createServerFn().handler(async ({ context }) => {
+  const me = await auth.currentUserRow(context.user, usersQuery, 'email')
+  if (me === null) return { records: [], total: 0, nextOffset: null }
+  return await ds
+    .list(nextBookings)
+    .where((q) => q.client.isOneOf([me.id]))
+    .orderBy((q) => q.date.asc)
+    .limit(3)
+})
+```
+
+The scope filters on `client`, so `nextBookings` declares it, also when the page does not show it.
+
+### A table with no link to Users takes its parent's scope
+
+Some tables have no link to Users. Chat messages belong to a chat, and the browser sends the chat id. If a server function reads the messages by that id alone, any chat id reads its messages. The same goes for a game room read by its code. Such a table takes its parent's scope: read the parent through its own scope first. Read or post the children only when that read answers, and filter them on the parent that it answered. Here `chats` has a `members` link to Users, and `messages` has a `chat` link to chats:
+
+```ts
+const listMessages = createServerFn()
+  .validator(z.object({ chatId: z.string() }))
+  .handler(async ({ context, data }) => {
+    const me = await auth.currentUserRow(context.user, usersQuery, 'email')
+    if (me === null) throw new Error('Chat not found')
+    const chat = await ds.get(chats, { id: data.chatId }).where((q) => q.members.isOneOf([me.id]))
+    if (chat === null) throw new Error('Chat not found')
+    return await ds
+      .list(messages)
+      .where((q) => q.chat.isOneOf([chat.id]))
+      .orderBy((q) => q.sentAt.asc)
+      .limit(100)
+  })
+```
+
+A server function that posts a message reads the chat the same way before `ds.create`.
+
+### Other people's records show only what the role needs
+
+A read returns every field its query declares, and everything a server function returns reaches the browser, also when the page does not show it. A list of other people, such as a directory or the members of a chat, declares only the fields its role needs, so no email or phone unless the role needs them. A `USER` field reads back with the person's email, so a list that must not show emails does not declare one either. When roles need different fields, declare one query per role, each with its own `fields` and `permissions`, and pick the query on the server by the visitor's groups:
+
+```ts
+const peopleForMembers = defineQuery({
+  id: 'peopleForMembers',
+  datasourceId: '00000000-0000-0000-0000-000000000003',
+  fields: { name: 'Hn4tRw8kPz2Mc5', jobTitle: 'Lb7yQe3vXa9Ns1' },
+  permissions: { userGroupTypes: ['LOGGED_IN_USERS'] },
+})
+
+const peopleForStaff = defineQuery({
+  id: 'peopleForStaff',
+  datasourceId: '00000000-0000-0000-0000-000000000003',
+  fields: { name: 'Hn4tRw8kPz2Mc5', jobTitle: 'Lb7yQe3vXa9Ns1', email: 'Td2kWm6pFs8Jq4' },
+  permissions: { userGroupTypes: ['LOGGED_IN_USERS'], customGroups: ['00000000-0000-0000-0000-00000000000a'] },
+})
+
+const listPeople = createServerFn().handler(async ({ context }) => {
+  if (!context.user) throw new Error('Not signed in')
+  if (context.user.userGroupIds.includes('00000000-0000-0000-0000-00000000000a')) {
+    return await ds.list(peopleForStaff).limit(100)
+  }
+  return await ds.list(peopleForMembers).limit(100)
+})
+```
+
+A role that may change only some rows changes only the rows it can read: see [record-mutations](../record-mutations/SKILL.md). A count or a chart over the table takes the same scope: see [charts-and-metrics](../charts-and-metrics/SKILL.md).
+
 ## Typing
 
 Queries you write are type safe and a type error is shown when there's a mistake. The records a read returns are typed the same way, so never validate them again with a zod schema of your own. A schema guesses each field's shape, and one value it misses, such as a person with no email, throws for the whole read and the page stops loading. Show each field with a fallback instead: `record.fields.owner?.name ?? '—'`. For an in depth reference on what fields every datasource has, read `docs/datasources/README.md` first — it lists every registered datasource with a link to its file. Follow those links to get field ids, types, and constraints. Do not guess filenames from table names.

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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **Boundary.** `definePage`, `pageHead`, the access functions and the error predicates come from `@softr/sdk` and work anywhere.
@@ -73,7 +73,7 @@ Everyone is both audiences, as in the first line above. A set names each audienc
 
 Take every id in `customGroups` from `docs/user-groups.md`, which lists each group the app has with its name and id. An id the app does not have is a type error.
 
-**`visibility` guards the page, not the server functions it calls.** A call can reach them without the page and with any arguments, so the queries and mutations behind a page carry its groups in their own `permissions` and reach only the rows the visitor's role allows.
+**`visibility` guards the page, not the server functions it calls.** A call can reach them without the page and with any arguments, so the queries and mutations behind a page carry its groups in their own `permissions`. `permissions` decide who may run them, not which rows they reach: each server function filters the rows itself, as [record-queries](../record-queries/SKILL.md#keep-each-visitor-to-their-own-records) shows.
 
 ## Core Patterns
 

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.2
+  library_version: 0.0.98-anonsession.0
 ---
 
 **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.
@@ -18,8 +18,6 @@ metadata:
 
 `workflow.trigger` fires a Softr workflow and waits for it to finish. It resolves to `void`.
 
-An email the app sends itself, when a form is submitted or a button is pressed, needs no workflow: load the `email` sub-skill. Fire a workflow for what the workflow's own steps do, such as updating a CRM or posting to a connected service.
-
 ## Setup
 
 ```ts
@@ -33,15 +31,15 @@ import { workflow } from '@softr/sdk/server'
 Every trigger needs a workflow action: which workflow, which trigger step, who may run it, and any data that is always sent. The workflow must have a **Run custom workflow** trigger — no other trigger type can be fired from app code.
 
 ```ts
-const syncNewLead = defineWorkflow({
-  id: 'syncNewLead',
+const sendWelcomeEmail = defineWorkflow({
+  id: 'sendWelcomeEmail',
   workflowId: 'c9d8e7f6-a5b4-4c3d-8e2f-1a0b9c8d7e6f',
   triggerId: '926da496-749f-4006-999c-197d8a556122',
   permissions: { userGroupTypes: ['LOGGED_IN_USERS'] },
   body: {
     email: '{LOGGED_IN_USER:EMAIL}',  // resolved server-side from the signed-in user
     name: '{LOGGED_IN_USER:NAME}',
-    source: 'website',                // any hardcoded value — always sent, never overridden at runtime
+    plan: 'enterprise',               // any hardcoded value — always sent, never overridden at runtime
   },
 })
 ```
@@ -72,7 +70,7 @@ These placeholders are resolved server-side when the workflow runs:
 const runWorkflow = createServerFn({ method: 'POST' })
   .validator(z.object({ message: z.string() }))
   .handler(async ({ data }) => {
-    await workflow.trigger(syncNewLead, { message: data.message })
+    await workflow.trigger(sendWelcomeEmail, { message: data.message })
   })
 ```
 
@@ -84,7 +82,7 @@ const runWorkflow = createServerFn({ method: 'POST' })
 
 ```ts
 const run = createServerFn({ method: 'POST' }).handler(async () => {
-  await workflow.trigger(syncNewLead)
+  await workflow.trigger(sendWelcomeEmail)
 })
 ```
 
@@ -96,11 +94,11 @@ Omit the second argument when the action's `body` already carries everything the
 
 ```ts
 // Wrong: calling from a click handler
-<button onClick={() => workflow.trigger(syncNewLead)}>Run</button>
+<button onClick={() => workflow.trigger(sendWelcomeEmail)}>Run</button>
 
 // Correct: server function, called from the button
 const run = createServerFn({ method: 'POST' }).handler(() =>
-  workflow.trigger(syncNewLead),
+  workflow.trigger(sendWelcomeEmail),
 )
 // …
 const submit = useServerFn(run)

package/dist/auth/permissions.js

@@ -1,13 +0,0 @@
-import { z } from "zod";
-
-//#region src/auth/permissions.ts
-const datasourcePermissionsSchema = z.object({
-	read: z.boolean(),
-	create: z.boolean(),
-	update: z.boolean(),
-	delete: z.boolean()
-});
-const permissionsSchema = z.object({ datasources: z.record(z.string(), datasourcePermissionsSchema) });
-
-//#endregion
-export { permissionsSchema };

package/dist/core/email.d.ts

@@ -1,48 +0,0 @@
-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", "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. */
-  to?: ReadonlyArray<string>;
-  /** Ignored when the action declares its own `cc` or `to`. */
-  cc?: ReadonlyArray<string>;
-  /** Ignored when the action declares its own `bcc` or `to`. */
-  bcc?: ReadonlyArray<string>;
-  /** Ignored when the action declares its own. */
-  replyTo?: string;
-  subject: string;
-  /** Plain text or HTML. */
-  body: string;
-}
-interface EmailSent {
-  /** Null when the mail provider did not report one; the email was still sent. */
-  messageId: string | null;
-}
-/**
- * Thrown when Softr did not send the email. `code` says why:
- *
- * - `NOT_FOUND`: no such action, or the caller is not in its audience.
- * - `INVALID_INPUT`: the call's inputs were refused; the message says which.
- * - `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.
- */
-declare class EmailError extends Error {
-  readonly status: number;
-  readonly code: EmailErrorCode;
-  constructor(status: number, code: EmailErrorCode, message: string);
-}
-/** Sends one email through the action. Never retries by itself. */
-declare function sendEmail(action: EmailAction, init: EmailSendInit): Promise<EmailSent>;
-declare const email: {
-  send: typeof sendEmail;
-};
-//#endregion
-export { EmailError, EmailErrorCode, EmailSendInit, EmailSent, email };

package/dist/core/email.js

@@ -1,100 +0,0 @@
-import { assert } from "../assertions.js";
-import { softrApiUrl } from "../softr-api.js";
-import { fetch } from "../fetch.js";
-import { sessionConfig } from "../auth/config.js";
-import { readSessionToken } from "../auth/session.js";
-
-//#region src/core/email.ts
-/** Longer than Softr waits for the send itself, so its own timeout answers first. */
-const TIMEOUT_MS = 12e4;
-const EMAIL_ERROR_CODES = [
-	"NOT_FOUND",
-	"INVALID_INPUT",
-	"PLAN_RESTRICTED",
-	"CREDITS_EXHAUSTED",
-	"RATE_LIMITED",
-	"DAILY_LIMIT_REACHED",
-	"SENDER_UNAVAILABLE",
-	"PROVIDER_REJECTED",
-	"UNAVAILABLE",
-	"TIMEOUT"
-];
-/**
-* Thrown when Softr did not send the email. `code` says why:
-*
-* - `NOT_FOUND`: no such action, or the caller is not in its audience.
-* - `INVALID_INPUT`: the call's inputs were refused; the message says which.
-* - `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.
-*/
-var EmailError = class extends Error {
-	status;
-	code;
-	constructor(status, code, message) {
-		super(message);
-		this.name = "EmailError";
-		this.status = status;
-		this.code = code;
-	}
-};
-/** Sends one email through the action. Never retries by itself. */
-async function sendEmail(action, init) {
-	const { to, cc, bcc, replyTo, subject, body } = init;
-	const sessionToken = readSessionToken();
-	let res;
-	try {
-		res = await fetch(`${softrApiUrl("SOFTR_PLATFORM_API_URL")}/v1/vibe/applications/${sessionConfig().applicationId}/actions/${action.id}/email`, {
-			method: "POST",
-			headers: {
-				...sessionToken ? { Authorization: `Bearer ${sessionToken}` } : {},
-				"Content-Type": "application/json"
-			},
-			body: JSON.stringify({ input: {
-				to,
-				cc,
-				bcc,
-				replyTo,
-				subject,
-				body
-			} }),
-			signal: AbortSignal.timeout(TIMEOUT_MS)
-		});
-	} catch (error) {
-		if (error instanceof DOMException && error.name === "TimeoutError") throw new EmailError(504, "TIMEOUT", `Email "${action.id}" got no answer in time. It may still have been sent.`);
-		throw new EmailError(502, "UNAVAILABLE", `Email "${action.id}" could not reach Softr: ${error instanceof Error ? error.message : String(error)}`);
-	}
-	if (res.ok) {
-		const sent = await res.json();
-		assert(typeof sent === "object" && sent !== null && "messageId" in sent && (typeof sent.messageId === "string" || sent.messageId === null), "the send answered without a messageId");
-		return { messageId: sent.messageId };
-	}
-	const { code, message } = await readFailure(res, `Email "${action.id}" failed with HTTP ${res.status}`);
-	throw new EmailError(res.status, code, message);
-}
-/** The code and message of a send Softr refused, read from its answer; `fallbackMessage` when it sent none. */
-async function readFailure(res, fallbackMessage) {
-	const failure = await res.json().catch(() => null);
-	const known = typeof failure === "object" && failure !== null ? failure : {};
-	return {
-		code: ("code" in known ? EMAIL_ERROR_CODES.find((errorCode) => errorCode === known.code) : void 0) ?? codeOfStatus(res.status),
-		message: "message" in known && typeof known.message === "string" && known.message !== "" ? known.message : fallbackMessage
-	};
-}
-function codeOfStatus(status) {
-	switch (status) {
-		case 400: return "INVALID_INPUT";
-		case 404: return "NOT_FOUND";
-		case 429: return "RATE_LIMITED";
-		default: return "UNAVAILABLE";
-	}
-}
-const email = { send: sendEmail };
-
-//#endregion
-export { EmailError, email };