@empire-builder-kit/runtime 0.0.1-alpha.8 → 1.0.0-beta.4

package/src/logging.js

@@ -0,0 +1,113 @@
+export const loggingContract = {
+    defaultFormat: 'json',
+    exportPath: '@empire-builder-kit/runtime/logging',
+    packageName: '@empire-builder-kit/runtime',
+};
+function mergeContext(base, overrides) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!base && !overrides) {
+        return undefined;
+    }
+    return {
+        actor: (_a = overrides === null || overrides === void 0 ? void 0 : overrides.actor) !== null && _a !== void 0 ? _a : base === null || base === void 0 ? void 0 : base.actor,
+        correlationId: (_b = overrides === null || overrides === void 0 ? void 0 : overrides.correlationId) !== null && _b !== void 0 ? _b : base === null || base === void 0 ? void 0 : base.correlationId,
+        metadata: Object.assign(Object.assign({}, ((_c = base === null || base === void 0 ? void 0 : base.metadata) !== null && _c !== void 0 ? _c : {})), ((_d = overrides === null || overrides === void 0 ? void 0 : overrides.metadata) !== null && _d !== void 0 ? _d : {})),
+        operation: (_e = overrides === null || overrides === void 0 ? void 0 : overrides.operation) !== null && _e !== void 0 ? _e : base === null || base === void 0 ? void 0 : base.operation,
+        requestId: (_f = overrides === null || overrides === void 0 ? void 0 : overrides.requestId) !== null && _f !== void 0 ? _f : base === null || base === void 0 ? void 0 : base.requestId,
+        source: (_g = overrides === null || overrides === void 0 ? void 0 : overrides.source) !== null && _g !== void 0 ? _g : base === null || base === void 0 ? void 0 : base.source,
+        stage: (_h = overrides === null || overrides === void 0 ? void 0 : overrides.stage) !== null && _h !== void 0 ? _h : base === null || base === void 0 ? void 0 : base.stage,
+    };
+}
+function contextMetadata(context) {
+    var _a, _b, _c;
+    if (!context) {
+        return {};
+    }
+    return compactObject(Object.assign({ actorId: (_a = context.actor) === null || _a === void 0 ? void 0 : _a.id, actorType: (_b = context.actor) === null || _b === void 0 ? void 0 : _b.type, operation: context.operation, source: context.source }, ((_c = context.metadata) !== null && _c !== void 0 ? _c : {})));
+}
+function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function safeStringify(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch (_a) {
+        return String(value);
+    }
+}
+export function serializeError(error) {
+    if (error instanceof Error) {
+        const value = error;
+        return compactObject({
+            code: value.code,
+            message: value.message,
+            name: value.name,
+            stack: value.stack,
+        });
+    }
+    return {
+        message: safeStringify(error),
+        name: 'UnknownError',
+    };
+}
+export function consoleSink(entry) {
+    console.log(JSON.stringify(entry));
+}
+export function createLogger(options) {
+    var _a, _b;
+    const sink = (_a = options.sink) !== null && _a !== void 0 ? _a : consoleSink;
+    const now = (_b = options.now) !== null && _b !== void 0 ? _b : (() => new Date());
+    const write = (level, message, input = {}) => {
+        var _a, _b, _c;
+        const mergedContext = mergeContext(options.context, input.context);
+        const metadata = compactObject(Object.assign(Object.assign(Object.assign({}, ((_a = options.metadata) !== null && _a !== void 0 ? _a : {})), contextMetadata(mergedContext)), ((_b = input.metadata) !== null && _b !== void 0 ? _b : {})));
+        const entry = compactObject({
+            app: options.app,
+            correlationId: mergedContext === null || mergedContext === void 0 ? void 0 : mergedContext.correlationId,
+            error: input.error === undefined ? undefined : serializeError(input.error),
+            level,
+            message,
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            requestId: mergedContext === null || mergedContext === void 0 ? void 0 : mergedContext.requestId,
+            service: options.service,
+            stage: (_c = mergedContext === null || mergedContext === void 0 ? void 0 : mergedContext.stage) !== null && _c !== void 0 ? _c : options.stage,
+            timestamp: now().toISOString(),
+        });
+        sink(entry);
+        return entry;
+    };
+    return {
+        child(childOptions = {}) {
+            var _a, _b, _c, _d;
+            return createLogger({
+                app: options.app,
+                context: mergeContext(options.context, childOptions.context),
+                metadata: Object.assign(Object.assign({}, ((_a = options.metadata) !== null && _a !== void 0 ? _a : {})), ((_b = childOptions.metadata) !== null && _b !== void 0 ? _b : {})),
+                now,
+                service: (_c = childOptions.service) !== null && _c !== void 0 ? _c : options.service,
+                sink,
+                stage: (_d = childOptions.stage) !== null && _d !== void 0 ? _d : options.stage,
+            });
+        },
+        debug(message, input) {
+            return write('debug', message, input);
+        },
+        error(message, input) {
+            return write('error', message, input);
+        },
+        info(message, input) {
+            return write('info', message, input);
+        },
+        log(level, message, input) {
+            return write(level, message, input);
+        },
+        warn(message, input) {
+            return write('warn', message, input);
+        },
+    };
+}
+//# sourceMappingURL=logging.js.map

package/src/logging.js.map

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

package/{dist → src}/observability.d.ts

@@ -83,7 +83,24 @@ export declare function createQueueAlarmDefinitions(input: QueueAlarmInput): Ala
 export declare function createDashboardPath(input: DashboardPathInput): string;
 export declare function createDashboardRegistration(input: DashboardRegistrationInput): MonitoringDashboardRegistration;
 export declare function createQueueAlarmRegistration(input: QueueAlarmRegistrationInput): QueueAlarmRegistration;
+export interface EventConsumerAlarmInput {
+    app: string;
+    consumer: string;
+    queueName: string;
+    dlqName: string;
+    severity?: AlarmSeverity;
+    stage: string;
+    thresholds?: Partial<QueueAlertThresholds>;
+}
+export interface EventConsumerAlarmRegistration {
+    alarms: AlarmDefinition[];
+    app: string;
+    consumer: string;
+    dlqName: string;
+    queueName: string;
+    stage: string;
+}
+export declare function defineEventConsumerAlarms(input: EventConsumerAlarmInput): EventConsumerAlarmRegistration;
 export declare function createDefaultAppGroupAlarmDefinitions(input: AppGroupObservabilityInput): AlarmDefinition[];
 export declare function createAppGroupObservabilityRegistration(input: AppGroupObservabilityInput): AppGroupObservabilityRegistration;
 export declare function defineAppGroupMonitoringRegistration<T extends AppGroupMonitoringRegistration>(registration: T): T;
-//# sourceMappingURL=observability.d.ts.map

package/{dist → src}/observability.js

@@ -1,15 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMetricNamespace = createMetricNamespace;
-exports.createAlarmName = createAlarmName;
-exports.defaultQueueAlertThresholds = defaultQueueAlertThresholds;
-exports.createQueueAlarmDefinitions = createQueueAlarmDefinitions;
-exports.createDashboardPath = createDashboardPath;
-exports.createDashboardRegistration = createDashboardRegistration;
-exports.createQueueAlarmRegistration = createQueueAlarmRegistration;
-exports.createDefaultAppGroupAlarmDefinitions = createDefaultAppGroupAlarmDefinitions;
-exports.createAppGroupObservabilityRegistration = createAppGroupObservabilityRegistration;
-exports.defineAppGroupMonitoringRegistration = defineAppGroupMonitoringRegistration;
 function normalizeSegment(value) {
     return value
         .trim()
@@ -17,30 +5,27 @@ function normalizeSegment(value) {
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-+|-+$/g, '');
 }
-function createMetricNamespace(app) {
+export function createMetricNamespace(app) {
     return `EBK/${normalizeSegment(app)}`;
 }
-function createAlarmName(input) {
+export function createAlarmName(input) {
+    var _a;
     return [
         normalizeSegment(input.app),
         normalizeSegment(input.stage),
         normalizeSegment(input.component),
         normalizeSegment(input.metric),
-        normalizeSegment(input.severity ?? 'medium'),
+        normalizeSegment((_a = input.severity) !== null && _a !== void 0 ? _a : 'medium'),
     ].join('-');
 }
-function defaultQueueAlertThresholds(overrides = {}) {
-    return {
-        messagesInFlight: 10,
-        messagesVisible: 25,
-        oldestMessageAgeSeconds: 300,
-        ...overrides,
-    };
+export function defaultQueueAlertThresholds(overrides = {}) {
+    return Object.assign({ messagesInFlight: 10, messagesVisible: 25, oldestMessageAgeSeconds: 300 }, overrides);
 }
-function createQueueAlarmDefinitions(input) {
+export function createQueueAlarmDefinitions(input) {
+    var _a;
     const thresholds = defaultQueueAlertThresholds(input.thresholds);
     const namespace = 'AWS/SQS';
-    const severity = input.severity ?? 'high';
+    const severity = (_a = input.severity) !== null && _a !== void 0 ? _a : 'high';
     return [
         {
             comparisonOperator: 'GreaterThanOrEqualToThreshold',
@@ -104,41 +89,72 @@ function createQueueAlarmDefinitions(input) {
         },
     ];
 }
-function createDashboardPath(input) {
+export function createDashboardPath(input) {
     return `/${normalizeSegment(input.stage)}/${normalizeSegment(input.app)}/${normalizeSegment(input.dashboard)}`;
 }
-function createDashboardRegistration(input) {
-    return {
-        ...input,
-        path: createDashboardPath(input),
-    };
+export function createDashboardRegistration(input) {
+    return Object.assign(Object.assign({}, input), { path: createDashboardPath(input) });
 }
-function createQueueAlarmRegistration(input) {
+export function createQueueAlarmRegistration(input) {
     const thresholds = defaultQueueAlertThresholds(input.thresholds);
-    return {
-        ...input,
-        alarms: createQueueAlarmDefinitions({
-            ...input,
-            thresholds,
-        }),
-        dashboardPath: input.dashboard
+    return Object.assign(Object.assign({}, input), { alarms: createQueueAlarmDefinitions(Object.assign(Object.assign({}, input), { thresholds })), dashboardPath: input.dashboard
             ? createDashboardPath({
                 app: input.app,
                 dashboard: input.dashboard,
                 stage: input.stage,
             })
-            : undefined,
-        thresholds,
-    };
+            : undefined, thresholds });
 }
-function createAppGroupMetricDimensions(input, extra = {}) {
+// Baseline alarms for an event consumer on the shared core bus
+// (rule -> SQS buffer -> Lambda, DLQ on the buffer):
+//
+//   - DLQ depth >= 1 (critical): a poison event exhausted its retries and
+//     needs manual redrive — this is the primary signal.
+//   - Buffer queue depth / in-flight / age (standard queue thresholds): the
+//     consumer is falling behind its publisher.
+export function defineEventConsumerAlarms(input) {
+    var _a;
+    const bufferAlarms = createQueueAlarmDefinitions({
+        app: input.app,
+        queue: input.queueName,
+        severity: (_a = input.severity) !== null && _a !== void 0 ? _a : 'high',
+        stage: input.stage,
+        thresholds: input.thresholds,
+    });
+    const dlqAlarm = {
+        comparisonOperator: 'GreaterThanOrEqualToThreshold',
+        description: `Dead-lettered ${input.consumer} events in ${input.dlqName} — a poison event exhausted its retries and needs redrive.`,
+        dimensions: {
+            QueueName: input.dlqName,
+        },
+        evaluationPeriods: 1,
+        metricName: 'ApproximateNumberOfMessagesVisible',
+        name: createAlarmName({
+            app: input.app,
+            component: `${input.consumer}-event-dlq`,
+            metric: 'dead-lettered-events',
+            severity: 'critical',
+            stage: input.stage,
+        }),
+        namespace: 'AWS/SQS',
+        periodSeconds: 60,
+        severity: 'critical',
+        threshold: 1,
+    };
     return {
-        App: input.app,
-        Stage: input.stage,
-        ...extra,
+        alarms: [dlqAlarm, ...bufferAlarms],
+        app: input.app,
+        consumer: input.consumer,
+        dlqName: input.dlqName,
+        queueName: input.queueName,
+        stage: input.stage,
     };
 }
-function createDefaultAppGroupAlarmDefinitions(input) {
+function createAppGroupMetricDimensions(input, extra = {}) {
+    return Object.assign({ App: input.app, Stage: input.stage }, extra);
+}
+export function createDefaultAppGroupAlarmDefinitions(input) {
+    var _a, _b;
     const namespace = createMetricNamespace(input.app);
     const alarms = [
         {
@@ -160,7 +176,7 @@ function createDefaultAppGroupAlarmDefinitions(input) {
             threshold: 1,
         },
     ];
-    for (const webApp of input.webApps ?? []) {
+    for (const webApp of (_a = input.webApps) !== null && _a !== void 0 ? _a : []) {
         alarms.push({
             comparisonOperator: 'GreaterThanOrEqualToThreshold',
             description: `5xx responses for ${input.app}/${webApp} exceed the web baseline threshold.`,
@@ -182,7 +198,7 @@ function createDefaultAppGroupAlarmDefinitions(input) {
             threshold: 1,
         });
     }
-    for (const functionName of input.functions ?? []) {
+    for (const functionName of (_b = input.functions) !== null && _b !== void 0 ? _b : []) {
         alarms.push({
             comparisonOperator: 'GreaterThanOrEqualToThreshold',
             description: `Lambda errors for ${input.app}/${functionName} exceed the function baseline threshold.`,
@@ -224,14 +240,11 @@ function createDefaultAppGroupAlarmDefinitions(input) {
     });
     return alarms;
 }
-function createAppGroupObservabilityRegistration(input) {
-    const owner = input.owner ?? 'product';
-    const summary = input.summary ??
-        `${input.app} app-group CloudWatch baseline for runtime health, web health, function errors, and smoke validation.`;
-    return {
-        ...input,
-        alarms: createDefaultAppGroupAlarmDefinitions(input),
-        dashboards: [
+export function createAppGroupObservabilityRegistration(input) {
+    var _a, _b;
+    const owner = (_a = input.owner) !== null && _a !== void 0 ? _a : 'product';
+    const summary = (_b = input.summary) !== null && _b !== void 0 ? _b : `${input.app} app-group CloudWatch baseline for runtime health, web health, function errors, and smoke validation.`;
+    return Object.assign(Object.assign({}, input), { alarms: createDefaultAppGroupAlarmDefinitions(input), dashboards: [
             createDashboardRegistration({
                 app: input.app,
                 dashboard: 'operations',
@@ -239,12 +252,9 @@ function createAppGroupObservabilityRegistration(input) {
                 stage: input.stage,
                 title: `${input.app} Operations`,
             }),
-        ],
-        owner,
-        queues: [],
-        summary,
-    };
+        ], owner, queues: [], summary });
 }
-function defineAppGroupMonitoringRegistration(registration) {
+export function defineAppGroupMonitoringRegistration(registration) {
     return registration;
 }
+//# sourceMappingURL=observability.js.map

package/src/observability.js.map

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

package/{dist → src}/request-context.d.ts

@@ -7,25 +7,35 @@ export interface RequestActor {
 export interface RequestContext {
     app: string;
     actor?: RequestActor;
+    causationId?: string;
     correlationId: string;
     metadata: RequestMetadata;
     operation: string;
     requestId: string;
     source?: string;
     stage?: string;
+    tenantId?: string;
+    traceParent?: string;
+    traceState?: string;
 }
 export interface RequestContextInput {
     app: string;
     actor?: RequestActor;
+    causationId?: string;
     correlationId?: string;
     metadata?: Record<string, RequestMetadataValue | undefined>;
     operation: string;
     requestId?: string;
     source?: string;
     stage?: string;
+    tenantId?: string;
+    traceParent?: string;
+    traceState?: string;
 }
+export declare function normalizePropagationId(value: string | null | undefined): string | undefined;
+export declare function normalizeTraceParent(value: string | null | undefined): string | undefined;
+export declare function normalizeTraceState(value: string | null | undefined): string | undefined;
 export declare function createRequestContext(input: RequestContextInput): RequestContext;
 export declare function extendRequestContext(context: RequestContext, overrides?: Partial<RequestContextInput>): RequestContext;
-export declare function toRequestHeaders(context: Pick<RequestContext, 'correlationId' | 'requestId'>): Record<string, string>;
+export declare function toRequestHeaders(context: Pick<RequestContext, 'correlationId' | 'requestId' | 'traceParent' | 'traceState'>): Record<string, string>;
 export declare function toRequestLogMetadata(context: Partial<RequestContext>): RequestMetadata;
-//# sourceMappingURL=request-context.d.ts.map

package/src/request-context.js

@@ -0,0 +1,68 @@
+import { randomUUID } from 'node:crypto';
+const PROPAGATION_ID_PATTERN = /^[A-Za-z0-9._:/-]{1,128}$/;
+const TRACE_PARENT_PATTERN = /^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/;
+export function normalizePropagationId(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim();
+    return normalized && PROPAGATION_ID_PATTERN.test(normalized)
+        ? normalized
+        : undefined;
+}
+export function normalizeTraceParent(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    return normalized && TRACE_PARENT_PATTERN.test(normalized)
+        ? normalized
+        : undefined;
+}
+export function normalizeTraceState(value) {
+    const normalized = value === null || value === void 0 ? void 0 : value.trim();
+    return normalized && normalized.length <= 512 && !/[\r\n]/.test(normalized)
+        ? normalized
+        : undefined;
+}
+function normalizeMetadata(metadata) {
+    const entries = Object.entries(metadata !== null && metadata !== void 0 ? metadata : {}).filter(([, value]) => value !== undefined);
+    return Object.fromEntries(entries);
+}
+export function createRequestContext(input) {
+    var _a, _b;
+    const requestId = (_a = normalizePropagationId(input.requestId)) !== null && _a !== void 0 ? _a : randomUUID();
+    return {
+        app: input.app,
+        actor: input.actor,
+        causationId: normalizePropagationId(input.causationId),
+        correlationId: (_b = normalizePropagationId(input.correlationId)) !== null && _b !== void 0 ? _b : requestId,
+        metadata: normalizeMetadata(input.metadata),
+        operation: input.operation,
+        requestId,
+        source: input.source,
+        stage: input.stage,
+        tenantId: normalizePropagationId(input.tenantId),
+        traceParent: normalizeTraceParent(input.traceParent),
+        traceState: normalizeTraceState(input.traceState),
+    };
+}
+export function extendRequestContext(context, overrides = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    return {
+        app: (_a = overrides.app) !== null && _a !== void 0 ? _a : context.app,
+        actor: (_b = overrides.actor) !== null && _b !== void 0 ? _b : context.actor,
+        causationId: (_c = normalizePropagationId(overrides.causationId)) !== null && _c !== void 0 ? _c : context.causationId,
+        correlationId: (_d = normalizePropagationId(overrides.correlationId)) !== null && _d !== void 0 ? _d : context.correlationId,
+        metadata: Object.assign(Object.assign({}, context.metadata), normalizeMetadata(overrides.metadata)),
+        operation: (_e = overrides.operation) !== null && _e !== void 0 ? _e : context.operation,
+        requestId: (_f = overrides.requestId) !== null && _f !== void 0 ? _f : context.requestId,
+        source: (_g = overrides.source) !== null && _g !== void 0 ? _g : context.source,
+        stage: (_h = overrides.stage) !== null && _h !== void 0 ? _h : context.stage,
+        tenantId: (_j = normalizePropagationId(overrides.tenantId)) !== null && _j !== void 0 ? _j : context.tenantId,
+        traceParent: (_k = normalizeTraceParent(overrides.traceParent)) !== null && _k !== void 0 ? _k : context.traceParent,
+        traceState: (_l = normalizeTraceState(overrides.traceState)) !== null && _l !== void 0 ? _l : context.traceState,
+    };
+}
+export function toRequestHeaders(context) {
+    return Object.assign(Object.assign({ 'x-causation-id': context.requestId, 'x-correlation-id': context.correlationId, 'x-request-id': context.requestId }, (context.traceParent ? { traceparent: context.traceParent } : {})), (context.traceState ? { tracestate: context.traceState } : {}));
+}
+export function toRequestLogMetadata(context) {
+    var _a, _b;
+    return normalizeMetadata(Object.assign({ actorId: (_a = context.actor) === null || _a === void 0 ? void 0 : _a.id, actorType: (_b = context.actor) === null || _b === void 0 ? void 0 : _b.type, app: context.app, causationId: context.causationId, correlationId: context.correlationId, operation: context.operation, requestId: context.requestId, source: context.source, stage: context.stage, tenantId: context.tenantId, traceParent: context.traceParent, traceState: context.traceState }, context.metadata));
+}
+//# sourceMappingURL=request-context.js.map

package/src/request-context.js.map

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

package/{dist → src}/response.d.ts

@@ -58,4 +58,3 @@ export declare class RuntimeError extends Error {
 export declare function isRuntimeError(error: unknown): error is RuntimeError;
 export declare function createSuccessResponse<T, M extends ResponseMetadata = ResponseMetadata>(data: T, options?: CreateSuccessResponseOptions<M>): SuccessResponse<T, M>;
 export declare function createErrorResponse<M extends ResponseMetadata = ResponseMetadata>(error: unknown, options?: CreateErrorResponseOptions<M>): ErrorResponse<M>;
-//# sourceMappingURL=response.d.ts.map

package/src/response.js

@@ -0,0 +1,66 @@
+export const responseContract = {
+    exportPath: '@empire-builder-kit/runtime/response',
+    packageName: '@empire-builder-kit/runtime',
+};
+export class RuntimeError extends Error {
+    constructor(options) {
+        var _a, _b, _c;
+        super(options.message);
+        this.name = 'RuntimeError';
+        this.code = options.code;
+        this.details = options.details;
+        this.status = (_a = options.status) !== null && _a !== void 0 ? _a : 500;
+        this.retryable = (_b = options.retryable) !== null && _b !== void 0 ? _b : false;
+        this.expose = (_c = options.expose) !== null && _c !== void 0 ? _c : this.status < 500;
+    }
+}
+export function isRuntimeError(error) {
+    return error instanceof RuntimeError;
+}
+export function createSuccessResponse(data, options = {}) {
+    var _a;
+    return compactObject({
+        data,
+        meta: options.meta,
+        ok: true,
+        status: (_a = options.status) !== null && _a !== void 0 ? _a : 200,
+    });
+}
+export function createErrorResponse(error, options = {}) {
+    var _a, _b;
+    const normalized = normalizeError(error, options);
+    const expose = normalized.expose;
+    return compactObject({
+        error: compactObject({
+            code: expose
+                ? normalized.code
+                : ((_a = options.fallbackCode) !== null && _a !== void 0 ? _a : 'internal_error'),
+            details: expose && options.includeDetails !== false
+                ? normalized.details
+                : undefined,
+            message: expose
+                ? normalized.message
+                : ((_b = options.fallbackMessage) !== null && _b !== void 0 ? _b : 'Internal server error'),
+            retryable: normalized.retryable,
+        }),
+        meta: options.meta,
+        ok: false,
+        status: normalized.status,
+    });
+}
+function normalizeError(error, options) {
+    var _a, _b;
+    if (isRuntimeError(error)) {
+        return error;
+    }
+    return new RuntimeError({
+        code: (_a = options.fallbackCode) !== null && _a !== void 0 ? _a : 'internal_error',
+        expose: false,
+        message: (_b = options.fallbackMessage) !== null && _b !== void 0 ? _b : 'Internal server error',
+        status: 500,
+    });
+}
+function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+//# sourceMappingURL=response.js.map

package/src/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../packages/runtime/src/response.ts"],"names":[],"mappings":"AA8DA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,sCAAsC;IAClD,WAAW,EAAE,6BAA6B;CAClC,CAAC;AAEX,MAAM,OAAO,YAAa,SAAQ,KAAK;IAOrC,YAAY,OAA4B;;QACtC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,GAAG,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,MAAA,OAAO,CAAC,SAAS,mCAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACpD,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAInC,IAAO,EACP,UAA2C,EAAE;;IAE7C,OAAO,aAAa,CAAC;QACnB,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,IAAa;QACjB,MAAM,EAAE,MAAA,OAAO,CAAC,MAAM,mCAAI,GAAG;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAGjC,KAAc,EACd,UAAyC,EAAE;;IAE3C,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAEjC,OAAO,aAAa,CAAC;QACnB,KAAK,EAAE,aAAa,CAAC;YACnB,IAAI,EAAE,MAAM;gBACV,CAAC,CAAC,UAAU,CAAC,IAAI;gBACjB,CAAC,CAAC,CAAC,MAAA,OAAO,CAAC,YAAY,mCAAI,gBAAgB,CAAC;YAC9C,OAAO,EACL,MAAM,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK;gBACxC,CAAC,CAAC,UAAU,CAAC,OAAO;gBACpB,CAAC,CAAC,SAAS;YACf,OAAO,EAAE,MAAM;gBACb,CAAC,CAAC,UAAU,CAAC,OAAO;gBACpB,CAAC,CAAC,CAAC,MAAA,OAAO,CAAC,eAAe,mCAAI,uBAAuB,CAAC;YACxD,SAAS,EAAE,UAAU,CAAC,SAAS;SAChC,CAAC;QACF,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,KAAc;QAClB,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CACrB,KAAc,EACd,OAAsC;;IAEtC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,MAAA,OAAO,CAAC,YAAY,mCAAI,gBAAgB;QAC9C,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,MAAA,OAAO,CAAC,eAAe,mCAAI,uBAAuB;QAC3D,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAoC,KAAQ;IAChE,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAC5D,CAAC;AACT,CAAC"}

package/dist/auth-backend.d.ts

@@ -1,18 +0,0 @@
-import { BetterAuthConfig, AuthenticatedSession } from './auth';
-import { type JWTVerifyGetKey } from 'jose';
-/**
- * Verifies a Cognito JWT token and returns a typed session.
- * Uses the Cognito JWKS endpoint for validation.
- */
-export interface CognitoJwtVerifier {
-    verify(token: string): Promise<AuthenticatedSession>;
-}
-export interface CognitoJwtVerifierOptions {
-    jwks?: JWTVerifyGetKey;
-}
-export declare function createCognitoJwtVerifier(config: BetterAuthConfig, options?: CognitoJwtVerifierOptions): CognitoJwtVerifier;
-/**
- * Extracts a Bearer token from an Authorization header.
- */
-export declare function extractBearerToken(authHeader: string | undefined): string | null;
-//# sourceMappingURL=auth-backend.d.ts.map

package/dist/auth-backend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-backend.d.ts","sourceRoot":"","sources":["../src/auth-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,oBAAoB,EACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,MAAM,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AA+BD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAmCpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAKf"}

package/dist/auth-backend.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCognitoJwtVerifier = createCognitoJwtVerifier;
-exports.extractBearerToken = extractBearerToken;
-const auth_1 = require("./auth");
-const jose_1 = require("jose");
-function hasExpectedAudience(payload, clientId) {
-    return (payload.aud === clientId ||
-        (Array.isArray(payload.aud) && payload.aud.includes(clientId)) ||
-        payload.client_id === clientId);
-}
-function normalizeGroups(groups) {
-    if (!Array.isArray(groups)) {
-        return undefined;
-    }
-    const normalized = groups.filter((group) => typeof group === 'string');
-    return normalized.length > 0 ? normalized : undefined;
-}
-function createCognitoJwtVerifier(config, options = {}) {
-    const jwks = options.jwks ??
-        (0, jose_1.createRemoteJWKSet)(new URL(`${config.issuerUrl}/.well-known/jwks.json`));
-    return {
-        async verify(token) {
-            const parts = token.split('.');
-            if (parts.length !== 3) {
-                throw new Error('Invalid JWT format');
-            }
-            const { payload } = await (0, jose_1.jwtVerify)(token, jwks, {
-                algorithms: ['RS256'],
-                issuer: config.issuerUrl,
-            });
-            if (!hasExpectedAudience(payload, config.clientId)) {
-                throw new Error('Invalid audience');
-            }
-            if (!payload.sub) {
-                throw new Error('Invalid subject');
-            }
-            return (0, auth_1.sessionFromCognitoToken)({
-                sub: payload.sub,
-                email: payload.email,
-                'cognito:username': payload['cognito:username'],
-                'cognito:groups': normalizeGroups(payload['cognito:groups']),
-                exp: payload.exp,
-                iat: payload.iat,
-            });
-        },
-    };
-}
-/**
- * Extracts a Bearer token from an Authorization header.
- */
-function extractBearerToken(authHeader) {
-    if (!authHeader?.startsWith('Bearer ')) {
-        return null;
-    }
-    return authHeader.slice(7).trim() || null;
-}