kontract 0.1.0

package/dist/response/helpers.d.ts

@@ -0,0 +1,132 @@
+import type { TSchema, Static } from '@sinclair/typebox';
+import type { ApiResponse, BinaryResponse, ApiErrorBody } from './types.js';
+import { type ValidationErrorDetail } from '../errors/validation.js';
+/**
+ * Configuration for response helpers.
+ * Set by the framework configuration.
+ */
+export interface ResponseConfig {
+    /**
+     * Whether to validate responses at runtime.
+     * Recommended: true in development, false in production.
+     */
+    validateResponses: boolean;
+    /**
+     * Validator function for response data.
+     * Should throw or return errors array on failure.
+     */
+    validator?: (schema: TSchema, data: unknown) => ValidationErrorDetail[] | void;
+}
+/**
+ * Configure response helpers.
+ * Called by the framework adapter during setup.
+ */
+export declare function configureResponses(newConfig: Partial<ResponseConfig>): void;
+/**
+ * Get current response configuration.
+ */
+export declare function getResponseConfig(): ResponseConfig;
+/**
+ * Core response builder with optional runtime validation.
+ *
+ * In development (validateResponses: true), validates that the data matches
+ * the schema to catch contract violations early.
+ */
+export declare function respond<TStatus extends number, TResponseSchema extends TSchema>(status: TStatus, schema: TResponseSchema, data: Static<TResponseSchema>): ApiResponse<TStatus, Static<TResponseSchema>>;
+/**
+ * Return 200 OK with validated response body.
+ */
+export declare function ok<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<200, Static<T>>;
+/**
+ * Return 201 Created with validated response body.
+ */
+export declare function created<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<201, Static<T>>;
+/**
+ * Return 202 Accepted with validated response body.
+ */
+export declare function accepted<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<202, Static<T>>;
+/**
+ * Return 204 No Content.
+ */
+export declare function noContent(): ApiResponse<204, null>;
+/**
+ * Return 400 Bad Request.
+ */
+export declare function badRequest<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<400, Static<T>>;
+/**
+ * Return 401 Unauthorized.
+ */
+export declare function unauthorized<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<401, Static<T>>;
+/**
+ * Return 403 Forbidden.
+ */
+export declare function forbidden<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<403, Static<T>>;
+/**
+ * Return 404 Not Found.
+ */
+export declare function notFound<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<404, Static<T>>;
+/**
+ * Return 409 Conflict.
+ */
+export declare function conflict<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<409, Static<T>>;
+/**
+ * Return 422 Unprocessable Entity (validation errors).
+ */
+export declare function unprocessableEntity<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<422, Static<T>>;
+/**
+ * Return 429 Too Many Requests.
+ */
+export declare function tooManyRequests<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<429, Static<T>>;
+/**
+ * Return 500 Internal Server Error.
+ */
+export declare function internalServerError<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<500, Static<T>>;
+/**
+ * Return 502 Bad Gateway.
+ */
+export declare function badGateway<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<502, Static<T>>;
+/**
+ * Return 503 Service Unavailable.
+ */
+export declare function serviceUnavailable<T extends TSchema>(schema: T, data: Static<T>): ApiResponse<503, Static<T>>;
+/**
+ * Return a binary/file response for downloads.
+ */
+export declare function binary<TStatus extends number>(status: TStatus, contentType: string, data: Buffer | string, filename?: string): BinaryResponse<TStatus>;
+/**
+ * Unified API error response helpers with sensible defaults.
+ * Returns responses matching the standard ApiErrorBody structure.
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * return apiError.notFound()              // "Resource not found"
+ * return apiError.unauthorized()          // "Authentication required"
+ *
+ * // Override message
+ * return apiError.notFound('Book not found')
+ * return apiError.serviceUnavailable('API is not configured')
+ *
+ * // Validation errors
+ * return apiError.validation([
+ *   { field: 'email', message: 'Invalid email format' },
+ * ])
+ * ```
+ */
+export declare const apiError: {
+    badRequest: (message?: string) => ApiResponse<400, ApiErrorBody>;
+    unauthorized: (message?: string) => ApiResponse<401, ApiErrorBody>;
+    forbidden: (message?: string) => ApiResponse<403, ApiErrorBody>;
+    notFound: (message?: string) => ApiResponse<404, ApiErrorBody>;
+    validation: (errors: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>) => ApiResponse<422, ApiErrorBody>;
+    conflict: (message?: string) => ApiResponse<409, ApiErrorBody>;
+    rateLimited: (message?: string) => ApiResponse<429, ApiErrorBody>;
+    internal: (message?: string) => ApiResponse<500, ApiErrorBody>;
+    serviceUnavailable: (message?: string) => ApiResponse<503, ApiErrorBody>;
+    externalApi: (message?: string) => ApiResponse<502, ApiErrorBody>;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/response/helpers.d.ts.map

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

package/dist/response/helpers.js

@@ -0,0 +1,197 @@
+import { ErrorCodes } from './types.js';
+import { ResponseValidationError } from '../errors/validation.js';
+let config = {
+    validateResponses: false,
+};
+/**
+ * Configure response helpers.
+ * Called by the framework adapter during setup.
+ */
+export function configureResponses(newConfig) {
+    config = { ...config, ...newConfig };
+}
+/**
+ * Get current response configuration.
+ */
+export function getResponseConfig() {
+    return config;
+}
+/**
+ * Core response builder with optional runtime validation.
+ *
+ * In development (validateResponses: true), validates that the data matches
+ * the schema to catch contract violations early.
+ */
+export function respond(status, schema, data) {
+    if (config.validateResponses && config.validator) {
+        // Validate the serialized form (what actually gets sent)
+        const serialized = JSON.parse(JSON.stringify(data));
+        const errors = config.validator(schema, serialized);
+        if (errors && errors.length > 0) {
+            throw new ResponseValidationError(schema, data, errors);
+        }
+    }
+    return { status, data };
+}
+// ============ Success Helpers ============
+/**
+ * Return 200 OK with validated response body.
+ */
+export function ok(schema, data) {
+    return respond(200, schema, data);
+}
+/**
+ * Return 201 Created with validated response body.
+ */
+export function created(schema, data) {
+    return respond(201, schema, data);
+}
+/**
+ * Return 202 Accepted with validated response body.
+ */
+export function accepted(schema, data) {
+    return respond(202, schema, data);
+}
+/**
+ * Return 204 No Content.
+ */
+export function noContent() {
+    return { status: 204, data: null };
+}
+// ============ Error Helpers ============
+/**
+ * Return 400 Bad Request.
+ */
+export function badRequest(schema, data) {
+    return respond(400, schema, data);
+}
+/**
+ * Return 401 Unauthorized.
+ */
+export function unauthorized(schema, data) {
+    return respond(401, schema, data);
+}
+/**
+ * Return 403 Forbidden.
+ */
+export function forbidden(schema, data) {
+    return respond(403, schema, data);
+}
+/**
+ * Return 404 Not Found.
+ */
+export function notFound(schema, data) {
+    return respond(404, schema, data);
+}
+/**
+ * Return 409 Conflict.
+ */
+export function conflict(schema, data) {
+    return respond(409, schema, data);
+}
+/**
+ * Return 422 Unprocessable Entity (validation errors).
+ */
+export function unprocessableEntity(schema, data) {
+    return respond(422, schema, data);
+}
+/**
+ * Return 429 Too Many Requests.
+ */
+export function tooManyRequests(schema, data) {
+    return respond(429, schema, data);
+}
+/**
+ * Return 500 Internal Server Error.
+ */
+export function internalServerError(schema, data) {
+    return respond(500, schema, data);
+}
+/**
+ * Return 502 Bad Gateway.
+ */
+export function badGateway(schema, data) {
+    return respond(502, schema, data);
+}
+/**
+ * Return 503 Service Unavailable.
+ */
+export function serviceUnavailable(schema, data) {
+    return respond(503, schema, data);
+}
+// ============ Binary Response ============
+/**
+ * Return a binary/file response for downloads.
+ */
+export function binary(status, contentType, data, filename) {
+    return { status, binary: true, contentType, data, filename };
+}
+// ============ Unified apiError Helpers ============
+/**
+ * Unified API error response helpers with sensible defaults.
+ * Returns responses matching the standard ApiErrorBody structure.
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * return apiError.notFound()              // "Resource not found"
+ * return apiError.unauthorized()          // "Authentication required"
+ *
+ * // Override message
+ * return apiError.notFound('Book not found')
+ * return apiError.serviceUnavailable('API is not configured')
+ *
+ * // Validation errors
+ * return apiError.validation([
+ *   { field: 'email', message: 'Invalid email format' },
+ * ])
+ * ```
+ */
+export const apiError = {
+    badRequest: (message = 'Bad request') => ({
+        status: 400,
+        data: { status: 400, code: ErrorCodes.BAD_REQUEST, message },
+    }),
+    unauthorized: (message = 'Authentication required') => ({
+        status: 401,
+        data: { status: 401, code: ErrorCodes.UNAUTHORIZED, message },
+    }),
+    forbidden: (message = 'Access denied') => ({
+        status: 403,
+        data: { status: 403, code: ErrorCodes.FORBIDDEN, message },
+    }),
+    notFound: (message = 'Resource not found') => ({
+        status: 404,
+        data: { status: 404, code: ErrorCodes.NOT_FOUND, message },
+    }),
+    validation: (errors) => ({
+        status: 422,
+        data: {
+            status: 422,
+            code: ErrorCodes.VALIDATION,
+            message: 'Validation failed',
+            errors,
+        },
+    }),
+    conflict: (message = 'Resource conflict') => ({
+        status: 409,
+        data: { status: 409, code: ErrorCodes.CONFLICT, message },
+    }),
+    rateLimited: (message = 'Too many requests') => ({
+        status: 429,
+        data: { status: 429, code: ErrorCodes.RATE_LIMITED, message },
+    }),
+    internal: (message = 'Internal server error') => ({
+        status: 500,
+        data: { status: 500, code: ErrorCodes.INTERNAL, message },
+    }),
+    serviceUnavailable: (message = 'Service unavailable') => ({
+        status: 503,
+        data: { status: 503, code: ErrorCodes.SERVICE_UNAVAILABLE, message },
+    }),
+    externalApi: (message = 'External API error') => ({
+        status: 502,
+        data: { status: 502, code: ErrorCodes.EXTERNAL_API, message },
+    }),
+};
+//# sourceMappingURL=helpers.js.map

package/dist/response/helpers.js.map

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

package/dist/response/index.d.ts

@@ -0,0 +1,4 @@
+export type { ApiResponse, BinaryResponse, AnyResponse, ApiErrorBody, ErrorCode, } from './types.js';
+export { isBinaryResponse, ErrorCodes } from './types.js';
+export { configureResponses, getResponseConfig, respond, ok, created, accepted, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, badGateway, serviceUnavailable, binary, apiError, type ResponseConfig, } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/response/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGzD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,OAAO,EACP,EAAE,EACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA"}

package/dist/response/index.js

@@ -0,0 +1,4 @@
+export { isBinaryResponse, ErrorCodes } from './types.js';
+// Response helpers
+export { configureResponses, getResponseConfig, respond, ok, created, accepted, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, badGateway, serviceUnavailable, binary, apiError, } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzD,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,OAAO,EACP,EAAE,EACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,QAAQ,GAET,MAAM,cAAc,CAAA"}

package/dist/response/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Standard API response wrapper.
+ * Used by response helpers to carry status code and data together.
+ */
+export interface ApiResponse<TStatus extends number, TData> {
+    status: TStatus;
+    data: TData;
+}
+/**
+ * Binary response for file downloads.
+ * Bypasses JSON serialization and sends raw data.
+ */
+export interface BinaryResponse<TStatus extends number> {
+    status: TStatus;
+    binary: true;
+    contentType: string;
+    filename?: string;
+    data: Buffer | string;
+}
+/**
+ * Union of all possible response types.
+ */
+export type AnyResponse = ApiResponse<number, unknown> | BinaryResponse<number>;
+/**
+ * Type guard to check if a response is binary.
+ */
+export declare function isBinaryResponse(response: unknown): response is BinaryResponse<number>;
+/**
+ * Common error codes for API responses.
+ * These can be extended by applications.
+ */
+export declare const ErrorCodes: {
+    readonly BAD_REQUEST: "E_BAD_REQUEST";
+    readonly UNAUTHORIZED: "E_UNAUTHORIZED";
+    readonly FORBIDDEN: "E_FORBIDDEN";
+    readonly NOT_FOUND: "E_NOT_FOUND";
+    readonly VALIDATION: "E_VALIDATION";
+    readonly CONFLICT: "E_CONFLICT";
+    readonly RATE_LIMITED: "E_RATE_LIMITED";
+    readonly INTERNAL: "E_INTERNAL";
+    readonly SERVICE_UNAVAILABLE: "E_SERVICE_UNAVAILABLE";
+    readonly EXTERNAL_API: "E_EXTERNAL_API";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+/**
+ * Standard error response structure.
+ * Applications can extend this with additional fields.
+ */
+export interface ApiErrorBody {
+    status: number;
+    code: string;
+    message: string;
+    errors?: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/response/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/response/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK;IACxD,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,KAAK,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM;IACpD,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,IAAI,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;AAE/E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC,CAOtF;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;CAWb,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAElE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH"}

package/dist/response/types.js

@@ -0,0 +1,26 @@
+/**
+ * Type guard to check if a response is binary.
+ */
+export function isBinaryResponse(response) {
+    return (response !== null
+        && typeof response === 'object'
+        && 'binary' in response
+        && response.binary === true);
+}
+/**
+ * Common error codes for API responses.
+ * These can be extended by applications.
+ */
+export const ErrorCodes = {
+    BAD_REQUEST: 'E_BAD_REQUEST',
+    UNAUTHORIZED: 'E_UNAUTHORIZED',
+    FORBIDDEN: 'E_FORBIDDEN',
+    NOT_FOUND: 'E_NOT_FOUND',
+    VALIDATION: 'E_VALIDATION',
+    CONFLICT: 'E_CONFLICT',
+    RATE_LIMITED: 'E_RATE_LIMITED',
+    INTERNAL: 'E_INTERNAL',
+    SERVICE_UNAVAILABLE: 'E_SERVICE_UNAVAILABLE',
+    EXTERNAL_API: 'E_EXTERNAL_API',
+};
+//# sourceMappingURL=types.js.map

package/dist/response/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/response/types.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,OAAO,CACL,QAAQ,KAAK,IAAI;WACd,OAAO,QAAQ,KAAK,QAAQ;WAC5B,QAAQ,IAAI,QAAQ;WACnB,QAAmC,CAAC,MAAM,KAAK,IAAI,CACxD,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,gBAAgB;IAC9B,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;IACxB,UAAU,EAAE,cAAc;IAC1B,QAAQ,EAAE,YAAY;IACtB,YAAY,EAAE,gBAAgB;IAC9B,QAAQ,EAAE,YAAY;IACtB,mBAAmB,EAAE,uBAAuB;IAC5C,YAAY,EAAE,gBAAgB;CACtB,CAAA"}

package/dist/runtime/adapter-types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Shared type definitions for kontract framework adapters.
+ *
+ * These types are used across all framework adapters (Hono, Fastify, Express, AdonisJS)
+ * to provide consistent typing for response helpers and handler contexts.
+ */
+import type { TSchema, Static } from '@sinclair/typebox';
+import type { ApiResponse } from '../response/types.js';
+import type { ResponseExample, ResponseHeader } from '../metadata/types.js';
+/**
+ * Response configuration for routes.
+ * Maps HTTP status codes to schemas or response definitions.
+ */
+export type ResponsesConfig = Record<number, TSchema | null | {
+    schema: TSchema | null;
+    description?: string;
+    headers?: Record<string, ResponseHeader>;
+    examples?: Record<string, ResponseExample>;
+    example?: unknown;
+}>;
+/**
+ * Normalized response entry (internal use).
+ */
+export interface NormalizedResponse {
+    schema: TSchema | null;
+    description?: string;
+    headers?: Record<string, ResponseHeader>;
+    examples?: Record<string, ResponseExample>;
+    example?: unknown;
+}
+/**
+ * Normalized responses map (internal use).
+ */
+export type NormalizedResponses = Record<number, NormalizedResponse>;
+/**
+ * Extract the schema from a response definition.
+ * Handles both `{ schema: T }` and raw `T` formats.
+ */
+export type ExtractResponseSchema<T> = T extends {
+    schema: infer S;
+} ? S extends TSchema ? S : never : T extends TSchema ? T : never;
+/**
+ * Get the schema type for a specific status code, or `never` if not defined.
+ */
+export type ResponseSchemaFor<TResponses, Status extends number> = Status extends keyof TResponses ? ExtractResponseSchema<TResponses[Status]> : never;
+/**
+ * Helper type to create a typed response function for a specific status code.
+ */
+export type TypedHelper<TResponses, Status extends number> = ResponseSchemaFor<TResponses, Status> extends TSchema ? (data: Static<ResponseSchemaFor<TResponses, Status>>) => ApiResponse<Status, Static<ResponseSchemaFor<TResponses, Status>>> : never;
+/**
+ * Error helper that accepts:
+ * - No args: use description from response definition as message
+ * - A string: use as message, auto-fill status and code
+ * - An object: merge with defaults (status, code, description as message)
+ */
+export type TypedErrorHelper<TResponses, Status extends number> = ResponseSchemaFor<TResponses, Status> extends TSchema ? (dataOrMessage?: string | Partial<Static<ResponseSchemaFor<TResponses, Status>>>) => ApiResponse<Status, Static<ResponseSchemaFor<TResponses, Status>>> : never;
+/**
+ * Success response helpers namespace (2xx).
+ * Only includes methods for status codes that are defined in responses.
+ */
+export type ReplyHelpers<TResponses extends ResponsesConfig> = (200 extends keyof TResponses ? {
+    ok: TypedHelper<TResponses, 200>;
+    list: TypedHelper<TResponses, 200>;
+} : unknown) & (201 extends keyof TResponses ? {
+    created: TypedHelper<TResponses, 201>;
+} : unknown) & (202 extends keyof TResponses ? {
+    accepted: TypedHelper<TResponses, 202>;
+} : unknown) & (204 extends keyof TResponses ? {
+    noContent: () => ApiResponse<204, null>;
+} : unknown);
+/**
+ * Error response helpers namespace (4xx/5xx).
+ * Only includes methods for status codes that are defined in responses.
+ *
+ * Each method accepts:
+ * - No args: `error.internal()` - uses response description as message
+ * - A string: `error.badRequest('Invalid token')`
+ * - An object: `error.badRequest({ message: 'Invalid', details: {...} })`
+ *
+ * Status, code, and message are auto-filled from sensible defaults.
+ */
+export type ErrorHelpers<TResponses extends ResponsesConfig> = (400 extends keyof TResponses ? {
+    badRequest: TypedErrorHelper<TResponses, 400>;
+} : unknown) & (401 extends keyof TResponses ? {
+    unauthorized: TypedErrorHelper<TResponses, 401>;
+} : unknown) & (403 extends keyof TResponses ? {
+    forbidden: TypedErrorHelper<TResponses, 403>;
+} : unknown) & (404 extends keyof TResponses ? {
+    notFound: TypedErrorHelper<TResponses, 404>;
+} : unknown) & (409 extends keyof TResponses ? {
+    conflict: TypedErrorHelper<TResponses, 409>;
+} : unknown) & (422 extends keyof TResponses ? {
+    validationError: TypedErrorHelper<TResponses, 422>;
+} : unknown) & (429 extends keyof TResponses ? {
+    tooManyRequests: TypedErrorHelper<TResponses, 429>;
+} : unknown) & (500 extends keyof TResponses ? {
+    internal: TypedErrorHelper<TResponses, 500>;
+} : unknown) & (503 extends keyof TResponses ? {
+    serviceUnavailable: TypedErrorHelper<TResponses, 503>;
+} : unknown);
+/**
+ * Base handler context interface.
+ * Framework adapters extend this with their specific context properties.
+ */
+export interface BaseHandlerContext<TBody = unknown, TQuery = unknown, TParams = unknown, TResponses extends ResponsesConfig = ResponsesConfig> {
+    /** Validated request body */
+    body: TBody;
+    /** Validated query parameters */
+    query: TQuery;
+    /** Validated path parameters */
+    params: TParams;
+    /** Authenticated user (available when auth is 'required' or 'optional') */
+    user: unknown;
+    /** Success response helpers (2xx) - methods typed from responses config */
+    reply: ReplyHelpers<TResponses>;
+    /** Error response helpers (4xx/5xx) - methods typed from responses config */
+    error: ErrorHelpers<TResponses>;
+}
+//# sourceMappingURL=adapter-types.d.ts.map

package/dist/runtime/adapter-types.d.ts.map

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

package/dist/runtime/adapter-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter-types.js.map

package/dist/runtime/adapter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-types.js","sourceRoot":"","sources":["../../src/runtime/adapter-types.ts"],"names":[],"mappings":""}

package/dist/runtime/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Runtime utilities for kontract adapters.
+ *
+ * This module exports shared code used by all framework adapters
+ * (Hono, Fastify, Express, AdonisJS) to reduce code duplication.
+ */
+export type { RequestContext, AuthUser, AuthResult, AdapterRouteHandler, RouterAdapter, AuthAdapter, ContainerAdapter, ResponseAdapter, LoggerAdapter, FrameworkAdapters, } from './types.js';
+export type { ResponsesConfig, NormalizedResponse, NormalizedResponses, ExtractResponseSchema, ResponseSchemaFor, TypedHelper, TypedErrorHelper, ReplyHelpers, ErrorHelpers, BaseHandlerContext, } from './adapter-types.js';
+export { ERROR_CODES, createSuccessHelper, createErrorHelper, getErrorMessage, createResponseHelpers, } from './response-helpers.js';
+export type { RouteString } from './route-utils.js';
+export { parseRouteString, normalizeResponses, isApiResponse, noContent, } from './route-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,uBAAuB,CAAA;AAG9B,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,SAAS,GACV,MAAM,kBAAkB,CAAA"}

package/dist/runtime/index.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime utilities for kontract adapters.
+ *
+ * This module exports shared code used by all framework adapters
+ * (Hono, Fastify, Express, AdonisJS) to reduce code duplication.
+ */
+// Response helpers
+export { ERROR_CODES, createSuccessHelper, createErrorHelper, getErrorMessage, createResponseHelpers, } from './response-helpers.js';
+export { parseRouteString, normalizeResponses, isApiResponse, noContent, } from './route-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,uBAAuB,CAAA;AAI9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,SAAS,GACV,MAAM,kBAAkB,CAAA"}