@nsite/stealthis 0.1.0 → 0.3.0

package/README.md

@@ -0,0 +1,70 @@
+# @nsite/stealthis
+
+A drop-in web component that adds a "Borrow this" button to any nsite. Visitors can deploy a copy of the current page to their own nostr identity with one click.
+
+## How it works
+
+When loaded on an nsite, `<nsite-deploy>` detects the site owner's pubkey from the subdomain, fetches the site manifest from nostr relays, and lets authenticated visitors publish a copy under their own npub. Each deployment appends a `muse` tag to the manifest, creating a paper trail of who was inspired by the site.
+
+## Install
+
+Add a script tag to your nsite. The widget auto-injects a fixed-position button in the bottom-right corner.
+
+```html
+<script src="https://unpkg.com/@nsite/stealthis/dist/stealthis.js"></script>
+```
+
+Or use the ES module:
+
+```js
+import '@nsite/stealthis';
+```
+
+## Manual placement
+
+If you want to control where the button appears, add the element yourself (the auto-inject will skip if one already exists):
+
+```html
+<nsite-deploy button-text="Cop this joint" stat-text="%s npubs copped this"></nsite-deploy>
+```
+
+## Attributes
+
+| Attribute | Default | Description |
+|-----------|---------|-------------|
+| `button-text` | `"Borrow this nsite"` | Button text |
+| `stat-text` | `"%s npubs borrowed this nsite"` | Paper trail summary. `%s` is replaced with the count. |
+| `no-trail` | _(absent)_ | Boolean attribute. When present, hides the paper trail. |
+
+The button's `trigger` part is exposed via `::part(trigger)` for CSS customization.
+
+## Authentication
+
+The widget supports three sign-in methods:
+
+- **NIP-07** - Browser extension (e.g. nos2x, Alby)
+- **NIP-46 Bunker URI** - Paste a `bunker://` connection string
+- **NIP-46 QR / Nostr Connect** - Scan a QR code with a signer app
+
+## Deploy options
+
+- **Root site** - Publishes as the visitor's primary nsite (kind `15128`)
+- **Named site** - Publishes as a named sub-site with a slug (kind `35128`)
+
+If the visitor already has a root site, the form defaults to a named site. Overwriting an existing site requires explicit confirmation.
+
+## Paper trail
+
+Each deployment adds a `muse` tag with the deployer's pubkey and relay list. The widget shows an expandable "Inspired N npubs" counter when muse tags are present. A maximum of 9 muse tags are kept per manifest (originator + 8 most recent), with FIFO truncation of the middle.
+
+## Development
+
+```bash
+pnpm install
+pnpm run build    # builds dist/stealthis.js (IIFE) and dist/stealthis.mjs (ESM)
+pnpm run dev      # watch mode
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsite/stealthis",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "dist/stealthis.js",
   "module": "dist/stealthis.mjs",

package/src/nostr.ts

@@ -9,7 +9,7 @@ export interface NsiteContext {
   baseDomain: string;
 }
 
-export interface Thief {
+export interface Muse {
   index: number;
   pubkey: string;
   relays: string[];
@@ -232,11 +232,11 @@ export async function checkExistingSite(
   return events.length > 0;
 }
 
-const MAX_THIEF_TAGS = 9;
+const MAX_MUSE_TAGS = 9;
 
-export function extractThieves(event: RelayEvent): Thief[] {
+export function extractMuses(event: RelayEvent): Muse[] {
   return event.tags
-    .filter((t) => t[0] === 'thief' && t[1] && t[2])
+    .filter((t) => t[0] === 'muse' && t[1] && t[2])
     .map((t) => ({ index: parseInt(t[1], 10), pubkey: t[2], relays: t.slice(3) }))
     .sort((a, b) => a.index - b.index);
 }
@@ -257,25 +257,25 @@ export function createDeployEvent(
     if (t[0] === 'path' || t[0] === 'server') tags.push([...t]);
   }
 
-  // Paper trail: copy thief tags, add new one, enforce max 9
-  const sourceThieves = source.tags
-    .filter((t) => t[0] === 'thief' && t[1] && t[2])
+  // Paper trail: copy muse tags, add new one, enforce max 9
+  const sourceMuses = source.tags
+    .filter((t) => t[0] === 'muse' && t[1] && t[2])
     .map((t) => [...t])
     .sort((a, b) => parseInt(a[1], 10) - parseInt(b[1], 10));
 
-  const maxIndex = sourceThieves.length > 0
-    ? Math.max(...sourceThieves.map((t) => parseInt(t[1], 10)))
+  const maxIndex = sourceMuses.length > 0
+    ? Math.max(...sourceMuses.map((t) => parseInt(t[1], 10)))
     : -1;
-  const newThief = ['thief', String(maxIndex + 1), options.deployerPubkey, ...options.deployerRelays];
-  const allThieves = [...sourceThieves, newThief];
+  const newMuse = ['muse', String(maxIndex + 1), options.deployerPubkey, ...options.deployerRelays];
+  const allMuses = [...sourceMuses, newMuse];
 
   // Keep index 0 (originator) + newest, FIFO truncate the middle
-  if (allThieves.length > MAX_THIEF_TAGS) {
-    const originator = allThieves[0];
-    const keep = allThieves.slice(allThieves.length - (MAX_THIEF_TAGS - 1));
+  if (allMuses.length > MAX_MUSE_TAGS) {
+    const originator = allMuses[0];
+    const keep = allMuses.slice(allMuses.length - (MAX_MUSE_TAGS - 1));
     tags.push(originator, ...keep);
   } else {
-    for (const t of allThieves) tags.push(t);
+    for (const t of allMuses) tags.push(t);
   }
 
   if (options.title) tags.push(['title', options.title]);

package/src/widget.ts

@@ -22,7 +22,7 @@ type State =
   | 'error';
 
 export class NsiteDeployButton extends HTMLElement {
-  static observedAttributes = ['label'];
+  static observedAttributes = ['button-text', 'stat-text', 'no-trail'];
 
   private shadow: ShadowRoot;
   private state: State = 'idle';
@@ -45,8 +45,8 @@ export class NsiteDeployButton extends HTMLElement {
   private ncConnect: ReturnType<typeof prepareNostrConnect> | null = null;
   private manifestPromise: Promise<nostr.SignedEvent | null> | null = null;
   private relaysPromise: Promise<string[]> | null = null;
-  private thieves: nostr.Thief[] = [];
-  private thievesExpanded = false;
+  private muses: nostr.Muse[] = [];
+  private musesExpanded = false;
 
   constructor() {
     super();
@@ -56,8 +56,8 @@ export class NsiteDeployButton extends HTMLElement {
       this.manifestPromise = nostr.fetchManifest(this.ctx);
       this.manifestPromise.then((manifest) => {
         if (manifest) {
-          this.thieves = nostr.extractThieves(manifest);
-          if (this.thieves.length > 0 && this.state === 'idle') this.render();
+          this.muses = nostr.extractMuses(manifest);
+          if (this.muses.length > 0 && this.state === 'idle') this.render();
         }
       });
       this.render();
@@ -68,8 +68,12 @@ export class NsiteDeployButton extends HTMLElement {
     if (this.state === 'idle') this.render();
   }
 
-  private get buttonLabel(): string {
-    return this.getAttribute('label') || 'Borrow this';
+  private get buttonText(): string {
+    return this.getAttribute('button-text') || 'Borrow this nsite';
+  }
+
+  private get statText(): string {
+    return this.getAttribute('stat-text') || '%s npubs borrowed this nsite';
   }
 
   private esc(s: string): string {
@@ -90,12 +94,12 @@ export class NsiteDeployButton extends HTMLElement {
 
     switch (this.state) {
       case 'idle':
-        html += `<button class="nd-trigger" part="trigger">${this.esc(this.buttonLabel)}</button>`;
+        html += `<button class="nd-trigger" part="trigger">${this.esc(this.buttonText)}</button>`;
         html += this.paperTrailContent();
         break;
 
       case 'auth':
-        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonLabel)}</button>`;
+        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonText)}</button>`;
         html += this.modal(this.authContent());
         break;
 
@@ -118,12 +122,12 @@ export class NsiteDeployButton extends HTMLElement {
         break;
 
       case 'form':
-        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonLabel)}</button>`;
+        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonText)}</button>`;
         html += this.modal(this.formContent());
         break;
 
       case 'confirm':
-        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonLabel)}</button>`;
+        html += `<button class="nd-trigger" disabled>${this.esc(this.buttonText)}</button>`;
         html += this.modal(this.confirmContent());
         break;
 
@@ -151,7 +155,7 @@ export class NsiteDeployButton extends HTMLElement {
         break;
 
       case 'error':
-        html += `<button class="nd-trigger" part="trigger">${this.esc(this.buttonLabel)}</button>`;
+        html += `<button class="nd-trigger" part="trigger">${this.esc(this.buttonText)}</button>`;
         html += this.modal(`
           <div class="nd-header">
             <h2 class="nd-title">Error</h2>
@@ -172,18 +176,18 @@ export class NsiteDeployButton extends HTMLElement {
   // --- Content builders ---
 
   private paperTrailContent(): string {
-    if (this.thieves.length === 0) return '';
+    if (this.hasAttribute('no-trail') || this.muses.length === 0) return '';
 
     let html = `<div class="nd-trail">
-      <button class="nd-trail-toggle" data-action="toggle-trail">Stolen by ${this.thieves.length} npub${this.thieves.length === 1 ? '' : 's'}</button>`;
+      <button class="nd-trail-toggle" data-action="toggle-trail">${this.esc(this.statText.replace('%s', String(this.muses.length)))}</button>`;
 
-    if (this.thievesExpanded) {
+    if (this.musesExpanded) {
       html += `<div class="nd-trail-list">`;
-      const first = this.thieves[0];
-      const second = this.thieves.length > 1 ? this.thieves[1] : null;
+      const first = this.muses[0];
+      const second = this.muses.length > 1 ? this.muses[1] : null;
 
       // Show originator
-      html += this.thiefItem(first);
+      html += this.museItem(first);
 
       // Show gap if indices aren't sequential (truncated middle)
       if (second && second.index > first.index + 1) {
@@ -192,8 +196,8 @@ export class NsiteDeployButton extends HTMLElement {
       }
 
       // Show the rest
-      for (let i = 1; i < this.thieves.length; i++) {
-        html += this.thiefItem(this.thieves[i]);
+      for (let i = 1; i < this.muses.length; i++) {
+        html += this.museItem(this.muses[i]);
       }
       html += `</div>`;
     }
@@ -202,11 +206,11 @@ export class NsiteDeployButton extends HTMLElement {
     return html;
   }
 
-  private thiefItem(thief: nostr.Thief): string {
-    const npub = nostr.npubEncode(thief.pubkey);
+  private museItem(muse: nostr.Muse): string {
+    const npub = nostr.npubEncode(muse.pubkey);
     const short = npub.slice(0, 12) + '...' + npub.slice(-4);
     return `<div class="nd-trail-item">
-      <span class="nd-trail-idx">#${thief.index}</span>
+      <span class="nd-trail-idx">#${muse.index}</span>
       <span class="nd-trail-pk">${short}</span>
     </div>`;
   }
@@ -345,7 +349,7 @@ export class NsiteDeployButton extends HTMLElement {
     this.shadow
       .querySelector('[data-action="toggle-trail"]')
       ?.addEventListener('click', () => {
-        this.thievesExpanded = !this.thievesExpanded;
+        this.musesExpanded = !this.musesExpanded;
         this.render();
       });
     this.shadow