@microfox/ai-worker 1.0.2 → 1.0.3

package/dist/client.js

@@ -23,14 +23,16 @@ __export(client_exports, {
   dispatch: () => dispatch,
   dispatchLocal: () => dispatchLocal,
   dispatchQueue: () => dispatchQueue,
+  dispatchWorker: () => dispatchWorker,
+  getQueueStartUrl: () => getQueueStartUrl,
   getWorkersTriggerUrl: () => getWorkersTriggerUrl
 });
 module.exports = __toCommonJS(client_exports);
 function getWorkersTriggerUrl() {
-  const raw = process.env.WORKER_BASE_URL || process.env.NEXT_PUBLIC_WORKER_BASE_URL || process.env.WORKERS_TRIGGER_API_URL || process.env.NEXT_PUBLIC_WORKERS_TRIGGER_API_URL || process.env.WORKERS_CONFIG_API_URL || process.env.NEXT_PUBLIC_WORKERS_CONFIG_API_URL;
+  const raw = process.env.WORKER_BASE_URL || process.env.WORKERS_TRIGGER_API_URL || process.env.WORKERS_CONFIG_API_URL;
   if (!raw) {
     throw new Error(
-      "WORKER_BASE_URL (preferred) or NEXT_PUBLIC_WORKER_BASE_URL is required for background workers"
+      "WORKER_BASE_URL is required for background workers. Set it server-side only."
     );
   }
   const url = new URL(raw);
@@ -42,6 +44,23 @@ function getWorkersTriggerUrl() {
   url.pathname = `${basePath}/workers/trigger`.replace(/\/+$/, "");
   return url.toString();
 }
+function getQueueStartUrl(queueId) {
+  const raw = process.env.WORKER_BASE_URL || process.env.WORKERS_TRIGGER_API_URL || process.env.WORKERS_CONFIG_API_URL;
+  if (!raw) {
+    throw new Error(
+      "WORKER_BASE_URL is required for background workers. Set it server-side only."
+    );
+  }
+  const url = new URL(raw);
+  url.search = "";
+  url.hash = "";
+  const path = url.pathname || "";
+  url.pathname = path.replace(/\/?workers\/(trigger|config)\/?$/, "");
+  const basePath = url.pathname.replace(/\/+$/, "");
+  const safeSegment = encodeURIComponent(queueId);
+  url.pathname = `${basePath}/queues/${safeSegment}/start`.replace(/\/+$/, "");
+  return url.toString();
+}
 function serializeContext(ctx) {
   const serialized = {};
   if (ctx.requestId) {
@@ -99,115 +118,75 @@ async function dispatch(workerId, input, inputSchema, options, ctx) {
     jobId
   };
 }
-async function dispatchLocal(handler, input, ctx) {
-  return handler({ input, ctx: ctx || {} });
-}
-async function dispatchQueue(queueId, initialInput, options = {}, ctx) {
-  const registry = options.registry;
-  if (!registry?.getQueueById) {
-    throw new Error(
-      "dispatchQueue requires options.registry with getQueueById. Use getQueueRegistry() from your workflows registry (e.g. app/api/workflows/registry/workers) and pass { registry: await getQueueRegistry() }."
-    );
-  }
-  const { getQueueById, invokeMapInput } = registry;
-  const queue = getQueueById(queueId);
-  if (!queue) {
-    throw new Error(`Worker queue "${queueId}" not found in registry`);
-  }
-  if (!queue.steps || queue.steps.length === 0) {
-    throw new Error(`Worker queue "${queueId}" has no steps defined`);
-  }
-  const stepIndex = 0;
-  const firstStep = queue.steps[stepIndex];
-  const firstWorkerId = firstStep.workerId;
-  if (!firstWorkerId) {
-    throw new Error(
-      `Worker queue "${queueId}" has an invalid first step (missing workerId)`
-    );
-  }
-  let firstInput = initialInput;
-  if (firstStep.mapInputFromPrev && typeof invokeMapInput === "function") {
-    firstInput = await invokeMapInput(
-      queueId,
-      stepIndex,
-      void 0,
-      initialInput
-    );
-  }
+async function dispatchWorker(workerId, input, options = {}, ctx) {
   const jobId = options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-  const queueContext = {
-    id: queueId,
-    stepIndex,
-    initialInput,
-    queueJobId: jobId
-  };
-  if (options.onCreateQueueJob) {
-    try {
-      await options.onCreateQueueJob({
-        queueJobId: jobId,
-        queueId,
-        firstStep: { workerId: firstWorkerId, workerJobId: jobId },
-        metadata: options.metadata
-      });
-    } catch (err) {
-      console.warn("[dispatchQueue] onCreateQueueJob failed:", err?.message ?? err);
-    }
-  }
-  const normalizedFirstInput = firstInput !== null && typeof firstInput === "object" ? firstInput : { value: firstInput };
-  const inputWithQueue = {
-    ...normalizedFirstInput,
-    __workerQueue: queueContext
-  };
-  const metadataWithQueue = {
-    ...options.metadata || {},
-    __workerQueue: queueContext
-  };
   const triggerUrl = getWorkersTriggerUrl();
   const serializedContext = ctx ? serializeContext(ctx) : {};
   const messageBody = {
-    workerId: firstWorkerId,
+    workerId,
     jobId,
-    input: inputWithQueue,
+    input: input ?? {},
     context: serializedContext,
     webhookUrl: options.webhookUrl,
-    metadata: metadataWithQueue,
+    metadata: options.metadata || {},
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const headers = {
-    "Content-Type": "application/json"
-  };
+  const headers = { "Content-Type": "application/json" };
   const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;
-  if (triggerKey) {
-    headers["x-workers-trigger-key"] = triggerKey;
-  }
+  if (triggerKey) headers["x-workers-trigger-key"] = triggerKey;
   const response = await fetch(triggerUrl, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({ workerId, body: messageBody })
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(
+      `Failed to trigger worker "${workerId}": ${response.status} ${response.statusText}${text ? ` - ${text}` : ""}`
+    );
+  }
+  const data = await response.json().catch(() => ({}));
+  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;
+  return { messageId, status: "queued", jobId };
+}
+async function dispatchLocal(handler, input, ctx) {
+  return handler({ input, ctx: ctx || {} });
+}
+async function dispatchQueue(queueId, initialInput, options = {}, _ctx) {
+  const jobId = options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+  const queueStartUrl = getQueueStartUrl(queueId);
+  const normalizedInput = initialInput !== null && typeof initialInput === "object" ? initialInput : { value: initialInput };
+  const headers = { "Content-Type": "application/json" };
+  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;
+  if (triggerKey) headers["x-workers-trigger-key"] = triggerKey;
+  const response = await fetch(queueStartUrl, {
     method: "POST",
     headers,
     body: JSON.stringify({
-      workerId: firstWorkerId,
-      body: messageBody
+      input: normalizedInput,
+      initialInput: normalizedInput,
+      metadata: options.metadata ?? {},
+      jobId,
+      ...options.webhookUrl ? { webhookUrl: options.webhookUrl } : {}
     })
   });
   if (!response.ok) {
     const text = await response.text().catch(() => "");
     throw new Error(
-      `Failed to trigger queue "${queueId}" (worker "${firstWorkerId}"): ${response.status} ${response.statusText}${text ? ` - ${text}` : ""}`
+      `Failed to start queue "${queueId}": ${response.status} ${response.statusText}${text ? ` - ${text}` : ""}`
     );
   }
   const data = await response.json().catch(() => ({}));
-  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;
-  return {
-    queueId,
-    messageId,
-    status: "queued",
-    jobId
-  };
+  const messageId = data?.messageId ?? data?.jobId ?? `queue-${jobId}`;
+  return { queueId, messageId, status: "queued", jobId };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   dispatch,
   dispatchLocal,
   dispatchQueue,
+  dispatchWorker,
+  getQueueStartUrl,
   getWorkersTriggerUrl
 });
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * Client for dispatching background worker jobs.\n *\n * In production, dispatching happens via the workers HTTP API:\n *   POST /workers/trigger  -> enqueues message to SQS on the workers service side\n *\n * This avoids requiring AWS credentials in your Next.js app.\n */\n\nimport type { ZodType, z } from 'zod';\nimport type { WorkerQueueConfig, WorkerQueueContext } from './queue.js';\n\nexport interface WorkerQueueRegistry {\n  getQueueById(queueId: string): WorkerQueueConfig | undefined;\n  invokeMapInput?: (\n    queueId: string,\n    stepIndex: number,\n    prevOutput: unknown,\n    initialInput: unknown\n  ) => Promise<unknown> | unknown;\n}\n\nexport interface DispatchOptions {\n  /**\n   * Optional webhook callback URL to notify when the job finishes.\n   * Only called when provided. Default: no webhook (use job store / MongoDB only).\n   */\n  webhookUrl?: string;\n  /**\n   * Controls how dispatch executes.\n   * - \"auto\" (default): local inline execution in development unless WORKERS_LOCAL_MODE=false.\n   * - \"local\": force inline execution (no SQS).\n   * - \"remote\": force SQS/Lambda dispatch even in development.\n   */\n  mode?: 'auto' | 'local' | 'remote';\n  jobId?: string;\n  metadata?: Record<string, any>;\n  /**\n   * In-memory queue registry for dispatchQueue. Required when using dispatchQueue.\n   * Pass a registry that imports from your .queue.ts definitions (works on Vercel/serverless).\n   */\n  registry?: WorkerQueueRegistry;\n  /**\n   * Optional callback to create a queue job record before dispatching.\n   * Called with queueJobId (= first worker's jobId), queueId, and firstStep.\n   */\n  onCreateQueueJob?: (params: {\n    queueJobId: string;\n    queueId: string;\n    firstStep: { workerId: string; workerJobId: string };\n    metadata?: Record<string, unknown>;\n  }) => Promise<void>;\n}\n\nexport interface DispatchResult {\n  messageId: string;\n  status: 'queued';\n  jobId: string;\n}\n\nexport interface DispatchQueueResult extends DispatchResult {\n  queueId: string;\n}\n\nexport interface SerializedContext {\n  requestId?: string;\n  userId?: string;\n  traceId?: string;\n  [key: string]: any;\n}\n\n/**\n * Derives the full /workers/trigger URL from env.\n * Exported for use by local dispatchWorker (worker-to-worker in dev).\n *\n * Preferred env vars:\n * - WORKER_BASE_URL: base URL of the workers service (e.g. https://.../prod)\n * - NEXT_PUBLIC_WORKER_BASE_URL: same, but exposed to the browser\n *\n * Legacy env vars (still supported for backwards compatibility):\n * - WORKERS_TRIGGER_API_URL / NEXT_PUBLIC_WORKERS_TRIGGER_API_URL\n * - WORKERS_CONFIG_API_URL / NEXT_PUBLIC_WORKERS_CONFIG_API_URL\n */\nexport function getWorkersTriggerUrl(): string {\n  const raw =\n    process.env.WORKER_BASE_URL ||\n    process.env.NEXT_PUBLIC_WORKER_BASE_URL ||\n    process.env.WORKERS_TRIGGER_API_URL ||\n    process.env.NEXT_PUBLIC_WORKERS_TRIGGER_API_URL ||\n    process.env.WORKERS_CONFIG_API_URL ||\n    process.env.NEXT_PUBLIC_WORKERS_CONFIG_API_URL;\n\n  if (!raw) {\n    throw new Error(\n      'WORKER_BASE_URL (preferred) or NEXT_PUBLIC_WORKER_BASE_URL is required for background workers'\n    );\n  }\n\n  const url = new URL(raw);\n  url.search = '';\n  url.hash = '';\n\n  const path = url.pathname || '';\n\n  // If the user pointed at a specific endpoint, normalize back to the service root.\n  url.pathname = path.replace(/\\/?workers\\/(trigger|config)\\/?$/, '');\n\n  const basePath = url.pathname.replace(/\\/+$/, '');\n  url.pathname = `${basePath}/workers/trigger`.replace(/\\/+$/, '');\n\n  return url.toString();\n}\n\n/**\n * Serializes context data for transmission to Lambda.\n * Only serializes safe, JSON-compatible properties.\n */\nfunction serializeContext(ctx: any): SerializedContext {\n  const serialized: SerializedContext = {};\n\n  if (ctx.requestId) {\n    serialized.requestId = ctx.requestId;\n  }\n\n  // Extract any additional serializable metadata\n  if (ctx.metadata && typeof ctx.metadata === 'object') {\n    Object.assign(serialized, ctx.metadata);\n  }\n\n  // Allow custom context serialization via a helper property\n  if (ctx._serializeContext && typeof ctx._serializeContext === 'function') {\n    const custom = ctx._serializeContext();\n    Object.assign(serialized, custom);\n  }\n\n  return serialized;\n}\n\n\n/**\n * Dispatches a background worker job to SQS.\n *\n * @param workerId - The ID of the worker to dispatch\n * @param input - The input data for the worker (will be validated against inputSchema)\n * @param inputSchema - Zod schema for input validation\n * @param options - Dispatch options including webhook URL\n * @param ctx - Optional context object (only serializable parts will be sent)\n * @returns Promise resolving to dispatch result with messageId and jobId\n */\nexport async function dispatch<INPUT_SCHEMA extends ZodType<any>>(\n  workerId: string,\n  input: z.input<INPUT_SCHEMA>,\n  inputSchema: INPUT_SCHEMA,\n  options: DispatchOptions,\n  ctx?: any\n): Promise<DispatchResult> {\n  // Validate input against schema\n  const validatedInput = inputSchema.parse(input);\n\n  // Generate job ID if not provided\n  const jobId =\n    options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n\n  // Resolve /workers/trigger endpoint URL\n  const triggerUrl = getWorkersTriggerUrl();\n\n  // Serialize context (only safe, JSON-compatible parts)\n  const serializedContext = ctx ? serializeContext(ctx) : {};\n\n  // Job updates use MongoDB only; never pass jobStoreUrl/origin URL.\n  const messageBody = {\n    workerId,\n    jobId,\n    input: validatedInput,\n    context: serializedContext,\n    webhookUrl: options.webhookUrl,\n    metadata: options.metadata || {},\n    timestamp: new Date().toISOString(),\n  };\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  };\n  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;\n  if (triggerKey) {\n    headers['x-workers-trigger-key'] = triggerKey;\n  }\n\n  const response = await fetch(triggerUrl, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify({\n      workerId,\n      body: messageBody,\n    }),\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    throw new Error(\n      `Failed to trigger worker \"${workerId}\": ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`\n    );\n  }\n\n  const data = (await response.json().catch(() => ({}))) as any;\n  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;\n\n  return {\n    messageId,\n    status: 'queued',\n    jobId,\n  };\n}\n\n/**\n * Local development mode: runs the handler immediately in the same process.\n * This bypasses SQS and Lambda for faster iteration during development.\n *\n * @param handler - The worker handler function\n * @param input - The input data\n * @param ctx - The context object\n * @returns The handler result\n */\nexport async function dispatchLocal<INPUT, OUTPUT>(\n  handler: (params: { input: INPUT; ctx: any }) => Promise<OUTPUT>,\n  input: INPUT,\n  ctx?: any\n): Promise<OUTPUT> {\n  return handler({ input, ctx: ctx || {} });\n}\n\n/**\n * Dispatches a queue by ID, using a generated registry of .queue.ts\n * definitions to determine the first worker and initial input mapping.\n *\n * This API intentionally mirrors the ergonomics of dispatching a single\n * worker, but under the hood it embeds queue context into the job input\n * so queue-aware wrappers can chain subsequent steps.\n */\nexport async function dispatchQueue<InitialInput = any>(\n  queueId: string,\n  initialInput: InitialInput,\n  options: DispatchOptions = {},\n  ctx?: any\n): Promise<DispatchQueueResult> {\n  const registry = options.registry;\n  if (!registry?.getQueueById) {\n    throw new Error(\n      'dispatchQueue requires options.registry with getQueueById. ' +\n        'Use getQueueRegistry() from your workflows registry (e.g. app/api/workflows/registry/workers) and pass { registry: await getQueueRegistry() }.'\n    );\n  }\n  const { getQueueById, invokeMapInput } = registry;\n  const queue = getQueueById(queueId);\n\n  if (!queue) {\n    throw new Error(`Worker queue \"${queueId}\" not found in registry`);\n  }\n\n  if (!queue.steps || queue.steps.length === 0) {\n    throw new Error(`Worker queue \"${queueId}\" has no steps defined`);\n  }\n\n  const stepIndex = 0;\n  const firstStep = queue.steps[stepIndex];\n  const firstWorkerId = firstStep.workerId;\n\n  if (!firstWorkerId) {\n    throw new Error(\n      `Worker queue \"${queueId}\" has an invalid first step (missing workerId)`\n    );\n  }\n\n  // Compute the first step's input:\n  // - If a mapping function is configured and the registry exposes invokeMapInput,\n  //   use it (prevOutput is undefined for the first step).\n  // - Otherwise, default to the initial input.\n  let firstInput: unknown = initialInput;\n  if (firstStep.mapInputFromPrev && typeof invokeMapInput === 'function') {\n    firstInput = await invokeMapInput(\n      queueId,\n      stepIndex,\n      undefined,\n      initialInput\n    );\n  }\n\n  const jobId =\n    options.jobId ||\n    `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n\n  const queueContext: WorkerQueueContext<InitialInput> = {\n    id: queueId,\n    stepIndex,\n    initialInput,\n    queueJobId: jobId,\n  };\n\n  // Create queue job record if callback provided (for progress tracking)\n  if (options.onCreateQueueJob) {\n    try {\n      await options.onCreateQueueJob({\n        queueJobId: jobId,\n        queueId,\n        firstStep: { workerId: firstWorkerId, workerJobId: jobId },\n        metadata: options.metadata as Record<string, unknown> | undefined,\n      });\n    } catch (err: any) {\n      console.warn('[dispatchQueue] onCreateQueueJob failed:', err?.message ?? err);\n    }\n  }\n\n  // Embed queue context into the worker input under a reserved key.\n  const normalizedFirstInput =\n    firstInput !== null && typeof firstInput === 'object'\n      ? (firstInput as Record<string, any>)\n      : { value: firstInput };\n\n  const inputWithQueue = {\n    ...normalizedFirstInput,\n    __workerQueue: queueContext,\n  };\n\n  const metadataWithQueue = {\n    ...(options.metadata || {}),\n    __workerQueue: queueContext,\n  };\n\n  const triggerUrl = getWorkersTriggerUrl();\n  const serializedContext = ctx ? serializeContext(ctx) : {};\n\n  const messageBody = {\n    workerId: firstWorkerId,\n    jobId,\n    input: inputWithQueue,\n    context: serializedContext,\n    webhookUrl: options.webhookUrl,\n    metadata: metadataWithQueue,\n    timestamp: new Date().toISOString(),\n  };\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  };\n  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;\n  if (triggerKey) {\n    headers['x-workers-trigger-key'] = triggerKey;\n  }\n\n  const response = await fetch(triggerUrl, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify({\n      workerId: firstWorkerId,\n      body: messageBody,\n    }),\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    throw new Error(\n      `Failed to trigger queue \"${queueId}\" (worker \"${firstWorkerId}\"): ` +\n        `${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`\n    );\n  }\n\n  const data = (await response.json().catch(() => ({}))) as any;\n  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;\n\n  return {\n    queueId,\n    messageId,\n    status: 'queued',\n    jobId,\n  };\n}\n\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * Client for dispatching background worker jobs.\n *\n * In production, dispatching happens via the workers HTTP API:\n *   POST /workers/trigger  -> enqueues message to SQS on the workers service side\n *\n * This avoids requiring AWS credentials in your Next.js app.\n */\n\nimport type { ZodType, z } from 'zod';\nimport type { WorkerQueueConfig } from './queue.js';\n\nexport interface WorkerQueueRegistry {\n  getQueueById(queueId: string): WorkerQueueConfig | undefined;\n  /** (initialInput, previousOutputs) for best DX: derive next input from original request and all prior step outputs. */\n  invokeMapInput?: (\n    queueId: string,\n    stepIndex: number,\n    initialInput: unknown,\n    previousOutputs: Array<{ stepIndex: number; workerId: string; output: unknown }>\n  ) => Promise<unknown> | unknown;\n}\n\nexport interface DispatchOptions {\n  /**\n   * Optional webhook callback URL to notify when the job finishes.\n   * Only called when provided. Default: no webhook (use job store / MongoDB only).\n   */\n  webhookUrl?: string;\n  /**\n   * Controls how dispatch executes.\n   * - \"auto\" (default): local inline execution in development unless WORKERS_LOCAL_MODE=false.\n   * - \"local\": force inline execution (no SQS).\n   * - \"remote\": force SQS/Lambda dispatch even in development.\n   */\n  mode?: 'auto' | 'local' | 'remote';\n  jobId?: string;\n  metadata?: Record<string, any>;\n  /**\n   * In-memory queue registry for dispatchQueue. Required when using dispatchQueue.\n   * Pass a registry that imports from your .queue.ts definitions (works on Vercel/serverless).\n   */\n  registry?: WorkerQueueRegistry;\n  /**\n   * Optional callback to create a queue job record before dispatching.\n   * Called with queueJobId (= first worker's jobId), queueId, and firstStep.\n   */\n  onCreateQueueJob?: (params: {\n    queueJobId: string;\n    queueId: string;\n    firstStep: { workerId: string; workerJobId: string };\n    metadata?: Record<string, unknown>;\n  }) => Promise<void>;\n}\n\nexport interface DispatchResult {\n  messageId: string;\n  status: 'queued';\n  jobId: string;\n}\n\nexport interface DispatchQueueResult extends DispatchResult {\n  queueId: string;\n}\n\nexport interface SerializedContext {\n  requestId?: string;\n  userId?: string;\n  traceId?: string;\n  [key: string]: any;\n}\n\n/**\n * Derives the full /workers/trigger URL from env.\n * Exported for use by local dispatchWorker (worker-to-worker in dev).\n * Server-side only; clients should use useWorkflowJob with your app's /api/workflows routes.\n *\n * Env vars:\n * - WORKER_BASE_URL: base URL of the workers service (e.g. https://.../prod)\n * - WORKERS_TRIGGER_API_URL / WORKERS_CONFIG_API_URL: legacy, still supported\n */\nexport function getWorkersTriggerUrl(): string {\n  const raw =\n    process.env.WORKER_BASE_URL ||\n    process.env.WORKERS_TRIGGER_API_URL ||\n    process.env.WORKERS_CONFIG_API_URL;\n\n  if (!raw) {\n    throw new Error(\n      'WORKER_BASE_URL is required for background workers. Set it server-side only.'\n    );\n  }\n\n  const url = new URL(raw);\n  url.search = '';\n  url.hash = '';\n\n  const path = url.pathname || '';\n\n  // If the user pointed at a specific endpoint, normalize back to the service root.\n  url.pathname = path.replace(/\\/?workers\\/(trigger|config)\\/?$/, '');\n\n  const basePath = url.pathname.replace(/\\/+$/, '');\n  url.pathname = `${basePath}/workers/trigger`.replace(/\\/+$/, '');\n\n  return url.toString();\n}\n\n/**\n * URL for the queue start endpoint (dispatch proxy). Use this so queue starts\n * go through the queue handler Lambda for easier debugging (one log stream per queue).\n */\nexport function getQueueStartUrl(queueId: string): string {\n  const raw =\n    process.env.WORKER_BASE_URL ||\n    process.env.WORKERS_TRIGGER_API_URL ||\n    process.env.WORKERS_CONFIG_API_URL;\n\n  if (!raw) {\n    throw new Error(\n      'WORKER_BASE_URL is required for background workers. Set it server-side only.'\n    );\n  }\n\n  const url = new URL(raw);\n  url.search = '';\n  url.hash = '';\n\n  const path = url.pathname || '';\n  url.pathname = path.replace(/\\/?workers\\/(trigger|config)\\/?$/, '');\n  const basePath = url.pathname.replace(/\\/+$/, '');\n  const safeSegment = encodeURIComponent(queueId);\n  url.pathname = `${basePath}/queues/${safeSegment}/start`.replace(/\\/+$/, '');\n\n  return url.toString();\n}\n\n/**\n * Serializes context data for transmission to Lambda.\n * Only serializes safe, JSON-compatible properties.\n */\nfunction serializeContext(ctx: any): SerializedContext {\n  const serialized: SerializedContext = {};\n\n  if (ctx.requestId) {\n    serialized.requestId = ctx.requestId;\n  }\n\n  // Extract any additional serializable metadata\n  if (ctx.metadata && typeof ctx.metadata === 'object') {\n    Object.assign(serialized, ctx.metadata);\n  }\n\n  // Allow custom context serialization via a helper property\n  if (ctx._serializeContext && typeof ctx._serializeContext === 'function') {\n    const custom = ctx._serializeContext();\n    Object.assign(serialized, custom);\n  }\n\n  return serialized;\n}\n\n\n/**\n * Dispatches a background worker job to SQS.\n *\n * @param workerId - The ID of the worker to dispatch\n * @param input - The input data for the worker (will be validated against inputSchema)\n * @param inputSchema - Zod schema for input validation\n * @param options - Dispatch options including webhook URL\n * @param ctx - Optional context object (only serializable parts will be sent)\n * @returns Promise resolving to dispatch result with messageId and jobId\n */\nexport async function dispatch<INPUT_SCHEMA extends ZodType<any>>(\n  workerId: string,\n  input: z.input<INPUT_SCHEMA>,\n  inputSchema: INPUT_SCHEMA,\n  options: DispatchOptions,\n  ctx?: any\n): Promise<DispatchResult> {\n  // Validate input against schema\n  const validatedInput = inputSchema.parse(input);\n\n  // Generate job ID if not provided\n  const jobId =\n    options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n\n  // Resolve /workers/trigger endpoint URL\n  const triggerUrl = getWorkersTriggerUrl();\n\n  // Serialize context (only safe, JSON-compatible parts)\n  const serializedContext = ctx ? serializeContext(ctx) : {};\n\n  // Job updates use MongoDB only; never pass jobStoreUrl/origin URL.\n  const messageBody = {\n    workerId,\n    jobId,\n    input: validatedInput,\n    context: serializedContext,\n    webhookUrl: options.webhookUrl,\n    metadata: options.metadata || {},\n    timestamp: new Date().toISOString(),\n  };\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  };\n  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;\n  if (triggerKey) {\n    headers['x-workers-trigger-key'] = triggerKey;\n  }\n\n  const response = await fetch(triggerUrl, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify({\n      workerId,\n      body: messageBody,\n    }),\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    throw new Error(\n      `Failed to trigger worker \"${workerId}\": ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`\n    );\n  }\n\n  const data = (await response.json().catch(() => ({}))) as any;\n  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;\n\n  return {\n    messageId,\n    status: 'queued',\n    jobId,\n  };\n}\n\n/**\n * Dispatch a worker by ID without importing the worker module.\n * Sends to the workers trigger API (WORKER_BASE_URL). No input schema validation at call site.\n *\n * @param workerId - The worker ID (e.g. 'echo', 'data-processor')\n * @param input - Input payload (object or undefined)\n * @param options - Optional jobId, webhookUrl, metadata\n * @param ctx - Optional context (serializable parts sent in the request)\n * @returns Promise resolving to { messageId, status: 'queued', jobId }\n */\nexport async function dispatchWorker(\n  workerId: string,\n  input?: Record<string, unknown>,\n  options: DispatchOptions = {},\n  ctx?: any\n): Promise<DispatchResult> {\n  const jobId =\n    options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n  const triggerUrl = getWorkersTriggerUrl();\n  const serializedContext = ctx ? serializeContext(ctx) : {};\n  const messageBody = {\n    workerId,\n    jobId,\n    input: input ?? {},\n    context: serializedContext,\n    webhookUrl: options.webhookUrl,\n    metadata: options.metadata || {},\n    timestamp: new Date().toISOString(),\n  };\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;\n  if (triggerKey) headers['x-workers-trigger-key'] = triggerKey;\n  const response = await fetch(triggerUrl, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify({ workerId, body: messageBody }),\n  });\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    throw new Error(\n      `Failed to trigger worker \"${workerId}\": ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`\n    );\n  }\n  const data = (await response.json().catch(() => ({}))) as any;\n  const messageId = data?.messageId ? String(data.messageId) : `trigger-${jobId}`;\n  return { messageId, status: 'queued', jobId };\n}\n\n/**\n * Local development mode: runs the handler immediately in the same process.\n * This bypasses SQS and Lambda for faster iteration during development.\n *\n * @param handler - The worker handler function\n * @param input - The input data\n * @param ctx - The context object\n * @returns The handler result\n */\nexport async function dispatchLocal<INPUT, OUTPUT>(\n  handler: (params: { input: INPUT; ctx: any }) => Promise<OUTPUT>,\n  input: INPUT,\n  ctx?: any\n): Promise<OUTPUT> {\n  return handler({ input, ctx: ctx || {} });\n}\n\n/**\n * Dispatches a queue by ID. POSTs to the queue-start API; the queue-start handler creates the queue job.\n * Pass the first worker's input directly (no registry required).\n */\nexport async function dispatchQueue<InitialInput = any>(\n  queueId: string,\n  initialInput?: InitialInput,\n  options: DispatchOptions = {},\n  _ctx?: any\n): Promise<DispatchQueueResult> {\n  const jobId =\n    options.jobId || `job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n  const queueStartUrl = getQueueStartUrl(queueId);\n  const normalizedInput =\n    initialInput !== null && typeof initialInput === 'object'\n      ? (initialInput as Record<string, unknown>)\n      : { value: initialInput };\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  const triggerKey = process.env.WORKERS_TRIGGER_API_KEY;\n  if (triggerKey) headers['x-workers-trigger-key'] = triggerKey;\n  const response = await fetch(queueStartUrl, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify({\n      input: normalizedInput,\n      initialInput: normalizedInput,\n      metadata: options.metadata ?? {},\n      jobId,\n      ...(options.webhookUrl ? { webhookUrl: options.webhookUrl } : {}),\n    }),\n  });\n  if (!response.ok) {\n    const text = await response.text().catch(() => '');\n    throw new Error(\n      `Failed to start queue \"${queueId}\": ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`\n    );\n  }\n  const data = (await response.json().catch(() => ({}))) as any;\n  const messageId = data?.messageId ?? data?.jobId ?? `queue-${jobId}`;\n  return { queueId, messageId, status: 'queued', jobId };\n}\n\n"],"mappings":"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","names":[]}

package/dist/client.mjs

@@ -2,13 +2,17 @@ import {
   dispatch,
   dispatchLocal,
   dispatchQueue,
+  dispatchWorker,
+  getQueueStartUrl,
   getWorkersTriggerUrl
-} from "./chunk-BJPQY2NJ.mjs";
+} from "./chunk-72XGFZCE.mjs";
 import "./chunk-BJTO5JO5.mjs";
 export {
   dispatch,
   dispatchLocal,
   dispatchQueue,
+  dispatchWorker,
+  getQueueStartUrl,
   getWorkersTriggerUrl
 };
 //# sourceMappingURL=client.mjs.map

package/dist/handler.d.mts

@@ -81,6 +81,17 @@ interface DispatchWorkerOptions {
      */
     delaySeconds?: number;
 }
+/**
+ * Logger provided on ctx with prefixed levels: [INFO], [WARN], [ERROR], [DEBUG].
+ * Each method accepts a message and optional data (logged as JSON).
+ */
+interface WorkerLogger {
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+}
+declare function createWorkerLogger(jobId: string, workerId: string): WorkerLogger;
 interface WorkerHandlerParams<INPUT, OUTPUT> {
     input: INPUT;
     ctx: {
@@ -92,6 +103,10 @@ interface WorkerHandlerParams<INPUT, OUTPUT> {
          * Uses MongoDB directly when configured; never HTTP/origin URL.
          */
         jobStore?: JobStore;
+        /**
+         * Logger with prefixed levels: ctx.logger.info(), .warn(), .error(), .debug().
+         */
+        logger: WorkerLogger;
         /**
          * Dispatch another worker (fire-and-forget or await). Uses WORKER_QUEUE_URL_<SANITIZED_ID> env.
          * Always provided by the runtime (Lambda and local).
@@ -111,10 +126,24 @@ interface QueueNextStep {
     delaySeconds?: number;
     mapInputFromPrev?: string;
 }
+/** One previous step's output (for mapInputFromPrev context). */
+interface QueueStepOutput {
+    stepIndex: number;
+    workerId: string;
+    output: unknown;
+}
 /** Runtime helpers for queue-aware wrappers (provided by generated registry). */
 interface QueueRuntime {
     getNextStep(queueId: string, stepIndex: number): QueueNextStep | undefined;
-    invokeMapInput?(queueId: string, stepIndex: number, prevOutput: unknown, initialInput: unknown): Promise<unknown> | unknown;
+    /** Optional: when provided, mapping can use outputs from any previous step. */
+    getQueueJob?(queueJobId: string): Promise<{
+        steps: Array<{
+            workerId: string;
+            output?: unknown;
+        }>;
+    } | null>;
+    /** (initialInput, previousOutputs) – previousOutputs includes outputs for steps 0..stepIndex-1 and current step. */
+    invokeMapInput?(queueId: string, stepIndex: number, initialInput: unknown, previousOutputs: QueueStepOutput[]): Promise<unknown> | unknown;
 }
 /**
  * Wraps a user handler so that when the job has __workerQueue context (from
@@ -127,6 +156,7 @@ declare function wrapHandlerForQueue<INPUT, OUTPUT>(handler: WorkerHandler<INPUT
         id: string;
         stepIndex: number;
         initialInput: unknown;
+        queueJobId?: string;
     };
 }, OUTPUT>;
 interface SQSMessageBody {
@@ -162,4 +192,4 @@ interface WebhookPayload {
  */
 declare function createLambdaHandler<INPUT, OUTPUT>(handler: WorkerHandler<INPUT, OUTPUT>, outputSchema?: ZodType<OUTPUT>): (event: SQSEvent, context: Context) => Promise<void>;
 
-export { type DispatchWorkerOptions, type JobRecord, type JobStore, type JobStoreUpdate, type QueueNextStep, type QueueRuntime, type SQSMessageBody, SQS_MAX_DELAY_SECONDS, type WebhookPayload, type WorkerHandler, type WorkerHandlerParams, createLambdaHandler, wrapHandlerForQueue };
+export { type DispatchWorkerOptions, type JobRecord, type JobStore, type JobStoreUpdate, type QueueNextStep, type QueueRuntime, type QueueStepOutput, type SQSMessageBody, SQS_MAX_DELAY_SECONDS, type WebhookPayload, type WorkerHandler, type WorkerHandlerParams, type WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue };

package/dist/handler.d.ts

@@ -81,6 +81,17 @@ interface DispatchWorkerOptions {
      */
     delaySeconds?: number;
 }
+/**
+ * Logger provided on ctx with prefixed levels: [INFO], [WARN], [ERROR], [DEBUG].
+ * Each method accepts a message and optional data (logged as JSON).
+ */
+interface WorkerLogger {
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+}
+declare function createWorkerLogger(jobId: string, workerId: string): WorkerLogger;
 interface WorkerHandlerParams<INPUT, OUTPUT> {
     input: INPUT;
     ctx: {
@@ -92,6 +103,10 @@ interface WorkerHandlerParams<INPUT, OUTPUT> {
          * Uses MongoDB directly when configured; never HTTP/origin URL.
          */
         jobStore?: JobStore;
+        /**
+         * Logger with prefixed levels: ctx.logger.info(), .warn(), .error(), .debug().
+         */
+        logger: WorkerLogger;
         /**
          * Dispatch another worker (fire-and-forget or await). Uses WORKER_QUEUE_URL_<SANITIZED_ID> env.
          * Always provided by the runtime (Lambda and local).
@@ -111,10 +126,24 @@ interface QueueNextStep {
     delaySeconds?: number;
     mapInputFromPrev?: string;
 }
+/** One previous step's output (for mapInputFromPrev context). */
+interface QueueStepOutput {
+    stepIndex: number;
+    workerId: string;
+    output: unknown;
+}
 /** Runtime helpers for queue-aware wrappers (provided by generated registry). */
 interface QueueRuntime {
     getNextStep(queueId: string, stepIndex: number): QueueNextStep | undefined;
-    invokeMapInput?(queueId: string, stepIndex: number, prevOutput: unknown, initialInput: unknown): Promise<unknown> | unknown;
+    /** Optional: when provided, mapping can use outputs from any previous step. */
+    getQueueJob?(queueJobId: string): Promise<{
+        steps: Array<{
+            workerId: string;
+            output?: unknown;
+        }>;
+    } | null>;
+    /** (initialInput, previousOutputs) – previousOutputs includes outputs for steps 0..stepIndex-1 and current step. */
+    invokeMapInput?(queueId: string, stepIndex: number, initialInput: unknown, previousOutputs: QueueStepOutput[]): Promise<unknown> | unknown;
 }
 /**
  * Wraps a user handler so that when the job has __workerQueue context (from
@@ -127,6 +156,7 @@ declare function wrapHandlerForQueue<INPUT, OUTPUT>(handler: WorkerHandler<INPUT
         id: string;
         stepIndex: number;
         initialInput: unknown;
+        queueJobId?: string;
     };
 }, OUTPUT>;
 interface SQSMessageBody {
@@ -162,4 +192,4 @@ interface WebhookPayload {
  */
 declare function createLambdaHandler<INPUT, OUTPUT>(handler: WorkerHandler<INPUT, OUTPUT>, outputSchema?: ZodType<OUTPUT>): (event: SQSEvent, context: Context) => Promise<void>;
 
-export { type DispatchWorkerOptions, type JobRecord, type JobStore, type JobStoreUpdate, type QueueNextStep, type QueueRuntime, type SQSMessageBody, SQS_MAX_DELAY_SECONDS, type WebhookPayload, type WorkerHandler, type WorkerHandlerParams, createLambdaHandler, wrapHandlerForQueue };
+export { type DispatchWorkerOptions, type JobRecord, type JobStore, type JobStoreUpdate, type QueueNextStep, type QueueRuntime, type QueueStepOutput, type SQSMessageBody, SQS_MAX_DELAY_SECONDS, type WebhookPayload, type WorkerHandler, type WorkerHandlerParams, type WorkerLogger, createLambdaHandler, createWorkerLogger, wrapHandlerForQueue };

package/dist/handler.js

@@ -22,6 +22,7 @@ var handler_exports = {};
 __export(handler_exports, {
   SQS_MAX_DELAY_SECONDS: () => SQS_MAX_DELAY_SECONDS,
   createLambdaHandler: () => createLambdaHandler,
+  createWorkerLogger: () => createWorkerLogger,
   wrapHandlerForQueue: () => wrapHandlerForQueue
 });
 module.exports = __toCommonJS(handler_exports);
@@ -666,6 +667,25 @@ async function appendQueueJobStepInStore(options) {
 
 // src/handler.ts
 var SQS_MAX_DELAY_SECONDS = 900;
+function createWorkerLogger(jobId, workerId) {
+  const prefix = (level) => `[${level}] [${workerId}] [${jobId}]`;
+  return {
+    info(msg, data) {
+      console.log(prefix("INFO"), msg, data !== void 0 ? JSON.stringify(data) : "");
+    },
+    warn(msg, data) {
+      console.warn(prefix("WARN"), msg, data !== void 0 ? JSON.stringify(data) : "");
+    },
+    error(msg, data) {
+      console.error(prefix("ERROR"), msg, data !== void 0 ? JSON.stringify(data) : "");
+    },
+    debug(msg, data) {
+      if (process.env.DEBUG || process.env.WORKER_DEBUG) {
+        console.debug(prefix("DEBUG"), msg, data !== void 0 ? JSON.stringify(data) : "");
+      }
+    }
+  };
+}
 var WORKER_QUEUE_KEY = "__workerQueue";
 async function notifyQueueJobStep(queueJobId, action, params) {
   try {
@@ -698,14 +718,13 @@ async function notifyQueueJobStep(queueJobId, action, params) {
       output: params.output,
       error: params.error
     });
-    if (process.env.DEBUG_WORKER_QUEUES === "1") {
-      console.log("[Worker] Queue job step updated", {
-        queueJobId,
-        action,
-        stepIndex: params.stepIndex,
-        status
-      });
-    }
+    console.log("[Worker] Queue job step updated", {
+      queueId: params.queueId ?? queueJobId,
+      queueJobId,
+      stepIndex: params.stepIndex,
+      workerId: params.workerId,
+      status
+    });
   } catch (err) {
     console.warn("[Worker] Queue job update error:", {
       queueJobId,
@@ -722,20 +741,52 @@ function wrapHandlerForQueue(handler, queueRuntime) {
       return output;
     }
     const { id: queueId, stepIndex, initialInput, queueJobId } = queueContext;
+    const jobId = params.ctx?.jobId;
+    const workerId = params.ctx?.workerId ?? "";
     const next = queueRuntime.getNextStep(queueId, stepIndex);
-    if (!next) {
-      return output;
-    }
-    const childJobId = `job-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
-    if (queueJobId) {
+    const childJobId = next ? `job-${Date.now()}-${Math.random().toString(36).slice(2, 11)}` : void 0;
+    if (next && queueJobId) {
       await notifyQueueJobStep(queueJobId, "append", {
         workerJobId: childJobId,
         workerId: next.workerId
       });
     }
+    if (queueJobId && typeof stepIndex === "number") {
+      await notifyQueueJobStep(queueJobId, "complete", {
+        queueId,
+        stepIndex,
+        workerJobId: jobId,
+        workerId,
+        output
+      });
+    }
+    if (!next) {
+      return output;
+    }
     let nextInput = output;
     if (next.mapInputFromPrev && typeof queueRuntime.invokeMapInput === "function") {
-      nextInput = await queueRuntime.invokeMapInput(queueId, stepIndex + 1, output, initialInput);
+      let previousOutputs = [];
+      if (queueJobId && typeof queueRuntime.getQueueJob === "function") {
+        try {
+          const job = await queueRuntime.getQueueJob(queueJobId);
+          if (job?.steps) {
+            const fromStore = job.steps.slice(0, stepIndex).map((s, i) => ({ stepIndex: i, workerId: s.workerId, output: s.output }));
+            previousOutputs = fromStore.concat([
+              { stepIndex, workerId: params.ctx?.workerId ?? "", output }
+            ]);
+          }
+        } catch (e) {
+          if (process.env.AI_WORKER_QUEUES_DEBUG === "1") {
+            console.warn("[Worker] getQueueJob failed, mapping without previousOutputs:", e?.message ?? e);
+          }
+        }
+      }
+      nextInput = await queueRuntime.invokeMapInput(
+        queueId,
+        stepIndex + 1,
+        initialInput,
+        previousOutputs
+      );
     }
     const nextInputWithQueue = {
       ...nextInput !== null && typeof nextInput === "object" ? nextInput : { value: nextInput },
@@ -914,6 +965,7 @@ function createLambdaHandler(handler, outputSchema) {
         const handlerContext = {
           ...baseContext,
           ...jobStore ? { jobStore } : {},
+          logger: createWorkerLogger(jobId, workerId),
           dispatchWorker: createDispatchWorker(
             jobId,
             workerId,
@@ -924,9 +976,12 @@ function createLambdaHandler(handler, outputSchema) {
         if (jobStore) {
           try {
             await jobStore.update({ status: "running" });
+            const queueCtxForLog = input?.__workerQueue ?? metadata?.__workerQueue;
             console.log("[Worker] Job status updated to running:", {
               jobId,
-              workerId
+              workerId,
+              ...queueCtxForLog?.id && { queueId: queueCtxForLog.id },
+              ...queueCtxForLog?.queueJobId && { queueJobId: queueCtxForLog.queueJobId }
             });
           } catch (error) {
             console.warn("[Worker] Failed to update status to running:", {
@@ -956,6 +1011,7 @@ function createLambdaHandler(handler, outputSchema) {
             }
           }
           await notifyQueueJobStep(queueCtx.queueJobId, "start", {
+            queueId: queueCtx.id,
             stepIndex: queueCtx.stepIndex,
             workerJobId: jobId,
             workerId,
@@ -1004,6 +1060,7 @@ function createLambdaHandler(handler, outputSchema) {
           const queueCtxFail = input?.__workerQueue ?? metadata?.__workerQueue;
           if (queueCtxFail?.queueJobId && typeof queueCtxFail.stepIndex === "number") {
             await notifyQueueJobStep(queueCtxFail.queueJobId, "fail", {
+              queueId: queueCtxFail.id,
               stepIndex: queueCtxFail.stepIndex,
               workerJobId: jobId,
               workerId,
@@ -1033,15 +1090,6 @@ function createLambdaHandler(handler, outputSchema) {
             });
           }
         }
-        const queueCtxSuccess = input?.__workerQueue ?? metadata?.__workerQueue;
-        if (queueCtxSuccess?.queueJobId && typeof queueCtxSuccess.stepIndex === "number") {
-          await notifyQueueJobStep(queueCtxSuccess.queueJobId, "complete", {
-            stepIndex: queueCtxSuccess.stepIndex,
-            workerJobId: jobId,
-            workerId,
-            output
-          });
-        }
         console.log("[Worker] Job completed:", {
           jobId,
           workerId,
@@ -1074,6 +1122,7 @@ function createLambdaHandler(handler, outputSchema) {
 0 && (module.exports = {
   SQS_MAX_DELAY_SECONDS,
   createLambdaHandler,
+  createWorkerLogger,
   wrapHandlerForQueue
 });
 //# sourceMappingURL=handler.js.map