@kehto/paja 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { NostrEvent } from 'nostr-tools';
 import { Filter } from 'nostr-tools/filter';
 import { ResolvedNapplet } from '@kehto/nip/5d';
 import { ShellCapabilities } from '@kehto/shell';
-import { IntentCatalogEntry, IntentTargetController, IntentRetentionParams, IntentRetainedDelivery } from '@kehto/services';
+import { IntentCatalogEntry, IntentTargetController, IntentDispatchParams, IntentTargetDispatch } from '@kehto/services';
 
 /**
  * Load a JSON Paja config file from disk.
@@ -138,7 +138,7 @@ declare function injectPajaRuntimeCsp(html: string, origins: readonly string[]):
 
 declare const PAJA_LEGACY_COMPATIBILITY_DOMAIN: string;
 /** Domain list mirrored from the upstream web runtime for parity checks. */
-declare const PAJA_UPSTREAM_WEB_DOMAINS: readonly ["ble", "common", "config", "count", "cvm", "dm", "identity", string, "inc", "intent", "keys", "link", "lists", "media", "notify", "outbox", "relay", "resource", "serial", "storage", "theme", "upload", "webrtc"];
+declare const PAJA_UPSTREAM_WEB_DOMAINS: readonly ["ble", "common", "config", "count", "cvm", "dm", "fs", "identity", string, "inc", "intent", "keys", "link", "lists", "media", "notify", "outbox", "relay", "resource", "serial", "storage", "theme", "upload", "webrtc"];
 /** Domains required during the initial Paja handshake. */
 declare const PAJA_HANDSHAKE_DOMAINS: readonly ["shell"];
 /** Compatibility aliases for renamed upstream capability domains. */
@@ -184,11 +184,12 @@ interface InstalledNappletRecord {
     readonly pointer: PajaDecodedPointer;
     /** Optional manifest title for handler selection UI. */
     readonly title?: string;
+    /** Verified NAP domains required by the artifact. */
+    readonly requires: readonly string[];
     /** Exact manifest convention contracts used for intent eligibility. */
     readonly archetypes: readonly {
         readonly slug: string;
         readonly convention: string;
-        readonly eventKinds?: readonly number[];
     }[];
 }
 /** Listener notified when an installed artifact is inserted or removed. */
@@ -230,12 +231,12 @@ declare class InstalledNappletCatalog {
 }
 
 /**
- * Browser-owned retained NAP-INTENT target lifecycle policy.
+ * Browser-owned NAP-INTENT target lifecycle policy.
  *
  * Retention is intentionally independent from browser frames. The host supplies
  * generation creation/reuse, source-bound readiness, current-generation checks,
- * and delivery. This controller freezes responsibility before an accepted
- * result, then starts that policy only afterward.
+ * and convention delivery. The controller resolves only after the target is
+ * ready and the delivery is enqueued.
  *
  * @packageDocumentation
  */
@@ -250,31 +251,28 @@ type BrowserIntentTerminalReason = 'open-failed' | 'ready-failed' | 'no-current-
 /** Browser lifecycle callbacks injected by the Paja host. */
 interface BrowserIntentControllerOptions {
     /** Open a compatible target or reuse its current generation. */
-    openOrReuse(params: IntentRetentionParams, attempt: number): BrowserIntentGeneration | null | Promise<BrowserIntentGeneration | null>;
+    openOrReuse(params: IntentDispatchParams, attempt: number): BrowserIntentGeneration | null | Promise<BrowserIntentGeneration | null>;
     /** Await source-bound NAP-SHELL readiness for a selected generation. */
     waitForReady(generation: BrowserIntentGeneration): void | Promise<void>;
     /** Return true only while the generation remains the selected current target. */
     isCurrent(generation: BrowserIntentGeneration): boolean | Promise<boolean>;
-    /** Send the retained delivery to the current ready generation exactly once. */
-    send(generation: BrowserIntentGeneration, delivery: IntentRetentionParams['delivery']): void | Promise<void>;
-    /** Maximum open/replacement attempts after acceptance. Finite values clamp to 1–10; defaults to two. */
+    /** Return the runtime-assigned window identifier once the target is ready. */
+    getWindowId(generation: BrowserIntentGeneration): string | null;
+    /** Send the convention through the ordinary carrier to the ready generation. */
+    send(generation: BrowserIntentGeneration, params: IntentDispatchParams): void | Promise<void>;
+    /** Maximum open/replacement attempts. Finite values clamp to 1–10; defaults to two. */
     maxAttempts?: number;
-    /** Observe terminal post-acceptance policy without producing another result. */
-    onTerminal?(params: IntentRetentionParams, reason: BrowserIntentTerminalReason): void;
+    /** Observe terminal target policy. */
+    onTerminal?(params: IntentDispatchParams, reason: BrowserIntentTerminalReason): void;
 }
 /**
- * Retains immutable delivery responsibility before the intent service accepts.
- *
- * It has no public lifecycle state: host callbacks own generation identity,
- * readiness, reuse, and replacement. A returned task is inert until its
- * `start()` method is invoked by the intent service after sending acceptance.
+ * Creates/focuses a target and enqueues one convention delivery.
  */
 declare class BrowserIntentController implements IntentTargetController {
     private readonly options;
     private readonly maxAttempts;
     constructor(options: BrowserIntentControllerOptions);
-    retain(params: IntentRetentionParams): IntentRetainedDelivery;
-    private start;
+    dispatch(params: IntentDispatchParams): Promise<IntentTargetDispatch>;
 }
 
 /**

package/dist/index.js

@@ -39,7 +39,7 @@ import {
   startPajaServer,
   summarizePajaSimulation,
   waitForTargetUrl
-} from "./chunk-OWVINAW7.js";
+} from "./chunk-EOCGC7A2.js";
 export {
   BrowserIntentController,
   DEFAULT_PAJA_AGGREGATE_HASH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kehto/paja",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Paja local authoring workshop for hosting napplets in a real Kehto iframe during development",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,22 +25,22 @@
     "access": "public"
   },
   "dependencies": {
-    "@kehto/acl": "^0.16.0",
-    "@kehto/firewall": "^0.4.0",
-    "@kehto/nip": "^0.4.2",
-    "@kehto/runtime": "^0.19.0",
-    "@kehto/services": "^0.17.0",
-    "@kehto/shell": "^0.18.0",
+    "@kehto/acl": "^0.17.0",
+    "@kehto/firewall": "^0.5.0",
+    "@kehto/nip": "^0.5.1",
+    "@kehto/runtime": "^0.21.0",
+    "@kehto/services": "^0.19.0",
+    "@kehto/shell": "^0.19.2",
     "@kehto/wm": "^0.0.2"
   },
   "peerDependencies": {
-    "@napplet/core": ">=0.29.0 <0.30.0",
-    "@napplet/nap": ">=0.29.0 <0.30.0",
+    "@napplet/core": ">=0.31.0 <0.32.0",
+    "@napplet/nap": ">=0.31.0 <0.32.0",
     "nostr-tools": ">=2.23.3 <=2.x"
   },
   "devDependencies": {
-    "@napplet/core": ">=0.29.0 <0.30.0",
-    "@napplet/nap": ">=0.29.0 <0.30.0",
+    "@napplet/core": ">=0.31.0 <0.32.0",
+    "@napplet/nap": ">=0.31.0 <0.32.0",
     "nostr-tools": "^2.23.3",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",