@kehto/paja 0.6.3 → 0.8.0

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,20 +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;
@@ -30,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;
@@ -49,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_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

@@ -34,7 +34,7 @@ import {
   startPajaServer,
   summarizePajaSimulation,
   waitForTargetUrl
-} from "./chunk-ADMLM2LH.js";
+} from "./chunk-NFJCS5PG.js";
 export {
   DEFAULT_PAJA_AGGREGATE_HASH,
   DEFAULT_PAJA_DTAG,

package/dist/{server-qAXYczds.d.ts → server-efRTBcMR.d.ts}

@@ -1,13 +1,20 @@
+/** JSON primitive accepted in Paja simulation config values. */
 type JsonPrimitive = string | number | boolean | null;
+/** JSON value accepted in Paja simulation config values. */
 type JsonValue = JsonPrimitive | JsonValue[] | {
     readonly [key: string]: JsonValue;
 };
+/** JSON object used for Paja simulation fixtures and config/theme values. */
 type JsonRecord = Record<string, JsonValue>;
+/** Capability domain names Paja can advertise or disable. */
 type PajaCapabilityDomain = 'relay' | 'outbox' | 'storage' | 'identity' | 'keys' | 'config' | 'resource' | 'theme' | 'notify' | 'media' | 'upload' | 'intent' | 'count' | 'link' | 'common' | 'lists' | 'serial' | 'ble' | 'webrtc' | 'cvm' | 'inc';
+/** Raw simulation controls accepted from CLI args or JSON config. */
 interface PajaSimulationRawOptions {
+    /** Per-domain capability overrides. */
     readonly capabilities?: {
         readonly domains?: Partial<Record<PajaCapabilityDomain, boolean>>;
     };
+    /** ACL behavior mode for simulated services. */
     readonly acl?: {
         readonly mode?: 'allow' | 'deny';
     };
@@ -19,7 +26,7 @@ interface PajaSimulationRawOptions {
         readonly pubkey?: string;
     };
     readonly relay?: {
-        readonly mode?: 'memory' | 'disabled';
+        readonly mode?: 'live' | 'memory' | 'disabled';
         readonly urls?: readonly string[];
         readonly fixtures?: readonly JsonRecord[];
     };
@@ -30,8 +37,12 @@ interface PajaSimulationRawOptions {
         readonly mode?: 'memory' | 'disabled';
     };
     readonly upload?: {
-        readonly mode?: 'memory' | 'disabled';
+        readonly mode?: 'memory' | 'blossom' | 'disabled';
         readonly rail?: string;
+        readonly servers?: readonly string[];
+        readonly discoverServers?: boolean;
+        readonly maxBytes?: number;
+        readonly mimeTypes?: readonly string[];
     };
     readonly media?: {
         readonly enabled?: boolean;
@@ -54,7 +65,9 @@ interface PajaSimulationRawOptions {
         readonly enabled?: boolean;
     };
 }
+/** Fully normalized Paja simulation model served to the browser host. */
 interface PajaSimulation {
+    /** Capability domains and disabled-domain summary. */
     readonly capabilities: {
         readonly domains: Record<PajaCapabilityDomain, boolean>;
         readonly disabledDomains: readonly PajaCapabilityDomain[];
@@ -70,7 +83,7 @@ interface PajaSimulation {
         readonly pubkey: string;
     };
     readonly relay: {
-        readonly mode: 'memory' | 'disabled';
+        readonly mode: 'live' | 'memory' | 'disabled';
         readonly urls: readonly string[];
         readonly fixtures: readonly JsonRecord[];
     };
@@ -81,8 +94,12 @@ interface PajaSimulation {
         readonly mode: 'memory' | 'disabled';
     };
     readonly upload: {
-        readonly mode: 'memory' | 'disabled';
-        readonly rail: string;
+        readonly mode: 'memory' | 'blossom' | 'disabled';
+        readonly rail?: string;
+        readonly servers: readonly string[];
+        readonly discoverServers: boolean;
+        readonly maxBytes?: number;
+        readonly mimeTypes?: readonly string[];
     };
     readonly media: {
         readonly enabled: boolean;
@@ -105,49 +122,95 @@ interface PajaSimulation {
         readonly enabled: boolean;
     };
 }
+/** Thrown when Paja simulation options are internally inconsistent. */
 declare class PajaSimulationError extends Error {
     constructor(message: string);
 }
+/** Capability domains exposed by Paja simulation controls. */
 declare const PAJA_SIMULATION_DOMAINS: readonly PajaCapabilityDomain[];
+/**
+ * Normalize raw simulation options into a complete deterministic model.
+ *
+ * @param raw - Partial simulation options from CLI args or config.
+ * @returns Complete simulation model.
+ */
 declare function normalizePajaSimulation(raw: PajaSimulationRawOptions | undefined): PajaSimulation;
+/**
+ * Format a compact, human-readable simulation summary.
+ *
+ * @param simulation - Normalized simulation model.
+ * @returns One-line summary used by CLI and host-page chrome.
+ */
 declare function summarizePajaSimulation(simulation: PajaSimulation): string;
 
-type PajaCommand = {
+/** Command configuration for a managed Paja target process. */
+type PajaCommand = 
+/** Spawn an executable with argv preserved exactly after `--`. */
+{
     readonly mode: 'argv';
     readonly argv: readonly string[];
-} | {
+}
+/** Run a shell command string. */
+ | {
     readonly mode: 'shell';
     readonly command: string;
 };
+/** Raw, unnormalized options accepted from CLI arguments or config files. */
 interface PajaRawOptions {
+    /** App dev-server URL that Paja should load. */
     readonly targetUrl?: string;
+    /** Optional managed command to start before serving Paja. */
     readonly command?: PajaCommand;
+    /** Hostname or IP address for the Paja HTTP server. */
     readonly host?: string;
+    /** Runtime HTTP port. */
     readonly port?: number | string;
+    /** Target readiness timeout in milliseconds. */
     readonly readyTimeoutMs?: number | string;
+    /** Optional JSON config file path. */
     readonly configPath?: string;
+    /** Simulation controls for injected shell domains. */
     readonly simulation?: PajaSimulationRawOptions;
 }
+/** Paja target loading mode. */
 type PajaTargetMode = 'iframe-url' | 'runtime-pointer';
+/** Hot-module-reload strategy for the hosted target. */
 type PajaHmrStrategy = 'iframe-target-url' | 'none';
+/** Runtime-pointer resolution config embedded into the Paja host page. */
 interface PajaPointerRuntimeConfig {
+    /** Optional naddr/nevent pointer to resolve at boot. */
     readonly value?: string;
+    /** Relay hints used to resolve the pointer. */
     readonly relays: readonly string[];
+    /** Blossom server hints used for artifact blob fetches. */
     readonly blossomServers: readonly string[];
+    /** Maximum pointer-resolution wait in milliseconds. */
     readonly maxWaitMs: number;
 }
+/** Normalized Paja runtime options. */
 interface PajaOptions {
+    /** Absolute target URL for iframe-url mode. */
     readonly targetUrl: string;
+    /** Optional managed target command. */
     readonly command?: PajaCommand;
+    /** Paja server host. */
     readonly host: string;
+    /** Paja server port. */
     readonly port: number;
+    /** Target readiness timeout in milliseconds. */
     readonly readyTimeoutMs: number;
+    /** Optional config path retained for host diagnostics. */
     readonly configPath?: string;
+    /** Normalized simulation model. */
     readonly simulation: PajaSimulation;
+    /** Whether Paja owns a managed command or attaches to an external target. */
     readonly mode: 'external-target' | 'managed-command';
 }
+/** Serialized host-page config served to the browser runtime. */
 interface PajaHostConfig {
+    /** Config schema version. */
     readonly version: 1;
+    /** Window identity used for the development target. */
     readonly window: {
         readonly id: string;
         readonly dTag: string;
@@ -175,51 +238,113 @@ interface PajaHostConfig {
     };
     readonly simulation: PajaSimulation;
 }
+/** Thrown when raw Paja options cannot be normalized. */
 declare class PajaOptionsError extends Error {
     constructor(message: string);
 }
+/** Default loopback host for the Paja HTTP server. */
 declare const DEFAULT_PAJA_HOST = "127.0.0.1";
+/** Default Paja HTTP port. */
 declare const DEFAULT_PAJA_PORT = 5197;
+/** Default readiness timeout for the target URL. */
 declare const DEFAULT_READY_TIMEOUT_MS = 30000;
+/** Default development window id used in host config. */
 declare const DEFAULT_PAJA_WINDOW_ID = "kehto-paja-window";
+/** Default development `d` tag used for target identity. */
 declare const DEFAULT_PAJA_DTAG = "dev-target";
+/** Default development aggregate hash used for target identity. */
 declare const DEFAULT_PAJA_AGGREGATE_HASH = "paja";
+/** Default pointer resolution wait in runtime-pointer mode. */
 declare const DEFAULT_PAJA_RUNTIME_WAIT_MS = 5000;
+/**
+ * Normalize raw CLI/config options into a validated Paja runtime config.
+ *
+ * @param raw - Raw options from CLI parsing or a config file.
+ * @returns Fully normalized runtime options.
+ */
 declare function normalizePajaOptions(raw: PajaRawOptions): PajaOptions;
+/**
+ * Create browser host-page config for iframe-url mode.
+ *
+ * @param options - Normalized Paja options.
+ * @param now - Clock value used for reload token and timestamps.
+ * @returns Serializable host-page config.
+ */
 declare function createPajaHostConfig(options: PajaOptions, now?: Date): PajaHostConfig;
+/**
+ * Create browser host-page config for runtime-pointer mode.
+ *
+ * @param options - Pointer, relay, and Blossom hints.
+ * @param now - Clock value used for reload token and timestamps.
+ * @returns Serializable host-page config.
+ */
 declare function createPajaRuntimeHostConfig(options?: {
     readonly pointer?: string;
     readonly relays?: readonly string[];
     readonly blossomServers?: readonly string[];
     readonly maxWaitMs?: number;
 }, now?: Date): PajaHostConfig;
+/**
+ * Format the local Paja runtime URL for display and CLI output.
+ *
+ * @param options - Host and port pair.
+ * @returns HTTP URL for the Paja runtime.
+ */
 declare function formatPajaUrl(options: Pick<PajaOptions, 'host' | 'port'>): string;
 
+/** Options for polling a target URL until it is ready. */
 interface WaitForTargetUrlOptions {
+    /** Total wait budget in milliseconds. */
     readonly timeoutMs: number;
+    /** Poll interval in milliseconds. Defaults to 250. */
     readonly intervalMs?: number;
+    /** Fetch implementation override for tests. */
     readonly fetch?: ReadinessFetch;
+    /** Sleep implementation override for tests. */
     readonly sleep?: (ms: number) => Promise<void>;
+    /** Clock override for tests. */
     readonly now?: () => number;
 }
+/** Fetch-like target readiness probe. */
 type ReadinessFetch = (url: string) => Promise<{
     readonly status: number;
 }>;
+/** Thrown when a target URL does not become ready before the timeout. */
 declare class ReadinessError extends Error {
     constructor(message: string);
 }
+/**
+ * Poll a target URL until it returns a non-5xx response or times out.
+ *
+ * @param url - Target URL to poll.
+ * @param options - Timeout and polling controls.
+ */
 declare function waitForTargetUrl(url: string, options: WaitForTargetUrlOptions): Promise<void>;
 
+/** Options for starting the Paja local HTTP server. */
 interface PajaServerOptions {
+    /** Raw options accepted by Paja; config-file references are resolved before serving. */
     readonly options: PajaRawOptions;
+    /** Clock override used for deterministic host config in tests. */
     readonly now?: Date;
 }
+/** Running Paja server handle. */
 interface PajaServer {
+    /** Runtime URL where the Paja host page is served. */
     readonly url: string;
+    /** Current host-page config. */
     readonly hostConfig: PajaHostConfig;
+    /** Update the target iframe URL without restarting the server. */
     updateTargetUrl(targetUrl: string): PajaHostConfig;
+    /** Stop the HTTP server. */
     close(): Promise<void>;
 }
+/**
+ * Start the local Paja development HTTP server.
+ *
+ * @param input - Raw options and optional clock override.
+ * @returns Running server handle.
+ */
 declare function startPajaServer(input: PajaServerOptions): Promise<PajaServer>;
 
 export { createPajaRuntimeHostConfig as A, formatPajaUrl as B, normalizePajaOptions as C, DEFAULT_PAJA_AGGREGATE_HASH as D, normalizePajaSimulation as E, summarizePajaSimulation as F, type JsonPrimitive as J, type PajaRawOptions as P, ReadinessError as R, type WaitForTargetUrlOptions as W, type PajaCommand as a, type PajaHostConfig as b, DEFAULT_PAJA_DTAG as c, DEFAULT_PAJA_HOST as d, DEFAULT_PAJA_PORT as e, DEFAULT_PAJA_RUNTIME_WAIT_MS as f, DEFAULT_PAJA_WINDOW_ID as g, DEFAULT_READY_TIMEOUT_MS as h, type JsonRecord as i, type JsonValue as j, PAJA_SIMULATION_DOMAINS as k, type PajaCapabilityDomain as l, type PajaHmrStrategy as m, type PajaOptions as n, PajaOptionsError as o, type PajaPointerRuntimeConfig as p, type PajaServer as q, type PajaServerOptions as r, startPajaServer as s, type PajaSimulation as t, PajaSimulationError as u, type PajaSimulationRawOptions as v, waitForTargetUrl as w, type PajaTargetMode as x, type ReadinessFetch as y, createPajaHostConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kehto/paja",
-  "version": "0.6.3",
+  "version": "0.8.0",
   "description": "Paja local authoring workshop for hosting napplets in a real Kehto iframe during development",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,22 +25,22 @@
     "access": "public"
   },
   "dependencies": {
-    "@kehto/acl": "^0.15.4",
-    "@kehto/firewall": "^0.3.8",
-    "@kehto/nip": "^0.4.1",
-    "@kehto/runtime": "^0.18.2",
-    "@kehto/services": "^0.16.1",
-    "@kehto/shell": "^0.16.4",
-    "@kehto/wm": "^0.0.1"
+    "@kehto/acl": "^0.15.6",
+    "@kehto/firewall": "^0.3.9",
+    "@kehto/nip": "^0.4.2",
+    "@kehto/runtime": "^0.18.5",
+    "@kehto/services": "^0.16.5",
+    "@kehto/shell": "^0.17.2",
+    "@kehto/wm": "^0.0.2"
   },
   "peerDependencies": {
-    "@napplet/core": ">=0.23.0 <=0.27.x",
-    "@napplet/nap": ">=0.23.0 <=0.27.x",
+    "@napplet/core": ">=0.23.0 <=0.28.x",
+    "@napplet/nap": ">=0.23.0 <=0.28.x",
     "nostr-tools": ">=2.23.3 <=2.x"
   },
   "devDependencies": {
-    "@napplet/core": ">=0.23.0 <=0.27.x",
-    "@napplet/nap": ">=0.23.0 <=0.27.x",
+    "@napplet/core": ">=0.23.0 <=0.28.x",
+    "@napplet/nap": ">=0.23.0 <=0.28.x",
     "nostr-tools": "^2.23.3",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",