@empire-builder-kit/runtime 1.0.0-beta.9 → 1.0.0-rc.2

package/src/index.d.ts

@@ -1,15 +1,21 @@
 export * from './auth.js';
 export * from './auth-session.js';
+export * from './canonical-json.js';
 export * from './config.js';
+export * from './deterministic-order.js';
 export * from './events.js';
 export * from './frontend.js';
 export * from './hosts.js';
 export * from './logging.js';
 export * from './lambda.js';
 export * from './observability.js';
+export * from './performance/index.js';
 export * from './request-context.js';
+export * from './reliability/index.js';
 export * from './response.js';
+export * from './safe-reference.js';
+export * from './secrets/sensitive-patterns.js';
 export declare const runtimePackage: {
-    readonly exports: readonly ["@empire-builder-kit/runtime/auth", "@empire-builder-kit/runtime/auth-backend", "@empire-builder-kit/runtime/auth-web", "@empire-builder-kit/runtime/auth-session", "@empire-builder-kit/runtime/config", "@empire-builder-kit/runtime/events", "@empire-builder-kit/runtime/frontend", "@empire-builder-kit/runtime/hosts", "@empire-builder-kit/runtime/request-context", "@empire-builder-kit/runtime/logging", "@empire-builder-kit/runtime/lambda", "@empire-builder-kit/runtime/observability", "@empire-builder-kit/runtime/response"];
+    readonly exports: readonly ["@empire-builder-kit/runtime/api-client", "@empire-builder-kit/runtime/api-contract", "@empire-builder-kit/runtime/api-server", "@empire-builder-kit/runtime/async-work", "@empire-builder-kit/runtime/auth", "@empire-builder-kit/runtime/auth-backend", "@empire-builder-kit/runtime/auth-web", "@empire-builder-kit/runtime/auth-session", "@empire-builder-kit/runtime/authorization", "@empire-builder-kit/runtime/canonical-json", "@empire-builder-kit/runtime/config", "@empire-builder-kit/runtime/configuration", "@empire-builder-kit/runtime/configuration-rollout-evaluator", "@empire-builder-kit/runtime/configuration-rollout-key", "@empire-builder-kit/runtime/data-lifecycle", "@empire-builder-kit/runtime/database", "@empire-builder-kit/runtime/deterministic-order", "@empire-builder-kit/runtime/events", "@empire-builder-kit/runtime/frontend", "@empire-builder-kit/runtime/hosts", "@empire-builder-kit/runtime/request-context", "@empire-builder-kit/runtime/reliability", "@empire-builder-kit/runtime/logging", "@empire-builder-kit/runtime/lambda", "@empire-builder-kit/runtime/observability", "@empire-builder-kit/runtime/performance", "@empire-builder-kit/runtime/response", "@empire-builder-kit/runtime/safe-reference", "@empire-builder-kit/runtime/secret-contract", "@empire-builder-kit/runtime/secrets", "@empire-builder-kit/runtime/sensitive-patterns"];
     readonly name: "@empire-builder-kit/runtime";
 };

package/src/index.js

@@ -1,29 +1,53 @@
 export * from './auth.js';
 export * from './auth-session.js';
+export * from './canonical-json.js';
 export * from './config.js';
+export * from './deterministic-order.js';
 export * from './events.js';
 export * from './frontend.js';
 export * from './hosts.js';
 export * from './logging.js';
 export * from './lambda.js';
 export * from './observability.js';
+export * from './performance/index.js';
 export * from './request-context.js';
+export * from './reliability/index.js';
 export * from './response.js';
+export * from './safe-reference.js';
+export * from './secrets/sensitive-patterns.js';
 export const runtimePackage = {
     exports: [
+        '@empire-builder-kit/runtime/api-client',
+        '@empire-builder-kit/runtime/api-contract',
+        '@empire-builder-kit/runtime/api-server',
+        '@empire-builder-kit/runtime/async-work',
         '@empire-builder-kit/runtime/auth',
         '@empire-builder-kit/runtime/auth-backend',
         '@empire-builder-kit/runtime/auth-web',
         '@empire-builder-kit/runtime/auth-session',
+        '@empire-builder-kit/runtime/authorization',
+        '@empire-builder-kit/runtime/canonical-json',
         '@empire-builder-kit/runtime/config',
+        '@empire-builder-kit/runtime/configuration',
+        '@empire-builder-kit/runtime/configuration-rollout-evaluator',
+        '@empire-builder-kit/runtime/configuration-rollout-key',
+        '@empire-builder-kit/runtime/data-lifecycle',
+        '@empire-builder-kit/runtime/database',
+        '@empire-builder-kit/runtime/deterministic-order',
         '@empire-builder-kit/runtime/events',
         '@empire-builder-kit/runtime/frontend',
         '@empire-builder-kit/runtime/hosts',
         '@empire-builder-kit/runtime/request-context',
+        '@empire-builder-kit/runtime/reliability',
         '@empire-builder-kit/runtime/logging',
         '@empire-builder-kit/runtime/lambda',
         '@empire-builder-kit/runtime/observability',
+        '@empire-builder-kit/runtime/performance',
         '@empire-builder-kit/runtime/response',
+        '@empire-builder-kit/runtime/safe-reference',
+        '@empire-builder-kit/runtime/secret-contract',
+        '@empire-builder-kit/runtime/secrets',
+        '@empire-builder-kit/runtime/sensitive-patterns',
     ],
     name: '@empire-builder-kit/runtime',
 };

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/runtime/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAE9B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,kCAAkC;QAClC,0CAA0C;QAC1C,sCAAsC;QACtC,0CAA0C;QAC1C,oCAAoC;QACpC,oCAAoC;QACpC,sCAAsC;QACtC,mCAAmC;QACnC,6CAA6C;QAC7C,qCAAqC;QACrC,oCAAoC;QACpC,2CAA2C;QAC3C,sCAAsC;KACvC;IACD,IAAI,EAAE,6BAA6B;CAC3B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/runtime/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,wCAAwC;QACxC,0CAA0C;QAC1C,wCAAwC;QACxC,wCAAwC;QACxC,kCAAkC;QAClC,0CAA0C;QAC1C,sCAAsC;QACtC,0CAA0C;QAC1C,2CAA2C;QAC3C,4CAA4C;QAC5C,oCAAoC;QACpC,2CAA2C;QAC3C,6DAA6D;QAC7D,uDAAuD;QACvD,4CAA4C;QAC5C,sCAAsC;QACtC,iDAAiD;QACjD,oCAAoC;QACpC,sCAAsC;QACtC,mCAAmC;QACnC,6CAA6C;QAC7C,yCAAyC;QACzC,qCAAqC;QACrC,oCAAoC;QACpC,2CAA2C;QAC3C,yCAAyC;QACzC,sCAAsC;QACtC,4CAA4C;QAC5C,6CAA6C;QAC7C,qCAAqC;QACrC,gDAAgD;KACjD;IACD,IAAI,EAAE,6BAA6B;CAC3B,CAAC"}

package/src/lambda.d.ts

@@ -4,7 +4,11 @@ import { type AppResponse } from './response.js';
 export interface RuntimeHttpEvent {
     body?: string | null;
     headers?: Record<string, string | undefined> | null;
+    isBase64Encoded?: boolean;
+    pathParameters?: Record<string, string | undefined> | null;
+    queryStringParameters?: Record<string, string | undefined> | null;
     rawPath?: string;
+    rawQueryString?: string;
     requestContext?: {
         http?: {
             method?: string;
@@ -26,14 +30,16 @@ export interface RuntimeHttpHandlerInput<E extends RuntimeHttpEvent = RuntimeHtt
     logger: Logger;
 }
 export interface CreateHttpJsonHandlerOptions<T, E extends RuntimeHttpEvent = RuntimeHttpEvent> {
-    app: string;
+    component: string;
+    feature: string;
     handle(input: RuntimeHttpHandlerInput<E>): Promise<T> | T;
     includeErrorDetails?: boolean;
     logger?: Logger;
     operation: string;
-    service?: string;
+    slice: string;
     stage?: string;
     successStatus?: number;
+    workspace: string;
 }
 export type RuntimeHttpJsonHandler<E extends RuntimeHttpEvent = RuntimeHttpEvent> = (event: E) => Promise<RuntimeHttpJsonResponse>;
 export declare const lambdaContract: {

package/src/lambda.js

@@ -1,26 +1,42 @@
 import { __awaiter } from "tslib";
 import { createLogger } from './logging.js';
 import { createRequestContext, toRequestHeaders, } from './request-context.js';
-import { createErrorResponse, createSuccessResponse, } from './response.js';
+import { createErrorResponse, createSuccessResponse, isRuntimeError, RuntimeError, } from './response.js';
 export const lambdaContract = {
     defaultResponseFormat: 'json',
     exportPath: '@empire-builder-kit/runtime/lambda',
     packageName: '@empire-builder-kit/runtime',
 };
-function getHeader(headers, name) {
-    if (!headers) {
-        return undefined;
+function normalizeHeaders(headers) {
+    const normalized = Object.create(null);
+    const names = new Set();
+    for (const [name, value] of Object.entries(headers !== null && headers !== void 0 ? headers : {})) {
+        const lowerName = name.toLowerCase();
+        if (names.has(lowerName)) {
+            throw new RuntimeError({
+                code: 'invalid_request',
+                expose: true,
+                message: 'Request headers must not repeat a case-insensitive name.',
+                retryable: false,
+                status: 400,
+            });
+        }
+        names.add(lowerName);
+        normalized[lowerName] = value;
     }
-    const lowerName = name.toLowerCase();
-    const entry = Object.entries(headers).find(([key]) => key.toLowerCase() === lowerName);
-    return entry === null || entry === void 0 ? void 0 : entry[1];
+    return normalized;
+}
+function getHeader(headers, name) {
+    return headers === null || headers === void 0 ? void 0 : headers[name.toLowerCase()];
 }
 function resolveStage(stage) {
     const resolved = stage !== null && stage !== void 0 ? stage : process.env['EBK_STAGE'];
-    if (resolved === undefined || resolved.trim() === '') {
-        throw new Error('EBK runtime stage is required. Pass options.stage or set EBK_STAGE.');
+    if (resolved === undefined ||
+        resolved !== resolved.trim() ||
+        !/^[A-Za-z0-9._:/-]{1,128}$/.test(resolved)) {
+        throw new Error('EBK runtime stage must be a bounded machine-readable token. Pass options.stage or set EBK_STAGE.');
     }
-    return resolved.trim();
+    return resolved;
 }
 function createResponseMeta(context) {
     return {
@@ -42,43 +58,85 @@ export function toHttpJsonResponse(response) {
     };
 }
 export function createHttpJsonHandler(options) {
-    var _a, _b;
+    var _a;
     const stage = resolveStage(options.stage);
+    const operationLabel = options.operation.startsWith(`${options.slice}.`)
+        ? options.operation
+        : `${options.slice}.${options.operation}`;
     const baseLogger = (_a = options.logger) !== null && _a !== void 0 ? _a : createLogger({
-        app: options.app,
-        service: (_b = options.service) !== null && _b !== void 0 ? _b : options.operation,
+        component: options.component,
+        feature: options.feature,
+        operation: options.operation,
+        slice: options.slice,
         stage,
+        workspace: options.workspace,
     });
     return (event) => __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
-        const requestId = (_a = getHeader(event.headers, 'x-request-id')) !== null && _a !== void 0 ? _a : (_b = event.requestContext) === null || _b === void 0 ? void 0 : _b.requestId;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        let normalizedHeaders;
+        try {
+            // Reject ambiguous input before request context, authorization, or
+            // operation parsing can consume a case-selected header value.
+            normalizedHeaders = normalizeHeaders(event.headers);
+        }
+        catch (error) {
+            const context = createRequestContext({
+                metadata: {
+                    method: (_b = (_a = event.requestContext) === null || _a === void 0 ? void 0 : _a.http) === null || _b === void 0 ? void 0 : _b.method,
+                },
+                operation: options.operation,
+                requestId: (_c = event.requestContext) === null || _c === void 0 ? void 0 : _c.requestId,
+                slice: options.slice,
+                source: 'http',
+                stage,
+            });
+            const requestLogger = baseLogger.child({
+                component: options.component,
+                context,
+                feature: options.feature,
+                operation: options.operation,
+            });
+            const response = createErrorResponse(error, {
+                includeDetails: options.includeErrorDetails,
+                meta: createResponseMeta(context),
+            });
+            requestLogger.error(`${operationLabel} request failed`, {
+                attributes: {
+                    httpStatus: response.status,
+                },
+                error,
+                errorMessageIsSafe: isRuntimeError(error) && error.expose,
+                outcome: 'failure',
+            });
+            const httpResponse = toHttpJsonResponse(response);
+            return Object.assign(Object.assign({}, httpResponse), { headers: Object.assign(Object.assign({}, httpResponse.headers), toRequestHeaders(context)) });
+        }
+        const requestId = (_d = getHeader(normalizedHeaders, 'x-request-id')) !== null && _d !== void 0 ? _d : (_e = event.requestContext) === null || _e === void 0 ? void 0 : _e.requestId;
         const context = createRequestContext({
-            app: options.app,
-            causationId: getHeader(event.headers, 'x-causation-id'),
-            correlationId: (_c = getHeader(event.headers, 'x-correlation-id')) !== null && _c !== void 0 ? _c : requestId,
+            causationId: getHeader(normalizedHeaders, 'x-causation-id'),
+            correlationId: (_f = getHeader(normalizedHeaders, 'x-correlation-id')) !== null && _f !== void 0 ? _f : requestId,
             metadata: {
-                method: (_e = (_d = event.requestContext) === null || _d === void 0 ? void 0 : _d.http) === null || _e === void 0 ? void 0 : _e.method,
-                path: (_f = event.rawPath) !== null && _f !== void 0 ? _f : (_h = (_g = event.requestContext) === null || _g === void 0 ? void 0 : _g.http) === null || _h === void 0 ? void 0 : _h.path,
-                sourceIp: (_k = (_j = event.requestContext) === null || _j === void 0 ? void 0 : _j.http) === null || _k === void 0 ? void 0 : _k.sourceIp,
-                userAgent: (_m = (_l = event.requestContext) === null || _l === void 0 ? void 0 : _l.http) === null || _m === void 0 ? void 0 : _m.userAgent,
+                method: (_h = (_g = event.requestContext) === null || _g === void 0 ? void 0 : _g.http) === null || _h === void 0 ? void 0 : _h.method,
             },
             operation: options.operation,
             requestId,
+            slice: options.slice,
+            source: 'http',
             stage,
-            tenantId: getHeader(event.headers, 'x-tenant-id'),
-            traceParent: getHeader(event.headers, 'traceparent'),
-            traceState: getHeader(event.headers, 'tracestate'),
+            tenantId: getHeader(normalizedHeaders, 'x-tenant-id'),
+            traceParent: getHeader(normalizedHeaders, 'traceparent'),
+            traceState: getHeader(normalizedHeaders, 'tracestate'),
         });
         const requestLogger = baseLogger.child({
+            component: options.component,
             context,
-            service: (_o = options.service) !== null && _o !== void 0 ? _o : options.operation,
-            stage,
+            feature: options.feature,
+            operation: options.operation,
         });
-        requestLogger.info(`${options.app}.${options.operation} request received`, {
-            metadata: {
-                method: (_q = (_p = event.requestContext) === null || _p === void 0 ? void 0 : _p.http) === null || _q === void 0 ? void 0 : _q.method,
-                path: (_r = event.rawPath) !== null && _r !== void 0 ? _r : (_t = (_s = event.requestContext) === null || _s === void 0 ? void 0 : _s.http) === null || _t === void 0 ? void 0 : _t.path,
-            },
+        requestLogger.info(`${operationLabel} request received`, {
+            attributes: ((_k = (_j = event.requestContext) === null || _j === void 0 ? void 0 : _j.http) === null || _k === void 0 ? void 0 : _k.method)
+                ? { httpMethod: event.requestContext.http.method }
+                : undefined,
         });
         try {
             const data = yield options.handle({
@@ -90,10 +148,11 @@ export function createHttpJsonHandler(options) {
                 meta: createResponseMeta(context),
                 status: options.successStatus,
             });
-            requestLogger.info(`${options.app}.${options.operation} request completed`, {
-                metadata: {
-                    status: response.status,
+            requestLogger.info(`${operationLabel} request completed`, {
+                attributes: {
+                    httpStatus: response.status,
                 },
+                outcome: 'success',
             });
             const httpResponse = toHttpJsonResponse(response);
             return Object.assign(Object.assign({}, httpResponse), { headers: Object.assign(Object.assign({}, httpResponse.headers), toRequestHeaders(context)) });
@@ -103,11 +162,13 @@ export function createHttpJsonHandler(options) {
                 includeDetails: options.includeErrorDetails,
                 meta: createResponseMeta(context),
             });
-            requestLogger.error(`${options.app}.${options.operation} request failed`, {
-                error,
-                metadata: {
-                    status: response.status,
+            requestLogger.error(`${operationLabel} request failed`, {
+                attributes: {
+                    httpStatus: response.status,
                 },
+                error,
+                errorMessageIsSafe: isRuntimeError(error) && error.expose,
+                outcome: 'failure',
             });
             const httpResponse = toHttpJsonResponse(response);
             return Object.assign(Object.assign({}, httpResponse), { headers: Object.assign(Object.assign({}, httpResponse.headers), toRequestHeaders(context)) });

package/src/lambda.js.map

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

package/src/logging.d.ts

@@ -1,69 +1,128 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-export type LogMetadata = Record<string, unknown>;
-export interface LoggerActor {
-    id?: string;
-    type?: string;
-}
-export interface LoggerContext {
-    actor?: LoggerActor;
-    correlationId?: string;
-    metadata?: Record<string, string | number | boolean | null | undefined>;
-    operation?: string;
-    requestId?: string;
-    source?: string;
-    stage?: string;
-}
+import { type RuntimeContext } from './request-context.js';
+export declare const LOG_SCHEMA_VERSION: 1;
+export declare const LOG_RECORD_LIMITS: {
+    readonly arrayItems: 32;
+    readonly attributeKeys: 64;
+    readonly attributeKeyLength: 128;
+    readonly attributeStringLength: 2048;
+    readonly attributeValues: 256;
+    readonly dimensionLength: 128;
+    readonly errorStackLength: 4096;
+    readonly messageLength: 512;
+    readonly nestingDepth: 4;
+    readonly recordBytes: number;
+};
+export type LogLevel = 'TRACE' | 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';
+export type LogOutcome = 'success' | 'failure' | 'cancelled' | 'unknown';
+export type LogAttributes = Record<string, unknown>;
+export type LoggerContext = Partial<RuntimeContext>;
+export type LogAttributeValue = boolean | null | number | string | LogAttributeValue[] | {
+    [key: string]: LogAttributeValue;
+};
 export interface SerializedError {
     code?: number | string;
     message: string;
     name: string;
     stack?: string;
 }
+export interface LogTruncation {
+    circularValues?: number;
+    droppedKeys?: number;
+    recordKeysDropped?: number;
+    redactedValues?: number;
+    truncatedArrays?: number;
+    truncatedDepth?: number;
+    truncatedStrings?: number;
+    truncatedValues?: number;
+    unsupportedValues?: number;
+}
 export interface LogEntry {
-    app: string;
+    attributes?: Record<string, LogAttributeValue>;
+    causationId?: string;
+    component: string;
     correlationId?: string;
-    error?: SerializedError;
+    eventId?: string;
+    eventType?: string;
+    feature: string;
     level: LogLevel;
     message: string;
-    metadata?: LogMetadata;
+    operation: string;
+    outcome?: LogOutcome;
     requestId?: string;
-    service?: string;
-    stage?: string;
+    schemaVersion: typeof LOG_SCHEMA_VERSION;
+    slice: string;
+    spanId?: string;
+    stage: string;
     timestamp: string;
+    traceId?: string;
+    workspace: string;
 }
 export interface LogEventInput {
+    attributes?: LogAttributes;
     context?: LoggerContext;
     error?: unknown;
-    metadata?: LogMetadata;
+    /**
+     * Only set this for a framework-owned/reviewed error whose message is
+     * explicitly classified safe for raw-log readers.
+     */
+    errorMessageIsSafe?: boolean;
+    outcome?: LogOutcome;
 }
 export interface ChildLoggerOptions {
+    attributes?: LogAttributes;
+    component?: string;
     context?: LoggerContext;
-    metadata?: LogMetadata;
-    service?: string;
-    stage?: string;
+    feature?: string;
+    operation?: string;
 }
 export interface CreateLoggerOptions {
-    app: string;
+    attributes?: LogAttributes;
+    component: string;
     context?: LoggerContext;
-    metadata?: LogMetadata;
+    /**
+     * Development diagnostics may include bounded error messages and stacks.
+     * Production remains the safe default.
+     */
+    errorDetail?: 'development' | 'production';
+    feature: string;
+    minimumLevel?: LogLevel;
     now?: () => Date;
-    service?: string;
-    sink?: (entry: LogEntry) => void;
-    stage?: string;
+    operation: string;
+    sink?: LogSink;
+    slice: string;
+    stage: string;
+    workspace: string;
 }
 export interface Logger {
     child(options?: ChildLoggerOptions): Logger;
-    debug(message: string, input?: LogEventInput): LogEntry;
-    error(message: string, input?: LogEventInput): LogEntry;
-    info(message: string, input?: LogEventInput): LogEntry;
-    log(level: LogLevel, message: string, input?: LogEventInput): LogEntry;
-    warn(message: string, input?: LogEventInput): LogEntry;
+    debug(message: string, input?: LogEventInput): LogEntry | undefined;
+    error(message: string, input?: LogEventInput): LogEntry | undefined;
+    fatal(message: string, input?: LogEventInput): LogEntry | undefined;
+    info(message: string, input?: LogEventInput): LogEntry | undefined;
+    log(level: LogLevel, message: string, input?: LogEventInput): LogEntry | undefined;
+    trace(message: string, input?: LogEventInput): LogEntry | undefined;
+    warn(message: string, input?: LogEventInput): LogEntry | undefined;
+}
+export type LogSink = (entry: Readonly<LogEntry>) => void;
+export interface LogWritable {
+    write(chunk: string): unknown;
+}
+export interface ProcessLogStreams {
+    stderr: LogWritable;
+    stdout: LogWritable;
+}
+export interface SerializeErrorOptions {
+    detail?: 'development' | 'production';
+    messageIsSafe?: boolean;
 }
 export declare const loggingContract: {
     readonly defaultFormat: "json";
     readonly exportPath: "@empire-builder-kit/runtime/logging";
     readonly packageName: "@empire-builder-kit/runtime";
+    readonly schemaVersion: 1;
 };
-export declare function serializeError(error: unknown): SerializedError;
-export declare function consoleSink(entry: LogEntry): void;
+export declare function serializeError(error: unknown, options?: SerializeErrorOptions): SerializedError;
+export declare function serializeLogRecord(entry: LogEntry): string;
+export declare function createProcessLogSink(streams?: ProcessLogStreams): LogSink;
+export declare const processLogSink: LogSink;
 export declare function createLogger(options: CreateLoggerOptions): Logger;