@kehto/paja 0.34.0 → 0.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -74,14 +74,27 @@ runtime ACL controls, Firewall permissions, signer controls, and a filterable me
74
74
  error details. It starts expanded and collapses to the left with the chevron
75
75
  button in the top bar; the same button brings the whole panel back. The toolbar
76
76
  stays onscreen after restoring a saved collapsed preference, including when no
77
- runtime tab is open. Collapsing
77
+ runtime tab is open. Paja allows every interface and operation by default and asks before each `link.open`; the Firewall panel edits those default rules for every napplet or one. Firewall approval prompts stay visible outside the sidebar, so new napplets can
78
+ still receive consent before executing. Grant management stays in the sidebar.
79
+ Collapsing
78
80
  is presentation-only — the target iframe keeps its identity and the loaded
79
81
  napplet keeps running — and Paja remembers the choice per browser origin. In
80
82
  runtime-pointer mode, ACL controls always display and mutate
81
83
  the active tab's resolver-verified d-tag and aggregate hash; a grant or revoke
82
- rerenders that same identity immediately. Paja auto-connects a browser NIP-07 signer when `window.nostr` is
83
- available, can connect to a bunker/NIP-46 URI, and only uses the generated local
84
- development signer when the Dev signer button is selected. Sign, publish, DM
84
+ rerenders that same identity immediately. Paja starts with **None** selected and never
85
+ asks an available browser extension for its public key on first startup. Choose
86
+ **Dev**, **NIP-07**, or **Bunker** explicitly; **None** disconnects and cancels pending
87
+ connections. The selected method (including None) is remembered per browser origin
88
+ under `kehto:paja:signer-method:v1`. Reload restores Dev or reconnects an explicitly
89
+ selected NIP-07 extension. Bunker restores selected but disconnected: enter its URI
90
+ again. Only the method is stored, never credentials, keys, URIs, or approvals.
91
+ Invalid or unreadable storage defaults to None; failed writes still allow selection
92
+ for the current session. An unavailable extension stays selected with an error,
93
+ without falling back to another signer. Fixed simulation identity is independent of
94
+ signing authority. Known NAP-IDENTITY gap: signer changes currently re-initialize
95
+ the hosted frame rather than delivering `identity.changed` to the existing frame;
96
+ the new frame reads the updated identity. The browser suite keeps that push gap
97
+ explicitly skipped. Sign, publish, DM
85
98
  send, filesystem picker, Blossom upload, and external-link requests use one serialized in-page
86
99
  confirmation dialog. Deny has initial focus and Escape denies. A napplet-scoped
87
100
  serial or BLE chooser receives runtime approval first; Paja then keeps the
@@ -200,8 +213,10 @@ For `notify`, Paja renders attributed text without fetching icons. The shared
200
213
  Firewall approves the exact notification operation/channel before the browser
201
214
  effect; Paja's own permission cache is tied to the current verified app artifact.
202
215
  Window teardown or revocation clears the UI and invalidates pending answers.
203
- For `link.open`, Paja approves the exact HTTP(S) URL and rechecks the approval
204
- signal and verified artifact after host confirmation before navigation. It
216
+ For `link.open`, Paja approves the exact HTTP(S) URL and opens it from the
217
+ click that approved it. When no click is live, such as a link allowed by a
218
+ standing rule, a host confirmation supplies one; Paja rechecks the approval
219
+ signal and verified artifact before navigation. It
205
220
  opens external links with `noopener,noreferrer`.
206
221
  Live relay URLs are validated before advertisement, fixture events and local
207
222
  publish echoes never enter live reads, and relay event sidecars disclose only
@@ -548,11 +563,15 @@ shell user's BUD-03 list through the same approval-bound relay path, then uses
548
563
  the current window's verified pointer-manifest servers, followed by upload-runtime
549
564
  fallbacks and saved extra resource servers. Every bootstrap and author relay is
550
565
  authorized as its exact `ws:`/`wss:` destination before its socket opens. The
551
- host refreshes signer-derived bootstrap URLs only at signer initialization or a
552
- signer lifecycle change; a resource request reads that bounded host cache and
553
- never calls an external signer's `getRelays()` hook, because that hook can
554
- perform opaque extension work before an origin exists to approve. If refreshing
555
- the cache fails, configured host bootstrap relays remain available. The user-list
566
+ host uses only configured discovery/super relays for bootstrap discovery,
567
+ including contact-list and followed-author warming. Paja neither reads nor calls
568
+ the obsolete NIP-07 `getRelays()` extension property, including during signer
569
+ initialization and account changes; there is no signer-bootstrap cache.
570
+ The retained NAP `identity.getRelays` operation returns an empty relay map for
571
+ unsupported external-user metadata, not host URLs presented as user NIP-65
572
+ preferences. This follows [current NIP-07](https://github.com/nostr-protocol/nips/blob/master/07.md)
573
+ (checked 2026-11-12) and [NAP-IDENTITY at `43cb3a4`](https://github.com/napplet/naps/blob/43cb3a4e855570ec4b90b9cc05f0c721e5ad0aab/naps/NAP-IDENTITY.md),
574
+ which permits empty unsupported results. The user-list
556
575
  lookup works independently of upload mode; an upload runtime may reuse the same
557
576
  servers when present. ROM-specific event and publisher locations retain
558
577
  priority over the user/runtime fallbacks. URI length is capped at 8192 characters;
@@ -713,3 +732,10 @@ collapsible player with transport, seek, volume, and close controls. It also
713
732
  streams live HTTPS MP3/AAC radio without awaiting EOF and displays napplet-owned
714
733
  sessions. See [Media playback](../../docs/media.md) for
715
734
  source support, lifecycle rules, and canonical API examples.
735
+
736
+ ## Optional temporal protection
737
+
738
+ Paja explicitly installs operation and prompt limiters from `@kehto/rate-limit`
739
+ in `createPajaPermissionAdapter`. These are Paja host choices; runtime and Firewall
740
+ do not impose them on other hosts. Limiter configuration and counters are separate
741
+ from approval grants.