@microfox/ai-worker 1.0.2 → 1.0.3

package/dist/chunk-AOXGONGI.mjs

@@ -0,0 +1,351 @@
+// src/queueJobStore.ts
+import { Redis as UpstashRedis } from "@upstash/redis";
+import { MongoClient } from "mongodb";
+var mongoUri = process.env.DATABASE_MONGODB_URI || process.env.MONGODB_URI;
+var mongoDbName = process.env.DATABASE_MONGODB_DB || process.env.MONGODB_DB || "mediamake";
+var mongoQueueCollectionName = process.env.MONGODB_QUEUE_JOBS_COLLECTION || "queue_jobs";
+var mongoClientPromise = null;
+async function getMongoClient() {
+  if (!mongoUri) {
+    throw new Error(
+      "MongoDB URI required for queue job store. Set DATABASE_MONGODB_URI or MONGODB_URI."
+    );
+  }
+  if (!mongoClientPromise) {
+    mongoClientPromise = new MongoClient(mongoUri, {
+      maxPoolSize: 10,
+      minPoolSize: 0,
+      serverSelectionTimeoutMS: 1e4
+    }).connect();
+  }
+  return mongoClientPromise;
+}
+async function getMongoQueueCollection() {
+  const client = await getMongoClient();
+  return client.db(mongoDbName).collection(mongoQueueCollectionName);
+}
+var redisUrl = process.env.WORKER_UPSTASH_REDIS_REST_URL || process.env.UPSTASH_REDIS_REST_URL || process.env.UPSTASH_REDIS_URL;
+var redisToken = process.env.WORKER_UPSTASH_REDIS_REST_TOKEN || process.env.UPSTASH_REDIS_REST_TOKEN || process.env.UPSTASH_REDIS_TOKEN;
+var queueKeyPrefix = process.env.WORKER_UPSTASH_REDIS_QUEUE_PREFIX || process.env.UPSTASH_REDIS_QUEUE_PREFIX || "worker:queue-jobs:";
+var defaultTtlSeconds = 60 * 60 * 24 * 7;
+var queueJobTtlSeconds = typeof process.env.WORKER_QUEUE_JOBS_TTL_SECONDS === "string" ? parseInt(process.env.WORKER_QUEUE_JOBS_TTL_SECONDS, 10) || defaultTtlSeconds : typeof process.env.WORKER_JOBS_TTL_SECONDS === "string" ? parseInt(process.env.WORKER_JOBS_TTL_SECONDS, 10) || defaultTtlSeconds : defaultTtlSeconds;
+var redisClient = null;
+function getRedis() {
+  if (!redisUrl || !redisToken) {
+    throw new Error(
+      "Upstash Redis configuration missing for queue job store. Set WORKER_UPSTASH_REDIS_REST_URL and WORKER_UPSTASH_REDIS_REST_TOKEN (or UPSTASH_REDIS_REST_URL/UPSTASH_REDIS_REST_TOKEN)."
+    );
+  }
+  if (!redisClient) {
+    redisClient = new UpstashRedis({
+      url: redisUrl,
+      token: redisToken
+    });
+  }
+  return redisClient;
+}
+function queueKey(id) {
+  return `${queueKeyPrefix}${id}`;
+}
+function stepsFromHash(val) {
+  if (Array.isArray(val)) return val;
+  if (typeof val === "string") {
+    try {
+      const parsed = JSON.parse(val);
+      return Array.isArray(parsed) ? parsed : [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+function metadataFromHash(val) {
+  if (val && typeof val === "object" && !Array.isArray(val)) return val;
+  if (typeof val === "string") {
+    try {
+      const parsed = JSON.parse(val);
+      return parsed && typeof parsed === "object" ? parsed : {};
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+async function loadQueueJobRedis(queueJobId) {
+  const redis = getRedis();
+  const key = queueKey(queueJobId);
+  const data = await redis.hgetall(key);
+  if (!data || typeof data !== "object" || Object.keys(data).length === 0) return null;
+  const d = data;
+  const record = {
+    id: d.id === void 0 ? queueJobId : String(d.id),
+    queueId: String(d.queueId ?? ""),
+    status: String(d.status ?? "running"),
+    steps: stepsFromHash(d.steps),
+    metadata: metadataFromHash(d.metadata),
+    createdAt: String(d.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()),
+    updatedAt: String(d.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString()),
+    completedAt: d.completedAt != null ? String(d.completedAt) : void 0
+  };
+  return record;
+}
+async function saveQueueJobRedis(record) {
+  const redis = getRedis();
+  const key = queueKey(record.id);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const toSet = {
+    id: record.id,
+    queueId: record.queueId,
+    status: record.status,
+    steps: JSON.stringify(record.steps || []),
+    metadata: JSON.stringify(record.metadata || {}),
+    createdAt: record.createdAt || now,
+    updatedAt: record.updatedAt || now
+  };
+  if (record.completedAt) {
+    toSet.completedAt = record.completedAt;
+  }
+  await redis.hset(key, toSet);
+  if (queueJobTtlSeconds > 0) {
+    await redis.expire(key, queueJobTtlSeconds);
+  }
+}
+function getStoreType() {
+  const t = (process.env.WORKER_DATABASE_TYPE || "upstash-redis").toLowerCase();
+  return t === "mongodb" ? "mongodb" : "upstash-redis";
+}
+function preferMongo() {
+  return getStoreType() === "mongodb" && Boolean(mongoUri?.trim());
+}
+function preferRedis() {
+  return getStoreType() !== "mongodb" && Boolean((redisUrl || "").trim() && (redisToken || "").trim());
+}
+async function upsertInitialQueueJob(options) {
+  const { queueJobId, queueId, firstWorkerId, firstWorkerJobId, metadata } = options;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  if (preferMongo()) {
+    const coll = await getMongoQueueCollection();
+    const existing = await coll.findOne({ _id: queueJobId });
+    if (existing) {
+      const steps = existing.steps ?? [];
+      if (steps.length === 0) {
+        steps.push({
+          workerId: firstWorkerId,
+          workerJobId: firstWorkerJobId,
+          status: "queued"
+        });
+      }
+      await coll.updateOne(
+        { _id: queueJobId },
+        {
+          $set: {
+            steps,
+            updatedAt: now
+          }
+        }
+      );
+    } else {
+      const doc = {
+        _id: queueJobId,
+        id: queueJobId,
+        queueId,
+        status: "running",
+        steps: [
+          {
+            workerId: firstWorkerId,
+            workerJobId: firstWorkerJobId,
+            status: "queued"
+          }
+        ],
+        metadata: metadata ?? {},
+        createdAt: now,
+        updatedAt: now
+      };
+      await coll.updateOne(
+        { _id: queueJobId },
+        { $set: doc },
+        { upsert: true }
+      );
+    }
+    return;
+  }
+  if (preferRedis()) {
+    const existing = await loadQueueJobRedis(queueJobId);
+    if (existing) {
+      if (!existing.steps || existing.steps.length === 0) {
+        existing.steps = [
+          {
+            workerId: firstWorkerId,
+            workerJobId: firstWorkerJobId,
+            status: "queued"
+          }
+        ];
+      }
+      existing.updatedAt = now;
+      await saveQueueJobRedis(existing);
+    } else {
+      const record = {
+        id: queueJobId,
+        queueId,
+        status: "running",
+        steps: [
+          {
+            workerId: firstWorkerId,
+            workerJobId: firstWorkerJobId,
+            status: "queued"
+          }
+        ],
+        metadata: metadata ?? {},
+        createdAt: now,
+        updatedAt: now
+      };
+      await saveQueueJobRedis(record);
+    }
+  }
+}
+async function updateQueueJobStepInStore(options) {
+  const { queueJobId, stepIndex, status, input, output, error } = options;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  if (preferMongo()) {
+    const coll = await getMongoQueueCollection();
+    const existing = await coll.findOne({ _id: queueJobId });
+    if (!existing) return;
+    const step = existing.steps[stepIndex];
+    if (!step) return;
+    const mergedStep = {
+      ...step,
+      status,
+      ...input !== void 0 && { input },
+      ...output !== void 0 && { output },
+      ...error !== void 0 && { error },
+      startedAt: step.startedAt ?? (status === "running" ? now : step.startedAt),
+      completedAt: step.completedAt ?? (status === "completed" || status === "failed" ? now : step.completedAt)
+    };
+    const setDoc = {
+      steps: existing.steps,
+      updatedAt: now
+    };
+    setDoc.steps[stepIndex] = mergedStep;
+    if (status === "failed") {
+      setDoc.status = "failed";
+      if (!existing.completedAt) setDoc.completedAt = now;
+    } else if (status === "completed" && stepIndex === existing.steps.length - 1) {
+      setDoc.status = "completed";
+      if (!existing.completedAt) setDoc.completedAt = now;
+    }
+    await coll.updateOne(
+      { _id: queueJobId },
+      {
+        $set: setDoc
+      }
+    );
+    return;
+  }
+  if (preferRedis()) {
+    const existing = await loadQueueJobRedis(queueJobId);
+    if (!existing) {
+      return;
+    }
+    const steps = existing.steps || [];
+    const step = steps[stepIndex];
+    if (!step) {
+      return;
+    }
+    step.status = status;
+    if (input !== void 0) step.input = input;
+    if (output !== void 0) step.output = output;
+    if (error !== void 0) step.error = error;
+    if (status === "running") {
+      step.startedAt = step.startedAt ?? now;
+    }
+    if (status === "completed" || status === "failed") {
+      step.completedAt = step.completedAt ?? now;
+    }
+    existing.steps = steps;
+    existing.updatedAt = now;
+    if (status === "failed") {
+      existing.status = "failed";
+      existing.completedAt = existing.completedAt ?? now;
+    } else if (status === "completed" && stepIndex === steps.length - 1) {
+      existing.status = "completed";
+      existing.completedAt = existing.completedAt ?? now;
+    }
+    await saveQueueJobRedis(existing);
+  }
+}
+async function appendQueueJobStepInStore(options) {
+  const { queueJobId, workerId, workerJobId } = options;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  if (preferMongo()) {
+    const coll = await getMongoQueueCollection();
+    await coll.updateOne(
+      { _id: queueJobId },
+      {
+        $push: {
+          steps: {
+            workerId,
+            workerJobId,
+            status: "queued"
+          }
+        },
+        $set: { updatedAt: now }
+      }
+    );
+    return;
+  }
+  if (preferRedis()) {
+    const existing = await loadQueueJobRedis(queueJobId);
+    if (!existing) return;
+    const steps = existing.steps || [];
+    steps.push({
+      workerId,
+      workerJobId,
+      status: "queued"
+    });
+    existing.steps = steps;
+    existing.updatedAt = now;
+    await saveQueueJobRedis(existing);
+  }
+}
+async function getQueueJob(queueJobId) {
+  if (preferMongo()) {
+    const coll = await getMongoQueueCollection();
+    const doc = await coll.findOne({ _id: queueJobId });
+    if (!doc) return null;
+    return {
+      id: doc.id ?? queueJobId,
+      queueId: doc.queueId,
+      status: doc.status,
+      steps: (doc.steps ?? []).map((s) => ({
+        workerId: s.workerId,
+        workerJobId: s.workerJobId,
+        status: s.status,
+        output: s.output
+      }))
+    };
+  }
+  if (preferRedis()) {
+    const record = await loadQueueJobRedis(queueJobId);
+    if (!record) return null;
+    return {
+      id: record.id,
+      queueId: record.queueId,
+      status: record.status,
+      steps: (record.steps ?? []).map((s) => ({
+        workerId: s.workerId,
+        workerJobId: s.workerJobId,
+        status: s.status,
+        output: s.output
+      }))
+    };
+  }
+  return null;
+}
+
+export {
+  upsertInitialQueueJob,
+  updateQueueJobStepInStore,
+  appendQueueJobStepInStore,
+  getQueueJob
+};
+//# sourceMappingURL=chunk-AOXGONGI.mjs.map

package/dist/chunk-AOXGONGI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queueJobStore.ts"],"sourcesContent":["/**\n * Queue job store for worker queues (MongoDB or Upstash Redis).\n *\n * Mirrors the worker_jobs pattern but optimized for queues:\n * - MongoDB: collection `queue_jobs` (configurable via MONGODB_QUEUE_JOBS_COLLECTION)\n * - Upstash Redis: JSON blob per queue job with compact step entries\n *\n * This module is runtime-only (used by Lambda workers). Next.js APIs can read\n * the same collections/keys to show queue progress.\n */\n\nimport type { Redis } from '@upstash/redis';\nimport { Redis as UpstashRedis } from '@upstash/redis';\nimport { MongoClient, type Collection } from 'mongodb';\n\ntype QueueJobStep = {\n  workerId: string;\n  workerJobId: string;\n  status: 'queued' | 'running' | 'completed' | 'failed';\n  input?: unknown;\n  output?: unknown;\n  error?: { message: string };\n  startedAt?: string;\n  completedAt?: string;\n};\n\ntype QueueJobDoc = {\n  _id: string; // queueJobId\n  id: string;\n  queueId: string;\n  status: 'running' | 'completed' | 'failed' | 'partial';\n  steps: QueueJobStep[];\n  metadata?: Record<string, unknown>;\n  createdAt: string;\n  updatedAt: string;\n  completedAt?: string;\n};\n\n\n// === Mongo backend (shares connection pattern with mongoJobStore) ===\n\nconst mongoUri = process.env.DATABASE_MONGODB_URI || process.env.MONGODB_URI;\nconst mongoDbName =\n  process.env.DATABASE_MONGODB_DB ||\n  process.env.MONGODB_DB ||\n  'mediamake';\nconst mongoQueueCollectionName =\n  process.env.MONGODB_QUEUE_JOBS_COLLECTION || 'queue_jobs';\n\nlet mongoClientPromise: Promise<MongoClient> | null = null;\n\nasync function getMongoClient(): Promise<MongoClient> {\n  if (!mongoUri) {\n    throw new Error(\n      'MongoDB URI required for queue job store. Set DATABASE_MONGODB_URI or MONGODB_URI.'\n    );\n  }\n  if (!mongoClientPromise) {\n    mongoClientPromise = new MongoClient(mongoUri, {\n      maxPoolSize: 10,\n      minPoolSize: 0,\n      serverSelectionTimeoutMS: 10_000,\n    }).connect();\n  }\n  return mongoClientPromise;\n}\n\nasync function getMongoQueueCollection(): Promise<Collection<QueueJobDoc>> {\n  const client = await getMongoClient();\n  return client.db(mongoDbName).collection<QueueJobDoc>(mongoQueueCollectionName);\n}\n\n// === Redis backend (Upstash) ===\n\nconst redisUrl =\n  process.env.WORKER_UPSTASH_REDIS_REST_URL ||\n  process.env.UPSTASH_REDIS_REST_URL ||\n  process.env.UPSTASH_REDIS_URL;\nconst redisToken =\n  process.env.WORKER_UPSTASH_REDIS_REST_TOKEN ||\n  process.env.UPSTASH_REDIS_REST_TOKEN ||\n  process.env.UPSTASH_REDIS_TOKEN;\nconst queueKeyPrefix =\n  process.env.WORKER_UPSTASH_REDIS_QUEUE_PREFIX ||\n  process.env.UPSTASH_REDIS_QUEUE_PREFIX ||\n  'worker:queue-jobs:';\n\nconst defaultTtlSeconds = 60 * 60 * 24 * 7; // 7 days\nconst queueJobTtlSeconds =\n  typeof process.env.WORKER_QUEUE_JOBS_TTL_SECONDS === 'string'\n    ? parseInt(process.env.WORKER_QUEUE_JOBS_TTL_SECONDS, 10) || defaultTtlSeconds\n    : typeof process.env.WORKER_JOBS_TTL_SECONDS === 'string'\n      ? parseInt(process.env.WORKER_JOBS_TTL_SECONDS, 10) || defaultTtlSeconds\n      : defaultTtlSeconds;\n\nlet redisClient: Redis | null = null;\n\nfunction getRedis(): Redis {\n  if (!redisUrl || !redisToken) {\n    throw new Error(\n      'Upstash Redis configuration missing for queue job store. Set WORKER_UPSTASH_REDIS_REST_URL and WORKER_UPSTASH_REDIS_REST_TOKEN (or UPSTASH_REDIS_REST_URL/UPSTASH_REDIS_REST_TOKEN).'\n    );\n  }\n  if (!redisClient) {\n    redisClient = new UpstashRedis({\n      url: redisUrl,\n      token: redisToken,\n    });\n  }\n  return redisClient;\n}\n\nfunction queueKey(id: string): string {\n  return `${queueKeyPrefix}${id}`;\n}\n\ntype QueueJobRecord = Omit<QueueJobDoc, '_id'>;\n\n/** Hash values from Upstash hgetall may be auto-parsed (array/object) or raw strings. */\nfunction stepsFromHash(val: unknown): QueueJobStep[] {\n  if (Array.isArray(val)) return val as QueueJobStep[];\n  if (typeof val === 'string') {\n    try {\n      const parsed = JSON.parse(val) as QueueJobStep[];\n      return Array.isArray(parsed) ? parsed : [];\n    } catch {\n      return [];\n    }\n  }\n  return [];\n}\n\nfunction metadataFromHash(val: unknown): Record<string, unknown> {\n  if (val && typeof val === 'object' && !Array.isArray(val)) return val as Record<string, unknown>;\n  if (typeof val === 'string') {\n    try {\n      const parsed = JSON.parse(val) as Record<string, unknown>;\n      return parsed && typeof parsed === 'object' ? parsed : {};\n    } catch {\n      return {};\n    }\n  }\n  return {};\n}\n\nasync function loadQueueJobRedis(queueJobId: string): Promise<QueueJobRecord | null> {\n  const redis = getRedis();\n  const key = queueKey(queueJobId);\n  const data = await redis.hgetall(key);\n  if (!data || typeof data !== 'object' || Object.keys(data).length === 0) return null;\n  const d = data as Record<string, unknown>;\n  const record: QueueJobRecord = {\n    id: (d.id === undefined ? queueJobId : String(d.id)) as string,\n    queueId: String(d.queueId ?? ''),\n    status: (String(d.status ?? 'running') as QueueJobRecord['status']),\n    steps: stepsFromHash(d.steps),\n    metadata: metadataFromHash(d.metadata),\n    createdAt: String(d.createdAt ?? new Date().toISOString()),\n    updatedAt: String(d.updatedAt ?? new Date().toISOString()),\n    completedAt: d.completedAt != null ? String(d.completedAt) : undefined,\n  };\n  return record;\n}\n\nasync function saveQueueJobRedis(record: QueueJobRecord): Promise<void> {\n  const redis = getRedis();\n  const key = queueKey(record.id);\n  const now = new Date().toISOString();\n  const toSet: Record<string, string> = {\n    id: record.id,\n    queueId: record.queueId,\n    status: record.status,\n    steps: JSON.stringify(record.steps || []),\n    metadata: JSON.stringify(record.metadata || {}),\n    createdAt: record.createdAt || now,\n    updatedAt: record.updatedAt || now,\n  };\n  if (record.completedAt) {\n    toSet.completedAt = record.completedAt;\n  }\n  await redis.hset(key, toSet);\n  if (queueJobTtlSeconds > 0) {\n    await redis.expire(key, queueJobTtlSeconds);\n  }\n}\n\n// === Backend selection ===\n\nfunction getStoreType(): 'mongodb' | 'upstash-redis' {\n  const t = (process.env.WORKER_DATABASE_TYPE || 'upstash-redis').toLowerCase();\n  return t === 'mongodb' ? 'mongodb' : 'upstash-redis';\n}\n\nfunction preferMongo(): boolean {\n  return getStoreType() === 'mongodb' && Boolean(mongoUri?.trim());\n}\n\nfunction preferRedis(): boolean {\n  return getStoreType() !== 'mongodb' && Boolean((redisUrl || '').trim() && (redisToken || '').trim());\n}\n\n// === Public API used from handler.ts ===\n\nexport async function upsertInitialQueueJob(options: {\n  queueJobId: string;\n  queueId: string;\n  firstWorkerId: string;\n  firstWorkerJobId: string;\n  metadata?: Record<string, any>;\n}): Promise<void> {\n  const { queueJobId, queueId, firstWorkerId, firstWorkerJobId, metadata } = options;\n  const now = new Date().toISOString();\n\n  if (preferMongo()) {\n    const coll = await getMongoQueueCollection();\n    const existing = await coll.findOne({ _id: queueJobId });\n    if (existing) {\n      const steps = existing.steps ?? [];\n      if (steps.length === 0) {\n        steps.push({\n          workerId: firstWorkerId,\n          workerJobId: firstWorkerJobId,\n          status: 'queued',\n        });\n      }\n      await coll.updateOne(\n        { _id: queueJobId },\n        {\n          $set: {\n            steps,\n            updatedAt: now,\n          },\n        }\n      );\n    } else {\n      const doc: QueueJobDoc = {\n        _id: queueJobId,\n        id: queueJobId,\n        queueId,\n        status: 'running',\n        steps: [\n          {\n            workerId: firstWorkerId,\n            workerJobId: firstWorkerJobId,\n            status: 'queued',\n          },\n        ],\n        metadata: metadata ?? {},\n        createdAt: now,\n        updatedAt: now,\n      };\n      await coll.updateOne(\n        { _id: queueJobId },\n        { $set: doc },\n        { upsert: true }\n      );\n    }\n    return;\n  }\n\n  if (preferRedis()) {\n    const existing = await loadQueueJobRedis(queueJobId);\n    if (existing) {\n      // Ensure we have at least one step\n      if (!existing.steps || existing.steps.length === 0) {\n        existing.steps = [\n          {\n            workerId: firstWorkerId,\n            workerJobId: firstWorkerJobId,\n            status: 'queued',\n          },\n        ];\n      }\n      existing.updatedAt = now;\n      await saveQueueJobRedis(existing);\n    } else {\n      const record: QueueJobRecord = {\n        id: queueJobId,\n        queueId,\n        status: 'running',\n        steps: [\n          {\n            workerId: firstWorkerId,\n            workerJobId: firstWorkerJobId,\n            status: 'queued',\n          },\n        ],\n        metadata: metadata ?? {},\n        createdAt: now,\n        updatedAt: now,\n      };\n      await saveQueueJobRedis(record);\n    }\n  }\n}\n\nexport async function updateQueueJobStepInStore(options: {\n  queueJobId: string;\n  queueId?: string;\n  stepIndex: number;\n  workerId: string;\n  workerJobId: string;\n  status: 'running' | 'completed' | 'failed';\n  input?: unknown;\n  output?: unknown;\n  error?: { message: string };\n}): Promise<void> {\n  const { queueJobId, stepIndex, status, input, output, error } = options;\n  const now = new Date().toISOString();\n\n  if (preferMongo()) {\n    const coll = await getMongoQueueCollection();\n    const existing = await coll.findOne({ _id: queueJobId });\n    if (!existing) return;\n    const step = existing.steps[stepIndex];\n    if (!step) return;\n\n    const mergedStep: QueueJobStep = {\n      ...step,\n      status,\n      ...(input !== undefined && { input }),\n      ...(output !== undefined && { output }),\n      ...(error !== undefined && { error }),\n      startedAt: step.startedAt ?? (status === 'running' ? now : step.startedAt),\n      completedAt:\n        step.completedAt ??\n        (status === 'completed' || status === 'failed' ? now : step.completedAt),\n    };\n\n    const setDoc: Partial<QueueJobDoc> & { steps: QueueJobStep[] } = {\n      steps: existing.steps,\n      updatedAt: now,\n    };\n    setDoc.steps[stepIndex] = mergedStep;\n    if (status === 'failed') {\n      setDoc.status = 'failed';\n      if (!existing.completedAt) setDoc.completedAt = now;\n    } else if (status === 'completed' && stepIndex === existing.steps.length - 1) {\n      setDoc.status = 'completed';\n      if (!existing.completedAt) setDoc.completedAt = now;\n    }\n\n    await coll.updateOne(\n      { _id: queueJobId },\n      {\n        $set: setDoc,\n      }\n    );\n    return;\n  }\n\n  if (preferRedis()) {\n    const existing = await loadQueueJobRedis(queueJobId);\n    if (!existing) {\n      // No queue job; nothing to update\n      return;\n    }\n    const steps = existing.steps || [];\n    const step = steps[stepIndex];\n    if (!step) {\n      return;\n    }\n    step.status = status;\n    if (input !== undefined) step.input = input;\n    if (output !== undefined) step.output = output;\n    if (error !== undefined) step.error = error;\n    if (status === 'running') {\n      step.startedAt = step.startedAt ?? now;\n    }\n    if (status === 'completed' || status === 'failed') {\n      step.completedAt = step.completedAt ?? now;\n    }\n\n    existing.steps = steps;\n    existing.updatedAt = now;\n    if (status === 'failed') {\n      existing.status = 'failed';\n      existing.completedAt = existing.completedAt ?? now;\n    } else if (status === 'completed' && stepIndex === steps.length - 1) {\n      existing.status = 'completed';\n      existing.completedAt = existing.completedAt ?? now;\n    }\n    await saveQueueJobRedis(existing);\n  }\n}\n\nexport async function appendQueueJobStepInStore(options: {\n  queueJobId: string;\n  queueId?: string;\n  workerId: string;\n  workerJobId: string;\n}): Promise<void> {\n  const { queueJobId, workerId, workerJobId } = options;\n  const now = new Date().toISOString();\n\n  if (preferMongo()) {\n    const coll = await getMongoQueueCollection();\n    await coll.updateOne(\n      { _id: queueJobId },\n      {\n        $push: {\n          steps: {\n            workerId,\n            workerJobId,\n            status: 'queued',\n          } as QueueJobStep,\n        },\n        $set: { updatedAt: now },\n      }\n    );\n    return;\n  }\n\n  if (preferRedis()) {\n    const existing = await loadQueueJobRedis(queueJobId);\n    if (!existing) return;\n    const steps = existing.steps || [];\n    steps.push({\n      workerId,\n      workerJobId,\n      status: 'queued',\n    });\n    existing.steps = steps;\n    existing.updatedAt = now;\n    await saveQueueJobRedis(existing);\n  }\n}\n\n/**\n * Load a queue job by ID (for mapping context: previous step outputs).\n * Used by wrapHandlerForQueue when invoking mapInputFromPrev with previousOutputs.\n */\nexport async function getQueueJob(queueJobId: string): Promise<{\n  id: string;\n  queueId: string;\n  status: string;\n  steps: Array<{ workerId: string; workerJobId: string; status: string; output?: unknown }>;\n} | null> {\n  if (preferMongo()) {\n    const coll = await getMongoQueueCollection();\n    const doc = await coll.findOne({ _id: queueJobId });\n    if (!doc) return null;\n    return {\n      id: doc.id ?? queueJobId,\n      queueId: doc.queueId,\n      status: doc.status,\n      steps: (doc.steps ?? []).map((s: QueueJobStep) => ({\n        workerId: s.workerId,\n        workerJobId: s.workerJobId,\n        status: s.status,\n        output: s.output,\n      })),\n    };\n  }\n  if (preferRedis()) {\n    const record = await loadQueueJobRedis(queueJobId);\n    if (!record) return null;\n    return {\n      id: record.id,\n      queueId: record.queueId,\n      status: record.status,\n      steps: (record.steps ?? []).map((s) => ({\n        workerId: s.workerId,\n        workerJobId: s.workerJobId,\n        status: s.status,\n        output: s.output,\n      })),\n    };\n  }\n  return null;\n}\n\n"],"mappings":"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","names":[]}

package/dist/{client-D25XR0V8.d.mts → client-BqSJQ9mZ.d.mts}

@@ -15,9 +15,11 @@ interface WorkerQueueStep {
      */
     delaySeconds?: number;
     /**
-     * Optional name of a mapping function exported from the .queue.ts file
-     * that derives this step's input from the previous step's output and
-     * the original initial input.
+     * Optional name of a mapping function exported from the .queue.ts file.
+     * The function is called with (initialInput, previousOutputs):
+     * - initialInput: original input passed to dispatchQueue (always first, for best DX).
+     * - previousOutputs: array of { stepIndex, workerId, output } for steps 0..current-1.
+     *   Use any prior step's output; the immediate previous step is previousOutputs[previousOutputs.length - 1]?.output.
      */
     mapInputFromPrev?: string;
 }
@@ -67,7 +69,12 @@ declare function defineWorkerQueue<T extends WorkerQueueConfig>(config: T): T;
 
 interface WorkerQueueRegistry {
     getQueueById(queueId: string): WorkerQueueConfig | undefined;
-    invokeMapInput?: (queueId: string, stepIndex: number, prevOutput: unknown, initialInput: unknown) => Promise<unknown> | unknown;
+    /** (initialInput, previousOutputs) for best DX: derive next input from original request and all prior step outputs. */
+    invokeMapInput?: (queueId: string, stepIndex: number, initialInput: unknown, previousOutputs: Array<{
+        stepIndex: number;
+        workerId: string;
+        output: unknown;
+    }>) => Promise<unknown> | unknown;
 }
 interface DispatchOptions {
     /**
@@ -120,16 +127,18 @@ interface SerializedContext {
 /**
  * Derives the full /workers/trigger URL from env.
  * Exported for use by local dispatchWorker (worker-to-worker in dev).
+ * Server-side only; clients should use useWorkflowJob with your app's /api/workflows routes.
  *
- * Preferred env vars:
+ * Env vars:
  * - WORKER_BASE_URL: base URL of the workers service (e.g. https://.../prod)
- * - NEXT_PUBLIC_WORKER_BASE_URL: same, but exposed to the browser
- *
- * Legacy env vars (still supported for backwards compatibility):
- * - WORKERS_TRIGGER_API_URL / NEXT_PUBLIC_WORKERS_TRIGGER_API_URL
- * - WORKERS_CONFIG_API_URL / NEXT_PUBLIC_WORKERS_CONFIG_API_URL
+ * - WORKERS_TRIGGER_API_URL / WORKERS_CONFIG_API_URL: legacy, still supported
  */
 declare function getWorkersTriggerUrl(): string;
+/**
+ * URL for the queue start endpoint (dispatch proxy). Use this so queue starts
+ * go through the queue handler Lambda for easier debugging (one log stream per queue).
+ */
+declare function getQueueStartUrl(queueId: string): string;
 /**
  * Dispatches a background worker job to SQS.
  *
@@ -141,6 +150,17 @@ declare function getWorkersTriggerUrl(): string;
  * @returns Promise resolving to dispatch result with messageId and jobId
  */
 declare function dispatch<INPUT_SCHEMA extends ZodType<any>>(workerId: string, input: z.input<INPUT_SCHEMA>, inputSchema: INPUT_SCHEMA, options: DispatchOptions, ctx?: any): Promise<DispatchResult>;
+/**
+ * Dispatch a worker by ID without importing the worker module.
+ * Sends to the workers trigger API (WORKER_BASE_URL). No input schema validation at call site.
+ *
+ * @param workerId - The worker ID (e.g. 'echo', 'data-processor')
+ * @param input - Input payload (object or undefined)
+ * @param options - Optional jobId, webhookUrl, metadata
+ * @param ctx - Optional context (serializable parts sent in the request)
+ * @returns Promise resolving to { messageId, status: 'queued', jobId }
+ */
+declare function dispatchWorker(workerId: string, input?: Record<string, unknown>, options?: DispatchOptions, ctx?: any): Promise<DispatchResult>;
 /**
  * Local development mode: runs the handler immediately in the same process.
  * This bypasses SQS and Lambda for faster iteration during development.
@@ -155,13 +175,9 @@ declare function dispatchLocal<INPUT, OUTPUT>(handler: (params: {
     ctx: any;
 }) => Promise<OUTPUT>, input: INPUT, ctx?: any): Promise<OUTPUT>;
 /**
- * Dispatches a queue by ID, using a generated registry of .queue.ts
- * definitions to determine the first worker and initial input mapping.
- *
- * This API intentionally mirrors the ergonomics of dispatching a single
- * worker, but under the hood it embeds queue context into the job input
- * so queue-aware wrappers can chain subsequent steps.
+ * Dispatches a queue by ID. POSTs to the queue-start API; the queue-start handler creates the queue job.
+ * Pass the first worker's input directly (no registry required).
  */
-declare function dispatchQueue<InitialInput = any>(queueId: string, initialInput: InitialInput, options?: DispatchOptions, ctx?: any): Promise<DispatchQueueResult>;
+declare function dispatchQueue<InitialInput = any>(queueId: string, initialInput?: InitialInput, options?: DispatchOptions, _ctx?: any): Promise<DispatchQueueResult>;
 
-export { type DispatchOptions as D, type SerializedContext as S, type WorkerQueueRegistry as W, type DispatchResult as a, type DispatchQueueResult as b, dispatchLocal as c, dispatch as d, dispatchQueue as e, type WorkerQueueStep as f, getWorkersTriggerUrl as g, type WorkerQueueConfig as h, type WorkerQueueContext as i, defineWorkerQueue as j };
+export { type DispatchOptions as D, type SerializedContext as S, type WorkerQueueRegistry as W, type DispatchResult as a, type DispatchQueueResult as b, getQueueStartUrl as c, dispatch as d, dispatchWorker as e, dispatchLocal as f, getWorkersTriggerUrl as g, dispatchQueue as h, type WorkerQueueStep as i, type WorkerQueueConfig as j, type WorkerQueueContext as k, defineWorkerQueue as l };

package/dist/{client-D25XR0V8.d.ts → client-BqSJQ9mZ.d.ts}

@@ -15,9 +15,11 @@ interface WorkerQueueStep {
      */
     delaySeconds?: number;
     /**
-     * Optional name of a mapping function exported from the .queue.ts file
-     * that derives this step's input from the previous step's output and
-     * the original initial input.
+     * Optional name of a mapping function exported from the .queue.ts file.
+     * The function is called with (initialInput, previousOutputs):
+     * - initialInput: original input passed to dispatchQueue (always first, for best DX).
+     * - previousOutputs: array of { stepIndex, workerId, output } for steps 0..current-1.
+     *   Use any prior step's output; the immediate previous step is previousOutputs[previousOutputs.length - 1]?.output.
      */
     mapInputFromPrev?: string;
 }
@@ -67,7 +69,12 @@ declare function defineWorkerQueue<T extends WorkerQueueConfig>(config: T): T;
 
 interface WorkerQueueRegistry {
     getQueueById(queueId: string): WorkerQueueConfig | undefined;
-    invokeMapInput?: (queueId: string, stepIndex: number, prevOutput: unknown, initialInput: unknown) => Promise<unknown> | unknown;
+    /** (initialInput, previousOutputs) for best DX: derive next input from original request and all prior step outputs. */
+    invokeMapInput?: (queueId: string, stepIndex: number, initialInput: unknown, previousOutputs: Array<{
+        stepIndex: number;
+        workerId: string;
+        output: unknown;
+    }>) => Promise<unknown> | unknown;
 }
 interface DispatchOptions {
     /**
@@ -120,16 +127,18 @@ interface SerializedContext {
 /**
  * Derives the full /workers/trigger URL from env.
  * Exported for use by local dispatchWorker (worker-to-worker in dev).
+ * Server-side only; clients should use useWorkflowJob with your app's /api/workflows routes.
  *
- * Preferred env vars:
+ * Env vars:
  * - WORKER_BASE_URL: base URL of the workers service (e.g. https://.../prod)
- * - NEXT_PUBLIC_WORKER_BASE_URL: same, but exposed to the browser
- *
- * Legacy env vars (still supported for backwards compatibility):
- * - WORKERS_TRIGGER_API_URL / NEXT_PUBLIC_WORKERS_TRIGGER_API_URL
- * - WORKERS_CONFIG_API_URL / NEXT_PUBLIC_WORKERS_CONFIG_API_URL
+ * - WORKERS_TRIGGER_API_URL / WORKERS_CONFIG_API_URL: legacy, still supported
  */
 declare function getWorkersTriggerUrl(): string;
+/**
+ * URL for the queue start endpoint (dispatch proxy). Use this so queue starts
+ * go through the queue handler Lambda for easier debugging (one log stream per queue).
+ */
+declare function getQueueStartUrl(queueId: string): string;
 /**
  * Dispatches a background worker job to SQS.
  *
@@ -141,6 +150,17 @@ declare function getWorkersTriggerUrl(): string;
  * @returns Promise resolving to dispatch result with messageId and jobId
  */
 declare function dispatch<INPUT_SCHEMA extends ZodType<any>>(workerId: string, input: z.input<INPUT_SCHEMA>, inputSchema: INPUT_SCHEMA, options: DispatchOptions, ctx?: any): Promise<DispatchResult>;
+/**
+ * Dispatch a worker by ID without importing the worker module.
+ * Sends to the workers trigger API (WORKER_BASE_URL). No input schema validation at call site.
+ *
+ * @param workerId - The worker ID (e.g. 'echo', 'data-processor')
+ * @param input - Input payload (object or undefined)
+ * @param options - Optional jobId, webhookUrl, metadata
+ * @param ctx - Optional context (serializable parts sent in the request)
+ * @returns Promise resolving to { messageId, status: 'queued', jobId }
+ */
+declare function dispatchWorker(workerId: string, input?: Record<string, unknown>, options?: DispatchOptions, ctx?: any): Promise<DispatchResult>;
 /**
  * Local development mode: runs the handler immediately in the same process.
  * This bypasses SQS and Lambda for faster iteration during development.
@@ -155,13 +175,9 @@ declare function dispatchLocal<INPUT, OUTPUT>(handler: (params: {
     ctx: any;
 }) => Promise<OUTPUT>, input: INPUT, ctx?: any): Promise<OUTPUT>;
 /**
- * Dispatches a queue by ID, using a generated registry of .queue.ts
- * definitions to determine the first worker and initial input mapping.
- *
- * This API intentionally mirrors the ergonomics of dispatching a single
- * worker, but under the hood it embeds queue context into the job input
- * so queue-aware wrappers can chain subsequent steps.
+ * Dispatches a queue by ID. POSTs to the queue-start API; the queue-start handler creates the queue job.
+ * Pass the first worker's input directly (no registry required).
  */
-declare function dispatchQueue<InitialInput = any>(queueId: string, initialInput: InitialInput, options?: DispatchOptions, ctx?: any): Promise<DispatchQueueResult>;
+declare function dispatchQueue<InitialInput = any>(queueId: string, initialInput?: InitialInput, options?: DispatchOptions, _ctx?: any): Promise<DispatchQueueResult>;
 
-export { type DispatchOptions as D, type SerializedContext as S, type WorkerQueueRegistry as W, type DispatchResult as a, type DispatchQueueResult as b, dispatchLocal as c, dispatch as d, dispatchQueue as e, type WorkerQueueStep as f, getWorkersTriggerUrl as g, type WorkerQueueConfig as h, type WorkerQueueContext as i, defineWorkerQueue as j };
+export { type DispatchOptions as D, type SerializedContext as S, type WorkerQueueRegistry as W, type DispatchResult as a, type DispatchQueueResult as b, getQueueStartUrl as c, dispatch as d, dispatchWorker as e, dispatchLocal as f, getWorkersTriggerUrl as g, dispatchQueue as h, type WorkerQueueStep as i, type WorkerQueueConfig as j, type WorkerQueueContext as k, defineWorkerQueue as l };

package/dist/client.d.mts

@@ -1,2 +1,2 @@
 import 'zod';
-export { D as DispatchOptions, b as DispatchQueueResult, a as DispatchResult, S as SerializedContext, W as WorkerQueueRegistry, d as dispatch, c as dispatchLocal, e as dispatchQueue, g as getWorkersTriggerUrl } from './client-D25XR0V8.mjs';
+export { D as DispatchOptions, b as DispatchQueueResult, a as DispatchResult, S as SerializedContext, W as WorkerQueueRegistry, d as dispatch, f as dispatchLocal, h as dispatchQueue, e as dispatchWorker, c as getQueueStartUrl, g as getWorkersTriggerUrl } from './client-BqSJQ9mZ.mjs';

package/dist/client.d.ts

@@ -1,2 +1,2 @@
 import 'zod';
-export { D as DispatchOptions, b as DispatchQueueResult, a as DispatchResult, S as SerializedContext, W as WorkerQueueRegistry, d as dispatch, c as dispatchLocal, e as dispatchQueue, g as getWorkersTriggerUrl } from './client-D25XR0V8.js';
+export { D as DispatchOptions, b as DispatchQueueResult, a as DispatchResult, S as SerializedContext, W as WorkerQueueRegistry, d as dispatch, f as dispatchLocal, h as dispatchQueue, e as dispatchWorker, c as getQueueStartUrl, g as getWorkersTriggerUrl } from './client-BqSJQ9mZ.js';