@kehto/paja 0.6.0 → 0.8.0

package/dist/cli.js

@@ -9,7 +9,7 @@ import {
   startPajaServer,
   summarizePajaSimulation,
   waitForTargetUrl
-} from "./chunk-5QKVKI4K.js";
+} from "./chunk-NFJCS5PG.js";
 
 // src/cli.ts
 import { spawn } from "child_process";
@@ -117,12 +117,13 @@ Options:
   --config <path>             JSON config file using the same option schema.
   --identity-mode <mode>      anonymous or fixed.
   --identity-pubkey <hex>     Required when identity mode is fixed.
-  --relay-mode <mode>         memory or disabled.
-  --relay-url <url>           Add a relay URL for memory relay simulation.
+  --relay-mode <mode>         live, memory, or disabled.
+  --relay-url <url>           Add a relay URL for live or memory relay backends.
   --storage-mode <mode>       local, memory, or disabled.
   --cache-mode <mode>         memory or disabled.
-  --upload-mode <mode>        memory or disabled.
+  --upload-mode <mode>        memory, blossom, or disabled.
   --upload-rail <name>        Upload rail name for memory uploads.
+  --upload-server <url>       Add a shell-owned Blossom server (repeatable).
   --media <state>             enabled or disabled.
   --notifications <state>     enabled or disabled.
   --notify-grant <bool>       true or false default notification grant.
@@ -174,7 +175,7 @@ function applySimulationOption(arg, args, index, raw) {
       setIdentity(raw, { pubkey: readValue(args, index, arg) });
       return true;
     case "--relay-mode":
-      setRelay(raw, { mode: readEnum(args, index, arg, ["memory", "disabled"]) });
+      setRelay(raw, { mode: readEnum(args, index, arg, ["live", "memory", "disabled"]) });
       return true;
     case "--relay-url":
       setRelay(raw, { urls: [...raw.simulation?.relay?.urls ?? [], readValue(args, index, arg)] });
@@ -186,11 +187,14 @@ function applySimulationOption(arg, args, index, raw) {
       ensureSimulation(raw).cache = { ...raw.simulation?.cache, mode: readEnum(args, index, arg, ["memory", "disabled"]) };
       return true;
     case "--upload-mode":
-      setUpload(raw, { mode: readEnum(args, index, arg, ["memory", "disabled"]) });
+      setUpload(raw, { mode: readEnum(args, index, arg, ["memory", "blossom", "disabled"]) });
       return true;
     case "--upload-rail":
       setUpload(raw, { rail: readValue(args, index, arg) });
       return true;
+    case "--upload-server":
+      setUpload(raw, { servers: [...raw.simulation?.upload?.servers ?? [], readValue(args, index, arg)] });
+      return true;
     case "--media":
       ensureSimulation(raw).media = { ...raw.simulation?.media, enabled: readEnabled(args, index, arg) };
       return true;

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { spawn, type ChildProcess } from 'node:child_process';\nimport {\n  createPajaHostConfig,\n  formatPajaUrl,\n  normalizePajaOptions,\n  waitForTargetUrl,\n  type PajaCommand,\n  type PajaRawOptions,\n  PajaOptionsError,\n} from './index.js';\nimport { resolvePajaRawOptions } from './config-file.js';\nimport { startPajaServer } from './server.js';\nimport {\n  PAJA_SIMULATION_DOMAINS,\n  summarizePajaSimulation,\n  type PajaCapabilityDomain,\n  type PajaSimulationRawOptions,\n  type JsonValue,\n} from './simulation.js';\n\n/**\n * Minimal output streams used by the CLI runner.\n *\n * @remarks\n * Tests and embedders can pass custom streams to capture output without\n * patching global `process.stdout` or `process.stderr`.\n */\nexport interface CliIo {\n  readonly stdout: { write(chunk: string): void };\n  readonly stderr: { write(chunk: string): void };\n}\n\n/**\n * Parsed CLI arguments before full option normalization.\n */\nexport interface CliParseResult {\n  readonly options?: PajaRawOptions;\n  readonly help: boolean;\n}\n\n/**\n * Execution controls for embedding the CLI runner in tests or wrappers.\n */\nexport interface RunPajaCliOptions {\n  readonly serve?: boolean;\n  readonly startServer?: typeof startPajaServer;\n  readonly startCommand?: (command: PajaCommand, io: CliIo) => ManagedChildProcess;\n  readonly waitForTargetUrl?: typeof waitForTargetUrl;\n  readonly targetDiscoveryGraceMs?: number;\n}\n\n/**\n * Parse raw `kehto paja` arguments into raw runtime options.\n *\n * @param args - Argument vector without the node executable or script path.\n * @returns Parsed raw options, or a help flag when `--help` is present.\n */\nexport function parsePajaArgs(args: readonly string[]): CliParseResult {\n  const raw: MutablePajaRawOptions = {};\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg === '--') {\n      const argv = args.slice(index + 1);\n      raw.command = { mode: 'argv', argv };\n      break;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      return { help: true };\n    }\n\n    if (applyCoreOption(arg, args, index, raw) || applySimulationOption(arg, args, index, raw)) {\n      index += 1;\n      continue;\n    }\n\n    throw new PajaOptionsError(`Unknown option \"${arg}\". Run kehto paja --help for usage.`);\n  }\n\n  return { help: false, options: raw };\n}\n\nexport async function runPajaCli(\n  args: readonly string[] = process.argv.slice(2),\n  io: CliIo = defaultIo,\n  runOptions: RunPajaCliOptions = {},\n): Promise<number> {\n  try {\n    const parsed = parsePajaArgs(args);\n    if (parsed.help) {\n      io.stdout.write(`${HELP_TEXT}\\n`);\n      return 0;\n    }\n\n    const rawOptions = resolvePajaRawOptions(parsed.options ?? {});\n    const options = normalizePajaOptions(rawOptions);\n    const hostConfig = createPajaHostConfig(options);\n    const shouldServe = runOptions.serve ?? true;\n    const startServer = runOptions.startServer ?? startPajaServer;\n    const startCommand = runOptions.startCommand ?? startManagedCommand;\n    const waitForTarget = runOptions.waitForTargetUrl ?? waitForTargetUrl;\n    let child: ManagedChildProcess | undefined;\n    let server: Awaited<ReturnType<typeof startPajaServer>> | undefined;\n    if (shouldServe) {\n      try {\n        server = await startServer({ options: rawOptions });\n        writeRuntimeSummary(io, server.url, hostConfig, options);\n\n        if (options.command) {\n          child = startCommand(options.command, io);\n          const targetUrl = await resolveManagedTargetUrl(options.targetUrl, child, {\n            timeoutMs: options.readyTimeoutMs,\n            discoveryGraceMs: runOptions.targetDiscoveryGraceMs,\n            waitForTargetUrl: waitForTarget,\n          });\n          if (targetUrl !== options.targetUrl) {\n            server.updateTargetUrl(targetUrl);\n            io.stdout.write(`Target URL updated: ${targetUrl}\\n`);\n          }\n        }\n      } catch (error) {\n        child?.kill();\n        await server?.close().catch(() => undefined);\n        throw error;\n      }\n    }\n    const runtimeUrl = server?.url ?? formatPajaUrl(options);\n\n    if (!shouldServe) {\n      writeRuntimeSummary(io, runtimeUrl, hostConfig, options);\n    }\n\n    return 0;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    io.stderr.write(`kehto paja: ${message}\\n`);\n    return 1;\n  }\n}\n\nfunction writeRuntimeSummary(\n  io: CliIo,\n  runtimeUrl: string,\n  hostConfig: ReturnType<typeof createPajaHostConfig>,\n  options: ReturnType<typeof normalizePajaOptions>,\n): void {\n    io.stdout.write(`Kehto Paja\\n`);\n    io.stdout.write(`Runtime URL: ${runtimeUrl}\\n`);\n    io.stdout.write(`Target URL: ${hostConfig.target.url}\\n`);\n    io.stdout.write(`Mode: ${options.mode}\\n`);\n    io.stdout.write(`HMR: ${hostConfig.target.hmrStrategy}\\n`);\n    io.stdout.write(`Simulation: ${summarizePajaSimulation(options.simulation)}\\n`);\n\n    if (options.command) {\n      io.stdout.write(`Command: ${formatCommand(options.command)}\\n`);\n    }\n}\n\nconst HELP_TEXT = `Usage:\n  kehto paja --target-url <url> [options]\n  kehto paja --target-url <url> [options] -- <command...>\n\nOptions:\n  --target-url, -u <url>      App dev-server URL to load in the runtime iframe.\n  --command, -c <command>     Shell command to start before waiting for target URL.\n  -- <command...>             Argv command form; preserves arbitrary framework commands.\n  --host <host>               Runtime host. Default: 127.0.0.1.\n  --port <port>               Runtime port. Default: 5197.\n  --ready-timeout <ms>        Target readiness timeout. Default: 30000.\n  --config <path>             JSON config file using the same option schema.\n  --identity-mode <mode>      anonymous or fixed.\n  --identity-pubkey <hex>     Required when identity mode is fixed.\n  --relay-mode <mode>         memory or disabled.\n  --relay-url <url>           Add a relay URL for memory relay simulation.\n  --storage-mode <mode>       local, memory, or disabled.\n  --cache-mode <mode>         memory or disabled.\n  --upload-mode <mode>        memory or disabled.\n  --upload-rail <name>        Upload rail name for memory uploads.\n  --media <state>             enabled or disabled.\n  --notifications <state>     enabled or disabled.\n  --notify-grant <bool>       true or false default notification grant.\n  --theme <mode>              dark or light.\n  --config-value <key=json>   Add a JSON config value.\n  --capability <domain:on|off> Toggle an advertised capability domain.\n  --acl-mode <mode>           allow or deny.\n  --firewall-mode <mode>      allow, deny, or observe.\n  --help, -h                  Show this help.`;\n\nfunction readValue(args: readonly string[], index: number, option: string): string {\n  const value = args[index + 1];\n  if (!value || value.startsWith('--')) {\n    throw new PajaOptionsError(`${option} requires a value.`);\n  }\n  return value;\n}\n\nfunction applyCoreOption(\n  arg: string,\n  args: readonly string[],\n  index: number,\n  raw: MutablePajaRawOptions,\n): boolean {\n  switch (arg) {\n    case '--target-url':\n    case '-u':\n      raw.targetUrl = readValue(args, index, arg);\n      return true;\n    case '--command':\n    case '-c':\n      raw.command = { mode: 'shell', command: readValue(args, index, arg) };\n      return true;\n    case '--host':\n      raw.host = readValue(args, index, arg);\n      return true;\n    case '--port':\n      raw.port = readValue(args, index, arg);\n      return true;\n    case '--ready-timeout':\n      raw.readyTimeoutMs = readValue(args, index, arg);\n      return true;\n    case '--config':\n      raw.configPath = readValue(args, index, arg);\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction applySimulationOption(\n  arg: string,\n  args: readonly string[],\n  index: number,\n  raw: MutablePajaRawOptions,\n): boolean {\n  switch (arg) {\n    case '--identity-mode':\n      setIdentity(raw, { mode: readEnum(args, index, arg, ['anonymous', 'fixed']) });\n      return true;\n    case '--identity-pubkey':\n      setIdentity(raw, { pubkey: readValue(args, index, arg) });\n      return true;\n    case '--relay-mode':\n      setRelay(raw, { mode: readEnum(args, index, arg, ['memory', 'disabled']) });\n      return true;\n    case '--relay-url':\n      setRelay(raw, { urls: [...(raw.simulation?.relay?.urls ?? []), readValue(args, index, arg)] });\n      return true;\n    case '--storage-mode':\n      ensureSimulation(raw).storage = { ...raw.simulation?.storage, mode: readEnum(args, index, arg, ['local', 'memory', 'disabled']) };\n      return true;\n    case '--cache-mode':\n      ensureSimulation(raw).cache = { ...raw.simulation?.cache, mode: readEnum(args, index, arg, ['memory', 'disabled']) };\n      return true;\n    case '--upload-mode':\n      setUpload(raw, { mode: readEnum(args, index, arg, ['memory', 'disabled']) });\n      return true;\n    case '--upload-rail':\n      setUpload(raw, { rail: readValue(args, index, arg) });\n      return true;\n    case '--media':\n      ensureSimulation(raw).media = { ...raw.simulation?.media, enabled: readEnabled(args, index, arg) };\n      return true;\n    case '--notifications':\n      setNotifications(raw, { enabled: readEnabled(args, index, arg) });\n      return true;\n    case '--notify-grant':\n      setNotifications(raw, { grant: readBoolean(args, index, arg) });\n      return true;\n    case '--theme':\n      ensureSimulation(raw).theme = { ...raw.simulation?.theme, mode: readEnum(args, index, arg, ['dark', 'light']) };\n      return true;\n    case '--config-value':\n      setConfigValue(raw, readConfigValue(args, index, arg));\n      return true;\n    case '--capability':\n      setCapability(raw, readCapability(args, index, arg));\n      return true;\n    case '--acl-mode':\n      ensureSimulation(raw).acl = { ...raw.simulation?.acl, mode: readEnum(args, index, arg, ['allow', 'deny']) };\n      return true;\n    case '--firewall-mode':\n      ensureSimulation(raw).firewall = { ...raw.simulation?.firewall, mode: readEnum(args, index, arg, ['allow', 'deny', 'observe']) };\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction formatCommand(command: PajaCommand): string {\n  return command.mode === 'argv' ? command.argv.join(' ') : command.command;\n}\n\nfunction readEnum<const T extends readonly string[]>(\n  args: readonly string[],\n  index: number,\n  option: string,\n  allowed: T,\n): T[number] {\n  const value = readValue(args, index, option);\n  if (!allowed.includes(value)) {\n    throw new PajaOptionsError(`${option} must be one of: ${allowed.join(', ')}.`);\n  }\n  return value;\n}\n\nfunction readEnabled(args: readonly string[], index: number, option: string): boolean {\n  const value = readValue(args, index, option);\n  if (value === 'enabled') return true;\n  if (value === 'disabled') return false;\n  throw new PajaOptionsError(`${option} must be \"enabled\" or \"disabled\".`);\n}\n\nfunction readBoolean(args: readonly string[], index: number, option: string): boolean {\n  const value = readValue(args, index, option);\n  if (value === 'true') return true;\n  if (value === 'false') return false;\n  throw new PajaOptionsError(`${option} must be \"true\" or \"false\".`);\n}\n\nfunction readConfigValue(\n  args: readonly string[],\n  index: number,\n  option: string,\n): { key: string; value: JsonValue } {\n  const raw = readValue(args, index, option);\n  const separator = raw.indexOf('=');\n  if (separator <= 0) {\n    throw new PajaOptionsError(`${option} expects key=json.`);\n  }\n  const key = raw.slice(0, separator).trim();\n  if (!key) {\n    throw new PajaOptionsError(`${option} expects a non-empty key.`);\n  }\n  try {\n    return { key, value: JSON.parse(raw.slice(separator + 1)) as JsonValue };\n  } catch {\n    throw new PajaOptionsError(`${option} value for \"${key}\" must be valid JSON.`);\n  }\n}\n\nfunction readCapability(\n  args: readonly string[],\n  index: number,\n  option: string,\n): { domain: PajaCapabilityDomain; enabled: boolean } {\n  const raw = readValue(args, index, option);\n  const [domainRaw, stateRaw] = raw.split(':') as [string | undefined, string | undefined];\n  if (!domainRaw || (stateRaw !== 'on' && stateRaw !== 'off')) {\n    throw new PajaOptionsError(`${option} expects domain:on or domain:off.`);\n  }\n  if (!PAJA_SIMULATION_DOMAINS.includes(domainRaw as PajaCapabilityDomain)) {\n    throw new PajaOptionsError(`${option} unknown domain \"${domainRaw}\".`);\n  }\n  return {\n    domain: domainRaw as PajaCapabilityDomain,\n    enabled: stateRaw === 'on',\n  };\n}\n\nfunction setIdentity(raw: MutablePajaRawOptions, identity: NonNullable<PajaSimulationRawOptions['identity']>): void {\n  ensureSimulation(raw).identity = { ...raw.simulation?.identity, ...identity };\n}\n\nfunction setRelay(raw: MutablePajaRawOptions, relay: NonNullable<PajaSimulationRawOptions['relay']>): void {\n  ensureSimulation(raw).relay = { ...raw.simulation?.relay, ...relay };\n}\n\nfunction setUpload(raw: MutablePajaRawOptions, upload: NonNullable<PajaSimulationRawOptions['upload']>): void {\n  ensureSimulation(raw).upload = { ...raw.simulation?.upload, ...upload };\n}\n\nfunction setNotifications(\n  raw: MutablePajaRawOptions,\n  notifications: NonNullable<PajaSimulationRawOptions['notifications']>,\n): void {\n  ensureSimulation(raw).notifications = { ...raw.simulation?.notifications, ...notifications };\n}\n\nfunction setConfigValue(\n  raw: MutablePajaRawOptions,\n  entry: { key: string; value: JsonValue },\n): void {\n  ensureSimulation(raw).config = {\n    ...raw.simulation?.config,\n    values: {\n      ...raw.simulation?.config?.values,\n      [entry.key]: entry.value,\n    },\n  };\n}\n\nfunction setCapability(\n  raw: MutablePajaRawOptions,\n  entry: { domain: PajaCapabilityDomain; enabled: boolean },\n): void {\n  ensureSimulation(raw).capabilities = {\n    ...raw.simulation?.capabilities,\n    domains: {\n      ...raw.simulation?.capabilities?.domains,\n      [entry.domain]: entry.enabled,\n    },\n  };\n}\n\nfunction ensureSimulation(raw: MutablePajaRawOptions): MutablePajaSimulationRawOptions {\n  raw.simulation ??= {};\n  return raw.simulation as MutablePajaSimulationRawOptions;\n}\n\nasync function resolveManagedTargetUrl(\n  configuredUrl: string,\n  child: ManagedChildProcess,\n  options: {\n    readonly timeoutMs: number;\n    readonly discoveryGraceMs?: number;\n    readonly waitForTargetUrl: typeof waitForTargetUrl;\n  },\n): Promise<string> {\n  let configuredError: unknown;\n  const configuredReady = options.waitForTargetUrl(configuredUrl, { timeoutMs: options.timeoutMs })\n    .then(() => configuredUrl)\n    .catch((error) => {\n      configuredError = error;\n      return undefined;\n    });\n  const first = await Promise.race([\n    configuredReady.then((url) => url ? { kind: 'configured' as const, url } : undefined),\n    child.detectedTargetUrl.then((url) => ({ kind: 'detected' as const, url })),\n  ]);\n\n  if (first?.kind === 'detected') {\n    await options.waitForTargetUrl(first.url, { timeoutMs: options.timeoutMs });\n    return first.url;\n  }\n\n  const graceMs = options.discoveryGraceMs ?? Math.min(1000, options.timeoutMs);\n  const detected = await resolveWithin(child.detectedTargetUrl, graceMs);\n  if (!detected) {\n    if (first?.url) {\n      return first.url;\n    }\n    throw configuredError instanceof Error ? configuredError : new Error(String(configuredError ?? 'Target URL was not ready.'));\n  }\n\n  await options.waitForTargetUrl(detected, { timeoutMs: options.timeoutMs });\n  return detected;\n}\n\nfunction resolveWithin<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined> {\n  return new Promise((resolve) => {\n    let settled = false;\n    const timeout = setTimeout(() => {\n      if (settled) return;\n      settled = true;\n      resolve(undefined);\n    }, Math.max(0, timeoutMs));\n\n    promise.then((value) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      resolve(value);\n    }, () => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      resolve(undefined);\n    });\n  });\n}\n\nfunction startManagedCommand(command: PajaCommand, io: CliIo): ManagedChildProcess {\n  const detector = createManagedTargetUrlDetector();\n  const child = spawnManagedCommand(command);\n  forwardManagedOutput(child, detector, io);\n  return {\n    kill: () => child.kill(),\n    detectedTargetUrl: detector.detectedTargetUrl,\n  };\n}\n\nfunction spawnManagedCommand(command: PajaCommand): ChildProcess {\n  if (command.mode === 'shell') {\n    return spawn(command.command, { shell: true, stdio: ['inherit', 'pipe', 'pipe'] as const });\n  }\n\n  const [executable, ...args] = command.argv;\n  if (!executable) {\n    throw new PajaOptionsError('Argv command mode requires an executable.');\n  }\n  return spawn(executable, args, { stdio: ['inherit', 'pipe', 'pipe'] as const });\n}\n\nfunction forwardManagedOutput(\n  child: ChildProcess,\n  detector: ManagedTargetUrlDetector,\n  io: CliIo,\n): void {\n  child.stdout?.on('data', (chunk: string | Uint8Array) => {\n    const text = String(chunk);\n    detector.observe(text);\n    io.stdout.write(text);\n  });\n  child.stderr?.on('data', (chunk: string | Uint8Array) => {\n    const text = String(chunk);\n    detector.observe(text);\n    io.stderr.write(text);\n  });\n}\n\nfunction createManagedTargetUrlDetector(): ManagedTargetUrlDetector {\n  let resolveDetected: (url: string) => void = () => {\n    // Promise executor replaces this before any child-process output can arrive.\n  };\n  let detected: string | undefined;\n  const detectedTargetUrl = new Promise<string>((resolve) => {\n    resolveDetected = resolve;\n  });\n\n  return {\n    detectedTargetUrl,\n    observe(chunk) {\n      if (detected) return;\n      const text = stripAnsi(chunk);\n      for (const match of text.matchAll(LOCAL_HTTP_URL_PATTERN)) {\n        const rawUrl = match[0];\n        let url: URL;\n        try {\n          url = new URL(rawUrl);\n        } catch {\n          continue;\n        }\n        detected = url.href;\n        resolveDetected(detected);\n        return;\n      }\n    },\n  };\n}\n\nfunction stripAnsi(value: string): string {\n  return value.replace(ANSI_PATTERN, '');\n}\n\ntype MutablePajaRawOptions = {\n  -readonly [K in keyof PajaRawOptions]: PajaRawOptions[K];\n};\n\ntype MutablePajaSimulationRawOptions = {\n  -readonly [K in keyof PajaSimulationRawOptions]: PajaSimulationRawOptions[K];\n};\n\nconst defaultIo: CliIo = {\n  stdout: { write: (chunk) => process.stdout.write(chunk) },\n  stderr: { write: (chunk) => process.stderr.write(chunk) },\n};\n\nif (isDirectPajaCli()) {\n  void runPajaCli().then((code) => {\n    process.exitCode = code;\n  });\n}\n\nexport function isDirectPajaCli(entryPath = process.argv[1]): boolean {\n  if (!entryPath) return false;\n  return entryPath.endsWith('/cli.js') || entryPath.endsWith('/paja');\n}\n\ndeclare const process: {\n  argv: string[];\n  exitCode?: number;\n  stdout: { write(chunk: string): void };\n  stderr: { write(chunk: string): void };\n};\n\nexport interface ManagedChildProcess {\n  kill(): void;\n  readonly detectedTargetUrl: Promise<string>;\n}\n\ninterface ManagedTargetUrlDetector {\n  readonly detectedTargetUrl: Promise<string>;\n  observe(chunk: string): void;\n}\n\nconst LOCAL_HTTP_URL_PATTERN = /https?:\\/\\/(?:localhost|127(?:\\.\\d{1,3}){3}|\\[::1\\])(?::\\d+)?(?:\\/[^\\s'\"<>)\\]]*)?/g;\nconst ANSI_PATTERN = /\\u001b\\[[0-?]*[ -/]*[@-~]/g;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entrypoint for running the Paja local authoring runtime.\n *\n * @module\n */\nimport { spawn, type ChildProcess } from 'node:child_process';\nimport {\n  createPajaHostConfig,\n  formatPajaUrl,\n  normalizePajaOptions,\n  waitForTargetUrl,\n  type PajaCommand,\n  type PajaRawOptions,\n  PajaOptionsError,\n} from './index.js';\nimport { resolvePajaRawOptions } from './config-file.js';\nimport { startPajaServer } from './server.js';\nimport {\n  PAJA_SIMULATION_DOMAINS,\n  summarizePajaSimulation,\n  type PajaCapabilityDomain,\n  type PajaSimulationRawOptions,\n  type JsonValue,\n} from './simulation.js';\n\n/**\n * Minimal output streams used by the CLI runner.\n *\n * @remarks\n * Tests and embedders can pass custom streams to capture output without\n * patching global `process.stdout` or `process.stderr`.\n */\nexport interface CliIo {\n  readonly stdout: { write(chunk: string): void };\n  readonly stderr: { write(chunk: string): void };\n}\n\n/**\n * Parsed CLI arguments before full option normalization.\n */\nexport interface CliParseResult {\n  readonly options?: PajaRawOptions;\n  readonly help: boolean;\n}\n\n/**\n * Execution controls for embedding the CLI runner in tests or wrappers.\n */\nexport interface RunPajaCliOptions {\n  readonly serve?: boolean;\n  readonly startServer?: typeof startPajaServer;\n  readonly startCommand?: (command: PajaCommand, io: CliIo) => ManagedChildProcess;\n  readonly waitForTargetUrl?: typeof waitForTargetUrl;\n  readonly targetDiscoveryGraceMs?: number;\n}\n\n/**\n * Parse raw `kehto paja` arguments into raw runtime options.\n *\n * @param args - Argument vector without the node executable or script path.\n * @returns Parsed raw options, or a help flag when `--help` is present.\n */\nexport function parsePajaArgs(args: readonly string[]): CliParseResult {\n  const raw: MutablePajaRawOptions = {};\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg === '--') {\n      const argv = args.slice(index + 1);\n      raw.command = { mode: 'argv', argv };\n      break;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      return { help: true };\n    }\n\n    if (applyCoreOption(arg, args, index, raw) || applySimulationOption(arg, args, index, raw)) {\n      index += 1;\n      continue;\n    }\n\n    throw new PajaOptionsError(`Unknown option \"${arg}\". Run kehto paja --help for usage.`);\n  }\n\n  return { help: false, options: raw };\n}\n\n/**\n * Run the Paja CLI command.\n *\n * @param args - Argument vector without the node executable or script path.\n * @param io - Output streams used by the command.\n * @param runOptions - Test/embedding controls for server and process spawning.\n * @returns Process exit code.\n */\nexport async function runPajaCli(\n  args: readonly string[] = process.argv.slice(2),\n  io: CliIo = defaultIo,\n  runOptions: RunPajaCliOptions = {},\n): Promise<number> {\n  try {\n    const parsed = parsePajaArgs(args);\n    if (parsed.help) {\n      io.stdout.write(`${HELP_TEXT}\\n`);\n      return 0;\n    }\n\n    const rawOptions = resolvePajaRawOptions(parsed.options ?? {});\n    const options = normalizePajaOptions(rawOptions);\n    const hostConfig = createPajaHostConfig(options);\n    const shouldServe = runOptions.serve ?? true;\n    const startServer = runOptions.startServer ?? startPajaServer;\n    const startCommand = runOptions.startCommand ?? startManagedCommand;\n    const waitForTarget = runOptions.waitForTargetUrl ?? waitForTargetUrl;\n    let child: ManagedChildProcess | undefined;\n    let server: Awaited<ReturnType<typeof startPajaServer>> | undefined;\n    if (shouldServe) {\n      try {\n        server = await startServer({ options: rawOptions });\n        writeRuntimeSummary(io, server.url, hostConfig, options);\n\n        if (options.command) {\n          child = startCommand(options.command, io);\n          const targetUrl = await resolveManagedTargetUrl(options.targetUrl, child, {\n            timeoutMs: options.readyTimeoutMs,\n            discoveryGraceMs: runOptions.targetDiscoveryGraceMs,\n            waitForTargetUrl: waitForTarget,\n          });\n          if (targetUrl !== options.targetUrl) {\n            server.updateTargetUrl(targetUrl);\n            io.stdout.write(`Target URL updated: ${targetUrl}\\n`);\n          }\n        }\n      } catch (error) {\n        child?.kill();\n        await server?.close().catch(() => undefined);\n        throw error;\n      }\n    }\n    const runtimeUrl = server?.url ?? formatPajaUrl(options);\n\n    if (!shouldServe) {\n      writeRuntimeSummary(io, runtimeUrl, hostConfig, options);\n    }\n\n    return 0;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    io.stderr.write(`kehto paja: ${message}\\n`);\n    return 1;\n  }\n}\n\nfunction writeRuntimeSummary(\n  io: CliIo,\n  runtimeUrl: string,\n  hostConfig: ReturnType<typeof createPajaHostConfig>,\n  options: ReturnType<typeof normalizePajaOptions>,\n): void {\n    io.stdout.write(`Kehto Paja\\n`);\n    io.stdout.write(`Runtime URL: ${runtimeUrl}\\n`);\n    io.stdout.write(`Target URL: ${hostConfig.target.url}\\n`);\n    io.stdout.write(`Mode: ${options.mode}\\n`);\n    io.stdout.write(`HMR: ${hostConfig.target.hmrStrategy}\\n`);\n    io.stdout.write(`Simulation: ${summarizePajaSimulation(options.simulation)}\\n`);\n\n    if (options.command) {\n      io.stdout.write(`Command: ${formatCommand(options.command)}\\n`);\n    }\n}\n\nconst HELP_TEXT = `Usage:\n  kehto paja --target-url <url> [options]\n  kehto paja --target-url <url> [options] -- <command...>\n\nOptions:\n  --target-url, -u <url>      App dev-server URL to load in the runtime iframe.\n  --command, -c <command>     Shell command to start before waiting for target URL.\n  -- <command...>             Argv command form; preserves arbitrary framework commands.\n  --host <host>               Runtime host. Default: 127.0.0.1.\n  --port <port>               Runtime port. Default: 5197.\n  --ready-timeout <ms>        Target readiness timeout. Default: 30000.\n  --config <path>             JSON config file using the same option schema.\n  --identity-mode <mode>      anonymous or fixed.\n  --identity-pubkey <hex>     Required when identity mode is fixed.\n  --relay-mode <mode>         live, memory, or disabled.\n  --relay-url <url>           Add a relay URL for live or memory relay backends.\n  --storage-mode <mode>       local, memory, or disabled.\n  --cache-mode <mode>         memory or disabled.\n  --upload-mode <mode>        memory, blossom, or disabled.\n  --upload-rail <name>        Upload rail name for memory uploads.\n  --upload-server <url>       Add a shell-owned Blossom server (repeatable).\n  --media <state>             enabled or disabled.\n  --notifications <state>     enabled or disabled.\n  --notify-grant <bool>       true or false default notification grant.\n  --theme <mode>              dark or light.\n  --config-value <key=json>   Add a JSON config value.\n  --capability <domain:on|off> Toggle an advertised capability domain.\n  --acl-mode <mode>           allow or deny.\n  --firewall-mode <mode>      allow, deny, or observe.\n  --help, -h                  Show this help.`;\n\nfunction readValue(args: readonly string[], index: number, option: string): string {\n  const value = args[index + 1];\n  if (!value || value.startsWith('--')) {\n    throw new PajaOptionsError(`${option} requires a value.`);\n  }\n  return value;\n}\n\nfunction applyCoreOption(\n  arg: string,\n  args: readonly string[],\n  index: number,\n  raw: MutablePajaRawOptions,\n): boolean {\n  switch (arg) {\n    case '--target-url':\n    case '-u':\n      raw.targetUrl = readValue(args, index, arg);\n      return true;\n    case '--command':\n    case '-c':\n      raw.command = { mode: 'shell', command: readValue(args, index, arg) };\n      return true;\n    case '--host':\n      raw.host = readValue(args, index, arg);\n      return true;\n    case '--port':\n      raw.port = readValue(args, index, arg);\n      return true;\n    case '--ready-timeout':\n      raw.readyTimeoutMs = readValue(args, index, arg);\n      return true;\n    case '--config':\n      raw.configPath = readValue(args, index, arg);\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction applySimulationOption(\n  arg: string,\n  args: readonly string[],\n  index: number,\n  raw: MutablePajaRawOptions,\n): boolean {\n  switch (arg) {\n    case '--identity-mode':\n      setIdentity(raw, { mode: readEnum(args, index, arg, ['anonymous', 'fixed']) });\n      return true;\n    case '--identity-pubkey':\n      setIdentity(raw, { pubkey: readValue(args, index, arg) });\n      return true;\n    case '--relay-mode':\n      setRelay(raw, { mode: readEnum(args, index, arg, ['live', 'memory', 'disabled']) });\n      return true;\n    case '--relay-url':\n      setRelay(raw, { urls: [...(raw.simulation?.relay?.urls ?? []), readValue(args, index, arg)] });\n      return true;\n    case '--storage-mode':\n      ensureSimulation(raw).storage = { ...raw.simulation?.storage, mode: readEnum(args, index, arg, ['local', 'memory', 'disabled']) };\n      return true;\n    case '--cache-mode':\n      ensureSimulation(raw).cache = { ...raw.simulation?.cache, mode: readEnum(args, index, arg, ['memory', 'disabled']) };\n      return true;\n    case '--upload-mode':\n      setUpload(raw, { mode: readEnum(args, index, arg, ['memory', 'blossom', 'disabled']) });\n      return true;\n    case '--upload-rail':\n      setUpload(raw, { rail: readValue(args, index, arg) });\n      return true;\n    case '--upload-server':\n      setUpload(raw, { servers: [...(raw.simulation?.upload?.servers ?? []), readValue(args, index, arg)] });\n      return true;\n    case '--media':\n      ensureSimulation(raw).media = { ...raw.simulation?.media, enabled: readEnabled(args, index, arg) };\n      return true;\n    case '--notifications':\n      setNotifications(raw, { enabled: readEnabled(args, index, arg) });\n      return true;\n    case '--notify-grant':\n      setNotifications(raw, { grant: readBoolean(args, index, arg) });\n      return true;\n    case '--theme':\n      ensureSimulation(raw).theme = { ...raw.simulation?.theme, mode: readEnum(args, index, arg, ['dark', 'light']) };\n      return true;\n    case '--config-value':\n      setConfigValue(raw, readConfigValue(args, index, arg));\n      return true;\n    case '--capability':\n      setCapability(raw, readCapability(args, index, arg));\n      return true;\n    case '--acl-mode':\n      ensureSimulation(raw).acl = { ...raw.simulation?.acl, mode: readEnum(args, index, arg, ['allow', 'deny']) };\n      return true;\n    case '--firewall-mode':\n      ensureSimulation(raw).firewall = { ...raw.simulation?.firewall, mode: readEnum(args, index, arg, ['allow', 'deny', 'observe']) };\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction formatCommand(command: PajaCommand): string {\n  return command.mode === 'argv' ? command.argv.join(' ') : command.command;\n}\n\nfunction readEnum<const T extends readonly string[]>(\n  args: readonly string[],\n  index: number,\n  option: string,\n  allowed: T,\n): T[number] {\n  const value = readValue(args, index, option);\n  if (!allowed.includes(value)) {\n    throw new PajaOptionsError(`${option} must be one of: ${allowed.join(', ')}.`);\n  }\n  return value;\n}\n\nfunction readEnabled(args: readonly string[], index: number, option: string): boolean {\n  const value = readValue(args, index, option);\n  if (value === 'enabled') return true;\n  if (value === 'disabled') return false;\n  throw new PajaOptionsError(`${option} must be \"enabled\" or \"disabled\".`);\n}\n\nfunction readBoolean(args: readonly string[], index: number, option: string): boolean {\n  const value = readValue(args, index, option);\n  if (value === 'true') return true;\n  if (value === 'false') return false;\n  throw new PajaOptionsError(`${option} must be \"true\" or \"false\".`);\n}\n\nfunction readConfigValue(\n  args: readonly string[],\n  index: number,\n  option: string,\n): { key: string; value: JsonValue } {\n  const raw = readValue(args, index, option);\n  const separator = raw.indexOf('=');\n  if (separator <= 0) {\n    throw new PajaOptionsError(`${option} expects key=json.`);\n  }\n  const key = raw.slice(0, separator).trim();\n  if (!key) {\n    throw new PajaOptionsError(`${option} expects a non-empty key.`);\n  }\n  try {\n    return { key, value: JSON.parse(raw.slice(separator + 1)) as JsonValue };\n  } catch {\n    throw new PajaOptionsError(`${option} value for \"${key}\" must be valid JSON.`);\n  }\n}\n\nfunction readCapability(\n  args: readonly string[],\n  index: number,\n  option: string,\n): { domain: PajaCapabilityDomain; enabled: boolean } {\n  const raw = readValue(args, index, option);\n  const [domainRaw, stateRaw] = raw.split(':') as [string | undefined, string | undefined];\n  if (!domainRaw || (stateRaw !== 'on' && stateRaw !== 'off')) {\n    throw new PajaOptionsError(`${option} expects domain:on or domain:off.`);\n  }\n  if (!PAJA_SIMULATION_DOMAINS.includes(domainRaw as PajaCapabilityDomain)) {\n    throw new PajaOptionsError(`${option} unknown domain \"${domainRaw}\".`);\n  }\n  return {\n    domain: domainRaw as PajaCapabilityDomain,\n    enabled: stateRaw === 'on',\n  };\n}\n\nfunction setIdentity(raw: MutablePajaRawOptions, identity: NonNullable<PajaSimulationRawOptions['identity']>): void {\n  ensureSimulation(raw).identity = { ...raw.simulation?.identity, ...identity };\n}\n\nfunction setRelay(raw: MutablePajaRawOptions, relay: NonNullable<PajaSimulationRawOptions['relay']>): void {\n  ensureSimulation(raw).relay = { ...raw.simulation?.relay, ...relay };\n}\n\nfunction setUpload(raw: MutablePajaRawOptions, upload: NonNullable<PajaSimulationRawOptions['upload']>): void {\n  ensureSimulation(raw).upload = { ...raw.simulation?.upload, ...upload };\n}\n\nfunction setNotifications(\n  raw: MutablePajaRawOptions,\n  notifications: NonNullable<PajaSimulationRawOptions['notifications']>,\n): void {\n  ensureSimulation(raw).notifications = { ...raw.simulation?.notifications, ...notifications };\n}\n\nfunction setConfigValue(\n  raw: MutablePajaRawOptions,\n  entry: { key: string; value: JsonValue },\n): void {\n  ensureSimulation(raw).config = {\n    ...raw.simulation?.config,\n    values: {\n      ...raw.simulation?.config?.values,\n      [entry.key]: entry.value,\n    },\n  };\n}\n\nfunction setCapability(\n  raw: MutablePajaRawOptions,\n  entry: { domain: PajaCapabilityDomain; enabled: boolean },\n): void {\n  ensureSimulation(raw).capabilities = {\n    ...raw.simulation?.capabilities,\n    domains: {\n      ...raw.simulation?.capabilities?.domains,\n      [entry.domain]: entry.enabled,\n    },\n  };\n}\n\nfunction ensureSimulation(raw: MutablePajaRawOptions): MutablePajaSimulationRawOptions {\n  raw.simulation ??= {};\n  return raw.simulation as MutablePajaSimulationRawOptions;\n}\n\nasync function resolveManagedTargetUrl(\n  configuredUrl: string,\n  child: ManagedChildProcess,\n  options: {\n    readonly timeoutMs: number;\n    readonly discoveryGraceMs?: number;\n    readonly waitForTargetUrl: typeof waitForTargetUrl;\n  },\n): Promise<string> {\n  let configuredError: unknown;\n  const configuredReady = options.waitForTargetUrl(configuredUrl, { timeoutMs: options.timeoutMs })\n    .then(() => configuredUrl)\n    .catch((error) => {\n      configuredError = error;\n      return undefined;\n    });\n  const first = await Promise.race([\n    configuredReady.then((url) => url ? { kind: 'configured' as const, url } : undefined),\n    child.detectedTargetUrl.then((url) => ({ kind: 'detected' as const, url })),\n  ]);\n\n  if (first?.kind === 'detected') {\n    await options.waitForTargetUrl(first.url, { timeoutMs: options.timeoutMs });\n    return first.url;\n  }\n\n  const graceMs = options.discoveryGraceMs ?? Math.min(1000, options.timeoutMs);\n  const detected = await resolveWithin(child.detectedTargetUrl, graceMs);\n  if (!detected) {\n    if (first?.url) {\n      return first.url;\n    }\n    throw configuredError instanceof Error ? configuredError : new Error(String(configuredError ?? 'Target URL was not ready.'));\n  }\n\n  await options.waitForTargetUrl(detected, { timeoutMs: options.timeoutMs });\n  return detected;\n}\n\nfunction resolveWithin<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined> {\n  return new Promise((resolve) => {\n    let settled = false;\n    const timeout = setTimeout(() => {\n      if (settled) return;\n      settled = true;\n      resolve(undefined);\n    }, Math.max(0, timeoutMs));\n\n    promise.then((value) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      resolve(value);\n    }, () => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      resolve(undefined);\n    });\n  });\n}\n\nfunction startManagedCommand(command: PajaCommand, io: CliIo): ManagedChildProcess {\n  const detector = createManagedTargetUrlDetector();\n  const child = spawnManagedCommand(command);\n  forwardManagedOutput(child, detector, io);\n  return {\n    kill: () => child.kill(),\n    detectedTargetUrl: detector.detectedTargetUrl,\n  };\n}\n\nfunction spawnManagedCommand(command: PajaCommand): ChildProcess {\n  if (command.mode === 'shell') {\n    return spawn(command.command, { shell: true, stdio: ['inherit', 'pipe', 'pipe'] as const });\n  }\n\n  const [executable, ...args] = command.argv;\n  if (!executable) {\n    throw new PajaOptionsError('Argv command mode requires an executable.');\n  }\n  return spawn(executable, args, { stdio: ['inherit', 'pipe', 'pipe'] as const });\n}\n\nfunction forwardManagedOutput(\n  child: ChildProcess,\n  detector: ManagedTargetUrlDetector,\n  io: CliIo,\n): void {\n  child.stdout?.on('data', (chunk: string | Uint8Array) => {\n    const text = String(chunk);\n    detector.observe(text);\n    io.stdout.write(text);\n  });\n  child.stderr?.on('data', (chunk: string | Uint8Array) => {\n    const text = String(chunk);\n    detector.observe(text);\n    io.stderr.write(text);\n  });\n}\n\nfunction createManagedTargetUrlDetector(): ManagedTargetUrlDetector {\n  let resolveDetected: (url: string) => void = () => {\n    // Promise executor replaces this before any child-process output can arrive.\n  };\n  let detected: string | undefined;\n  const detectedTargetUrl = new Promise<string>((resolve) => {\n    resolveDetected = resolve;\n  });\n\n  return {\n    detectedTargetUrl,\n    observe(chunk) {\n      if (detected) return;\n      const text = stripAnsi(chunk);\n      for (const match of text.matchAll(LOCAL_HTTP_URL_PATTERN)) {\n        const rawUrl = match[0];\n        let url: URL;\n        try {\n          url = new URL(rawUrl);\n        } catch {\n          continue;\n        }\n        detected = url.href;\n        resolveDetected(detected);\n        return;\n      }\n    },\n  };\n}\n\nfunction stripAnsi(value: string): string {\n  return value.replace(ANSI_PATTERN, '');\n}\n\ntype MutablePajaRawOptions = {\n  -readonly [K in keyof PajaRawOptions]: PajaRawOptions[K];\n};\n\ntype MutablePajaSimulationRawOptions = {\n  -readonly [K in keyof PajaSimulationRawOptions]: PajaSimulationRawOptions[K];\n};\n\nconst defaultIo: CliIo = {\n  stdout: { write: (chunk) => process.stdout.write(chunk) },\n  stderr: { write: (chunk) => process.stderr.write(chunk) },\n};\n\nif (isDirectPajaCli()) {\n  void runPajaCli().then((code) => {\n    process.exitCode = code;\n  });\n}\n\n/**\n * Detect whether this module is running as the direct Paja CLI entrypoint.\n *\n * @param entryPath - Process entry path to inspect.\n * @returns `true` when the entry path looks like Paja's built CLI.\n */\nexport function isDirectPajaCli(entryPath = process.argv[1]): boolean {\n  if (!entryPath) return false;\n  return entryPath.endsWith('/cli.js') || entryPath.endsWith('/paja');\n}\n\ndeclare const process: {\n  argv: string[];\n  exitCode?: number;\n  stdout: { write(chunk: string): void };\n  stderr: { write(chunk: string): void };\n};\n\n/** Managed child process handle. */\nexport interface ManagedChildProcess {\n  /** Stop the managed target process. */\n  kill(): void;\n  /** First local target URL detected from process output. */\n  readonly detectedTargetUrl: Promise<string>;\n}\n\ninterface ManagedTargetUrlDetector {\n  readonly detectedTargetUrl: Promise<string>;\n  observe(chunk: string): void;\n}\n\nconst LOCAL_HTTP_URL_PATTERN = /https?:\\/\\/(?:localhost|127(?:\\.\\d{1,3}){3}|\\[::1\\])(?::\\d+)?(?:\\/[^\\s'\"<>)\\]]*)?/g;\nconst ANSI_PATTERN = /\\u001b\\[[0-?]*[ -/]*[@-~]/g;\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,17 +1,46 @@
-import { P as PajaRawOptions, b as PajaHostConfig } from './server-qAXYczds.js';
-export { D as DEFAULT_PAJA_AGGREGATE_HASH, c as DEFAULT_PAJA_DTAG, d as DEFAULT_PAJA_HOST, e as DEFAULT_PAJA_PORT, f as DEFAULT_PAJA_RUNTIME_WAIT_MS, g as DEFAULT_PAJA_WINDOW_ID, h as DEFAULT_READY_TIMEOUT_MS, J as JsonPrimitive, i as JsonRecord, j as JsonValue, k as PAJA_SIMULATION_DOMAINS, l as PajaCapabilityDomain, a as PajaCommand, m as PajaHmrStrategy, n as PajaOptions, o as PajaOptionsError, p as PajaPointerRuntimeConfig, q as PajaServer, r as PajaServerOptions, t as PajaSimulation, u as PajaSimulationError, v as PajaSimulationRawOptions, x as PajaTargetMode, R as ReadinessError, y as ReadinessFetch, W as WaitForTargetUrlOptions, z as createPajaHostConfig, A as createPajaRuntimeHostConfig, B as formatPajaUrl, C as normalizePajaOptions, E as normalizePajaSimulation, s as startPajaServer, F as summarizePajaSimulation, w as waitForTargetUrl } from './server-qAXYczds.js';
+import { P as PajaRawOptions, b as PajaHostConfig } from './server-efRTBcMR.js';
+export { D as DEFAULT_PAJA_AGGREGATE_HASH, c as DEFAULT_PAJA_DTAG, d as DEFAULT_PAJA_HOST, e as DEFAULT_PAJA_PORT, f as DEFAULT_PAJA_RUNTIME_WAIT_MS, g as DEFAULT_PAJA_WINDOW_ID, h as DEFAULT_READY_TIMEOUT_MS, J as JsonPrimitive, i as JsonRecord, j as JsonValue, k as PAJA_SIMULATION_DOMAINS, l as PajaCapabilityDomain, a as PajaCommand, m as PajaHmrStrategy, n as PajaOptions, o as PajaOptionsError, p as PajaPointerRuntimeConfig, q as PajaServer, r as PajaServerOptions, t as PajaSimulation, u as PajaSimulationError, v as PajaSimulationRawOptions, x as PajaTargetMode, R as ReadinessError, y as ReadinessFetch, W as WaitForTargetUrlOptions, z as createPajaHostConfig, A as createPajaRuntimeHostConfig, B as formatPajaUrl, C as normalizePajaOptions, E as normalizePajaSimulation, s as startPajaServer, F as summarizePajaSimulation, w as waitForTargetUrl } from './server-efRTBcMR.js';
 import { NostrEvent } from 'nostr-tools';
 import { Filter } from 'nostr-tools/filter';
 import { ResolvedNapplet } from '@kehto/nip/5d';
 import { ShellCapabilities } from '@kehto/shell';
 
+/**
+ * Load a JSON Paja config file from disk.
+ *
+ * @param configPath - Path to a JSON config file.
+ * @returns Raw options parsed from the config file.
+ */
 declare function loadPajaConfigFile(configPath: string): PajaRawOptions;
+/**
+ * Resolve raw options by merging an optional config file with explicit values.
+ *
+ * @param raw - CLI/config options, optionally including `configPath`.
+ * @returns Raw options with config-file defaults applied.
+ */
 declare function resolvePajaRawOptions(raw: PajaRawOptions): PajaRawOptions;
+/**
+ * Merge two raw Paja option objects, with override values taking precedence.
+ *
+ * @param base - Base options, usually from a config file.
+ * @param override - Explicit options, usually from CLI args.
+ * @returns Merged raw options.
+ */
 declare function mergePajaRawOptions(base: PajaRawOptions, override: PajaRawOptions): PajaRawOptions;
 
+/**
+ * Render the browser host page for a Paja runtime config.
+ *
+ * @param config - Serializable host-page config.
+ * @returns Complete HTML document served by Paja.
+ */
 declare function renderPajaHtml(config: PajaHostConfig): string;
 
+/** Named/addressable NIP-5D napplet manifest kind (`35129`). */
 declare const PAJA_NAPPLET_MANIFEST_KIND = 35129;
+/** All NIP-5D napplet manifest kinds accepted by Paja pointers (`5129`, `15129`, `35129`). */
+declare const PAJA_NAPPLET_MANIFEST_KINDS: readonly number[];
+/** Decoded naddr/nevent pointer accepted by Paja runtime-pointer mode. */
 type PajaDecodedPointer = {
     readonly type: 'naddr';
     readonly value: string;
@@ -27,17 +56,28 @@ type PajaDecodedPointer = {
     readonly kind?: number;
     readonly relays: readonly string[];
 };
+/** Fully resolved pointer plus verified napplet artifact bytes. */
 interface PajaResolvedPointer {
+    /** Decoded pointer input. */
     readonly pointer: PajaDecodedPointer;
+    /** Manifest event resolved from relays. */
     readonly event: NostrEvent;
+    /** Relay URLs queried for the pointer. */
     readonly relays: readonly string[];
+    /** Blossom server hints used for blob fetches. */
     readonly blossomServers: readonly string[];
+    /** Resolved manifest `d` tag. */
     readonly dTag: string;
+    /** Verified NIP-5A aggregate hash. */
     readonly aggregateHash: string;
+    /** Verified target `/index.html` content. */
     readonly indexHtml: string;
+    /** Parsed NIP-5D manifest. */
     readonly manifest: ResolvedNapplet['manifest'];
 }
+/** Relay-pool contract for runtime-pointer resolution. */
 interface PajaPointerRelayPool {
+    /** Query relays synchronously for matching manifest events. */
     querySync(relays: string[], filter: Filter, params?: {
         readonly maxWait?: number;
         readonly label?: string;
@@ -46,25 +86,69 @@ interface PajaPointerRelayPool {
     close?(relays: string[]): void;
     destroy?(): void;
 }
+/** Options for resolving a Paja runtime pointer. */
 interface ResolvePajaPointerOptions {
+    /** Relay pool override; defaults to a `nostr-tools` `SimplePool`. */
     readonly pool?: PajaPointerRelayPool;
+    /** Fetch override used for Blossom blob URLs. */
     readonly fetcher?: (url: string) => Promise<Response>;
+    /** Extra relay hints appended to pointer relays. */
     readonly relays?: readonly string[];
+    /** Extra Blossom server hints appended during artifact fetch. */
     readonly blossomServers?: readonly string[];
+    /** Maximum relay query wait in milliseconds. */
     readonly maxWaitMs?: number;
 }
+/**
+ * Decode a NIP-19 naddr/nevent pointer for Paja runtime-pointer mode.
+ *
+ * @param value - NIP-19 pointer string.
+ * @returns Structured pointer metadata.
+ */
 declare function decodePajaPointer(value: string): PajaDecodedPointer;
+/**
+ * Resolve a Paja runtime pointer into verified napplet HTML and manifest data.
+ *
+ * @param value - NIP-19 naddr or nevent pointer.
+ * @param options - Relay, fetch, and Blossom overrides.
+ * @returns Verified napplet artifact ready for srcdoc injection.
+ */
 declare function resolvePajaPointer(value: string, options?: ResolvePajaPointerOptions): Promise<PajaResolvedPointer>;
+/**
+ * Inject a restrictive connect-src CSP for runtime-pointer srcdoc output.
+ *
+ * @param html - Verified target HTML.
+ * @param origins - Origins the resolved target may connect to.
+ * @returns HTML with a CSP meta tag inserted.
+ */
 declare function injectPajaRuntimeCsp(html: string, origins: readonly string[]): string;
 
-declare const PAJA_UPSTREAM_WEB_DOMAINS: readonly ["ble", "common", "config", "count", "cvm", "dm", "identity", "ifc", "inc", "intent", "keys", "link", "lists", "media", "notify", "outbox", "relay", "resource", "serial", "storage", "theme", "upload", "webrtc"];
+declare const PAJA_LEGACY_COMPATIBILITY_DOMAIN: string;
+/** Domain list mirrored from the upstream web runtime for parity checks. */
+declare const PAJA_UPSTREAM_WEB_DOMAINS: readonly ["ble", "common", "config", "count", "cvm", "dm", "identity", string, "inc", "intent", "keys", "link", "lists", "media", "notify", "outbox", "relay", "resource", "serial", "storage", "theme", "upload", "webrtc"];
+/** Domains required during the initial Paja handshake. */
 declare const PAJA_HANDSHAKE_DOMAINS: readonly ["shell"];
+/** Compatibility aliases for renamed upstream capability domains. */
 declare const PAJA_COMPATIBILITY_ALIASES: {
-    readonly ifc: "inc";
+    readonly [PAJA_LEGACY_COMPATIBILITY_DOMAIN]: "inc";
 };
+/** Domains Paja advertises through its simulated shell capability surface. */
 declare const PAJA_ADVERTISED_DOMAINS: readonly ["relay", "outbox", "identity", "storage", "inc", "theme", "keys", "link", "common", "lists", "serial", "ble", "webrtc", "media", "notify", "config", "resource", "cvm", "upload", "intent", "count"];
+/** Service names Paja expects the host runtime to provide. */
 declare const PAJA_REQUIRED_SERVICES: readonly ["config", "cvm", "identity", "intent", "keys", "link", "common", "lists", "serial", "ble", "webrtc", "media", "notifications", "notify", "outbox", "relay", "resource", "theme", "upload", "count"];
+/**
+ * Find advertised Paja domains missing from a shell capability snapshot.
+ *
+ * @param capabilities - Shell capability snapshot to inspect.
+ * @returns Advertised domains not present in the snapshot.
+ */
 declare function getMissingAdvertisedDomains(capabilities: ShellCapabilities): string[];
+/**
+ * Find required service names missing from a runtime service list.
+ *
+ * @param services - Runtime service names to inspect.
+ * @returns Required service names that are absent.
+ */
 declare function getMissingServices(services: readonly string[]): string[];
 
-export { PAJA_ADVERTISED_DOMAINS, PAJA_COMPATIBILITY_ALIASES, PAJA_HANDSHAKE_DOMAINS, PAJA_NAPPLET_MANIFEST_KIND, PAJA_REQUIRED_SERVICES, PAJA_UPSTREAM_WEB_DOMAINS, type PajaDecodedPointer, PajaHostConfig, type PajaPointerRelayPool, PajaRawOptions, type PajaResolvedPointer, type ResolvePajaPointerOptions, decodePajaPointer, getMissingAdvertisedDomains, getMissingServices, injectPajaRuntimeCsp, loadPajaConfigFile, mergePajaRawOptions, renderPajaHtml, resolvePajaPointer, resolvePajaRawOptions };
+export { PAJA_ADVERTISED_DOMAINS, PAJA_COMPATIBILITY_ALIASES, PAJA_HANDSHAKE_DOMAINS, PAJA_NAPPLET_MANIFEST_KIND, PAJA_NAPPLET_MANIFEST_KINDS, PAJA_REQUIRED_SERVICES, PAJA_UPSTREAM_WEB_DOMAINS, type PajaDecodedPointer, PajaHostConfig, type PajaPointerRelayPool, PajaRawOptions, type PajaResolvedPointer, type ResolvePajaPointerOptions, decodePajaPointer, getMissingAdvertisedDomains, getMissingServices, injectPajaRuntimeCsp, loadPajaConfigFile, mergePajaRawOptions, renderPajaHtml, resolvePajaPointer, resolvePajaRawOptions };

package/dist/index.js

@@ -10,6 +10,7 @@ import {
   PAJA_COMPATIBILITY_ALIASES,
   PAJA_HANDSHAKE_DOMAINS,
   PAJA_NAPPLET_MANIFEST_KIND,
+  PAJA_NAPPLET_MANIFEST_KINDS,
   PAJA_REQUIRED_SERVICES,
   PAJA_SIMULATION_DOMAINS,
   PAJA_UPSTREAM_WEB_DOMAINS,
@@ -33,7 +34,7 @@ import {
   startPajaServer,
   summarizePajaSimulation,
   waitForTargetUrl
-} from "./chunk-5QKVKI4K.js";
+} from "./chunk-NFJCS5PG.js";
 export {
   DEFAULT_PAJA_AGGREGATE_HASH,
   DEFAULT_PAJA_DTAG,
@@ -46,6 +47,7 @@ export {
   PAJA_COMPATIBILITY_ALIASES,
   PAJA_HANDSHAKE_DOMAINS,
   PAJA_NAPPLET_MANIFEST_KIND,
+  PAJA_NAPPLET_MANIFEST_KINDS,
   PAJA_REQUIRED_SERVICES,
   PAJA_SIMULATION_DOMAINS,
   PAJA_UPSTREAM_WEB_DOMAINS,