#!/usr/bin/env node
/**
 * Emit a TypeScript helper aligned with BARE_OS_CTX_API_VERSION and bare-os-ctx.d.ts.
 * Writes docs/reference/ctx-client-helper.generated.ts (commit this file when the API bumps).
 */
import fs from 'node:fs'
import path from 'node:path'
import process from 'node:process'
import { fileURLToPath } from 'node:url'

const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
const apiPath = path.join(
  root,
  'packages/bare-os-booter/lib/bare-os-ctx-api.js'
)
const dtsPath = path.join(
  root,
  'packages/bare-os-booter/lib/bare-os-ctx.d.ts'
)
const outPath = path.join(root, 'docs/reference/ctx-client-helper.generated.ts')

const apiSrc = fs.readFileSync(apiPath, 'utf8')
const m = apiSrc.match(/export const BARE_OS_CTX_API_VERSION = '([^']+)'/)
const ver = m ? m[1] : 'unknown'

let dtsBareOsMemberApprox = 0
let dtsBytes = 0
if (fs.existsSync(dtsPath)) {
  const dts = fs.readFileSync(dtsPath, 'utf8')
  dtsBytes = dts.length
  const re = /\bbareOs[a-zA-Z0-9_]*\??\s*[:(]/g
  let mm
  while ((mm = re.exec(dts)) !== null) dtsBareOsMemberApprox++
}

const out = `// Auto-generated by scripts/gen-ctx-client-helper.mjs — do not edit by hand.

/** Canonical \`ctx\` API semver from \`packages/bare-os-booter/lib/bare-os-ctx-api.js\`. */
export const BARE_OS_CTX_API_CLIENT_VERSION = '${ver}' as const

/** Relative path to the hand-maintained TypeScript contract (schema source of truth). */
export const BARE_OS_CTX_DTS_SOURCE = 'packages/bare-os-booter/lib/bare-os-ctx.d.ts' as const

/** Approximate count of \`bareOs…\` members in the DTS (diagnostic only; regenerate on contract edits). */
export const BARE_OS_CTX_DTS_BAREOS_MEMBER_APPROX = ${dtsBareOsMemberApprox} as const

/** Byte length of \`bare-os-ctx.d.ts\` when this file was generated. */
export const BARE_OS_CTX_DTS_BYTES = ${dtsBytes} as const

/** Pointers for external client generators (OpenAPI / JSON Schema follow-ups). */
export const BARE_OS_CTX_SCHEMA_HINT = {
  ctxApiVersion: BARE_OS_CTX_API_CLIENT_VERSION,
  primaryInterface: 'BareOsKernelContext',
  documentation: [
    'docs/reference/package-bare-os-protocol.md',
    'docs/reference/package-bare-os-booter.md',
    'developer-guide/02-the-context-object.md',
  ],
} as const
`

fs.mkdirSync(path.dirname(outPath), { recursive: true })
fs.writeFileSync(outPath, out, 'utf8')
process.stdout.write(out)