@colixsystems/widget-sdk 0.169.0 → 0.170.0

package/README.md

@@ -73,7 +73,20 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.169.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.170.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.170.0 (contract 1.131.0)
+
+**An action script receives the parameters a Run action event sent — `input` joins `CONTRACT.actionScriptGlobals` (sc-9031).** A button or widget event bound to "Run action" could start an Action but could not tell it anything, so authors wrote the value into a row and switched to a record trigger. The binding now carries `params`, and a widget event's payload is forwarded with them:
+
+```js
+if (!input || typeof input.client_id !== "string") return;
+await connectors.call("crm", { path: `/clients/${encodeURIComponent(input.client_id)}/sync`, method: "POST" });
+```
+
+- **Deep-frozen, null elsewhere.** `input` is `null` on `schedule`, `record_*`, `manual` and `http_post` runs, so `if (input)` is the guard.
+- **Untrusted.** It comes from the app user's device; validate it. The run still executes as the Action's bound integration identity.
+- **Widget side unchanged.** A widget passes data with the emitter it already has: `useWidgetEvent("slotChosen")({ slot })`. The author binds that event to Run action.
 
 ### What's new in 0.169.0 (contract 1.130.0)
 

package/dist/contract.cjs

@@ -2451,6 +2451,8 @@ const ACTION_SCRIPT_GLOBALS = [
   "triggerTableId",
   // sc-7885 — who initiated the run; null on `schedule` / `record_*`.
   "triggeredBy",
+  // sc-9031 — a Run action event's parameters; null on every other trigger.
+  "input",
 ];
 // Mirrors action.service.js SCRIPT_MAX_BYTES.
 const ACTION_SCRIPT_MAX_BYTES = 200 * 1024;
@@ -4607,7 +4609,11 @@ const CONTRACT = deepFreeze({
   // `useFilestoreCopy`. Widgets can now create Filestore folders and copy a
   // file into another folder or space (project / public / personal); the
   // filestore client gains `files.copy`.
-  version: "1.130.0",
+  // 1.131.0: additive (sc-9031) — `input` joins `actionScriptGlobals`: the
+  //    parameters a Run action event sent (the binding's `params` merged over
+  //    the emitting widget's payload), deep-frozen, null on every non-`app`
+  //    trigger. Additive: a script that never reads it runs unchanged.
+  version: "1.131.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -2447,6 +2447,8 @@ const ACTION_SCRIPT_GLOBALS = [
   "triggerTableId",
   // sc-7885 — who initiated the run; null on `schedule` / `record_*`.
   "triggeredBy",
+  // sc-9031 — a Run action event's parameters; null on every other trigger.
+  "input",
 ];
 // Mirrors action.service.js SCRIPT_MAX_BYTES.
 const ACTION_SCRIPT_MAX_BYTES = 200 * 1024;
@@ -4603,7 +4605,11 @@ const CONTRACT = deepFreeze({
   // `useFilestoreCopy`. Widgets can now create Filestore folders and copy a
   // file into another folder or space (project / public / personal); the
   // filestore client gains `files.copy`.
-  version: "1.130.0",
+  // 1.131.0: additive (sc-9031) — `input` joins `actionScriptGlobals`: the
+  //    parameters a Run action event sent (the binding's `params` merged over
+  //    the emitting widget's payload), deep-frozen, null on every non-`app`
+  //    trigger. Additive: a script that never reads it runs unchanged.
+  version: "1.131.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.169.0",
+  "version": "0.170.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",