@empire-builder-kit/runtime 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,28 @@
+# @empire-builder-kit/runtime
+
+Publishable runtime primitives for Empire Builder Kit workspaces and apps.
+
+## Purpose
+
+- provide a stable runtime dependency for repos generated from `@empire-builder-kit/preset`
+- keep auth/session, frontend client contracts, config parsing, request context, logging, and observability conventions versioned outside a single workspace
+- add shared response and error-envelope helpers so generated repos can return the same public contract by default
+- separate framework runtime contracts from monorepo-only `packages/shared/*` internals
+
+## Exports
+
+- `@empire-builder-kit/runtime`
+- `@empire-builder-kit/runtime/auth`
+- `@empire-builder-kit/runtime/config`
+- `@empire-builder-kit/runtime/frontend`
+- `@empire-builder-kit/runtime/request-context`
+- `@empire-builder-kit/runtime/logging`
+- `@empire-builder-kit/runtime/observability`
+- `@empire-builder-kit/runtime/response`
+
+## Verification
+
+- `pnpm nx build @empire-builder-kit/runtime`
+- `pnpm nx test @empire-builder-kit/runtime`
+- `pnpm nx lint @empire-builder-kit/runtime`
+- `pnpm nx typecheck @empire-builder-kit/runtime`

package/dist/auth.d.ts

@@ -0,0 +1,42 @@
+import type { RequestActor, RequestMetadata, RequestMetadataValue } from './request-context';
+export type AuthSessionStatus = 'anonymous' | 'authenticated';
+export interface AuthSessionSubject {
+    displayName?: string;
+    email?: string;
+    id: string;
+    permissions?: string[];
+    roles?: string[];
+    tenantId?: string;
+    type: RequestActor['type'];
+}
+export interface AuthSession {
+    expiresAt?: string;
+    issuedAt?: string;
+    metadata: RequestMetadata;
+    sessionId?: string;
+    status: AuthSessionStatus;
+    subject?: AuthSessionSubject;
+}
+export interface AnonymousSessionInput {
+    expiresAt?: string;
+    issuedAt?: string;
+    metadata?: Record<string, RequestMetadataValue | undefined>;
+    sessionId?: string;
+}
+export interface AuthenticatedSessionInput extends AnonymousSessionInput {
+    subject: AuthSessionSubject;
+}
+export interface AuthenticatedSession extends AuthSession {
+    status: 'authenticated';
+    subject: AuthSessionSubject;
+}
+export declare const authContract: {
+    readonly exportPath: "@empire-builder-kit/runtime/auth";
+    readonly packageName: "@empire-builder-kit/runtime";
+};
+export declare function createAnonymousSession(input?: AnonymousSessionInput): AuthSession;
+export declare function createAuthenticatedSession(input: AuthenticatedSessionInput): AuthenticatedSession;
+export declare function isAuthenticatedSession(session: AuthSession): session is AuthenticatedSession;
+export declare function toRequestActor(session: AuthSession): RequestActor | undefined;
+export declare function toSessionLogMetadata(session: AuthSession): RequestMetadata;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,eAAe,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAmCX,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,qBAA0B,GAChC,WAAW,CAQb;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,GAC/B,oBAAoB,CAMtB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,GACnB,OAAO,IAAI,oBAAoB,CAEjC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAS7E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAe1E"}

package/dist/auth.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authContract = void 0;
+exports.createAnonymousSession = createAnonymousSession;
+exports.createAuthenticatedSession = createAuthenticatedSession;
+exports.isAuthenticatedSession = isAuthenticatedSession;
+exports.toRequestActor = toRequestActor;
+exports.toSessionLogMetadata = toSessionLogMetadata;
+exports.authContract = {
+    exportPath: '@empire-builder-kit/runtime/auth',
+    packageName: '@empire-builder-kit/runtime',
+};
+function normalizeMetadata(metadata) {
+    const entries = Object.entries(metadata ?? {}).filter(([, value]) => value !== undefined);
+    return Object.fromEntries(entries);
+}
+function normalizeList(values) {
+    const normalized = (values ?? [])
+        .map((value) => value.trim())
+        .filter(Boolean);
+    if (normalized.length === 0) {
+        return undefined;
+    }
+    return [...new Set(normalized)];
+}
+function normalizeSubject(subject) {
+    return {
+        ...subject,
+        displayName: subject.displayName?.trim() || undefined,
+        email: subject.email?.trim() || undefined,
+        permissions: normalizeList(subject.permissions),
+        roles: normalizeList(subject.roles),
+        tenantId: subject.tenantId?.trim() || undefined,
+    };
+}
+function createAnonymousSession(input = {}) {
+    return {
+        expiresAt: input.expiresAt,
+        issuedAt: input.issuedAt,
+        metadata: normalizeMetadata(input.metadata),
+        sessionId: input.sessionId,
+        status: 'anonymous',
+    };
+}
+function createAuthenticatedSession(input) {
+    return {
+        ...createAnonymousSession(input),
+        status: 'authenticated',
+        subject: normalizeSubject(input.subject),
+    };
+}
+function isAuthenticatedSession(session) {
+    return session.status === 'authenticated' && session.subject !== undefined;
+}
+function toRequestActor(session) {
+    if (!isAuthenticatedSession(session)) {
+        return undefined;
+    }
+    return {
+        id: session.subject.id,
+        type: session.subject.type,
+    };
+}
+function toSessionLogMetadata(session) {
+    return normalizeMetadata({
+        authExpiresAt: session.expiresAt,
+        authIssuedAt: session.issuedAt,
+        authPermissions: session.subject?.permissions?.join(','),
+        authRoles: session.subject?.roles?.join(','),
+        authSessionId: session.sessionId,
+        authStatus: session.status,
+        authSubjectEmail: session.subject?.email,
+        authSubjectId: session.subject?.id,
+        authSubjectName: session.subject?.displayName,
+        authSubjectType: session.subject?.type,
+        authTenantId: session.subject?.tenantId,
+        ...session.metadata,
+    });
+}

package/dist/config.d.ts

@@ -0,0 +1,52 @@
+export type ConfigSource = Record<string, string | undefined>;
+export interface ConfigIssue {
+    key: string;
+    message: string;
+    value?: string;
+}
+export interface ConfigParserContext {
+    propertyKey: string;
+    source: ConfigSource;
+}
+export type ConfigParser<T> = (context: ConfigParserContext) => T;
+export type ConfigSchema = Record<string, ConfigParser<unknown>>;
+export type InferConfig<S extends ConfigSchema> = {
+    [Key in keyof S]: ReturnType<S[Key]>;
+};
+interface StringOptions {
+    defaultValue?: string;
+    env?: string;
+    minLength?: number;
+    pattern?: RegExp;
+    trim?: boolean;
+}
+interface NumberOptions {
+    defaultValue?: number;
+    env?: string;
+    integer?: boolean;
+    max?: number;
+    min?: number;
+}
+interface BooleanOptions {
+    defaultValue?: boolean;
+    env?: string;
+}
+interface EnumOptions<T extends string> {
+    defaultValue?: T;
+    env?: string;
+}
+export declare class ConfigValidationError extends Error {
+    readonly issues: ConfigIssue[];
+    constructor(issues: ConfigIssue[]);
+}
+export declare function formatConfigIssues(issues: ConfigIssue[]): string;
+export declare function loadConfig<S extends ConfigSchema>(schema: S, source?: ConfigSource): InferConfig<S>;
+export declare function string(options?: StringOptions): ConfigParser<string>;
+export declare function optionalString(options?: Omit<StringOptions, 'defaultValue'> & {
+    defaultValue?: string;
+}): ConfigParser<string | undefined>;
+export declare function number(options?: NumberOptions): ConfigParser<number>;
+export declare function boolean(options?: BooleanOptions): ConfigParser<boolean>;
+export declare function enumValue<const T extends string>(values: readonly T[], options?: EnumOptions<T>): ConfigParser<T>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,KAAK,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI;KAC/C,GAAG,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrC,CAAC;AAEF,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW,CAAC,CAAC,SAAS,MAAM;IACpC,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAYD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;gBAEnB,MAAM,EAAE,WAAW,EAAE;CAKlC;AAwCD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAUhE;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,YAAY,EAC/C,MAAM,EAAE,CAAC,EACT,MAAM,GAAE,YAA0B,GACjC,WAAW,CAAC,CAAC,CAAC,CA4BhB;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CA6BxE;AAED,wBAAgB,cAAc,CAC5B,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CA6BlC;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAiCxE;AAED,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,YAAY,CAAC,OAAO,CAAC,CAyB3E;AAED,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC9C,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAC3B,YAAY,CAAC,CAAC,CAAC,CAmBjB"}

package/dist/config.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationError = void 0;
+exports.formatConfigIssues = formatConfigIssues;
+exports.loadConfig = loadConfig;
+exports.string = string;
+exports.optionalString = optionalString;
+exports.number = number;
+exports.boolean = boolean;
+exports.enumValue = enumValue;
+class ConfigFieldError extends Error {
+    issue;
+    constructor(issue) {
+        super(`${issue.key}: ${issue.message}`);
+        this.name = 'ConfigFieldError';
+        this.issue = issue;
+    }
+}
+class ConfigValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(formatConfigIssues(issues));
+        this.name = 'ConfigValidationError';
+        this.issues = issues;
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+function normalizeEnvKey(propertyKey, env) {
+    if (env) {
+        return env;
+    }
+    return propertyKey
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[\s-]+/g, '_')
+        .toUpperCase();
+}
+function createIssue(key, message, value) {
+    return {
+        key,
+        message,
+        value,
+    };
+}
+function throwFieldError(key, message, value) {
+    throw new ConfigFieldError(createIssue(key, message, value));
+}
+function normalizeStringValue(value, trim = true) {
+    return trim ? value.trim() : value;
+}
+function resolveStringValue(rawValue, defaultValue) {
+    if (rawValue === undefined) {
+        return defaultValue;
+    }
+    return rawValue;
+}
+function formatConfigIssues(issues) {
+    const summary = issues
+        .map(({ key, message, value }) => value === undefined
+        ? `- ${key}: ${message}`
+        : `- ${key}: ${message} (received "${value}")`)
+        .join('\n');
+    return `Invalid configuration:\n${summary}`;
+}
+function loadConfig(schema, source = process.env) {
+    const issues = [];
+    const config = {};
+    for (const [propertyKey, parser] of Object.entries(schema)) {
+        try {
+            config[propertyKey] = parser({
+                propertyKey: String(propertyKey),
+                source,
+            });
+        }
+        catch (error) {
+            if (error instanceof ConfigFieldError) {
+                issues.push(error.issue);
+                continue;
+            }
+            throw error;
+        }
+    }
+    if (issues.length > 0) {
+        throw new ConfigValidationError(issues);
+    }
+    return config;
+}
+function string(options = {}) {
+    return ({ propertyKey, source }) => {
+        const envKey = normalizeEnvKey(propertyKey, options.env);
+        const rawValue = resolveStringValue(source[envKey], options.defaultValue);
+        if (rawValue === undefined) {
+            throwFieldError(envKey, 'is required');
+        }
+        const value = normalizeStringValue(rawValue, options.trim !== false);
+        if (value.length === 0) {
+            throwFieldError(envKey, 'must not be empty', rawValue);
+        }
+        if (options.minLength !== undefined && value.length < options.minLength) {
+            throwFieldError(envKey, `must be at least ${options.minLength} characters`, value);
+        }
+        if (options.pattern && !options.pattern.test(value)) {
+            throwFieldError(envKey, 'does not match the expected pattern', value);
+        }
+        return value;
+    };
+}
+function optionalString(options = {}) {
+    return ({ propertyKey, source }) => {
+        const envKey = normalizeEnvKey(propertyKey, options.env);
+        const rawValue = resolveStringValue(source[envKey], options.defaultValue);
+        if (rawValue === undefined) {
+            return undefined;
+        }
+        const value = normalizeStringValue(rawValue, options.trim !== false);
+        if (value.length === 0) {
+            return undefined;
+        }
+        if (options.minLength !== undefined && value.length < options.minLength) {
+            throwFieldError(envKey, `must be at least ${options.minLength} characters`, value);
+        }
+        if (options.pattern && !options.pattern.test(value)) {
+            throwFieldError(envKey, 'does not match the expected pattern', value);
+        }
+        return value;
+    };
+}
+function number(options = {}) {
+    return ({ propertyKey, source }) => {
+        const envKey = normalizeEnvKey(propertyKey, options.env);
+        const rawValue = source[envKey];
+        if (rawValue === undefined || rawValue.trim().length === 0) {
+            if (options.defaultValue !== undefined) {
+                return options.defaultValue;
+            }
+            throwFieldError(envKey, 'is required', rawValue);
+        }
+        const value = Number(rawValue);
+        if (Number.isNaN(value)) {
+            throwFieldError(envKey, 'must be a valid number', rawValue);
+        }
+        if (options.integer && !Number.isInteger(value)) {
+            throwFieldError(envKey, 'must be an integer', rawValue);
+        }
+        if (options.min !== undefined && value < options.min) {
+            throwFieldError(envKey, `must be at least ${options.min}`, rawValue);
+        }
+        if (options.max !== undefined && value > options.max) {
+            throwFieldError(envKey, `must be at most ${options.max}`, rawValue);
+        }
+        return value;
+    };
+}
+function boolean(options = {}) {
+    return ({ propertyKey, source }) => {
+        const envKey = normalizeEnvKey(propertyKey, options.env);
+        const rawValue = source[envKey];
+        if (rawValue === undefined || rawValue.trim().length === 0) {
+            if (options.defaultValue !== undefined) {
+                return options.defaultValue;
+            }
+            throwFieldError(envKey, 'is required', rawValue);
+        }
+        const normalized = rawValue.trim().toLowerCase();
+        if (['true', '1', 'yes', 'on'].includes(normalized)) {
+            return true;
+        }
+        if (['false', '0', 'no', 'off'].includes(normalized)) {
+            return false;
+        }
+        throwFieldError(envKey, 'must be a boolean value', rawValue);
+    };
+}
+function enumValue(values, options = {}) {
+    return ({ propertyKey, source }) => {
+        const envKey = normalizeEnvKey(propertyKey, options.env);
+        const rawValue = resolveStringValue(source[envKey], options.defaultValue);
+        if (rawValue === undefined) {
+            throwFieldError(envKey, 'is required');
+        }
+        if (!values.includes(rawValue)) {
+            throwFieldError(envKey, `must be one of ${values.map((value) => `"${value}"`).join(', ')}`, rawValue);
+        }
+        return rawValue;
+    };
+}

package/dist/frontend.d.ts

@@ -0,0 +1,42 @@
+import type { AuthSessionStatus } from './auth';
+export type FrontendRuntime = 'web' | 'mobile';
+export type FrontendDeploymentMode = 'opennext' | 'container' | 'static-export' | 'expo';
+export type FrontendSessionTransport = 'cookie' | 'bearer' | 'none';
+export type FrontendSessionStorage = 'server' | 'secure-store' | 'memory';
+export interface FrontendAuthContract {
+    exportPath: '@empire-builder-kit/runtime/auth';
+    initialStatus: AuthSessionStatus;
+    storage: FrontendSessionStorage;
+    transport: FrontendSessionTransport;
+}
+export interface FrontendApiContract {
+    sameScopeImportPrefix: string;
+    sdkPackage: string;
+}
+export interface FrontendDeploymentContract {
+    mode: FrontendDeploymentMode;
+    publicBaseUrlEnvVar: string;
+    stageEnvVar: string;
+}
+export interface FrontendClientContract {
+    api: FrontendApiContract;
+    app: string;
+    auth: FrontendAuthContract;
+    client: string;
+    deployment: FrontendDeploymentContract;
+    runtime: FrontendRuntime;
+}
+export interface FrontendClientContractInput {
+    api?: Partial<FrontendApiContract>;
+    app: string;
+    auth?: Partial<Omit<FrontendAuthContract, 'exportPath'>>;
+    client: string;
+    deployment?: Partial<FrontendDeploymentContract>;
+    runtime: FrontendRuntime;
+}
+export declare const frontendContract: {
+    readonly exportPath: "@empire-builder-kit/runtime/frontend";
+    readonly packageName: "@empire-builder-kit/runtime";
+};
+export declare function createFrontendClientContract(input: FrontendClientContractInput): FrontendClientContract;
+//# sourceMappingURL=frontend.d.ts.map

package/dist/frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.d.ts","sourceRoot":"","sources":["../src/frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,WAAW,GACX,eAAe,GACf,MAAM,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,kCAAkC,CAAC;IAC/C,aAAa,EAAE,iBAAiB,CAAC;IACjC,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,wBAAwB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,0BAA0B,CAAC;IACvC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACjD,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAsCX,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAkCxB"}

package/dist/frontend.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frontendContract = void 0;
+exports.createFrontendClientContract = createFrontendClientContract;
+exports.frontendContract = {
+    exportPath: '@empire-builder-kit/runtime/frontend',
+    packageName: '@empire-builder-kit/runtime',
+};
+function trimOrFallback(value, fallback) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : fallback;
+}
+function defaultsForRuntime(runtime) {
+    if (runtime === 'mobile') {
+        return {
+            auth: {
+                initialStatus: 'anonymous',
+                storage: 'secure-store',
+                transport: 'bearer',
+            },
+            deployment: {
+                mode: 'expo',
+                publicBaseUrlEnvVar: 'EXPO_PUBLIC_API_BASE_URL',
+                stageEnvVar: 'EXPO_PUBLIC_STAGE',
+            },
+        };
+    }
+    return {
+        auth: {
+            initialStatus: 'anonymous',
+            storage: 'server',
+            transport: 'cookie',
+        },
+        deployment: {
+            mode: 'opennext',
+            publicBaseUrlEnvVar: 'NEXT_PUBLIC_APP_URL',
+            stageEnvVar: 'NEXT_PUBLIC_STAGE',
+        },
+    };
+}
+function createFrontendClientContract(input) {
+    const runtimeDefaults = defaultsForRuntime(input.runtime);
+    const app = trimOrFallback(input.app, 'app');
+    return {
+        api: {
+            sameScopeImportPrefix: trimOrFallback(input.api?.sameScopeImportPrefix, `@${app}/`),
+            sdkPackage: trimOrFallback(input.api?.sdkPackage, `@${app}/sdk/client`),
+        },
+        app,
+        auth: {
+            exportPath: '@empire-builder-kit/runtime/auth',
+            initialStatus: input.auth?.initialStatus ?? runtimeDefaults.auth.initialStatus,
+            storage: input.auth?.storage ?? runtimeDefaults.auth.storage,
+            transport: input.auth?.transport ?? runtimeDefaults.auth.transport,
+        },
+        client: trimOrFallback(input.client, `${app}-${input.runtime}`),
+        deployment: {
+            mode: input.deployment?.mode ?? runtimeDefaults.deployment.mode,
+            publicBaseUrlEnvVar: trimOrFallback(input.deployment?.publicBaseUrlEnvVar, runtimeDefaults.deployment.publicBaseUrlEnvVar),
+            stageEnvVar: trimOrFallback(input.deployment?.stageEnvVar, runtimeDefaults.deployment.stageEnvVar),
+        },
+        runtime: input.runtime,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './auth';
+export * from './config';
+export * from './frontend';
+export * from './logging';
+export * from './observability';
+export * from './request-context';
+export * from './response';
+export declare const runtimePackage: {
+    readonly exports: readonly ["@empire-builder-kit/runtime/auth", "@empire-builder-kit/runtime/config", "@empire-builder-kit/runtime/frontend", "@empire-builder-kit/runtime/request-context", "@empire-builder-kit/runtime/logging", "@empire-builder-kit/runtime/observability", "@empire-builder-kit/runtime/response"];
+    readonly name: "@empire-builder-kit/runtime";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,cAAc;;;CAWjB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimePackage = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./auth"), exports);
+tslib_1.__exportStar(require("./config"), exports);
+tslib_1.__exportStar(require("./frontend"), exports);
+tslib_1.__exportStar(require("./logging"), exports);
+tslib_1.__exportStar(require("./observability"), exports);
+tslib_1.__exportStar(require("./request-context"), exports);
+tslib_1.__exportStar(require("./response"), exports);
+exports.runtimePackage = {
+    exports: [
+        '@empire-builder-kit/runtime/auth',
+        '@empire-builder-kit/runtime/config',
+        '@empire-builder-kit/runtime/frontend',
+        '@empire-builder-kit/runtime/request-context',
+        '@empire-builder-kit/runtime/logging',
+        '@empire-builder-kit/runtime/observability',
+        '@empire-builder-kit/runtime/response',
+    ],
+    name: '@empire-builder-kit/runtime',
+};

package/dist/logging.d.ts

@@ -0,0 +1,70 @@
+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;
+}
+export interface SerializedError {
+    code?: number | string;
+    message: string;
+    name: string;
+    stack?: string;
+}
+export interface LogEntry {
+    app: string;
+    correlationId?: string;
+    error?: SerializedError;
+    level: LogLevel;
+    message: string;
+    metadata?: LogMetadata;
+    requestId?: string;
+    service?: string;
+    stage?: string;
+    timestamp: string;
+}
+export interface LogEventInput {
+    context?: LoggerContext;
+    error?: unknown;
+    metadata?: LogMetadata;
+}
+export interface ChildLoggerOptions {
+    context?: LoggerContext;
+    metadata?: LogMetadata;
+    service?: string;
+    stage?: string;
+}
+export interface CreateLoggerOptions {
+    app: string;
+    context?: LoggerContext;
+    metadata?: LogMetadata;
+    now?: () => Date;
+    service?: string;
+    sink?: (entry: LogEntry) => void;
+    stage?: 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;
+}
+export declare const loggingContract: {
+    readonly defaultFormat: "json";
+    readonly exportPath: "@empire-builder-kit/runtime/logging";
+    readonly packageName: "@empire-builder-kit/runtime";
+};
+export declare function serializeError(error: unknown): SerializedError;
+export declare function consoleSink(entry: LogEntry): void;
+export declare function createLogger(options: CreateLoggerOptions): Logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

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

package/dist/logging.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loggingContract = void 0;
+exports.serializeError = serializeError;
+exports.consoleSink = consoleSink;
+exports.createLogger = createLogger;
+exports.loggingContract = {
+    defaultFormat: 'json',
+    exportPath: '@empire-builder-kit/runtime/logging',
+    packageName: '@empire-builder-kit/runtime',
+};
+function mergeContext(base, overrides) {
+    if (!base && !overrides) {
+        return undefined;
+    }
+    return {
+        actor: overrides?.actor ?? base?.actor,
+        correlationId: overrides?.correlationId ?? base?.correlationId,
+        metadata: {
+            ...(base?.metadata ?? {}),
+            ...(overrides?.metadata ?? {}),
+        },
+        operation: overrides?.operation ?? base?.operation,
+        requestId: overrides?.requestId ?? base?.requestId,
+        source: overrides?.source ?? base?.source,
+        stage: overrides?.stage ?? base?.stage,
+    };
+}
+function contextMetadata(context) {
+    if (!context) {
+        return {};
+    }
+    return compactObject({
+        actorId: context.actor?.id,
+        actorType: context.actor?.type,
+        operation: context.operation,
+        source: context.source,
+        ...(context.metadata ?? {}),
+    });
+}
+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 {
+        return String(value);
+    }
+}
+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',
+    };
+}
+function consoleSink(entry) {
+    console.log(JSON.stringify(entry));
+}
+function createLogger(options) {
+    const sink = options.sink ?? consoleSink;
+    const now = options.now ?? (() => new Date());
+    const write = (level, message, input = {}) => {
+        const mergedContext = mergeContext(options.context, input.context);
+        const metadata = compactObject({
+            ...(options.metadata ?? {}),
+            ...contextMetadata(mergedContext),
+            ...(input.metadata ?? {}),
+        });
+        const entry = compactObject({
+            app: options.app,
+            correlationId: mergedContext?.correlationId,
+            error: input.error === undefined ? undefined : serializeError(input.error),
+            level,
+            message,
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            requestId: mergedContext?.requestId,
+            service: options.service,
+            stage: mergedContext?.stage ?? options.stage,
+            timestamp: now().toISOString(),
+        });
+        sink(entry);
+        return entry;
+    };
+    return {
+        child(childOptions = {}) {
+            return createLogger({
+                app: options.app,
+                context: mergeContext(options.context, childOptions.context),
+                metadata: {
+                    ...(options.metadata ?? {}),
+                    ...(childOptions.metadata ?? {}),
+                },
+                now,
+                service: childOptions.service ?? options.service,
+                sink,
+                stage: childOptions.stage ?? 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);
+        },
+    };
+}

package/dist/observability.d.ts

@@ -0,0 +1,71 @@
+export type AlarmSeverity = 'low' | 'medium' | 'high' | 'critical';
+export interface QueueAlertThresholds {
+    messagesInFlight: number;
+    messagesVisible: number;
+    oldestMessageAgeSeconds: number;
+}
+export interface AlarmDefinition {
+    comparisonOperator: 'GreaterThanOrEqualToThreshold';
+    description: string;
+    dimensions: Record<string, string>;
+    evaluationPeriods: number;
+    metricName: string;
+    name: string;
+    namespace: string;
+    periodSeconds: number;
+    severity: AlarmSeverity;
+    threshold: number;
+}
+export interface AlarmNameInput {
+    app: string;
+    component: string;
+    metric: string;
+    severity?: AlarmSeverity;
+    stage: string;
+}
+export interface QueueAlarmInput {
+    app: string;
+    queue: string;
+    severity?: AlarmSeverity;
+    stage: string;
+    thresholds?: Partial<QueueAlertThresholds>;
+}
+export interface DashboardPathInput {
+    app: string;
+    dashboard: string;
+    stage: string;
+}
+export interface DashboardRegistrationInput extends DashboardPathInput {
+    description: string;
+    title: string;
+}
+export interface MonitoringDashboardRegistration extends DashboardPathInput, Pick<DashboardRegistrationInput, 'description' | 'title'> {
+    path: string;
+}
+export interface QueueAlarmRegistrationInput extends QueueAlarmInput {
+    dashboard?: string;
+    summary: string;
+}
+export interface QueueAlarmRegistration extends QueueAlarmInput {
+    alarms: AlarmDefinition[];
+    dashboardPath?: string;
+    summary: string;
+    thresholds: QueueAlertThresholds;
+}
+export type MonitoringOwner = 'platform' | 'product';
+export interface AppGroupMonitoringRegistration {
+    app: string;
+    dashboards: MonitoringDashboardRegistration[];
+    owner: MonitoringOwner;
+    queues: QueueAlarmRegistration[];
+    summary: string;
+}
+export declare function createMetricNamespace(app: string): string;
+export declare function createAlarmName(input: AlarmNameInput): string;
+export declare function defaultQueueAlertThresholds(overrides?: Partial<QueueAlertThresholds>): QueueAlertThresholds;
+export declare function createQueueAlarmDefinitions(input: QueueAlarmInput): AlarmDefinition[];
+export declare function createDashboardPath(input: DashboardPathInput): string;
+export declare function createDashboardRegistration(input: DashboardRegistrationInput): MonitoringDashboardRegistration;
+export declare function createQueueAlarmRegistration(input: QueueAlarmRegistrationInput): QueueAlarmRegistration;
+export declare function defineAppGroupMonitoringRegistration<T extends AppGroupMonitoringRegistration>(registration: T): T;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

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

package/dist/observability.js

@@ -0,0 +1,134 @@
+"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.defineAppGroupMonitoringRegistration = defineAppGroupMonitoringRegistration;
+function normalizeSegment(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function createMetricNamespace(app) {
+    return `EBK/${normalizeSegment(app)}`;
+}
+function createAlarmName(input) {
+    return [
+        normalizeSegment(input.app),
+        normalizeSegment(input.stage),
+        normalizeSegment(input.component),
+        normalizeSegment(input.metric),
+        normalizeSegment(input.severity ?? 'medium'),
+    ].join('-');
+}
+function defaultQueueAlertThresholds(overrides = {}) {
+    return {
+        messagesInFlight: 10,
+        messagesVisible: 25,
+        oldestMessageAgeSeconds: 300,
+        ...overrides,
+    };
+}
+function createQueueAlarmDefinitions(input) {
+    const thresholds = defaultQueueAlertThresholds(input.thresholds);
+    const namespace = 'AWS/SQS';
+    const severity = input.severity ?? 'high';
+    return [
+        {
+            comparisonOperator: 'GreaterThanOrEqualToThreshold',
+            description: `Visible messages in ${input.queue} exceed the shared queue threshold.`,
+            dimensions: {
+                QueueName: input.queue,
+            },
+            evaluationPeriods: 2,
+            metricName: 'ApproximateNumberOfMessagesVisible',
+            name: createAlarmName({
+                app: input.app,
+                component: input.queue,
+                metric: 'messages-visible',
+                severity,
+                stage: input.stage,
+            }),
+            namespace,
+            periodSeconds: 60,
+            severity,
+            threshold: thresholds.messagesVisible,
+        },
+        {
+            comparisonOperator: 'GreaterThanOrEqualToThreshold',
+            description: `In-flight messages in ${input.queue} exceed the shared queue threshold.`,
+            dimensions: {
+                QueueName: input.queue,
+            },
+            evaluationPeriods: 2,
+            metricName: 'ApproximateNumberOfMessagesNotVisible',
+            name: createAlarmName({
+                app: input.app,
+                component: input.queue,
+                metric: 'messages-in-flight',
+                severity,
+                stage: input.stage,
+            }),
+            namespace,
+            periodSeconds: 60,
+            severity,
+            threshold: thresholds.messagesInFlight,
+        },
+        {
+            comparisonOperator: 'GreaterThanOrEqualToThreshold',
+            description: `Oldest message age in ${input.queue} exceeds the shared queue threshold.`,
+            dimensions: {
+                QueueName: input.queue,
+            },
+            evaluationPeriods: 2,
+            metricName: 'ApproximateAgeOfOldestMessage',
+            name: createAlarmName({
+                app: input.app,
+                component: input.queue,
+                metric: 'oldest-message-age',
+                severity,
+                stage: input.stage,
+            }),
+            namespace,
+            periodSeconds: 60,
+            severity,
+            threshold: thresholds.oldestMessageAgeSeconds,
+        },
+    ];
+}
+function createDashboardPath(input) {
+    return `/${normalizeSegment(input.stage)}/${normalizeSegment(input.app)}/${normalizeSegment(input.dashboard)}`;
+}
+function createDashboardRegistration(input) {
+    return {
+        ...input,
+        path: createDashboardPath(input),
+    };
+}
+function createQueueAlarmRegistration(input) {
+    const thresholds = defaultQueueAlertThresholds(input.thresholds);
+    return {
+        ...input,
+        alarms: createQueueAlarmDefinitions({
+            ...input,
+            thresholds,
+        }),
+        dashboardPath: input.dashboard
+            ? createDashboardPath({
+                app: input.app,
+                dashboard: input.dashboard,
+                stage: input.stage,
+            })
+            : undefined,
+        thresholds,
+    };
+}
+function defineAppGroupMonitoringRegistration(registration) {
+    return registration;
+}

package/dist/request-context.d.ts

@@ -0,0 +1,31 @@
+export type RequestMetadataValue = string | number | boolean | null;
+export type RequestMetadata = Record<string, RequestMetadataValue>;
+export interface RequestActor {
+    id?: string;
+    type: 'service' | 'system' | 'user';
+}
+export interface RequestContext {
+    app: string;
+    actor?: RequestActor;
+    correlationId: string;
+    metadata: RequestMetadata;
+    operation: string;
+    requestId: string;
+    source?: string;
+    stage?: string;
+}
+export interface RequestContextInput {
+    app: string;
+    actor?: RequestActor;
+    correlationId?: string;
+    metadata?: Record<string, RequestMetadataValue | undefined>;
+    operation: string;
+    requestId?: string;
+    source?: string;
+    stage?: string;
+}
+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 toRequestLogMetadata(context: Partial<RequestContext>): RequestMetadata;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,GACzB,cAAc,CAahB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,cAAc,CAchB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,GAAG,WAAW,CAAC,GAC3D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,eAAe,CAYjB"}

package/dist/request-context.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestContext = createRequestContext;
+exports.extendRequestContext = extendRequestContext;
+exports.toRequestHeaders = toRequestHeaders;
+exports.toRequestLogMetadata = toRequestLogMetadata;
+const node_crypto_1 = require("node:crypto");
+function normalizeMetadata(metadata) {
+    const entries = Object.entries(metadata ?? {}).filter(([, value]) => value !== undefined);
+    return Object.fromEntries(entries);
+}
+function createRequestContext(input) {
+    const requestId = input.requestId ?? (0, node_crypto_1.randomUUID)();
+    return {
+        app: input.app,
+        actor: input.actor,
+        correlationId: input.correlationId ?? requestId,
+        metadata: normalizeMetadata(input.metadata),
+        operation: input.operation,
+        requestId,
+        source: input.source,
+        stage: input.stage,
+    };
+}
+function extendRequestContext(context, overrides = {}) {
+    return {
+        app: overrides.app ?? context.app,
+        actor: overrides.actor ?? context.actor,
+        correlationId: overrides.correlationId ?? context.correlationId,
+        metadata: {
+            ...context.metadata,
+            ...normalizeMetadata(overrides.metadata),
+        },
+        operation: overrides.operation ?? context.operation,
+        requestId: overrides.requestId ?? context.requestId,
+        source: overrides.source ?? context.source,
+        stage: overrides.stage ?? context.stage,
+    };
+}
+function toRequestHeaders(context) {
+    return {
+        'x-correlation-id': context.correlationId,
+        'x-request-id': context.requestId,
+    };
+}
+function toRequestLogMetadata(context) {
+    return normalizeMetadata({
+        actorId: context.actor?.id,
+        actorType: context.actor?.type,
+        app: context.app,
+        correlationId: context.correlationId,
+        operation: context.operation,
+        requestId: context.requestId,
+        source: context.source,
+        stage: context.stage,
+        ...context.metadata,
+    });
+}

package/dist/response.d.ts

@@ -0,0 +1,61 @@
+export interface ResponseMetadata {
+    correlationId?: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+export interface SuccessResponse<T, M extends ResponseMetadata = ResponseMetadata> {
+    data: T;
+    meta?: M;
+    ok: true;
+    status: number;
+}
+export interface RuntimeErrorDetails {
+    [key: string]: unknown;
+}
+export interface RuntimeErrorShape {
+    code: string;
+    details?: RuntimeErrorDetails;
+    message: string;
+    retryable: boolean;
+}
+export interface ErrorResponse<M extends ResponseMetadata = ResponseMetadata> {
+    error: RuntimeErrorShape;
+    meta?: M;
+    ok: false;
+    status: number;
+}
+export type AppResponse<T, M extends ResponseMetadata = ResponseMetadata> = ErrorResponse<M> | SuccessResponse<T, M>;
+export interface RuntimeErrorOptions {
+    code: string;
+    details?: RuntimeErrorDetails;
+    expose?: boolean;
+    message: string;
+    retryable?: boolean;
+    status?: number;
+}
+export interface CreateErrorResponseOptions<M extends ResponseMetadata = ResponseMetadata> {
+    fallbackCode?: string;
+    fallbackMessage?: string;
+    includeDetails?: boolean;
+    meta?: M;
+}
+export interface CreateSuccessResponseOptions<M extends ResponseMetadata = ResponseMetadata> {
+    meta?: M;
+    status?: number;
+}
+export declare const responseContract: {
+    readonly exportPath: "@empire-builder-kit/runtime/response";
+    readonly packageName: "@empire-builder-kit/runtime";
+};
+export declare class RuntimeError extends Error {
+    readonly code: string;
+    readonly details?: RuntimeErrorDetails;
+    readonly expose: boolean;
+    readonly retryable: boolean;
+    readonly status: number;
+    constructor(options: RuntimeErrorOptions);
+}
+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/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe,CAC9B,CAAC,EACD,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAE7C,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAC1E,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IACpE,aAAa,CAAC,CAAC,CAAC,GAChB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B,CACzC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAE7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,4BAA4B,CAC3C,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAE7C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,mBAAmB;CASzC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EACD,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAE7C,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,4BAA4B,CAAC,CAAC,CAAM,GAC5C,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAOvB;AAED,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAE7C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,0BAA0B,CAAC,CAAC,CAAM,GAC1C,aAAa,CAAC,CAAC,CAAC,CAelB"}

package/dist/response.js

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

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@empire-builder-kit/runtime",
+  "version": "0.0.1-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@org/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./auth": {
+      "@org/source": "./src/auth.ts",
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.js",
+      "default": "./dist/auth.js"
+    },
+    "./config": {
+      "@org/source": "./src/config.ts",
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
+    "./frontend": {
+      "@org/source": "./src/frontend.ts",
+      "types": "./dist/frontend.d.ts",
+      "import": "./dist/frontend.js",
+      "default": "./dist/frontend.js"
+    },
+    "./request-context": {
+      "@org/source": "./src/request-context.ts",
+      "types": "./dist/request-context.d.ts",
+      "import": "./dist/request-context.js",
+      "default": "./dist/request-context.js"
+    },
+    "./logging": {
+      "@org/source": "./src/logging.ts",
+      "types": "./dist/logging.d.ts",
+      "import": "./dist/logging.js",
+      "default": "./dist/logging.js"
+    },
+    "./observability": {
+      "@org/source": "./src/observability.ts",
+      "types": "./dist/observability.d.ts",
+      "import": "./dist/observability.js",
+      "default": "./dist/observability.js"
+    },
+    "./response": {
+      "@org/source": "./src/response.ts",
+      "types": "./dist/response.d.ts",
+      "import": "./dist/response.js",
+      "default": "./dist/response.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "tags": [
+      "scope:workspace",
+      "layer:runtime",
+      "type:runtime",
+      "visibility:public"
+    ],
+    "targets": {
+      "typecheck": {
+        "dependsOn": [
+          "build",
+          "^build"
+        ]
+      },
+      "build": {
+        "executor": "@nx/js:tsc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/runtime/dist",
+          "main": "packages/runtime/src/index.ts",
+          "tsConfig": "packages/runtime/tsconfig.lib.json",
+          "rootDir": "packages/runtime/src",
+          "generatePackageJson": false,
+          "assets": [
+            {
+              "input": "./packages/runtime/src",
+              "glob": "**/!(*.ts)",
+              "output": "."
+            },
+            {
+              "input": "./packages/runtime/src",
+              "glob": "**/*.d.ts",
+              "output": "."
+            }
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}