@bwalletx/connect 0.2.0 → 0.4.1

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { WalletInterface, WalletProtocol } from '@bsv/sdk';
+import { f as PairingOptions, W as WalletOption } from './wallets-VOKIKBbO.js';
+export { g as BRC29_PROTOCOL, i as Brc29Remittance, B as BuyTokenRequest, C as ConnectedWallet, D as DiscoverWalletsOptions, H as HandCashAdapterOptions, L as LegacyPayer, j as PairConnectionOptions, k as PairStorage, l as PairedWallet, b as PayOptions, m as PayOutput, P as PayRequest, a as PayResult, n as PaySource, c as PaymentError, o as PaymentErrorCode, S as SocketFactory, q as SocketLike, T as TokenQuote, r as WalletKind, s as amountInSats, d as brc100Option, t as buyToken, u as clearPairing, e as discoverWallets, h as handcashAdapter, v as isIdentityKeyHex, w as isPaymail, x as pairBwalletX, p as pairingOption, y as pay, z as resolvePaymailP2P, A as restorePairing, E as tip } from './wallets-VOKIKBbO.js';
 export { AuthorizeParams, GET_URL, SIGNIN_CSS, SIGNIN_TAG, SigninBrand, SigninLabel, SigninSize, SigninTheme, WEB_WALLET_URL, buildAuthorizeUrl, defineBwalletxSignin, markSvg, signinText } from './element.js';
 
 /** Ids bWalletX announces in BRC-100 wallet discovery. */
@@ -24,67 +26,6 @@ declare function discoverBwalletX(ms?: number): Promise<FoundWallet | null>;
  */
 declare function findBwalletX(ms?: number): Promise<WalletInterface | null>;
 
-/** localStorage-shaped storage. Methods may be sync or async. */
-interface PairStorage {
-    getItem(key: string): string | null | Promise<string | null>;
-    setItem(key: string, value: string): void | Promise<void>;
-    removeItem(key: string): void | Promise<void>;
-}
-/** The minimum of the browser WebSocket API this package uses (the `ws` package also fits). */
-interface SocketLike {
-    readonly readyState: number;
-    onopen: ((ev: unknown) => void) | null;
-    onmessage: ((ev: {
-        data: unknown;
-    }) => void) | null;
-    onerror: ((ev: unknown) => void) | null;
-    onclose: ((ev: unknown) => void) | null;
-    send(data: string): void;
-    close(): void;
-}
-type SocketFactory = (url: string) => SocketLike;
-interface PairConnectionOptions {
-    /** Where the pairing is kept so it survives a reload. Default: localStorage, else memory only. */
-    storage?: PairStorage | null;
-    /** Storage key. Default 'bwalletx.connect.pairing.v1'. */
-    storageKey?: string;
-    /** Opens a socket. Default: the global WebSocket. Pass one to run in Node or to test. */
-    socket?: SocketFactory;
-    /** Per-call timeout in ms. Default 120000. */
-    callTimeoutMs?: number;
-}
-interface PairingOptions extends PairConnectionOptions {
-    /** Show this link as a QR code, and as text to copy (web.bwalletx.com takes it pasted). */
-    onLink: (link: string) => void;
-    /** Show this 4-digit code. The wallet shows the same one; the user checks they match. */
-    onCode: (code: string) => void;
-    signal?: AbortSignal;
-    /** Relay host. Default relay.bwallet.space. */
-    relay?: string;
-    /** This page's origin, as the relay will see it. Default location.origin. */
-    origin?: string;
-}
-/** A BRC-100 wallet whose every call goes, end-to-end encrypted, to the paired phone or web wallet. */
-type PairedWallet = WalletInterface & {
-    /** Close the relay connection. The pairing stays stored; the next call reconnects. */
-    close(): void;
-    /** Tell the wallet to unpair, close, and delete the stored pairing. */
-    forget(): Promise<void>;
-};
-/**
- * Pair with bWalletX on a phone (scan the QR) or web.bwalletx.com (paste the link).
- * Resolves with a wallet once the user taps Connect. The pairing is stored (see `storage`) so
- * `restorePairing()` can reconnect after a reload without a new QR.
- */
-declare function pairBwalletX(opts: PairingOptions): Promise<PairedWallet>;
-/**
- * The wallet from a pairing stored by an earlier `pairBwalletX`, or null if there is none.
- * It connects on the first call. The wallet must still have this site paired.
- */
-declare function restorePairing(opts?: PairConnectionOptions): Promise<PairedWallet | null>;
-/** Delete the stored pairing without telling the wallet. */
-declare function clearPairing(opts?: Pick<PairConnectionOptions, 'storage' | 'storageKey'>): Promise<void>;
-
 /** Security level 2, a protocol name used for nothing else. */
 declare const LOGIN_PROTOCOL: WalletProtocol;
 /** What your server's challenge route returns (createChallenge from '@bwalletx/connect/server'). */
@@ -146,4 +87,24 @@ declare function renderButton(el: HTMLElement | string, opts?: ButtonOptions): H
  */
 declare function inOrder<T>(handle: (frame: T) => Promise<void> | void, onError?: (e: unknown) => void): (frame: T) => Promise<void>;
 
-export { BWALLETX_RDNS, type ButtonOptions, type Challenge, type FoundBy, type FoundWallet, LOGIN_PROTOCOL, LOGO_URL, type PairConnectionOptions, type PairStorage, type PairedWallet, type PairingOptions, RDNS_EXTENSION, RDNS_MOBILE, type SignInMethod, type SignInOptions, type SignInResult, type SocketFactory, type SocketLike, clearPairing, connectBwalletX, discoverBwalletX, findBwalletX, inOrder, pairBwalletX, renderButton, restorePairing, signInWithBwalletX };
+/** An SVG QR code for `text` (error correction M). */
+declare function qrSvg(text: string): string;
+interface PairingModalOptions {
+    title?: string;
+    /** Called when the user closes the modal (the pairing is then aborted). */
+    onCancel?: () => void;
+}
+/**
+ * PairingOptions that show a QR modal. Pass to signInWithBwalletX({ pairing: pairingModal() }) or
+ * connectBwalletX. The modal opens when the link is ready and shows the match code. Call `close()`
+ * once pairing settles (useBwalletX does this for you); Cancel aborts the pairing.
+ */
+declare function pairingModal(o?: PairingModalOptions): PairingOptions & {
+    close(): void;
+};
+/** Show the picker; resolves with the chosen option, or null if closed. */
+declare function pickWallet(options: WalletOption[], o?: {
+    title?: string;
+}): Promise<WalletOption | null>;
+
+export { BWALLETX_RDNS, type ButtonOptions, type Challenge, type FoundBy, type FoundWallet, LOGIN_PROTOCOL, LOGO_URL, type PairingModalOptions, PairingOptions, RDNS_EXTENSION, RDNS_MOBILE, type SignInMethod, type SignInOptions, type SignInResult, WalletOption, connectBwalletX, discoverBwalletX, findBwalletX, inOrder, pairingModal, pickWallet, qrSvg, renderButton, signInWithBwalletX };

package/dist/index.js

@@ -1,3 +1,21 @@
+import {
+  BRC29_PROTOCOL,
+  PaymentError,
+  amountInSats,
+  brc100Option,
+  buyToken,
+  discoverWallets,
+  handcashAdapter,
+  isIdentityKeyHex,
+  isPaymail,
+  pairingModal,
+  pairingOption,
+  pay,
+  pickWallet,
+  qrSvg,
+  resolvePaymailP2P,
+  tip
+} from "./chunk-FUQ46RJV.js";
 import {
   BWALLETX_RDNS,
   GET_URL,
@@ -65,27 +83,43 @@ function renderButton(el, opts = {}) {
   return b;
 }
 export {
+  BRC29_PROTOCOL,
   BWALLETX_RDNS,
   GET_URL,
   LOGIN_PROTOCOL,
   LOGO_URL,
+  PaymentError,
   RDNS_EXTENSION,
   RDNS_MOBILE,
   SIGNIN_CSS,
   SIGNIN_TAG,
   WEB_WALLET_URL,
+  amountInSats,
+  brc100Option,
   buildAuthorizeUrl,
+  buyToken,
   clearPairing,
   connectBwalletX,
   defineBwalletxSignin,
   discoverBwalletX,
+  discoverWallets,
   findBwalletX,
+  handcashAdapter,
   inOrder,
+  isIdentityKeyHex,
+  isPaymail,
   markSvg,
   pairBwalletX,
+  pairingModal,
+  pairingOption,
+  pay,
+  pickWallet,
+  qrSvg,
   renderButton,
+  resolvePaymailP2P,
   restorePairing,
   signInWithBwalletX,
-  signinText
+  signinText,
+  tip
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/button.ts"],"sourcesContent":["const CSS = `\n.bwx-signin{display:inline-flex;align-items:center;gap:12px;min-height:48px;padding:10px 22px 10px 10px;border:0;border-radius:12px;cursor:pointer;background:linear-gradient(180deg,#fcd34d,#f59e0b);color:#000;text-align:left;font:700 16px/1.2 system-ui,-apple-system,\"Segoe UI\",sans-serif;box-shadow:0 8px 24px rgba(245,158,11,.2)}\n.bwx-signin:hover{background:linear-gradient(180deg,#fde68a,#fbbf24)}\n.bwx-signin:focus-visible{outline:2px solid #ffd24d;outline-offset:3px}\n.bwx-signin:disabled{opacity:.6;cursor:wait}\n.bwx-signin .bwx-mark{display:inline-flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:50%;background:#000;flex:none}\n.bwx-signin small{display:block;font-size:11px;font-weight:500;color:rgba(0,0,0,.6)}`;\n\nexport const LOGO_URL = 'https://bwalletx.com/logo.svg';\n\nexport interface ButtonOptions {\n  /** Second line under the label. Default \"also works with bWallet\". false hides it. */\n  subtitle?: string | false;\n  onClick?: (button: HTMLButtonElement) => void;\n}\n\n/** Put the gold \"Sign in with bWalletX\" button into `el` (replacing its contents). */\nexport function renderButton(el: HTMLElement | string, opts: ButtonOptions = {}): HTMLButtonElement {\n  const host = typeof el === 'string' ? document.querySelector<HTMLElement>(el) : el;\n  if (!host) throw new Error(`renderButton: no element ${String(el)}`);\n  if (!document.getElementById('bwx-signin-css')) {\n    const style = document.createElement('style');\n    style.id = 'bwx-signin-css';\n    style.textContent = CSS;\n    document.head.appendChild(style);\n  }\n  const b = document.createElement('button');\n  b.type = 'button';\n  b.className = 'bwx-signin';\n  const mark = document.createElement('span');\n  mark.className = 'bwx-mark';\n  const img = document.createElement('img');\n  img.src = LOGO_URL;\n  img.alt = '';\n  img.width = 15;\n  img.height = 20;\n  mark.appendChild(img);\n  const label = document.createElement('span');\n  label.className = 'bwx-label';\n  label.textContent = 'Sign in with bWalletX';\n  const sub = opts.subtitle === undefined ? 'also works with bWallet' : opts.subtitle;\n  if (sub) {\n    const small = document.createElement('small');\n    small.textContent = sub;\n    label.appendChild(small);\n  }\n  b.append(mark, label);\n  if (opts.onClick) b.addEventListener('click', () => opts.onClick!(b));\n  host.replaceChildren(b);\n  return b;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQL,IAAM,WAAW;AASjB,SAAS,aAAa,IAA0B,OAAsB,CAAC,GAAsB;AAClG,QAAM,OAAO,OAAO,OAAO,WAAW,SAAS,cAA2B,EAAE,IAAI;AAChF,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE,CAAC,EAAE;AACnE,MAAI,CAAC,SAAS,eAAe,gBAAgB,GAAG;AAC9C,UAAM,QAAQ,SAAS,cAAc,OAAO;AAC5C,UAAM,KAAK;AACX,UAAM,cAAc;AACpB,aAAS,KAAK,YAAY,KAAK;AAAA,EACjC;AACA,QAAM,IAAI,SAAS,cAAc,QAAQ;AACzC,IAAE,OAAO;AACT,IAAE,YAAY;AACd,QAAM,OAAO,SAAS,cAAc,MAAM;AAC1C,OAAK,YAAY;AACjB,QAAM,MAAM,SAAS,cAAc,KAAK;AACxC,MAAI,MAAM;AACV,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,OAAK,YAAY,GAAG;AACpB,QAAM,QAAQ,SAAS,cAAc,MAAM;AAC3C,QAAM,YAAY;AAClB,QAAM,cAAc;AACpB,QAAM,MAAM,KAAK,aAAa,SAAY,4BAA4B,KAAK;AAC3E,MAAI,KAAK;AACP,UAAM,QAAQ,SAAS,cAAc,OAAO;AAC5C,UAAM,cAAc;AACpB,UAAM,YAAY,KAAK;AAAA,EACzB;AACA,IAAE,OAAO,MAAM,KAAK;AACpB,MAAI,KAAK,QAAS,GAAE,iBAAiB,SAAS,MAAM,KAAK,QAAS,CAAC,CAAC;AACpE,OAAK,gBAAgB,CAAC;AACtB,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/button.ts"],"sourcesContent":["const CSS = `\n.bwx-signin{display:inline-flex;align-items:center;gap:12px;min-height:48px;padding:10px 22px 10px 10px;border:0;border-radius:12px;cursor:pointer;background:linear-gradient(180deg,#fcd34d,#f59e0b);color:#000;text-align:left;font:700 16px/1.2 system-ui,-apple-system,\"Segoe UI\",sans-serif;box-shadow:0 8px 24px rgba(245,158,11,.2)}\n.bwx-signin:hover{background:linear-gradient(180deg,#fde68a,#fbbf24)}\n.bwx-signin:focus-visible{outline:2px solid #ffd24d;outline-offset:3px}\n.bwx-signin:disabled{opacity:.6;cursor:wait}\n.bwx-signin .bwx-mark{display:inline-flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:50%;background:#000;flex:none}\n.bwx-signin small{display:block;font-size:11px;font-weight:500;color:rgba(0,0,0,.6)}`;\n\nexport const LOGO_URL = 'https://bwalletx.com/logo.svg';\n\nexport interface ButtonOptions {\n  /** Second line under the label. Default \"also works with bWallet\". false hides it. */\n  subtitle?: string | false;\n  onClick?: (button: HTMLButtonElement) => void;\n}\n\n/** Put the gold \"Sign in with bWalletX\" button into `el` (replacing its contents). */\nexport function renderButton(el: HTMLElement | string, opts: ButtonOptions = {}): HTMLButtonElement {\n  const host = typeof el === 'string' ? document.querySelector<HTMLElement>(el) : el;\n  if (!host) throw new Error(`renderButton: no element ${String(el)}`);\n  if (!document.getElementById('bwx-signin-css')) {\n    const style = document.createElement('style');\n    style.id = 'bwx-signin-css';\n    style.textContent = CSS;\n    document.head.appendChild(style);\n  }\n  const b = document.createElement('button');\n  b.type = 'button';\n  b.className = 'bwx-signin';\n  const mark = document.createElement('span');\n  mark.className = 'bwx-mark';\n  const img = document.createElement('img');\n  img.src = LOGO_URL;\n  img.alt = '';\n  img.width = 15;\n  img.height = 20;\n  mark.appendChild(img);\n  const label = document.createElement('span');\n  label.className = 'bwx-label';\n  label.textContent = 'Sign in with bWalletX';\n  const sub = opts.subtitle === undefined ? 'also works with bWallet' : opts.subtitle;\n  if (sub) {\n    const small = document.createElement('small');\n    small.textContent = sub;\n    label.appendChild(small);\n  }\n  b.append(mark, label);\n  if (opts.onClick) b.addEventListener('click', () => opts.onClick!(b));\n  host.replaceChildren(b);\n  return b;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQL,IAAM,WAAW;AASjB,SAAS,aAAa,IAA0B,OAAsB,CAAC,GAAsB;AAClG,QAAM,OAAO,OAAO,OAAO,WAAW,SAAS,cAA2B,EAAE,IAAI;AAChF,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE,CAAC,EAAE;AACnE,MAAI,CAAC,SAAS,eAAe,gBAAgB,GAAG;AAC9C,UAAM,QAAQ,SAAS,cAAc,OAAO;AAC5C,UAAM,KAAK;AACX,UAAM,cAAc;AACpB,aAAS,KAAK,YAAY,KAAK;AAAA,EACjC;AACA,QAAM,IAAI,SAAS,cAAc,QAAQ;AACzC,IAAE,OAAO;AACT,IAAE,YAAY;AACd,QAAM,OAAO,SAAS,cAAc,MAAM;AAC1C,OAAK,YAAY;AACjB,QAAM,MAAM,SAAS,cAAc,KAAK;AACxC,MAAI,MAAM;AACV,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,OAAK,YAAY,GAAG;AACpB,QAAM,QAAQ,SAAS,cAAc,MAAM;AAC3C,QAAM,YAAY;AAClB,QAAM,cAAc;AACpB,QAAM,MAAM,KAAK,aAAa,SAAY,4BAA4B,KAAK;AAC3E,MAAI,KAAK;AACP,UAAM,QAAQ,SAAS,cAAc,OAAO;AAC5C,UAAM,cAAc;AACpB,UAAM,YAAY,KAAK;AAAA,EACzB;AACA,IAAE,OAAO,MAAM,KAAK;AACpB,MAAI,KAAK,QAAS,GAAE,iBAAiB,SAAS,MAAM,KAAK,QAAS,CAAC,CAAC;AACpE,OAAK,gBAAgB,CAAC;AACtB,SAAO;AACT;","names":[]}

package/dist/manifest-Caj_Raqm.d.cts

@@ -0,0 +1,81 @@
+/**
+ * bApp manifest: /.well-known/bapp.json. One file declares the app's five scoped slots, its drawer
+ * (Home + sections) and its like-to-fund config. The web bar draws from it; inside bWalletX the
+ * wallet's native dock reads the same file. Every path is same-origin: no URLs, no schemes.
+ */
+declare const SLOT_IDS: readonly ["wallet", "exchange", "b", "feed", "chat"];
+type SlotId = (typeof SLOT_IDS)[number];
+interface BappSlot {
+    /** Same-origin path, e.g. "/feed". Required when enabled, except for "b" (the agent). */
+    path?: string;
+    /** Optional rename ("Market"); the icon and position never change. */
+    label?: string;
+    /** false = shown greyed out and not clickable. Slots are never hidden. */
+    enabled: boolean;
+}
+interface BappDrawerItem {
+    label: string;
+    path: string;
+    /** Optional same-origin icon path. */
+    icon?: string;
+}
+interface BappLikeConfig {
+    /** Which fields of a feed item hold the id, token (BSV-21 id / $TICKER), payee, title and media. */
+    fields: {
+        id: string;
+        token: string;
+        payee?: string;
+        title?: string;
+        media?: string;
+    };
+    /** Price of one Like in US cents. Default 1 (one PNEE). */
+    amountCents: number;
+    /** Pay in PNEE (the wallet's USD-cent token) when held, else BSV. Default "PNEE". */
+    currency: 'PNEE' | 'BSV';
+    /** Daily cap in US cents. Default 100 ($1), never more. */
+    dailyCapCents: number;
+}
+interface BappTheme {
+    /** Active/accent colour, #RRGGBB. Default #FFD24D. */
+    accent?: string;
+}
+interface BappManifest {
+    version: 1;
+    name: string;
+    /** Same-origin path to a square icon. */
+    icon: string;
+    /** The app's Home (first drawer item). Default "/". */
+    home: string;
+    theme?: BappTheme;
+    slots: Record<SlotId, BappSlot>;
+    drawer: BappDrawerItem[];
+    like?: BappLikeConfig;
+}
+type ValidationResult = {
+    ok: true;
+    manifest: BappManifest;
+    errors: [];
+} | {
+    ok: false;
+    errors: string[];
+    manifest?: undefined;
+};
+declare const WELL_KNOWN_PATH = "/.well-known/bapp.json";
+declare const LIKE_DEFAULT_CENTS = 1;
+declare const LIKE_MAX_DAILY_CENTS = 100;
+/**
+ * A same-origin path: starts with one "/", no "//" (protocol-relative), no backslashes, no control
+ * characters, no scheme. Query and hash are allowed.
+ */
+declare function isSameOriginPath(p: unknown): p is string;
+/** Validate and normalise a parsed bapp.json. Never throws. */
+declare function validateManifest(input: unknown): ValidationResult;
+/** Same as validateManifest but throws with every error listed. */
+declare function parseManifest(input: unknown): BappManifest;
+/** Fetch and validate /.well-known/bapp.json (same origin). */
+declare function loadManifest(path?: string, fetchImpl?: typeof fetch): Promise<BappManifest>;
+/** The path a slot points at, or null when disabled / no path. */
+declare function slotPath(m: BappManifest, slot: SlotId): string | null;
+declare const isSlotId: (v: unknown) => v is SlotId;
+
+export { type BappManifest as B, LIKE_DEFAULT_CENTS as L, type SlotId as S, type ValidationResult as V, WELL_KNOWN_PATH as W, type BappDrawerItem as a, type BappLikeConfig as b, type BappSlot as c, type BappTheme as d, LIKE_MAX_DAILY_CENTS as e, SLOT_IDS as f, isSlotId as g, isSameOriginPath as i, loadManifest as l, parseManifest as p, slotPath as s, validateManifest as v };

package/dist/manifest-Caj_Raqm.d.ts

@@ -0,0 +1,81 @@
+/**
+ * bApp manifest: /.well-known/bapp.json. One file declares the app's five scoped slots, its drawer
+ * (Home + sections) and its like-to-fund config. The web bar draws from it; inside bWalletX the
+ * wallet's native dock reads the same file. Every path is same-origin: no URLs, no schemes.
+ */
+declare const SLOT_IDS: readonly ["wallet", "exchange", "b", "feed", "chat"];
+type SlotId = (typeof SLOT_IDS)[number];
+interface BappSlot {
+    /** Same-origin path, e.g. "/feed". Required when enabled, except for "b" (the agent). */
+    path?: string;
+    /** Optional rename ("Market"); the icon and position never change. */
+    label?: string;
+    /** false = shown greyed out and not clickable. Slots are never hidden. */
+    enabled: boolean;
+}
+interface BappDrawerItem {
+    label: string;
+    path: string;
+    /** Optional same-origin icon path. */
+    icon?: string;
+}
+interface BappLikeConfig {
+    /** Which fields of a feed item hold the id, token (BSV-21 id / $TICKER), payee, title and media. */
+    fields: {
+        id: string;
+        token: string;
+        payee?: string;
+        title?: string;
+        media?: string;
+    };
+    /** Price of one Like in US cents. Default 1 (one PNEE). */
+    amountCents: number;
+    /** Pay in PNEE (the wallet's USD-cent token) when held, else BSV. Default "PNEE". */
+    currency: 'PNEE' | 'BSV';
+    /** Daily cap in US cents. Default 100 ($1), never more. */
+    dailyCapCents: number;
+}
+interface BappTheme {
+    /** Active/accent colour, #RRGGBB. Default #FFD24D. */
+    accent?: string;
+}
+interface BappManifest {
+    version: 1;
+    name: string;
+    /** Same-origin path to a square icon. */
+    icon: string;
+    /** The app's Home (first drawer item). Default "/". */
+    home: string;
+    theme?: BappTheme;
+    slots: Record<SlotId, BappSlot>;
+    drawer: BappDrawerItem[];
+    like?: BappLikeConfig;
+}
+type ValidationResult = {
+    ok: true;
+    manifest: BappManifest;
+    errors: [];
+} | {
+    ok: false;
+    errors: string[];
+    manifest?: undefined;
+};
+declare const WELL_KNOWN_PATH = "/.well-known/bapp.json";
+declare const LIKE_DEFAULT_CENTS = 1;
+declare const LIKE_MAX_DAILY_CENTS = 100;
+/**
+ * A same-origin path: starts with one "/", no "//" (protocol-relative), no backslashes, no control
+ * characters, no scheme. Query and hash are allowed.
+ */
+declare function isSameOriginPath(p: unknown): p is string;
+/** Validate and normalise a parsed bapp.json. Never throws. */
+declare function validateManifest(input: unknown): ValidationResult;
+/** Same as validateManifest but throws with every error listed. */
+declare function parseManifest(input: unknown): BappManifest;
+/** Fetch and validate /.well-known/bapp.json (same origin). */
+declare function loadManifest(path?: string, fetchImpl?: typeof fetch): Promise<BappManifest>;
+/** The path a slot points at, or null when disabled / no path. */
+declare function slotPath(m: BappManifest, slot: SlotId): string | null;
+declare const isSlotId: (v: unknown) => v is SlotId;
+
+export { type BappManifest as B, LIKE_DEFAULT_CENTS as L, type SlotId as S, type ValidationResult as V, WELL_KNOWN_PATH as W, type BappDrawerItem as a, type BappLikeConfig as b, type BappSlot as c, type BappTheme as d, LIKE_MAX_DAILY_CENTS as e, SLOT_IDS as f, isSlotId as g, isSameOriginPath as i, loadManifest as l, parseManifest as p, slotPath as s, validateManifest as v };