@colixsystems/widget-sdk 0.285.0 → 0.286.0

package/README.md

@@ -89,7 +89,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.285.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.286.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.286.0 (contract 1.234.0)
+
+**Action scripts only: `previous` and `changedFields`.** `CONTRACT.actionScriptGlobals` lists the two new runner globals a `record_updated` Action script reads: the row before the edit and the columns whose value changed. Nothing changes for widget authors.
 
 ### What's new in 0.285.0 (contract 1.233.0)
 

package/dist/contract.cjs

@@ -3945,6 +3945,9 @@ const ACTION_SCRIPT_GLOBALS = [
   "directory",
   "console",
   "record",
+  // sc-15609 — on record_updated, the row before the edit and what changed.
+  "previous",
+  "changedFields",
   // sc-5366 — `{ body }` on a run fired by the inbound `http_post` trigger,
   // null on every other trigger.
   "request",
@@ -6719,7 +6722,9 @@ const CONTRACT = deepFreeze({
   //    "Rows per page" property.
   // 1.233.0: additive (sc-8115) — a `datastoreTemplate` table may declare
   //    `deleteWhenLastMemberLeaves: true`.
-  version: "1.233.0",
+  // 1.234.0: additive (sc-15609) — ACTION_SCRIPT_GLOBALS gains `previous` and
+  //    `changedFields`; no widget hook, primitive or manifest field changed.
+  version: "1.234.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -3941,6 +3941,9 @@ const ACTION_SCRIPT_GLOBALS = [
   "directory",
   "console",
   "record",
+  // sc-15609 — on record_updated, the row before the edit and what changed.
+  "previous",
+  "changedFields",
   // sc-5366 — `{ body }` on a run fired by the inbound `http_post` trigger,
   // null on every other trigger.
   "request",
@@ -6715,7 +6718,9 @@ const CONTRACT = deepFreeze({
   //    "Rows per page" property.
   // 1.233.0: additive (sc-8115) — a `datastoreTemplate` table may declare
   //    `deleteWhenLastMemberLeaves: true`.
-  version: "1.233.0",
+  // 1.234.0: additive (sc-15609) — ACTION_SCRIPT_GLOBALS gains `previous` and
+  //    `changedFields`; no widget hook, primitive or manifest field changed.
+  version: "1.234.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/navigation.cjs

@@ -3,6 +3,7 @@
 "use strict";
 
 const { CONTRACT, isHexColor, contrastRatio, mixHex, readableTextColor } = require("./contract.cjs");
+const { isPlainObject } = require("./plain-object.cjs");
 
 // REQ-NAV-STRUCTURE — the host side of an app's navigation SHAPE and the
 // tokens its footer strip is painted with.
@@ -27,10 +28,6 @@ const { CONTRACT, isHexColor, contrastRatio, mixHex, readableTextColor } = requi
 // existed renders and compiles byte-identically.
 const DEFAULT_MENU_TYPE = "sidebar";
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 /**
  * Resolve a `theme_config.navigation` block to the shape both hosts read.
  *

package/dist/navigation.js

@@ -17,15 +17,12 @@
 // diverge.
 
 import { CONTRACT, isHexColor, contrastRatio, mixHex, readableTextColor } from "./contract.js";
+import { isPlainObject } from "./plain-object.js";
 
 // Absent or unknown resolves here, so every app authored before menu types
 // existed renders and compiles byte-identically.
 const DEFAULT_MENU_TYPE = "sidebar";
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 /**
  * Resolve a `theme_config.navigation` block to the shape both hosts read.
  *

package/dist/plain-object.cjs

@@ -0,0 +1,11 @@
+// GENERATED from plain-object.js by scripts/generate-cjs.js — DO NOT EDIT.
+// Change plain-object.js, then run `npm run generate:cjs` in packages/widget-sdk.
+"use strict";
+
+/** Any non-null, non-array object — a Date, Map or class instance passes. */
+function isPlainObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+module.exports = {
+  isPlainObject,
+};

package/dist/plain-object.js

@@ -0,0 +1,4 @@
+/** Any non-null, non-array object — a Date, Map or class instance passes. */
+export function isPlainObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/property-schema.js

@@ -3,6 +3,7 @@
 
 import { CORNER_RADIUS_KEYS } from "./corner-radius.js";
 import { SPACING_KEYS } from "./spacing.js";
+import { isPlainObject } from "./plain-object.js";
 
 const VALID_TYPES = new Set([
   "string", "number", "boolean",
@@ -85,10 +86,6 @@ const VALID_TYPES = new Set([
 /** The propertySchema field types, for documentation generated from this list. */
 export const PROPERTY_TYPES = Object.freeze([...VALID_TYPES]);
 
-function isPlainObject(v) {
-  return v !== null && typeof v === "object" && !Array.isArray(v);
-}
-
 function validateDef(def, path, errors) {
   if (!isPlainObject(def)) {
     errors.push(`${path}: must be an object`);

package/dist/signing-state.js

@@ -2,6 +2,8 @@
 // a sign order's state, what a refusal says, and how an overview is indexed.
 // Kept apart from hooks.js so it runs under plain `node --test`.
 
+import { isPlainObject } from "./plain-object.js";
+
 /** The server reads at most this many file ids per overview call. */
 export const OVERVIEW_IDS_PER_CALL = 200;
 
@@ -83,12 +85,11 @@ export function readRefusalDetail(err) {
 }
 
 const nonEmptyString = (value) => typeof value === "string" && value.trim() !== "";
-const isObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 
 /** One prepare entry as the filestore client takes it, or null when it is neither form. */
 function signerForPrepare(signer) {
   if (nonEmptyString(signer)) return signer;
-  if (!isObject(signer)) return null;
+  if (!isPlainObject(signer)) return null;
   const keys = Object.keys(signer).sort().join(",");
   if (keys === "app_user_id" && nonEmptyString(signer.app_user_id)) return signer.app_user_id;
   if (keys === "email,name" && nonEmptyString(signer.name) && nonEmptyString(signer.email)) {
@@ -111,7 +112,7 @@ export function signerListForPrepare(signers) {
 
 /** The body of a new link: a corrected `email` when one is given, otherwise nothing. */
 export function resendLinkOptions(options) {
-  const email = isObject(options) && typeof options.email === "string" ? options.email.trim() : "";
+  const email = isPlainObject(options) && typeof options.email === "string" ? options.email.trim() : "";
   return email ? { email } : {};
 }
 

package/dist/theme-appearance.cjs

@@ -3,6 +3,7 @@
 "use strict";
 
 const { isHexColor, APPEARANCE_PREFERENCES } = require("./contract.cjs");
+const { isPlainObject } = require("./plain-object.cjs");
 
 // APPEARANCE_PREFERENCES: what an app opens on and a user may choose.
 
@@ -21,10 +22,6 @@ const APPEARANCE_THEME_KEYS = ["dark", "appearance"];
 /** The two palettes an app can render. */
 const APPEARANCE_MODES = Object.freeze(["light", "dark"]);
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 // A gradient is one colour value: its angle and type travel with its stops.
 function isGradient(value) {
   return isPlainObject(value) && isHexColor(value.from) && isHexColor(value.to);

package/dist/theme-appearance.js

@@ -1,5 +1,6 @@
 // APPEARANCE_PREFERENCES: what an app opens on and a user may choose.
 import { isHexColor, APPEARANCE_PREFERENCES } from "./contract.js";
+import { isPlainObject } from "./plain-object.js";
 
 export { APPEARANCE_PREFERENCES };
 
@@ -17,10 +18,6 @@ const APPEARANCE_THEME_KEYS = ["dark", "appearance"];
 /** The two palettes an app can render. */
 export const APPEARANCE_MODES = Object.freeze(["light", "dark"]);
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 // A gradient is one colour value: its angle and type travel with its stops.
 function isGradient(value) {
   return isPlainObject(value) && isHexColor(value.from) && isHexColor(value.to);

package/dist/theme-components.cjs

@@ -3,6 +3,7 @@
 "use strict";
 
 const { CONTRACT, normaliseComponentGradient } = require("./contract.cjs");
+const { isPlainObject } = require("./plain-object.cjs");
 
 // REQ-THEME-15 (sc-1497) — the host side of per-component style tokens.
 //
@@ -26,10 +27,6 @@ const { CONTRACT, normaliseComponentGradient } = require("./contract.cjs");
 // must never drop a colour the runner already accepted.
 const HEX_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 function coerceToken(def, value) {
   if (def.type === "color") {
     if (typeof value !== "string") return undefined;

package/dist/theme-components.js

@@ -16,15 +16,12 @@
 // literal, so what a planner may emit and what a host applies cannot diverge.
 
 import { CONTRACT, normaliseComponentGradient } from "./contract.js";
+import { isPlainObject } from "./plain-object.js";
 
 // 3-, 6- and 8-digit hex, matching what the build runner persists — the host
 // must never drop a colour the runner already accepted.
 const HEX_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 function coerceToken(def, value) {
   if (def.type === "color") {
     if (typeof value !== "string") return undefined;

package/dist/theme-token-refs.js

@@ -23,6 +23,7 @@ import {
   withHexAlpha,
   THEME_TOKEN_REF_PREFIX,
 } from "./contract.js";
+import { isPlainObject } from "./plain-object.js";
 
 // A value is a binding, not a colour, when it carries this prefix. No CSS
 // colour can begin with it, so a stored literal can never be misread as one.
@@ -67,10 +68,6 @@ export function resolveThemeTokenRef(value, theme) {
   return ref.alpha === null ? resolved : withHexAlpha(resolved, ref.alpha);
 }
 
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 // The same guard the neighbouring style validators apply: these props are
 // author-stored JSON, and assigning such a key while rebuilding an object would
 // silently reseat its prototype instead of carrying the value.

package/package.json

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

package/src/contract.js

@@ -3941,6 +3941,9 @@ const ACTION_SCRIPT_GLOBALS = [
   "directory",
   "console",
   "record",
+  // sc-15609 — on record_updated, the row before the edit and what changed.
+  "previous",
+  "changedFields",
   // sc-5366 — `{ body }` on a run fired by the inbound `http_post` trigger,
   // null on every other trigger.
   "request",
@@ -6715,7 +6718,9 @@ const CONTRACT = deepFreeze({
   //    "Rows per page" property.
   // 1.233.0: additive (sc-8115) — a `datastoreTemplate` table may declare
   //    `deleteWhenLastMemberLeaves: true`.
-  version: "1.233.0",
+  // 1.234.0: additive (sc-15609) — ACTION_SCRIPT_GLOBALS gains `previous` and
+  //    `changedFields`; no widget hook, primitive or manifest field changed.
+  version: "1.234.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,