@colixsystems/widget-sdk 0.181.0 → 0.182.0

package/README.md

@@ -74,7 +74,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.181.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.182.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.182.0 (contract 1.143.0)
+
+**A `datastoreTemplate` relation decides what happens when the row it points at is deleted.** A `ONE_TO_ONE` / `ONE_TO_MANY` RELATION column may declare `onDelete`. With `"SET_NULL"`, the default, the row is kept and its reference is emptied. With `"CASCADE"`, the row is deleted along with the row it points at, and anything that cascades from it is deleted in turn. A `MANY_TO_MANY` column takes no `onDelete`: deleting a row on either side only removes its links. The platform applies the rule on every delete, so a widget that deletes a parent row never has to delete or clear its children itself. Use `CASCADE` for rows that mean nothing without their parent (order lines, a post's comments). Additive: a template without it gets `SET_NULL`.
 
 ### What's new in 0.181.0 (contract 1.142.0)
 

package/dist/contract.cjs

@@ -4780,7 +4780,9 @@ const CONTRACT = deepFreeze({
   //    `app_user_id` and `status: "open"`, and each invite row carries
   //    `app_user_id`: the id the invitee's user account will have once they
   //    accept.
-  version: "1.142.0",
+  // 1.143.0: additive (sc-9756) — a datastoreTemplate RELATION column may
+  //    declare `onDelete` ("CASCADE" | "SET_NULL") for ONE_TO_ONE/ONE_TO_MANY.
+  version: "1.143.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -4776,7 +4776,9 @@ const CONTRACT = deepFreeze({
   //    `app_user_id` and `status: "open"`, and each invite row carries
   //    `app_user_id`: the id the invitee's user account will have once they
   //    accept.
-  version: "1.142.0",
+  // 1.143.0: additive (sc-9756) — a datastoreTemplate RELATION column may
+  //    declare `onDelete` ("CASCADE" | "SET_NULL") for ONE_TO_ONE/ONE_TO_MANY.
+  version: "1.143.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/index.d.ts

@@ -187,6 +187,12 @@ export interface WidgetDatastoreTemplateColumn {
   relationType?: "ONE_TO_ONE" | "ONE_TO_MANY" | "MANY_TO_MANY";
   /** REQ-ACL-RELINHERIT: opt this RELATION column into row-level ACL inheritance. */
   inheritAcl?: boolean;
+  /**
+   * ONE_TO_ONE / ONE_TO_MANY only: what deleting the referenced row does to
+   * this table's rows. `CASCADE` deletes them too; `SET_NULL` (the default)
+   * empties the reference. A MANY_TO_MANY link is always removed.
+   */
+  onDelete?: "CASCADE" | "SET_NULL";
   /**
    * REQ-DDL-ENCRYPT: store this column's values encrypted at rest (AES-256-GCM
    * under a per-workspace subkey). The widget still reads and writes plaintext

package/package.json

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