@softr/sdk 0.0.35 → 0.0.37

package/dist/codegen/softr-env.js

@@ -33,7 +33,7 @@ function header(sdkVersion) {
  * THIS FILE IS AUTO GENERATED, DO NOT EDIT THIS MANUALLY
  *
  * Generated by @softr/sdk@${sdkVersion}
- * This file can be regenerated by running \`npx @softr/sdk generate\`
+ * This file is regenerated automatically at the end of the turn
  */
 
 export {};`;

package/dist/core/workflow.js

@@ -1,31 +1,40 @@
 import { fetch } from "../fetch.js";
+import { panic } from "../assertions.js";
 import { sessionConfig } from "../auth/config.js";
 import { readSessionToken } from "../auth/session.js";
 import { platformApiUrl } from "../auth/platform.js";
 
 //#region src/core/workflow.ts
+function workflowsApiUrl() {
+	const url = process.env.SOFTR_WORKFLOWS_API_URL;
+	if (!url) panic("SOFTR_WORKFLOWS_API_URL is not set.");
+	return url.replace(/\/+$/, "");
+}
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function triggerWorkflow(action, payload) {
-	const baseUrl = `${await platformApiUrl()}/v1/vibe/applications/${sessionConfig().applicationId}/actions/${action.id}/workflow`;
-	const triggerRes = await fetch(baseUrl, {
+	const triggerRes = await fetch(`${await platformApiUrl()}/v1/vibe/applications/${sessionConfig().applicationId}/actions/${action.id}/workflow`, {
 		method: "POST",
 		headers: {
 			Authorization: `Bearer ${readSessionToken()}`,
 			"Content-Type": "application/json"
 		},
-		body: JSON.stringify(payload ?? {})
+		body: JSON.stringify({ input: payload ?? {} })
 	});
 	if (!triggerRes.ok) throw new Error(`Workflow trigger failed: ${triggerRes.status}`);
-	const execution = await triggerRes.json();
-	if (execution.status === "FINISHED") return;
-	if (execution.status === "PENDING_INTERACTION") throw new Error("Workflow requires interaction");
-	while (true) {
-		await sleep(2e3);
-		const detailsRes = await fetch(`${baseUrl}/${execution.id}`, { headers: { Authorization: `Bearer ${readSessionToken()}` } });
+	let details = await triggerRes.json();
+	while (details.status !== "FINISHED") {
+		if (details.status === "PENDING_INTERACTION") for (const interaction of details.nextInteractions) {
+			const interactionRes = await fetch(`${workflowsApiUrl()}/v1/interactive-actions/executions/${details.id}/actions/${interaction.id}`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: "{}"
+			});
+			if (!interactionRes.ok) throw new Error(`Workflow interaction failed: ${interactionRes.status}`);
+		}
+		await sleep(1e3);
+		const detailsRes = await fetch(`${workflowsApiUrl()}/v1/workflows/${action.resource.workflowId}/executions/${details.id}/details`);
 		if (!detailsRes.ok) throw new Error(`Workflow status check failed: ${detailsRes.status}`);
-		const details = await detailsRes.json();
-		if (details.status === "FINISHED") return;
-		if (details.status === "PENDING_INTERACTION") throw new Error("Workflow requires interaction");
+		details = await detailsRes.json();
 	}
 }
 const workflow = { trigger: triggerWorkflow };

package/dist/package.js

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

package/package.json

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

package/skills/softr-sdk/SKILL.md

@@ -11,7 +11,7 @@ description: >-
 metadata:
   type: core
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 # Softr SDK core

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

@@ -16,7 +16,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **Boundary.** `auth` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineVisibility`, the hooks and every type come from `@softr/sdk`. The app is already wired (`src/start.ts`, `src/router.tsx`, `src/routes/__root.tsx`); never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.

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.35
+  library_version: 0.0.37
 ---
 
 **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. The app is already wired (`src/start.ts`, `src/router.tsx`, `src/routes/__root.tsx`); never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.

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

@@ -10,7 +10,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **Boundary.** `useCurrentUser`, `usePermissions` and every type come from `@softr/sdk` and work anywhere; `ds` and `auth` live on `@softr/sdk/server` and run only inside a `createServerFn` handler. The app is already wired — `src/start.ts` registers `softrAuthMiddleware`, `src/routes/__root.tsx` publishes the visitor as route context — never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.
@@ -32,7 +32,7 @@ import type { User } from '@softr/sdk'
 type User = {
   id: string
   email: string
-  name: string
+  fullName: string
   userGroupIds: Array<SoftrUserGroupId>   // plain string unless you declare your ids
 }
 ```
@@ -67,17 +67,21 @@ A `guard()` in `beforeLoad` guarantees a visitor at runtime, but it does not cha
 
 ```ts
 import { createServerFn } from '@tanstack/react-start'
-
-// The datasource id from the table's registration on the application — not the table id.
-const INVOICES = '00000000-0000-0000-0000-000000000001'
+import { defineQuery } from '@softr/sdk'
+import { ds } from '@softr/sdk/server'
+
+const myInvoices = defineQuery({
+  id: 'myInvoices',
+  // The datasource id from the table's registration on the application — not the table id.
+  datasourceId: '00000000-0000-0000-0000-000000000001',
+  fields: { owner: 'Gq5wNt8rJy3Hb1', amount: 'Vk9cXm2pSz6Ld4' },
+  permissions: { userGroup: 'LOGGED_IN_USERS' },
+})
 
 const getMyInvoices = createServerFn().handler(async ({ context }) => {
   if (!context.user) throw new Error('Not signed in')
-
-  return await ds.list(INVOICES, {
-    select: q.select({ owner: 'Gq5wNt8rJy3Hb1', amount: 'Vk9cXm2pSz6Ld4' }),
-    where: q.text('owner').is(context.user.id),
-  })
+  const userId = context.user.id
+  return await ds.list(myInvoices).where((q) => q.owner.is(userId))
 })
 ```
 

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

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

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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **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. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.
@@ -28,14 +28,17 @@ import { integration } from '@softr/sdk/server'
 
 ## Reading connected integrations from the prompt
 
-When the user attaches integrations to the chat, they appear in the `## Attached data sources` section of the prompt in this form:
+When the user attaches integrations to the chat, they appear in the `## Attached integrations` section of the prompt in this form:
 
 ```
-- "Gmail" — database `<databaseId>`, integration `<integrationId>`, type `GMAIL`
+- integration `<integrationId>`, type `GMAIL`, database `<databaseId>` "Gmail"
+- integration `<integrationId>`, type `GMAIL`
 ```
 
 Pass the `integration` value as `integrationId` in `defineIntegration`. The `database` value is the table coordinate; integrations do not use it, so do not pass it anywhere. Use `integrationType` (e.g. `GMAIL`) to look up the base URL from the reference table below — then construct the full URL path, including any query parameters, directly in the `url` string.
 
+Either shape configures `defineIntegration`. An entry with no `database` coordinate carries the `integrationId`, which is all the call needs.
+
 ## Declare the integration action
 
 ```ts
@@ -93,7 +96,7 @@ Do not add an `Authorization` key to `headers` — Softr injects the integration
 
 ## Base URLs by integration type
 
-Match the `integrationType` from the attached data sources section to find the base URL:
+Match the `integrationType` from the attached integrations section to find the base URL:
 
 | integrationType | Base URL |
 |---|---|

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

@@ -11,7 +11,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **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. The app is already wired (`src/start.ts`, `src/router.tsx`, `src/routes/__root.tsx`); never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.

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

@@ -12,7 +12,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **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. The app is already wired (`src/start.ts`, `src/router.tsx`, `src/routes/__root.tsx`); never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.

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

@@ -12,7 +12,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **Boundary.** `defineVisibility`, the error predicates and every type come from `@softr/sdk` and work anywhere; `ds` and `auth` live on `@softr/sdk/server` and run only inside a `createServerFn` handler. The app is already wired — `src/start.ts` registers `softrAuthMiddleware`, `src/routes/__root.tsx` publishes the visitor as route context — never add a second registration. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.

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

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.35
+  library_version: 0.0.37
 ---
 
 **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. Load the core `softr-sdk` skill only if you are unsure this is the right sub-skill.