hono-apcore 0.1.0

package/dist/cli.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { writeFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { resolve as resolvePath } from 'node:path';
+import { formatModules } from 'apcore-toolkit';
+import { HonoApcore } from './core/apcore.js';
+import { HonoRouteScanner } from './scanners/hono-route-scanner.js';
+import { renderBindingsYaml, writeBindingsFile } from './output/yaml-writer.js';
+import { ApcoreMcpService } from './mcp/apcore-mcp.service.js';
+import { loadSettings, toMcpTransport } from './config.js';
+const USAGE = `hono-apcore — expose a Hono app as apcore modules
+
+Usage:
+  hono-apcore <command> <entry> [options]
+
+Commands:
+  scan     Scan the app's routes and print or write the module bindings
+  serve    Scan, then start an MCP server exposing the modules as tools
+  export   Write OpenAI-compatible tool definitions as JSON
+
+Entry:
+  <path>[:<export>]   Module to import. <export> defaults to "default", then "app".
+                      TypeScript entries need a loader, e.g.
+                        npx tsx node_modules/.bin/hono-apcore scan ./src/app.ts
+
+Options:
+  --out <file>        scan/export: write to this file instead of stdout
+  --format <fmt>      scan: yaml | json | markdown | table (default: table)
+  --transport <t>     serve: stdio | http | sse            (default: $APCORE_TRANSPORT)
+  --host <host>       serve: bind address                  (default: $APCORE_HOST)
+  --port <n>          serve: bind port                     (default: $APCORE_PORT)
+  --explorer          serve: enable the MCP Tool Explorer UI
+  --allow-execute     serve: allow tool execution from the Explorer
+  --name <name>       serve: MCP server name
+  --bindings <file>   Load additional modules from a YAML bindings file
+  --prefix <str>      Prefix prepended to generated module IDs
+  --include <regex>   Keep only module IDs matching this pattern
+  --exclude <regex>   Drop module IDs matching this pattern
+  -h, --help          Show this help
+  -v, --version       Show the package version
+`;
+function isHonoApp(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        Array.isArray(value.routes) &&
+        typeof value.request === 'function');
+}
+/**
+ * Duck-typed rather than `instanceof`: the entry may have been built against a
+ * different copy of this package (a workspace link, two versions in the tree),
+ * and a real instance under a second copy is still the instance the user meant.
+ */
+function isHonoApcore(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (typeof candidate.registerTool === 'function' &&
+        typeof candidate.scanRoutes === 'function' &&
+        typeof candidate.init === 'function' &&
+        candidate.registry !== undefined &&
+        candidate.executor !== undefined);
+}
+/**
+ * Import the entry module and work out which export is the Hono app and
+ * which — if any — is a pre-configured {@link HonoApcore}.
+ */
+async function resolveEntry(spec) {
+    const separator = spec.lastIndexOf(':');
+    // A Windows drive letter ("C:\...") is not an export separator.
+    const hasExport = separator > 1;
+    const modulePath = hasExport ? spec.slice(0, separator) : spec;
+    const exportName = hasExport ? spec.slice(separator + 1) : undefined;
+    const url = pathToFileURL(resolvePath(process.cwd(), modulePath)).href;
+    const mod = (await import(url));
+    const named = exportName ? mod[exportName] : undefined;
+    if (exportName && named === undefined) {
+        throw new Error(`Entry module "${modulePath}" has no export named "${exportName}".`);
+    }
+    const candidate = named ?? mod['default'] ?? mod['app'];
+    // A configured instance may be exported under any name — apps commonly call
+    // it `ap`, because `apcore` is already taken by the middleware import.
+    const instance = (isHonoApcore(candidate) ? candidate : undefined) ??
+        Object.values(mod).find(isHonoApcore) ??
+        new HonoApcore();
+    const app = isHonoApp(candidate)
+        ? candidate
+        : isHonoApp(mod['app'])
+            ? mod['app']
+            : isHonoApp(mod['default'])
+                ? mod['default']
+                : null;
+    return { instance, app };
+}
+/** Scan the app's routes without registering, for `scan` and `export` output. */
+function scanModules(app, options) {
+    if (!app)
+        return [];
+    return new HonoRouteScanner().scan(app, options);
+}
+/**
+ * Build the scan options for a command: the entry's own configuration first,
+ * then the CLI flags. A flag that was not passed leaves the entry's value
+ * alone, so `scan` reports the same modules the app itself registers.
+ */
+function routeOptions(values, instance) {
+    const base = instance?.routeOptions ?? {
+        modulePrefix: loadSettings().modulePrefix || undefined,
+        includePaths: loadSettings().includePaths,
+        excludePaths: loadSettings().excludePaths,
+    };
+    const overrides = {};
+    if (values['prefix'] !== undefined)
+        overrides.modulePrefix = values['prefix'];
+    if (values['include'] !== undefined)
+        overrides.include = values['include'];
+    if (values['exclude'] !== undefined)
+        overrides.exclude = values['exclude'];
+    return { ...base, ...overrides };
+}
+async function emit(content, out) {
+    if (out) {
+        await writeFile(out, content, 'utf-8');
+        process.stdout.write(`Wrote ${out}\n`);
+    }
+    else {
+        process.stdout.write(content.endsWith('\n') ? content : `${content}\n`);
+    }
+}
+async function commandScan(entry, values) {
+    const { app, instance } = await resolveEntry(entry);
+    if (!app) {
+        throw new Error('Entry module does not export a Hono app — nothing to scan.');
+    }
+    const modules = scanModules(app, routeOptions(values, instance));
+    const format = values['format'] ?? 'table';
+    const out = values['out'];
+    if (format === 'yaml') {
+        if (out) {
+            await writeBindingsFile(modules, out);
+            process.stdout.write(`Wrote ${out} (${modules.length} modules)\n`);
+            return;
+        }
+        await emit(renderBindingsYaml(modules));
+        return;
+    }
+    if (format === 'json') {
+        await emit(JSON.stringify(formatModules(modules, { style: 'json' }), null, 2), out);
+        return;
+    }
+    const style = format === 'markdown' ? 'markdown' : 'table-row';
+    await emit(String(formatModules(modules, { style })), out);
+}
+async function commandServe(entry, values) {
+    const { instance, app } = await resolveEntry(entry);
+    const settings = loadSettings();
+    await instance.init(app ?? undefined, routeOptions(values, instance));
+    if (values['bindings']) {
+        await instance.loadBindings(values['bindings']);
+    }
+    // A zero-config entry (a bare Hono app) still gets an MCP surface here, so
+    // `hono-apcore serve ./src/app.ts` works without touching the app's source.
+    const mcp = instance.mcp ?? new ApcoreMcpService(instance.registry, instance.executor, {});
+    const transport = toMcpTransport((values['transport'] ?? settings.transport));
+    const port = values['port'] !== undefined ? Number(values['port']) : undefined;
+    process.stderr.write(`hono-apcore: serving ${instance.registry.count} modules over ${transport}\n`);
+    await mcp.start({
+        transport,
+        host: values['host'],
+        port: Number.isFinite(port) ? port : undefined,
+        explorer: values['explorer'],
+        allowExecute: values['allow-execute'],
+        name: values['name'],
+    });
+}
+async function commandExport(entry, values) {
+    const { instance, app } = await resolveEntry(entry);
+    await instance.init(app ?? undefined, routeOptions(values, instance));
+    const mcp = instance.mcp ?? new ApcoreMcpService(instance.registry, instance.executor, {});
+    const tools = await mcp.toOpenaiTools();
+    await emit(JSON.stringify(tools, null, 2), values['out']);
+}
+/** Parse argv and dispatch. Exported so tests can drive the CLI directly. */
+export async function main(argv = process.argv.slice(2)) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            out: { type: 'string' },
+            format: { type: 'string' },
+            transport: { type: 'string' },
+            host: { type: 'string' },
+            port: { type: 'string' },
+            explorer: { type: 'boolean' },
+            'allow-execute': { type: 'boolean' },
+            name: { type: 'string' },
+            bindings: { type: 'string' },
+            prefix: { type: 'string' },
+            include: { type: 'string' },
+            exclude: { type: 'string' },
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'v' },
+        },
+    });
+    if (values.version) {
+        const { VERSION } = await import('apcore-js');
+        process.stdout.write(`hono-apcore (apcore-js ${VERSION})\n`);
+        return 0;
+    }
+    if (values.help || positionals.length === 0) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const [command, entry] = positionals;
+    if (!entry) {
+        process.stderr.write(`hono-apcore: "${command}" needs an entry module.\n\n${USAGE}`);
+        return 2;
+    }
+    switch (command) {
+        case 'scan':
+            await commandScan(entry, values);
+            return 0;
+        case 'serve':
+            await commandServe(entry, values);
+            return 0;
+        case 'export':
+            await commandExport(entry, values);
+            return 0;
+        default:
+            process.stderr.write(`hono-apcore: unknown command "${command}".\n\n${USAGE}`);
+            return 2;
+    }
+}
+const invokedDirectly = process.argv[1] !== undefined &&
+    import.meta.url === pathToFileURL(process.argv[1]).href;
+if (invokedDirectly) {
+    main()
+        .then((code) => {
+        if (code !== 0)
+            process.exitCode = code;
+    })
+        .catch((err) => {
+        process.stderr.write(`hono-apcore: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The canonical `APCORE_*` settings every apcore framework integration
+ * implements with identical names, types, and defaults.
+ *
+ * Values are read from `process.env` (or any object passed to
+ * {@link loadSettings}) and normalised into this camelCase shape.
+ */
+export interface ApcoreSettings {
+    /** `APCORE_ENABLED` — master switch. */
+    enabled: boolean;
+    /** `APCORE_DEBUG` — verbose logging / introspection. */
+    debug: boolean;
+    /** `APCORE_SCANNERS` — enabled scanner identifiers. */
+    scanners: string[];
+    /** `APCORE_INCLUDE_PATHS` — route patterns to include (empty = all). */
+    includePaths: string[];
+    /** `APCORE_EXCLUDE_PATHS` — route patterns to exclude. */
+    excludePaths: string[];
+    /** `APCORE_MODULE_PREFIX` — prefix prepended to generated module IDs. */
+    modulePrefix: string;
+    /** `APCORE_AUTH_ENABLED` — require auth for MCP/A2A endpoints. */
+    authEnabled: boolean;
+    /** `APCORE_AUTH_STRATEGY` — `bearer` / `session` / `custom`. */
+    authStrategy: 'bearer' | 'session' | 'custom';
+    /** `APCORE_TRANSPORT` — MCP transport: `stdio` / `http` / `sse`. */
+    transport: 'stdio' | 'http' | 'sse';
+    /** `APCORE_HOST` — bind address when transport is not stdio. */
+    host: string;
+    /** `APCORE_PORT` — bind port when transport is not stdio. */
+    port: number;
+}
+/** Authoritative defaults, shared across every apcore integration. */
+export declare const APCORE_SETTING_DEFAULTS: Readonly<ApcoreSettings>;
+/** Minimal shape of an environment source (`process.env` satisfies it). */
+export type EnvSource = Record<string, string | undefined>;
+/**
+ * Read the canonical `APCORE_*` settings from an environment source.
+ *
+ * Unset or unparseable variables fall back to {@link APCORE_SETTING_DEFAULTS}.
+ * `overrides` win over the environment, letting code configure the same
+ * knobs without mutating `process.env`.
+ *
+ * @param env - Environment source. Defaults to `process.env` when available.
+ * @param overrides - Values that take precedence over the environment.
+ */
+export declare function loadSettings(env?: EnvSource, overrides?: Partial<ApcoreSettings>): ApcoreSettings;
+/**
+ * Translate the canonical `APCORE_TRANSPORT` value to the transport name
+ * `apcore-mcp` expects.
+ *
+ * `"http"` is the ecosystem-wide spelling; `apcore-mcp` calls the same
+ * transport `"streamable-http"`.
+ */
+export declare function toMcpTransport(transport: ApcoreSettings['transport']): 'stdio' | 'streamable-http' | 'sse';
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wEAAwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,oEAAoE;IACpE,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACpC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAY3D,CAAC;AAEH,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAoC3D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,GAAG,GAAE,SAA6D,EAClE,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GACtC,cAAc,CA0BhB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,OAAO,GAAG,iBAAiB,GAAG,KAAK,CAErC"}

package/dist/config.js

@@ -0,0 +1,86 @@
+import { APCORE_ENV_PREFIX } from './constants.js';
+/** Authoritative defaults, shared across every apcore integration. */
+export const APCORE_SETTING_DEFAULTS = Object.freeze({
+    enabled: true,
+    debug: false,
+    scanners: ['auto'],
+    includePaths: [],
+    excludePaths: [],
+    modulePrefix: '',
+    authEnabled: false,
+    authStrategy: 'bearer',
+    transport: 'stdio',
+    host: '0.0.0.0',
+    port: 8808,
+});
+function parseBool(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const value = raw.trim().toLowerCase();
+    if (value === 'true' || value === '1' || value === 'yes' || value === 'on')
+        return true;
+    if (value === 'false' || value === '0' || value === 'no' || value === 'off')
+        return false;
+    return fallback;
+}
+function parseList(raw, fallback) {
+    if (raw === undefined)
+        return [...fallback];
+    const items = raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    return items;
+}
+function parsePort(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const value = Number.parseInt(raw, 10);
+    if (!Number.isInteger(value) || value < 0 || value > 65535)
+        return fallback;
+    return value;
+}
+function parseEnum(raw, allowed, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const value = raw.trim().toLowerCase();
+    return allowed.includes(value) ? value : fallback;
+}
+/**
+ * Read the canonical `APCORE_*` settings from an environment source.
+ *
+ * Unset or unparseable variables fall back to {@link APCORE_SETTING_DEFAULTS}.
+ * `overrides` win over the environment, letting code configure the same
+ * knobs without mutating `process.env`.
+ *
+ * @param env - Environment source. Defaults to `process.env` when available.
+ * @param overrides - Values that take precedence over the environment.
+ */
+export function loadSettings(env = typeof process !== 'undefined' ? process.env : {}, overrides = {}) {
+    const key = (name) => env[`${APCORE_ENV_PREFIX}${name}`];
+    const fromEnv = {
+        enabled: parseBool(key('ENABLED'), APCORE_SETTING_DEFAULTS.enabled),
+        debug: parseBool(key('DEBUG'), APCORE_SETTING_DEFAULTS.debug),
+        scanners: parseList(key('SCANNERS'), APCORE_SETTING_DEFAULTS.scanners),
+        includePaths: parseList(key('INCLUDE_PATHS'), APCORE_SETTING_DEFAULTS.includePaths),
+        excludePaths: parseList(key('EXCLUDE_PATHS'), APCORE_SETTING_DEFAULTS.excludePaths),
+        modulePrefix: key('MODULE_PREFIX') ?? APCORE_SETTING_DEFAULTS.modulePrefix,
+        authEnabled: parseBool(key('AUTH_ENABLED'), APCORE_SETTING_DEFAULTS.authEnabled),
+        authStrategy: parseEnum(key('AUTH_STRATEGY'), ['bearer', 'session', 'custom'], APCORE_SETTING_DEFAULTS.authStrategy),
+        transport: parseEnum(key('TRANSPORT'), ['stdio', 'http', 'sse'], APCORE_SETTING_DEFAULTS.transport),
+        host: key('HOST') ?? APCORE_SETTING_DEFAULTS.host,
+        port: parsePort(key('PORT'), APCORE_SETTING_DEFAULTS.port),
+    };
+    return { ...fromEnv, ...overrides };
+}
+/**
+ * Translate the canonical `APCORE_TRANSPORT` value to the transport name
+ * `apcore-mcp` expects.
+ *
+ * `"http"` is the ecosystem-wide spelling; `apcore-mcp` calls the same
+ * transport `"streamable-http"`.
+ */
+export function toMcpTransport(transport) {
+    return transport === 'http' ? 'streamable-http' : transport;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hono context variable key holding the {@link HonoApcore} instance.
+ *
+ * Read it with `c.get(APCORE_VAR)` — or, with types, via `getApcore(c)`.
+ */
+export declare const APCORE_VAR: "apcore";
+/**
+ * Hono context variable key holding the per-request apcore `Context`
+ * built by {@link HonoContextFactory}.
+ */
+export declare const APCORE_CONTEXT_VAR: "apcoreContext";
+/** Default path the embedded MCP endpoint is mounted at. */
+export declare const DEFAULT_MCP_ENDPOINT = "/mcp";
+/** Default URL prefix for the MCP Tool Explorer UI. */
+export declare const DEFAULT_EXPLORER_PREFIX = "/explorer";
+/**
+ * Sentinel header `@hono/node-server` looks for to learn that a handler has
+ * already written the response directly to the Node `ServerResponse`.
+ *
+ * Mirrors `RESPONSE_ALREADY_SENT` from `@hono/node-server/utils/response`;
+ * inlined so mounting MCP does not force a hard dependency on the Node
+ * adapter in edge builds.
+ */
+export declare const HONO_ALREADY_SENT_HEADER = "x-hono-already-sent";
+/** Environment-variable prefix for all `APCORE_*` settings. */
+export declare const APCORE_ENV_PREFIX = "APCORE_";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAG,QAAiB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAE3D,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,YAAY,CAAC"}

package/dist/constants.js

@@ -0,0 +1,27 @@
+/**
+ * Hono context variable key holding the {@link HonoApcore} instance.
+ *
+ * Read it with `c.get(APCORE_VAR)` — or, with types, via `getApcore(c)`.
+ */
+export const APCORE_VAR = 'apcore';
+/**
+ * Hono context variable key holding the per-request apcore `Context`
+ * built by {@link HonoContextFactory}.
+ */
+export const APCORE_CONTEXT_VAR = 'apcoreContext';
+/** Default path the embedded MCP endpoint is mounted at. */
+export const DEFAULT_MCP_ENDPOINT = '/mcp';
+/** Default URL prefix for the MCP Tool Explorer UI. */
+export const DEFAULT_EXPLORER_PREFIX = '/explorer';
+/**
+ * Sentinel header `@hono/node-server` looks for to learn that a handler has
+ * already written the response directly to the Node `ServerResponse`.
+ *
+ * Mirrors `RESPONSE_ALREADY_SENT` from `@hono/node-server/utils/response`;
+ * inlined so mounting MCP does not force a hard dependency on the Node
+ * adapter in edge builds.
+ */
+export const HONO_ALREADY_SENT_HEADER = 'x-hono-already-sent';
+/** Environment-variable prefix for all `APCORE_*` settings. */
+export const APCORE_ENV_PREFIX = 'APCORE_';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,QAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAwB,CAAC;AAE3D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,uDAAuD;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC"}

package/dist/context/hono-context.factory.d.ts

@@ -0,0 +1,61 @@
+import { Context as ApcoreContext } from 'apcore-js';
+import type { Identity } from 'apcore-js';
+/**
+ * Anything this factory can read request headers from.
+ *
+ * Covers a Hono `Context` (`c`), a raw web `Request`, a bare `Headers`
+ * instance, and the plain header record a Node handler sees — so the same
+ * factory serves routes, middleware, and tests.
+ */
+export type HeaderSource = Headers | Request | {
+    req: {
+        raw: Request;
+    };
+} | {
+    headers: Headers | Record<string, string | string[] | undefined>;
+};
+/**
+ * Reduce any {@link HeaderSource} to a `Headers` instance.
+ *
+ * `Headers` already matches header names case-insensitively, so downstream
+ * lookups need no normalisation of their own.
+ */
+export declare function toHeaders(source: HeaderSource): Headers;
+/**
+ * Builds apcore `Context` objects from Hono requests.
+ *
+ * **Identity resolution**, in order:
+ *   1. `x-user-id` header
+ *   2. `Authorization: Bearer <token>` (identity id `"bearer"`)
+ *   3. `x-roles` alone — a demo shortcut for role-based ACL without auth
+ *   4. anonymous
+ *
+ * **W3C Trace Context** — a `traceparent` header supplies the trace id.
+ * Strict 32-hex validation and rejection of W3C-invalid ids happen inside
+ * `Context.create`, not here (PROTOCOL_SPEC §10.5).
+ *
+ * **Correlation id** — `x-correlation-id` (or `x-request-id`) is copied into
+ * `context.data["x-correlation-id"]` so existing log pipelines keep working.
+ *
+ * Pass a `resolveIdentity` override to plug in real authentication: whatever
+ * it returns wins over the header heuristics above.
+ */
+export declare class HonoContextFactory {
+    private readonly options;
+    constructor(options?: {
+        /** Custom identity resolver; returning `null` falls back to the headers. */
+        resolveIdentity?: (headers: Headers) => Identity | null;
+        /** Extra `context.data` entries merged over the built-in ones. */
+        data?: (headers: Headers) => Record<string, unknown>;
+    });
+    /** Create an apcore `Context` from a Hono context, `Request`, or headers. */
+    createContext(source: HeaderSource): ApcoreContext;
+    private extractTraceParent;
+    private extractIdentity;
+    /** Parse the comma-separated `x-roles` header into a role list. */
+    private extractRoles;
+    private extractData;
+}
+/** Shared factory used by the default `apcore()` middleware. */
+export declare const defaultContextFactory: HonoContextFactory;
+//# sourceMappingURL=hono-context.factory.d.ts.map

package/dist/context/hono-context.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-context.factory.d.ts","sourceRoot":"","sources":["../../src/context/hono-context.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAgC,MAAM,WAAW,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,WAAW,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,OAAO,GACP;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,CAAC;AAWzE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAsBvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE;QACxB,4EAA4E;QAC5E,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CAAC;QACxD,kEAAkE;QAClE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjD;IAGR,6EAA6E;IAC7E,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAWlD,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,eAAe;IAyBvB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;CAQpB;AAED,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,oBAA2B,CAAC"}