experimental-a2 0.6.0 → 0.7.0

package/dist/cli-B3VuxoDe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-B3VuxoDe.js","names":["nodeOpen","readFile","nodeReadFile"],"sources":["../src/cli.ts"],"sourcesContent":["import { open as nodeOpen, readFile as nodeReadFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport {\n  DEVTOOLS_PROTOCOL_VERSION,\n  DEVTOOLS_SESSION_PAGE_LIMIT,\n  devtoolsSessionRevision,\n  parseDevtoolsCapture,\n  verifyDevtoolsCapture,\n  type DevtoolsCapture,\n  type DevtoolsContractsResponse,\n  type DevtoolsSessionDetail,\n  type DevtoolsSessionPage,\n  type DevtoolsSessionsResponse,\n} from './devtools.ts'\n\nexport const DEVTOOLS_CLI_EXIT_ERROR = 1 as const\nexport const DEVTOOLS_CLI_EXIT_CHECK_FAILED = 2 as const\n\ntype OutputFormat = 'human' | 'json' | 'ndjson'\ntype Command = 'contracts' | 'sessions' | 'show' | 'export' | 'check' | 'verify'\n\nexport type DevtoolsCliOptions = {\n  fetch?: typeof globalThis.fetch\n  env?: Readonly<Record<string, string | undefined>>\n  cwd?: string\n  stdout?: (text: string) => void\n  stderr?: (text: string) => void\n  readFile?: (path: string) => Promise<Uint8Array>\n  writeFile?: (\n    path: string,\n    data: Uint8Array,\n    options: { flag: 'w' | 'wx'; mode: number },\n  ) => Promise<void>\n}\n\ntype ParsedArguments = {\n  command: Command | null\n  help: boolean\n  url: string | undefined\n  format: OutputFormat\n  contract: string | undefined\n  session: string | undefined\n  cursor: string | undefined\n  limit: number | undefined\n  output: string | undefined\n  force: boolean\n  bearerEnv: string | undefined\n  headerEnvs: string[]\n  settled: boolean\n  noDeadLetters: boolean\n  noCaughtFailures: boolean\n  maxRedispatches: number | undefined\n  positionals: string[]\n}\n\ntype CheckSummary = {\n  ok: boolean\n  contract: string\n  sessionId: string\n  revision: string\n  eventCount: number\n  snapshotCount: number\n  pendingCount: number\n  deadLetterCount: number\n  caughtFailureCount: number\n  redispatchCount: number\n  failures: string[]\n}\n\nclass CliFailure extends Error {\n  readonly exitCode: number\n\n  constructor(message: string, exitCode: number = DEVTOOLS_CLI_EXIT_ERROR) {\n    super(message)\n    this.name = 'CliFailure'\n    this.exitCode = exitCode\n  }\n}\n\nclass IntegrityFailure extends CliFailure {\n  constructor(message: string) {\n    super(message, DEVTOOLS_CLI_EXIT_CHECK_FAILED)\n    this.name = 'IntegrityFailure'\n  }\n}\n\nconst USAGE = `Usage: a2 devtools <command> [options]\n\nCommands:\n  contracts                    List mounted contracts\n  sessions --contract NAME     List a contract's sessions\n  show --contract NAME --session ID\n                               Show one durable session\n  export --contract NAME --session ID [--output FILE]\n                               Save an integrity-protected .a2log capture\n  check --contract NAME --session ID [assertions]\n                               Verify a live session capture\n  verify FILE                  Verify a saved .a2log capture\n\nConnection:\n  --url URL                    Mounted devtools URL (or A2_DEVTOOLS_URL)\n  --bearer-env ENV             Read a bearer token from ENV\n  --header-env HEADER=ENV      Read a request header from ENV; repeatable\n\nOutput:\n  --format human|json|ndjson   Human output is the default\n  --output FILE, -o FILE       Export destination\n  --force                      Allow export to replace FILE\n\nCheck assertions:\n  --settled                    Require no pending events\n  --no-dead-letters            Require no dead-lettered events\n  --no-caught-failures         Require no caught handler failures\n  --max-redispatches N         Limit dispatches after each event's first claim\n`\n\nconst commandNames = new Set<Command>([\n  'contracts',\n  'sessions',\n  'show',\n  'export',\n  'check',\n  'verify',\n])\n\nconst fail = (message: string): never => {\n  throw new CliFailure(message)\n}\n\nconst nextValue = (\n  argv: readonly string[],\n  index: number,\n  option: string,\n): { value: string; next: number } => {\n  const token = argv[index]!\n  const equals = token.indexOf('=')\n  if (equals !== -1) {\n    const value = token.slice(equals + 1)\n    if (value.length === 0) fail(`${option} requires a value`)\n    return { value, next: index }\n  }\n  const value = argv[index + 1]\n  if (value === undefined || value.startsWith('-')) {\n    fail(`${option} requires a value`)\n  }\n  return { value: value!, next: index + 1 }\n}\n\nconst nonNegativeInteger = (value: string, option: string): number => {\n  const parsed = Number(value)\n  if (!Number.isSafeInteger(parsed) || parsed < 0) {\n    fail(`${option} must be a non-negative integer`)\n  }\n  return parsed\n}\n\nconst positiveInteger = (value: string, option: string): number => {\n  const parsed = nonNegativeInteger(value, option)\n  if (parsed === 0) fail(`${option} must be a positive integer`)\n  return parsed\n}\n\nconst parseArguments = (argv: readonly string[]): ParsedArguments => {\n  if (argv[0] !== 'devtools') {\n    if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {\n      return {\n        command: null,\n        help: true,\n        url: undefined,\n        format: 'human',\n        contract: undefined,\n        session: undefined,\n        cursor: undefined,\n        limit: undefined,\n        output: undefined,\n        force: false,\n        bearerEnv: undefined,\n        headerEnvs: [],\n        settled: false,\n        noDeadLetters: false,\n        noCaughtFailures: false,\n        maxRedispatches: undefined,\n        positionals: [],\n      }\n    }\n    fail(\"expected the 'devtools' command namespace\")\n  }\n\n  const parsed: ParsedArguments = {\n    command: null,\n    help: false,\n    url: undefined,\n    format: 'human',\n    contract: undefined,\n    session: undefined,\n    cursor: undefined,\n    limit: undefined,\n    output: undefined,\n    force: false,\n    bearerEnv: undefined,\n    headerEnvs: [],\n    settled: false,\n    noDeadLetters: false,\n    noCaughtFailures: false,\n    maxRedispatches: undefined,\n    positionals: [],\n  }\n\n  for (let index = 1; index < argv.length; index += 1) {\n    const token = argv[index]!\n    if (token === '--help' || token === '-h' || token === 'help') {\n      parsed.help = true\n      continue\n    }\n    if (\n      token === '--token' ||\n      token.startsWith('--token=') ||\n      token === '--bearer' ||\n      token.startsWith('--bearer=') ||\n      token === '--header' ||\n      token.startsWith('--header=')\n    ) {\n      fail(\n        'literal credential flags are not supported; use A2_DEVTOOLS_TOKEN, --bearer-env, or --header-env',\n      )\n    }\n    if (token === '--force') {\n      parsed.force = true\n      continue\n    }\n    if (token === '--settled') {\n      parsed.settled = true\n      continue\n    }\n    if (token === '--no-dead-letters') {\n      parsed.noDeadLetters = true\n      continue\n    }\n    if (token === '--no-caught-failures') {\n      parsed.noCaughtFailures = true\n      continue\n    }\n\n    const option = token.split('=', 1)[0]!\n    if (\n      option === '--url' ||\n      option === '--format' ||\n      option === '--contract' ||\n      option === '--session' ||\n      option === '--cursor' ||\n      option === '--limit' ||\n      option === '--output' ||\n      option === '-o' ||\n      option === '--bearer-env' ||\n      option === '--header-env' ||\n      option === '--max-redispatches'\n    ) {\n      const result = nextValue(argv, index, option)\n      index = result.next\n      switch (option) {\n        case '--url':\n          parsed.url = result.value\n          break\n        case '--format':\n          if (\n            result.value !== 'human' &&\n            result.value !== 'json' &&\n            result.value !== 'ndjson'\n          ) {\n            fail('--format must be human, json, or ndjson')\n          }\n          parsed.format = result.value as OutputFormat\n          break\n        case '--contract':\n          parsed.contract = result.value\n          break\n        case '--session':\n          parsed.session = result.value\n          break\n        case '--cursor':\n          parsed.cursor = result.value\n          break\n        case '--limit':\n          parsed.limit = positiveInteger(result.value, '--limit')\n          break\n        case '--output':\n        case '-o':\n          parsed.output = result.value\n          break\n        case '--bearer-env':\n          parsed.bearerEnv = result.value\n          break\n        case '--header-env':\n          parsed.headerEnvs.push(result.value)\n          break\n        case '--max-redispatches':\n          parsed.maxRedispatches = nonNegativeInteger(\n            result.value,\n            '--max-redispatches',\n          )\n          break\n      }\n      continue\n    }\n    if (token.startsWith('-')) fail(`unknown option '${token}'`)\n    if (parsed.command === null && commandNames.has(token as Command)) {\n      parsed.command = token as Command\n      continue\n    }\n    if (parsed.command === null) fail(`unknown devtools command '${token}'`)\n    parsed.positionals.push(token)\n  }\n  return parsed\n}\n\nconst required = (value: string | undefined, option: string): string => {\n  if (value === undefined) fail(`${option} is required`)\n  return value!\n}\n\nconst assertCommandArguments = (args: ParsedArguments): void => {\n  if (args.command === null) return\n  if (args.command === 'verify') {\n    if (args.positionals.length !== 1) {\n      fail('verify requires exactly one capture file')\n    }\n    return\n  }\n  if (args.positionals.length > 0) {\n    fail(`unexpected argument '${args.positionals[0]}'`)\n  }\n  if (args.command !== 'contracts') {\n    required(args.contract, '--contract')\n  }\n  if (\n    args.command === 'show' ||\n    args.command === 'export' ||\n    args.command === 'check'\n  ) {\n    required(args.session, '--session')\n  }\n}\n\nconst baseUrl = (value: string): URL => {\n  const url = (() => {\n    try {\n      return new URL(value)\n    } catch {\n      return fail('--url must be an absolute HTTP(S) URL')\n    }\n  })()\n  if (url.protocol !== 'http:' && url.protocol !== 'https:') {\n    fail('--url must use HTTP or HTTPS')\n  }\n  if (url.username || url.password) {\n    fail('credentials must not be embedded in --url')\n  }\n  if (url.search || url.hash) {\n    fail('--url must not contain a query string or fragment')\n  }\n  url.pathname = `${url.pathname.replace(/\\/+$/, '')}/`\n  return url\n}\n\nconst environmentName = (value: string, option: string): string => {\n  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {\n    fail(`${option} must reference a valid environment variable name`)\n  }\n  return value\n}\n\nconst requestHeaders = (\n  args: ParsedArguments,\n  env: Readonly<Record<string, string | undefined>>,\n  accept: string,\n): Headers => {\n  const headers = new Headers({ accept })\n  const bearerName =\n    args.bearerEnv === undefined\n      ? 'A2_DEVTOOLS_TOKEN'\n      : environmentName(args.bearerEnv, '--bearer-env')\n  const bearer = env[bearerName]\n  if (args.bearerEnv !== undefined && !bearer) {\n    fail(`environment variable '${bearerName}' is not set`)\n  }\n  if (bearer) headers.set('authorization', `Bearer ${bearer}`)\n\n  for (const mapping of args.headerEnvs) {\n    const equals = mapping.indexOf('=')\n    if (equals < 1 || equals === mapping.length - 1) {\n      fail('--header-env must use HEADER=ENV')\n    }\n    const name = mapping.slice(0, equals)\n    const envName = environmentName(mapping.slice(equals + 1), '--header-env')\n    const value = env[envName]\n    if (!value) fail(`environment variable '${envName}' is not set`)\n    if (headers.has(name)) fail(`request header '${name}' was configured twice`)\n    try {\n      headers.set(name, value!)\n    } catch {\n      fail(`--header-env contains an invalid header name or value`)\n    }\n  }\n  return headers\n}\n\nconst resourceUrl = (\n  base: URL,\n  resource: string,\n  params: Readonly<Record<string, string | number | undefined>>,\n): URL => {\n  const url = new URL(`_a2/${resource}`, base)\n  for (const [name, value] of Object.entries(params)) {\n    if (value !== undefined) url.searchParams.set(name, String(value))\n  }\n  return url\n}\n\nconst terminalText = (value: string): string =>\n  [...value]\n    .map((character) => {\n      const codePoint = character.codePointAt(0)!\n      const isControl =\n        codePoint <= 0x1f ||\n        (codePoint >= 0x7f && codePoint <= 0x9f) ||\n        codePoint === 0x2028 ||\n        codePoint === 0x2029\n      if (!isControl) return character\n      if (character === '\\n') return '\\\\n'\n      if (character === '\\r') return '\\\\r'\n      if (character === '\\t') return '\\\\t'\n      return codePoint <= 0xff\n        ? `\\\\x${codePoint.toString(16).padStart(2, '0')}`\n        : `\\\\u${codePoint.toString(16).padStart(4, '0')}`\n    })\n    .join('')\n\nconst fetchResponse = async (\n  fetcher: typeof globalThis.fetch,\n  url: URL,\n  headers: Headers,\n  resource: string,\n): Promise<Response> => {\n  let response: Response\n  try {\n    response = await fetcher(url, {\n      method: 'GET',\n      headers,\n      redirect: 'manual',\n    })\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    throw new CliFailure(`could not fetch ${resource}: ${message}`)\n  }\n  if (!response.ok) {\n    let text = ''\n    try {\n      text = await response.text()\n    } catch {\n      // The status remains useful when an error response has an unreadable body.\n    }\n    const detail = terminalText(text.trim().slice(0, 300))\n    throw new CliFailure(\n      `${resource} returned ${response.status}${detail ? `: ${detail}` : ''}`,\n    )\n  }\n  return response\n}\n\nconst responseText = async (\n  fetcher: typeof globalThis.fetch,\n  url: URL,\n  headers: Headers,\n  resource: string,\n): Promise<string> =>\n  (await fetchResponse(fetcher, url, headers, resource)).text()\n\nconst responseBytes = async (\n  fetcher: typeof globalThis.fetch,\n  url: URL,\n  headers: Headers,\n  resource: string,\n): Promise<Uint8Array> =>\n  new Uint8Array(\n    await (await fetchResponse(fetcher, url, headers, resource)).arrayBuffer(),\n  )\n\nconst objectValue = (value: unknown): Record<string, unknown> | null =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst parseJson = (text: string, resource: string): unknown => {\n  try {\n    return JSON.parse(text) as unknown\n  } catch {\n    throw new CliFailure(`${resource} did not return valid JSON`)\n  }\n}\n\nconst assertProtocol = (\n  value: Record<string, unknown>,\n  resource: string,\n): void => {\n  if (value['protocolVersion'] !== DEVTOOLS_PROTOCOL_VERSION) {\n    throw new CliFailure(`${resource} returned an unsupported protocol version`)\n  }\n}\n\nconst hasContractName = (value: unknown): boolean => {\n  const object = objectValue(value)\n  return typeof object?.['name'] === 'string' && object['name'].length > 0\n}\n\nconst contractsResponse = (value: unknown): DevtoolsContractsResponse => {\n  const object = objectValue(value)\n  if (!object) throw new CliFailure('contracts returned an invalid response')\n  assertProtocol(object, 'contracts')\n  if (\n    !Array.isArray(object['contracts']) ||\n    !object['contracts'].every(hasContractName)\n  ) {\n    throw new CliFailure('contracts returned an invalid response')\n  }\n  return object as DevtoolsContractsResponse\n}\n\nconst sessionsResponse = (value: unknown): DevtoolsSessionsResponse => {\n  const object = objectValue(value)\n  if (!object) throw new CliFailure('sessions returned an invalid response')\n  assertProtocol(object, 'sessions')\n  if (\n    !Array.isArray(object['sessions']) ||\n    (object['cursor'] !== null && typeof object['cursor'] !== 'string')\n  ) {\n    throw new CliFailure('sessions returned an invalid response')\n  }\n  return object as DevtoolsSessionsResponse\n}\n\nconst sessionResponse = (value: unknown): DevtoolsSessionDetail => {\n  const object = objectValue(value)\n  if (!object) throw new CliFailure('session returned an invalid response')\n  assertProtocol(object, 'session')\n  if (\n    typeof object['contract'] !== 'string' ||\n    typeof object['sessionId'] !== 'string' ||\n    typeof object['revision'] !== 'string' ||\n    !Array.isArray(object['events']) ||\n    !Array.isArray(object['snapshots'])\n  ) {\n    throw new CliFailure('session returned an invalid response')\n  }\n  return object as DevtoolsSessionDetail\n}\n\nconst sessionPageResponse = (value: unknown): DevtoolsSessionPage => {\n  const object = objectValue(value)\n  if (!object) throw new CliFailure('session returned an invalid response')\n  assertProtocol(object, 'session')\n  if (\n    typeof object['contract'] !== 'string' ||\n    typeof object['sessionId'] !== 'string' ||\n    !Number.isSafeInteger(object['throughIndex']) ||\n    (object['throughIndex'] as number) < 0 ||\n    (object['cursor'] !== null && typeof object['cursor'] !== 'string') ||\n    !Array.isArray(object['events']) ||\n    !Array.isArray(object['snapshots'])\n  ) {\n    throw new CliFailure('session returned an invalid response')\n  }\n  return object as DevtoolsSessionPage\n}\n\nconst readSessionDetail = async (\n  fetcher: typeof globalThis.fetch,\n  base: URL,\n  headers: Headers,\n  contract: string,\n  session: string,\n): Promise<DevtoolsSessionDetail> => {\n  const events: DevtoolsSessionDetail['events'] = []\n  let snapshots: DevtoolsSessionDetail['snapshots'] = []\n  let cursor: string | undefined\n  let throughIndex: number | undefined\n  const seenCursors = new Set<string>()\n  for (;;) {\n    // oxlint-disable-next-line no-await-in-loop -- each HTTP request advances one frozen session page\n    const text = await responseText(\n      fetcher,\n      resourceUrl(base, 'session', {\n        contract,\n        session,\n        limit: DEVTOOLS_SESSION_PAGE_LIMIT,\n        cursor,\n      }),\n      headers,\n      'session',\n    )\n    const parsed = parseJson(text, 'session')\n    const object = objectValue(parsed)\n    if (object && typeof object['revision'] === 'string') {\n      if (events.length > 0) {\n        throw new CliFailure('session changed response shape between pages')\n      }\n      return sessionResponse(parsed)\n    }\n    const page = sessionPageResponse(parsed)\n    if (page.contract !== contract || page.sessionId !== session) {\n      throw new CliFailure('session page returned a different identity')\n    }\n    if (throughIndex === undefined) {\n      throughIndex = page.throughIndex\n      snapshots = page.snapshots\n    } else if (\n      page.throughIndex !== throughIndex ||\n      page.snapshots.length > 0\n    ) {\n      throw new CliFailure('session page changed its frozen frontier')\n    }\n    for (const event of page.events) {\n      if (event.index !== events.length + 1 || event.index > throughIndex) {\n        throw new CliFailure('session event pages are not contiguous')\n      }\n      events.push(event)\n    }\n    if (page.cursor === null) break\n    if (\n      page.events.length === 0 ||\n      events.length === throughIndex ||\n      seenCursors.has(page.cursor)\n    ) {\n      throw new CliFailure('session cursor did not advance')\n    }\n    seenCursors.add(page.cursor)\n    cursor = page.cursor\n  }\n  if (throughIndex !== events.length) {\n    throw new CliFailure('session ended before its frozen frontier')\n  }\n  return {\n    protocolVersion: DEVTOOLS_PROTOCOL_VERSION,\n    contract,\n    sessionId: session,\n    revision: await devtoolsSessionRevision({ events, snapshots }),\n    events,\n    snapshots,\n  }\n}\n\nconst jsonText = (value: unknown): string =>\n  `${JSON.stringify(value, null, 2)}\\n`\n\nconst ndjsonText = (values: readonly unknown[]): string =>\n  values.map((value) => JSON.stringify(value)).join('\\n') +\n  (values.length === 0 ? '' : '\\n')\n\nconst humanContracts = (response: DevtoolsContractsResponse): string =>\n  response.contracts.length === 0\n    ? 'No contracts.\\n'\n    : `${response.contracts.map((contract) => terminalText(contract.name)).join('\\n')}\\n`\n\nconst humanSessions = (response: DevtoolsSessionsResponse): string => {\n  if (response.sessions.length === 0) return 'No sessions.\\n'\n  const rows = response.sessions.map((session) =>\n    [\n      terminalText(session.sessionId),\n      session.eventCount,\n      session.pendingCount,\n      session.failedCount,\n      session.attemptCount,\n      session.failureCount,\n      terminalText(session.updatedAt),\n    ].join('\\t'),\n  )\n  return (\n    [\n      'SESSION\\tEVENTS\\tPENDING\\tDEAD\\tATTEMPTS\\tFAILURES\\tUPDATED',\n      ...rows,\n    ].join('\\n') + '\\n'\n  )\n}\n\nconst humanSession = (detail: DevtoolsSessionDetail): string => {\n  const rows = detail.events.map((event) => {\n    const status = event.failedAt\n      ? 'dead-lettered'\n      : event.processedAt\n        ? 'completed'\n        : 'pending'\n    return `${event.index}\\t${status}\\t${terminalText(event.type)}\\t${terminalText(event.id)}`\n  })\n  const heading = `${terminalText(detail.contract)}/${terminalText(detail.sessionId)}: ${detail.events.length} events, ${detail.snapshots.length} snapshots\\n`\n  return rows.length === 0\n    ? heading\n    : `${heading}INDEX\\tSTATUS\\tTYPE\\tID\\n${rows.join('\\n')}\\n`\n}\n\nconst emitResponse = (\n  format: OutputFormat,\n  value: unknown,\n  ndjson: readonly unknown[],\n  human: string,\n  stdout: (text: string) => void,\n): void => {\n  if (format === 'json') stdout(jsonText(value))\n  else if (format === 'ndjson') stdout(ndjsonText(ndjson))\n  else stdout(human)\n}\n\nconst parseAndVerifyCapture = async (\n  bytes: Uint8Array,\n): Promise<DevtoolsCapture> => {\n  let text: string\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes)\n  } catch {\n    throw new IntegrityFailure('capture is not valid UTF-8')\n  }\n  try {\n    const capture = parseDevtoolsCapture(text)\n    await verifyDevtoolsCapture(capture)\n    return capture\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    throw new IntegrityFailure(message)\n  }\n}\n\nconst captureSummary = (capture: DevtoolsCapture): CheckSummary => {\n  let pendingCount = 0\n  let deadLetterCount = 0\n  let caughtFailureCount = 0\n  let redispatchCount = 0\n  for (const event of capture.events) {\n    if (event.processedAt === null && event.failedAt === null) pendingCount += 1\n    if (event.failedAt !== null) deadLetterCount += 1\n    if (\n      !Number.isSafeInteger(event.failureCount) ||\n      event.failureCount < 0 ||\n      !Number.isSafeInteger(event.attemptCount) ||\n      event.attemptCount < 0\n    ) {\n      throw new IntegrityFailure(\n        `event #${event.index} has invalid attempt or failure counts`,\n      )\n    }\n    caughtFailureCount += event.failureCount\n    redispatchCount += Math.max(0, event.attemptCount - 1)\n  }\n  return {\n    ok: true,\n    contract: capture.contract,\n    sessionId: capture.sessionId,\n    revision: capture.revision,\n    eventCount: capture.events.length,\n    snapshotCount: capture.snapshots.length,\n    pendingCount,\n    deadLetterCount,\n    caughtFailureCount,\n    redispatchCount,\n    failures: [],\n  }\n}\n\nconst checkSummary = (\n  capture: DevtoolsCapture,\n  args: ParsedArguments,\n): CheckSummary => {\n  const summary = captureSummary(capture)\n  if (capture.contract !== args.contract) {\n    summary.failures.push(\n      `capture contract '${capture.contract}' does not match '${args.contract}'`,\n    )\n  }\n  if (capture.sessionId !== args.session) {\n    summary.failures.push(\n      `capture session '${capture.sessionId}' does not match '${args.session}'`,\n    )\n  }\n  if (args.settled && summary.pendingCount > 0) {\n    summary.failures.push(`${summary.pendingCount} event(s) are pending`)\n  }\n  if (args.noDeadLetters && summary.deadLetterCount > 0) {\n    summary.failures.push(\n      `${summary.deadLetterCount} event(s) are dead-lettered`,\n    )\n  }\n  if (args.noCaughtFailures && summary.caughtFailureCount > 0) {\n    summary.failures.push(\n      `${summary.caughtFailureCount} caught handler failure(s) were recorded`,\n    )\n  }\n  if (\n    args.maxRedispatches !== undefined &&\n    summary.redispatchCount > args.maxRedispatches\n  ) {\n    summary.failures.push(\n      `${summary.redispatchCount} redispatch(es) exceed the limit of ${args.maxRedispatches}`,\n    )\n  }\n  summary.ok = summary.failures.length === 0\n  return summary\n}\n\nconst assertCaptureIdentity = (\n  capture: DevtoolsCapture,\n  contract: string,\n  sessionId: string,\n): void => {\n  if (capture.contract !== contract) {\n    throw new IntegrityFailure(\n      `capture contract '${capture.contract}' does not match '${contract}'`,\n    )\n  }\n  if (capture.sessionId !== sessionId) {\n    throw new IntegrityFailure(\n      `capture session '${capture.sessionId}' does not match '${sessionId}'`,\n    )\n  }\n}\n\nconst humanCheck = (summary: CheckSummary, verb: string): string =>\n  `${verb} ${terminalText(summary.contract)}/${terminalText(summary.sessionId)}: ${summary.eventCount} events, ${summary.snapshotCount} snapshots, ${summary.pendingCount} pending, ${summary.deadLetterCount} dead-lettered, ${summary.caughtFailureCount} caught failures, ${summary.redispatchCount} redispatches\\n`\n\nconst defaultCaptureName = (contract: string, sessionId: string): string => {\n  const safe = `${contract}-${sessionId}`\n    .replaceAll(/[^a-zA-Z0-9._-]/g, '_')\n    .slice(0, 160)\n  return `${safe || 'a2-session'}.a2log`\n}\n\nconst errorCode = (error: unknown): string | undefined => {\n  const object = objectValue(error)\n  return typeof object?.['code'] === 'string' ? object['code'] : undefined\n}\n\nconst writeCaptureFile = async (\n  path: string,\n  data: Uint8Array,\n  options: { flag: 'w' | 'wx'; mode: number },\n): Promise<void> => {\n  const file = await nodeOpen(path, options.flag, options.mode)\n  try {\n    await file.chmod(options.mode)\n    await file.writeFile(data)\n  } finally {\n    await file.close()\n  }\n}\n\n/** Run the `a2 devtools` command namespace and return its process exit code. */\nexport async function runCli(\n  argv: readonly string[],\n  options: DevtoolsCliOptions = {},\n): Promise<number> {\n  const stdout =\n    options.stdout ?? ((text: string) => process.stdout.write(text))\n  const stderr =\n    options.stderr ?? ((text: string) => process.stderr.write(text))\n  const env = options.env ?? process.env\n  const fetcher = options.fetch ?? globalThis.fetch\n  const cwd = options.cwd ?? process.cwd()\n  const readFile = options.readFile ?? nodeReadFile\n  const writeFile = options.writeFile ?? writeCaptureFile\n\n  try {\n    const args = parseArguments(argv)\n    if (args.help || args.command === null) {\n      stdout(USAGE)\n      return 0\n    }\n    assertCommandArguments(args)\n\n    if (args.command === 'verify') {\n      const path = resolve(cwd, args.positionals[0]!)\n      let bytes: Uint8Array\n      try {\n        bytes = await readFile(path)\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error)\n        throw new CliFailure(`could not read '${path}': ${message}`)\n      }\n      const summary = captureSummary(await parseAndVerifyCapture(bytes))\n      emitResponse(\n        args.format,\n        summary,\n        [summary],\n        humanCheck(summary, 'Verified'),\n        stdout,\n      )\n      return 0\n    }\n\n    const configuredUrl = args.url ?? env['A2_DEVTOOLS_URL']\n    if (!configuredUrl) {\n      fail('--url or A2_DEVTOOLS_URL is required')\n    }\n    const base = baseUrl(configuredUrl!)\n    const headers = requestHeaders(args, env, 'application/json')\n\n    if (args.command === 'contracts') {\n      const text = await responseText(\n        fetcher,\n        resourceUrl(base, 'contracts', {}),\n        headers,\n        'contracts',\n      )\n      const response = contractsResponse(parseJson(text, 'contracts'))\n      emitResponse(\n        args.format,\n        response,\n        response.contracts,\n        humanContracts(response),\n        stdout,\n      )\n      return 0\n    }\n\n    const contract = required(args.contract, '--contract')\n    if (args.command === 'sessions') {\n      const text = await responseText(\n        fetcher,\n        resourceUrl(base, 'sessions', {\n          contract,\n          cursor: args.cursor,\n          limit: args.limit,\n        }),\n        headers,\n        'sessions',\n      )\n      const response = sessionsResponse(parseJson(text, 'sessions'))\n      emitResponse(\n        args.format,\n        response,\n        response.sessions,\n        humanSessions(response),\n        stdout,\n      )\n      return 0\n    }\n\n    const session = required(args.session, '--session')\n    if (args.command === 'show') {\n      const detail = await readSessionDetail(\n        fetcher,\n        base,\n        headers,\n        contract,\n        session,\n      )\n      emitResponse(\n        args.format,\n        detail,\n        [\n          {\n            kind: 'session',\n            protocolVersion: detail.protocolVersion,\n            contract: detail.contract,\n            sessionId: detail.sessionId,\n            revision: detail.revision,\n          },\n          ...detail.events.map((event) => ({ ...event, kind: 'event' })),\n          ...detail.snapshots.map((snapshot) => ({\n            ...snapshot,\n            kind: 'snapshot',\n          })),\n        ],\n        humanSession(detail),\n        stdout,\n      )\n      return 0\n    }\n\n    const exportHeaders = requestHeaders(args, env, 'application/x-ndjson')\n    const captureBytes = await responseBytes(\n      fetcher,\n      resourceUrl(base, 'export', { contract, session }),\n      exportHeaders,\n      'export',\n    )\n    const capture = await parseAndVerifyCapture(captureBytes)\n\n    if (args.command === 'check') {\n      const summary = checkSummary(capture, args)\n      emitResponse(\n        args.format,\n        summary,\n        [summary],\n        humanCheck(summary, summary.ok ? 'Checked' : 'Check failed for'),\n        stdout,\n      )\n      if (!summary.ok) {\n        for (const failure of summary.failures) {\n          stderr(`a2 devtools: ${terminalText(failure)}\\n`)\n        }\n        return DEVTOOLS_CLI_EXIT_CHECK_FAILED\n      }\n      return 0\n    }\n\n    assertCaptureIdentity(capture, contract, session)\n\n    const output = resolve(\n      cwd,\n      args.output ?? defaultCaptureName(contract, session),\n    )\n    try {\n      await writeFile(output, captureBytes, {\n        flag: args.force ? 'w' : 'wx',\n        mode: 0o600,\n      })\n    } catch (error) {\n      if (errorCode(error) === 'EEXIST') {\n        throw new CliFailure(\n          `'${output}' already exists; pass --force to replace it`,\n        )\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      throw new CliFailure(`could not write '${output}': ${message}`)\n    }\n    const result = {\n      path: output,\n      contract: capture.contract,\n      sessionId: capture.sessionId,\n      eventCount: capture.events.length,\n      snapshotCount: capture.snapshots.length,\n      sha256: capture.footer.sha256,\n    }\n    emitResponse(\n      args.format,\n      result,\n      [result],\n      `Exported ${terminalText(capture.contract)}/${terminalText(capture.sessionId)}: ${capture.events.length} events, ${capture.snapshots.length} snapshots -> ${terminalText(output)}\\n`,\n      stdout,\n    )\n    return 0\n  } catch (error) {\n    const failure =\n      error instanceof CliFailure\n        ? error\n        : new CliFailure(error instanceof Error ? error.message : String(error))\n    stderr(`a2 devtools: ${terminalText(failure.message)}\\n`)\n    return failure.exitCode\n  }\n}\n"],"mappings":"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"}

package/dist/cli-bin.d.ts

@@ -1 +0,0 @@
-export {}

package/dist/cli-bin.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-import { r as runCli } from "./cli-B3VuxoDe.js";
-//#region src/cli-bin.ts
-process.exitCode = await runCli(process.argv.slice(2));
-//#endregion
-
-//# sourceMappingURL=cli-bin.js.map

package/dist/cli-bin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-bin.js","names":[],"sources":["../src/cli-bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { runCli } from './cli.ts'\n\nprocess.exitCode = await runCli(process.argv.slice(2))\n"],"mappings":";;;AAIA,QAAQ,WAAW,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -1,20 +0,0 @@
-//#region src/cli.d.ts
-declare const DEVTOOLS_CLI_EXIT_ERROR: 1;
-declare const DEVTOOLS_CLI_EXIT_CHECK_FAILED: 2;
-type DevtoolsCliOptions = {
-  fetch?: typeof globalThis.fetch;
-  env?: Readonly<Record<string, string | undefined>>;
-  cwd?: string;
-  stdout?: (text: string) => void;
-  stderr?: (text: string) => void;
-  readFile?: (path: string) => Promise<Uint8Array>;
-  writeFile?: (path: string, data: Uint8Array, options: {
-    flag: "w" | "wx";
-    mode: number;
-  }) => Promise<void>;
-};
-/** Run the `a2 devtools` command namespace and return its process exit code. */
-declare function runCli(argv: readonly string[], options?: DevtoolsCliOptions): Promise<number>;
-//#endregion
-export { DEVTOOLS_CLI_EXIT_CHECK_FAILED, DEVTOOLS_CLI_EXIT_ERROR, DevtoolsCliOptions, runCli };
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","names":[],"sources":["../src/cli.ts"],"mappings":";cAea;cACA;KAKD;EACV,eAAe,WAAW;EAC1B,MAAM,SAAS;EACf;EACA,UAAU;EACV,UAAU;EACV,YAAY,iBAAiB,QAAQ;EACrC,aACE,cACA,MAAM,YACN;IAAW;IAAkB;QAC1B;;;iBAozBe,OACpB,yBACA,UAAS,qBACR"}

package/dist/cli.js

@@ -1,2 +0,0 @@
-import { n as DEVTOOLS_CLI_EXIT_ERROR, r as runCli, t as DEVTOOLS_CLI_EXIT_CHECK_FAILED } from "./cli-B3VuxoDe.js";
-export { DEVTOOLS_CLI_EXIT_CHECK_FAILED, DEVTOOLS_CLI_EXIT_ERROR, runCli };

package/dist/client-CdMqi7mC.d.ts

@@ -1,202 +0,0 @@
-import { a as EventDefs, c as PresencePatch, d as WithPresence, o as PresenceDefs, p as Reducer, r as ContractEvent, s as PresenceMap, t as AppendInput } from "./contract-jIfaR085.js";
-//#region src/client.d.ts
-type ConnectionStatus = "idle" | "connecting" | "live" | "closed";
-/**
- * The connection, as a discriminated union — impossible states are
- * unrepresentable: an error only exists while disconnected,
- * `reconnects` only once a connection has been attempted.
- * "Reconnecting…" is `status === 'connecting' && reconnects > 0`.
- */
-type Connection = {
-  status: "idle";
-} | {
-  status: "connecting";
-  /** Drops of an established stream so far. `0` = first connect. */
-  reconnects: number;
-  /** Why the last connection ended; `null` on the first connect. */
-  error: Error | null;
-} | {
-  status: "live";
-  reconnects: number;
-} | {
-  status: "closed";
-};
-/**
- * What `push` returns: resolves at the server ack (exactly like a
- * plain promise — `await push(...)` gives the acked events), and
- * carries `confirmed` for the later moment when the live stream has
- * delivered the whole batch back and the optimistic overlay entry
- * retired — the view now shows server truth. `confirmed` is lazy:
- * never accessed, never created. A rejected push rejects both.
- */
-type PushResult<D extends EventDefs> = Promise<ContractEvent<D>[]> & {
-  readonly confirmed: Promise<ContractEvent<D>[]>;
-};
-type LoadHistoryOptions = {
-  /**
-   * Exclusive upper bound for the fetch. Defaults to the oldest
-   * already-loaded index — successive calls page backward — or one
-   * past the hydration frontier while nothing is loaded yet.
-   */
-  before?: number;
-  /** Page size; defaults to 50. */
-  limit?: number;
-};
-/** Backscroll progress, derived from the raw event feed. */
-type HistoryState = {
-  /** A `loadHistory` fetch is in flight. */
-  loading: boolean;
-  /** The feed reaches index 1 — nothing older remains to fetch. */
-  complete: boolean;
-  /** The oldest loaded index; `null` while nothing is loaded. */
-  oldestLoaded: number | null;
-};
-/** One immutable view of the session — stable identity between changes. */
-type SessionSnapshot<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>> = WithPresence<P, {
-  /** The replicated presence map, this client included (local echo). */
-  presence: PresenceMap<P>;
-}> & {
-  /** The live view: server events folded, optimistic pushes applied. */
-  state: S;
-  /** The raw event feed: server truth — observed, seeded, or
-   * backscrolled via `loadHistory` — plus pending optimistic events
-   * (provisional indexes past the frontier). `state` never folds
-   * backscrolled events; they are display data below the frontier. */
-  events: ContractEvent<D>[];
-  /** The stream frontier: the last server-confirmed index. This is the
-   * `lastSeenIndex` cancellation wants. */
-  index: number;
-  /** Backscroll progress — `loadHistory` moves it. */
-  history: HistoryState;
-  connection: Connection;
-};
-/**
- * The presence member of a client session — intersected in via
- * `WithPresence`, so it exists exactly when the contract declares
- * presence fields.
- */
-type SessionClientPresence<P extends PresenceDefs> = {
-  /**
-   * Fire-and-forget presence: validates locally against the reducer's
-   * presence schemas, merges into the local map immediately (the
-   * echo), and coalesces on the wire to a fixed cadence — a leading
-   * send immediately, then at most one merged send per interval,
-   * later values winning field-wise. `null` clears a field. No ack,
-   * no retry, no rollback: a lost patch is repainted by the next one.
-   * Requires the session's `participant`.
-   */
-  setPresence(values: PresencePatch<P>["values"]): void;
-};
-type SessionClient<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>> = WithPresence<P, SessionClientPresence<P>> & {
-  readonly sessionId: string;
-  subscribe(listener: () => void): () => void;
-  getSnapshot(): SessionSnapshot<D, S, P>;
-  /**
-   * Optimistic append: validates locally against the reducer's event
-   * schemas (instant `INVALID_PAYLOAD`, no flicker), applies to the
-   * local fold, POSTs, swaps in the ack, rolls back on rejection.
-   * Auto-retries only `STORE_UNAVAILABLE`. Resolves with the appended
-   * events as the server recorded them. Overlapping calls on this
-   * handle enter the transport in invocation order without delaying
-   * their optimistic folds.
-   */
-  push(...events: AppendInput<D>[]): PushResult<D>;
-  /**
-   * Backscroll: fetch a bounded slice of events from below the
-   * frontier and merge it into `events` — deduped, ordered, shared by
-   * every handle of this session. Folded state and the optimistic
-   * overlay are never touched. Calls serialize per session and skip
-   * already-loaded ranges, so overlapping backscrolls never fetch the
-   * same range twice. Resolves with the events in the requested range.
-   * Requires an http api; the `ws` transport has no history lane and
-   * this throws a TypeError there.
-   */
-  loadHistory(options?: LoadHistoryOptions): Promise<ContractEvent<D>[]>;
-  /**
-   * Take a lease on the live stream and return its release. Leases
-   * refcount per handle — the first connects, releasing the last
-   * closes — so independent consumers of one identity-mapped handle
-   * (two hooks, a hook plus vanilla code) never fight over the
-   * stream. Releasing twice is a no-op. While any lease is held the
-   * stream reconnects with backoff and resumes from the frontier.
-   */
-  connect(): () => void;
-  /**
-   * The hard stop: drops every outstanding lease and closes the
-   * stream now. Not terminal — a later `connect()` starts fresh from
-   * the current frontier.
-   */
-  close(): void;
-};
-type SessionOptions<D extends EventDefs, S> = {
-  initialState?: S;
-  initialIndex?: number;
-  /** Server-rendered history through `initialIndex`. Seeds the event feed. */
-  initialEvents?: ContractEvent<D>[];
-  /** Overrides the client's `participant` for this session handle.
-   * Bound once per handle. */
-  participant?: string;
-};
-type A2Client<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>> = {
-  session(sessionId: string, options?: SessionOptions<D, S>): SessionClient<D, S, P>;
-};
-/**
- * The wire the client rides. The string form is one route serving GET
- * (SSE stream) + POST (push). `http` splits the verbs across two
- * routes, for when platform duration limits differ per verb. `ws`
- * rides everything — every session of this client — over one
- * multiplexed WebSocket, served by `sessionsSocket`.
- */
-type ClientApi = string | {
-  type: "http";
-  push: string;
-  stream: string;
-} | {
-  type: "ws";
-  url: string;
-};
-/**
- * The socket surface the `ws` transport drives — satisfied structurally
- * by the DOM `WebSocket` and Node's alike, and small enough to fake in
- * tests.
- */
-type ClientWebSocket = {
-  readonly readyState: number;
-  send(data: string): void;
-  close(code?: number, reason?: string): void;
-  addEventListener(type: "open", listener: () => void): void;
-  addEventListener(type: "message", listener: (event: {
-    data: unknown;
-  }) => void): void;
-  addEventListener(type: "close", listener: (event: {
-    code: number;
-    reason: string;
-  }) => void): void;
-  addEventListener(type: "error", listener: () => void): void;
-};
-type ClientWebSocketConstructor = new (url: string) => ClientWebSocket;
-type CreateClientOptions<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>> = {
-  reducer: Reducer<D, S, P>;
-  /** The route (or routes) the client speaks — see `ClientApi`. */
-  api: ClientApi;
-  /** Injectable fetch — defaults to the global. */
-  fetch?: typeof globalThis.fetch;
-  /** Injectable WebSocket constructor for the `ws` api — defaults to
-   * the global. The http transports never touch it. */
-  webSocket?: ClientWebSocketConstructor;
-  /** How long an idle session keeps its in-memory identity, in
-   * milliseconds. Defaults to five minutes; `Infinity` disables GC. */
-  gcTime?: number;
-  /**
-   * This client's presence identity — required to call `setPresence`.
-   * Caller-supplied (a user id, a tab nonce, a guest name): A2 does
-   * not invent an identity story; the app states it once here. The
-   * default for every session handle this client creates;
-   * `session(id, { participant })` overrides it per handle.
-   */
-  participant?: string;
-};
-declare function createClient<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>>(options: CreateClientOptions<D, S, P>): A2Client<D, S, P>;
-//#endregion
-export { Connection as a, HistoryState as c, SessionClient as d, SessionClientPresence as f, createClient as h, ClientWebSocketConstructor as i, LoadHistoryOptions as l, SessionSnapshot as m, ClientApi as n, ConnectionStatus as o, SessionOptions as p, ClientWebSocket as r, CreateClientOptions as s, A2Client as t, PushResult as u };
-//# sourceMappingURL=client-CdMqi7mC.d.ts.map

package/dist/client-CdMqi7mC.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-CdMqi7mC.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;KAoDY;;;;;;;KAQA;EACN;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;EAAgB;;EAChB;;;;;;;;;;KAUM,WAAW,UAAU,aAAa,QAAQ,cAAc;WACzD,WAAW,QAAQ,cAAc;;KAGhC;;;;;;EAMV;;EAEA;;;KAIU;;EAEV;;EAEA;;EAEA;;;KAIU,gBACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aACF;;EAGE,UAAU,YAAY;;;EAIxB,OAAO;;;;;EAKP,QAAQ,cAAc;;;EAGtB;;EAEA,SAAS;EACT,YAAY;;;;;;;KAQF,sBAAsB,UAAU;;;;;;;;;;EAU1C,YAAY,QAAQ,cAAc;;KAGxB,cACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aAAa,GAAG,sBAAsB;WAC/B;EACT,UAAU;EACV,eAAe,gBAAgB,GAAG,GAAG;;;;;;;;;;EAUrC,QAAQ,QAAQ,YAAY,OAAO,WAAW;;;;;;;;;;;EAW9C,YAAY,UAAU,qBAAqB,QAAQ,cAAc;;;;;;;;;EASjE;;;;;;EAMA;;KAGU,eAAe,UAAU,WAAW;EAC9C,eAAe;EACf;;EAEA,gBAAgB,cAAc;;;EAG9B;;KAGU,SACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,QACE,mBACA,UAAU,eAAe,GAAG,KAC3B,cAAc,GAAG,GAAG;;;;;;;;;KAUb;EAEN;EAAc;EAAc;;EAC5B;EAAY;;;;;;;KAON;WACD;EACT,KAAK;EACL,MAAM,eAAe;EACrB,iBAAiB,cAAc;EAC/B,iBACE,iBACA,WAAW;IAAS;;EAEtB,iBACE,eACA,WAAW;IAAS;IAAc;;EAEpC,iBAAiB,eAAe;;KAGtB,kCAAkC,gBAAgB;KAElD,oBACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,SAAS,QAAQ,GAAG,GAAG;;EAEvB,KAAK;;EAEL,eAAe,WAAW;;;EAG1B,YAAY;;;EAGZ;;;;;;;;EAQA;;iBAirBc,aACd,UAAU,WACV,GACA,UAAU,eAAe,sBACzB,SAAS,oBAAoB,GAAG,GAAG,KAAK,SAAS,GAAG,GAAG"}