@ghostlytools/sdk 1.13.2 → 1.13.4
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/dist/{bitcoinAddress-BIW3tpJG.js → bitcoinAddress-CDYL3yPz.js} +28 -8
- package/dist/bitcoinAddress-CDYL3yPz.js.map +1 -0
- package/dist/core.js +276 -42
- package/dist/core.js.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/{pairedTransports-BcTRg3tp.js → pairedTransports-CQGJfihi.js} +2 -2
- package/dist/{pairedTransports-BcTRg3tp.js.map → pairedTransports-CQGJfihi.js.map} +1 -1
- package/dist/testing.js +2 -2
- package/dist/types/browser/src/proofs/contract.d.ts +2 -1
- package/dist/types/core/src/chatFiles.d.ts +30 -5
- package/dist/types/core/src/didDht.d.ts +2 -1
- package/dist/types/core/src/groupSession.d.ts +33 -2
- package/dist/types/core/src/http.d.ts +3 -2
- package/dist/types/core/src/identityProofs.d.ts +10 -0
- package/dist/types/core/src/viewerGuard.d.ts +7 -4
- package/dist/{verify-DGJJAFTs.js → verify-CmN2lXY3.js} +2 -2
- package/dist/{verify-DGJJAFTs.js.map → verify-CmN2lXY3.js.map} +1 -1
- package/package.json +1 -1
- package/dist/bitcoinAddress-BIW3tpJG.js.map +0 -1
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { a as describeProvider, c as offeredIn, i as PROVIDER_PLATFORMS, l as providerDescriptorProblems, n as PROVIDER_ID, o as isNothingSpentError, r as PROVIDER_NETWORKS, s as networkMode, t as NothingSpentError, u as redact } from "./types-DbgC491n.js";
|
|
2
|
-
import { i as verifyIdentity, n as boundedIdentityFetch, r as descriptorProblems, t as availableSigners } from "./verify-
|
|
3
|
-
import { P as newIdentityBinding, f as IDENTITY_MAX_VALIDITY, j as identityStatement, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress } from "./bitcoinAddress-
|
|
4
|
-
import { i as TRANSPORTS } from "./pairedTransports-
|
|
2
|
+
import { i as verifyIdentity, n as boundedIdentityFetch, r as descriptorProblems, t as availableSigners } from "./verify-CmN2lXY3.js";
|
|
3
|
+
import { P as newIdentityBinding, f as IDENTITY_MAX_VALIDITY, j as identityStatement, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress } from "./bitcoinAddress-CDYL3yPz.js";
|
|
4
|
+
import { i as TRANSPORTS } from "./pairedTransports-CQGJfihi.js";
|
|
5
5
|
import { n as decodeBolt11 } from "./bolt11-CRiQrma3.js";
|
|
6
6
|
// ../browser/src/proofs/contract.ts
|
|
7
7
|
var IDENTITY_PLATFORMS = [
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../browser/src/proofs/contract.ts","../../browser/src/plugins/bundled.ts","../../browser/src/plugins/registry.ts"],"sourcesContent":["import type { IdentityDisplay, IdentityStatement, VerifiedIdentity } from \"@ghostly/core\";\n\n/**\n * The identity-proof provider contract. A provider is one way to prove control of an external\n * identity (a Nostr key, a domain, a Bitcoin address, an SSH or PGP key, an OpenID Connect account):\n * how the person produces evidence over the shared statement (`signers`), and how any Ghostly app\n * checks it (`verify`). Everything else — the statement bytes, the proof key, sharing per contact,\n * replay protection, storage, expiry, the UI — is shared. See PROOFS.md.\n */\n\n/**\n * Who vouches for the identity. The UI shows the difference:\n * - self-custodied: the person holds the key (Nostr, SSH, PGP, Bitcoin, a domain they control);\n * only they can have produced the evidence.\n * - provider-attested: a company signs that the person logged in to an account (OpenID Connect);\n * the evidence is only as trustworthy as that company.\n */\nexport type IdentityCategory = \"self-custodied\" | \"provider-attested\";\n/** Where Ghostly runs: the web app, the browser extension (engine in an offscreen document), the Tauri app. */\nexport type IdentityPlatform = \"web\" | \"extension\" | \"desktop\";\nexport const IDENTITY_PLATFORMS: readonly IdentityPlatform[] = [\"web\", \"extension\", \"desktop\"];\n\n/**\n * A bounded HTTPS GET through the engine: time-out, size cap (`maxBytes`, default 64 KiB), no credentials,\n * no referrer, refused offline. `redirect` defaults to \"error\": a record that redirects does not count\n * unless the provider says so. `text` is the body as UTF-8; `bytes` is the same body raw (binary\n * answers such as DNS-over-HTTPS `application/dns-message`).\n */\nexport interface IdentityFetchOptions {\n headers?: Record<string, string>; maxBytes?: number; signal?: AbortSignal; redirect?: \"follow\" | \"error\";\n /**\n * A read of one of the profile's own Pkarr relays (a did:dht): read as the chats read them, http:// and a private\n * address included, since the person chose them. Ignored for any other URL.\n */\n ownPkarrRelay?: boolean;\n}\nexport interface IdentityFetchResponse { status: number; contentType: string; text: string; bytes: Uint8Array }\nexport type IdentityFetch = (url: string, options?: IdentityFetchOptions) => Promise<IdentityFetchResponse>;\n\n/**\n * How a provider says a line it works out when it runs (a step naming the person's domain, a progress line) in the\n * app's language: `key` names the line within the provider, `english` is the line itself with `{{name}}` for each of\n * `values`. The UI reads a built-in provider's line under `identities.providers.<provider id>.<key>`, with `english`\n * when its language has none; a provider written outside the app (a plugin) always gets its `english` back, filled in.\n * Its fixed words (`label`, `summary`, a signer's `description`…) need no call: the UI reads them by the same rule,\n * under their own path (`subject.help`, `signers.<signer id>.label`, `signers.<signer id>.fields.<name>.help`).\n */\nexport type ProviderSay = (key: string, english: string, values?: Readonly<Record<string, string | number>>) => string;\n\n/** `english` with its `{{name}}`s filled in: what `ProviderSay` returns where no app language is at hand (the CLI, tests). */\nexport const englishSay: ProviderSay = (_key, english, values) =>\n values ? english.replace(/\\{\\{(\\w+)\\}\\}/g, (all, name: string) => (name in values ? String(values[name]) : all)) : english;\n\nexport interface VerifyContext {\n /** Seconds. Use this, never `Date.now()`, so tests and re-checks agree on time. */\n now: number;\n signal: AbortSignal;\n /** The only way `verify` may reach the network. Never call the global `fetch`. */\n fetch: IdentityFetch;\n}\n\nexport interface SubjectSpec {\n /** \"Public key\", \"Domain\", \"Bitcoin address\", \"Account\". */\n label: string;\n placeholder?: string;\n help?: string;\n /** Choices instead of a text field (an OpenID Connect provider's issuer). */\n options?: readonly { value: string; label: string }[];\n /** The canonical subject for what the person typed (or a signer returned). Throw a message they can act on. */\n normalize(input: string): string;\n /** Short form for badges and lists (\"npub1x…4f2\"). Defaults to the subject. */\n short?(subject: string): string;\n /**\n * What the (normalized) subject turns out to be, shown under the field before anything is signed: a DID's\n * method, its keys and its domain. Runs in the UI on the person's input; may reach the network (the\n * person's own identity). Throw a message they can act on.\n */\n preview?(subject: string, options: { signal: AbortSignal; say?: ProviderSay }): Promise<SubjectPreview>;\n}\n\nexport interface SubjectPreview {\n /** Short facts, in order: \"Method\" → \"did:web\", \"Keys\" → \"#key-1 (Ed25519)\". */\n facts: readonly { label: string; value: string }[];\n /** The ids of the signers that apply to this subject; every signer when omitted. */\n signers?: readonly string[];\n}\n\n/** A field an in-app signer needs (a NIP-46 connection link). `secret` values are never stored or logged. */\nexport interface SignerField {\n name: string;\n label: string;\n kind: \"text\" | \"secret\";\n placeholder?: string;\n help?: string;\n optional?: boolean;\n}\n\n/**\n * A request waiting for the person's approval elsewhere, in one of two ways (Pubky: Passport in a browser window, or\n * Ring by scanning a QR code). The UI shows both on one screen; whichever approves first wins. Its values are secrets\n * (the QR carries a relay key): never logged, never stored.\n */\nexport interface ApprovalRequest {\n /** The primary button. `run` is called synchronously from its click, so a popup it opens keeps the user activation. */\n open?: { label: string; description?: string; run(): void };\n /** A QR code for a phone app, with its caption. */\n qr?: { value: string; label: string };\n /** Short lines under the choices. */\n notes?: readonly string[];\n}\n\n/** A signer's own wait for the person's approval ended (Pubky's relay forgot the request): a time-out, not a failure. */\nexport class SignerTimeout extends Error {}\n\nexport interface SignerContext {\n values: Record<string, string>;\n signal: AbortSignal;\n /**\n * How long the caller waits for the approval (the CLI's --timeout): a signer with a wait of its own takes this one,\n * up to its `maxWaitMs`. Its own wait when absent (the app).\n */\n waitMs?: number;\n /** The signer asks the person to approve on a page (NIP-46 auth_url): the UI shows it as a link, never opens it itself. */\n onAuthUrl(url: string): void;\n onProgress(message: string): void;\n /** The signer waits for an approval elsewhere (`null`: it no longer does). The UI renders it; see `ApprovalRequest`. */\n onApproval?(request: ApprovalRequest | null): void;\n /** Says the signer's progress lines and approval words in the app's language; `englishSay` when absent. */\n say?: ProviderSay;\n}\n\nexport interface SignerSession<E> {\n /** The identity the signer controls, canonical (as `subject.normalize` returns it). */\n subject(): Promise<string>;\n sign(statement: IdentityStatement): Promise<E>;\n}\n\nexport interface InstructionStep {\n text: string;\n /** Shown in a copyable block (a command, a DNS record). */\n copy?: string;\n}\nexport interface SignerInstructions {\n steps: readonly InstructionStep[];\n /** external-tool: the field the output is pasted into. */\n paste?: { label: string; placeholder?: string; multiline?: boolean };\n}\n\ninterface SignerBase {\n /** Unique within the provider: \"nip07\", \"nip46\", \"ssh-keygen\". */\n id: string;\n label: string;\n description?: string;\n /** Defaults to the provider's. */\n platforms?: readonly IdentityPlatform[];\n /** False hides it (no NIP-07 extension in this window). Runs in the UI. */\n available?(): boolean;\n /** The button that starts it (\"Continue on your server\"). Default: \"Sign with <label>\" in-app, \"Continue\" otherwise. */\n action?: string;\n}\n\n/** Signs inside Ghostly through something the person already uses (NIP-07, NIP-46, a wallet API). */\nexport interface InAppSigner<E> extends SignerBase {\n kind: \"in-app\";\n fields?: readonly SignerField[];\n /** The longest it can wait for an approval, whatever `waitMs` says (Pubky: its relay keeps a request five minutes). */\n maxWaitMs?: number;\n /** Opens the signer, runs `work`, and always cleans up (closes connections, drops keys) before resolving. */\n run<T>(ctx: SignerContext, work: (session: SignerSession<E>) => Promise<T>): Promise<T>;\n}\n\n/** The person runs a tool (ssh-keygen, gpg, a Bitcoin wallet) on the statement and pastes the output back. */\nexport interface ExternalToolSigner<E> extends SignerBase {\n kind: \"external-tool\";\n /** `say`: the steps in the app's language (`englishSay` when absent). */\n instructions(statement: IdentityStatement, say?: ProviderSay): SignerInstructions;\n /** What was pasted, as evidence. Throw a message the person can act on (\"That is not an SSH signature\"). */\n parse(pasted: string, statement: IdentityStatement): E | Promise<E>;\n}\n\n/** A popup to the provider's login page (OpenID Connect); the subject comes out of `verify`. */\nexport interface RedirectSigner<E> extends SignerBase {\n kind: \"redirect\";\n start(statement: IdentityStatement, ctx: SignerContext): Promise<E>;\n}\n\n/** The person publishes something the verifier fetches (a DNS TXT record, a /.well-known file). */\nexport interface PublishSigner<E> extends SignerBase {\n kind: \"publish\";\n /** `say`: the steps in the app's language (`englishSay` when absent). */\n instructions(statement: IdentityStatement, say?: ProviderSay): SignerInstructions;\n /** Usually small or empty: the verifier looks the record up itself. */\n evidence(statement: IdentityStatement): E | Promise<E>;\n}\n\nexport type IdentitySigner<E> = InAppSigner<E> | ExternalToolSigner<E> | RedirectSigner<E> | PublishSigner<E>;\n\n/**\n * A provider module's export. Registering it is adding the module under `proofs/providers/` and ONE\n * line in `proofs/registry.ts`.\n */\nexport interface IdentityProofProvider<E = unknown> {\n /** Stable: it is in the statement, on the wire and in storage. `^[a-z][a-z0-9-]{0,31}$`. */\n id: string;\n label: string;\n category: IdentityCategory;\n /**\n * One short line for the picker card, how you make it: \"Sign once with your Nostr signer\". About 40\n * characters at most; the card shows nothing else beside the name and the category.\n */\n summary: string;\n /** The details view (opened from the card, shown again above the form): what is proven and how, a sentence or two. */\n description: string;\n /**\n * What the proof does NOT show, when a contact could easily assume more (\"Does not prove a balance, a past\n * payment, or that you would pay.\"). Shown with the description, never hidden behind a hover.\n */\n limits?: string;\n platforms: readonly IdentityPlatform[];\n subject: SubjectSpec;\n /** How long one proof may last. The person picks up to `maxDays` (never above 400). */\n validity: { defaultDays: number; maxDays: number };\n /**\n * When a verifier's check can go stale (the DNS record may be removed later): the contact's app offers\n * \"Check again\" after this many seconds and shows the last check time. Omit when the evidence is a\n * signature that stays valid until expiry. `perHour`: the most checks the app runs on its own in an hour, for a\n * server that limits lookups per IP (the rest wait for later); well under that limit, so a check a person starts\n * (a new contact's proof, \"Check again\") still gets an answer.\n */\n recheck?: { afterSeconds: number; perHour?: number };\n /** One sentence for people: what `verify` contacts and who learns what. \"Nothing: checked on this device.\" */\n privacy: string;\n /** Mark providers whose flows are not proven against real-world tools yet. */\n experimental?: boolean;\n /** Listed under \"Advanced\" in the picker, for people who know what it is (DIDs), so it does not crowd newcomers. */\n advanced?: boolean;\n signers: readonly IdentitySigner<E>[];\n /**\n * Untrusted evidence off the wire → typed evidence. Strict: exact shape, bounded sizes, no extra keys.\n * The serialized evidence is already capped at 16 KiB before this runs.\n */\n parseEvidence(raw: unknown): E;\n /**\n * Checks `evidence` against exactly `statement.bytes` / `statement.text` and returns what it proves.\n * Throws when it does not. Must:\n * - self-custodied: return `subject === statement.binding.subject`;\n * - provider-attested: return the attested subject and set `attester`;\n * - reach the network only through `ctx.fetch`, and use `ctx.now` for time.\n */\n verify(statement: IdentityStatement, evidence: E, ctx: VerifyContext): Promise<VerifiedIdentity>;\n /**\n * Optional public name/picture for a verified subject (Nostr kind-0). Called ONLY when the person asks,\n * never automatically. Sanitize like avatars: plain-text name, bounded raster re-encoded to a data URL.\n */\n lookupDisplay?(subject: string, options: { signal: AbortSignal }): Promise<IdentityDisplay | undefined>;\n /** The button that runs `lookupDisplay`. Default: \"Show public profile\". */\n lookupLabel?: string;\n /**\n * The verified subject as a URI a public DID document may list in `alsoKnownAs` (the profile's\n * did:dht, and only for identities the person chooses to list there). Omit when the identity has no\n * URI of its own. No comma: did:dht separates the list with commas.\n */\n publicUri?(subject: string): string | undefined;\n /**\n * Takes down what a signer published when the person removes the proof (an AT Protocol record, a Pubky proof file). Runs in\n * the UI, called synchronously from the confirming click (it may open a window first). The shared Pkarr\n * revocation is published either way; if this fails, the person may remove the proof without it.\n */\n unpublish?: {\n /** What the removal adds, for the confirmation: \"Also deletes the record on your server.\" */\n description: string;\n /** `evidence` is what `parseEvidence` accepted when the proof was made (Pubky: the proof file's folder). */\n run(proof: { id: string; subject: string; key: string; evidence: E }, ctx: SignerContext): Promise<void>;\n };\n}\n","import type { GhostlyAdapterPlugin } from \"./registry\";\n\n/**\n * The adapter plugins compiled into this build. Empty unless the build lists some: `GHOSTLY_PLUGINS`\n * names their modules (comma-separated paths from the repository root, each default-exporting a\n * `GhostlyAdapterPlugin`), and the Vite plugin in `packages/browser/vite-plugin.ts` swaps this module\n * for one that imports them. Release builds never set it; the e2e build carries the SDK example.\n */\nexport const BUNDLED_PLUGINS: readonly GhostlyAdapterPlugin[] = [];\n","import type { LightningProviderDescriptor } from \"../engine/paymentAdapters/providers/lightning\";\nimport type { OnchainProviderDescriptor } from \"../engine/paymentAdapters/providers/onchain\";\nimport { providerDescriptorProblems, type ProviderDescriptor, type ProviderKind } from \"../engine/paymentAdapters/providers/types\";\nimport type { IdentityProofProvider } from \"../proofs/contract\";\nimport { descriptorProblems } from \"../proofs/verify\";\nimport { BUNDLED_PLUGINS } from \"./bundled\";\n\n/**\n * Adapters written outside the app: wallet sources (Lightning, on-chain) and identity-proof providers\n * that register here instead of being added to the built-in lists. A plugin is a plain object naming\n * its adapters; the registries (`providers/registry.ts`, `proofs/registry.ts`) list what is registered\n * after the built-ins and before the test fakes, and the same platform and mode rules apply to all.\n *\n * Two ways in:\n * - at build time: `GHOSTLY_PLUGINS` lists the modules and `bundled.ts` is swapped for them;\n * - at run time: code already running in the engine's realm calls `registerAdapters` before the\n * pickers are shown (or after: the engine re-reads the lists when something registers).\n *\n * Trust: a plugin runs with the app's privileges, in the app's own JavaScript realm. There is no\n * sandbox, no permission prompt and no store; whoever builds a plugin in, or loads one, trusts its\n * author with everything the app can do, keys and sats included. A manifest with permissions and an\n * isolated runtime are a later phase (docs/wisps/ADAPTER-ROADMAP.md, \"Plugins, apps, catalogs\").\n *\n * The state lives on `globalThis` under a well-known symbol, so a plugin bundled with its own copy of\n * the SDK (a second copy of this module) still registers into the same lists the app reads.\n */\n\n/** The generation of the adapter contracts. A plugin says which one it was written against. */\nexport const SDK_API = 1;\nexport const PLUGIN_ID = /^[a-z][a-z0-9-]{0,63}$/;\n\nexport interface GhostlyAdapterPlugin {\n /** Stable, unique among plugins: `^[a-z][a-z0-9-]{0,63}$`. */\n id: string;\n /** The plugin's own version, for people. */\n version?: string;\n /** The contract generation it was written against: `SDK_API`. Another one is refused. */\n sdk: number;\n lightning?: readonly LightningProviderDescriptor[];\n onchain?: readonly OnchainProviderDescriptor[];\n identities?: readonly IdentityProofProvider[];\n}\n\nexport type AdapterKind = ProviderKind | \"identity\";\n\ninterface Store {\n plugins: Map<string, GhostlyAdapterPlugin>;\n /** Ids the built-in registries own, per kind: a plugin cannot take one. */\n reserved: Record<AdapterKind, Set<string>>;\n listeners: Set<() => void>;\n seeded: boolean;\n}\n\nconst KEY = Symbol.for(\"ghostly.adapters/1\");\nfunction store(): Store {\n const g = globalThis as unknown as Record<symbol, Store | undefined>;\n return (g[KEY] ??= { plugins: new Map(), reserved: { lightning: new Set(), onchain: new Set(), identity: new Set() }, listeners: new Set(), seeded: false });\n}\n\nconst ids = (kind: AdapterKind, plugin: GhostlyAdapterPlugin): string[] => {\n // Not trusted to be well formed: pluginProblems reads it before saying what is wrong with it.\n const list: unknown = kind === \"identity\" ? plugin.identities : kind === \"lightning\" ? plugin.lightning : plugin.onchain;\n return Array.isArray(list) ? list.map((a: { id?: string } | null) => a?.id as string) : [];\n};\nconst KINDS: readonly AdapterKind[] = [\"lightning\", \"onchain\", \"identity\"];\n\n/** Problems with a plugin, empty when it can be registered. Does not look at what is already registered. */\nexport function pluginProblems(plugin: GhostlyAdapterPlugin): string[] {\n const problems: string[] = [];\n if (!plugin || typeof plugin !== \"object\") return [\"not a plugin object\"];\n if (!PLUGIN_ID.test(plugin.id ?? \"\")) problems.push(\"plugin id must match ^[a-z][a-z0-9-]{0,63}$\");\n if (plugin.sdk !== SDK_API) problems.push(`plugin was written for SDK API ${String(plugin.sdk)}; this app speaks ${SDK_API}`);\n if (plugin.version !== undefined && (typeof plugin.version !== \"string\" || plugin.version.length > 64)) problems.push(\"version must be a short string\");\n for (const kind of [\"lightning\", \"onchain\"] as const) {\n const list = plugin[kind];\n if (list === undefined) continue;\n if (!Array.isArray(list)) { problems.push(`${kind} must be a list of descriptors`); continue; }\n for (const d of list as ProviderDescriptor<unknown>[]) {\n if (!d || typeof d !== \"object\") { problems.push(`${kind} ${String(d)}: not a descriptor`); continue; }\n const own = providerDescriptorProblems(d);\n if (d?.kind && d.kind !== kind) own.push(`is listed under ${kind} but says kind ${String(d.kind)}`);\n problems.push(...own.map((p) => `${kind} ${String(d?.id)}: ${p}`));\n }\n }\n if (plugin.identities !== undefined) {\n if (!Array.isArray(plugin.identities)) problems.push(\"identities must be a list of providers\");\n else for (const p of plugin.identities) {\n if (!p || typeof p !== \"object\") problems.push(`identity ${String(p)}: not a provider`);\n else problems.push(...descriptorProblems(p).map((m) => `identity ${String(p.id)}: ${m}`));\n }\n }\n for (const kind of KINDS) {\n const list = ids(kind, plugin);\n if (new Set(list).size !== list.length) problems.push(`${kind} ids are not unique within the plugin`);\n }\n if (!KINDS.some((kind) => ids(kind, plugin).length)) problems.push(\"the plugin brings no adapter\");\n return problems;\n}\n\n/** The built-in registries say which ids are theirs. A plugin using one is refused. */\nexport function reserveAdapterIds(kind: AdapterKind, list: readonly string[]): void {\n const s = store();\n for (const id of list) s.reserved[kind].add(id);\n}\n\n/**\n * Registers a plugin's adapters. Throws, registering nothing, when the plugin is malformed, its id or\n * one of its adapters' ids is taken (by a built-in or by another plugin), or its contract generation\n * is another one. Returns the function that unregisters it.\n */\nexport function registerAdapters(plugin: GhostlyAdapterPlugin): () => void {\n const problems = pluginProblems(plugin);\n const s = store();\n if (!problems.length) {\n if (s.plugins.has(plugin.id)) problems.push(`a plugin with id ${plugin.id} is already registered`);\n for (const kind of KINDS) for (const id of ids(kind, plugin)) {\n if (s.reserved[kind].has(id)) problems.push(`${kind} ${id} is a built-in of this app`);\n for (const other of s.plugins.values()) if (ids(kind, other).includes(id)) problems.push(`${kind} ${id} is already registered by plugin ${other.id}`);\n }\n }\n if (problems.length) throw new Error(`Cannot register plugin ${String(plugin?.id)}: ${problems.join(\"; \")}`);\n s.plugins.set(plugin.id, plugin);\n notify(s);\n return () => { if (s.plugins.get(plugin.id) === plugin) { s.plugins.delete(plugin.id); notify(s); } };\n}\n\nfunction notify(s: Store) { for (const listener of s.listeners) { try { listener(); } catch { /* a listener's problem */ } } }\n\n/** Called when a plugin registers or unregisters: the engine re-reads the lists. */\nexport function onAdaptersChanged(listener: () => void): () => void {\n const s = store();\n s.listeners.add(listener);\n return () => { s.listeners.delete(listener); };\n}\n\n/** Every registered plugin, in registration order (bundled ones first). */\nexport function registeredPlugins(): readonly GhostlyAdapterPlugin[] { seed(); return [...store().plugins.values()]; }\nexport function registeredLightningProviders(): readonly LightningProviderDescriptor[] { return registeredPlugins().flatMap((p) => p.lightning ?? []); }\nexport function registeredOnchainProviders(): readonly OnchainProviderDescriptor[] { return registeredPlugins().flatMap((p) => p.onchain ?? []); }\nexport function registeredIdentityProviders(): readonly IdentityProofProvider[] { return registeredPlugins().flatMap((p) => p.identities ?? []); }\n\n/**\n * The plugins compiled into this build register once, when they are first asked for. A broken one is\n * reported and skipped rather than taking the app down with it; the e2e that expects it fails instead.\n */\nfunction seed() {\n const s = store();\n if (s.seeded) return;\n s.seeded = true;\n for (const plugin of BUNDLED_PLUGINS) {\n try { registerAdapters(plugin); }\n catch (error) { console.error(`[ghostly] a bundled adapter plugin was not loaded: ${error instanceof Error ? error.message : String(error)}`); }\n }\n}\n\n/** Tests only: forget every registration, including the bundled ones. */\nexport function resetAdapterRegistry(): void {\n const s = store();\n s.plugins.clear(); s.seeded = false;\n for (const kind of KINDS) s.reserved[kind].clear();\n notify(s);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../../browser/src/proofs/contract.ts","../../browser/src/plugins/bundled.ts","../../browser/src/plugins/registry.ts"],"sourcesContent":["import type { IdentityDisplay, IdentityStatement, VerifiedIdentity } from \"@ghostly/core\";\n\n/**\n * The identity-proof provider contract. A provider is one way to prove control of an external\n * identity (a Nostr key, a domain, a Bitcoin address, an SSH or PGP key, an OpenID Connect account):\n * how the person produces evidence over the shared statement (`signers`), and how any Ghostly app\n * checks it (`verify`). Everything else — the statement bytes, the proof key, sharing per contact,\n * replay protection, storage, expiry, the UI — is shared. See PROOFS.md.\n */\n\n/**\n * Who vouches for the identity. The UI shows the difference:\n * - self-custodied: the person holds the key (Nostr, SSH, PGP, Bitcoin, a domain they control);\n * only they can have produced the evidence.\n * - provider-attested: a company signs that the person logged in to an account (OpenID Connect);\n * the evidence is only as trustworthy as that company.\n */\nexport type IdentityCategory = \"self-custodied\" | \"provider-attested\";\n/** Where Ghostly runs: the web app, the browser extension (engine in an offscreen document), the Tauri app. */\nexport type IdentityPlatform = \"web\" | \"extension\" | \"desktop\";\nexport const IDENTITY_PLATFORMS: readonly IdentityPlatform[] = [\"web\", \"extension\", \"desktop\"];\n\n/**\n * A bounded HTTPS GET through the engine: time-out, size cap (`maxBytes`, default 64 KiB), no credentials,\n * no referrer, refused offline. `redirect` defaults to \"error\": a record that redirects does not count\n * unless the provider says so. `text` is the body as UTF-8; `bytes` is the same body raw (binary\n * answers such as DNS-over-HTTPS `application/dns-message`).\n */\nexport interface IdentityFetchOptions {\n headers?: Record<string, string>; maxBytes?: number; signal?: AbortSignal; redirect?: \"follow\" | \"error\";\n /**\n * A read of one of the profile's own Pkarr relays (a did:dht): read as the chats read them, http:// and a private\n * address included, since the person chose them. Ignored for any other URL.\n */\n ownPkarrRelay?: boolean;\n}\nexport interface IdentityFetchResponse { status: number; contentType: string; text: string; bytes: Uint8Array }\nexport type IdentityFetch = (url: string, options?: IdentityFetchOptions) => Promise<IdentityFetchResponse>;\n\n/**\n * How a provider says a line it works out when it runs (a step naming the person's domain, a progress line) in the\n * app's language: `key` names the line within the provider, `english` is the line itself with `{{name}}` for each of\n * `values`. The UI reads a built-in provider's line under `identities.providers.<provider id>.<key>`, with `english`\n * when its language has none; a provider written outside the app (a plugin) always gets its `english` back, filled in.\n * Its fixed words (`label`, `summary`, a signer's `description`…) need no call: the UI reads them by the same rule,\n * under their own path (`subject.help`, `signers.<signer id>.label`, `signers.<signer id>.fields.<name>.help`).\n */\nexport type ProviderSay = (key: string, english: string, values?: Readonly<Record<string, string | number>>) => string;\n\n/** `english` with its `{{name}}`s filled in: what `ProviderSay` returns where no app language is at hand (the CLI, tests). */\nexport const englishSay: ProviderSay = (_key, english, values) =>\n values ? english.replace(/\\{\\{(\\w+)\\}\\}/g, (all, name: string) => (name in values ? String(values[name]) : all)) : english;\n\nexport interface VerifyContext {\n /** Seconds. Use this, never `Date.now()`, so tests and re-checks agree on time. */\n now: number;\n signal: AbortSignal;\n /** The only way `verify` may reach the network. Never call the global `fetch`. */\n fetch: IdentityFetch;\n}\n\nexport interface SubjectSpec {\n /** \"Public key\", \"Domain\", \"Bitcoin address\", \"Account\". */\n label: string;\n placeholder?: string;\n help?: string;\n /** Choices instead of a text field (an OpenID Connect provider's issuer). */\n options?: readonly { value: string; label: string }[];\n /** The canonical subject for what the person typed (or a signer returned). Throw a message they can act on. */\n normalize(input: string): string;\n /** Short form for badges and lists (\"npub1x…4f2\"). Defaults to the subject. */\n short?(subject: string): string;\n /**\n * What the (normalized) subject turns out to be, shown under the field before anything is signed: a DID's\n * method, its keys and its domain. Runs in the UI on the person's input; may reach the network (the\n * person's own identity). Throw a message they can act on.\n */\n preview?(subject: string, options: { signal: AbortSignal; say?: ProviderSay }): Promise<SubjectPreview>;\n}\n\nexport interface SubjectPreview {\n /** Short facts, in order: \"Method\" → \"did:web\", \"Keys\" → \"#key-1 (Ed25519)\". */\n facts: readonly { label: string; value: string; /** A machine token (a host, URL, key id), not a sentence: shown left to right in any language. */ code?: true }[];\n /** The ids of the signers that apply to this subject; every signer when omitted. */\n signers?: readonly string[];\n}\n\n/** A field an in-app signer needs (a NIP-46 connection link). `secret` values are never stored or logged. */\nexport interface SignerField {\n name: string;\n label: string;\n kind: \"text\" | \"secret\";\n placeholder?: string;\n help?: string;\n optional?: boolean;\n}\n\n/**\n * A request waiting for the person's approval elsewhere, in one of two ways (Pubky: Passport in a browser window, or\n * Ring by scanning a QR code). The UI shows both on one screen; whichever approves first wins. Its values are secrets\n * (the QR carries a relay key): never logged, never stored.\n */\nexport interface ApprovalRequest {\n /** The primary button. `run` is called synchronously from its click, so a popup it opens keeps the user activation. */\n open?: { label: string; description?: string; run(): void };\n /** A QR code for a phone app, with its caption. */\n qr?: { value: string; label: string };\n /** Short lines under the choices. */\n notes?: readonly string[];\n}\n\n/** A signer's own wait for the person's approval ended (Pubky's relay forgot the request): a time-out, not a failure. */\nexport class SignerTimeout extends Error {}\n\nexport interface SignerContext {\n values: Record<string, string>;\n signal: AbortSignal;\n /**\n * How long the caller waits for the approval (the CLI's --timeout): a signer with a wait of its own takes this one,\n * up to its `maxWaitMs`. Its own wait when absent (the app).\n */\n waitMs?: number;\n /** The signer asks the person to approve on a page (NIP-46 auth_url): the UI shows it as a link, never opens it itself. */\n onAuthUrl(url: string): void;\n onProgress(message: string): void;\n /** The signer waits for an approval elsewhere (`null`: it no longer does). The UI renders it; see `ApprovalRequest`. */\n onApproval?(request: ApprovalRequest | null): void;\n /** Says the signer's progress lines and approval words in the app's language; `englishSay` when absent. */\n say?: ProviderSay;\n}\n\nexport interface SignerSession<E> {\n /** The identity the signer controls, canonical (as `subject.normalize` returns it). */\n subject(): Promise<string>;\n sign(statement: IdentityStatement): Promise<E>;\n}\n\nexport interface InstructionStep {\n text: string;\n /** Shown in a copyable block (a command, a DNS record). */\n copy?: string;\n}\nexport interface SignerInstructions {\n steps: readonly InstructionStep[];\n /** external-tool: the field the output is pasted into. */\n paste?: { label: string; placeholder?: string; multiline?: boolean };\n}\n\ninterface SignerBase {\n /** Unique within the provider: \"nip07\", \"nip46\", \"ssh-keygen\". */\n id: string;\n label: string;\n description?: string;\n /** Defaults to the provider's. */\n platforms?: readonly IdentityPlatform[];\n /** False hides it (no NIP-07 extension in this window). Runs in the UI. */\n available?(): boolean;\n /** The button that starts it (\"Continue on your server\"). Default: \"Sign with <label>\" in-app, \"Continue\" otherwise. */\n action?: string;\n}\n\n/** Signs inside Ghostly through something the person already uses (NIP-07, NIP-46, a wallet API). */\nexport interface InAppSigner<E> extends SignerBase {\n kind: \"in-app\";\n fields?: readonly SignerField[];\n /** The longest it can wait for an approval, whatever `waitMs` says (Pubky: its relay keeps a request five minutes). */\n maxWaitMs?: number;\n /** Opens the signer, runs `work`, and always cleans up (closes connections, drops keys) before resolving. */\n run<T>(ctx: SignerContext, work: (session: SignerSession<E>) => Promise<T>): Promise<T>;\n}\n\n/** The person runs a tool (ssh-keygen, gpg, a Bitcoin wallet) on the statement and pastes the output back. */\nexport interface ExternalToolSigner<E> extends SignerBase {\n kind: \"external-tool\";\n /** `say`: the steps in the app's language (`englishSay` when absent). */\n instructions(statement: IdentityStatement, say?: ProviderSay): SignerInstructions;\n /** What was pasted, as evidence. Throw a message the person can act on (\"That is not an SSH signature\"). */\n parse(pasted: string, statement: IdentityStatement): E | Promise<E>;\n}\n\n/** A popup to the provider's login page (OpenID Connect); the subject comes out of `verify`. */\nexport interface RedirectSigner<E> extends SignerBase {\n kind: \"redirect\";\n start(statement: IdentityStatement, ctx: SignerContext): Promise<E>;\n}\n\n/** The person publishes something the verifier fetches (a DNS TXT record, a /.well-known file). */\nexport interface PublishSigner<E> extends SignerBase {\n kind: \"publish\";\n /** `say`: the steps in the app's language (`englishSay` when absent). */\n instructions(statement: IdentityStatement, say?: ProviderSay): SignerInstructions;\n /** Usually small or empty: the verifier looks the record up itself. */\n evidence(statement: IdentityStatement): E | Promise<E>;\n}\n\nexport type IdentitySigner<E> = InAppSigner<E> | ExternalToolSigner<E> | RedirectSigner<E> | PublishSigner<E>;\n\n/**\n * A provider module's export. Registering it is adding the module under `proofs/providers/` and ONE\n * line in `proofs/registry.ts`.\n */\nexport interface IdentityProofProvider<E = unknown> {\n /** Stable: it is in the statement, on the wire and in storage. `^[a-z][a-z0-9-]{0,31}$`. */\n id: string;\n label: string;\n category: IdentityCategory;\n /**\n * One short line for the picker card, how you make it: \"Sign once with your Nostr signer\". About 40\n * characters at most; the card shows nothing else beside the name and the category.\n */\n summary: string;\n /** The details view (opened from the card, shown again above the form): what is proven and how, a sentence or two. */\n description: string;\n /**\n * What the proof does NOT show, when a contact could easily assume more (\"Does not prove a balance, a past\n * payment, or that you would pay.\"). Shown with the description, never hidden behind a hover.\n */\n limits?: string;\n platforms: readonly IdentityPlatform[];\n subject: SubjectSpec;\n /** How long one proof may last. The person picks up to `maxDays` (never above 400). */\n validity: { defaultDays: number; maxDays: number };\n /**\n * When a verifier's check can go stale (the DNS record may be removed later): the contact's app offers\n * \"Check again\" after this many seconds and shows the last check time. Omit when the evidence is a\n * signature that stays valid until expiry. `perHour`: the most checks the app runs on its own in an hour, for a\n * server that limits lookups per IP (the rest wait for later); well under that limit, so a check a person starts\n * (a new contact's proof, \"Check again\") still gets an answer.\n */\n recheck?: { afterSeconds: number; perHour?: number };\n /** One sentence for people: what `verify` contacts and who learns what. \"Nothing: checked on this device.\" */\n privacy: string;\n /** Mark providers whose flows are not proven against real-world tools yet. */\n experimental?: boolean;\n /** Listed under \"Advanced\" in the picker, for people who know what it is (DIDs), so it does not crowd newcomers. */\n advanced?: boolean;\n signers: readonly IdentitySigner<E>[];\n /**\n * Untrusted evidence off the wire → typed evidence. Strict: exact shape, bounded sizes, no extra keys.\n * The serialized evidence is already capped at 16 KiB before this runs.\n */\n parseEvidence(raw: unknown): E;\n /**\n * Checks `evidence` against exactly `statement.bytes` / `statement.text` and returns what it proves.\n * Throws when it does not. Must:\n * - self-custodied: return `subject === statement.binding.subject`;\n * - provider-attested: return the attested subject and set `attester`;\n * - reach the network only through `ctx.fetch`, and use `ctx.now` for time.\n */\n verify(statement: IdentityStatement, evidence: E, ctx: VerifyContext): Promise<VerifiedIdentity>;\n /**\n * Optional public name/picture for a verified subject (Nostr kind-0). Called ONLY when the person asks,\n * never automatically. Sanitize like avatars: plain-text name, bounded raster re-encoded to a data URL.\n */\n lookupDisplay?(subject: string, options: { signal: AbortSignal }): Promise<IdentityDisplay | undefined>;\n /** The button that runs `lookupDisplay`. Default: \"Show public profile\". */\n lookupLabel?: string;\n /**\n * The verified subject as a URI a public DID document may list in `alsoKnownAs` (the profile's\n * did:dht, and only for identities the person chooses to list there). Omit when the identity has no\n * URI of its own. No comma: did:dht separates the list with commas.\n */\n publicUri?(subject: string): string | undefined;\n /**\n * Takes down what a signer published when the person removes the proof (an AT Protocol record, a Pubky proof file). Runs in\n * the UI, called synchronously from the confirming click (it may open a window first). The shared Pkarr\n * revocation is published either way; if this fails, the person may remove the proof without it.\n */\n unpublish?: {\n /** What the removal adds, for the confirmation: \"Also deletes the record on your server.\" */\n description: string;\n /** `evidence` is what `parseEvidence` accepted when the proof was made (Pubky: the proof file's folder). */\n run(proof: { id: string; subject: string; key: string; evidence: E }, ctx: SignerContext): Promise<void>;\n };\n}\n","import type { GhostlyAdapterPlugin } from \"./registry\";\n\n/**\n * The adapter plugins compiled into this build. Empty unless the build lists some: `GHOSTLY_PLUGINS`\n * names their modules (comma-separated paths from the repository root, each default-exporting a\n * `GhostlyAdapterPlugin`), and the Vite plugin in `packages/browser/vite-plugin.ts` swaps this module\n * for one that imports them. Release builds never set it; the e2e build carries the SDK example.\n */\nexport const BUNDLED_PLUGINS: readonly GhostlyAdapterPlugin[] = [];\n","import type { LightningProviderDescriptor } from \"../engine/paymentAdapters/providers/lightning\";\nimport type { OnchainProviderDescriptor } from \"../engine/paymentAdapters/providers/onchain\";\nimport { providerDescriptorProblems, type ProviderDescriptor, type ProviderKind } from \"../engine/paymentAdapters/providers/types\";\nimport type { IdentityProofProvider } from \"../proofs/contract\";\nimport { descriptorProblems } from \"../proofs/verify\";\nimport { BUNDLED_PLUGINS } from \"./bundled\";\n\n/**\n * Adapters written outside the app: wallet sources (Lightning, on-chain) and identity-proof providers\n * that register here instead of being added to the built-in lists. A plugin is a plain object naming\n * its adapters; the registries (`providers/registry.ts`, `proofs/registry.ts`) list what is registered\n * after the built-ins and before the test fakes, and the same platform and mode rules apply to all.\n *\n * Two ways in:\n * - at build time: `GHOSTLY_PLUGINS` lists the modules and `bundled.ts` is swapped for them;\n * - at run time: code already running in the engine's realm calls `registerAdapters` before the\n * pickers are shown (or after: the engine re-reads the lists when something registers).\n *\n * Trust: a plugin runs with the app's privileges, in the app's own JavaScript realm. There is no\n * sandbox, no permission prompt and no store; whoever builds a plugin in, or loads one, trusts its\n * author with everything the app can do, keys and sats included. A manifest with permissions and an\n * isolated runtime are a later phase (docs/wisps/ADAPTER-ROADMAP.md, \"Plugins, apps, catalogs\").\n *\n * The state lives on `globalThis` under a well-known symbol, so a plugin bundled with its own copy of\n * the SDK (a second copy of this module) still registers into the same lists the app reads.\n */\n\n/** The generation of the adapter contracts. A plugin says which one it was written against. */\nexport const SDK_API = 1;\nexport const PLUGIN_ID = /^[a-z][a-z0-9-]{0,63}$/;\n\nexport interface GhostlyAdapterPlugin {\n /** Stable, unique among plugins: `^[a-z][a-z0-9-]{0,63}$`. */\n id: string;\n /** The plugin's own version, for people. */\n version?: string;\n /** The contract generation it was written against: `SDK_API`. Another one is refused. */\n sdk: number;\n lightning?: readonly LightningProviderDescriptor[];\n onchain?: readonly OnchainProviderDescriptor[];\n identities?: readonly IdentityProofProvider[];\n}\n\nexport type AdapterKind = ProviderKind | \"identity\";\n\ninterface Store {\n plugins: Map<string, GhostlyAdapterPlugin>;\n /** Ids the built-in registries own, per kind: a plugin cannot take one. */\n reserved: Record<AdapterKind, Set<string>>;\n listeners: Set<() => void>;\n seeded: boolean;\n}\n\nconst KEY = Symbol.for(\"ghostly.adapters/1\");\nfunction store(): Store {\n const g = globalThis as unknown as Record<symbol, Store | undefined>;\n return (g[KEY] ??= { plugins: new Map(), reserved: { lightning: new Set(), onchain: new Set(), identity: new Set() }, listeners: new Set(), seeded: false });\n}\n\nconst ids = (kind: AdapterKind, plugin: GhostlyAdapterPlugin): string[] => {\n // Not trusted to be well formed: pluginProblems reads it before saying what is wrong with it.\n const list: unknown = kind === \"identity\" ? plugin.identities : kind === \"lightning\" ? plugin.lightning : plugin.onchain;\n return Array.isArray(list) ? list.map((a: { id?: string } | null) => a?.id as string) : [];\n};\nconst KINDS: readonly AdapterKind[] = [\"lightning\", \"onchain\", \"identity\"];\n\n/** Problems with a plugin, empty when it can be registered. Does not look at what is already registered. */\nexport function pluginProblems(plugin: GhostlyAdapterPlugin): string[] {\n const problems: string[] = [];\n if (!plugin || typeof plugin !== \"object\") return [\"not a plugin object\"];\n if (!PLUGIN_ID.test(plugin.id ?? \"\")) problems.push(\"plugin id must match ^[a-z][a-z0-9-]{0,63}$\");\n if (plugin.sdk !== SDK_API) problems.push(`plugin was written for SDK API ${String(plugin.sdk)}; this app speaks ${SDK_API}`);\n if (plugin.version !== undefined && (typeof plugin.version !== \"string\" || plugin.version.length > 64)) problems.push(\"version must be a short string\");\n for (const kind of [\"lightning\", \"onchain\"] as const) {\n const list = plugin[kind];\n if (list === undefined) continue;\n if (!Array.isArray(list)) { problems.push(`${kind} must be a list of descriptors`); continue; }\n for (const d of list as ProviderDescriptor<unknown>[]) {\n if (!d || typeof d !== \"object\") { problems.push(`${kind} ${String(d)}: not a descriptor`); continue; }\n const own = providerDescriptorProblems(d);\n if (d?.kind && d.kind !== kind) own.push(`is listed under ${kind} but says kind ${String(d.kind)}`);\n problems.push(...own.map((p) => `${kind} ${String(d?.id)}: ${p}`));\n }\n }\n if (plugin.identities !== undefined) {\n if (!Array.isArray(plugin.identities)) problems.push(\"identities must be a list of providers\");\n else for (const p of plugin.identities) {\n if (!p || typeof p !== \"object\") problems.push(`identity ${String(p)}: not a provider`);\n else problems.push(...descriptorProblems(p).map((m) => `identity ${String(p.id)}: ${m}`));\n }\n }\n for (const kind of KINDS) {\n const list = ids(kind, plugin);\n if (new Set(list).size !== list.length) problems.push(`${kind} ids are not unique within the plugin`);\n }\n if (!KINDS.some((kind) => ids(kind, plugin).length)) problems.push(\"the plugin brings no adapter\");\n return problems;\n}\n\n/** The built-in registries say which ids are theirs. A plugin using one is refused. */\nexport function reserveAdapterIds(kind: AdapterKind, list: readonly string[]): void {\n const s = store();\n for (const id of list) s.reserved[kind].add(id);\n}\n\n/**\n * Registers a plugin's adapters. Throws, registering nothing, when the plugin is malformed, its id or\n * one of its adapters' ids is taken (by a built-in or by another plugin), or its contract generation\n * is another one. Returns the function that unregisters it.\n */\nexport function registerAdapters(plugin: GhostlyAdapterPlugin): () => void {\n const problems = pluginProblems(plugin);\n const s = store();\n if (!problems.length) {\n if (s.plugins.has(plugin.id)) problems.push(`a plugin with id ${plugin.id} is already registered`);\n for (const kind of KINDS) for (const id of ids(kind, plugin)) {\n if (s.reserved[kind].has(id)) problems.push(`${kind} ${id} is a built-in of this app`);\n for (const other of s.plugins.values()) if (ids(kind, other).includes(id)) problems.push(`${kind} ${id} is already registered by plugin ${other.id}`);\n }\n }\n if (problems.length) throw new Error(`Cannot register plugin ${String(plugin?.id)}: ${problems.join(\"; \")}`);\n s.plugins.set(plugin.id, plugin);\n notify(s);\n return () => { if (s.plugins.get(plugin.id) === plugin) { s.plugins.delete(plugin.id); notify(s); } };\n}\n\nfunction notify(s: Store) { for (const listener of s.listeners) { try { listener(); } catch { /* a listener's problem */ } } }\n\n/** Called when a plugin registers or unregisters: the engine re-reads the lists. */\nexport function onAdaptersChanged(listener: () => void): () => void {\n const s = store();\n s.listeners.add(listener);\n return () => { s.listeners.delete(listener); };\n}\n\n/** Every registered plugin, in registration order (bundled ones first). */\nexport function registeredPlugins(): readonly GhostlyAdapterPlugin[] { seed(); return [...store().plugins.values()]; }\nexport function registeredLightningProviders(): readonly LightningProviderDescriptor[] { return registeredPlugins().flatMap((p) => p.lightning ?? []); }\nexport function registeredOnchainProviders(): readonly OnchainProviderDescriptor[] { return registeredPlugins().flatMap((p) => p.onchain ?? []); }\nexport function registeredIdentityProviders(): readonly IdentityProofProvider[] { return registeredPlugins().flatMap((p) => p.identities ?? []); }\n\n/**\n * The plugins compiled into this build register once, when they are first asked for. A broken one is\n * reported and skipped rather than taking the app down with it; the e2e that expects it fails instead.\n */\nfunction seed() {\n const s = store();\n if (s.seeded) return;\n s.seeded = true;\n for (const plugin of BUNDLED_PLUGINS) {\n try { registerAdapters(plugin); }\n catch (error) { console.error(`[ghostly] a bundled adapter plugin was not loaded: ${error instanceof Error ? error.message : String(error)}`); }\n }\n}\n\n/** Tests only: forget every registration, including the bundled ones. */\nexport function resetAdapterRegistry(): void {\n const s = store();\n s.plugins.clear(); s.seeded = false;\n for (const kind of KINDS) s.reserved[kind].clear();\n notify(s);\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { a as concatBytes, c as fromZ32, d as toBase64, f as toBase64Url, h as utf8Encode, m as utf8Decode, o as fromBase64, p as toZ32, s as fromBase64Url, u as randomBytes } from "./bolt11-CRiQrma3.js";
|
|
2
|
-
import { Kt as measureRecords, cn as publicKeyFromZ32, dn as verify, on as identityFromSeed, sn as identityFromSeedB64, un as sign } from "./bitcoinAddress-
|
|
2
|
+
import { Kt as measureRecords, cn as publicKeyFromZ32, dn as verify, on as identityFromSeed, sn as identityFromSeedB64, un as sign } from "./bitcoinAddress-CDYL3yPz.js";
|
|
3
3
|
import { xsalsa20poly1305 } from "@noble/ciphers/salsa.js";
|
|
4
4
|
import { ed25519, x25519 } from "@noble/curves/ed25519.js";
|
|
5
5
|
import { sha256 } from "@noble/hashes/sha2.js";
|
|
@@ -870,4 +870,4 @@ function transportOrder(available, preferred, fallback) {
|
|
|
870
870
|
}
|
|
871
871
|
export { NIP05_PATH as A, parseDomainTxt as B, underLocalSuffix as C, DOMAIN_MAX_RECORDS as D, DOMAIN_FILE_MAX_BYTES as E, domainWellKnownFile as F, validDomainRecord as G, recordsFromWellKnown as H, encodeDnsQuery as I, encrypt as J, wellKnownUrl as K, isPublicAddress as L, decodeDnsResponse as M, dnsProofName as N, DOMAIN_METHODS as O, domainTxtRecord as P, nip05RootKey as R, readManifest as S, DNS_TYPE as T, recordsName as U, recordsFromTxt as V, txtValue as W, sealedLength as X, generateEncryptionKey as Y, tryDecrypt as Z, HOLD_LIMITS as _, automaticTransport as a, isHoldUrl as b, irohDescriptor as c, relayUrl as d, relayUrlTooLong as f, HOLD_DATED_BACK_MS as g, HOLD_CAPABILITY as h, TRANSPORTS as i, WELL_KNOWN_PATH as j, DOMAIN_TXT_MAX_BYTES as k, irohRelayUrl as l, transportOrder as m, RELAY_URL as n, checkedDescriptors as o, relayedTransports as p, decrypt as q, RELAY_WITH_SECRETS as r, dialableIrohRelay as s, AUTOMATIC_ORDER as t, rankTransports as u, HoldKeys as v, DNS_LABEL as w, newMailbox as x, HoldRefusedError as y, normalizeDomain as z };
|
|
872
872
|
|
|
873
|
-
//# sourceMappingURL=pairedTransports-
|
|
873
|
+
//# sourceMappingURL=pairedTransports-CQGJfihi.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pairedTransports-BcTRg3tp.js","names":[],"sources":["../../core/src/crypto.ts","../../core/src/domainProofs.ts","../../core/src/localNames.ts","../../core/src/storeForward.ts","../../core/src/pairedTransports.ts"],"sourcesContent":["import { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { concatBytes, fromBase64, randomBytes, toBase64, utf8Decode, utf8Encode } from \"./bytes\";\n\nconst NONCE_LENGTH = 24;\nconst KEY_LENGTH = 32;\n\nexport function generateEncryptionKey(): Uint8Array {\n return randomBytes(KEY_LENGTH);\n}\n\n/**\n * NaCl secretbox (XSalsa20-Poly1305). Wire format matches the Rust\n * implementation in `apps/desktop/src/crypto.rs`: base64(nonce || box).\n */\nexport function encrypt(plaintext: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const nonce = randomBytes(NONCE_LENGTH);\n const box = xsalsa20poly1305(key, nonce).encrypt(utf8Encode(plaintext));\n return toBase64(concatBytes(nonce, box));\n}\n\n/** The length of what `encrypt` returns for a plaintext of this many UTF-8 bytes: base64 of nonce, box and 16-byte tag. */\nexport function sealedLength(plaintextBytes: number): number {\n return 4 * Math.ceil((NONCE_LENGTH + 16 + plaintextBytes) / 3);\n}\n\nexport function decrypt(encoded: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const combined = fromBase64(encoded);\n if (combined.length < NONCE_LENGTH + 1) throw new Error(\"Invalid ciphertext: too short\");\n const nonce = combined.subarray(0, NONCE_LENGTH);\n const box = combined.subarray(NONCE_LENGTH);\n return utf8Decode(xsalsa20poly1305(key, nonce).decrypt(box));\n}\n\nexport function tryDecrypt(encoded: string, key: Uint8Array): string | null {\n try {\n return decrypt(encoded, key);\n } catch {\n return null;\n }\n}\n","import { concatBytes, fromZ32, toZ32, utf8Decode, utf8Encode } from './bytes';\n\n/**\n * Domain identity proofs (draft WISP 304, docs/wisps/304-domain.md), the pure half.\n *\n * Under WISP 300 a proof authorizes a fresh Ed25519 *proof key* that only this\n * profile holds, through a statement the external identity vouches for. A\n * domain vouches by publishing: a DNS TXT record at `_ghostly.<domain>` or a\n * `/.well-known/ghostly.json` file names the proof key **and the statement id**\n * (SHA-256 of the statement), so the record commits to the exact binding —\n * subject, key, dates and nonce — not just to a key. Sharing with a contact is\n * then the contract's per-contact presentation, signed by the proof key.\n *\n * People who already run NIP-05 can use `/.well-known/nostr.json` instead: its\n * root name `_` must be the very Nostr key that signed the statement.\n *\n * The record names no participation key and no contact. Fetching, DNS over\n * HTTPS and caching live in `@ghostly/browser/proofs/domain`.\n */\n\nexport type DomainMethod = 'dns' | 'https' | 'nip05';\n/** What a record says: this Ghostly proof key, for this statement. */\nexport interface DomainRecord { key: string; proof: string }\n\nexport const DOMAIN_METHODS: readonly DomainMethod[] = ['dns', 'https', 'nip05'];\nexport const DNS_LABEL = '_ghostly';\nexport const WELL_KNOWN_PATH = '/.well-known/ghostly.json';\nexport const NIP05_PATH = '/.well-known/nostr.json?name=_';\n/** Everything read from a domain is bounded; these match the fetch limits. */\nexport const DOMAIN_FILE_MAX_BYTES = 16 * 1024;\nexport const DOMAIN_TXT_MAX_BYTES = 1024;\nexport const DOMAIN_MAX_RECORDS = 8;\n\nconst z32 = /^[ybndrfg8ejkmcpqxot1uwisza345h769]{52}$/;\nconst hex64 = /^[a-f0-9]{64}$/;\n\n// ---------------------------------------------------------------------------\n// Domain names\n\n/** Names that never resolve publicly (RFC 6761, 6762, 7686, 8375, 9476) or that\n * only ever mean a private network. A proof for them could only point inward. */\nconst SPECIAL_USE = ['localhost', 'local', 'internal', 'lan', 'home', 'corp', 'intranet', 'private',\n 'test', 'example', 'invalid', 'onion', 'alt', 'arpa'];\n\n/**\n * Normalizes what a person typed (\"Example.COM.\", \"https://example.com/\") into\n * a lowercase ASCII host name, or throws with a message fit for the UI.\n * Internationalized names become punycode (xn--), the form DNS carries.\n */\nexport function normalizeDomain(input: string): string {\n if (typeof input !== 'string') throw new Error('Enter a domain name, like example.com');\n let value = input.trim();\n if (!value || value.length > 300) throw new Error('Enter a domain name, like example.com');\n if (/^[a-z][a-z0-9+.-]*:\\/\\//i.test(value)) {\n let url: URL;\n try { url = new URL(value); } catch { throw new Error('Enter a domain name, like example.com'); }\n if (url.protocol !== 'https:' || url.username || url.password || url.port || (url.pathname !== '/' && url.pathname !== '') || url.search || url.hash)\n throw new Error('Enter only the domain name, without a path or port');\n value = url.hostname;\n } else {\n if (/[/:@?#\\s\\\\]/.test(value)) throw new Error('Enter only the domain name, without a path or port');\n try { value = new URL(`https://${value}`).hostname; } catch { throw new Error('That is not a valid domain name'); }\n }\n value = value.toLowerCase().replace(/\\.$/, '');\n if (value.length > 253 - DNS_LABEL.length - 1) throw new Error('That domain name is too long');\n const labels = value.split('.');\n if (labels.length < 2) throw new Error('Use a full domain name, like example.com');\n for (const label of labels) {\n if (!/^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/.test(label)) throw new Error('That is not a valid domain name');\n }\n const tld = labels[labels.length - 1];\n if (/^[0-9]+$/.test(tld) || /^\\[/.test(value)) throw new Error('Use a domain name, not an IP address');\n if (SPECIAL_USE.includes(tld) || (labels.length >= 2 && labels.slice(-2).join('.') === 'home.arpa'))\n throw new Error('That name only works on private networks');\n return value;\n}\n\nexport const dnsProofName = (domain: string) => `${DNS_LABEL}.${normalizeDomain(domain)}`;\nexport const wellKnownUrl = (domain: string, method: 'https' | 'nip05' = 'https') =>\n `https://${normalizeDomain(domain)}${method === 'nip05' ? NIP05_PATH : WELL_KNOWN_PATH}`;\n\n// ---------------------------------------------------------------------------\n// Records\n\nexport function validDomainRecord(r: DomainRecord): boolean {\n if (!r || typeof r.key !== 'string' || typeof r.proof !== 'string' || !z32.test(r.key) || !hex64.test(r.proof)) return false;\n try { return toZ32(fromZ32(r.key)) === r.key; } catch { return false; }\n}\n\n/** The TXT record value, in the `tag=value; …` style people know from DKIM. */\nexport function domainTxtRecord(r: DomainRecord): string {\n if (!validDomainRecord(r)) throw new Error('Invalid domain record');\n return `v=ghostly1; key=${r.key}; proof=${r.proof}`;\n}\n\n/** Parses one TXT string. Undefined for anything that is not ours or not exactly\n * well-formed; unknown extra tags are ignored for forward compatibility. */\nexport function parseDomainTxt(value: string): DomainRecord | undefined {\n if (typeof value !== 'string' || utf8Encode(value).length > DOMAIN_TXT_MAX_BYTES) return;\n const tags = new Map<string, string>();\n const parts = value.split(';').map(p => p.trim()).filter(Boolean);\n for (const part of parts) {\n const eq = part.indexOf('=');\n if (eq < 1) return;\n const name = part.slice(0, eq).trim().toLowerCase();\n if (tags.has(name)) return;\n tags.set(name, part.slice(eq + 1).trim());\n }\n if (!parts[0]?.toLowerCase().startsWith('v=') || tags.get('v') !== 'ghostly1') return;\n const r = { key: tags.get('key'), proof: tags.get('proof') } as DomainRecord;\n return validDomainRecord(r) ? r : undefined;\n}\n\nconst addRecord = (list: DomainRecord[], r: DomainRecord) => {\n if (!list.some(x => x.key === r.key && x.proof === r.proof)) list.push(r);\n};\n\n/** All records among the first 32 TXT strings of `_ghostly.<domain>`; other strings are skipped. A TXT set has\n * no order, so every record is kept: the one a proof needs may come in any position. */\nexport function recordsFromTxt(values: string[]): DomainRecord[] {\n const out: DomainRecord[] = [];\n for (const value of values.slice(0, 32)) { const r = parseDomainTxt(value); if (r) addRecord(out, r); }\n return out;\n}\n\n/** The body of `/.well-known/ghostly.json`. */\nexport function domainWellKnownFile(records: DomainRecord[]): string {\n if (!records.length || records.length > DOMAIN_MAX_RECORDS || !records.every(validDomainRecord)) throw new Error('Invalid domain records');\n return JSON.stringify({ ghostly: 1, proofs: records.map(r => ({ key: r.key, proof: r.proof })) }, null, 2) + '\\n';\n}\n\nfunction parseJson(text: string): unknown {\n if (typeof text !== 'string' || utf8Encode(text).length > DOMAIN_FILE_MAX_BYTES) throw new Error('File too large');\n return JSON.parse(text);\n}\n\n/** Records from the first 32 entries of `ghostly.json`. Throws on a malformed file; [] when it names none. */\nexport function recordsFromWellKnown(text: string): DomainRecord[] {\n const body = parseJson(text) as { ghostly?: unknown; proofs?: unknown };\n if (!body || typeof body !== 'object' || Array.isArray(body) || body.ghostly !== 1 || !Array.isArray(body.proofs))\n throw new Error('Not a Ghostly domain file');\n const out: DomainRecord[] = [];\n for (const entry of body.proofs.slice(0, 32) as { key?: unknown; proof?: unknown }[]) {\n if (!entry || typeof entry !== 'object') continue;\n const r = { key: entry.key, proof: entry.proof } as DomainRecord;\n if (validDomainRecord(r)) addRecord(out, r);\n }\n return out;\n}\n\n/** NIP-05: only the root name `_` speaks for the domain itself. Undefined when absent. */\nexport function nip05RootKey(text: string): string | undefined {\n const body = parseJson(text) as { names?: unknown };\n if (!body || typeof body !== 'object' || !body.names || typeof body.names !== 'object' || Array.isArray(body.names))\n throw new Error('Not a NIP-05 file');\n const root = (body.names as Record<string, unknown>)['_'];\n return typeof root === 'string' && hex64.test(root) ? root : undefined;\n}\n\nexport const recordsName = (records: DomainRecord[], r: DomainRecord) => records.some(x => x.key === r.key && x.proof === r.proof);\n\n// ---------------------------------------------------------------------------\n// DNS over HTTPS (RFC 8484) wire messages\n\nexport const DNS_TYPE = { A: 1, CNAME: 5, TXT: 16, AAAA: 28 } as const;\nexport type DnsType = keyof typeof DNS_TYPE;\nexport interface DnsAnswer { name: string; type: number; ttl: number; data: Uint8Array }\nexport interface DnsResponse {\n /** 0 = NOERROR, 3 = NXDOMAIN; anything else is a failed lookup. */\n rcode: number;\n /** The resolver reports it validated the answer with DNSSEC. */\n authenticated: boolean;\n answers: DnsAnswer[];\n}\n\n/**\n * EDNS0 OPT record (RFC 6891) with one Client Subnet option of source prefix 0 (RFC 7871 §7.1.2): a resolver must\n * not add this device's subnet to its queries to the name's servers, as Google Public DNS otherwise does.\n */\nconst NO_CLIENT_SUBNET = Uint8Array.of(0, 0, 41, 1232 >> 8, 1232 & 0xff, 0, 0, 0, 0, 0, 8, 0, 8, 0, 4, 0, 1, 0, 0);\n\n/** A recursive query for one name and type. ID 0, as RFC 8484 recommends for caching;\n * the AD bit asks the resolver to report DNSSEC validation (RFC 6840 §5.7). */\nexport function encodeDnsQuery(name: string, type: DnsType): Uint8Array {\n const labels = name.replace(/\\.$/, '').split('.');\n const parts: Uint8Array[] = [Uint8Array.of(0, 0, 0x01, 0x20, 0, 1, 0, 0, 0, 0, 0, 1)];\n for (const label of labels) {\n const bytes = utf8Encode(label);\n if (!bytes.length || bytes.length > 63) throw new Error('Invalid DNS name');\n parts.push(Uint8Array.of(bytes.length), bytes);\n }\n const code = DNS_TYPE[type];\n parts.push(Uint8Array.of(0, code >> 8, code & 0xff, 0, 1), NO_CLIENT_SUBNET);\n return concatBytes(...parts);\n}\n\nfunction readName(data: Uint8Array, start: number): { name: string; next: number } {\n const labels: string[] = [];\n let pos = start, next = -1, jumps = 0, length = 0;\n for (;;) {\n if (pos >= data.length) throw new Error('DNS name out of bounds');\n const len = data[pos];\n if ((len & 0xc0) === 0xc0) {\n if (pos + 1 >= data.length) throw new Error('DNS pointer out of bounds');\n if (next < 0) next = pos + 2;\n pos = ((len & 0x3f) << 8) | data[pos + 1];\n if (++jumps > 32) throw new Error('DNS name loops');\n continue;\n }\n if (len & 0xc0) throw new Error('Unsupported DNS label');\n pos += 1;\n if (len === 0) break;\n if (pos + len > data.length) throw new Error('DNS label out of bounds');\n length += len + 1;\n if (length > 255) throw new Error('DNS name too long');\n labels.push(utf8Decode(data.subarray(pos, pos + len)).toLowerCase());\n pos += len;\n }\n return { name: labels.join('.'), next: next < 0 ? pos : next };\n}\n\n/**\n * Decodes a resolver's answer to `encodeDnsQuery(name, type)`. Refuses a reply\n * to another question or a truncated one, and keeps only records of the asked\n * type owned by the name or by the CNAME chain the answer itself follows.\n */\nexport function decodeDnsResponse(data: Uint8Array, name: string, type: DnsType): DnsResponse {\n if (data.length < 12) throw new Error('DNS response too short');\n const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n const flags = view.getUint16(2);\n if (!(flags & 0x8000) || (flags & 0x7800) || (flags & 0x0200)) throw new Error('Unusable DNS response');\n const questions = view.getUint16(4), count = view.getUint16(6);\n const want = name.replace(/\\.$/, '').toLowerCase(), code = DNS_TYPE[type];\n if (questions !== 1) throw new Error('DNS response is for another question');\n const q = readName(data, 12);\n if (q.name !== want || q.next + 4 > data.length || view.getUint16(q.next) !== code) throw new Error('DNS response is for another question');\n let pos = q.next + 4;\n const all: DnsAnswer[] = [];\n for (let i = 0; i < count && i < 64; i++) {\n const owner = readName(data, pos);\n pos = owner.next;\n if (pos + 10 > data.length) throw new Error('DNS record out of bounds');\n const rtype = view.getUint16(pos), ttl = view.getUint32(pos + 4), len = view.getUint16(pos + 8);\n pos += 10;\n if (pos + len > data.length) throw new Error('DNS record out of bounds');\n const rdata = rtype === DNS_TYPE.CNAME ? utf8Encode(readName(data, pos).name) : data.slice(pos, pos + len);\n all.push({ name: owner.name, type: rtype, ttl, data: rdata });\n pos += len;\n }\n const owners = new Set([want]);\n for (let hop = 0; hop < 8; hop++) {\n const cname = all.find(a => a.type === DNS_TYPE.CNAME && owners.has(a.name) && !owners.has(utf8Decode(a.data)));\n if (!cname) break;\n owners.add(utf8Decode(cname.data));\n }\n return { rcode: flags & 0x000f, authenticated: !!(flags & 0x0020), answers: all.filter(a => a.type === code && owners.has(a.name)) };\n}\n\n/** The TXT character-strings of one record, joined as RFC 7208 §3.3 does. */\nexport function txtValue(rdata: Uint8Array): string {\n const parts: Uint8Array[] = [];\n for (let p = 0; p < rdata.length;) {\n const len = rdata[p];\n if (p + 1 + len > rdata.length) throw new Error('DNS text out of bounds');\n parts.push(rdata.subarray(p + 1, p + 1 + len));\n p += 1 + len;\n }\n return new TextDecoder('utf-8', { fatal: true }).decode(concatBytes(...parts));\n}\n\n// ---------------------------------------------------------------------------\n// Addresses: a proof may only make a contact's app fetch from the public Internet\n\n/** False for loopback, private, link-local, shared (CGNAT), multicast, reserved\n * and unspecified addresses, including IPv4 embedded in IPv6, and for 6to4, Teredo and documentation IPv6, as\n * Desktop's link_preview::is_public and apps/ui/src/lib/localHost.ts refuse them. */\nexport function isPublicAddress(address: Uint8Array): boolean {\n if (address.length === 4) {\n const [a, b, c] = address;\n return !(a === 0 || a === 10 || a === 127 || a >= 224 ||\n (a === 100 && b >= 64 && b <= 127) || (a === 169 && b === 254) || (a === 172 && b >= 16 && b <= 31) ||\n (a === 192 && b === 168) || (a === 192 && b === 0 && c === 0) || (a === 198 && (b === 18 || b === 19)));\n }\n if (address.length !== 16) return false;\n const zeroTo = (n: number) => address.subarray(0, n).every(x => x === 0);\n if (zeroTo(15) && (address[15] === 0 || address[15] === 1)) return false; // :: and ::1\n if (zeroTo(10) && address[10] === 0xff && address[11] === 0xff) return isPublicAddress(address.subarray(12)); // ::ffff:a.b.c.d\n if (address[0] === 0x00 && address[1] === 0x64 && address[2] === 0xff && address[3] === 0x9b && address.subarray(4, 12).every(x => x === 0))\n return isPublicAddress(address.subarray(12)); // 64:ff9b::/96 NAT64\n if (zeroTo(12)) return false; // deprecated IPv4-compatible\n if ((address[0] & 0xfe) === 0xfc) return false; // fc00::/7 unique local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0x80) return false; // fe80::/10 link-local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0xc0) return false; // fec0::/10 site-local\n if (address[0] === 0xff) return false; // multicast\n if (address[0] === 0x01 && address.subarray(1, 8).every(x => x === 0)) return false; // 100::/64 discard\n if (address[0] === 0x20 && address[1] === 0x02) return false; // 2002::/16 6to4: carries an IPv4 address a gateway may reach\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x00 && address[3] === 0x00) return false; // 2001::/32 Teredo, the same\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x0d && address[3] === 0xb8) return false; // 2001:db8::/32 documentation\n return (address[0] & 0xe0) === 0x20; // only 2000::/3 is global unicast\n}\n","/**\n * Names only a local network answers (RFC 6762, RFC 8375, ICANN's .internal, and the usual router and company ones).\n * The same list as apps/ui/src/lib/localHost.ts and Desktop's apps/desktop/src/local_names.rs (a test there pins them).\n */\nexport const LOCAL_SUFFIXES = [\"localhost\", \"local\", \"internal\", \"lan\", \"home\", \"home.arpa\", \"localdomain\", \"intranet\", \"corp\"] as const;\n\n/** Whether a lowercase host with no trailing dot is one of `LOCAL_SUFFIXES` or under one. */\nexport const underLocalSuffix = (host: string): boolean => LOCAL_SUFFIXES.some(s => host === s || host.endsWith(`.${s}`));\n","import { ed25519, x25519 } from \"@noble/curves/ed25519.js\";\nimport { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { hkdf } from \"@noble/hashes/hkdf.js\";\nimport { sha256 } from \"@noble/hashes/sha2.js\";\nimport { concatBytes, fromBase64Url, randomBytes, toBase64Url, utf8Decode, utf8Encode } from \"./bytes\";\nimport { encrypt, tryDecrypt } from \"./crypto\";\nimport { isPublicAddress } from \"./domainProofs\";\nimport { identityFromSeed, identityFromSeedB64, publicKeyFromZ32, sign, verify, type Identity } from \"./identity\";\nimport type { LinkParams } from \"./invite\";\nimport { underLocalSuffix } from \"./localNames\";\nimport { measureRecords, MAX_DNS_PACKET_BYTES, type GhostRecord, type SignedPacket } from \"./pkarr\";\n\n/**\n * Store-and-forward for an away contact (WISP 404 draft, `hold/1`).\n *\n * What a person sends while the contact is away is sealed into a *bundle* (signed by the sender's\n * participation key, then encrypted to a key only the two of them can derive), put in the sender's\n * own storage (WISP 1000), and named in a *manifest* the storage also holds. A small signed, encrypted\n * *pointer* record on a per-link Pkarr key tells the contact where the manifest is (a URL that expires)\n * and which of the contact's own bundles have been received. Storage and relays see ciphertext, sizes\n * and timing only. Nothing here promises forward secrecy or retention beyond the bounds below.\n */\nexport const HOLD_CAPABILITY = \"hold/1\" as const;\nexport const HOLD_LIMITS = {\n /** One bundle, ciphertext and header included: a picture, not a video. */\n maxBundleBytes: 8 * 1024 * 1024,\n /** All bundles held for one contact at once. */\n maxMailboxBytes: 64 * 1024 * 1024,\n maxMailboxBundles: 64,\n /** A bundle not picked up by then is dropped by its sender. The longest a presigned URL lives, too. */\n ttlMs: 7 * 24 * 60 * 60_000,\n maxTextBytes: 16 * 1024,\n maxPaymentRequestBytes: 64 * 1024,\n maxManifestBytes: 64 * 1024,\n /**\n * How far past one lifetime from now an expiry may reach by the reader's clock: the sender's clock may be ahead, and\n * a day covers any clock that is merely wrong. Nothing else about a pointer or a bundle is held against this clock.\n */\n clockSkewMs: 24 * 60 * 60_000,\n} as const;\n/**\n * How far before its own clock a sender dates its pointer and its manifest, and ends the lifetimes it gives. A reader\n * refuses nothing for those dates: `rev` orders pointers and `seq` orders items, both kept by the reader. Apps up to\n * 1.0.2 refuse a pointer or a manifest dated more than a minute past their clock, and an expiry more than a minute\n * past one lifetime from now, each without a word: the items of a sender whose clock ran two minutes fast were never\n * fetched. Dated back, a sender up to about eleven minutes ahead is read by them.\n */\nexport const HOLD_DATED_BACK_MS = 10 * 60_000;\n\nexport type HoldKind = \"text\" | \"file\" | \"pay-req\" | \"manifest\";\nconst KINDS: readonly string[] = [\"text\", \"file\", \"pay-req\", \"manifest\"];\nconst WIRE_ID = /^[A-Za-z0-9_-]{8,64}$/;\nconst MAILBOX = /^[A-Za-z0-9_-]{22}$/;\nconst SIG = /^[A-Za-z0-9_-]{86}$/;\nconst MAGIC = utf8Encode(\"GHLD\");\nconst VERSION = 1;\nconst NONCE = 24;\n/** A bundle sealed by the chat's ratchet (WISP 4xx § Held items). */\nconst RATCHETED = 2;\ntype HoldItem = { mailbox: string; seq: number; id: string; ts: number; kind: HoldKind; meta?: unknown; expires: number };\n\nexport interface HoldFileMeta { name: string; size: number; mime: string }\n/** One held bundle as the manifest lists it: where to get it, and what to expect. */\nexport type HoldManifestEntry = [seq: number, id: string, kind: Exclude<HoldKind, \"manifest\">, bytes: number, url: string, expires: number];\nexport interface HoldHeader {\n v: 1;\n /** Rendezvous keys, as the sender sees the link. */\n from: string;\n to: string;\n /** Participation keys: who signed, who may open. */\n author: string;\n recipient: string;\n mailbox: string;\n seq: number;\n id: string;\n ts: number;\n kind: HoldKind;\n meta: unknown;\n /** base64url SHA-256 of the body. */\n digest: string;\n expires: number;\n}\nexport interface HoldPointer {\n rev: number;\n issued: number;\n /** When the manifest URL stops working. */\n expires: number;\n manifestUrl: string | null;\n /** Highest sequence the publisher has held for the reader. */\n top: number;\n /** Highest sequence the publisher received from the reader. */\n ack: number;\n count: number;\n bytes: number;\n /** Sequences of the reader's items this publisher refused (changed, oversized, not for it): at most the last 32. */\n refused: number[];\n}\n\n/** Why a bundle, manifest or pointer was refused. Never a reason to trust it a little. */\nexport class HoldRefusedError extends Error {\n /** The bytes the chat's ratchet opened, when it opened them before the item was refused: the caller commits them. */\n ratcheted?: Uint8Array;\n constructor(readonly reason: \"size\" | \"format\" | \"tampered\" | \"not-for-me\" | \"author\" | \"signature\" | \"digest\" | \"limits\" | \"expired\" | \"plain\", message: string) {\n super(message);\n }\n}\n\nconst bodyDigest = (body: Uint8Array) => toBase64Url(sha256(body));\nconst newMailbox = () => toBase64Url(randomBytes(16)).slice(0, 22);\nexport { newMailbox as newHoldMailbox };\n\n/**\n * Everything derived once per link for this feature: my pointer key, the contact's pointer address and\n * the key that seals bundles and pointers between the two participation keys. Needs a pinned contact.\n */\nexport class HoldKeys {\n readonly from: string;\n readonly to: string;\n readonly me: string;\n readonly peer: string;\n /** Publishes my pointer. */\n readonly identity: Identity;\n /** Where the contact publishes its pointer. */\n readonly peerAddress: string;\n private readonly seed: Uint8Array;\n private readonly sealKey: Uint8Array;\n\n constructor(params: LinkParams, participationSeedB64: string, peerKey: string) {\n this.from = identityFromSeedB64(params.seedB64).pubKeyZ32;\n this.to = params.peerPubKeyZ32;\n const mine = identityFromSeedB64(participationSeedB64);\n this.seed = mine.seed;\n this.me = mine.pubKeyZ32;\n this.peer = peerKey;\n const secret = fromBase64Url(params.encKeyB64);\n const context = JSON.stringify([\"ghostly-hold/1\", [this.from, this.to].sort()]);\n const derive = (label: string) => hkdf(sha256, secret, utf8Encode(context), utf8Encode(label), 32);\n this.identity = identityFromSeed(derive(`pointer:${this.from}`));\n this.peerAddress = identityFromSeed(derive(`pointer:${this.to}`)).pubKeyZ32;\n const shared = x25519.getSharedSecret(ed25519.utils.toMontgomerySecret(this.seed), ed25519.utils.toMontgomery(publicKeyFromZ32(peerKey)));\n this.sealKey = hkdf(sha256, shared, derive(\"envelope\"), utf8Encode(\"ghostly-hold-envelope/1\"), 32);\n }\n\n /** Seals one item for the contact: signed with my participation key, encrypted to our shared key. */\n seal(item: HoldItem, body: Uint8Array): Uint8Array {\n const nonce = randomBytes(NONCE);\n const box = xsalsa20poly1305(this.sealKey, nonce).encrypt(this.inner(item, body));\n return concatBytes(MAGIC, new Uint8Array([VERSION]), nonce, box);\n }\n /**\n * The same item as a version-2 bundle (WISP 4xx § Held items): the same plaintext, sealed by the chat's ratchet\n * (`seal`, which saves the ratchet's state before it returns), so the bundle can be uploaded once this returns.\n */\n async sealRatcheted(item: HoldItem, body: Uint8Array, seal: (plaintext: Uint8Array) => Promise<Uint8Array>): Promise<Uint8Array> {\n return concatBytes(MAGIC, new Uint8Array([RATCHETED]), await seal(this.inner(item, body)));\n }\n /** What a bundle seals: the header's length, the signed header, the body. */\n private inner(item: HoldItem, body: Uint8Array): Uint8Array {\n const fields = [VERSION, this.from, this.to, this.me, this.peer, item.mailbox, item.seq, item.id, item.ts, item.kind, item.meta ?? null, bodyDigest(body), item.expires];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), this.seed));\n const header = utf8Encode(JSON.stringify([fields, signature]));\n const length = new Uint8Array(4);\n new DataView(length.buffer).setUint32(0, header.length);\n return concatBytes(length, header, body);\n }\n\n /**\n * Opens a bundle the contact sealed for me. Everything is checked before anything is returned: the\n * authenticated encryption, the header's shape, that it names this link, this contact and me, the\n * signature, the body digest and the limits of its kind. `loopback`: see `isHoldUrl`.\n */\n /**\n * `ratchet`: opens a version-2 bundle's sealed bytes (WISP 4xx), without keeping anything; absent, one is from a newer\n * Ghostly. `refusePlain`: a ratcheted item from this contact opened here, so a version-1 item other than the manifest is\n * refused (WISP 4xx § Downgrade). `ratcheted` in the result: the bytes the ratchet opened, for the caller to commit once\n * the item is stored.\n */\n open(bytes: Uint8Array, expect: { maxBytes?: number; mailbox?: string; now?: number; loopback?: boolean; ratchet?: (sealed: Uint8Array) => Uint8Array | null; refusePlain?: boolean } = {}): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n const now = expect.now ?? Date.now();\n if (bytes.length > (expect.maxBytes ?? HOLD_LIMITS.maxBundleBytes)) throw new HoldRefusedError(\"size\", \"The held item is larger than allowed\");\n if (bytes.length < MAGIC.length + 1 + 16 + 4 || !MAGIC.every((b, i) => bytes[i] === b)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const version = bytes[MAGIC.length];\n if (version !== VERSION && (version !== RATCHETED || !expect.ratchet)) throw new HoldRefusedError(\"format\", \"Held item from a newer Ghostly\");\n let plain: Uint8Array | null, ratcheted: Uint8Array | undefined;\n if (version === RATCHETED) {\n ratcheted = bytes.subarray(MAGIC.length + 1);\n try { plain = expect.ratchet!(ratcheted); } catch { plain = null; }\n if (!plain) throw new HoldRefusedError(\"tampered\", \"The held item was changed, is not for this chat, or was opened already\");\n } else {\n if (bytes.length < MAGIC.length + 1 + NONCE + 16 + 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n try { plain = xsalsa20poly1305(this.sealKey, bytes.subarray(MAGIC.length + 1, MAGIC.length + 1 + NONCE)).decrypt(bytes.subarray(MAGIC.length + 1 + NONCE)); }\n catch { throw new HoldRefusedError(\"tampered\", \"The held item was changed or is not for this chat\"); }\n }\n try { return this.read(plain, ratcheted, expect, now); }\n catch (error) {\n // Opened, then refused: the ratchet's bytes go with the refusal, so the key is used up and the lane heard all the same.\n if (error instanceof HoldRefusedError && ratcheted) error.ratcheted = ratcheted;\n throw error;\n }\n }\n /** The checks of `open` once the bundle is decrypted. */\n private read(plain: Uint8Array, ratcheted: Uint8Array | undefined, expect: { mailbox?: string; loopback?: boolean; refusePlain?: boolean }, now: number): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n if (plain.length < 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const headerLength = new DataView(plain.buffer, plain.byteOffset, 4).getUint32(0);\n if (headerLength > 128 * 1024 || 4 + headerLength > plain.length) throw new HoldRefusedError(\"format\", \"Not a held item\");\n let parsed: unknown;\n try { parsed = JSON.parse(utf8Decode(plain.subarray(4, 4 + headerLength))); } catch { throw new HoldRefusedError(\"format\", \"Not a held item\"); }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || parsed[0].length !== 13 || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const [fields, signature] = parsed as [unknown[], string];\n const [v, from, to, author, recipient, mailbox, seq, id, ts, kind, meta, digest, expires] = fields;\n if (v !== VERSION || typeof from !== \"string\" || typeof to !== \"string\" || typeof author !== \"string\" || typeof recipient !== \"string\" || typeof mailbox !== \"string\" || !MAILBOX.test(mailbox) ||\n !Number.isSafeInteger(seq) || (seq as number) < 0 || typeof id !== \"string\" || !WIRE_ID.test(id) || !Number.isSafeInteger(ts) || (ts as number) <= 0 ||\n typeof kind !== \"string\" || !KINDS.includes(kind) || typeof digest !== \"string\" || !Number.isSafeInteger(expires)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n // Both directions of this link are sealed with the same key: the header says which one this is.\n if (from !== this.to || to !== this.from || recipient !== this.me) throw new HoldRefusedError(\"not-for-me\", \"The held item is for another chat\");\n if (author !== this.peer) throw new HoldRefusedError(\"author\", \"The held item was not signed by this contact\");\n if (expect.mailbox && mailbox !== expect.mailbox) throw new HoldRefusedError(\"not-for-me\", \"The held item is from another mailbox\");\n let valid: boolean;\n try { valid = verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), publicKeyFromZ32(author)); } catch { valid = false; }\n if (!valid) throw new HoldRefusedError(\"signature\", \"The held item's signature does not check out\");\n const body = plain.subarray(4 + headerLength);\n if (bodyDigest(body) !== digest) throw new HoldRefusedError(\"digest\", \"The held item's content does not match its header\");\n // Its `ts` is its sender's clock, often minutes from this one: nothing is refused for it. It was, past a minute\n // ahead, and for good: the item's sequence was passed, and its sender told \"could not be verified as yours, or was\n // too large\". What stops an item from being taken twice is its sequence (the manifest's, the pointer's `rev`).\n // The item may be older than its upload (a retry, a message written offline); its expiry may not reach past one\n // lifetime from now, give or take what the sender's clock is ahead.\n if ((expires as number) <= (ts as number) || (expires as number) > now + HOLD_LIMITS.ttlMs + HOLD_LIMITS.clockSkewMs) throw new HoldRefusedError(\"limits\", \"The held item's lifetime is out of bounds\");\n const header: HoldHeader = { v: 1, from, to, author, recipient, mailbox, seq: seq as number, id, ts: ts as number, kind: kind as HoldKind, meta, digest, expires: expires as number };\n // The manifest is always sealed as before; anything else from a contact whose items come ratcheted must be ratcheted.\n if (!ratcheted && expect.refusePlain && kind !== \"manifest\") throw new HoldRefusedError(\"plain\", \"The held item was sealed without forward secrecy, which this chat no longer takes\");\n checkKind(header, body, expect.loopback);\n return { header, body, ...(ratcheted && { ratcheted }) };\n }\n\n /** My pointer, as records to publish under `identity`. Throws when it cannot fit a packet. */\n pointerRecords(pointer: HoldPointer, now = Date.now()): GhostRecord[] {\n const body = [VERSION, pointer.rev, pointer.issued, pointer.expires, pointer.manifestUrl, pointer.top, pointer.ack, pointer.count, pointer.bytes, pointer.refused.slice(-32)];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.from, this.to, body])), this.seed));\n const ttl = Math.min(24 * 3600, Math.max(60, Math.ceil((pointer.expires - now) / 1000)));\n const records = [{ label: \"_hold\", value: encrypt(JSON.stringify([body, signature]), this.sealKey), ttl }];\n if (measureRecords(this.identity.pubKeyZ32, records) > MAX_DNS_PACKET_BYTES) throw new Error(\"The storage address is too long for a DHT packet. Use a shorter endpoint or prefix.\");\n return records;\n }\n\n /**\n * The contact's pointer out of its packet, or null when the packet is not one of its pointers. Its `issued` is the\n * contact's clock and refuses nothing: an older pointer cannot take a newer one's place because of `rev`. The\n * manifest's address is held to what an item's is (`isHoldUrl`): it is fetched as soon as the pointer is read.\n */\n readPointer(packet: SignedPacket, loopback = false): HoldPointer | null {\n if (packet.pubKeyZ32 !== this.peerAddress || measureRecords(packet.pubKeyZ32, packet.records) > MAX_DNS_PACKET_BYTES) return null;\n const records = packet.records.filter(r => r.label === \"_hold\");\n if (records.length !== 1) return null;\n const plain = tryDecrypt(records[0].value, this.sealKey);\n if (!plain) return null;\n let parsed: unknown;\n try { parsed = JSON.parse(plain); } catch { return null; }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || (parsed[0].length !== 9 && parsed[0].length !== 10) || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) return null;\n const [body, signature] = parsed as [unknown[], string];\n const [v, rev, issued, expires, manifestUrl, top, ack, count, bytes, refused = []] = body;\n if (v !== VERSION || ![rev, issued, expires, top, ack, count, bytes].every(n => Number.isSafeInteger(n) && (n as number) >= 0) ||\n (manifestUrl !== null && !isHoldUrl(manifestUrl, loopback)) ||\n !Array.isArray(refused) || refused.length > 32 || !refused.every(n => Number.isSafeInteger(n) && (n as number) > 0)) return null;\n try {\n if (!verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.to, this.from, body])), publicKeyFromZ32(this.peer))) return null;\n } catch { return null; }\n return { rev: rev as number, issued: issued as number, expires: expires as number, manifestUrl: manifestUrl as string | null, top: top as number, ack: ack as number, count: count as number, bytes: bytes as number, refused: refused as number[] };\n }\n}\n\n/**\n * A URL a bundle or manifest may be fetched from. The contact chose it and this device fetches it on its own, so it\n * is HTTPS, without a user or password, at a public name or a public IPv4 address: never this machine or its network.\n * A name with no dot or under a local suffix is a local one. A public name may still resolve to a local address:\n * where the host can resolve, its `fetch` refuses that too (the CLI's, packages/cli/src/runtime/holdFetch.ts, and\n * Desktop's, apps/desktop/src/hold_fetch.rs).\n * `loopback` adds plain HTTP to this machine, for a test against a local server; no shipped app passes it.\n */\nexport function isHoldUrl(value: unknown, loopback = false): value is string {\n if (typeof value !== \"string\" || value.length > 2048) return false;\n let url: URL;\n try { url = new URL(value); } catch { return false; }\n if (url.username || url.password) return false;\n const host = url.hostname.toLowerCase().replace(/\\.+$/, \"\");\n if (loopback && url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(host)) return true;\n if (url.protocol !== \"https:\" || !host.includes(\".\") || host.startsWith(\"[\") || underLocalSuffix(host)) return false;\n // A URL's IPv4 host is always written as four decimal numbers, whatever form it was given in.\n return !/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(host) || isPublicAddress(Uint8Array.from(host.split(\".\"), Number));\n}\n\n/** The limits of each kind, on the way in. */\nfunction checkKind(header: HoldHeader, body: Uint8Array, loopback = false): void {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n switch (header.kind) {\n case \"text\":\n if (body.length > HOLD_LIMITS.maxTextBytes) throw bad(\"The held text is too long\");\n try { utf8Decode(body); } catch { throw bad(\"The held text is not text\"); }\n return;\n case \"pay-req\":\n if (body.length > HOLD_LIMITS.maxPaymentRequestBytes) throw bad(\"The held payment request is too large\");\n return;\n case \"file\": {\n const meta = header.meta as Partial<HoldFileMeta> | null;\n if (!meta || typeof meta !== \"object\" || typeof meta.name !== \"string\" || meta.name.length > 255 || typeof meta.mime !== \"string\" || meta.mime.length > 255 || meta.size !== body.length) throw bad(\"The held file does not match its description\");\n return;\n }\n case \"manifest\": {\n if (body.length !== 0) throw bad(\"A manifest carries no body\");\n readManifest(header.meta, loopback);\n return;\n }\n }\n}\n\n/** The entries of a manifest, checked: strictly increasing sequences, bounded sizes, fetchable URLs. */\nexport function readManifest(meta: unknown, loopback = false): HoldManifestEntry[] {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n const entries = (meta as { entries?: unknown } | null)?.entries;\n if (!Array.isArray(entries) || entries.length > HOLD_LIMITS.maxMailboxBundles) throw bad(\"The manifest lists too many items\");\n let last = 0, total = 0;\n const out: HoldManifestEntry[] = [];\n for (const entry of entries) {\n if (!Array.isArray(entry) || entry.length !== 6) throw bad(\"The manifest is malformed\");\n const [seq, id, kind, bytes, url, expires] = entry;\n if (!Number.isSafeInteger(seq) || seq <= last || typeof id !== \"string\" || !WIRE_ID.test(id) || typeof kind !== \"string\" || !KINDS.includes(kind) || kind === \"manifest\" ||\n !Number.isSafeInteger(bytes) || bytes < 0 || bytes > HOLD_LIMITS.maxBundleBytes || !isHoldUrl(url, loopback) || !Number.isSafeInteger(expires)) throw bad(\"The manifest is malformed\");\n last = seq; total += bytes;\n if (total > HOLD_LIMITS.maxMailboxBytes) throw bad(\"The manifest lists more than a mailbox may hold\");\n out.push([seq, id, kind as HoldManifestEntry[2], bytes, url, expires]);\n }\n return out;\n}\n","import type { FrameChannel } from \"./frames\";\nimport { isHoldUrl } from \"./storeForward\";\n\nexport const TRANSPORTS = [\"iroh/1\", \"hyperdht/1\", \"webrtc/1\"] as const;\nexport type PairedTransport = typeof TRANSPORTS[number];\nexport type NativeTransport = Exclude<PairedTransport, \"webrtc/1\">;\n\n/** Supplied only by the local adapter after its real cryptographic handshake.\n * Iroh uses a TLS exporter; HyperDHT uses its Noise handshake hash. */\nexport interface NativeBinding {\n transport: NativeTransport;\n context: string;\n identities: [string, string];\n}\nexport interface BoundChannel { channel: FrameChannel; binding: NativeBinding }\nexport interface NativeEndpoint {\n transport: NativeTransport;\n descriptor: unknown;\n connect(descriptor: unknown): Promise<BoundChannel>;\n close(): Promise<void>;\n onConnection: ((connection: BoundChannel) => void) | null;\n onDescriptor: (() => void) | null;\n onUnavailable?: (() => void) | null;\n /** The endpoint is connected to its relay again after it lost it (the native Iroh's home relay; nothing else says it). */\n onRelayBack?: (() => void) | null;\n}\nexport type TransportDescriptors = Partial<Record<NativeTransport, unknown>>;\n\n/**\n * One spelling per Iroh relay. Iroh compares relay URLs as text, and its own relays are named with the trailing dot\n * of a fully qualified name (`https://use1-1.relay.n0.iroh.link./`): the same server written without the dot is\n * another relay to it, and an endpoint dialling a contact there opens a second connection to the server it is already\n * homed on, which the server answers by setting the first one aside.\n *\n * So every relay URL is put in one spelling before it goes into an Iroh endpoint (the relays it homes on, a contact's\n * descriptor before a dial), and which one depends on the endpoint:\n * - `\"dotted\"`, n0's relays with their trailing dot: what native Iroh homes on by default (the Desktop), and the form\n * to compare two relays in. Any other relay keeps its plain name here too: a relay behind a proxy (a Cloudflare\n * tunnel) is found by its Host header, and the proxy answers the dotted name with 404.\n * - `\"plain\"`, the name without it: the only one every browser opens. WebKit (Safari, the iPhone app) refuses a\n * host name that ends in a dot, for `fetch` and for a WebSocket alike, so nothing a browser's Iroh is given has one.\n *\n * An IP address and a single-label name (a search domain may complete it) stay as written; `localhost.` loses its dot\n * in both, the form the relay settings accept. What does not parse comes back untouched, for the caller's own check.\n */\nexport type IrohRelaySpelling = \"dotted\" | \"plain\";\nexport function irohRelayUrl(value: string, spelling: IrohRelaySpelling = \"dotted\"): string {\n let url: URL;\n try { url = new URL(value); } catch { return value; }\n const host = url.hostname, name = host.replace(/\\.$/, \"\");\n if (!name.includes(\".\") && name !== \"localhost\") return value;\n if (name.startsWith(\"[\") || /^\\d+(\\.\\d+){3}$/.test(name)) return value;\n const wanted = spelling === \"dotted\" && /(^|\\.)iroh\\.link$/.test(name) ? `${name}.` : name;\n if (wanted === host) return value;\n url.hostname = wanted;\n return url.href;\n}\n\n/** An Iroh descriptor with its relay in one spelling (`irohRelayUrl`); anything else as it is. */\nexport function irohDescriptor<T>(descriptor: T, spelling: IrohRelaySpelling = \"dotted\"): T {\n const relay = (descriptor as { relay?: unknown } | null | undefined)?.relay;\n if (typeof relay !== \"string\") return descriptor;\n const canonical = irohRelayUrl(relay, spelling);\n return canonical === relay ? descriptor : { ...descriptor, relay: canonical };\n}\n\n/**\n * A relay server's URL, short: https, or wss for a browser's relay; plain http or ws only on this machine's loopback,\n * as a test relay is (the same rule as the relay settings).\n */\nexport const RELAY_URL = /^((https|wss):\\/\\/[^\\s]{1,120}|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]{0,100})?)$/;\n/**\n * A relay URL with more than its server's address in it: a login, a query or a fragment, which no relay setting takes\n * (irohWeb.ts `irohRelayProblem`, hyperdhtRelay.ts `hyperdhtRelayProblem`). An older app named its HyperDHT relay as\n * set, with them; such a descriptor is not dialed or kept, and the rest of what the contact told still is.\n */\nexport const RELAY_WITH_SECRETS = /^[a-z]+:\\/\\/[^/?#]*@|[?#]/i;\n/** A relay URL a descriptor may name: `RELAY_URL`, with nothing but the server's address in it. */\nexport const relayUrl = (value: unknown): value is string => typeof value === \"string\" && RELAY_URL.test(value) && !RELAY_WITH_SECRETS.test(value);\n/** `RELAY_URL` at any length. */\nconst RELAY_URL_ANY_LENGTH = /^((https|wss):\\/\\/[^\\s]+|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]*)?)$/;\n/**\n * A relay URL `relayUrl` refuses for its length alone (past 120 characters, a loopback path past 100): a relay setting\n * asks for a shorter one, where \"not a relay address\" sent the person looking for a typo in it.\n */\nexport const relayUrlTooLong = (value: string): boolean => !relayUrl(value) && !RELAY_WITH_SECRETS.test(value) && RELAY_URL_ANY_LENGTH.test(value);\n/**\n * Whether an Iroh endpoint may dial a contact through the relay its descriptor names (none: a direct address alone).\n * The contact chose that relay and this device opens it on its own, again on each redial, so it is held to what a held\n * item's address is (`isHoldUrl`): https at a public name or a public address, never this machine or its network.\n * One of the endpoint's own relays (`own`: the person's settings, a private network's or a test's) is dialled as well,\n * in either spelling: this device opens it anyway.\n */\nexport function dialableIrohRelay(relay: unknown, own: readonly string[]): boolean {\n if (relay === null || relay === undefined) return true;\n if (!relayUrl(relay)) return false;\n const same = (a: string, b: string) => { try { return new URL(irohRelayUrl(a, \"plain\")).href === new URL(irohRelayUrl(b, \"plain\")).href; } catch { return false; } };\n return own.some(mine => same(mine, relay)) || isHoldUrl(relay);\n}\nconst HEX_KEY = /^[0-9a-f]{64}$/;\n/** An Iroh direct address as the adapters parse it: an IPv4 or bracketed IPv6 address and its port. */\nconst SOCKET_ADDRESS = /^(\\d{1,3}(\\.\\d{1,3}){3}|\\[[0-9A-Fa-f:.]{2,45}(%[A-Za-z0-9._-]{1,16})?\\]):\\d{1,5}$/;\nconst MAX_ADDRESSES = 8;\n\n/**\n * A contact's native descriptors as it tells them on a session (`paired-policy`, `paired-adapters`) or as this app\n * kept them: only what the adapters dial, each field in the shape its adapter makes. The keys are 64 hex characters,\n * a relay passes `relayUrl` (the rule its capability record is read by), an Iroh descriptor lists at most eight\n * socket addresses. A descriptor that is anything else is left out, as one the contact never told; a field this app\n * does not know is not kept.\n */\nexport function checkedDescriptors(value: unknown): TransportDescriptors {\n const out: TransportDescriptors = {};\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return out;\n const raw = value as Record<string, unknown>;\n const relayed = (v: unknown) => v === undefined || typeof v === \"boolean\";\n const iroh = raw[\"iroh/1\"] as { id?: unknown; relay?: unknown; addresses?: unknown; relayed?: unknown } | null | undefined;\n if (iroh && typeof iroh === \"object\" && typeof iroh.id === \"string\" && HEX_KEY.test(iroh.id) &&\n (iroh.relay === undefined || iroh.relay === null || relayUrl(iroh.relay)) && relayed(iroh.relayed) &&\n Array.isArray(iroh.addresses) && iroh.addresses.length <= MAX_ADDRESSES &&\n iroh.addresses.every(a => typeof a === \"string\" && SOCKET_ADDRESS.test(a)))\n out[\"iroh/1\"] = { id: iroh.id, relay: (iroh.relay as string | null | undefined) ?? null, addresses: [...iroh.addresses] as string[],\n ...(iroh.relayed !== undefined ? { relayed: iroh.relayed } : {}) };\n const hyper = raw[\"hyperdht/1\"] as { publicKey?: unknown; relay?: unknown; relayed?: unknown } | null | undefined;\n if (hyper && typeof hyper === \"object\" && typeof hyper.publicKey === \"string\" && HEX_KEY.test(hyper.publicKey) &&\n (hyper.relay === undefined || relayUrl(hyper.relay)) && relayed(hyper.relayed))\n out[\"hyperdht/1\"] = { publicKey: hyper.publicKey, ...(hyper.relay !== undefined ? { relay: hyper.relay } : {}),\n ...(hyper.relayed !== undefined ? { relayed: hyper.relayed } : {}) };\n return out;\n}\n\n/**\n * Relay only (WISP 100, \"Relayed\"): the transport reaches this contact only through a relay server, never\n * directly. A descriptor says so with `relayed: true`, and an Iroh descriptor with no direct address is relayed\n * too (a browser's, WISP 102). Either side being relay only makes the whole path relayed. Both sides hold both\n * descriptors after the exchange, so they agree, and the rank stays symmetric.\n */\nexport function relayedTransports(local: TransportDescriptors, remote: TransportDescriptors): NativeTransport[] {\n const relayOnly = (transport: NativeTransport, descriptor: unknown): boolean => {\n if (!descriptor || typeof descriptor !== \"object\") return false;\n const d = descriptor as { relayed?: unknown; addresses?: unknown };\n return d.relayed === true || (transport === \"iroh/1\" && Array.isArray(d.addresses) && d.addresses.length === 0);\n };\n return ([\"iroh/1\", \"hyperdht/1\"] as const).filter(t => relayOnly(t, local[t]) || relayOnly(t, remote[t]));\n}\n\n/** Symmetric rank sum; the fixed order breaks ties deterministically. Neither\n * a remote list nor a preference can add an unavailable local adapter. A\n * relayed transport ranks after every direct one: it is where a failed direct\n * path goes, never ahead of one that works. Iroh through its relay is the\n * exception (WISP 100, revision 2026-11-08): it comes back almost at once after\n * the app was away, and a browser's Iroh is never anything else. */\nexport function rankTransports(local: readonly string[], remote: readonly string[], relayed: readonly string[] = []): PairedTransport[] {\n const penalty = (t: PairedTransport) => t !== \"iroh/1\" && relayed.includes(t) ? 1 : 0;\n return TRANSPORTS.filter(t => local.includes(t) && remote.includes(t))\n .sort((a, b) => penalty(a) - penalty(b)\n || (local.indexOf(a) + remote.indexOf(a)) - (local.indexOf(b) + remote.indexOf(b))\n || TRANSPORTS.indexOf(a) - TRANSPORTS.indexOf(b));\n}\n\n/**\n * What a chat prefers when nobody chose (Automatic): Iroh where the app has it, then WebRTC, then HyperDHT (WISP 100,\n * revision 2026-11-08). Every app puts Iroh first, so the rank sum of two apps that both run it puts it first on both\n * sides. With nothing at all, WebRTC, which the offer then leaves out.\n * With Fallback off the chat may use only that one transport, and nothing moves it off a relayed Iroh then: WebRTC\n * where the app has it, else the first transport it has (a Linux Desktop: WebKitGTK has no WebRTC), as before.\n */\nexport const AUTOMATIC_ORDER: readonly PairedTransport[] = [\"iroh/1\", \"webrtc/1\", \"hyperdht/1\"];\nexport function automaticTransport(available: readonly PairedTransport[], fallback = true): PairedTransport {\n if (!fallback) return available.includes(\"webrtc/1\") ? \"webrtc/1\" : TRANSPORTS.find(t => available.includes(t)) ?? \"webrtc/1\";\n return AUTOMATIC_ORDER.find(t => available.includes(t)) ?? \"webrtc/1\";\n}\n\nexport function transportOrder(available: readonly PairedTransport[], preferred: PairedTransport,\n fallback: boolean): PairedTransport[] {\n const rest = TRANSPORTS.filter(t => available.includes(t) && t !== preferred);\n return [...(available.includes(preferred) ? [preferred] : []), ...(fallback ? rest : [])];\n}\n"],"mappings":";;;;;;;AAGA,IAAM,eAAe;AACrB,IAAM,aAAa;AAEnB,SAAgB,wBAAoC;CAClD,OAAO,YAAY,UAAU;AAC/B;;;;;AAMA,SAAgB,QAAQ,WAAmB,KAAyB;CAClE,IAAI,IAAI,WAAW,YAAY,MAAM,IAAI,MAAM,uCAAuC;CACtF,MAAM,QAAQ,YAAY,YAAY;CACtC,MAAM,MAAM,iBAAiB,KAAK,KAAK,CAAC,CAAC,QAAQ,WAAW,SAAS,CAAC;CACtE,OAAO,SAAS,YAAY,OAAO,GAAG,CAAC;AACzC;;AAGA,SAAgB,aAAa,gBAAgC;CAC3D,OAAO,IAAI,KAAK,MAAM,KAAoB,kBAAkB,CAAC;AAC/D;AAEA,SAAgB,QAAQ,SAAiB,KAAyB;CAChE,IAAI,IAAI,WAAW,YAAY,MAAM,IAAI,MAAM,uCAAuC;CACtF,MAAM,WAAW,WAAW,OAAO;CACnC,IAAI,SAAS,SAAS,IAAkB,MAAM,IAAI,MAAM,+BAA+B;CACvF,MAAM,QAAQ,SAAS,SAAS,GAAG,YAAY;CAC/C,MAAM,MAAM,SAAS,SAAS,YAAY;CAC1C,OAAO,WAAW,iBAAiB,KAAK,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;AAC7D;AAEA,SAAgB,WAAW,SAAiB,KAAgC;CAC1E,IAAI;EACF,OAAO,QAAQ,SAAS,GAAG;CAC7B,QAAQ;EACN,OAAO;CACT;AACF;;ACjBA,IAAa,iBAA0C;CAAC;CAAO;CAAS;AAAO;AAC/E,IAAa,YAAY;AACzB,IAAa,kBAAkB;AAC/B,IAAa,aAAa;;AAE1B,IAAa,wBAAwB;AACrC,IAAa,uBAAuB;AACpC,IAAa,qBAAqB;AAElC,IAAM,MAAM;AACZ,IAAM,QAAQ;;;AAOd,IAAM,cAAc;CAAC;CAAa;CAAS;CAAY;CAAO;CAAQ;CAAQ;CAAY;CACxF;CAAQ;CAAW;CAAW;CAAS;CAAO;AAAM;;;;;;AAOtD,SAAgB,gBAAgB,OAAuB;CACrD,IAAI,OAAO,UAAU,UAAU,MAAM,IAAI,MAAM,uCAAuC;CACtF,IAAI,QAAQ,MAAM,KAAK;CACvB,IAAI,CAAC,SAAS,MAAM,SAAS,KAAK,MAAM,IAAI,MAAM,uCAAuC;CACzF,IAAI,2BAA2B,KAAK,KAAK,GAAG;EAC1C,IAAI;EACJ,IAAI;GAAE,MAAM,IAAI,IAAI,KAAK;EAAG,QAAQ;GAAE,MAAM,IAAI,MAAM,uCAAuC;EAAG;EAChG,IAAI,IAAI,aAAa,YAAY,IAAI,YAAY,IAAI,YAAY,IAAI,QAAS,IAAI,aAAa,OAAO,IAAI,aAAa,MAAO,IAAI,UAAU,IAAI,MAC9I,MAAM,IAAI,MAAM,oDAAoD;EACtE,QAAQ,IAAI;CACd,OAAO;EACL,IAAI,cAAc,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,oDAAoD;EACnG,IAAI;GAAE,QAAQ,IAAI,IAAI,WAAW,OAAO,CAAC,CAAC;EAAU,QAAQ;GAAE,MAAM,IAAI,MAAM,iCAAiC;EAAG;CACpH;CACA,QAAQ,MAAM,YAAY,CAAC,CAAC,QAAQ,OAAO,EAAE;CAC7C,IAAI,MAAM,SAAS,KAA4B,MAAM,IAAI,MAAM,8BAA8B;CAC7F,MAAM,SAAS,MAAM,MAAM,GAAG;CAC9B,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,MAAM,0CAA0C;CACjF,KAAK,MAAM,SAAS,QAClB,IAAI,CAAC,uCAAuC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,iCAAiC;CAE5G,MAAM,MAAM,OAAO,OAAO,SAAS;CACnC,IAAI,WAAW,KAAK,GAAG,KAAK,MAAM,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,sCAAsC;CACrG,IAAI,YAAY,SAAS,GAAG,KAAM,OAAO,UAAU,KAAK,OAAO,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG,MAAM,aACrF,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT;AAEA,IAAa,gBAAgB,WAAmB,GAAG,UAAU,GAAG,gBAAgB,MAAM;AACtF,IAAa,gBAAgB,QAAgB,SAA4B,YACvE,WAAW,gBAAgB,MAAM,IAAI,WAAW,UAAU,aAAa;AAKzE,SAAgB,kBAAkB,GAA0B;CAC1D,IAAI,CAAC,KAAK,OAAO,EAAE,QAAQ,YAAY,OAAO,EAAE,UAAU,YAAY,CAAC,IAAI,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,GAAG,OAAO;CACvH,IAAI;EAAE,OAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;CAAK,QAAQ;EAAE,OAAO;CAAO;AACxE;;AAGA,SAAgB,gBAAgB,GAAyB;CACvD,IAAI,CAAC,kBAAkB,CAAC,GAAG,MAAM,IAAI,MAAM,uBAAuB;CAClE,OAAO,mBAAmB,EAAE,IAAI,UAAU,EAAE;AAC9C;;;AAIA,SAAgB,eAAe,OAAyC;CACtE,IAAI,OAAO,UAAU,YAAY,WAAW,KAAK,CAAC,CAAC,SAAA,MAA+B;CAClF,MAAM,uBAAO,IAAI,IAAoB;CACrC,MAAM,QAAQ,MAAM,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO;CAChE,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,KAAK,QAAQ,GAAG;EAC3B,IAAI,KAAK,GAAG;EACZ,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY;EAClD,IAAI,KAAK,IAAI,IAAI,GAAG;EACpB,KAAK,IAAI,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;CAC1C;CACA,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,KAAK,IAAI,GAAG,MAAM,YAAY;CAC/E,MAAM,IAAI;EAAE,KAAK,KAAK,IAAI,KAAK;EAAG,OAAO,KAAK,IAAI,OAAO;CAAE;CAC3D,OAAO,kBAAkB,CAAC,IAAI,IAAI,KAAA;AACpC;AAEA,IAAM,aAAa,MAAsB,MAAoB;CAC3D,IAAI,CAAC,KAAK,MAAK,MAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,KAAK,CAAC;AAC1E;;;AAIA,SAAgB,eAAe,QAAkC;CAC/D,MAAM,MAAsB,CAAC;CAC7B,KAAK,MAAM,SAAS,OAAO,MAAM,GAAG,EAAE,GAAG;EAAE,MAAM,IAAI,eAAe,KAAK;EAAG,IAAI,GAAG,UAAU,KAAK,CAAC;CAAG;CACtG,OAAO;AACT;;AAGA,SAAgB,oBAAoB,SAAiC;CACnE,IAAI,CAAC,QAAQ,UAAU,QAAQ,SAAA,KAA+B,CAAC,QAAQ,MAAM,iBAAiB,GAAG,MAAM,IAAI,MAAM,wBAAwB;CACzI,OAAO,KAAK,UAAU;EAAE,SAAS;EAAG,QAAQ,QAAQ,KAAI,OAAM;GAAE,KAAK,EAAE;GAAK,OAAO,EAAE;EAAM,EAAE;CAAE,GAAG,MAAM,CAAC,IAAI;AAC/G;AAEA,SAAS,UAAU,MAAuB;CACxC,IAAI,OAAO,SAAS,YAAY,WAAW,IAAI,CAAC,CAAC,SAAA,OAAgC,MAAM,IAAI,MAAM,gBAAgB;CACjH,OAAO,KAAK,MAAM,IAAI;AACxB;;AAGA,SAAgB,qBAAqB,MAA8B;CACjE,MAAM,OAAO,UAAU,IAAI;CAC3B,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,MAAM,QAAQ,KAAK,MAAM,GAC9G,MAAM,IAAI,MAAM,2BAA2B;CAC7C,MAAM,MAAsB,CAAC;CAC7B,KAAK,MAAM,SAAS,KAAK,OAAO,MAAM,GAAG,EAAE,GAA2C;EACpF,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU;EACzC,MAAM,IAAI;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;EAAM;EAC/C,IAAI,kBAAkB,CAAC,GAAG,UAAU,KAAK,CAAC;CAC5C;CACA,OAAO;AACT;;AAGA,SAAgB,aAAa,MAAkC;CAC7D,MAAM,OAAO,UAAU,IAAI;CAC3B,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,CAAC,KAAK,SAAS,OAAO,KAAK,UAAU,YAAY,MAAM,QAAQ,KAAK,KAAK,GAChH,MAAM,IAAI,MAAM,mBAAmB;CACrC,MAAM,OAAQ,KAAK,MAAkC;CACrD,OAAO,OAAO,SAAS,YAAY,MAAM,KAAK,IAAI,IAAI,OAAO,KAAA;AAC/D;AAEA,IAAa,eAAe,SAAyB,MAAoB,QAAQ,MAAK,MAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK;AAKjI,IAAa,WAAW;CAAE,GAAG;CAAG,OAAO;CAAG,KAAK;CAAI,MAAM;AAAG;;;;;AAe5D,IAAM,mBAAmB,WAAW,GAAG,GAAG,GAAG,IAAI,GAAW,KAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;;;AAIjH,SAAgB,eAAe,MAAc,MAA2B;CACtE,MAAM,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG;CAChD,MAAM,QAAsB,CAAC,WAAW,GAAG,GAAG,GAAG,GAAM,IAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;CACpF,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,QAAQ,WAAW,KAAK;EAC9B,IAAI,CAAC,MAAM,UAAU,MAAM,SAAS,IAAI,MAAM,IAAI,MAAM,kBAAkB;EAC1E,MAAM,KAAK,WAAW,GAAG,MAAM,MAAM,GAAG,KAAK;CAC/C;CACA,MAAM,OAAO,SAAS;CACtB,MAAM,KAAK,WAAW,GAAG,GAAG,QAAQ,GAAG,OAAO,KAAM,GAAG,CAAC,GAAG,gBAAgB;CAC3E,OAAO,YAAY,GAAG,KAAK;AAC7B;AAEA,SAAS,SAAS,MAAkB,OAA+C;CACjF,MAAM,SAAmB,CAAC;CAC1B,IAAI,MAAM,OAAO,OAAO,IAAI,QAAQ,GAAG,SAAS;CAChD,SAAS;EACP,IAAI,OAAO,KAAK,QAAQ,MAAM,IAAI,MAAM,wBAAwB;EAChE,MAAM,MAAM,KAAK;EACjB,KAAK,MAAM,SAAU,KAAM;GACzB,IAAI,MAAM,KAAK,KAAK,QAAQ,MAAM,IAAI,MAAM,2BAA2B;GACvE,IAAI,OAAO,GAAG,OAAO,MAAM;GAC3B,OAAQ,MAAM,OAAS,IAAK,KAAK,MAAM;GACvC,IAAI,EAAE,QAAQ,IAAI,MAAM,IAAI,MAAM,gBAAgB;GAClD;EACF;EACA,IAAI,MAAM,KAAM,MAAM,IAAI,MAAM,uBAAuB;EACvD,OAAO;EACP,IAAI,QAAQ,GAAG;EACf,IAAI,MAAM,MAAM,KAAK,QAAQ,MAAM,IAAI,MAAM,yBAAyB;EACtE,UAAU,MAAM;EAChB,IAAI,SAAS,KAAK,MAAM,IAAI,MAAM,mBAAmB;EACrD,OAAO,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;EACnE,OAAO;CACT;CACA,OAAO;EAAE,MAAM,OAAO,KAAK,GAAG;EAAG,MAAM,OAAO,IAAI,MAAM;CAAK;AAC/D;;;;;;AAOA,SAAgB,kBAAkB,MAAkB,MAAc,MAA4B;CAC5F,IAAI,KAAK,SAAS,IAAI,MAAM,IAAI,MAAM,wBAAwB;CAC9D,MAAM,OAAO,IAAI,SAAS,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU;CACvE,MAAM,QAAQ,KAAK,UAAU,CAAC;CAC9B,IAAI,EAAE,QAAQ,UAAY,QAAQ,SAAY,QAAQ,KAAS,MAAM,IAAI,MAAM,uBAAuB;CACtG,MAAM,YAAY,KAAK,UAAU,CAAC,GAAG,QAAQ,KAAK,UAAU,CAAC;CAC7D,MAAM,OAAO,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,YAAY,GAAG,OAAO,SAAS;CACpE,IAAI,cAAc,GAAG,MAAM,IAAI,MAAM,sCAAsC;CAC3E,MAAM,IAAI,SAAS,MAAM,EAAE;CAC3B,IAAI,EAAE,SAAS,QAAQ,EAAE,OAAO,IAAI,KAAK,UAAU,KAAK,UAAU,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,MAAM,sCAAsC;CAC1I,IAAI,MAAM,EAAE,OAAO;CACnB,MAAM,MAAmB,CAAC;CAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,IAAI,IAAI,KAAK;EACxC,MAAM,QAAQ,SAAS,MAAM,GAAG;EAChC,MAAM,MAAM;EACZ,IAAI,MAAM,KAAK,KAAK,QAAQ,MAAM,IAAI,MAAM,0BAA0B;EACtE,MAAM,QAAQ,KAAK,UAAU,GAAG,GAAG,MAAM,KAAK,UAAU,MAAM,CAAC,GAAG,MAAM,KAAK,UAAU,MAAM,CAAC;EAC9F,OAAO;EACP,IAAI,MAAM,MAAM,KAAK,QAAQ,MAAM,IAAI,MAAM,0BAA0B;EACvE,MAAM,QAAQ,UAAU,SAAS,QAAQ,WAAW,SAAS,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,GAAG;EACzG,IAAI,KAAK;GAAE,MAAM,MAAM;GAAM,MAAM;GAAO;GAAK,MAAM;EAAM,CAAC;EAC5D,OAAO;CACT;CACA,MAAM,yBAAS,IAAI,IAAI,CAAC,IAAI,CAAC;CAC7B,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO;EAChC,MAAM,QAAQ,IAAI,MAAK,MAAK,EAAE,SAAS,SAAS,SAAS,OAAO,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,WAAW,EAAE,IAAI,CAAC,CAAC;EAC9G,IAAI,CAAC,OAAO;EACZ,OAAO,IAAI,WAAW,MAAM,IAAI,CAAC;CACnC;CACA,OAAO;EAAE,OAAO,QAAQ;EAAQ,eAAe,CAAC,EAAE,QAAQ;EAAS,SAAS,IAAI,QAAO,MAAK,EAAE,SAAS,QAAQ,OAAO,IAAI,EAAE,IAAI,CAAC;CAAE;AACrI;;AAGA,SAAgB,SAAS,OAA2B;CAClD,MAAM,QAAsB,CAAC;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,SAAS;EACjC,MAAM,MAAM,MAAM;EAClB,IAAI,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,IAAI,MAAM,wBAAwB;EACxE,MAAM,KAAK,MAAM,SAAS,IAAI,GAAG,IAAI,IAAI,GAAG,CAAC;EAC7C,KAAK,IAAI;CACX;CACA,OAAO,IAAI,YAAY,SAAS,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,YAAY,GAAG,KAAK,CAAC;AAC/E;;;;AAQA,SAAgB,gBAAgB,SAA8B;CAC5D,IAAI,QAAQ,WAAW,GAAG;EACxB,MAAM,CAAC,GAAG,GAAG,KAAK;EAClB,OAAO,EAAE,MAAM,KAAK,MAAM,MAAM,MAAM,OAAO,KAAK,OAC/C,MAAM,OAAO,KAAK,MAAM,KAAK,OAAS,MAAM,OAAO,MAAM,OAAS,MAAM,OAAO,KAAK,MAAM,KAAK,MAC/F,MAAM,OAAO,MAAM,OAAS,MAAM,OAAO,MAAM,KAAK,MAAM,KAAO,MAAM,QAAQ,MAAM,MAAM,MAAM;CACtG;CACA,IAAI,QAAQ,WAAW,IAAI,OAAO;CAClC,MAAM,UAAU,MAAc,QAAQ,SAAS,GAAG,CAAC,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC;CACvE,IAAI,OAAO,EAAE,MAAM,QAAQ,QAAQ,KAAK,QAAQ,QAAQ,IAAI,OAAO;CACnE,IAAI,OAAO,EAAE,KAAK,QAAQ,QAAQ,OAAQ,QAAQ,QAAQ,KAAM,OAAO,gBAAgB,QAAQ,SAAS,EAAE,CAAC;CAC3G,IAAI,QAAQ,OAAO,KAAQ,QAAQ,OAAO,OAAQ,QAAQ,OAAO,OAAQ,QAAQ,OAAO,OAAQ,QAAQ,SAAS,GAAG,EAAE,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC,GACxI,OAAO,gBAAgB,QAAQ,SAAS,EAAE,CAAC;CAC7C,IAAI,OAAO,EAAE,GAAG,OAAO;CACvB,KAAK,QAAQ,KAAK,SAAU,KAAM,OAAO;CACzC,IAAI,QAAQ,OAAO,QAAS,QAAQ,KAAK,SAAU,KAAM,OAAO;CAChE,IAAI,QAAQ,OAAO,QAAS,QAAQ,KAAK,SAAU,KAAM,OAAO;CAChE,IAAI,QAAQ,OAAO,KAAM,OAAO;CAChC,IAAI,QAAQ,OAAO,KAAQ,QAAQ,SAAS,GAAG,CAAC,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC,GAAG,OAAO;CAC9E,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,GAAM,OAAO;CACvD,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,GAAM,OAAO;CACrG,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAM,OAAO;CACrG,QAAQ,QAAQ,KAAK,SAAU;AACjC;;;;;;ACvSA,IAAa,iBAAiB;CAAC;CAAa;CAAS;CAAY;CAAO;CAAQ;CAAa;CAAe;CAAY;AAAM;;AAG9H,IAAa,oBAAoB,SAA0B,eAAe,MAAK,MAAK,SAAS,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC;;;;;;;;;;;;ACexH,IAAa,kBAAkB;AAC/B,IAAa,cAAc;;CAEzB,gBAAgB;;CAEhB,iBAAiB;CACjB,mBAAmB;;CAEnB,OAAO;CACP,cAAc;CACd,wBAAwB;CACxB,kBAAkB;;;;;CAKlB,aAAa;AACf;;;;;;;;AAQA,IAAa,qBAAqB;AAGlC,IAAM,QAA2B;CAAC;CAAQ;CAAQ;CAAW;AAAU;AACvE,IAAM,UAAU;AAChB,IAAM,UAAU;AAChB,IAAM,MAAM;AACZ,IAAM,QAAQ,WAAW,MAAM;AAC/B,IAAM,UAAU;AAChB,IAAM,QAAQ;;AAEd,IAAM,YAAY;;AAyClB,IAAa,mBAAb,cAAsC,MAAM;CAGrB;;CADrB;CACA,YAAY,QAAqI,SAAiB;EAChK,MAAM,OAAO;EADM,KAAA,SAAA;CAErB;AACF;AAEA,IAAM,cAAc,SAAqB,YAAY,OAAO,IAAI,CAAC;AACjE,IAAM,mBAAmB,YAAY,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE;;;;;AAOjE,IAAa,WAAb,MAAsB;CACpB;CACA;CACA;CACA;;CAEA;;CAEA;CACA;CACA;CAEA,YAAY,QAAoB,sBAA8B,SAAiB;EAC7E,KAAK,OAAO,oBAAoB,OAAO,OAAO,CAAC,CAAC;EAChD,KAAK,KAAK,OAAO;EACjB,MAAM,OAAO,oBAAoB,oBAAoB;EACrD,KAAK,OAAO,KAAK;EACjB,KAAK,KAAK,KAAK;EACf,KAAK,OAAO;EACZ,MAAM,SAAS,cAAc,OAAO,SAAS;EAC7C,MAAM,UAAU,KAAK,UAAU,CAAC,kBAAkB,CAAC,KAAK,MAAM,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;EAC9E,MAAM,UAAU,UAAkB,KAAK,QAAQ,QAAQ,WAAW,OAAO,GAAG,WAAW,KAAK,GAAG,EAAE;EACjG,KAAK,WAAW,iBAAiB,OAAO,WAAW,KAAK,MAAM,CAAC;EAC/D,KAAK,cAAc,iBAAiB,OAAO,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC;EAClE,MAAM,SAAS,OAAO,gBAAgB,QAAQ,MAAM,mBAAmB,KAAK,IAAI,GAAG,QAAQ,MAAM,aAAa,iBAAiB,OAAO,CAAC,CAAC;EACxI,KAAK,UAAU,KAAK,QAAQ,QAAQ,OAAO,UAAU,GAAG,WAAW,yBAAyB,GAAG,EAAE;CACnG;;CAGA,KAAK,MAAgB,MAA8B;EACjD,MAAM,QAAQ,YAAY,KAAK;EAC/B,MAAM,MAAM,iBAAiB,KAAK,SAAS,KAAK,CAAC,CAAC,QAAQ,KAAK,MAAM,MAAM,IAAI,CAAC;EAChF,OAAO,YAAY,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG;CACjE;;;;;CAKA,MAAM,cAAc,MAAgB,MAAkB,MAA2E;EAC/H,OAAO,YAAY,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,GAAG,MAAM,KAAK,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC;CAC3F;;CAEA,MAAc,MAAgB,MAA8B;EAC1D,MAAM,SAAS;GAAC;GAAS,KAAK;GAAM,KAAK;GAAI,KAAK;GAAI,KAAK;GAAM,KAAK;GAAS,KAAK;GAAK,KAAK;GAAI,KAAK;GAAI,KAAK;GAAM,KAAK,QAAQ;GAAM,WAAW,IAAI;GAAG,KAAK;EAAO;EACvK,MAAM,YAAY,YAAY,KAAK,WAAW,KAAK,UAAU,CAAC,uBAAuB,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;EAC1G,MAAM,SAAS,WAAW,KAAK,UAAU,CAAC,QAAQ,SAAS,CAAC,CAAC;EAC7D,MAAM,yBAAS,IAAI,WAAW,CAAC;EAC/B,IAAI,SAAS,OAAO,MAAM,CAAC,CAAC,UAAU,GAAG,OAAO,MAAM;EACtD,OAAO,YAAY,QAAQ,QAAQ,IAAI;CACzC;;;;;;;;;;;;CAaA,KAAK,OAAmB,SAAgK,CAAC,GAAqE;EAC5P,MAAM,MAAM,OAAO,OAAO,KAAK,IAAI;EACnC,IAAI,MAAM,UAAU,OAAO,YAAY,YAAY,iBAAiB,MAAM,IAAI,iBAAiB,QAAQ,sCAAsC;EAC7I,IAAI,MAAM,SAAS,MAAM,SAAS,IAAI,KAAK,KAAK,CAAC,MAAM,OAAO,GAAG,MAAM,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC9I,MAAM,UAAU,MAAM,MAAM;EAC5B,IAAI,YAAY,YAAY,YAAY,aAAa,CAAC,OAAO,UAAU,MAAM,IAAI,iBAAiB,UAAU,gCAAgC;EAC5I,IAAI,OAA0B;EAC9B,IAAI,YAAY,WAAW;GACzB,YAAY,MAAM,SAAS,MAAM,SAAS,CAAC;GAC3C,IAAI;IAAE,QAAQ,OAAO,QAAS,SAAS;GAAG,QAAQ;IAAE,QAAQ;GAAM;GAClE,IAAI,CAAC,OAAO,MAAM,IAAI,iBAAiB,YAAY,wEAAwE;EAC7H,OAAO;GACL,IAAI,MAAM,SAAS,MAAM,SAAS,IAAI,QAAQ,KAAK,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;GAC5G,IAAI;IAAE,QAAQ,iBAAiB,KAAK,SAAS,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,SAAS,MAAM,SAAS,IAAI,KAAK,CAAC;GAAG,QACtJ;IAAE,MAAM,IAAI,iBAAiB,YAAY,mDAAmD;GAAG;EACvG;EACA,IAAI;GAAE,OAAO,KAAK,KAAK,OAAO,WAAW,QAAQ,GAAG;EAAG,SAChD,OAAO;GAEZ,IAAI,iBAAiB,oBAAoB,WAAW,MAAM,YAAY;GACtE,MAAM;EACR;CACF;;CAEA,KAAa,OAAmB,WAAmC,QAAyE,KAA+E;EACzN,IAAI,MAAM,SAAS,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC5E,MAAM,eAAe,IAAI,SAAS,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;EAChF,IAAI,eAAe,UAAc,IAAI,eAAe,MAAM,QAAQ,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EACxH,IAAI;EACJ,IAAI;GAAE,SAAS,KAAK,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC;EAAG,QAAQ;GAAE,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAAG;EAC/I,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,KAAK,CAAC,MAAM,QAAQ,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,WAAW,MAAM,OAAO,OAAO,OAAO,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC1N,MAAM,CAAC,QAAQ,aAAa;EAC5B,MAAM,CAAC,GAAG,MAAM,IAAI,QAAQ,WAAW,SAAS,KAAK,IAAI,IAAI,MAAM,MAAM,QAAQ,WAAW;EAC5F,IAAI,MAAM,WAAW,OAAO,SAAS,YAAY,OAAO,OAAO,YAAY,OAAO,WAAW,YAAY,OAAO,cAAc,YAAY,OAAO,YAAY,YAAY,CAAC,QAAQ,KAAK,OAAO,KAC5L,CAAC,OAAO,cAAc,GAAG,KAAM,MAAiB,KAAK,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAK,EAAE,KAAK,CAAC,OAAO,cAAc,EAAE,KAAM,MAAiB,KACnJ,OAAO,SAAS,YAAY,CAAC,MAAM,SAAS,IAAI,KAAK,OAAO,WAAW,YAAY,CAAC,OAAO,cAAc,OAAO,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAE3K,IAAI,SAAS,KAAK,MAAM,OAAO,KAAK,QAAQ,cAAc,KAAK,IAAI,MAAM,IAAI,iBAAiB,cAAc,mCAAmC;EAC/I,IAAI,WAAW,KAAK,MAAM,MAAM,IAAI,iBAAiB,UAAU,8CAA8C;EAC7G,IAAI,OAAO,WAAW,YAAY,OAAO,SAAS,MAAM,IAAI,iBAAiB,cAAc,uCAAuC;EAClI,IAAI;EACJ,IAAI;GAAE,QAAQ,OAAO,cAAc,SAAS,GAAG,WAAW,KAAK,UAAU,CAAC,uBAAuB,MAAM,CAAC,CAAC,GAAG,iBAAiB,MAAM,CAAC;EAAG,QAAQ;GAAE,QAAQ;EAAO;EAChK,IAAI,CAAC,OAAO,MAAM,IAAI,iBAAiB,aAAa,8CAA8C;EAClG,MAAM,OAAO,MAAM,SAAS,IAAI,YAAY;EAC5C,IAAI,WAAW,IAAI,MAAM,QAAQ,MAAM,IAAI,iBAAiB,UAAU,mDAAmD;EAMzH,IAAK,WAAuB,MAAkB,UAAqB,MAAM,YAAY,QAAQ,YAAY,aAAa,MAAM,IAAI,iBAAiB,UAAU,2CAA2C;EACtM,MAAM,SAAqB;GAAE,GAAG;GAAG;GAAM;GAAI;GAAQ;GAAW;GAAc;GAAe;GAAQ;GAAoB;GAAkB;GAAM;GAAiB;EAAkB;EAEpL,IAAI,CAAC,aAAa,OAAO,eAAe,SAAS,YAAY,MAAM,IAAI,iBAAiB,SAAS,mFAAmF;EACpL,UAAU,QAAQ,MAAM,OAAO,QAAQ;EACvC,OAAO;GAAE;GAAQ;GAAM,GAAI,aAAa,EAAE,UAAU;EAAG;CACzD;;CAGA,eAAe,SAAsB,MAAM,KAAK,IAAI,GAAkB;EACpE,MAAM,OAAO;GAAC;GAAS,QAAQ;GAAK,QAAQ;GAAQ,QAAQ;GAAS,QAAQ;GAAa,QAAQ;GAAK,QAAQ;GAAK,QAAQ;GAAO,QAAQ;GAAO,QAAQ,QAAQ,MAAM,GAAG;EAAC;EAC5K,MAAM,YAAY,YAAY,KAAK,WAAW,KAAK,UAAU;GAAC;GAAwB,KAAK;GAAM,KAAK;GAAI;EAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;EAC7H,MAAM,MAAM,KAAK,IAAI,OAAW,KAAK,IAAI,IAAI,KAAK,MAAM,QAAQ,UAAU,OAAO,GAAI,CAAC,CAAC;EACvF,MAAM,UAAU,CAAC;GAAE,OAAO;GAAS,OAAO,QAAQ,KAAK,UAAU,CAAC,MAAM,SAAS,CAAC,GAAG,KAAK,OAAO;GAAG;EAAI,CAAC;EACzG,IAAI,eAAe,KAAK,SAAS,WAAW,OAAO,IAAA,KAA0B,MAAM,IAAI,MAAM,qFAAqF;EAClL,OAAO;CACT;;;;;;CAOA,YAAY,QAAsB,WAAW,OAA2B;EACtE,IAAI,OAAO,cAAc,KAAK,eAAe,eAAe,OAAO,WAAW,OAAO,OAAO,IAAA,KAA0B,OAAO;EAC7H,MAAM,UAAU,OAAO,QAAQ,QAAO,MAAK,EAAE,UAAU,OAAO;EAC9D,IAAI,QAAQ,WAAW,GAAG,OAAO;EACjC,MAAM,QAAQ,WAAW,QAAQ,EAAE,CAAC,OAAO,KAAK,OAAO;EACvD,IAAI,CAAC,OAAO,OAAO;EACnB,IAAI;EACJ,IAAI;GAAE,SAAS,KAAK,MAAM,KAAK;EAAG,QAAQ;GAAE,OAAO;EAAM;EACzD,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,KAAK,CAAC,MAAM,QAAQ,OAAO,EAAE,KAAM,OAAO,EAAE,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC,WAAW,MAAO,OAAO,OAAO,OAAO,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,GAAG,OAAO;EACvM,MAAM,CAAC,MAAM,aAAa;EAC1B,MAAM,CAAC,GAAG,KAAK,QAAQ,SAAS,aAAa,KAAK,KAAK,OAAO,OAAO,UAAU,CAAC,KAAK;EACrF,IAAI,MAAM,WAAW,CAAC;GAAC;GAAK;GAAQ;GAAS;GAAK;GAAK;GAAO;EAAK,CAAC,CAAC,OAAM,MAAK,OAAO,cAAc,CAAC,KAAM,KAAgB,CAAC,KAC1H,gBAAgB,QAAQ,CAAC,UAAU,aAAa,QAAQ,KACzD,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,MAAM,CAAC,QAAQ,OAAM,MAAK,OAAO,cAAc,CAAC,KAAM,IAAe,CAAC,GAAG,OAAO;EAC9H,IAAI;GACF,IAAI,CAAC,OAAO,cAAc,SAAS,GAAG,WAAW,KAAK,UAAU;IAAC;IAAwB,KAAK;IAAI,KAAK;IAAM;GAAI,CAAC,CAAC,GAAG,iBAAiB,KAAK,IAAI,CAAC,GAAG,OAAO;EAC7J,QAAQ;GAAE,OAAO;EAAM;EACvB,OAAO;GAAO;GAAuB;GAA2B;GAAgC;GAAmC;GAAoB;GAAsB;GAAwB;GAA0B;EAAoB;CACrP;AACF;;;;;;;;;AAUA,SAAgB,UAAU,OAAgB,WAAW,OAAwB;CAC3E,IAAI,OAAO,UAAU,YAAY,MAAM,SAAS,MAAM,OAAO;CAC7D,IAAI;CACJ,IAAI;EAAE,MAAM,IAAI,IAAI,KAAK;CAAG,QAAQ;EAAE,OAAO;CAAO;CACpD,IAAI,IAAI,YAAY,IAAI,UAAU,OAAO;CACzC,MAAM,OAAO,IAAI,SAAS,YAAY,CAAC,CAAC,QAAQ,QAAQ,EAAE;CAC1D,IAAI,YAAY,IAAI,aAAa,WAAW;EAAC;EAAa;EAAa;CAAO,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;CACvG,IAAI,IAAI,aAAa,YAAY,CAAC,KAAK,SAAS,GAAG,KAAK,KAAK,WAAW,GAAG,KAAK,iBAAiB,IAAI,GAAG,OAAO;CAE/G,OAAO,CAAC,uBAAuB,KAAK,IAAI,KAAK,gBAAgB,WAAW,KAAK,KAAK,MAAM,GAAG,GAAG,MAAM,CAAC;AACvG;;AAGA,SAAS,UAAU,QAAoB,MAAkB,WAAW,OAAa;CAC/E,MAAM,OAAO,YAAoB,IAAI,iBAAiB,UAAU,OAAO;CACvE,QAAQ,OAAO,MAAf;EACE,KAAK;GACH,IAAI,KAAK,SAAS,YAAY,cAAc,MAAM,IAAI,2BAA2B;GACjF,IAAI;IAAE,WAAW,IAAI;GAAG,QAAQ;IAAE,MAAM,IAAI,2BAA2B;GAAG;GAC1E;EACF,KAAK;GACH,IAAI,KAAK,SAAS,YAAY,wBAAwB,MAAM,IAAI,uCAAuC;GACvG;EACF,KAAK,QAAQ;GACX,MAAM,OAAO,OAAO;GACpB,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,OAAO,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,OAAO,KAAK,SAAS,KAAK,QAAQ,MAAM,IAAI,8CAA8C;GAClP;EACF;EACA,KAAK;GACH,IAAI,KAAK,WAAW,GAAG,MAAM,IAAI,4BAA4B;GAC7D,aAAa,OAAO,MAAM,QAAQ;GAClC;CAEJ;AACF;;AAGA,SAAgB,aAAa,MAAe,WAAW,OAA4B;CACjF,MAAM,OAAO,YAAoB,IAAI,iBAAiB,UAAU,OAAO;CACvE,MAAM,UAAW,MAAuC;CACxD,IAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,YAAY,mBAAmB,MAAM,IAAI,mCAAmC;CAC5H,IAAI,OAAO,GAAG,QAAQ;CACtB,MAAM,MAA2B,CAAC;CAClC,KAAK,MAAM,SAAS,SAAS;EAC3B,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAAG,MAAM,IAAI,2BAA2B;EACtF,MAAM,CAAC,KAAK,IAAI,MAAM,OAAO,KAAK,WAAW;EAC7C,IAAI,CAAC,OAAO,cAAc,GAAG,KAAK,OAAO,QAAQ,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAK,EAAE,KAAK,OAAO,SAAS,YAAY,CAAC,MAAM,SAAS,IAAI,KAAK,SAAS,cAC5J,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,KAAK,QAAQ,YAAY,kBAAkB,CAAC,UAAU,KAAK,QAAQ,KAAK,CAAC,OAAO,cAAc,OAAO,GAAG,MAAM,IAAI,2BAA2B;EACvL,OAAO;EAAK,SAAS;EACrB,IAAI,QAAQ,YAAY,iBAAiB,MAAM,IAAI,iDAAiD;EACpG,IAAI,KAAK;GAAC;GAAK;GAAI;GAA8B;GAAO;GAAK;EAAO,CAAC;CACvE;CACA,OAAO;AACT;;ACzUA,IAAa,aAAa;CAAC;CAAU;CAAc;AAAU;AA2C7D,SAAgB,aAAa,OAAe,WAA8B,UAAkB;CAC1F,IAAI;CACJ,IAAI;EAAE,MAAM,IAAI,IAAI,KAAK;CAAG,QAAQ;EAAE,OAAO;CAAO;CACpD,MAAM,OAAO,IAAI,UAAU,OAAO,KAAK,QAAQ,OAAO,EAAE;CACxD,IAAI,CAAC,KAAK,SAAS,GAAG,KAAK,SAAS,aAAa,OAAO;CACxD,IAAI,KAAK,WAAW,GAAG,KAAK,kBAAkB,KAAK,IAAI,GAAG,OAAO;CACjE,MAAM,SAAS,aAAa,YAAY,oBAAoB,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK;CACtF,IAAI,WAAW,MAAM,OAAO;CAC5B,IAAI,WAAW;CACf,OAAO,IAAI;AACb;;AAGA,SAAgB,eAAkB,YAAe,WAA8B,UAAa;CAC1F,MAAM,QAAS,YAAuD;CACtE,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,MAAM,YAAY,aAAa,OAAO,QAAQ;CAC9C,OAAO,cAAc,QAAQ,aAAa;EAAE,GAAG;EAAY,OAAO;CAAU;AAC9E;;;;;AAMA,IAAa,YAAY;;;;;;AAMzB,IAAa,qBAAqB;;AAElC,IAAa,YAAY,UAAoC,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK,KAAK,CAAC,mBAAmB,KAAK,KAAK;;AAEjJ,IAAM,uBAAuB;;;;;AAK7B,IAAa,mBAAmB,UAA2B,CAAC,SAAS,KAAK,KAAK,CAAC,mBAAmB,KAAK,KAAK,KAAK,qBAAqB,KAAK,KAAK;;;;;;;;AAQjJ,SAAgB,kBAAkB,OAAgB,KAAiC;CACjF,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;CAClD,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO;CAC7B,MAAM,QAAQ,GAAW,MAAc;EAAE,IAAI;GAAE,OAAO,IAAI,IAAI,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;EAAM,QAAQ;GAAE,OAAO;EAAO;CAAE;CACnK,OAAO,IAAI,MAAK,SAAQ,KAAK,MAAM,KAAK,CAAC,KAAK,UAAU,KAAK;AAC/D;AACA,IAAM,UAAU;;AAEhB,IAAM,iBAAiB;AACvB,IAAM,gBAAgB;;;;;;;;AAStB,SAAgB,mBAAmB,OAAsC;CACvE,MAAM,MAA4B,CAAC;CACnC,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,OAAO;CACxE,MAAM,MAAM;CACZ,MAAM,WAAW,MAAe,MAAM,KAAA,KAAa,OAAO,MAAM;CAChE,MAAM,OAAO,IAAI;CACjB,IAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,OAAO,YAAY,QAAQ,KAAK,KAAK,EAAE,MACxF,KAAK,UAAU,KAAA,KAAa,KAAK,UAAU,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,OAAO,KACjG,MAAM,QAAQ,KAAK,SAAS,KAAK,KAAK,UAAU,UAAU,iBAC1D,KAAK,UAAU,OAAM,MAAK,OAAO,MAAM,YAAY,eAAe,KAAK,CAAC,CAAC,GACzE,IAAI,YAAY;EAAE,IAAI,KAAK;EAAI,OAAQ,KAAK,SAAuC;EAAM,WAAW,CAAC,GAAG,KAAK,SAAS;EACpH,GAAI,KAAK,YAAY,KAAA,IAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAAG;CACrE,MAAM,QAAQ,IAAI;CAClB,IAAI,SAAS,OAAO,UAAU,YAAY,OAAO,MAAM,cAAc,YAAY,QAAQ,KAAK,MAAM,SAAS,MAC1G,MAAM,UAAU,KAAA,KAAa,SAAS,MAAM,KAAK,MAAM,QAAQ,MAAM,OAAO,GAC7E,IAAI,gBAAgB;EAAE,WAAW,MAAM;EAAW,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC1G,GAAI,MAAM,YAAY,KAAA,IAAY,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;CAAG;CACvE,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAA6B,QAAiD;CAC9G,MAAM,aAAa,WAA4B,eAAiC;EAC9E,IAAI,CAAC,cAAc,OAAO,eAAe,UAAU,OAAO;EAC1D,MAAM,IAAI;EACV,OAAO,EAAE,YAAY,QAAS,cAAc,YAAY,MAAM,QAAQ,EAAE,SAAS,KAAK,EAAE,UAAU,WAAW;CAC/G;CACA,OAAQ,CAAC,UAAU,YAAY,CAAC,CAAW,QAAO,MAAK,UAAU,GAAG,MAAM,EAAE,KAAK,UAAU,GAAG,OAAO,EAAE,CAAC;AAC1G;;;;;;;AAQA,SAAgB,eAAe,OAA0B,QAA2B,UAA6B,CAAC,GAAsB;CACtI,MAAM,WAAW,MAAuB,MAAM,YAAY,QAAQ,SAAS,CAAC,IAAI,IAAI;CACpF,OAAO,WAAW,QAAO,MAAK,MAAM,SAAS,CAAC,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC,CACnE,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAChC,MAAM,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAM,MAAM,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,MAC7E,WAAW,QAAQ,CAAC,IAAI,WAAW,QAAQ,CAAC,CAAC;AACtD;;;;;;;;AASA,IAAa,kBAA8C;CAAC;CAAU;CAAY;AAAY;AAC9F,SAAgB,mBAAmB,WAAuC,WAAW,MAAuB;CAC1G,IAAI,CAAC,UAAU,OAAO,UAAU,SAAS,UAAU,IAAI,aAAa,WAAW,MAAK,MAAK,UAAU,SAAS,CAAC,CAAC,KAAK;CACnH,OAAO,gBAAgB,MAAK,MAAK,UAAU,SAAS,CAAC,CAAC,KAAK;AAC7D;AAEA,SAAgB,eAAe,WAAuC,WACpE,UAAsC;CACtC,MAAM,OAAO,WAAW,QAAO,MAAK,UAAU,SAAS,CAAC,KAAK,MAAM,SAAS;CAC5E,OAAO,CAAC,GAAI,UAAU,SAAS,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,GAAI,GAAI,WAAW,OAAO,CAAC,CAAE;AAC1F"}
|
|
1
|
+
{"version":3,"file":"pairedTransports-CQGJfihi.js","names":[],"sources":["../../core/src/crypto.ts","../../core/src/domainProofs.ts","../../core/src/localNames.ts","../../core/src/storeForward.ts","../../core/src/pairedTransports.ts"],"sourcesContent":["import { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { concatBytes, fromBase64, randomBytes, toBase64, utf8Decode, utf8Encode } from \"./bytes\";\n\nconst NONCE_LENGTH = 24;\nconst KEY_LENGTH = 32;\n\nexport function generateEncryptionKey(): Uint8Array {\n return randomBytes(KEY_LENGTH);\n}\n\n/**\n * NaCl secretbox (XSalsa20-Poly1305). Wire format matches the Rust\n * implementation in `apps/desktop/src/crypto.rs`: base64(nonce || box).\n */\nexport function encrypt(plaintext: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const nonce = randomBytes(NONCE_LENGTH);\n const box = xsalsa20poly1305(key, nonce).encrypt(utf8Encode(plaintext));\n return toBase64(concatBytes(nonce, box));\n}\n\n/** The length of what `encrypt` returns for a plaintext of this many UTF-8 bytes: base64 of nonce, box and 16-byte tag. */\nexport function sealedLength(plaintextBytes: number): number {\n return 4 * Math.ceil((NONCE_LENGTH + 16 + plaintextBytes) / 3);\n}\n\nexport function decrypt(encoded: string, key: Uint8Array): string {\n if (key.length !== KEY_LENGTH) throw new Error(\"Invalid key length: expected 32 bytes\");\n const combined = fromBase64(encoded);\n if (combined.length < NONCE_LENGTH + 1) throw new Error(\"Invalid ciphertext: too short\");\n const nonce = combined.subarray(0, NONCE_LENGTH);\n const box = combined.subarray(NONCE_LENGTH);\n return utf8Decode(xsalsa20poly1305(key, nonce).decrypt(box));\n}\n\nexport function tryDecrypt(encoded: string, key: Uint8Array): string | null {\n try {\n return decrypt(encoded, key);\n } catch {\n return null;\n }\n}\n","import { concatBytes, fromZ32, toZ32, utf8Decode, utf8Encode } from './bytes';\n\n/**\n * Domain identity proofs (draft WISP 304, docs/wisps/304-domain.md), the pure half.\n *\n * Under WISP 300 a proof authorizes a fresh Ed25519 *proof key* that only this\n * profile holds, through a statement the external identity vouches for. A\n * domain vouches by publishing: a DNS TXT record at `_ghostly.<domain>` or a\n * `/.well-known/ghostly.json` file names the proof key **and the statement id**\n * (SHA-256 of the statement), so the record commits to the exact binding —\n * subject, key, dates and nonce — not just to a key. Sharing with a contact is\n * then the contract's per-contact presentation, signed by the proof key.\n *\n * People who already run NIP-05 can use `/.well-known/nostr.json` instead: its\n * root name `_` must be the very Nostr key that signed the statement.\n *\n * The record names no participation key and no contact. Fetching, DNS over\n * HTTPS and caching live in `@ghostly/browser/proofs/domain`.\n */\n\nexport type DomainMethod = 'dns' | 'https' | 'nip05';\n/** What a record says: this Ghostly proof key, for this statement. */\nexport interface DomainRecord { key: string; proof: string }\n\nexport const DOMAIN_METHODS: readonly DomainMethod[] = ['dns', 'https', 'nip05'];\nexport const DNS_LABEL = '_ghostly';\nexport const WELL_KNOWN_PATH = '/.well-known/ghostly.json';\nexport const NIP05_PATH = '/.well-known/nostr.json?name=_';\n/** Everything read from a domain is bounded; these match the fetch limits. */\nexport const DOMAIN_FILE_MAX_BYTES = 16 * 1024;\nexport const DOMAIN_TXT_MAX_BYTES = 1024;\nexport const DOMAIN_MAX_RECORDS = 8;\n\nconst z32 = /^[ybndrfg8ejkmcpqxot1uwisza345h769]{52}$/;\nconst hex64 = /^[a-f0-9]{64}$/;\n\n// ---------------------------------------------------------------------------\n// Domain names\n\n/** Names that never resolve publicly (RFC 6761, 6762, 7686, 8375, 9476) or that\n * only ever mean a private network. A proof for them could only point inward. */\nconst SPECIAL_USE = ['localhost', 'local', 'internal', 'lan', 'home', 'corp', 'intranet', 'private',\n 'test', 'example', 'invalid', 'onion', 'alt', 'arpa'];\n\n/**\n * Normalizes what a person typed (\"Example.COM.\", \"https://example.com/\") into\n * a lowercase ASCII host name, or throws with a message fit for the UI.\n * Internationalized names become punycode (xn--), the form DNS carries.\n */\nexport function normalizeDomain(input: string): string {\n if (typeof input !== 'string') throw new Error('Enter a domain name, like example.com');\n let value = input.trim();\n if (!value || value.length > 300) throw new Error('Enter a domain name, like example.com');\n if (/^[a-z][a-z0-9+.-]*:\\/\\//i.test(value)) {\n let url: URL;\n try { url = new URL(value); } catch { throw new Error('Enter a domain name, like example.com'); }\n if (url.protocol !== 'https:' || url.username || url.password || url.port || (url.pathname !== '/' && url.pathname !== '') || url.search || url.hash)\n throw new Error('Enter only the domain name, without a path or port');\n value = url.hostname;\n } else {\n if (/[/:@?#\\s\\\\]/.test(value)) throw new Error('Enter only the domain name, without a path or port');\n try { value = new URL(`https://${value}`).hostname; } catch { throw new Error('That is not a valid domain name'); }\n }\n value = value.toLowerCase().replace(/\\.$/, '');\n if (value.length > 253 - DNS_LABEL.length - 1) throw new Error('That domain name is too long');\n const labels = value.split('.');\n if (labels.length < 2) throw new Error('Use a full domain name, like example.com');\n for (const label of labels) {\n if (!/^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/.test(label)) throw new Error('That is not a valid domain name');\n }\n const tld = labels[labels.length - 1];\n if (/^[0-9]+$/.test(tld) || /^\\[/.test(value)) throw new Error('Use a domain name, not an IP address');\n if (SPECIAL_USE.includes(tld) || (labels.length >= 2 && labels.slice(-2).join('.') === 'home.arpa'))\n throw new Error('That name only works on private networks');\n return value;\n}\n\nexport const dnsProofName = (domain: string) => `${DNS_LABEL}.${normalizeDomain(domain)}`;\nexport const wellKnownUrl = (domain: string, method: 'https' | 'nip05' = 'https') =>\n `https://${normalizeDomain(domain)}${method === 'nip05' ? NIP05_PATH : WELL_KNOWN_PATH}`;\n\n// ---------------------------------------------------------------------------\n// Records\n\nexport function validDomainRecord(r: DomainRecord): boolean {\n if (!r || typeof r.key !== 'string' || typeof r.proof !== 'string' || !z32.test(r.key) || !hex64.test(r.proof)) return false;\n try { return toZ32(fromZ32(r.key)) === r.key; } catch { return false; }\n}\n\n/** The TXT record value, in the `tag=value; …` style people know from DKIM. */\nexport function domainTxtRecord(r: DomainRecord): string {\n if (!validDomainRecord(r)) throw new Error('Invalid domain record');\n return `v=ghostly1; key=${r.key}; proof=${r.proof}`;\n}\n\n/** Parses one TXT string. Undefined for anything that is not ours or not exactly\n * well-formed; unknown extra tags are ignored for forward compatibility. */\nexport function parseDomainTxt(value: string): DomainRecord | undefined {\n if (typeof value !== 'string' || utf8Encode(value).length > DOMAIN_TXT_MAX_BYTES) return;\n const tags = new Map<string, string>();\n const parts = value.split(';').map(p => p.trim()).filter(Boolean);\n for (const part of parts) {\n const eq = part.indexOf('=');\n if (eq < 1) return;\n const name = part.slice(0, eq).trim().toLowerCase();\n if (tags.has(name)) return;\n tags.set(name, part.slice(eq + 1).trim());\n }\n if (!parts[0]?.toLowerCase().startsWith('v=') || tags.get('v') !== 'ghostly1') return;\n const r = { key: tags.get('key'), proof: tags.get('proof') } as DomainRecord;\n return validDomainRecord(r) ? r : undefined;\n}\n\nconst addRecord = (list: DomainRecord[], r: DomainRecord) => {\n if (!list.some(x => x.key === r.key && x.proof === r.proof)) list.push(r);\n};\n\n/** All records among the first 32 TXT strings of `_ghostly.<domain>`; other strings are skipped. A TXT set has\n * no order, so every record is kept: the one a proof needs may come in any position. */\nexport function recordsFromTxt(values: string[]): DomainRecord[] {\n const out: DomainRecord[] = [];\n for (const value of values.slice(0, 32)) { const r = parseDomainTxt(value); if (r) addRecord(out, r); }\n return out;\n}\n\n/** The body of `/.well-known/ghostly.json`. */\nexport function domainWellKnownFile(records: DomainRecord[]): string {\n if (!records.length || records.length > DOMAIN_MAX_RECORDS || !records.every(validDomainRecord)) throw new Error('Invalid domain records');\n return JSON.stringify({ ghostly: 1, proofs: records.map(r => ({ key: r.key, proof: r.proof })) }, null, 2) + '\\n';\n}\n\nfunction parseJson(text: string): unknown {\n if (typeof text !== 'string' || utf8Encode(text).length > DOMAIN_FILE_MAX_BYTES) throw new Error('File too large');\n return JSON.parse(text);\n}\n\n/** Records from the first 32 entries of `ghostly.json`. Throws on a malformed file; [] when it names none. */\nexport function recordsFromWellKnown(text: string): DomainRecord[] {\n const body = parseJson(text) as { ghostly?: unknown; proofs?: unknown };\n if (!body || typeof body !== 'object' || Array.isArray(body) || body.ghostly !== 1 || !Array.isArray(body.proofs))\n throw new Error('Not a Ghostly domain file');\n const out: DomainRecord[] = [];\n for (const entry of body.proofs.slice(0, 32) as { key?: unknown; proof?: unknown }[]) {\n if (!entry || typeof entry !== 'object') continue;\n const r = { key: entry.key, proof: entry.proof } as DomainRecord;\n if (validDomainRecord(r)) addRecord(out, r);\n }\n return out;\n}\n\n/** NIP-05: only the root name `_` speaks for the domain itself. Undefined when absent. */\nexport function nip05RootKey(text: string): string | undefined {\n const body = parseJson(text) as { names?: unknown };\n if (!body || typeof body !== 'object' || !body.names || typeof body.names !== 'object' || Array.isArray(body.names))\n throw new Error('Not a NIP-05 file');\n const root = (body.names as Record<string, unknown>)['_'];\n return typeof root === 'string' && hex64.test(root) ? root : undefined;\n}\n\nexport const recordsName = (records: DomainRecord[], r: DomainRecord) => records.some(x => x.key === r.key && x.proof === r.proof);\n\n// ---------------------------------------------------------------------------\n// DNS over HTTPS (RFC 8484) wire messages\n\nexport const DNS_TYPE = { A: 1, CNAME: 5, TXT: 16, AAAA: 28 } as const;\nexport type DnsType = keyof typeof DNS_TYPE;\nexport interface DnsAnswer { name: string; type: number; ttl: number; data: Uint8Array }\nexport interface DnsResponse {\n /** 0 = NOERROR, 3 = NXDOMAIN; anything else is a failed lookup. */\n rcode: number;\n /** The resolver reports it validated the answer with DNSSEC. */\n authenticated: boolean;\n answers: DnsAnswer[];\n}\n\n/**\n * EDNS0 OPT record (RFC 6891) with one Client Subnet option of source prefix 0 (RFC 7871 §7.1.2): a resolver must\n * not add this device's subnet to its queries to the name's servers, as Google Public DNS otherwise does.\n */\nconst NO_CLIENT_SUBNET = Uint8Array.of(0, 0, 41, 1232 >> 8, 1232 & 0xff, 0, 0, 0, 0, 0, 8, 0, 8, 0, 4, 0, 1, 0, 0);\n\n/** A recursive query for one name and type. ID 0, as RFC 8484 recommends for caching;\n * the AD bit asks the resolver to report DNSSEC validation (RFC 6840 §5.7). */\nexport function encodeDnsQuery(name: string, type: DnsType): Uint8Array {\n const labels = name.replace(/\\.$/, '').split('.');\n const parts: Uint8Array[] = [Uint8Array.of(0, 0, 0x01, 0x20, 0, 1, 0, 0, 0, 0, 0, 1)];\n for (const label of labels) {\n const bytes = utf8Encode(label);\n if (!bytes.length || bytes.length > 63) throw new Error('Invalid DNS name');\n parts.push(Uint8Array.of(bytes.length), bytes);\n }\n const code = DNS_TYPE[type];\n parts.push(Uint8Array.of(0, code >> 8, code & 0xff, 0, 1), NO_CLIENT_SUBNET);\n return concatBytes(...parts);\n}\n\nfunction readName(data: Uint8Array, start: number): { name: string; next: number } {\n const labels: string[] = [];\n let pos = start, next = -1, jumps = 0, length = 0;\n for (;;) {\n if (pos >= data.length) throw new Error('DNS name out of bounds');\n const len = data[pos];\n if ((len & 0xc0) === 0xc0) {\n if (pos + 1 >= data.length) throw new Error('DNS pointer out of bounds');\n if (next < 0) next = pos + 2;\n pos = ((len & 0x3f) << 8) | data[pos + 1];\n if (++jumps > 32) throw new Error('DNS name loops');\n continue;\n }\n if (len & 0xc0) throw new Error('Unsupported DNS label');\n pos += 1;\n if (len === 0) break;\n if (pos + len > data.length) throw new Error('DNS label out of bounds');\n length += len + 1;\n if (length > 255) throw new Error('DNS name too long');\n labels.push(utf8Decode(data.subarray(pos, pos + len)).toLowerCase());\n pos += len;\n }\n return { name: labels.join('.'), next: next < 0 ? pos : next };\n}\n\n/**\n * Decodes a resolver's answer to `encodeDnsQuery(name, type)`. Refuses a reply\n * to another question or a truncated one, and keeps only records of the asked\n * type owned by the name or by the CNAME chain the answer itself follows.\n */\nexport function decodeDnsResponse(data: Uint8Array, name: string, type: DnsType): DnsResponse {\n if (data.length < 12) throw new Error('DNS response too short');\n const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n const flags = view.getUint16(2);\n if (!(flags & 0x8000) || (flags & 0x7800) || (flags & 0x0200)) throw new Error('Unusable DNS response');\n const questions = view.getUint16(4), count = view.getUint16(6);\n const want = name.replace(/\\.$/, '').toLowerCase(), code = DNS_TYPE[type];\n if (questions !== 1) throw new Error('DNS response is for another question');\n const q = readName(data, 12);\n if (q.name !== want || q.next + 4 > data.length || view.getUint16(q.next) !== code) throw new Error('DNS response is for another question');\n let pos = q.next + 4;\n const all: DnsAnswer[] = [];\n for (let i = 0; i < count && i < 64; i++) {\n const owner = readName(data, pos);\n pos = owner.next;\n if (pos + 10 > data.length) throw new Error('DNS record out of bounds');\n const rtype = view.getUint16(pos), ttl = view.getUint32(pos + 4), len = view.getUint16(pos + 8);\n pos += 10;\n if (pos + len > data.length) throw new Error('DNS record out of bounds');\n const rdata = rtype === DNS_TYPE.CNAME ? utf8Encode(readName(data, pos).name) : data.slice(pos, pos + len);\n all.push({ name: owner.name, type: rtype, ttl, data: rdata });\n pos += len;\n }\n const owners = new Set([want]);\n for (let hop = 0; hop < 8; hop++) {\n const cname = all.find(a => a.type === DNS_TYPE.CNAME && owners.has(a.name) && !owners.has(utf8Decode(a.data)));\n if (!cname) break;\n owners.add(utf8Decode(cname.data));\n }\n return { rcode: flags & 0x000f, authenticated: !!(flags & 0x0020), answers: all.filter(a => a.type === code && owners.has(a.name)) };\n}\n\n/** The TXT character-strings of one record, joined as RFC 7208 §3.3 does. */\nexport function txtValue(rdata: Uint8Array): string {\n const parts: Uint8Array[] = [];\n for (let p = 0; p < rdata.length;) {\n const len = rdata[p];\n if (p + 1 + len > rdata.length) throw new Error('DNS text out of bounds');\n parts.push(rdata.subarray(p + 1, p + 1 + len));\n p += 1 + len;\n }\n return new TextDecoder('utf-8', { fatal: true }).decode(concatBytes(...parts));\n}\n\n// ---------------------------------------------------------------------------\n// Addresses: a proof may only make a contact's app fetch from the public Internet\n\n/** False for loopback, private, link-local, shared (CGNAT), multicast, reserved\n * and unspecified addresses, including IPv4 embedded in IPv6, and for 6to4, Teredo and documentation IPv6, as\n * Desktop's link_preview::is_public and apps/ui/src/lib/localHost.ts refuse them. */\nexport function isPublicAddress(address: Uint8Array): boolean {\n if (address.length === 4) {\n const [a, b, c] = address;\n return !(a === 0 || a === 10 || a === 127 || a >= 224 ||\n (a === 100 && b >= 64 && b <= 127) || (a === 169 && b === 254) || (a === 172 && b >= 16 && b <= 31) ||\n (a === 192 && b === 168) || (a === 192 && b === 0 && c === 0) || (a === 198 && (b === 18 || b === 19)));\n }\n if (address.length !== 16) return false;\n const zeroTo = (n: number) => address.subarray(0, n).every(x => x === 0);\n if (zeroTo(15) && (address[15] === 0 || address[15] === 1)) return false; // :: and ::1\n if (zeroTo(10) && address[10] === 0xff && address[11] === 0xff) return isPublicAddress(address.subarray(12)); // ::ffff:a.b.c.d\n if (address[0] === 0x00 && address[1] === 0x64 && address[2] === 0xff && address[3] === 0x9b && address.subarray(4, 12).every(x => x === 0))\n return isPublicAddress(address.subarray(12)); // 64:ff9b::/96 NAT64\n if (zeroTo(12)) return false; // deprecated IPv4-compatible\n if ((address[0] & 0xfe) === 0xfc) return false; // fc00::/7 unique local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0x80) return false; // fe80::/10 link-local\n if (address[0] === 0xfe && (address[1] & 0xc0) === 0xc0) return false; // fec0::/10 site-local\n if (address[0] === 0xff) return false; // multicast\n if (address[0] === 0x01 && address.subarray(1, 8).every(x => x === 0)) return false; // 100::/64 discard\n if (address[0] === 0x20 && address[1] === 0x02) return false; // 2002::/16 6to4: carries an IPv4 address a gateway may reach\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x00 && address[3] === 0x00) return false; // 2001::/32 Teredo, the same\n if (address[0] === 0x20 && address[1] === 0x01 && address[2] === 0x0d && address[3] === 0xb8) return false; // 2001:db8::/32 documentation\n return (address[0] & 0xe0) === 0x20; // only 2000::/3 is global unicast\n}\n","/**\n * Names only a local network answers (RFC 6762, RFC 8375, ICANN's .internal, and the usual router and company ones).\n * The same list as apps/ui/src/lib/localHost.ts and Desktop's apps/desktop/src/local_names.rs (a test there pins them).\n */\nexport const LOCAL_SUFFIXES = [\"localhost\", \"local\", \"internal\", \"lan\", \"home\", \"home.arpa\", \"localdomain\", \"intranet\", \"corp\"] as const;\n\n/** Whether a lowercase host with no trailing dot is one of `LOCAL_SUFFIXES` or under one. */\nexport const underLocalSuffix = (host: string): boolean => LOCAL_SUFFIXES.some(s => host === s || host.endsWith(`.${s}`));\n","import { ed25519, x25519 } from \"@noble/curves/ed25519.js\";\nimport { xsalsa20poly1305 } from \"@noble/ciphers/salsa.js\";\nimport { hkdf } from \"@noble/hashes/hkdf.js\";\nimport { sha256 } from \"@noble/hashes/sha2.js\";\nimport { concatBytes, fromBase64Url, randomBytes, toBase64Url, utf8Decode, utf8Encode } from \"./bytes\";\nimport { encrypt, tryDecrypt } from \"./crypto\";\nimport { isPublicAddress } from \"./domainProofs\";\nimport { identityFromSeed, identityFromSeedB64, publicKeyFromZ32, sign, verify, type Identity } from \"./identity\";\nimport type { LinkParams } from \"./invite\";\nimport { underLocalSuffix } from \"./localNames\";\nimport { measureRecords, MAX_DNS_PACKET_BYTES, type GhostRecord, type SignedPacket } from \"./pkarr\";\n\n/**\n * Store-and-forward for an away contact (WISP 404 draft, `hold/1`).\n *\n * What a person sends while the contact is away is sealed into a *bundle* (signed by the sender's\n * participation key, then encrypted to a key only the two of them can derive), put in the sender's\n * own storage (WISP 1000), and named in a *manifest* the storage also holds. A small signed, encrypted\n * *pointer* record on a per-link Pkarr key tells the contact where the manifest is (a URL that expires)\n * and which of the contact's own bundles have been received. Storage and relays see ciphertext, sizes\n * and timing only. Nothing here promises forward secrecy or retention beyond the bounds below.\n */\nexport const HOLD_CAPABILITY = \"hold/1\" as const;\nexport const HOLD_LIMITS = {\n /** One bundle, ciphertext and header included: a picture, not a video. */\n maxBundleBytes: 8 * 1024 * 1024,\n /** All bundles held for one contact at once. */\n maxMailboxBytes: 64 * 1024 * 1024,\n maxMailboxBundles: 64,\n /** A bundle not picked up by then is dropped by its sender. The longest a presigned URL lives, too. */\n ttlMs: 7 * 24 * 60 * 60_000,\n maxTextBytes: 16 * 1024,\n maxPaymentRequestBytes: 64 * 1024,\n maxManifestBytes: 64 * 1024,\n /**\n * How far past one lifetime from now an expiry may reach by the reader's clock: the sender's clock may be ahead, and\n * a day covers any clock that is merely wrong. Nothing else about a pointer or a bundle is held against this clock.\n */\n clockSkewMs: 24 * 60 * 60_000,\n} as const;\n/**\n * How far before its own clock a sender dates its pointer and its manifest, and ends the lifetimes it gives. A reader\n * refuses nothing for those dates: `rev` orders pointers and `seq` orders items, both kept by the reader. Apps up to\n * 1.0.2 refuse a pointer or a manifest dated more than a minute past their clock, and an expiry more than a minute\n * past one lifetime from now, each without a word: the items of a sender whose clock ran two minutes fast were never\n * fetched. Dated back, a sender up to about eleven minutes ahead is read by them.\n */\nexport const HOLD_DATED_BACK_MS = 10 * 60_000;\n\nexport type HoldKind = \"text\" | \"file\" | \"pay-req\" | \"manifest\";\nconst KINDS: readonly string[] = [\"text\", \"file\", \"pay-req\", \"manifest\"];\nconst WIRE_ID = /^[A-Za-z0-9_-]{8,64}$/;\nconst MAILBOX = /^[A-Za-z0-9_-]{22}$/;\nconst SIG = /^[A-Za-z0-9_-]{86}$/;\nconst MAGIC = utf8Encode(\"GHLD\");\nconst VERSION = 1;\nconst NONCE = 24;\n/** A bundle sealed by the chat's ratchet (WISP 4xx § Held items). */\nconst RATCHETED = 2;\ntype HoldItem = { mailbox: string; seq: number; id: string; ts: number; kind: HoldKind; meta?: unknown; expires: number };\n\nexport interface HoldFileMeta { name: string; size: number; mime: string }\n/** One held bundle as the manifest lists it: where to get it, and what to expect. */\nexport type HoldManifestEntry = [seq: number, id: string, kind: Exclude<HoldKind, \"manifest\">, bytes: number, url: string, expires: number];\nexport interface HoldHeader {\n v: 1;\n /** Rendezvous keys, as the sender sees the link. */\n from: string;\n to: string;\n /** Participation keys: who signed, who may open. */\n author: string;\n recipient: string;\n mailbox: string;\n seq: number;\n id: string;\n ts: number;\n kind: HoldKind;\n meta: unknown;\n /** base64url SHA-256 of the body. */\n digest: string;\n expires: number;\n}\nexport interface HoldPointer {\n rev: number;\n issued: number;\n /** When the manifest URL stops working. */\n expires: number;\n manifestUrl: string | null;\n /** Highest sequence the publisher has held for the reader. */\n top: number;\n /** Highest sequence the publisher received from the reader. */\n ack: number;\n count: number;\n bytes: number;\n /** Sequences of the reader's items this publisher refused (changed, oversized, not for it): at most the last 32. */\n refused: number[];\n}\n\n/** Why a bundle, manifest or pointer was refused. Never a reason to trust it a little. */\nexport class HoldRefusedError extends Error {\n /** The bytes the chat's ratchet opened, when it opened them before the item was refused: the caller commits them. */\n ratcheted?: Uint8Array;\n constructor(readonly reason: \"size\" | \"format\" | \"tampered\" | \"not-for-me\" | \"author\" | \"signature\" | \"digest\" | \"limits\" | \"expired\" | \"plain\", message: string) {\n super(message);\n }\n}\n\nconst bodyDigest = (body: Uint8Array) => toBase64Url(sha256(body));\nconst newMailbox = () => toBase64Url(randomBytes(16)).slice(0, 22);\nexport { newMailbox as newHoldMailbox };\n\n/**\n * Everything derived once per link for this feature: my pointer key, the contact's pointer address and\n * the key that seals bundles and pointers between the two participation keys. Needs a pinned contact.\n */\nexport class HoldKeys {\n readonly from: string;\n readonly to: string;\n readonly me: string;\n readonly peer: string;\n /** Publishes my pointer. */\n readonly identity: Identity;\n /** Where the contact publishes its pointer. */\n readonly peerAddress: string;\n private readonly seed: Uint8Array;\n private readonly sealKey: Uint8Array;\n\n constructor(params: LinkParams, participationSeedB64: string, peerKey: string) {\n this.from = identityFromSeedB64(params.seedB64).pubKeyZ32;\n this.to = params.peerPubKeyZ32;\n const mine = identityFromSeedB64(participationSeedB64);\n this.seed = mine.seed;\n this.me = mine.pubKeyZ32;\n this.peer = peerKey;\n const secret = fromBase64Url(params.encKeyB64);\n const context = JSON.stringify([\"ghostly-hold/1\", [this.from, this.to].sort()]);\n const derive = (label: string) => hkdf(sha256, secret, utf8Encode(context), utf8Encode(label), 32);\n this.identity = identityFromSeed(derive(`pointer:${this.from}`));\n this.peerAddress = identityFromSeed(derive(`pointer:${this.to}`)).pubKeyZ32;\n const shared = x25519.getSharedSecret(ed25519.utils.toMontgomerySecret(this.seed), ed25519.utils.toMontgomery(publicKeyFromZ32(peerKey)));\n this.sealKey = hkdf(sha256, shared, derive(\"envelope\"), utf8Encode(\"ghostly-hold-envelope/1\"), 32);\n }\n\n /** Seals one item for the contact: signed with my participation key, encrypted to our shared key. */\n seal(item: HoldItem, body: Uint8Array): Uint8Array {\n const nonce = randomBytes(NONCE);\n const box = xsalsa20poly1305(this.sealKey, nonce).encrypt(this.inner(item, body));\n return concatBytes(MAGIC, new Uint8Array([VERSION]), nonce, box);\n }\n /**\n * The same item as a version-2 bundle (WISP 4xx § Held items): the same plaintext, sealed by the chat's ratchet\n * (`seal`, which saves the ratchet's state before it returns), so the bundle can be uploaded once this returns.\n */\n async sealRatcheted(item: HoldItem, body: Uint8Array, seal: (plaintext: Uint8Array) => Promise<Uint8Array>): Promise<Uint8Array> {\n return concatBytes(MAGIC, new Uint8Array([RATCHETED]), await seal(this.inner(item, body)));\n }\n /** What a bundle seals: the header's length, the signed header, the body. */\n private inner(item: HoldItem, body: Uint8Array): Uint8Array {\n const fields = [VERSION, this.from, this.to, this.me, this.peer, item.mailbox, item.seq, item.id, item.ts, item.kind, item.meta ?? null, bodyDigest(body), item.expires];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), this.seed));\n const header = utf8Encode(JSON.stringify([fields, signature]));\n const length = new Uint8Array(4);\n new DataView(length.buffer).setUint32(0, header.length);\n return concatBytes(length, header, body);\n }\n\n /**\n * Opens a bundle the contact sealed for me. Everything is checked before anything is returned: the\n * authenticated encryption, the header's shape, that it names this link, this contact and me, the\n * signature, the body digest and the limits of its kind. `loopback`: see `isHoldUrl`.\n */\n /**\n * `ratchet`: opens a version-2 bundle's sealed bytes (WISP 4xx), without keeping anything; absent, one is from a newer\n * Ghostly. `refusePlain`: a ratcheted item from this contact opened here, so a version-1 item other than the manifest is\n * refused (WISP 4xx § Downgrade). `ratcheted` in the result: the bytes the ratchet opened, for the caller to commit once\n * the item is stored.\n */\n open(bytes: Uint8Array, expect: { maxBytes?: number; mailbox?: string; now?: number; loopback?: boolean; ratchet?: (sealed: Uint8Array) => Uint8Array | null; refusePlain?: boolean } = {}): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n const now = expect.now ?? Date.now();\n if (bytes.length > (expect.maxBytes ?? HOLD_LIMITS.maxBundleBytes)) throw new HoldRefusedError(\"size\", \"The held item is larger than allowed\");\n if (bytes.length < MAGIC.length + 1 + 16 + 4 || !MAGIC.every((b, i) => bytes[i] === b)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const version = bytes[MAGIC.length];\n if (version !== VERSION && (version !== RATCHETED || !expect.ratchet)) throw new HoldRefusedError(\"format\", \"Held item from a newer Ghostly\");\n let plain: Uint8Array | null, ratcheted: Uint8Array | undefined;\n if (version === RATCHETED) {\n ratcheted = bytes.subarray(MAGIC.length + 1);\n try { plain = expect.ratchet!(ratcheted); } catch { plain = null; }\n if (!plain) throw new HoldRefusedError(\"tampered\", \"The held item was changed, is not for this chat, or was opened already\");\n } else {\n if (bytes.length < MAGIC.length + 1 + NONCE + 16 + 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n try { plain = xsalsa20poly1305(this.sealKey, bytes.subarray(MAGIC.length + 1, MAGIC.length + 1 + NONCE)).decrypt(bytes.subarray(MAGIC.length + 1 + NONCE)); }\n catch { throw new HoldRefusedError(\"tampered\", \"The held item was changed or is not for this chat\"); }\n }\n try { return this.read(plain, ratcheted, expect, now); }\n catch (error) {\n // Opened, then refused: the ratchet's bytes go with the refusal, so the key is used up and the lane heard all the same.\n if (error instanceof HoldRefusedError && ratcheted) error.ratcheted = ratcheted;\n throw error;\n }\n }\n /** The checks of `open` once the bundle is decrypted. */\n private read(plain: Uint8Array, ratcheted: Uint8Array | undefined, expect: { mailbox?: string; loopback?: boolean; refusePlain?: boolean }, now: number): { header: HoldHeader; body: Uint8Array; ratcheted?: Uint8Array } {\n if (plain.length < 4) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const headerLength = new DataView(plain.buffer, plain.byteOffset, 4).getUint32(0);\n if (headerLength > 128 * 1024 || 4 + headerLength > plain.length) throw new HoldRefusedError(\"format\", \"Not a held item\");\n let parsed: unknown;\n try { parsed = JSON.parse(utf8Decode(plain.subarray(4, 4 + headerLength))); } catch { throw new HoldRefusedError(\"format\", \"Not a held item\"); }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || parsed[0].length !== 13 || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) throw new HoldRefusedError(\"format\", \"Not a held item\");\n const [fields, signature] = parsed as [unknown[], string];\n const [v, from, to, author, recipient, mailbox, seq, id, ts, kind, meta, digest, expires] = fields;\n if (v !== VERSION || typeof from !== \"string\" || typeof to !== \"string\" || typeof author !== \"string\" || typeof recipient !== \"string\" || typeof mailbox !== \"string\" || !MAILBOX.test(mailbox) ||\n !Number.isSafeInteger(seq) || (seq as number) < 0 || typeof id !== \"string\" || !WIRE_ID.test(id) || !Number.isSafeInteger(ts) || (ts as number) <= 0 ||\n typeof kind !== \"string\" || !KINDS.includes(kind) || typeof digest !== \"string\" || !Number.isSafeInteger(expires)) throw new HoldRefusedError(\"format\", \"Not a held item\");\n // Both directions of this link are sealed with the same key: the header says which one this is.\n if (from !== this.to || to !== this.from || recipient !== this.me) throw new HoldRefusedError(\"not-for-me\", \"The held item is for another chat\");\n if (author !== this.peer) throw new HoldRefusedError(\"author\", \"The held item was not signed by this contact\");\n if (expect.mailbox && mailbox !== expect.mailbox) throw new HoldRefusedError(\"not-for-me\", \"The held item is from another mailbox\");\n let valid: boolean;\n try { valid = verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-bundle\", fields])), publicKeyFromZ32(author)); } catch { valid = false; }\n if (!valid) throw new HoldRefusedError(\"signature\", \"The held item's signature does not check out\");\n const body = plain.subarray(4 + headerLength);\n if (bodyDigest(body) !== digest) throw new HoldRefusedError(\"digest\", \"The held item's content does not match its header\");\n // Its `ts` is its sender's clock, often minutes from this one: nothing is refused for it. It was, past a minute\n // ahead, and for good: the item's sequence was passed, and its sender told \"could not be verified as yours, or was\n // too large\". What stops an item from being taken twice is its sequence (the manifest's, the pointer's `rev`).\n // The item may be older than its upload (a retry, a message written offline); its expiry may not reach past one\n // lifetime from now, give or take what the sender's clock is ahead.\n if ((expires as number) <= (ts as number) || (expires as number) > now + HOLD_LIMITS.ttlMs + HOLD_LIMITS.clockSkewMs) throw new HoldRefusedError(\"limits\", \"The held item's lifetime is out of bounds\");\n const header: HoldHeader = { v: 1, from, to, author, recipient, mailbox, seq: seq as number, id, ts: ts as number, kind: kind as HoldKind, meta, digest, expires: expires as number };\n // The manifest is always sealed as before; anything else from a contact whose items come ratcheted must be ratcheted.\n if (!ratcheted && expect.refusePlain && kind !== \"manifest\") throw new HoldRefusedError(\"plain\", \"The held item was sealed without forward secrecy, which this chat no longer takes\");\n checkKind(header, body, expect.loopback);\n return { header, body, ...(ratcheted && { ratcheted }) };\n }\n\n /** My pointer, as records to publish under `identity`. Throws when it cannot fit a packet. */\n pointerRecords(pointer: HoldPointer, now = Date.now()): GhostRecord[] {\n const body = [VERSION, pointer.rev, pointer.issued, pointer.expires, pointer.manifestUrl, pointer.top, pointer.ack, pointer.count, pointer.bytes, pointer.refused.slice(-32)];\n const signature = toBase64Url(sign(utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.from, this.to, body])), this.seed));\n const ttl = Math.min(24 * 3600, Math.max(60, Math.ceil((pointer.expires - now) / 1000)));\n const records = [{ label: \"_hold\", value: encrypt(JSON.stringify([body, signature]), this.sealKey), ttl }];\n if (measureRecords(this.identity.pubKeyZ32, records) > MAX_DNS_PACKET_BYTES) throw new Error(\"The storage address is too long for a DHT packet. Use a shorter endpoint or prefix.\");\n return records;\n }\n\n /**\n * The contact's pointer out of its packet, or null when the packet is not one of its pointers. Its `issued` is the\n * contact's clock and refuses nothing: an older pointer cannot take a newer one's place because of `rev`. The\n * manifest's address is held to what an item's is (`isHoldUrl`): it is fetched as soon as the pointer is read.\n */\n readPointer(packet: SignedPacket, loopback = false): HoldPointer | null {\n if (packet.pubKeyZ32 !== this.peerAddress || measureRecords(packet.pubKeyZ32, packet.records) > MAX_DNS_PACKET_BYTES) return null;\n const records = packet.records.filter(r => r.label === \"_hold\");\n if (records.length !== 1) return null;\n const plain = tryDecrypt(records[0].value, this.sealKey);\n if (!plain) return null;\n let parsed: unknown;\n try { parsed = JSON.parse(plain); } catch { return null; }\n if (!Array.isArray(parsed) || parsed.length !== 2 || !Array.isArray(parsed[0]) || (parsed[0].length !== 9 && parsed[0].length !== 10) || typeof parsed[1] !== \"string\" || !SIG.test(parsed[1])) return null;\n const [body, signature] = parsed as [unknown[], string];\n const [v, rev, issued, expires, manifestUrl, top, ack, count, bytes, refused = []] = body;\n if (v !== VERSION || ![rev, issued, expires, top, ack, count, bytes].every(n => Number.isSafeInteger(n) && (n as number) >= 0) ||\n (manifestUrl !== null && !isHoldUrl(manifestUrl, loopback)) ||\n !Array.isArray(refused) || refused.length > 32 || !refused.every(n => Number.isSafeInteger(n) && (n as number) > 0)) return null;\n try {\n if (!verify(fromBase64Url(signature), utf8Encode(JSON.stringify([\"ghostly-hold-pointer\", this.to, this.from, body])), publicKeyFromZ32(this.peer))) return null;\n } catch { return null; }\n return { rev: rev as number, issued: issued as number, expires: expires as number, manifestUrl: manifestUrl as string | null, top: top as number, ack: ack as number, count: count as number, bytes: bytes as number, refused: refused as number[] };\n }\n}\n\n/**\n * A URL a bundle or manifest may be fetched from. The contact chose it and this device fetches it on its own, so it\n * is HTTPS, without a user or password, at a public name or a public IPv4 address: never this machine or its network.\n * A name with no dot or under a local suffix is a local one. A public name may still resolve to a local address:\n * where the host can resolve, its `fetch` refuses that too (the CLI's, packages/cli/src/runtime/holdFetch.ts, and\n * Desktop's, apps/desktop/src/hold_fetch.rs).\n * `loopback` adds plain HTTP to this machine, for a test against a local server; no shipped app passes it.\n */\nexport function isHoldUrl(value: unknown, loopback = false): value is string {\n if (typeof value !== \"string\" || value.length > 2048) return false;\n let url: URL;\n try { url = new URL(value); } catch { return false; }\n if (url.username || url.password) return false;\n const host = url.hostname.toLowerCase().replace(/\\.+$/, \"\");\n if (loopback && url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(host)) return true;\n if (url.protocol !== \"https:\" || !host.includes(\".\") || host.startsWith(\"[\") || underLocalSuffix(host)) return false;\n // A URL's IPv4 host is always written as four decimal numbers, whatever form it was given in.\n return !/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(host) || isPublicAddress(Uint8Array.from(host.split(\".\"), Number));\n}\n\n/** The limits of each kind, on the way in. */\nfunction checkKind(header: HoldHeader, body: Uint8Array, loopback = false): void {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n switch (header.kind) {\n case \"text\":\n if (body.length > HOLD_LIMITS.maxTextBytes) throw bad(\"The held text is too long\");\n try { utf8Decode(body); } catch { throw bad(\"The held text is not text\"); }\n return;\n case \"pay-req\":\n if (body.length > HOLD_LIMITS.maxPaymentRequestBytes) throw bad(\"The held payment request is too large\");\n return;\n case \"file\": {\n const meta = header.meta as Partial<HoldFileMeta> | null;\n if (!meta || typeof meta !== \"object\" || typeof meta.name !== \"string\" || meta.name.length > 255 || typeof meta.mime !== \"string\" || meta.mime.length > 255 || meta.size !== body.length) throw bad(\"The held file does not match its description\");\n return;\n }\n case \"manifest\": {\n if (body.length !== 0) throw bad(\"A manifest carries no body\");\n readManifest(header.meta, loopback);\n return;\n }\n }\n}\n\n/** The entries of a manifest, checked: strictly increasing sequences, bounded sizes, fetchable URLs. */\nexport function readManifest(meta: unknown, loopback = false): HoldManifestEntry[] {\n const bad = (message: string) => new HoldRefusedError(\"limits\", message);\n const entries = (meta as { entries?: unknown } | null)?.entries;\n if (!Array.isArray(entries) || entries.length > HOLD_LIMITS.maxMailboxBundles) throw bad(\"The manifest lists too many items\");\n let last = 0, total = 0;\n const out: HoldManifestEntry[] = [];\n for (const entry of entries) {\n if (!Array.isArray(entry) || entry.length !== 6) throw bad(\"The manifest is malformed\");\n const [seq, id, kind, bytes, url, expires] = entry;\n if (!Number.isSafeInteger(seq) || seq <= last || typeof id !== \"string\" || !WIRE_ID.test(id) || typeof kind !== \"string\" || !KINDS.includes(kind) || kind === \"manifest\" ||\n !Number.isSafeInteger(bytes) || bytes < 0 || bytes > HOLD_LIMITS.maxBundleBytes || !isHoldUrl(url, loopback) || !Number.isSafeInteger(expires)) throw bad(\"The manifest is malformed\");\n last = seq; total += bytes;\n if (total > HOLD_LIMITS.maxMailboxBytes) throw bad(\"The manifest lists more than a mailbox may hold\");\n out.push([seq, id, kind as HoldManifestEntry[2], bytes, url, expires]);\n }\n return out;\n}\n","import type { FrameChannel } from \"./frames\";\nimport { isHoldUrl } from \"./storeForward\";\n\nexport const TRANSPORTS = [\"iroh/1\", \"hyperdht/1\", \"webrtc/1\"] as const;\nexport type PairedTransport = typeof TRANSPORTS[number];\nexport type NativeTransport = Exclude<PairedTransport, \"webrtc/1\">;\n\n/** Supplied only by the local adapter after its real cryptographic handshake.\n * Iroh uses a TLS exporter; HyperDHT uses its Noise handshake hash. */\nexport interface NativeBinding {\n transport: NativeTransport;\n context: string;\n identities: [string, string];\n}\nexport interface BoundChannel { channel: FrameChannel; binding: NativeBinding }\nexport interface NativeEndpoint {\n transport: NativeTransport;\n descriptor: unknown;\n connect(descriptor: unknown): Promise<BoundChannel>;\n close(): Promise<void>;\n onConnection: ((connection: BoundChannel) => void) | null;\n onDescriptor: (() => void) | null;\n onUnavailable?: (() => void) | null;\n /** The endpoint is connected to its relay again after it lost it (the native Iroh's home relay; nothing else says it). */\n onRelayBack?: (() => void) | null;\n}\nexport type TransportDescriptors = Partial<Record<NativeTransport, unknown>>;\n\n/**\n * One spelling per Iroh relay. Iroh compares relay URLs as text, and its own relays are named with the trailing dot\n * of a fully qualified name (`https://use1-1.relay.n0.iroh.link./`): the same server written without the dot is\n * another relay to it, and an endpoint dialling a contact there opens a second connection to the server it is already\n * homed on, which the server answers by setting the first one aside.\n *\n * So every relay URL is put in one spelling before it goes into an Iroh endpoint (the relays it homes on, a contact's\n * descriptor before a dial), and which one depends on the endpoint:\n * - `\"dotted\"`, n0's relays with their trailing dot: what native Iroh homes on by default (the Desktop), and the form\n * to compare two relays in. Any other relay keeps its plain name here too: a relay behind a proxy (a Cloudflare\n * tunnel) is found by its Host header, and the proxy answers the dotted name with 404.\n * - `\"plain\"`, the name without it: the only one every browser opens. WebKit (Safari, the iPhone app) refuses a\n * host name that ends in a dot, for `fetch` and for a WebSocket alike, so nothing a browser's Iroh is given has one.\n *\n * An IP address and a single-label name (a search domain may complete it) stay as written; `localhost.` loses its dot\n * in both, the form the relay settings accept. What does not parse comes back untouched, for the caller's own check.\n */\nexport type IrohRelaySpelling = \"dotted\" | \"plain\";\nexport function irohRelayUrl(value: string, spelling: IrohRelaySpelling = \"dotted\"): string {\n let url: URL;\n try { url = new URL(value); } catch { return value; }\n const host = url.hostname, name = host.replace(/\\.$/, \"\");\n if (!name.includes(\".\") && name !== \"localhost\") return value;\n if (name.startsWith(\"[\") || /^\\d+(\\.\\d+){3}$/.test(name)) return value;\n const wanted = spelling === \"dotted\" && /(^|\\.)iroh\\.link$/.test(name) ? `${name}.` : name;\n if (wanted === host) return value;\n url.hostname = wanted;\n return url.href;\n}\n\n/** An Iroh descriptor with its relay in one spelling (`irohRelayUrl`); anything else as it is. */\nexport function irohDescriptor<T>(descriptor: T, spelling: IrohRelaySpelling = \"dotted\"): T {\n const relay = (descriptor as { relay?: unknown } | null | undefined)?.relay;\n if (typeof relay !== \"string\") return descriptor;\n const canonical = irohRelayUrl(relay, spelling);\n return canonical === relay ? descriptor : { ...descriptor, relay: canonical };\n}\n\n/**\n * A relay server's URL, short: https, or wss for a browser's relay; plain http or ws only on this machine's loopback,\n * as a test relay is (the same rule as the relay settings).\n */\nexport const RELAY_URL = /^((https|wss):\\/\\/[^\\s]{1,120}|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]{0,100})?)$/;\n/**\n * A relay URL with more than its server's address in it: a login, a query or a fragment, which no relay setting takes\n * (irohWeb.ts `irohRelayProblem`, hyperdhtRelay.ts `hyperdhtRelayProblem`). An older app named its HyperDHT relay as\n * set, with them; such a descriptor is not dialed or kept, and the rest of what the contact told still is.\n */\nexport const RELAY_WITH_SECRETS = /^[a-z]+:\\/\\/[^/?#]*@|[?#]/i;\n/** A relay URL a descriptor may name: `RELAY_URL`, with nothing but the server's address in it. */\nexport const relayUrl = (value: unknown): value is string => typeof value === \"string\" && RELAY_URL.test(value) && !RELAY_WITH_SECRETS.test(value);\n/** `RELAY_URL` at any length. */\nconst RELAY_URL_ANY_LENGTH = /^((https|wss):\\/\\/[^\\s]+|(http|ws):\\/\\/(127\\.0\\.0\\.1|localhost|\\[::1\\])(:\\d{1,5})?(\\/[^\\s]*)?)$/;\n/**\n * A relay URL `relayUrl` refuses for its length alone (past 120 characters, a loopback path past 100): a relay setting\n * asks for a shorter one, where \"not a relay address\" sent the person looking for a typo in it.\n */\nexport const relayUrlTooLong = (value: string): boolean => !relayUrl(value) && !RELAY_WITH_SECRETS.test(value) && RELAY_URL_ANY_LENGTH.test(value);\n/**\n * Whether an Iroh endpoint may dial a contact through the relay its descriptor names (none: a direct address alone).\n * The contact chose that relay and this device opens it on its own, again on each redial, so it is held to what a held\n * item's address is (`isHoldUrl`): https at a public name or a public address, never this machine or its network.\n * One of the endpoint's own relays (`own`: the person's settings, a private network's or a test's) is dialled as well,\n * in either spelling: this device opens it anyway.\n */\nexport function dialableIrohRelay(relay: unknown, own: readonly string[]): boolean {\n if (relay === null || relay === undefined) return true;\n if (!relayUrl(relay)) return false;\n const same = (a: string, b: string) => { try { return new URL(irohRelayUrl(a, \"plain\")).href === new URL(irohRelayUrl(b, \"plain\")).href; } catch { return false; } };\n return own.some(mine => same(mine, relay)) || isHoldUrl(relay);\n}\nconst HEX_KEY = /^[0-9a-f]{64}$/;\n/** An Iroh direct address as the adapters parse it: an IPv4 or bracketed IPv6 address and its port. */\nconst SOCKET_ADDRESS = /^(\\d{1,3}(\\.\\d{1,3}){3}|\\[[0-9A-Fa-f:.]{2,45}(%[A-Za-z0-9._-]{1,16})?\\]):\\d{1,5}$/;\nconst MAX_ADDRESSES = 8;\n\n/**\n * A contact's native descriptors as it tells them on a session (`paired-policy`, `paired-adapters`) or as this app\n * kept them: only what the adapters dial, each field in the shape its adapter makes. The keys are 64 hex characters,\n * a relay passes `relayUrl` (the rule its capability record is read by), an Iroh descriptor lists at most eight\n * socket addresses. A descriptor that is anything else is left out, as one the contact never told; a field this app\n * does not know is not kept.\n */\nexport function checkedDescriptors(value: unknown): TransportDescriptors {\n const out: TransportDescriptors = {};\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return out;\n const raw = value as Record<string, unknown>;\n const relayed = (v: unknown) => v === undefined || typeof v === \"boolean\";\n const iroh = raw[\"iroh/1\"] as { id?: unknown; relay?: unknown; addresses?: unknown; relayed?: unknown } | null | undefined;\n if (iroh && typeof iroh === \"object\" && typeof iroh.id === \"string\" && HEX_KEY.test(iroh.id) &&\n (iroh.relay === undefined || iroh.relay === null || relayUrl(iroh.relay)) && relayed(iroh.relayed) &&\n Array.isArray(iroh.addresses) && iroh.addresses.length <= MAX_ADDRESSES &&\n iroh.addresses.every(a => typeof a === \"string\" && SOCKET_ADDRESS.test(a)))\n out[\"iroh/1\"] = { id: iroh.id, relay: (iroh.relay as string | null | undefined) ?? null, addresses: [...iroh.addresses] as string[],\n ...(iroh.relayed !== undefined ? { relayed: iroh.relayed } : {}) };\n const hyper = raw[\"hyperdht/1\"] as { publicKey?: unknown; relay?: unknown; relayed?: unknown } | null | undefined;\n if (hyper && typeof hyper === \"object\" && typeof hyper.publicKey === \"string\" && HEX_KEY.test(hyper.publicKey) &&\n (hyper.relay === undefined || relayUrl(hyper.relay)) && relayed(hyper.relayed))\n out[\"hyperdht/1\"] = { publicKey: hyper.publicKey, ...(hyper.relay !== undefined ? { relay: hyper.relay } : {}),\n ...(hyper.relayed !== undefined ? { relayed: hyper.relayed } : {}) };\n return out;\n}\n\n/**\n * Relay only (WISP 100, \"Relayed\"): the transport reaches this contact only through a relay server, never\n * directly. A descriptor says so with `relayed: true`, and an Iroh descriptor with no direct address is relayed\n * too (a browser's, WISP 102). Either side being relay only makes the whole path relayed. Both sides hold both\n * descriptors after the exchange, so they agree, and the rank stays symmetric.\n */\nexport function relayedTransports(local: TransportDescriptors, remote: TransportDescriptors): NativeTransport[] {\n const relayOnly = (transport: NativeTransport, descriptor: unknown): boolean => {\n if (!descriptor || typeof descriptor !== \"object\") return false;\n const d = descriptor as { relayed?: unknown; addresses?: unknown };\n return d.relayed === true || (transport === \"iroh/1\" && Array.isArray(d.addresses) && d.addresses.length === 0);\n };\n return ([\"iroh/1\", \"hyperdht/1\"] as const).filter(t => relayOnly(t, local[t]) || relayOnly(t, remote[t]));\n}\n\n/** Symmetric rank sum; the fixed order breaks ties deterministically. Neither\n * a remote list nor a preference can add an unavailable local adapter. A\n * relayed transport ranks after every direct one: it is where a failed direct\n * path goes, never ahead of one that works. Iroh through its relay is the\n * exception (WISP 100, revision 2026-11-08): it comes back almost at once after\n * the app was away, and a browser's Iroh is never anything else. */\nexport function rankTransports(local: readonly string[], remote: readonly string[], relayed: readonly string[] = []): PairedTransport[] {\n const penalty = (t: PairedTransport) => t !== \"iroh/1\" && relayed.includes(t) ? 1 : 0;\n return TRANSPORTS.filter(t => local.includes(t) && remote.includes(t))\n .sort((a, b) => penalty(a) - penalty(b)\n || (local.indexOf(a) + remote.indexOf(a)) - (local.indexOf(b) + remote.indexOf(b))\n || TRANSPORTS.indexOf(a) - TRANSPORTS.indexOf(b));\n}\n\n/**\n * What a chat prefers when nobody chose (Automatic): Iroh where the app has it, then WebRTC, then HyperDHT (WISP 100,\n * revision 2026-11-08). Every app puts Iroh first, so the rank sum of two apps that both run it puts it first on both\n * sides. With nothing at all, WebRTC, which the offer then leaves out.\n * With Fallback off the chat may use only that one transport, and nothing moves it off a relayed Iroh then: WebRTC\n * where the app has it, else the first transport it has (a Linux Desktop: WebKitGTK has no WebRTC), as before.\n */\nexport const AUTOMATIC_ORDER: readonly PairedTransport[] = [\"iroh/1\", \"webrtc/1\", \"hyperdht/1\"];\nexport function automaticTransport(available: readonly PairedTransport[], fallback = true): PairedTransport {\n if (!fallback) return available.includes(\"webrtc/1\") ? \"webrtc/1\" : TRANSPORTS.find(t => available.includes(t)) ?? \"webrtc/1\";\n return AUTOMATIC_ORDER.find(t => available.includes(t)) ?? \"webrtc/1\";\n}\n\nexport function transportOrder(available: readonly PairedTransport[], preferred: PairedTransport,\n fallback: boolean): PairedTransport[] {\n const rest = TRANSPORTS.filter(t => available.includes(t) && t !== preferred);\n return [...(available.includes(preferred) ? [preferred] : []), ...(fallback ? rest : [])];\n}\n"],"mappings":";;;;;;;AAGA,IAAM,eAAe;AACrB,IAAM,aAAa;AAEnB,SAAgB,wBAAoC;CAClD,OAAO,YAAY,UAAU;AAC/B;;;;;AAMA,SAAgB,QAAQ,WAAmB,KAAyB;CAClE,IAAI,IAAI,WAAW,YAAY,MAAM,IAAI,MAAM,uCAAuC;CACtF,MAAM,QAAQ,YAAY,YAAY;CACtC,MAAM,MAAM,iBAAiB,KAAK,KAAK,CAAC,CAAC,QAAQ,WAAW,SAAS,CAAC;CACtE,OAAO,SAAS,YAAY,OAAO,GAAG,CAAC;AACzC;;AAGA,SAAgB,aAAa,gBAAgC;CAC3D,OAAO,IAAI,KAAK,MAAM,KAAoB,kBAAkB,CAAC;AAC/D;AAEA,SAAgB,QAAQ,SAAiB,KAAyB;CAChE,IAAI,IAAI,WAAW,YAAY,MAAM,IAAI,MAAM,uCAAuC;CACtF,MAAM,WAAW,WAAW,OAAO;CACnC,IAAI,SAAS,SAAS,IAAkB,MAAM,IAAI,MAAM,+BAA+B;CACvF,MAAM,QAAQ,SAAS,SAAS,GAAG,YAAY;CAC/C,MAAM,MAAM,SAAS,SAAS,YAAY;CAC1C,OAAO,WAAW,iBAAiB,KAAK,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;AAC7D;AAEA,SAAgB,WAAW,SAAiB,KAAgC;CAC1E,IAAI;EACF,OAAO,QAAQ,SAAS,GAAG;CAC7B,QAAQ;EACN,OAAO;CACT;AACF;;ACjBA,IAAa,iBAA0C;CAAC;CAAO;CAAS;AAAO;AAC/E,IAAa,YAAY;AACzB,IAAa,kBAAkB;AAC/B,IAAa,aAAa;;AAE1B,IAAa,wBAAwB;AACrC,IAAa,uBAAuB;AACpC,IAAa,qBAAqB;AAElC,IAAM,MAAM;AACZ,IAAM,QAAQ;;;AAOd,IAAM,cAAc;CAAC;CAAa;CAAS;CAAY;CAAO;CAAQ;CAAQ;CAAY;CACxF;CAAQ;CAAW;CAAW;CAAS;CAAO;AAAM;;;;;;AAOtD,SAAgB,gBAAgB,OAAuB;CACrD,IAAI,OAAO,UAAU,UAAU,MAAM,IAAI,MAAM,uCAAuC;CACtF,IAAI,QAAQ,MAAM,KAAK;CACvB,IAAI,CAAC,SAAS,MAAM,SAAS,KAAK,MAAM,IAAI,MAAM,uCAAuC;CACzF,IAAI,2BAA2B,KAAK,KAAK,GAAG;EAC1C,IAAI;EACJ,IAAI;GAAE,MAAM,IAAI,IAAI,KAAK;EAAG,QAAQ;GAAE,MAAM,IAAI,MAAM,uCAAuC;EAAG;EAChG,IAAI,IAAI,aAAa,YAAY,IAAI,YAAY,IAAI,YAAY,IAAI,QAAS,IAAI,aAAa,OAAO,IAAI,aAAa,MAAO,IAAI,UAAU,IAAI,MAC9I,MAAM,IAAI,MAAM,oDAAoD;EACtE,QAAQ,IAAI;CACd,OAAO;EACL,IAAI,cAAc,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,oDAAoD;EACnG,IAAI;GAAE,QAAQ,IAAI,IAAI,WAAW,OAAO,CAAC,CAAC;EAAU,QAAQ;GAAE,MAAM,IAAI,MAAM,iCAAiC;EAAG;CACpH;CACA,QAAQ,MAAM,YAAY,CAAC,CAAC,QAAQ,OAAO,EAAE;CAC7C,IAAI,MAAM,SAAS,KAA4B,MAAM,IAAI,MAAM,8BAA8B;CAC7F,MAAM,SAAS,MAAM,MAAM,GAAG;CAC9B,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,MAAM,0CAA0C;CACjF,KAAK,MAAM,SAAS,QAClB,IAAI,CAAC,uCAAuC,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,iCAAiC;CAE5G,MAAM,MAAM,OAAO,OAAO,SAAS;CACnC,IAAI,WAAW,KAAK,GAAG,KAAK,MAAM,KAAK,KAAK,GAAG,MAAM,IAAI,MAAM,sCAAsC;CACrG,IAAI,YAAY,SAAS,GAAG,KAAM,OAAO,UAAU,KAAK,OAAO,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG,MAAM,aACrF,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT;AAEA,IAAa,gBAAgB,WAAmB,GAAG,UAAU,GAAG,gBAAgB,MAAM;AACtF,IAAa,gBAAgB,QAAgB,SAA4B,YACvE,WAAW,gBAAgB,MAAM,IAAI,WAAW,UAAU,aAAa;AAKzE,SAAgB,kBAAkB,GAA0B;CAC1D,IAAI,CAAC,KAAK,OAAO,EAAE,QAAQ,YAAY,OAAO,EAAE,UAAU,YAAY,CAAC,IAAI,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,GAAG,OAAO;CACvH,IAAI;EAAE,OAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;CAAK,QAAQ;EAAE,OAAO;CAAO;AACxE;;AAGA,SAAgB,gBAAgB,GAAyB;CACvD,IAAI,CAAC,kBAAkB,CAAC,GAAG,MAAM,IAAI,MAAM,uBAAuB;CAClE,OAAO,mBAAmB,EAAE,IAAI,UAAU,EAAE;AAC9C;;;AAIA,SAAgB,eAAe,OAAyC;CACtE,IAAI,OAAO,UAAU,YAAY,WAAW,KAAK,CAAC,CAAC,SAAA,MAA+B;CAClF,MAAM,uBAAO,IAAI,IAAoB;CACrC,MAAM,QAAQ,MAAM,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO;CAChE,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,KAAK,QAAQ,GAAG;EAC3B,IAAI,KAAK,GAAG;EACZ,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY;EAClD,IAAI,KAAK,IAAI,IAAI,GAAG;EACpB,KAAK,IAAI,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;CAC1C;CACA,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,KAAK,IAAI,GAAG,MAAM,YAAY;CAC/E,MAAM,IAAI;EAAE,KAAK,KAAK,IAAI,KAAK;EAAG,OAAO,KAAK,IAAI,OAAO;CAAE;CAC3D,OAAO,kBAAkB,CAAC,IAAI,IAAI,KAAA;AACpC;AAEA,IAAM,aAAa,MAAsB,MAAoB;CAC3D,IAAI,CAAC,KAAK,MAAK,MAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,KAAK,CAAC;AAC1E;;;AAIA,SAAgB,eAAe,QAAkC;CAC/D,MAAM,MAAsB,CAAC;CAC7B,KAAK,MAAM,SAAS,OAAO,MAAM,GAAG,EAAE,GAAG;EAAE,MAAM,IAAI,eAAe,KAAK;EAAG,IAAI,GAAG,UAAU,KAAK,CAAC;CAAG;CACtG,OAAO;AACT;;AAGA,SAAgB,oBAAoB,SAAiC;CACnE,IAAI,CAAC,QAAQ,UAAU,QAAQ,SAAA,KAA+B,CAAC,QAAQ,MAAM,iBAAiB,GAAG,MAAM,IAAI,MAAM,wBAAwB;CACzI,OAAO,KAAK,UAAU;EAAE,SAAS;EAAG,QAAQ,QAAQ,KAAI,OAAM;GAAE,KAAK,EAAE;GAAK,OAAO,EAAE;EAAM,EAAE;CAAE,GAAG,MAAM,CAAC,IAAI;AAC/G;AAEA,SAAS,UAAU,MAAuB;CACxC,IAAI,OAAO,SAAS,YAAY,WAAW,IAAI,CAAC,CAAC,SAAA,OAAgC,MAAM,IAAI,MAAM,gBAAgB;CACjH,OAAO,KAAK,MAAM,IAAI;AACxB;;AAGA,SAAgB,qBAAqB,MAA8B;CACjE,MAAM,OAAO,UAAU,IAAI;CAC3B,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,MAAM,QAAQ,KAAK,MAAM,GAC9G,MAAM,IAAI,MAAM,2BAA2B;CAC7C,MAAM,MAAsB,CAAC;CAC7B,KAAK,MAAM,SAAS,KAAK,OAAO,MAAM,GAAG,EAAE,GAA2C;EACpF,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU;EACzC,MAAM,IAAI;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;EAAM;EAC/C,IAAI,kBAAkB,CAAC,GAAG,UAAU,KAAK,CAAC;CAC5C;CACA,OAAO;AACT;;AAGA,SAAgB,aAAa,MAAkC;CAC7D,MAAM,OAAO,UAAU,IAAI;CAC3B,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,CAAC,KAAK,SAAS,OAAO,KAAK,UAAU,YAAY,MAAM,QAAQ,KAAK,KAAK,GAChH,MAAM,IAAI,MAAM,mBAAmB;CACrC,MAAM,OAAQ,KAAK,MAAkC;CACrD,OAAO,OAAO,SAAS,YAAY,MAAM,KAAK,IAAI,IAAI,OAAO,KAAA;AAC/D;AAEA,IAAa,eAAe,SAAyB,MAAoB,QAAQ,MAAK,MAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK;AAKjI,IAAa,WAAW;CAAE,GAAG;CAAG,OAAO;CAAG,KAAK;CAAI,MAAM;AAAG;;;;;AAe5D,IAAM,mBAAmB,WAAW,GAAG,GAAG,GAAG,IAAI,GAAW,KAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;;;AAIjH,SAAgB,eAAe,MAAc,MAA2B;CACtE,MAAM,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG;CAChD,MAAM,QAAsB,CAAC,WAAW,GAAG,GAAG,GAAG,GAAM,IAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;CACpF,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,QAAQ,WAAW,KAAK;EAC9B,IAAI,CAAC,MAAM,UAAU,MAAM,SAAS,IAAI,MAAM,IAAI,MAAM,kBAAkB;EAC1E,MAAM,KAAK,WAAW,GAAG,MAAM,MAAM,GAAG,KAAK;CAC/C;CACA,MAAM,OAAO,SAAS;CACtB,MAAM,KAAK,WAAW,GAAG,GAAG,QAAQ,GAAG,OAAO,KAAM,GAAG,CAAC,GAAG,gBAAgB;CAC3E,OAAO,YAAY,GAAG,KAAK;AAC7B;AAEA,SAAS,SAAS,MAAkB,OAA+C;CACjF,MAAM,SAAmB,CAAC;CAC1B,IAAI,MAAM,OAAO,OAAO,IAAI,QAAQ,GAAG,SAAS;CAChD,SAAS;EACP,IAAI,OAAO,KAAK,QAAQ,MAAM,IAAI,MAAM,wBAAwB;EAChE,MAAM,MAAM,KAAK;EACjB,KAAK,MAAM,SAAU,KAAM;GACzB,IAAI,MAAM,KAAK,KAAK,QAAQ,MAAM,IAAI,MAAM,2BAA2B;GACvE,IAAI,OAAO,GAAG,OAAO,MAAM;GAC3B,OAAQ,MAAM,OAAS,IAAK,KAAK,MAAM;GACvC,IAAI,EAAE,QAAQ,IAAI,MAAM,IAAI,MAAM,gBAAgB;GAClD;EACF;EACA,IAAI,MAAM,KAAM,MAAM,IAAI,MAAM,uBAAuB;EACvD,OAAO;EACP,IAAI,QAAQ,GAAG;EACf,IAAI,MAAM,MAAM,KAAK,QAAQ,MAAM,IAAI,MAAM,yBAAyB;EACtE,UAAU,MAAM;EAChB,IAAI,SAAS,KAAK,MAAM,IAAI,MAAM,mBAAmB;EACrD,OAAO,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;EACnE,OAAO;CACT;CACA,OAAO;EAAE,MAAM,OAAO,KAAK,GAAG;EAAG,MAAM,OAAO,IAAI,MAAM;CAAK;AAC/D;;;;;;AAOA,SAAgB,kBAAkB,MAAkB,MAAc,MAA4B;CAC5F,IAAI,KAAK,SAAS,IAAI,MAAM,IAAI,MAAM,wBAAwB;CAC9D,MAAM,OAAO,IAAI,SAAS,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU;CACvE,MAAM,QAAQ,KAAK,UAAU,CAAC;CAC9B,IAAI,EAAE,QAAQ,UAAY,QAAQ,SAAY,QAAQ,KAAS,MAAM,IAAI,MAAM,uBAAuB;CACtG,MAAM,YAAY,KAAK,UAAU,CAAC,GAAG,QAAQ,KAAK,UAAU,CAAC;CAC7D,MAAM,OAAO,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,YAAY,GAAG,OAAO,SAAS;CACpE,IAAI,cAAc,GAAG,MAAM,IAAI,MAAM,sCAAsC;CAC3E,MAAM,IAAI,SAAS,MAAM,EAAE;CAC3B,IAAI,EAAE,SAAS,QAAQ,EAAE,OAAO,IAAI,KAAK,UAAU,KAAK,UAAU,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,MAAM,sCAAsC;CAC1I,IAAI,MAAM,EAAE,OAAO;CACnB,MAAM,MAAmB,CAAC;CAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,IAAI,IAAI,KAAK;EACxC,MAAM,QAAQ,SAAS,MAAM,GAAG;EAChC,MAAM,MAAM;EACZ,IAAI,MAAM,KAAK,KAAK,QAAQ,MAAM,IAAI,MAAM,0BAA0B;EACtE,MAAM,QAAQ,KAAK,UAAU,GAAG,GAAG,MAAM,KAAK,UAAU,MAAM,CAAC,GAAG,MAAM,KAAK,UAAU,MAAM,CAAC;EAC9F,OAAO;EACP,IAAI,MAAM,MAAM,KAAK,QAAQ,MAAM,IAAI,MAAM,0BAA0B;EACvE,MAAM,QAAQ,UAAU,SAAS,QAAQ,WAAW,SAAS,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,GAAG;EACzG,IAAI,KAAK;GAAE,MAAM,MAAM;GAAM,MAAM;GAAO;GAAK,MAAM;EAAM,CAAC;EAC5D,OAAO;CACT;CACA,MAAM,yBAAS,IAAI,IAAI,CAAC,IAAI,CAAC;CAC7B,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO;EAChC,MAAM,QAAQ,IAAI,MAAK,MAAK,EAAE,SAAS,SAAS,SAAS,OAAO,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,WAAW,EAAE,IAAI,CAAC,CAAC;EAC9G,IAAI,CAAC,OAAO;EACZ,OAAO,IAAI,WAAW,MAAM,IAAI,CAAC;CACnC;CACA,OAAO;EAAE,OAAO,QAAQ;EAAQ,eAAe,CAAC,EAAE,QAAQ;EAAS,SAAS,IAAI,QAAO,MAAK,EAAE,SAAS,QAAQ,OAAO,IAAI,EAAE,IAAI,CAAC;CAAE;AACrI;;AAGA,SAAgB,SAAS,OAA2B;CAClD,MAAM,QAAsB,CAAC;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,SAAS;EACjC,MAAM,MAAM,MAAM;EAClB,IAAI,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,IAAI,MAAM,wBAAwB;EACxE,MAAM,KAAK,MAAM,SAAS,IAAI,GAAG,IAAI,IAAI,GAAG,CAAC;EAC7C,KAAK,IAAI;CACX;CACA,OAAO,IAAI,YAAY,SAAS,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,YAAY,GAAG,KAAK,CAAC;AAC/E;;;;AAQA,SAAgB,gBAAgB,SAA8B;CAC5D,IAAI,QAAQ,WAAW,GAAG;EACxB,MAAM,CAAC,GAAG,GAAG,KAAK;EAClB,OAAO,EAAE,MAAM,KAAK,MAAM,MAAM,MAAM,OAAO,KAAK,OAC/C,MAAM,OAAO,KAAK,MAAM,KAAK,OAAS,MAAM,OAAO,MAAM,OAAS,MAAM,OAAO,KAAK,MAAM,KAAK,MAC/F,MAAM,OAAO,MAAM,OAAS,MAAM,OAAO,MAAM,KAAK,MAAM,KAAO,MAAM,QAAQ,MAAM,MAAM,MAAM;CACtG;CACA,IAAI,QAAQ,WAAW,IAAI,OAAO;CAClC,MAAM,UAAU,MAAc,QAAQ,SAAS,GAAG,CAAC,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC;CACvE,IAAI,OAAO,EAAE,MAAM,QAAQ,QAAQ,KAAK,QAAQ,QAAQ,IAAI,OAAO;CACnE,IAAI,OAAO,EAAE,KAAK,QAAQ,QAAQ,OAAQ,QAAQ,QAAQ,KAAM,OAAO,gBAAgB,QAAQ,SAAS,EAAE,CAAC;CAC3G,IAAI,QAAQ,OAAO,KAAQ,QAAQ,OAAO,OAAQ,QAAQ,OAAO,OAAQ,QAAQ,OAAO,OAAQ,QAAQ,SAAS,GAAG,EAAE,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC,GACxI,OAAO,gBAAgB,QAAQ,SAAS,EAAE,CAAC;CAC7C,IAAI,OAAO,EAAE,GAAG,OAAO;CACvB,KAAK,QAAQ,KAAK,SAAU,KAAM,OAAO;CACzC,IAAI,QAAQ,OAAO,QAAS,QAAQ,KAAK,SAAU,KAAM,OAAO;CAChE,IAAI,QAAQ,OAAO,QAAS,QAAQ,KAAK,SAAU,KAAM,OAAO;CAChE,IAAI,QAAQ,OAAO,KAAM,OAAO;CAChC,IAAI,QAAQ,OAAO,KAAQ,QAAQ,SAAS,GAAG,CAAC,CAAC,CAAC,OAAM,MAAK,MAAM,CAAC,GAAG,OAAO;CAC9E,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,GAAM,OAAO;CACvD,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,GAAM,OAAO;CACrG,IAAI,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAQ,QAAQ,OAAO,MAAQ,QAAQ,OAAO,KAAM,OAAO;CACrG,QAAQ,QAAQ,KAAK,SAAU;AACjC;;;;;;ACvSA,IAAa,iBAAiB;CAAC;CAAa;CAAS;CAAY;CAAO;CAAQ;CAAa;CAAe;CAAY;AAAM;;AAG9H,IAAa,oBAAoB,SAA0B,eAAe,MAAK,MAAK,SAAS,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC;;;;;;;;;;;;ACexH,IAAa,kBAAkB;AAC/B,IAAa,cAAc;;CAEzB,gBAAgB;;CAEhB,iBAAiB;CACjB,mBAAmB;;CAEnB,OAAO;CACP,cAAc;CACd,wBAAwB;CACxB,kBAAkB;;;;;CAKlB,aAAa;AACf;;;;;;;;AAQA,IAAa,qBAAqB;AAGlC,IAAM,QAA2B;CAAC;CAAQ;CAAQ;CAAW;AAAU;AACvE,IAAM,UAAU;AAChB,IAAM,UAAU;AAChB,IAAM,MAAM;AACZ,IAAM,QAAQ,WAAW,MAAM;AAC/B,IAAM,UAAU;AAChB,IAAM,QAAQ;;AAEd,IAAM,YAAY;;AAyClB,IAAa,mBAAb,cAAsC,MAAM;CAGrB;;CADrB;CACA,YAAY,QAAqI,SAAiB;EAChK,MAAM,OAAO;EADM,KAAA,SAAA;CAErB;AACF;AAEA,IAAM,cAAc,SAAqB,YAAY,OAAO,IAAI,CAAC;AACjE,IAAM,mBAAmB,YAAY,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE;;;;;AAOjE,IAAa,WAAb,MAAsB;CACpB;CACA;CACA;CACA;;CAEA;;CAEA;CACA;CACA;CAEA,YAAY,QAAoB,sBAA8B,SAAiB;EAC7E,KAAK,OAAO,oBAAoB,OAAO,OAAO,CAAC,CAAC;EAChD,KAAK,KAAK,OAAO;EACjB,MAAM,OAAO,oBAAoB,oBAAoB;EACrD,KAAK,OAAO,KAAK;EACjB,KAAK,KAAK,KAAK;EACf,KAAK,OAAO;EACZ,MAAM,SAAS,cAAc,OAAO,SAAS;EAC7C,MAAM,UAAU,KAAK,UAAU,CAAC,kBAAkB,CAAC,KAAK,MAAM,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;EAC9E,MAAM,UAAU,UAAkB,KAAK,QAAQ,QAAQ,WAAW,OAAO,GAAG,WAAW,KAAK,GAAG,EAAE;EACjG,KAAK,WAAW,iBAAiB,OAAO,WAAW,KAAK,MAAM,CAAC;EAC/D,KAAK,cAAc,iBAAiB,OAAO,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC;EAClE,MAAM,SAAS,OAAO,gBAAgB,QAAQ,MAAM,mBAAmB,KAAK,IAAI,GAAG,QAAQ,MAAM,aAAa,iBAAiB,OAAO,CAAC,CAAC;EACxI,KAAK,UAAU,KAAK,QAAQ,QAAQ,OAAO,UAAU,GAAG,WAAW,yBAAyB,GAAG,EAAE;CACnG;;CAGA,KAAK,MAAgB,MAA8B;EACjD,MAAM,QAAQ,YAAY,KAAK;EAC/B,MAAM,MAAM,iBAAiB,KAAK,SAAS,KAAK,CAAC,CAAC,QAAQ,KAAK,MAAM,MAAM,IAAI,CAAC;EAChF,OAAO,YAAY,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG;CACjE;;;;;CAKA,MAAM,cAAc,MAAgB,MAAkB,MAA2E;EAC/H,OAAO,YAAY,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,GAAG,MAAM,KAAK,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC;CAC3F;;CAEA,MAAc,MAAgB,MAA8B;EAC1D,MAAM,SAAS;GAAC;GAAS,KAAK;GAAM,KAAK;GAAI,KAAK;GAAI,KAAK;GAAM,KAAK;GAAS,KAAK;GAAK,KAAK;GAAI,KAAK;GAAI,KAAK;GAAM,KAAK,QAAQ;GAAM,WAAW,IAAI;GAAG,KAAK;EAAO;EACvK,MAAM,YAAY,YAAY,KAAK,WAAW,KAAK,UAAU,CAAC,uBAAuB,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;EAC1G,MAAM,SAAS,WAAW,KAAK,UAAU,CAAC,QAAQ,SAAS,CAAC,CAAC;EAC7D,MAAM,yBAAS,IAAI,WAAW,CAAC;EAC/B,IAAI,SAAS,OAAO,MAAM,CAAC,CAAC,UAAU,GAAG,OAAO,MAAM;EACtD,OAAO,YAAY,QAAQ,QAAQ,IAAI;CACzC;;;;;;;;;;;;CAaA,KAAK,OAAmB,SAAgK,CAAC,GAAqE;EAC5P,MAAM,MAAM,OAAO,OAAO,KAAK,IAAI;EACnC,IAAI,MAAM,UAAU,OAAO,YAAY,YAAY,iBAAiB,MAAM,IAAI,iBAAiB,QAAQ,sCAAsC;EAC7I,IAAI,MAAM,SAAS,MAAM,SAAS,IAAI,KAAK,KAAK,CAAC,MAAM,OAAO,GAAG,MAAM,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC9I,MAAM,UAAU,MAAM,MAAM;EAC5B,IAAI,YAAY,YAAY,YAAY,aAAa,CAAC,OAAO,UAAU,MAAM,IAAI,iBAAiB,UAAU,gCAAgC;EAC5I,IAAI,OAA0B;EAC9B,IAAI,YAAY,WAAW;GACzB,YAAY,MAAM,SAAS,MAAM,SAAS,CAAC;GAC3C,IAAI;IAAE,QAAQ,OAAO,QAAS,SAAS;GAAG,QAAQ;IAAE,QAAQ;GAAM;GAClE,IAAI,CAAC,OAAO,MAAM,IAAI,iBAAiB,YAAY,wEAAwE;EAC7H,OAAO;GACL,IAAI,MAAM,SAAS,MAAM,SAAS,IAAI,QAAQ,KAAK,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;GAC5G,IAAI;IAAE,QAAQ,iBAAiB,KAAK,SAAS,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,SAAS,MAAM,SAAS,IAAI,KAAK,CAAC;GAAG,QACtJ;IAAE,MAAM,IAAI,iBAAiB,YAAY,mDAAmD;GAAG;EACvG;EACA,IAAI;GAAE,OAAO,KAAK,KAAK,OAAO,WAAW,QAAQ,GAAG;EAAG,SAChD,OAAO;GAEZ,IAAI,iBAAiB,oBAAoB,WAAW,MAAM,YAAY;GACtE,MAAM;EACR;CACF;;CAEA,KAAa,OAAmB,WAAmC,QAAyE,KAA+E;EACzN,IAAI,MAAM,SAAS,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC5E,MAAM,eAAe,IAAI,SAAS,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;EAChF,IAAI,eAAe,UAAc,IAAI,eAAe,MAAM,QAAQ,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EACxH,IAAI;EACJ,IAAI;GAAE,SAAS,KAAK,MAAM,WAAW,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC;EAAG,QAAQ;GAAE,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAAG;EAC/I,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,KAAK,CAAC,MAAM,QAAQ,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,WAAW,MAAM,OAAO,OAAO,OAAO,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAC1N,MAAM,CAAC,QAAQ,aAAa;EAC5B,MAAM,CAAC,GAAG,MAAM,IAAI,QAAQ,WAAW,SAAS,KAAK,IAAI,IAAI,MAAM,MAAM,QAAQ,WAAW;EAC5F,IAAI,MAAM,WAAW,OAAO,SAAS,YAAY,OAAO,OAAO,YAAY,OAAO,WAAW,YAAY,OAAO,cAAc,YAAY,OAAO,YAAY,YAAY,CAAC,QAAQ,KAAK,OAAO,KAC5L,CAAC,OAAO,cAAc,GAAG,KAAM,MAAiB,KAAK,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAK,EAAE,KAAK,CAAC,OAAO,cAAc,EAAE,KAAM,MAAiB,KACnJ,OAAO,SAAS,YAAY,CAAC,MAAM,SAAS,IAAI,KAAK,OAAO,WAAW,YAAY,CAAC,OAAO,cAAc,OAAO,GAAG,MAAM,IAAI,iBAAiB,UAAU,iBAAiB;EAE3K,IAAI,SAAS,KAAK,MAAM,OAAO,KAAK,QAAQ,cAAc,KAAK,IAAI,MAAM,IAAI,iBAAiB,cAAc,mCAAmC;EAC/I,IAAI,WAAW,KAAK,MAAM,MAAM,IAAI,iBAAiB,UAAU,8CAA8C;EAC7G,IAAI,OAAO,WAAW,YAAY,OAAO,SAAS,MAAM,IAAI,iBAAiB,cAAc,uCAAuC;EAClI,IAAI;EACJ,IAAI;GAAE,QAAQ,OAAO,cAAc,SAAS,GAAG,WAAW,KAAK,UAAU,CAAC,uBAAuB,MAAM,CAAC,CAAC,GAAG,iBAAiB,MAAM,CAAC;EAAG,QAAQ;GAAE,QAAQ;EAAO;EAChK,IAAI,CAAC,OAAO,MAAM,IAAI,iBAAiB,aAAa,8CAA8C;EAClG,MAAM,OAAO,MAAM,SAAS,IAAI,YAAY;EAC5C,IAAI,WAAW,IAAI,MAAM,QAAQ,MAAM,IAAI,iBAAiB,UAAU,mDAAmD;EAMzH,IAAK,WAAuB,MAAkB,UAAqB,MAAM,YAAY,QAAQ,YAAY,aAAa,MAAM,IAAI,iBAAiB,UAAU,2CAA2C;EACtM,MAAM,SAAqB;GAAE,GAAG;GAAG;GAAM;GAAI;GAAQ;GAAW;GAAc;GAAe;GAAQ;GAAoB;GAAkB;GAAM;GAAiB;EAAkB;EAEpL,IAAI,CAAC,aAAa,OAAO,eAAe,SAAS,YAAY,MAAM,IAAI,iBAAiB,SAAS,mFAAmF;EACpL,UAAU,QAAQ,MAAM,OAAO,QAAQ;EACvC,OAAO;GAAE;GAAQ;GAAM,GAAI,aAAa,EAAE,UAAU;EAAG;CACzD;;CAGA,eAAe,SAAsB,MAAM,KAAK,IAAI,GAAkB;EACpE,MAAM,OAAO;GAAC;GAAS,QAAQ;GAAK,QAAQ;GAAQ,QAAQ;GAAS,QAAQ;GAAa,QAAQ;GAAK,QAAQ;GAAK,QAAQ;GAAO,QAAQ;GAAO,QAAQ,QAAQ,MAAM,GAAG;EAAC;EAC5K,MAAM,YAAY,YAAY,KAAK,WAAW,KAAK,UAAU;GAAC;GAAwB,KAAK;GAAM,KAAK;GAAI;EAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;EAC7H,MAAM,MAAM,KAAK,IAAI,OAAW,KAAK,IAAI,IAAI,KAAK,MAAM,QAAQ,UAAU,OAAO,GAAI,CAAC,CAAC;EACvF,MAAM,UAAU,CAAC;GAAE,OAAO;GAAS,OAAO,QAAQ,KAAK,UAAU,CAAC,MAAM,SAAS,CAAC,GAAG,KAAK,OAAO;GAAG;EAAI,CAAC;EACzG,IAAI,eAAe,KAAK,SAAS,WAAW,OAAO,IAAA,KAA0B,MAAM,IAAI,MAAM,qFAAqF;EAClL,OAAO;CACT;;;;;;CAOA,YAAY,QAAsB,WAAW,OAA2B;EACtE,IAAI,OAAO,cAAc,KAAK,eAAe,eAAe,OAAO,WAAW,OAAO,OAAO,IAAA,KAA0B,OAAO;EAC7H,MAAM,UAAU,OAAO,QAAQ,QAAO,MAAK,EAAE,UAAU,OAAO;EAC9D,IAAI,QAAQ,WAAW,GAAG,OAAO;EACjC,MAAM,QAAQ,WAAW,QAAQ,EAAE,CAAC,OAAO,KAAK,OAAO;EACvD,IAAI,CAAC,OAAO,OAAO;EACnB,IAAI;EACJ,IAAI;GAAE,SAAS,KAAK,MAAM,KAAK;EAAG,QAAQ;GAAE,OAAO;EAAM;EACzD,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,KAAK,CAAC,MAAM,QAAQ,OAAO,EAAE,KAAM,OAAO,EAAE,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC,WAAW,MAAO,OAAO,OAAO,OAAO,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,GAAG,OAAO;EACvM,MAAM,CAAC,MAAM,aAAa;EAC1B,MAAM,CAAC,GAAG,KAAK,QAAQ,SAAS,aAAa,KAAK,KAAK,OAAO,OAAO,UAAU,CAAC,KAAK;EACrF,IAAI,MAAM,WAAW,CAAC;GAAC;GAAK;GAAQ;GAAS;GAAK;GAAK;GAAO;EAAK,CAAC,CAAC,OAAM,MAAK,OAAO,cAAc,CAAC,KAAM,KAAgB,CAAC,KAC1H,gBAAgB,QAAQ,CAAC,UAAU,aAAa,QAAQ,KACzD,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,MAAM,CAAC,QAAQ,OAAM,MAAK,OAAO,cAAc,CAAC,KAAM,IAAe,CAAC,GAAG,OAAO;EAC9H,IAAI;GACF,IAAI,CAAC,OAAO,cAAc,SAAS,GAAG,WAAW,KAAK,UAAU;IAAC;IAAwB,KAAK;IAAI,KAAK;IAAM;GAAI,CAAC,CAAC,GAAG,iBAAiB,KAAK,IAAI,CAAC,GAAG,OAAO;EAC7J,QAAQ;GAAE,OAAO;EAAM;EACvB,OAAO;GAAO;GAAuB;GAA2B;GAAgC;GAAmC;GAAoB;GAAsB;GAAwB;GAA0B;EAAoB;CACrP;AACF;;;;;;;;;AAUA,SAAgB,UAAU,OAAgB,WAAW,OAAwB;CAC3E,IAAI,OAAO,UAAU,YAAY,MAAM,SAAS,MAAM,OAAO;CAC7D,IAAI;CACJ,IAAI;EAAE,MAAM,IAAI,IAAI,KAAK;CAAG,QAAQ;EAAE,OAAO;CAAO;CACpD,IAAI,IAAI,YAAY,IAAI,UAAU,OAAO;CACzC,MAAM,OAAO,IAAI,SAAS,YAAY,CAAC,CAAC,QAAQ,QAAQ,EAAE;CAC1D,IAAI,YAAY,IAAI,aAAa,WAAW;EAAC;EAAa;EAAa;CAAO,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;CACvG,IAAI,IAAI,aAAa,YAAY,CAAC,KAAK,SAAS,GAAG,KAAK,KAAK,WAAW,GAAG,KAAK,iBAAiB,IAAI,GAAG,OAAO;CAE/G,OAAO,CAAC,uBAAuB,KAAK,IAAI,KAAK,gBAAgB,WAAW,KAAK,KAAK,MAAM,GAAG,GAAG,MAAM,CAAC;AACvG;;AAGA,SAAS,UAAU,QAAoB,MAAkB,WAAW,OAAa;CAC/E,MAAM,OAAO,YAAoB,IAAI,iBAAiB,UAAU,OAAO;CACvE,QAAQ,OAAO,MAAf;EACE,KAAK;GACH,IAAI,KAAK,SAAS,YAAY,cAAc,MAAM,IAAI,2BAA2B;GACjF,IAAI;IAAE,WAAW,IAAI;GAAG,QAAQ;IAAE,MAAM,IAAI,2BAA2B;GAAG;GAC1E;EACF,KAAK;GACH,IAAI,KAAK,SAAS,YAAY,wBAAwB,MAAM,IAAI,uCAAuC;GACvG;EACF,KAAK,QAAQ;GACX,MAAM,OAAO,OAAO;GACpB,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,OAAO,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,OAAO,KAAK,SAAS,KAAK,QAAQ,MAAM,IAAI,8CAA8C;GAClP;EACF;EACA,KAAK;GACH,IAAI,KAAK,WAAW,GAAG,MAAM,IAAI,4BAA4B;GAC7D,aAAa,OAAO,MAAM,QAAQ;GAClC;CAEJ;AACF;;AAGA,SAAgB,aAAa,MAAe,WAAW,OAA4B;CACjF,MAAM,OAAO,YAAoB,IAAI,iBAAiB,UAAU,OAAO;CACvE,MAAM,UAAW,MAAuC;CACxD,IAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,YAAY,mBAAmB,MAAM,IAAI,mCAAmC;CAC5H,IAAI,OAAO,GAAG,QAAQ;CACtB,MAAM,MAA2B,CAAC;CAClC,KAAK,MAAM,SAAS,SAAS;EAC3B,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAAG,MAAM,IAAI,2BAA2B;EACtF,MAAM,CAAC,KAAK,IAAI,MAAM,OAAO,KAAK,WAAW;EAC7C,IAAI,CAAC,OAAO,cAAc,GAAG,KAAK,OAAO,QAAQ,OAAO,OAAO,YAAY,CAAC,QAAQ,KAAK,EAAE,KAAK,OAAO,SAAS,YAAY,CAAC,MAAM,SAAS,IAAI,KAAK,SAAS,cAC5J,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,KAAK,QAAQ,YAAY,kBAAkB,CAAC,UAAU,KAAK,QAAQ,KAAK,CAAC,OAAO,cAAc,OAAO,GAAG,MAAM,IAAI,2BAA2B;EACvL,OAAO;EAAK,SAAS;EACrB,IAAI,QAAQ,YAAY,iBAAiB,MAAM,IAAI,iDAAiD;EACpG,IAAI,KAAK;GAAC;GAAK;GAAI;GAA8B;GAAO;GAAK;EAAO,CAAC;CACvE;CACA,OAAO;AACT;;ACzUA,IAAa,aAAa;CAAC;CAAU;CAAc;AAAU;AA2C7D,SAAgB,aAAa,OAAe,WAA8B,UAAkB;CAC1F,IAAI;CACJ,IAAI;EAAE,MAAM,IAAI,IAAI,KAAK;CAAG,QAAQ;EAAE,OAAO;CAAO;CACpD,MAAM,OAAO,IAAI,UAAU,OAAO,KAAK,QAAQ,OAAO,EAAE;CACxD,IAAI,CAAC,KAAK,SAAS,GAAG,KAAK,SAAS,aAAa,OAAO;CACxD,IAAI,KAAK,WAAW,GAAG,KAAK,kBAAkB,KAAK,IAAI,GAAG,OAAO;CACjE,MAAM,SAAS,aAAa,YAAY,oBAAoB,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK;CACtF,IAAI,WAAW,MAAM,OAAO;CAC5B,IAAI,WAAW;CACf,OAAO,IAAI;AACb;;AAGA,SAAgB,eAAkB,YAAe,WAA8B,UAAa;CAC1F,MAAM,QAAS,YAAuD;CACtE,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,MAAM,YAAY,aAAa,OAAO,QAAQ;CAC9C,OAAO,cAAc,QAAQ,aAAa;EAAE,GAAG;EAAY,OAAO;CAAU;AAC9E;;;;;AAMA,IAAa,YAAY;;;;;;AAMzB,IAAa,qBAAqB;;AAElC,IAAa,YAAY,UAAoC,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK,KAAK,CAAC,mBAAmB,KAAK,KAAK;;AAEjJ,IAAM,uBAAuB;;;;;AAK7B,IAAa,mBAAmB,UAA2B,CAAC,SAAS,KAAK,KAAK,CAAC,mBAAmB,KAAK,KAAK,KAAK,qBAAqB,KAAK,KAAK;;;;;;;;AAQjJ,SAAgB,kBAAkB,OAAgB,KAAiC;CACjF,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;CAClD,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO;CAC7B,MAAM,QAAQ,GAAW,MAAc;EAAE,IAAI;GAAE,OAAO,IAAI,IAAI,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;EAAM,QAAQ;GAAE,OAAO;EAAO;CAAE;CACnK,OAAO,IAAI,MAAK,SAAQ,KAAK,MAAM,KAAK,CAAC,KAAK,UAAU,KAAK;AAC/D;AACA,IAAM,UAAU;;AAEhB,IAAM,iBAAiB;AACvB,IAAM,gBAAgB;;;;;;;;AAStB,SAAgB,mBAAmB,OAAsC;CACvE,MAAM,MAA4B,CAAC;CACnC,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,OAAO;CACxE,MAAM,MAAM;CACZ,MAAM,WAAW,MAAe,MAAM,KAAA,KAAa,OAAO,MAAM;CAChE,MAAM,OAAO,IAAI;CACjB,IAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,OAAO,YAAY,QAAQ,KAAK,KAAK,EAAE,MACxF,KAAK,UAAU,KAAA,KAAa,KAAK,UAAU,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,OAAO,KACjG,MAAM,QAAQ,KAAK,SAAS,KAAK,KAAK,UAAU,UAAU,iBAC1D,KAAK,UAAU,OAAM,MAAK,OAAO,MAAM,YAAY,eAAe,KAAK,CAAC,CAAC,GACzE,IAAI,YAAY;EAAE,IAAI,KAAK;EAAI,OAAQ,KAAK,SAAuC;EAAM,WAAW,CAAC,GAAG,KAAK,SAAS;EACpH,GAAI,KAAK,YAAY,KAAA,IAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAAG;CACrE,MAAM,QAAQ,IAAI;CAClB,IAAI,SAAS,OAAO,UAAU,YAAY,OAAO,MAAM,cAAc,YAAY,QAAQ,KAAK,MAAM,SAAS,MAC1G,MAAM,UAAU,KAAA,KAAa,SAAS,MAAM,KAAK,MAAM,QAAQ,MAAM,OAAO,GAC7E,IAAI,gBAAgB;EAAE,WAAW,MAAM;EAAW,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC1G,GAAI,MAAM,YAAY,KAAA,IAAY,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;CAAG;CACvE,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAA6B,QAAiD;CAC9G,MAAM,aAAa,WAA4B,eAAiC;EAC9E,IAAI,CAAC,cAAc,OAAO,eAAe,UAAU,OAAO;EAC1D,MAAM,IAAI;EACV,OAAO,EAAE,YAAY,QAAS,cAAc,YAAY,MAAM,QAAQ,EAAE,SAAS,KAAK,EAAE,UAAU,WAAW;CAC/G;CACA,OAAQ,CAAC,UAAU,YAAY,CAAC,CAAW,QAAO,MAAK,UAAU,GAAG,MAAM,EAAE,KAAK,UAAU,GAAG,OAAO,EAAE,CAAC;AAC1G;;;;;;;AAQA,SAAgB,eAAe,OAA0B,QAA2B,UAA6B,CAAC,GAAsB;CACtI,MAAM,WAAW,MAAuB,MAAM,YAAY,QAAQ,SAAS,CAAC,IAAI,IAAI;CACpF,OAAO,WAAW,QAAO,MAAK,MAAM,SAAS,CAAC,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC,CACnE,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAChC,MAAM,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAM,MAAM,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,MAC7E,WAAW,QAAQ,CAAC,IAAI,WAAW,QAAQ,CAAC,CAAC;AACtD;;;;;;;;AASA,IAAa,kBAA8C;CAAC;CAAU;CAAY;AAAY;AAC9F,SAAgB,mBAAmB,WAAuC,WAAW,MAAuB;CAC1G,IAAI,CAAC,UAAU,OAAO,UAAU,SAAS,UAAU,IAAI,aAAa,WAAW,MAAK,MAAK,UAAU,SAAS,CAAC,CAAC,KAAK;CACnH,OAAO,gBAAgB,MAAK,MAAK,UAAU,SAAS,CAAC,CAAC,KAAK;AAC7D;AAEA,SAAgB,eAAe,WAAuC,WACpE,UAAsC;CACtC,MAAM,OAAO,WAAW,QAAO,MAAK,UAAU,SAAS,CAAC,KAAK,MAAM,SAAS;CAC5E,OAAO,CAAC,GAAI,UAAU,SAAS,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,GAAI,GAAI,WAAW,OAAO,CAAC,CAAE;AAC1F"}
|
package/dist/testing.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { n as decodeBolt11 } from "./bolt11-CRiQrma3.js";
|
|
2
|
-
import { D as emptyIdentityLedger, P as newIdentityBinding, an as createIdentity, j as identityStatement, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress, w as IdentityExchange } from "./bitcoinAddress-
|
|
2
|
+
import { D as emptyIdentityLedger, P as newIdentityBinding, an as createIdentity, j as identityStatement, l as IDENTITY_MAX_EVIDENCE, n as isBitcoinAddress, w as IdentityExchange } from "./bitcoinAddress-CDYL3yPz.js";
|
|
3
3
|
import { l as providerDescriptorProblems, o as isNothingSpentError } from "./types-DbgC491n.js";
|
|
4
|
-
import { i as verifyIdentity, r as descriptorProblems } from "./verify-
|
|
4
|
+
import { i as verifyIdentity, r as descriptorProblems } from "./verify-CmN2lXY3.js";
|
|
5
5
|
import { _ as fakeAddress, a as fakeAccount, b as fakeOnchain, c as fakeKeySign, d as fakeRecord, f as fakeRecordText, g as TEST_PROVIDERS_FLAG, h as FakeOnchainProvider, i as TEST_IDENTITIES_FLAG, l as fakeKeySubject, m as FakeLightningProvider, n as FAKE_ISSUER, o as fakeAccountToken, p as testIdentitiesEnabled, r as FAKE_RECORD_HOST, s as fakeKey, t as FAKE_IDENTITY_PROVIDERS, u as fakeKeyring, v as fakeInvoice, x as testProvidersEnabled, y as fakeLightning } from "./fakes-Cgl1w4Nv.js";
|
|
6
6
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
7
7
|
// ../browser/src/engine/paymentAdapters/providers/contractSuite.ts
|
|
@@ -87,7 +87,8 @@ export interface SubjectPreview {
|
|
|
87
87
|
/** Short facts, in order: "Method" → "did:web", "Keys" → "#key-1 (Ed25519)". */
|
|
88
88
|
facts: readonly {
|
|
89
89
|
label: string;
|
|
90
|
-
value: string;
|
|
90
|
+
value: string; /** A machine token (a host, URL, key id), not a sentence: shown left to right in any language. */
|
|
91
|
+
code?: true;
|
|
91
92
|
}[];
|
|
92
93
|
/** The ids of the signers that apply to this subject; every signer when omitted. */
|
|
93
94
|
signers?: readonly string[];
|