@adobe/data-lit 0.9.87 → 0.9.89

package/dist/elements/database-element.d.ts

@@ -6,12 +6,14 @@ export declare abstract class DatabaseElement<P extends Database.Plugin> extends
     /**
      * The element's database surface.
      *  - SET to inject the full database (DI).
-     *  - GET returns the UI-restricted view (every mutator rewritten to
-     *    fire-and-forget `void`).
+     *  - GET returns the UI-restricted view: every mutator rewritten to
+     *    fire-and-forget `void`, and every transaction shadowed by a same-named
+     *    action masked out so the UI calls the action instead (see
+     *    {@link UIService.FromDatabase}).
      * Divergent get/set types are intentional: inject full, consume restricted.
      */
     set service(db: Database.Plugin.ToDatabase<P>);
-    get service(): UIService.FromService<Database.Plugin.ToDatabase<P>>;
+    get service(): UIService.FromDatabase<Database.Plugin.ToDatabase<P>>;
     /**
      * The full, unrestricted database — for imperative-rendering subclasses
      * (a canvas / WebGL draw loop that reads columns synchronously each frame,

package/dist/elements/database-element.js

@@ -11,8 +11,10 @@ export class DatabaseElement extends LitElement {
     /**
      * The element's database surface.
      *  - SET to inject the full database (DI).
-     *  - GET returns the UI-restricted view (every mutator rewritten to
-     *    fire-and-forget `void`).
+     *  - GET returns the UI-restricted view: every mutator rewritten to
+     *    fire-and-forget `void`, and every transaction shadowed by a same-named
+     *    action masked out so the UI calls the action instead (see
+     *    {@link UIService.FromDatabase}).
      * Divergent get/set types are intentional: inject full, consume restricted.
      */
     set service(db) {

package/dist/elements/database-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"database-element.js","sourceRoot":"","sources":["../../src/elements/database-element.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAgB,eAA2C,SAAQ,UAAU;IAEjF;+EAC2E;IAC3E,SAAS,CAAiC;IAE1C;;;;;;OAMG;IACH,IAAI,OAAO,CAAC,EAAiC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAc,QAAQ;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QACR,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAID,iBAAiB;QACf,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,uBAAuB;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;YAAE,OAAO;QACnE,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,IAAI,GAAG,IAA8D,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IAES,mBAAmB;QAC3B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAgC,CAAC;YACrD,IAAI,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC3C,CAAC;IACH,CAAC;IAEe,MAAM;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CAEF"}
+{"version":3,"file":"database-element.js","sourceRoot":"","sources":["../../src/elements/database-element.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAgB,eAA2C,SAAQ,UAAU;IAEjF;+EAC2E;IAC3E,SAAS,CAAiC;IAE1C;;;;;;;;OAQG;IACH,IAAI,OAAO,CAAC,EAAiC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAc,QAAQ;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QACR,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAID,iBAAiB;QACf,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,uBAAuB;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;YAAE,OAAO;QACnE,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,IAAI,GAAG,IAA8D,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IAES,mBAAmB;QAC3B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAgC,CAAC;YACrD,IAAI,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC3C,CAAC;IACH,CAAC;IAEe,MAAM;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CAEF"}

package/dist/elements/database-element.type-test.js

@@ -22,6 +22,18 @@ const plugin = Database.Plugin.create({
         setCount: (t, input) => {
             t.resources.count = input.value;
         },
+        // A raw commit that the `save` action below wraps.
+        save: (t) => {
+            t.resources.count = t.resources.count;
+        },
+    },
+    actions: {
+        // The `save` action shadows the `save` transaction: it wraps the raw
+        // transaction with async work, so the UI must call the action. The
+        // restricted view masks `transactions.save` out entirely.
+        save: async (db) => {
+            db.transactions.save();
+        },
     },
 });
 class _CountElement extends DatabaseElement {

package/dist/elements/database-element.type-test.js.map

@@ -1 +1 @@
-{"version":3,"file":"database-element.type-test.js","sourceRoot":"","sources":["../../src/elements/database-element.type-test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;;;;GAQG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE;QACT,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;KAChC;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAiC,EAAE,EAAE;YACjD,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,aAAc,SAAQ,eAA8B;IACxD,IAAI,MAAM;QACR,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAKD,iFAAiF;AACjF,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,CAAC,EAAiB,EAAE,EAAe,EAAQ,EAAE;IACvE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAClB,CAAC,CAAC;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC9D,+EAA+E;IAC/E,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,gFAAgF;AAChF,0EAA0E;AAC1E,MAAM,yBAAyB,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC5D,4EAA4E;IAC5E,KAAK,EAAE,CAAC,QAAQ,CAAC;AACnB,CAAC,CAAC;AA8CF,MAAM,iBAAiB,GACrB,IAA0D,CAAC;AAC7D,iFAAiF;AACjF,MAAM,eAAe,GACnB,IAA0D,CAAC"}
+{"version":3,"file":"database-element.type-test.js","sourceRoot":"","sources":["../../src/elements/database-element.type-test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;;;;GAQG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE;QACT,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;KAChC;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAiC,EAAE,EAAE;YACjD,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,CAAC;QACD,mDAAmD;QACnD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;YACV,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QACxC,CAAC;KACF;IACD,OAAO,EAAE;QACP,qEAAqE;QACrE,mEAAmE;QACnE,0DAA0D;QAC1D,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,aAAc,SAAQ,eAA8B;IACxD,IAAI,MAAM;QACR,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAKD,iFAAiF;AACjF,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,CAAC,EAAiB,EAAE,EAAe,EAAQ,EAAE;IACvE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAClB,CAAC,CAAC;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC9D,+EAA+E;IAC/E,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,gFAAgF;AAChF,0EAA0E;AAC1E,MAAM,yBAAyB,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC5D,4EAA4E;IAC5E,KAAK,EAAE,CAAC,QAAQ,CAAC;AACnB,CAAC,CAAC;AA+CF,MAAM,iBAAiB,GACrB,IAA0D,CAAC;AAC7D,iFAAiF;AACjF,MAAM,eAAe,GACnB,IAA0D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.9.87",
+  "version": "0.9.89",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@adobe/data": "0.9.87"
+    "@adobe/data": "0.9.89"
   },
   "peerDependencies": {
     "lit": "^3.3.1"

package/src/elements/database-element.ts

@@ -15,8 +15,10 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
   /**
    * The element's database surface.
    *  - SET to inject the full database (DI).
-   *  - GET returns the UI-restricted view (every mutator rewritten to
-   *    fire-and-forget `void`).
+   *  - GET returns the UI-restricted view: every mutator rewritten to
+   *    fire-and-forget `void`, and every transaction shadowed by a same-named
+   *    action masked out so the UI calls the action instead (see
+   *    {@link UIService.FromDatabase}).
    * Divergent get/set types are intentional: inject full, consume restricted.
    */
   set service(db: Database.Plugin.ToDatabase<P>) {
@@ -24,7 +26,7 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
     this.#database = db;
     this.requestUpdate('service', old);
   }
-  get service(): UIService.FromService<Database.Plugin.ToDatabase<P>> {
+  get service(): UIService.FromDatabase<Database.Plugin.ToDatabase<P>> {
     return UIService.restrict(this.#database);
   }
 

package/src/elements/database-element.type-test.ts

@@ -29,6 +29,18 @@ const plugin = Database.Plugin.create({
     setCount: (t, input: { readonly value: number }) => {
       t.resources.count = input.value;
     },
+    // A raw commit that the `save` action below wraps.
+    save: (t) => {
+      t.resources.count = t.resources.count;
+    },
+  },
+  actions: {
+    // The `save` action shadows the `save` transaction: it wraps the raw
+    // transaction with async work, so the UI must call the action. The
+    // restricted view masks `transactions.save` out entirely.
+    save: async (db) => {
+      db.transactions.save();
+    },
   },
 });
 
@@ -62,8 +74,9 @@ const _noPublicDatabaseProperty = (el: _CountElement): void => {
 };
 type _CheckNoDatabaseKey = Assert<Equal<Extract<keyof _CountElement, "database">, never>>;
 
-// 1. The exposed service type is the UIService-restricted view of the database.
-type _CheckRestricted = Assert<Equal<ServiceType, UIService.FromService<RawDatabase>>>;
+// 1. The exposed service type is the database-restricted UI view (FromService
+//    plus action masking).
+type _CheckRestricted = Assert<Equal<ServiceType, UIService.FromDatabase<RawDatabase>>>;
 
 // 2. Observe surfaces survive the restriction.
 type _CheckResourceObserveSurvives = Assert<
@@ -114,6 +127,26 @@ type _CheckSetCountAsyncVoid = Assert<
   Equal<ReturnType<ServiceType["transactions"]["setCount"]>, void>
 >;
 
+// 8. Action masking: a transaction shadowed by a same-named action is removed
+//    from the restricted `transactions`, so the UI can only reach it through
+//    the action. Unshadowed transactions are untouched, and the raw database
+//    still exposes the transaction (masking is a UI-view concern only).
+type _CheckSaveTransactionMasked = Assert<
+  Equal<Extract<keyof ServiceType["transactions"], "save">, never>
+>;
+type _CheckSaveTransactionStillRaw = Assert<
+  Equal<Extract<keyof RawDatabase["transactions"], "save">, "save">
+>;
+type _CheckSaveActionSurvivesAsVoid = Assert<
+  Equal<ReturnType<ServiceType["actions"]["save"]>, void>
+>;
+type _CheckIncrementNotMasked = Assert<
+  Equal<Extract<keyof ServiceType["transactions"], "increment">, "increment">
+>;
+type _CheckSetCountNotMasked = Assert<
+  Equal<Extract<keyof ServiceType["transactions"], "setCount">, "setCount">
+>;
+
 // ----------------------------------------------------------------------------
 // Local helpers (kept inline so this file stays a self-contained type test).
 // ----------------------------------------------------------------------------