@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/utils/types/guards.js

@@ -0,0 +1,229 @@
+/**
+ * @fileoverview Type guard utilities for safe runtime type narrowing.
+ * @module utils/types/guards
+ *
+ * Provides reusable type guards to replace unsafe type assertions throughout the codebase.
+ * All guards perform proper runtime validation and narrow TypeScript types safely.
+ */
+/**
+ * Type guard to check if a value is a non-null object.
+ *
+ * @param value - Value to check
+ * @returns True if value is an object (excluding null and arrays)
+ *
+ * @example
+ * ```typescript
+ * if (isObject(someValue)) {
+ *   // someValue is now typed as object
+ *   console.log(someValue.toString());
+ * }
+ * ```
+ */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard to check if a value is a plain record (non-null, non-array object with string keys).
+ *
+ * Arrays are excluded — this guard is intended for key-value objects only.
+ * Delegates to {@link isObject} for the underlying check.
+ *
+ * @param value - Value to check
+ * @returns True if value is a `Record<string, unknown>` (plain object, not null, not an array)
+ *
+ * @example
+ * ```typescript
+ * if (isRecord(data)) {
+ *   // data is now typed as Record<string, unknown>
+ *   const keys = Object.keys(data);
+ * }
+ * ```
+ */
+export function isRecord(value) {
+    return isObject(value);
+}
+/**
+ * Type guard to check if an object has a specific property.
+ *
+ * @param obj - Object to check
+ * @param key - Property key to look for
+ * @returns True if object has the specified property
+ *
+ * @example
+ * ```typescript
+ * if (hasProperty(error, 'message')) {
+ *   // TypeScript now knows error has a 'message' property
+ *   console.log(error.message);
+ * }
+ * ```
+ */
+export function hasProperty(obj, key) {
+    return isObject(obj) && key in obj;
+}
+/**
+ * Type guard to check if an object has a property of a specific type.
+ *
+ * @param obj - Object to check
+ * @param key - Property key to look for
+ * @param typeGuard - Type guard function for the property value
+ * @returns True if object has the property and it matches the type
+ *
+ * @example
+ * ```typescript
+ * if (hasPropertyOfType(obj, 'count', (v): v is number => typeof v === 'number')) {
+ *   // obj.count is now typed as number
+ *   console.log(obj.count + 1);
+ * }
+ * ```
+ */
+export function hasPropertyOfType(obj, key, typeGuard) {
+    return hasProperty(obj, key) && typeGuard(obj[key]);
+}
+/**
+ * Type guard to check if a value is a string.
+ *
+ * @param value - Value to check
+ * @returns True if value is a string
+ *
+ * @example
+ * ```typescript
+ * if (isString(value)) {
+ *   // value is now typed as string
+ *   console.log(value.toUpperCase());
+ * }
+ * ```
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard to check if a value is a number.
+ *
+ * `NaN` is explicitly excluded — `typeof NaN === 'number'` is true in JavaScript,
+ * but `NaN` is almost never a valid value in the contexts where this guard is used.
+ *
+ * @param value - Value to check
+ * @returns True if value is a finite or infinite number (excluding NaN)
+ *
+ * @example
+ * ```typescript
+ * if (isNumber(value)) {
+ *   // value is now typed as number (NaN excluded)
+ *   console.log(value.toFixed(2));
+ * }
+ * ```
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+/**
+ * Type guard to check if an error is an AggregateError.
+ *
+ * AggregateError contains multiple errors in an 'errors' array property.
+ * This guard safely checks for the errors property without unsafe type assertions.
+ *
+ * @param error - Error to check
+ * @returns True if error is an AggregateError with errors array
+ *
+ * @example
+ * ```typescript
+ * if (isAggregateError(error)) {
+ *   // error.errors is now safely typed as unknown[]
+ *   error.errors.forEach(innerError => console.log(innerError));
+ * }
+ * ```
+ */
+export function isAggregateError(error) {
+    return error instanceof Error && hasProperty(error, 'errors') && Array.isArray(error.errors);
+}
+/**
+ * Type guard to check if an error has a code property.
+ *
+ * @param error - Error to check
+ * @returns True if error has a code property
+ *
+ * @example
+ * ```typescript
+ * if (isErrorWithCode(error)) {
+ *   console.log(`Error code: ${error.code}`);
+ * }
+ * ```
+ */
+export function isErrorWithCode(error) {
+    return error instanceof Error && hasProperty(error, 'code');
+}
+/**
+ * Type guard to check if an error has a status property.
+ *
+ * @param error - Error to check
+ * @returns True if error has a status property
+ *
+ * @example
+ * ```typescript
+ * if (isErrorWithStatus(error)) {
+ *   console.log(`HTTP status: ${error.status}`);
+ * }
+ * ```
+ */
+export function isErrorWithStatus(error) {
+    return error instanceof Error && hasProperty(error, 'status');
+}
+/**
+ * Safely get a property from an object if it exists.
+ *
+ * @param obj - Object to get property from
+ * @param key - Property key
+ * @returns Property value or undefined if property doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const message = getProperty(error, 'message');
+ * // message is typed as unknown
+ * ```
+ */
+export function getProperty(obj, key) {
+    return hasProperty(obj, key) ? obj[key] : undefined;
+}
+/**
+ * Safely get a string property from an object.
+ *
+ * @param obj - Object to get property from
+ * @param key - Property key
+ * @returns String value or undefined if property doesn't exist or is not a string
+ *
+ * @example
+ * ```typescript
+ * const traceId = getStringProperty(context, 'traceId');
+ * if (traceId) {
+ *   // traceId is typed as string
+ *   console.log(traceId.toUpperCase());
+ * }
+ * ```
+ */
+export function getStringProperty(obj, key) {
+    const value = getProperty(obj, key);
+    return isString(value) ? value : undefined;
+}
+/**
+ * Safely get a number property from an object.
+ *
+ * Returns `undefined` if the property is absent, not a number, or is `NaN`.
+ *
+ * @param obj - Object to get property from
+ * @param key - Property key
+ * @returns Number value or undefined if property doesn't exist, is not a number, or is NaN
+ *
+ * @example
+ * ```typescript
+ * const retries = getNumberProperty(config, 'maxRetries');
+ * if (retries !== undefined) {
+ *   // retries is typed as number
+ *   console.log(`Max retries: ${retries}`);
+ * }
+ * ```
+ */
+export function getNumberProperty(obj, key) {
+    const value = getProperty(obj, key);
+    return isNumber(value) ? value : undefined;
+}
+//# sourceMappingURL=guards.js.map

package/dist/utils/types/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/utils/types/guards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,GAAY,EACZ,GAAM;IAEN,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,GAAM,EACN,SAAyC;IAEzC,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAwB,GAAY,EAAE,GAAM;IACrE,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAwB,GAAY,EAAE,GAAM;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAwB,GAAY,EAAE,GAAM;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/dist/utils/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel export for type guard utilities.
+ * @module utils/types
+ */
+export { isErrorWithCode, isRecord } from './guards.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel export for type guard utilities.
+ * @module utils/types
+ */
+export { isErrorWithCode, isRecord } from './guards.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Cloudflare Worker entry point factory. `createWorkerHandler()`
+ * returns a standard Workers export object (`{ fetch, scheduled }`) that handles
+ * env injection, binding storage, singleton init caching, per-request server
+ * creation (GHSA-345p-7cg4-v4c7), error responses, and telemetry flush via
+ * `ctx.waitUntil()`.
+ * @module src/worker
+ */
+import type { Ai, D1Database, KVNamespace, R2Bucket, ScheduledController } from '@cloudflare/workers-types';
+import { type CreateAppOptions } from './app.js';
+/**
+ * Cloudflare Worker Bindings with proper type safety.
+ * No index signature — servers extend via intersection types.
+ */
+export interface CloudflareBindings {
+    AI?: Ai;
+    DB?: D1Database;
+    ENVIRONMENT?: string;
+    KV_NAMESPACE?: KVNamespace;
+    LOG_LEVEL?: string;
+    MCP_ALLOWED_ORIGINS?: string;
+    MCP_AUTH_MODE?: string;
+    MCP_AUTH_SECRET_KEY?: string;
+    OAUTH_AUDIENCE?: string;
+    OAUTH_ISSUER_URL?: string;
+    OAUTH_JWKS_URI?: string;
+    OPENROUTER_API_KEY?: string;
+    OTEL_ENABLED?: string;
+    OTEL_EXPORTER_OTLP_METRICS_ENDPOINT?: string;
+    OTEL_EXPORTER_OTLP_TRACES_ENDPOINT?: string;
+    R2_BUCKET?: R2Bucket;
+    SPEECH_STT_API_KEY?: string;
+    SPEECH_STT_ENABLED?: string;
+    SPEECH_TTS_API_KEY?: string;
+    SPEECH_TTS_ENABLED?: string;
+    STORAGE_PROVIDER_TYPE?: string;
+    SUPABASE_ANON_KEY?: string;
+    SUPABASE_SERVICE_ROLE_KEY?: string;
+    SUPABASE_URL?: string;
+}
+/** Options for {@link createWorkerHandler}. */
+export interface WorkerHandlerOptions extends CreateAppOptions {
+    /** Extra string CF bindings to inject into process.env (beyond the core set). */
+    extraEnvBindings?: Array<[string, string]>;
+    /** Extra object CF bindings (KV, R2, D1, etc.) to store on globalThis. */
+    extraObjectBindings?: Array<[string, string]>;
+    /** Handler for scheduled/cron events. Called after app init and binding refresh. */
+    onScheduled?: (controller: ScheduledController, env: CloudflareBindings, ctx: ExecutionContext) => Promise<void>;
+}
+/**
+ * Returns a standard Cloudflare Workers export object (`{ fetch, scheduled }`).
+ * Handles env injection, binding storage, singleton init caching, per-request
+ * server creation, error responses, and telemetry flush via `ctx.waitUntil()`.
+ */
+export declare function createWorkerHandler(options?: WorkerHandlerOptions): {
+    fetch(request: Request, env: CloudflareBindings, ctx: ExecutionContext): Promise<Response>;
+    scheduled(controller: ScheduledController, env: CloudflareBindings, ctx: ExecutionContext): Promise<void>;
+};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,EAAE,EAEF,UAAU,EACV,WAAW,EACX,QAAQ,EACR,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,gBAAgB,EAAmB,MAAM,UAAU,CAAC;AAMlE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC,CAAC,EAAE,MAAM,CAAC;IAC7C,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,oFAAoF;IACpF,WAAW,CAAC,EAAE,CACZ,UAAU,EAAE,mBAAmB,EAC/B,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAwED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB;mBAmFvD,OAAO,OACX,kBAAkB,OAClB,gBAAgB,GACpB,OAAO,CAAC,QAAQ,CAAC;0BA4DN,mBAAmB,OAC1B,kBAAkB,OAClB,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC;EAuCnB"}

package/dist/worker.js

@@ -0,0 +1,216 @@
+import { composeServices } from './app.js';
+import { createHttpApp } from './mcp-server/transports/http/httpTransport.js';
+import { logger } from './utils/internal/logger.js';
+import { initHighResTimer } from './utils/internal/performance.js';
+import { requestContextService } from './utils/internal/requestContext.js';
+/** Core string bindings injected into process.env for config parsing. */
+const CORE_ENV_BINDINGS = [
+    ['ENVIRONMENT', 'NODE_ENV'],
+    ['LOG_LEVEL', 'MCP_LOG_LEVEL'],
+    ['MCP_AUTH_MODE', 'MCP_AUTH_MODE'],
+    ['MCP_AUTH_SECRET_KEY', 'MCP_AUTH_SECRET_KEY'],
+    ['OPENROUTER_API_KEY', 'OPENROUTER_API_KEY'],
+    ['SUPABASE_URL', 'SUPABASE_URL'],
+    ['SUPABASE_ANON_KEY', 'SUPABASE_ANON_KEY'],
+    ['SUPABASE_SERVICE_ROLE_KEY', 'SUPABASE_SERVICE_ROLE_KEY'],
+    ['STORAGE_PROVIDER_TYPE', 'STORAGE_PROVIDER_TYPE'],
+    ['OAUTH_ISSUER_URL', 'OAUTH_ISSUER_URL'],
+    ['OAUTH_AUDIENCE', 'OAUTH_AUDIENCE'],
+    ['OAUTH_JWKS_URI', 'OAUTH_JWKS_URI'],
+    ['MCP_ALLOWED_ORIGINS', 'MCP_ALLOWED_ORIGINS'],
+    ['SPEECH_TTS_ENABLED', 'SPEECH_TTS_ENABLED'],
+    ['SPEECH_TTS_API_KEY', 'SPEECH_TTS_API_KEY'],
+    ['SPEECH_STT_ENABLED', 'SPEECH_STT_ENABLED'],
+    ['SPEECH_STT_API_KEY', 'SPEECH_STT_API_KEY'],
+    ['OTEL_ENABLED', 'OTEL_ENABLED'],
+    ['OTEL_EXPORTER_OTLP_TRACES_ENDPOINT', 'OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'],
+    ['OTEL_EXPORTER_OTLP_METRICS_ENDPOINT', 'OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'],
+];
+/** Core object bindings stored on globalThis for storage/AI providers. */
+const CORE_OBJECT_BINDINGS = [
+    ['KV_NAMESPACE', 'KV_NAMESPACE'],
+    ['R2_BUCKET', 'R2_BUCKET'],
+    ['DB', 'DB'],
+    ['AI', 'AI'],
+];
+function injectEnvVars(env, extraBindings) {
+    if (typeof process === 'undefined')
+        return;
+    for (const [bindingKey, processKey] of CORE_ENV_BINDINGS) {
+        const value = env[bindingKey];
+        if (typeof value === 'string' && value.trim() !== '') {
+            process.env[processKey] = value;
+        }
+    }
+    if (extraBindings) {
+        for (const [bindingKey, processKey] of extraBindings) {
+            const value = env[bindingKey];
+            if (typeof value === 'string' && value.trim() !== '') {
+                process.env[processKey] = value;
+            }
+        }
+    }
+}
+function storeBindings(env, extraBindings) {
+    for (const [bindingKey, globalKey] of CORE_OBJECT_BINDINGS) {
+        const value = env[bindingKey];
+        if (value != null) {
+            Object.assign(globalThis, { [globalKey]: value });
+        }
+    }
+    if (extraBindings) {
+        for (const [bindingKey, globalKey] of extraBindings) {
+            const value = env[bindingKey];
+            if (value != null) {
+                Object.assign(globalThis, { [globalKey]: value });
+            }
+        }
+    }
+}
+/**
+ * Returns a standard Cloudflare Workers export object (`{ fetch, scheduled }`).
+ * Handles env injection, binding storage, singleton init caching, per-request
+ * server creation, error responses, and telemetry flush via `ctx.waitUntil()`.
+ */
+export function createWorkerHandler(options = {}) {
+    const { extraEnvBindings, extraObjectBindings, onScheduled, ...appOptions } = options;
+    let appPromise = null;
+    function initializeApp(env) {
+        if (appPromise)
+            return appPromise;
+        appPromise = (async () => {
+            const initStartTime = Date.now();
+            try {
+                if (typeof process !== 'undefined' && process.env) {
+                    process.env.IS_SERVERLESS = 'true';
+                }
+                else {
+                    Object.assign(globalThis, { IS_SERVERLESS: true });
+                }
+                const { createServer } = await composeServices(appOptions);
+                await initHighResTimer();
+                const logLevel = env.LOG_LEVEL?.toLowerCase() ?? 'info';
+                const validLogLevels = [
+                    'debug',
+                    'info',
+                    'notice',
+                    'warning',
+                    'error',
+                    'crit',
+                    'alert',
+                    'emerg',
+                ];
+                const validatedLogLevel = validLogLevels.includes(logLevel)
+                    ? logLevel
+                    : 'info';
+                await logger.initialize(validatedLogLevel, 'http');
+                const workerContext = requestContextService.createRequestContext({
+                    operation: 'WorkerInitialization',
+                    isServerless: true,
+                });
+                logger.info('Cloudflare Worker initializing...', {
+                    ...workerContext,
+                    environment: env.ENVIRONMENT ?? 'production',
+                    storageProvider: env.STORAGE_PROVIDER_TYPE ?? 'in-memory',
+                });
+                const { app } = await createHttpApp(createServer, workerContext);
+                const initDuration = Date.now() - initStartTime;
+                logger.info('Cloudflare Worker initialized successfully.', {
+                    ...workerContext,
+                    initDurationMs: initDuration,
+                });
+                return app;
+            }
+            catch (error) {
+                const initDuration = Date.now() - initStartTime;
+                const errorContext = requestContextService.createRequestContext({
+                    operation: 'WorkerInitialization',
+                    isServerless: true,
+                    initDurationMs: initDuration,
+                    error: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                logger.crit('Failed to initialize Cloudflare Worker.', error instanceof Error ? error : new Error(String(error)), errorContext);
+                appPromise = null;
+                throw error;
+            }
+        })();
+        return appPromise;
+    }
+    return {
+        async fetch(request, env, ctx) {
+            try {
+                injectEnvVars(env, extraEnvBindings);
+                storeBindings(env, extraObjectBindings);
+                const app = await initializeApp(env);
+                const cfProperties = request.cf;
+                const requestId = request.headers.get('cf-ray') ?? crypto.randomUUID();
+                const requestContext = requestContextService.createRequestContext({
+                    operation: 'WorkerFetch',
+                    requestId,
+                    isServerless: true,
+                    ...(cfProperties && {
+                        colo: cfProperties.colo,
+                        country: cfProperties.country,
+                        city: cfProperties.city,
+                    }),
+                });
+                logger.debug('Processing Worker fetch request.', {
+                    ...requestContext,
+                    method: request.method,
+                    url: request.url,
+                    colo: cfProperties?.colo,
+                });
+                return await app.fetch(request, env, ctx);
+            }
+            catch (error) {
+                const requestId = request.headers.get('cf-ray');
+                const errorContext = requestContextService.createRequestContext({
+                    operation: 'WorkerFetch',
+                    isServerless: true,
+                    method: request.method,
+                    url: request.url,
+                    ...(requestId && { requestId }),
+                });
+                logger.error('Worker fetch handler error.', error instanceof Error ? error : new Error(String(error)), errorContext);
+                return new Response(JSON.stringify({
+                    error: 'Internal Server Error',
+                    message: 'An internal error occurred.',
+                }), {
+                    status: 500,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+        },
+        async scheduled(controller, env, ctx) {
+            try {
+                injectEnvVars(env, extraEnvBindings);
+                storeBindings(env, extraObjectBindings);
+                await initializeApp(env);
+                if (onScheduled) {
+                    await onScheduled(controller, env, ctx);
+                    return;
+                }
+                const scheduledContext = requestContextService.createRequestContext({
+                    operation: 'WorkerScheduled',
+                    isServerless: true,
+                    cron: controller.cron,
+                });
+                logger.info('Processing scheduled event.', {
+                    ...scheduledContext,
+                    scheduledTime: new Date(controller.scheduledTime).toISOString(),
+                });
+                logger.info('Scheduled event completed.', scheduledContext);
+            }
+            catch (error) {
+                const errorContext = requestContextService.createRequestContext({
+                    operation: 'WorkerScheduled',
+                    isServerless: true,
+                    cron: controller.cron,
+                });
+                logger.error('Worker scheduled handler error.', error instanceof Error ? error : new Error(String(error)), errorContext);
+            }
+        },
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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