@frontera-sdk/blueprint 1.53.8 → 1.53.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/blueprint",
-  "version": "1.53.8",
+  "version": "1.53.10",
   "description": "React hooks for reading Blueprint data and invoking governed Actions from inside a Frontera app.",
   "keywords": [
     "frontera",
@@ -56,7 +56,7 @@
     "smoke": "bun run scripts/smoke.ts"
   },
   "dependencies": {
-    "@frontera-sdk/core": "1.53.8"
+    "@frontera-sdk/core": "1.53.10"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.90.21",

package/src/action-types.ts

@@ -238,15 +238,15 @@ export interface ActionDescriptor {
  * - `not_deployed`: published, but no deployment runs it here (never
  *   deployed, or switched off).
  * - `no_workspace_grant`: this workspace holds no Blueprint grant on the
- *   Action's object type.
+ *   Action's object type, or on a type it writes records of.
  * - `not_a_person`: the caller acts as a key, which belongs to no member.
  * - `not_a_member`: the person is not a member of this workspace.
  * - `business_user`: a Business user holds no governed authority here.
  * - `role_cannot_submit`: the person's role may not submit Action requests.
  * - `capability_not_granted`: the role does not hold the Action's invoke capability.
  * - `agent_not_active`, `agent_no_grant`: for an Agent caller.
- * - `agent_cannot_act`: the Agent may read the Action's object type, but its
- *   grant there has no `act`, so it submits no Action on it.
+ * - `agent_cannot_act`: the Agent may read the Action's object type, or a
+ *   type it writes records of, but its grant there has no `act`.
  * - `refused`: refused for a reason not listed.
  * - `unknown`: the platform did not say (the caller may not ask, such as a
  *   person signed in to an externally hosted App, or a platform that
@@ -415,6 +415,16 @@ export interface ActionRequest {
   apiName?: string
   lifecycle: ActionRequestLifecycle
   effectCertainty?: ActionEffectCertainty
+  /**
+   * The records the request names beside its subject, in the order the
+   * Action declares them: records it creates and records it changes or
+   * deletes. A record the request sets nothing on, because every input that
+   * sets it is left out, is listed but not written. Absent when the Action
+   * writes its subject only, and from a platform that predates the field.
+   * Read it to refresh what the request touched once `actionEffectOf` reads
+   * `applied`.
+   */
+  records?: Array<{ objectTypeId: string; objectId: string }>
   createdAt?: string
   updatedAt?: string
   /**
@@ -594,6 +604,10 @@ export interface SubmitActionInput {
    * Parameter values, keyed by the Action's parameter API names. Leave out
    * the key input and `expectedVersion`: they are filled from `objectId` and
    * `expectedVersion` (see those).
+   *
+   * An optional parameter with no default takes `null`, which empties the
+   * property it sets; leaving it out keeps the property as it is. `undefined`
+   * is leaving it out (JSON drops it), so clear a field with `null`.
    */
   input: Record<string, unknown>
   /**