create-fedi-app 0.1.0

package/dist/templates/modules/ecash-balance/components/fedi/BalanceDisplay.tsx

@@ -0,0 +1,162 @@
+'use client';
+
+import { useFediBalance } from '../../hooks/useFediBalance';
+import { FediVersionBadge } from './FediVersionBadge';
+import { InstallMiniAppButton, type IInstallMiniAppProps } from './InstallMiniAppButton';
+
+interface IBalanceDisplayProps {
+  /** When provided, renders an "Add to Fedi" install prompt (v2 only). */
+  installApp?: IInstallMiniAppProps;
+}
+
+function truncateUrl(url: string): string {
+  try {
+    const parsed = new URL(url);
+    const path = parsed.pathname === '/' ? '' : parsed.pathname;
+    const display = `${parsed.hostname}${path}`;
+    return display.length > 36 ? `${display.slice(0, 33)}…` : display;
+  } catch {
+    return url.length > 36 ? `${url.slice(0, 33)}…` : url;
+  }
+}
+
+function OpenInFediPrompt() {
+  return (
+    <div
+      className="rounded-xl px-4 py-5 text-center"
+      style={{
+        background: 'var(--color-surface-1)',
+        border: '1px solid var(--color-border)',
+        borderRadius: 'var(--radius-lg)',
+      }}
+    >
+      <p className="mb-1 text-sm font-semibold text-[var(--color-text)]">Open in Fedi</p>
+      <p className="mx-auto max-w-[32ch] text-xs leading-[1.65] text-[var(--color-text-muted)]">
+        This feature reads <code className="font-mono">window.fediInternal</code>, which is only
+        injected inside the Fedi app. Open this mini app from Fedi to see installed apps and install
+        prompts.
+      </p>
+    </div>
+  );
+}
+
+/**
+ * Shows fediInternal version, installed mini apps (v2), and an optional install button.
+ */
+export function BalanceDisplay({ installApp }: IBalanceDisplayProps) {
+  const state = useFediBalance();
+
+  if (state.status === 'loading') {
+    return (
+      <div
+        className="rounded-xl px-4 py-5"
+        style={{
+          background: 'var(--color-surface-1)',
+          border: '1px solid var(--color-border)',
+          borderRadius: 'var(--radius-lg)',
+        }}
+      >
+        <p className="text-sm text-[var(--color-text-subtle)]">Checking Fedi environment…</p>
+      </div>
+    );
+  }
+
+  if (state.status === 'unavailable') {
+    return <OpenInFediPrompt />;
+  }
+
+  const { version, miniApps, miniAppsError } = state;
+
+  return (
+    <div
+      className="flex flex-col gap-4 rounded-xl p-4"
+      style={{
+        background: 'var(--color-surface-1)',
+        border: '1px solid var(--color-border)',
+        borderRadius: 'var(--radius-lg)',
+      }}
+    >
+      <div className="flex items-center justify-between gap-3">
+        <div className="min-w-0 space-y-0.5">
+          <p className="text-sm font-semibold text-[var(--color-text)]">Fedi internal API</p>
+          <p className="font-mono text-xs text-[var(--color-text-muted)]">
+            window.fediInternal.version = {version}
+          </p>
+        </div>
+        <FediVersionBadge />
+      </div>
+
+      {version < 2 && (
+        <p className="text-xs leading-[1.65] text-[var(--color-text-muted)]">
+          Installed mini apps and install prompts require fediInternal v2. You are on v{version}.
+        </p>
+      )}
+
+      {version === 2 && (
+        <div className="space-y-2">
+          <p className="text-xs font-medium text-[var(--color-text-subtle)]">
+            Installed mini apps
+            {miniApps !== null ? ` (${miniApps.length})` : ''}
+          </p>
+
+          {miniAppsError && (
+            <p className="text-xs text-[var(--color-text-muted)]">
+              Could not load installed apps. Try reopening this page inside Fedi.
+            </p>
+          )}
+
+          {miniApps !== null && miniApps.length === 0 && (
+            <p className="text-xs text-[var(--color-text-muted)]">No mini apps installed yet.</p>
+          )}
+
+          {miniApps !== null && miniApps.length > 0 && (
+            <ul className="flex flex-col gap-1.5" aria-label="Installed mini apps">
+              {miniApps.map((app) => (
+                <li key={app.url}>
+                  <a
+                    href={app.url}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="flex items-center gap-2 rounded-lg px-3 py-2 text-left transition-opacity duration-200 ease-[cubic-bezier(0.25,1,0.5,1)] hover:opacity-80"
+                    style={{
+                      background: 'var(--color-surface-2)',
+                      border: '1px solid var(--color-border)',
+                      borderRadius: 'var(--radius-md)',
+                    }}
+                    aria-label={`Open mini app: ${app.url}`}
+                  >
+                    <span
+                      className="flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-xs"
+                      style={{
+                        background: 'var(--color-accent-dim)',
+                        color: 'var(--color-accent)',
+                      }}
+                      aria-hidden
+                    >
+                      ↗
+                    </span>
+                    <span className="min-w-0 flex-1">
+                      <span className="block truncate font-mono text-xs text-[var(--color-text)]">
+                        {truncateUrl(app.url)}
+                      </span>
+                      <span className="block truncate font-mono text-[10px] text-[var(--color-text-muted)]">
+                        {app.url}
+                      </span>
+                    </span>
+                  </a>
+                </li>
+              ))}
+            </ul>
+          )}
+        </div>
+      )}
+
+      {installApp && (
+        <div className="space-y-2 border-t border-[var(--color-border)] pt-4">
+          <p className="text-xs font-medium text-[var(--color-text-subtle)]">Install mini app</p>
+          <InstallMiniAppButton {...installApp} />
+        </div>
+      )}
+    </div>
+  );
+}

package/dist/templates/modules/ecash-balance/components/fedi/FediVersionBadge.tsx

@@ -0,0 +1,39 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { getFediInternalVersion } from '../../lib/fedi';
+
+/**
+ * Small debug badge showing the detected `window.fediInternal` API version.
+ */
+export function FediVersionBadge() {
+  const [label, setLabel] = useState<string | null>(null);
+
+  useEffect(() => {
+    const version = getFediInternalVersion();
+    setLabel(version === null ? 'Not in Fedi' : `v${version}`);
+  }, []);
+
+  const inFedi = label !== null && label !== 'Not in Fedi';
+
+  return (
+    <span
+      className="inline-flex items-center rounded px-2 py-0.5 font-mono text-[10px] font-medium uppercase tracking-wide"
+      style={{
+        background: inFedi ? 'var(--color-accent-dim)' : 'var(--color-surface-2)',
+        color: inFedi ? 'var(--color-accent)' : 'var(--color-text-muted)',
+        borderRadius: 'var(--radius-sm)',
+      }}
+      title={
+        label === null
+          ? 'Detecting Fedi environment…'
+          : inFedi
+            ? `fediInternal API ${label}`
+            : 'window.fediInternal is not available in this environment'
+      }
+      aria-label={label === null ? 'Detecting Fedi environment' : `Fedi internal API: ${label}`}
+    >
+      {label ?? '…'}
+    </span>
+  );
+}

package/dist/templates/modules/ecash-balance/components/fedi/InstallMiniAppButton.tsx

@@ -0,0 +1,74 @@
+'use client';
+
+import { useState } from 'react';
+import { useFediInternal } from '../../hooks/useFediInternal';
+
+export interface IInstallMiniAppProps {
+  id: string;
+  title: string;
+  url: string;
+  imageUrl?: string | null;
+  description?: string;
+}
+
+/**
+ * Triggers Fedi's native install prompt for a mini app (requires fediInternal v2).
+ */
+export function InstallMiniAppButton({
+  id,
+  title,
+  url,
+  imageUrl,
+  description,
+}: IInstallMiniAppProps) {
+  const { installMiniApp: installMiniAppFn } = useFediInternal();
+  const [status, setStatus] = useState<'idle' | 'installing' | 'done' | 'error'>('idle');
+
+  if (!installMiniAppFn) {
+    return (
+      <p className="text-xs leading-[1.65] text-[var(--color-text-muted)]">
+        Install prompts require fediInternal v2 inside the Fedi app.
+      </p>
+    );
+  }
+
+  const installMiniApp = installMiniAppFn;
+
+  async function handleInstall() {
+    setStatus('installing');
+    try {
+      await installMiniApp({ id, title, url, imageUrl, description });
+      setStatus('done');
+    } catch {
+      setStatus('error');
+    }
+  }
+
+  const label =
+    status === 'installing'
+      ? 'Opening prompt…'
+      : status === 'done'
+        ? 'Prompt closed'
+        : status === 'error'
+          ? 'Try again'
+          : `Add "${title}" to Fedi`;
+
+  return (
+    <button
+      type="button"
+      onClick={handleInstall}
+      disabled={status === 'installing'}
+      className="inline-flex w-full items-center justify-center rounded-lg px-4 py-2.5 text-sm font-semibold transition-opacity duration-200 ease-[cubic-bezier(0.25,1,0.5,1)] hover:opacity-80 active:opacity-70 disabled:cursor-not-allowed disabled:opacity-40"
+      style={{
+        background: status === 'error' ? 'var(--color-surface-2)' : 'var(--color-accent)',
+        color: status === 'error' ? 'var(--color-text)' : 'var(--color-primary-foreground)',
+        border:
+          status === 'error' ? '1px solid var(--color-border)' : '1px solid transparent',
+        borderRadius: 'var(--radius-md)',
+      }}
+      aria-label={`Install mini app: ${title}`}
+    >
+      {label}
+    </button>
+  );
+}

package/dist/templates/modules/ecash-balance/hooks/useFediBalance.ts

@@ -0,0 +1,65 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import type { FediInternal } from '../lib/fedi-types';
+
+type TMiniApp = { url: string };
+
+export type TFediBalanceState =
+  | { status: 'loading' }
+  | { status: 'unavailable' }
+  | {
+      status: 'ready';
+      version: 0 | 1 | 2;
+      miniApps: TMiniApp[] | null;
+      miniAppsError: boolean;
+    };
+
+/**
+ * Reads `window.fediInternal` and, on v2, loads installed mini apps.
+ */
+export function useFediBalance(): TFediBalanceState {
+  const [state, setState] = useState<TFediBalanceState>({ status: 'loading' });
+
+  useEffect(() => {
+    const fedi = window.fediInternal;
+    if (!fedi) {
+      setState({ status: 'unavailable' });
+      return;
+    }
+
+    if (fedi.version < 2) {
+      setState({
+        status: 'ready',
+        version: fedi.version,
+        miniApps: null,
+        miniAppsError: false,
+      });
+      return;
+    }
+
+    const v2 = fedi as Extract<FediInternal, { version: 2 }>;
+    let cancelled = false;
+
+    async function loadMiniApps() {
+      try {
+        const miniApps = await v2.getInstalledMiniApps();
+        if (!cancelled) {
+          setState({ status: 'ready', version: 2, miniApps, miniAppsError: false });
+        }
+      } catch {
+        if (!cancelled) {
+          setState({ status: 'ready', version: 2, miniApps: null, miniAppsError: true });
+        }
+      }
+    }
+
+    loadMiniApps();
+
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+
+  return state;
+}

package/dist/templates/modules/ecash-balance/module.json

@@ -0,0 +1,14 @@
+{
+  "name": "ecash-balance",
+  "description": "Fedi ecash balance display and fediInternal API demos",
+  "dependencies": [],
+  "devDependencies": [],
+  "files": [
+    { "src": "components/fedi/BalanceDisplay.tsx", "dest": "components/fedi/BalanceDisplay.tsx", "merge": "add" },
+    { "src": "components/fedi/FediVersionBadge.tsx", "dest": "components/fedi/FediVersionBadge.tsx", "merge": "add" },
+    { "src": "components/fedi/InstallMiniAppButton.tsx", "dest": "components/fedi/InstallMiniAppButton.tsx", "merge": "add" },
+    { "src": "hooks/useFediBalance.ts", "dest": "hooks/useFediBalance.ts", "merge": "add" },
+    { "src": "app/demo/ecash/page.tsx", "dest": "app/demo/ecash/page.tsx", "merge": "add" }
+  ],
+  "envVars": []
+}

package/dist/templates/modules/lnurl/app/api/lnurlauth/route.ts

@@ -0,0 +1,118 @@
+import { NextResponse } from 'next/server';
+import { encodeLnurl, getLnurlServerBaseUrl } from '../../../lib/lnurl-utils';
+import {
+  completeAuthSession,
+  createAuthSession,
+  getAuthSession,
+} from '../../../lib/lnurl-store';
+import {
+  verifyK1SchnorrSignature,
+  verifyLnurlAuthEvent,
+} from '../../../lib/lnurl-auth-verify';
+
+type TAuthCallbackBody = {
+  k1?: string;
+  sig?: string;
+  key?: string;
+  tag?: string;
+  event?: string | Record<string, unknown>;
+};
+
+function resolveAuthCallback(
+  k1: string | null,
+  sig: string | null,
+  key: string | null,
+  tag: string | null,
+  event: string | Record<string, unknown> | null,
+) {
+  if (!k1 || !key || tag !== 'login' || (!sig && !event)) {
+    return null;
+  }
+
+  const session = getAuthSession(k1);
+  if (!session) {
+    return NextResponse.json({ status: 'ERROR', reason: 'Unknown or expired k1' });
+  }
+
+  let pubkey = key;
+
+  if (event) {
+    const eventJson = typeof event === 'string' ? event : JSON.stringify(event);
+    const verified = verifyLnurlAuthEvent(k1, eventJson);
+    if (!verified.valid) {
+      return NextResponse.json({
+        status: 'ERROR',
+        reason: verified.reason ?? 'Invalid auth event',
+      });
+    }
+    pubkey = verified.pubkey ?? key;
+  } else if (sig) {
+    if (!verifyK1SchnorrSignature(k1, sig, key)) {
+      return NextResponse.json({ status: 'ERROR', reason: 'Invalid signature' });
+    }
+  } else {
+    return NextResponse.json({ status: 'ERROR', reason: 'sig or event required' });
+  }
+
+  const completed = completeAuthSession(k1, pubkey);
+  if (!completed) {
+    return NextResponse.json({ status: 'ERROR', reason: 'Session expired' });
+  }
+
+  return NextResponse.json({
+    status: 'OK',
+    event: 'login',
+    pubkey,
+  });
+}
+
+/**
+ * LNURL-auth endpoint (LUD-04).
+ * Initial GET returns `{ tag: "auth", k1 }`. Callback GET/POST with sig/key completes login.
+ */
+export async function GET(request: Request) {
+  const { searchParams } = new URL(request.url);
+  const callback = resolveAuthCallback(
+    searchParams.get('k1'),
+    searchParams.get('sig'),
+    searchParams.get('key'),
+    searchParams.get('tag'),
+    searchParams.get('event'),
+  );
+
+  if (callback) return callback;
+
+  const session = createAuthSession();
+  const baseUrl = getLnurlServerBaseUrl(request);
+  const authUrl = `${baseUrl}/api/lnurlauth?tag=login`;
+  const lnurl = encodeLnurl(authUrl);
+
+  return NextResponse.json({
+    tag: 'auth',
+    k1: session.k1,
+    lnurl,
+    url: authUrl,
+  });
+}
+
+/** POST callback for mini-app demos (signed Nostr events exceed GET URL limits). */
+export async function POST(request: Request) {
+  let body: TAuthCallbackBody;
+  try {
+    body = (await request.json()) as TAuthCallbackBody;
+  } catch {
+    return NextResponse.json({ status: 'ERROR', reason: 'Invalid JSON body' }, { status: 400 });
+  }
+
+  const callback = resolveAuthCallback(
+    body.k1 ?? null,
+    body.sig ?? null,
+    body.key ?? null,
+    body.tag ?? null,
+    body.event ?? null,
+  );
+
+  if (callback) return callback;
+
+  return NextResponse.json({ status: 'ERROR', reason: 'Missing auth parameters' }, { status: 400 });
+}

package/dist/templates/modules/lnurl/app/api/lnurlp/[username]/route.ts

@@ -0,0 +1,70 @@
+import { NextResponse } from 'next/server';
+import {
+  buildLnurlMetadata,
+  getLnurlServerBaseUrl,
+  msatsToSats,
+} from '../../../../lib/lnurl-utils';
+import { createLnurlPayInvoice } from '../../../../lib/lnurl-store';
+
+const DEFAULT_MIN_MSATS = 1_000;
+const DEFAULT_MAX_MSATS = 10_000_000_000;
+
+type TRouteContext = { params: Promise<{ username: string }> };
+
+/**
+ * LNURL-pay endpoint (LUD-06).
+ * GET without `amount` returns payRequest metadata; with `amount` returns a BOLT11 invoice.
+ */
+export async function GET(request: Request, context: TRouteContext) {
+  const { username } = await context.params;
+  const { searchParams } = new URL(request.url);
+  const amountParam = searchParams.get('amount');
+
+  if (!username || !/^[a-zA-Z0-9_-]+$/.test(username)) {
+    return NextResponse.json({ status: 'ERROR', reason: 'Invalid username' }, { status: 400 });
+  }
+
+  const baseUrl = getLnurlServerBaseUrl(request);
+  const callbackUrl = `${baseUrl}/api/lnurlp/${encodeURIComponent(username)}`;
+
+  if (amountParam !== null) {
+    const amountMsats = Number.parseInt(amountParam, 10);
+    if (!Number.isFinite(amountMsats) || amountMsats < DEFAULT_MIN_MSATS) {
+      return NextResponse.json(
+        { status: 'ERROR', reason: 'Invalid amount' },
+        { status: 400 },
+      );
+    }
+
+    if (amountMsats > DEFAULT_MAX_MSATS) {
+      return NextResponse.json(
+        { status: 'ERROR', reason: 'Amount above maximum' },
+        { status: 400 },
+      );
+    }
+
+    const pr = createLnurlPayInvoice(amountMsats, username);
+    return NextResponse.json({
+      pr,
+      routes: [],
+      successAction: {
+        tag: 'message',
+        message: `Received ${msatsToSats(amountMsats)} sats for @${username}`,
+      },
+    });
+  }
+
+  const metadata = buildLnurlMetadata([
+    ['text/plain', `Pay @${username} via LNURL`],
+    ['text/identifier', `${username}@fedi`],
+  ]);
+
+  return NextResponse.json({
+    tag: 'payRequest',
+    callback: callbackUrl,
+    minSendable: DEFAULT_MIN_MSATS,
+    maxSendable: DEFAULT_MAX_MSATS,
+    metadata,
+    commentAllowed: 140,
+  });
+}

package/dist/templates/modules/lnurl/app/api/lnurlw/route.ts

@@ -0,0 +1,57 @@
+import { NextResponse } from 'next/server';
+import { encodeLnurl, getLnurlServerBaseUrl } from '../../../lib/lnurl-utils';
+import {
+  completeWithdrawSession,
+  createWithdrawSession,
+  getWithdrawSession,
+} from '../../../lib/lnurl-store';
+
+const DEFAULT_MIN_MSATS = 1_000;
+const DEFAULT_MAX_MSATS = 1_000_000_000;
+
+/**
+ * LNURL-withdraw endpoint (LUD-03).
+ * Initial GET returns withdrawRequest metadata; callback GET with pr completes withdrawal.
+ */
+export async function GET(request: Request) {
+  const { searchParams } = new URL(request.url);
+  const k1 = searchParams.get('k1');
+  const pr = searchParams.get('pr');
+  const tag = searchParams.get('tag');
+
+  if (k1 && pr && tag === 'withdrawLink') {
+    const session = getWithdrawSession(k1);
+    if (!session) {
+      return NextResponse.json({ status: 'ERROR', reason: 'Unknown or expired k1' });
+    }
+
+    if (!pr.startsWith('lnbc')) {
+      return NextResponse.json({ status: 'ERROR', reason: 'Invalid payment request' });
+    }
+
+    const completed = completeWithdrawSession(k1, pr, DEFAULT_MAX_MSATS);
+    if (!completed) {
+      return NextResponse.json({ status: 'ERROR', reason: 'Withdraw session expired' });
+    }
+
+    return NextResponse.json({
+      status: 'OK',
+      pr,
+    });
+  }
+
+  const session = createWithdrawSession();
+  const baseUrl = getLnurlServerBaseUrl(request);
+  const callback = `${baseUrl}/api/lnurlw`;
+  const lnurl = encodeLnurl(callback);
+
+  return NextResponse.json({
+    tag: 'withdrawRequest',
+    callback,
+    k1: session.k1,
+    minWithdrawable: DEFAULT_MIN_MSATS,
+    maxWithdrawable: DEFAULT_MAX_MSATS,
+    defaultDescription: 'LNURL withdraw demo',
+    lnurl,
+  });
+}