shokupan 0.13.0 → 0.14.0

package/dist/surreal-w7DeGVI-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surreal-w7DeGVI-.js","sources":["../src/util/adapter/datastore/surreal.ts"],"sourcesContent":["import { RecordId, Surreal } from 'surrealdb';\nimport { createLogger } from '../../logger';\nimport type { DatastoreAdapter, QueryOptions } from '../datastore';\n\nexport interface SurrealAdapterOptions {\n    url?: string;\n    namespace?: string;\n    database?: string;\n    auth?: any;\n    engines?: any;\n    connectOptions?: any;\n}\n\nexport class SurrealAdapter implements DatastoreAdapter {\n    name = 'surrealdb';\n    private db: Surreal;\n    private logger = createLogger('surreal-adapter');\n    private options: SurrealAdapterOptions;\n\n    constructor(options: SurrealAdapterOptions = {}) {\n        this.options = options;\n        if (options.engines) {\n            this.db = new Surreal({ engines: options.engines });\n        } else {\n            this.db = new Surreal();\n        }\n\n        process.on(\"exit\", async () => {\n            await this.disconnect();\n        });\n    }\n\n    async connect(): Promise<void> {\n        let url = this.options.url;\n        if (!url) {\n            // Default behavior equivalent to old initDatastore\n            if (process.env.NODE_ENV === 'test') {\n                url = 'mem://';\n            } else {\n                url = 'surrealkv://database';\n            }\n        }\n\n        if (!this.options.engines && !url.match(/^(?:wss?|https?):\\/\\//)) {\n            try {\n                const mod = await import('@surrealdb/node');\n                this.db = new Surreal({ engines: mod.createNodeEngines() });\n            } catch (e) {\n                this.logger.warn('SurrealAdapter', \"Could not load @surrealdb/node engines. Embedded protocols might fail.\", { error: e });\n            }\n        }\n\n        await this.db.connect(url, this.options.connectOptions);\n\n        await this.db.use({\n            namespace: this.options.namespace ?? \"vendor\",\n            database: this.options.database ?? \"shokupan\"\n        });\n    }\n\n    async disconnect(): Promise<void> {\n        await this.db.close();\n    }\n\n    async setupSchema(): Promise<void> {\n        // Equivalent to old createSchema but generic tables if dynamic?\n        // Old code had hardcoded table defines. We should keep them for now or rely on \"SCHEMALESS\" \n        // SurrealDB is schemaless by default but defines help with performance/structure.\n        // We'll reimplement the base defines.\n\n        await this.db.query(`\n            DEFINE TABLE OVERWRITE failed_requests SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE sessions SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE users SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE idempotency_keys SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE middleware_tracking SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE requests SCHEMALESS COMMENT \"Created by Shokupan\";\n            DEFINE TABLE OVERWRITE metrics SCHEMALESS COMMENT \"Created by Shokupan\";\n        `);\n    }\n\n    private retry<T>(fn: () => Promise<T>): Promise<T> {\n        return fn().catch(err => {\n            if (err?.message?.includes('This transaction can be retried')) {\n                return fn();\n            }\n            throw err;\n        });\n    }\n\n    async get<T>(table: string, id: string): Promise<T | null> {\n        try {\n            const result = await this.db.select<T>(new RecordId(table, id));\n            // SurrealDB select typically returns the object, or throws if connection fails.\n            // If ID not found, it might return undefined or null or error depending on version.\n            // Recent JS SDK: select returns T (single) or T[] (if variable).\n            // But if it returns undefined/null, we return null.\n            if (Array.isArray(result)) return result[0] || null;\n            return result as T || null;\n        } catch (error) {\n            // If it throws because of not found (some older versions), return null.\n            // Or log real error? generic get should probably return null if not found.\n            return null;\n        }\n    }\n\n    async create<T>(table: string, id: string, data: T): Promise<T> {\n        return this.retry(() => this.db.create(new RecordId(table, id)).content(data as any)) as any;\n    }\n\n    async update<T>(table: string, id: string, data: Partial<T>): Promise<T> {\n        return this.retry(() => this.db.update(new RecordId(table, id)).merge(data as any)) as any;\n    }\n\n    async upsert<T>(table: string, id: string, data: T): Promise<T> {\n        // SurrealDB .upsert() replaces content. If we want merge-like upsert behavior we might need logic,\n        // but typically upsert means \"insert or replace\".\n        return this.retry(() => this.db.upsert(new RecordId(table, id)).content(data as any)) as any;\n    }\n\n    async delete(table: string, id: string): Promise<void> {\n        await this.retry(() => this.db.delete(new RecordId(table, id)));\n    }\n\n    async count(table: string, query?: QueryOptions): Promise<number> {\n        const q = this.buildQuery(table, query, true);\n        const res = await this.db.query<[{ count: number; }]>(q.statement, q.vars);\n\n        const result = res as any; // Cast to inspect\n        this.logger.debug('SurrealAdapter', \"Count Result\", { result });\n\n        // Defensive coding:\n        if (Array.isArray(result) && result.length > 0) {\n            const first = result[0];\n\n            // 1. Nested array result (common in query()): [[{ count: N }]]\n            if (Array.isArray(first)) {\n                if (first[0]?.count !== undefined) return first[0].count;\n            }\n\n            // 2. Direct result: [{ count: N }]\n            if (first?.count !== undefined) return first.count;\n\n            // 3. Result wrapper: [{ result: [{ count: N }], status: \"OK\" }]\n            if (first?.result && Array.isArray(first.result)) {\n                const inner = first.result[0];\n                if (inner?.count !== undefined) return inner.count;\n            }\n        }\n\n        return 0;\n    }\n\n    async deleteMany(table: string, query?: QueryOptions): Promise<void> {\n        const q = this.buildQuery(table, query, false, true);\n        await this.db.query(q.statement, q.vars);\n    }\n\n    async findMany<T>(table: string, query?: QueryOptions): Promise<T[]> {\n        const q = this.buildQuery(table, query);\n        try {\n            const res = await this.db.query<T[]>(q.statement, q.vars);\n\n            // Robust result extraction\n            let result: any = res;\n            if (Array.isArray(res) && res.length > 0) {\n                if (Array.isArray(res[0])) result = res[0];\n                else if ((res[0] as any).result && Array.isArray((res[0] as any).result)) result = (res[0] as any).result;\n                else result = res[0] || [];\n            }\n\n            return (Array.isArray(result) ? result : []) as T[];\n        } catch (e) {\n            this.logger.error('SurrealAdapter', `findMany ${table} failed`, e);\n            throw e;\n        }\n    }\n\n    private buildQuery(table: string, options?: QueryOptions, isCount = false, isDelete = false): { statement: string, vars: any; } {\n        // Basic query builder\n        let type = isDelete ? 'DELETE' : 'SELECT';\n        let fields = isDelete ? '' : (isCount ? 'count()' : '*');\n        let from = `FROM type::table($table)`;\n        let vars: any = { table };\n        let clauses: string[] = [];\n\n        if (options?.where) {\n            Object.entries(options.where).forEach(([k, v], i) => {\n                const varName = `where_${i}`;\n                clauses.push(`${k} = $${varName}`);\n                vars[varName] = v;\n            });\n        }\n\n        if (options?.gt) {\n            Object.entries(options.gt).forEach(([k, v], i) => {\n                const varName = `gt_${i}`;\n                clauses.push(`${k} > $${varName}`);\n                vars[varName] = v;\n            });\n        }\n\n        if (options?.lt) {\n            Object.entries(options.lt).forEach(([k, v], i) => {\n                const varName = `lt_${i}`;\n                clauses.push(`${k} < $${varName}`);\n                vars[varName] = v;\n            });\n        }\n\n        let whereStr = clauses.length ? 'WHERE ' + clauses.join(' AND ') : '';\n\n        let suffix = '';\n        if (!isCount && !isDelete) {\n            if (options?.sort) {\n                const sorts = Object.entries(options.sort).map(([k, v]) => `${k} ${v.toUpperCase()}`);\n                if (sorts.length) suffix += ` ORDER BY ${sorts.join(', ')}`;\n            }\n            if (options?.limit) {\n                suffix += ` LIMIT ${options.limit}`;\n            }\n            if (options?.offset) {\n                suffix += ` START ${options.offset}`;\n            }\n        }\n\n        // Handle Delete LIMIT separately because DELETE statements support LIMIT\n        if (isDelete) {\n            // Surreal DELETE supports WHERE ... \n            // Does it support LIMIT? Yes: DELETE user WHERE ... LIMIT 10\n            // Does it support ORDER BY? Yes.\n            if (options?.sort) {\n                const sorts = Object.entries(options.sort).map(([k, v]) => `${k} ${v.toUpperCase()}`);\n                if (sorts.length) suffix += ` ORDER BY ${sorts.join(', ')}`;\n            }\n            if (options?.limit) {\n                suffix += ` LIMIT ${options.limit}`;\n            }\n        }\n\n        // isDelete format: DELETE [FROM] table WHERE ...\n        // SurrealQL: DELETE table WHERE ...\n        if (isDelete) {\n            return {\n                statement: `DELETE type::table($table) ${whereStr}${suffix};`,\n                vars\n            };\n        }\n\n        const groupAll = isCount ? 'GROUP ALL' : '';\n\n        return {\n            statement: `SELECT ${fields} ${from} ${whereStr} ${groupAll} ${suffix};`,\n            vars\n        };\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/util/adapter/datastore/knex.d.ts

@@ -0,0 +1,29 @@
+import { Knex } from 'knex';
+import { DatastoreAdapter, QueryOptions } from '../datastore';
+export interface KnexAdapterOptions extends Knex.Config {
+}
+export declare class KnexAdapter implements DatastoreAdapter {
+    private options;
+    name: string;
+    private db;
+    private logger;
+    private jsonColumnType;
+    constructor(options: KnexAdapterOptions);
+    connect(): Promise<void>;
+    private detectDialectFeatures;
+    disconnect(): Promise<void>;
+    setupSchema(): Promise<void>;
+    private ensureTable;
+    private jsonRef;
+    get<T>(table: string, id: string): Promise<T | null>;
+    create<T>(table: string, id: string, data: T): Promise<T>;
+    update<T>(table: string, id: string, data: Partial<T>): Promise<T>;
+    upsert<T>(table: string, id: string, data: T): Promise<T>;
+    delete(table: string, id: string): Promise<void>;
+    count(table: string, query?: QueryOptions): Promise<number>;
+    deleteMany(table: string, query?: QueryOptions): Promise<void>;
+    private findManyIDs;
+    findMany<T>(table: string, query?: QueryOptions): Promise<T[]>;
+    private applyFilters;
+    private applyQuery;
+}

package/dist/util/adapter/datastore/level.d.ts

@@ -0,0 +1,26 @@
+import { DatastoreAdapter, QueryOptions } from '../datastore';
+export declare class LevelAdapter implements DatastoreAdapter {
+    private options;
+    name: string;
+    private db;
+    private logger;
+    constructor(options?: {
+        location?: string;
+        db?: any;
+    });
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    setupSchema(): Promise<void>;
+    private getKey;
+    get<T>(table: string, id: string): Promise<T | null>;
+    create<T>(table: string, id: string, data: T): Promise<T>;
+    update<T>(table: string, id: string, data: Partial<T>): Promise<T>;
+    upsert<T>(table: string, id: string, data: T): Promise<T>;
+    delete(table: string, id: string): Promise<void>;
+    count(table: string, query?: QueryOptions): Promise<number>;
+    deleteMany(table: string, query?: QueryOptions): Promise<void>;
+    findMany<T>(table: string, query?: QueryOptions): Promise<T[]>;
+    private scan;
+    private matches;
+    private applySortLimit;
+}

package/dist/util/adapter/datastore/sqlite.d.ts

@@ -0,0 +1,24 @@
+import { DatastoreAdapter, QueryOptions } from '../datastore';
+export declare class SqliteAdapter implements DatastoreAdapter {
+    private options;
+    name: string;
+    private db;
+    private logger;
+    private tables;
+    constructor(options?: {
+        filename?: string;
+    });
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    setupSchema(): Promise<void>;
+    private ensureTable;
+    get<T>(table: string, id: string): Promise<T | null>;
+    create<T>(table: string, id: string, data: T): Promise<T>;
+    update<T>(table: string, id: string, data: Partial<T>): Promise<T>;
+    upsert<T>(table: string, id: string, data: T): Promise<T>;
+    delete(table: string, id: string): Promise<void>;
+    count(table: string, query?: QueryOptions): Promise<number>;
+    deleteMany(table: string, query?: QueryOptions): Promise<void>;
+    findMany<T>(table: string, query?: QueryOptions): Promise<T[]>;
+    private buildWhere;
+}

package/dist/util/adapter/datastore/surreal.d.ts

@@ -0,0 +1,29 @@
+import { DatastoreAdapter, QueryOptions } from '../datastore';
+export interface SurrealAdapterOptions {
+    url?: string;
+    namespace?: string;
+    database?: string;
+    auth?: any;
+    engines?: any;
+    connectOptions?: any;
+}
+export declare class SurrealAdapter implements DatastoreAdapter {
+    name: string;
+    private db;
+    private logger;
+    private options;
+    constructor(options?: SurrealAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    setupSchema(): Promise<void>;
+    private retry;
+    get<T>(table: string, id: string): Promise<T | null>;
+    create<T>(table: string, id: string, data: T): Promise<T>;
+    update<T>(table: string, id: string, data: Partial<T>): Promise<T>;
+    upsert<T>(table: string, id: string, data: T): Promise<T>;
+    delete(table: string, id: string): Promise<void>;
+    count(table: string, query?: QueryOptions): Promise<number>;
+    deleteMany(table: string, query?: QueryOptions): Promise<void>;
+    findMany<T>(table: string, query?: QueryOptions): Promise<T[]>;
+    private buildQuery;
+}

package/dist/util/adapter/datastore.d.ts

@@ -0,0 +1,59 @@
+export interface QueryOptions {
+    /**
+     * strict equality matches
+     */
+    where?: Record<string, any>;
+    /**
+     * less than matches
+     */
+    lt?: Record<string, number | string>;
+    /**
+     * greater than matches
+     */
+    gt?: Record<string, number | string>;
+    /**
+     * sort results by field
+     */
+    sort?: Record<string, 'asc' | 'desc'>;
+    limit?: number;
+    offset?: number;
+}
+export interface DatastoreAdapter {
+    name: string;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    setupSchema(): Promise<void>;
+    /**
+     * Get a single record by global ID (table + id)
+     */
+    get<T>(table: string, id: string): Promise<T | null>;
+    /**
+     * Create a new record. Fails if exists.
+     */
+    create<T>(table: string, id: string, data: T): Promise<T>;
+    /**
+     * Update an existing record. Fails if not exists.
+     * Merges data.
+     */
+    update<T>(table: string, id: string, data: Partial<T>): Promise<T>;
+    /**
+     * Create or update a record.
+     */
+    upsert<T>(table: string, id: string, data: T): Promise<T>;
+    /**
+     * Delete a single record
+     */
+    delete(table: string, id: string): Promise<void>;
+    /**
+     * Count records matching query
+     */
+    count(table: string, query?: QueryOptions): Promise<number>;
+    /**
+     * Delete multiple records matching query
+     */
+    deleteMany(table: string, query?: QueryOptions): Promise<void>;
+    /**
+     * Find multiple records matching query
+     */
+    findMany<T>(table: string, query?: QueryOptions): Promise<T[]>;
+}

package/dist/util/adapter/h3.d.ts

@@ -0,0 +1,8 @@
+import { Server } from 'bun';
+import { Shokupan } from '../../shokupan';
+import { ServerAdapter } from './interface';
+export declare class H3Adapter implements ServerAdapter {
+    private nodeServer?;
+    listen(port: number, app: Shokupan): Promise<Server<any>>;
+    stop(): Promise<void>;
+}

package/dist/util/adapter/index.d.ts

@@ -1,4 +1,5 @@
 export * from './bun';
+export * from './h3';
 export * from './interface';
 export * from './node';
 export * from './wintercg';

package/dist/util/ast-analyzer-worker.d.ts

@@ -0,0 +1,77 @@
+import { EventEmitter } from 'events';
+export type ASTAnalyzerState = 'idle' | 'analyzing' | 'completed' | 'failed';
+export interface ASTAnalyzerResult {
+    applications: any[];
+}
+export interface ASTAnalyzerEvents {
+    'started': () => void;
+    'completed': (result: ASTAnalyzerResult) => void;
+    'failed': (error: Error) => void;
+    'progress': (message: string) => void;
+}
+/**
+ * Worker-based AST analyzer that runs TypeScript analysis in a separate thread.
+ * This prevents blocking the main event loop during intensive AST parsing.
+ */
+export declare class ASTAnalyzerWorker extends EventEmitter {
+    private state;
+    private result;
+    private error;
+    private worker;
+    private analysisPromise;
+    private rootDir;
+    private entrypoint?;
+    private timeout;
+    private startTime;
+    constructor(rootDir: string, entrypoint?: string, timeout?: number);
+    /**
+     * Get the current state of the analyzer.
+     */
+    getState(): ASTAnalyzerState;
+    /**
+     * Get the cached result if analysis completed successfully.
+     */
+    getResult(): ASTAnalyzerResult | null;
+    /**
+     * Get the error if analysis failed.
+     */
+    getError(): Error | null;
+    /**
+     * Check if analysis is currently running.
+     */
+    isAnalyzing(): boolean;
+    /**
+     * Check if analysis has completed successfully.
+     */
+    isCompleted(): boolean;
+    /**
+     * Check if analysis has failed.
+     */
+    isFailed(): boolean;
+    /**
+     * Get analysis duration in milliseconds (if completed or failed).
+     */
+    getDuration(): number | null;
+    /**
+     * Start AST analysis in a worker thread.
+     * Returns immediately and emits events as analysis progresses.
+     */
+    analyze(): Promise<ASTAnalyzerResult>;
+    /**
+     * Wait for analysis to complete (if it's running) or return immediately if already done.
+     */
+    waitForCompletion(): Promise<ASTAnalyzerResult>;
+    /**
+     * Terminate the worker thread if running.
+     */
+    terminate(): void;
+}
+/**
+ * Get or create the global AST analyzer instance.
+ * This ensures all plugins share the same analysis results.
+ */
+export declare function getGlobalAnalyzer(rootDir?: string, entrypoint?: string, timeout?: number): ASTAnalyzerWorker;
+/**
+ * Reset the global analyzer instance (useful for testing).
+ */
+export declare function resetGlobalAnalyzer(): void;

package/dist/util/ast-worker-thread.d.ts

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

package/dist/util/cookie-parser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fast Cookie Parser
+ *
+ * Optimized for speed by minimizing allocations and avoiding regex/split.
+ */
+export declare function parseCookies(str: string): Record<string, string>;

package/dist/util/env-loader.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from './logger';
 export type EnvLoaderOptions = {
     /**
      * If provided, k8s secrets will be loaded from the given paths
@@ -9,6 +10,10 @@ export type EnvLoaderOptions = {
      * @default []
      */
     k8sConfigMapMountPaths?: string[];
+    /**
+     * Optional logger instance
+     */
+    logger?: Logger;
 };
 type Listener<T> = (value: T) => void;
 /**
@@ -50,6 +55,7 @@ declare const $secretSubjects: unique symbol;
 declare const $options: unique symbol;
 declare const $watchers: unique symbol;
 declare const $watchersStarted: unique symbol;
+declare const $logger: unique symbol;
 declare const $getSecretValueInternal: unique symbol;
 declare const $getOrCreateSubject: unique symbol;
 declare const $loadSecrets: unique symbol;
@@ -65,6 +71,7 @@ export declare abstract class EnvLoader {
     private [$options];
     private [$watchers];
     private [$watchersStarted];
+    private [$logger];
     constructor(options?: EnvLoaderOptions);
     /**
      * Initialize the loader: read secrets.

package/dist/util/html.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Escapes unsafe characters in a string for use in HTML using named character references.
+ *
+ * @param unsafe - The input value to escape. If not a string, it will be coerced to one.
+ * @returns The escaped string.
+ */
+export declare function escapeHtml(unsafe: unknown): string;
+/**
+ * Safely serializes data to JSON for embedding in a <script> tag.
+ * Prevents Script Injection via </script> tags.
+ *
+ * @param data - The data to serialize.
+ * @returns The JSON string with </script> escaped.
+ */
+export declare function safeScriptJson(data: any): string;

package/dist/util/ide.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utility for generating links to open files in various editors.
+ * Controlled by the `IDE` environment variable or app-level configuration.
+ */
+export declare function configureIde(config: {
+    ide?: string;
+}): void;
+export declare function getEditorLinkPattern(): string;
+export declare function generateEditorLink(filePath: string, line?: number, column?: number): string;

package/dist/util/logger.d.ts

@@ -0,0 +1,25 @@
+export interface Logger {
+    debug(module: string, msg: string, props?: Record<string, any>): void;
+    info(module: string, msg: string, props?: Record<string, any>): void;
+    warn(module: string, msg: string, props?: Record<string, any>): void;
+    error(module: string, msg: string, props?: Record<string, any>): void;
+    fatal(module: string, msg: string, props?: Record<string, any>): void;
+}
+export declare class JsonLogger implements Logger {
+    private write;
+    debug(module: string, msg: string, props?: Record<string, any>): void;
+    info(module: string, msg: string, props?: Record<string, any>): void;
+    warn(module: string, msg: string, props?: Record<string, any>): void;
+    error(module: string, msg: string, props?: Record<string, any>): void;
+    fatal(module: string, msg: string, props?: Record<string, any>): void;
+}
+export declare class ConsolaLogger implements Logger {
+    private consola;
+    constructor(level?: number);
+    debug(module: string, msg: string, props?: Record<string, any>): void;
+    info(module: string, msg: string, props?: Record<string, any>): void;
+    warn(module: string, msg: string, props?: Record<string, any>): void;
+    error(module: string, msg: string, props?: Record<string, any>): void;
+    fatal(module: string, msg: string, props?: Record<string, any>): void;
+}
+export declare function createLogger(env?: string): Logger;

package/dist/util/query-string.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Fast Querystring Parser
+ *
+ * Optimized for speed by minimizing allocations and avoiding regex.
+ * Benchmarked faster than 'fast-querystring' and significantly faster than native 'URLSearchParams'.
+ */
+export type QueryParserMode = 'simple' | 'extended' | 'strict';
+export declare function parseQuery(url: string, mode?: QueryParserMode): Record<string, any>;

package/dist/util/response-transformer.d.ts

@@ -0,0 +1,87 @@
+import { BodyInit } from 'bun';
+/**
+ * Response transformer function
+ * Converts data to a specific format and returns response metadata
+ */
+export interface ResponseTransformer {
+    /**
+     * MIME type(s) this transformer handles
+     * Can be a string or array of strings
+     */
+    contentType: string | string[];
+    /**
+     * Serialize the data
+     * @param data The data to serialize
+     * @returns Serialized body and optional headers
+     */
+    serialize: (data: any) => {
+        body: BodyInit;
+        headers?: Record<string, string>;
+    } | Promise<{
+        body: BodyInit;
+        headers?: Record<string, string>;
+    }>;
+    /**
+     * Optional: Quality value for content negotiation (0-1)
+     * Higher values = preferred format when multiple matches exist
+     */
+    quality?: number;
+}
+/**
+ * Response transformer registry
+ * Manages registered transformers and performs content negotiation
+ */
+export declare class ResponseTransformerRegistry {
+    private transformers;
+    private defaultTransformer?;
+    /**
+     * Register a response transformer
+     * @param transformer The transformer to register
+     */
+    register(transformer: ResponseTransformer): void;
+    /**
+     * Get a transformer by exact content type match
+     * @param contentType The content type to look up
+     * @returns The transformer or undefined
+     */
+    getTransformer(contentType: string): ResponseTransformer | undefined;
+    /**
+     * Set the default transformer content type
+     * @param contentType The content type to use as default
+     */
+    setDefault(contentType: string): void;
+    /**
+     * Get the default transformer
+     * @returns The default transformer or undefined
+     */
+    getDefault(): ResponseTransformer | undefined;
+    /**
+     * Perform content negotiation based on Accept header
+     * @param acceptHeader The Accept header value
+     * @returns The best matching transformer or undefined
+     */
+    negotiate(acceptHeader: string): ResponseTransformer | undefined;
+    /**
+     * Parse Accept header into structured entries
+     * @param acceptHeader The Accept header value
+     * @returns Array of parsed accept entries
+     */
+    private parseAcceptHeader;
+    /**
+     * Find exact content type match
+     * @param accept The accept entry to match
+     * @returns The matching transformer or undefined
+     */
+    private findExactMatch;
+    /**
+     * Find wildcard content type match
+     * @param accept The accept entry to match
+     * @returns The matching transformer or undefined
+     */
+    private findWildcardMatch;
+    /**
+     * Get all registered content types
+     * @returns Array of registered content types
+     */
+    getRegisteredTypes(): string[];
+}

package/dist/util/symbol.d.ts

@@ -14,6 +14,7 @@ export declare const $mountPath: unique symbol;
 export declare const $dispatch: unique symbol;
 export declare const $routes: unique symbol;
 export declare const $routeSpec: unique symbol;
+export declare const $controllerHooks: unique symbol;
 export declare const $url: unique symbol;
 export declare const $requestId: unique symbol;
 export declare const $debug: unique symbol;