@sonamu-kit/tasks 0.0.1

package/dist/tasks/remote-task.js

@@ -0,0 +1,213 @@
+import { findRoute } from "rou3";
+import { isSonamuTaskError } from "../errors.js";
+import { routedAction } from "./shared.js";
+// start, stop, fetch 이벤트는 router를 잡기 전에 일어나서 별도로 분리
+export async function saveUnroutedTaskEvent(knex, data) {
+    switch(data.type){
+        case "start":
+            return knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp
+            }).into("sonamu_task_events");
+        case "stop":
+            return knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp,
+                reason: data.reason,
+                error_message: data.error?.message,
+                error_stack: data.error?.stack
+            }).into("sonamu_task_events");
+        case "fetch":
+            return knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp
+            }).into("sonamu_task_events");
+        default:
+            throw new Error(`Unknown task event type: ${data.type}`);
+    }
+}
+// router에서 매칭 후 생긴 이벤트를 처리
+export async function saveRoutedTaskEvent(knex, router, data) {
+    const queries = [];
+    const matched = findRoute(router, "", data.task.namespace);
+    switch(data.type){
+        case "process:start":
+            queries.push(knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp,
+                task_item_id: knex.fn.uuidToBin(data.task.id),
+                attempt: data.task.attempt
+            }).into("sonamu_task_events"));
+            break;
+        case "process:complete":
+            // sonamu_task_items의 TaskItem을 sonamu_archived_task_items로 이동
+            queries.push(knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp,
+                task_item_id: knex.fn.uuidToBin(data.task.id),
+                attempt: data.task.attempt
+            }).into("sonamu_task_events"));
+            queries.push(knex("sonamu_task_items").where("id", knex.fn.uuidToBin(data.task.id)).delete());
+            queries.push(knex.insert({
+                id: knex.fn.uuidToBin(data.task.id),
+                created_at: data.task.createdAt,
+                completed_at: data.timestamp,
+                namespace: data.task.namespace,
+                payload: data.task.payload,
+                attempt: data.task.attempt,
+                status: "completed"
+            }).into("sonamu_archived_task_items"));
+            break;
+        case "process:error":
+            queries.push(knex.insert({
+                event_type: data.type,
+                info_id: knex.fn.uuidToBin(data.info.id),
+                info_name: data.info.name,
+                timestamp: data.timestamp,
+                task_item_id: knex.fn.uuidToBin(data.task.id),
+                attempt: data.task.attempt,
+                reason: data.reason,
+                error_message: data.error?.message,
+                error_stack: data.error?.stack
+            }).into("sonamu_task_events"));
+            if (data.task.attempt >= (matched?.data.retry.maxAttempts ?? 1)) {
+                // 최대 실행 횟수를 넘겼을 경우, 에러로 sonamu_archived_task_items로 옮김
+                queries.push(knex("sonamu_task_items").where("id", knex.fn.uuidToBin(data.task.id)).delete());
+                queries.push(knex.insert({
+                    id: knex.fn.uuidToBin(data.task.id),
+                    created_at: data.task.createdAt,
+                    completed_at: data.timestamp,
+                    namespace: data.task.namespace,
+                    payload: data.task.payload,
+                    attempt: data.task.attempt,
+                    status: "error"
+                }).into("sonamu_archived_task_items"));
+            } else {
+                // 재시도 횟수 증가 및 상태 업데이트
+                queries.push(knex("sonamu_task_items").where("id", knex.fn.uuidToBin(data.task.id)).update({
+                    status: "pending",
+                    attempt: data.task.attempt + 1,
+                    updated_at: data.timestamp
+                }));
+            }
+            break;
+        default:
+            throw new Error(`Unknown task type: ${data}`);
+    }
+    await Promise.all(queries);
+}
+// Scheduler에서 Remote Task가 돌아갈 때 실행되는 부분
+// TODO: Retry를 지금은 서버에서 처리하기 떄문에 delay가 적용되지 않음.
+export async function wrapRemoteTask(router, info, onEvent, knex) {
+    const trx = await knex.transaction();
+    await (async ()=>{
+        const event = {
+            type: "fetch",
+            info: info,
+            timestamp: new Date()
+        };
+        onEvent(event);
+        await saveUnroutedTaskEvent(trx, event);
+    })();
+    // NOTE: 대기 처리를 Queue를 별도로 분리한다면 where status = "pending_for_retry"를 추가하면 됨.
+    const rawTask = await trx.select("id", "created_at", "updated_at", "namespace", "status", "attempt", "payload").from("sonamu_task_items").forUpdate().skipLocked().limit(1).first();
+    if (!rawTask) {
+        await trx.rollback();
+        return;
+    }
+    const item = {
+        id: knex.fn.binToUuid(rawTask.id),
+        createdAt: rawTask.created_at,
+        updatedAt: rawTask.updated_at,
+        status: rawTask.status,
+        namespace: rawTask.namespace,
+        attempt: rawTask.attempt,
+        payload: rawTask.payload
+    };
+    await (async ()=>{
+        const event = {
+            type: "process:start",
+            task: item,
+            timestamp: new Date(),
+            info: info
+        };
+        onEvent(event);
+        await saveRoutedTaskEvent(trx, router, event);
+    })();
+    // Router에서 Route를 찾음
+    const matched = findRoute(router, "", item.namespace);
+    if (!matched) {
+        await (async ()=>{
+            const event = {
+                type: "process:error",
+                task: item,
+                timestamp: new Date(),
+                info: info,
+                reason: "no_route"
+            };
+            onEvent(event);
+            await saveRoutedTaskEvent(trx, router, event);
+        })();
+        await trx.commit();
+        return;
+    }
+    try {
+        await routedAction(matched, item);
+        await (async ()=>{
+            const event = {
+                type: "process:complete",
+                task: item,
+                timestamp: new Date(),
+                info: matched.data.info
+            };
+            onEvent(event);
+            await saveRoutedTaskEvent(trx, router, event);
+        })();
+    } catch (err) {
+        let evt;
+        if (isSonamuTaskError(err)) {
+            evt = {
+                type: "process:error",
+                task: item,
+                timestamp: new Date(),
+                info: matched.data.info,
+                reason: err.type,
+                error: err.cause ?? err
+            };
+        } else if (err instanceof Error) {
+            evt = {
+                type: "process:error",
+                task: item,
+                timestamp: new Date(),
+                info: matched.data.info,
+                reason: "exception",
+                error: err
+            };
+        } else {
+            evt = {
+                type: "process:error",
+                task: item,
+                timestamp: new Date(),
+                info: matched.data.info,
+                reason: "exception",
+                error: new Error(`Unknown Error: ${err}`)
+            };
+        }
+        onEvent(evt);
+        await saveRoutedTaskEvent(trx, router, evt);
+    } finally{
+        await trx.commit();
+    }
+}
+
+//# sourceMappingURL=remote-task.js.map

package/dist/tasks/remote-task.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tasks/remote-task.ts"],"sourcesContent":["import type { Knex } from \"knex\";\nimport type {\n  SchedulerInfo,\n  TaskItem,\n  UnroutedTaskEvent,\n  RoutedTaskEvent,\n  TaskRouterContext,\n  TaskEvent,\n} from \"../types\";\nimport { type RouterContext, findRoute } from \"rou3\";\nimport { isSonamuTaskError } from \"../errors\";\nimport { routedAction } from \"./shared\";\n\n// start, stop, fetch 이벤트는 router를 잡기 전에 일어나서 별도로 분리\nexport async function saveUnroutedTaskEvent(knex: Knex, data: UnroutedTaskEvent) {\n  switch (data.type) {\n    case \"start\":\n      return knex\n        .insert({\n          event_type: data.type,\n          info_id: knex.fn.uuidToBin(data.info.id),\n          info_name: data.info.name,\n          timestamp: data.timestamp,\n        })\n        .into(\"sonamu_task_events\");\n    case \"stop\":\n      return knex\n        .insert({\n          event_type: data.type,\n          info_id: knex.fn.uuidToBin(data.info.id),\n          info_name: data.info.name,\n          timestamp: data.timestamp,\n          reason: data.reason,\n          error_message: data.error?.message,\n          error_stack: data.error?.stack,\n        })\n        .into(\"sonamu_task_events\");\n    case \"fetch\":\n      return knex\n        .insert({\n          event_type: data.type,\n          info_id: knex.fn.uuidToBin(data.info.id),\n          info_name: data.info.name,\n          timestamp: data.timestamp,\n        })\n        .into(\"sonamu_task_events\");\n\n    default:\n      throw new Error(`Unknown task event type: ${(data as any).type}`);\n  }\n}\n\n// router에서 매칭 후 생긴 이벤트를 처리\nexport async function saveRoutedTaskEvent<T extends RoutedTaskEvent>(\n  knex: Knex,\n  router: RouterContext<TaskRouterContext & { info: SchedulerInfo }>,\n  data: T,\n) {\n  const queries: Knex.QueryBuilder[] = [];\n  const matched = findRoute(router, \"\", data.task.namespace);\n\n  switch (data.type) {\n    case \"process:start\":\n      queries.push(\n        knex\n          .insert({\n            event_type: data.type,\n            info_id: knex.fn.uuidToBin(data.info.id),\n            info_name: data.info.name,\n            timestamp: data.timestamp,\n            task_item_id: knex.fn.uuidToBin(data.task.id),\n            attempt: data.task.attempt,\n          })\n          .into(\"sonamu_task_events\"),\n      );\n      break;\n\n    case \"process:complete\":\n      // sonamu_task_items의 TaskItem을 sonamu_archived_task_items로 이동\n      queries.push(\n        knex\n          .insert({\n            event_type: data.type,\n            info_id: knex.fn.uuidToBin(data.info.id),\n            info_name: data.info.name,\n            timestamp: data.timestamp,\n            task_item_id: knex.fn.uuidToBin(data.task.id),\n            attempt: data.task.attempt,\n          })\n          .into(\"sonamu_task_events\"),\n      );\n      queries.push(knex(\"sonamu_task_items\").where(\"id\", knex.fn.uuidToBin(data.task.id)).delete());\n      queries.push(\n        knex\n          .insert({\n            id: knex.fn.uuidToBin(data.task.id),\n            created_at: data.task.createdAt,\n            completed_at: data.timestamp,\n            namespace: data.task.namespace,\n            payload: data.task.payload,\n            attempt: data.task.attempt,\n            status: \"completed\",\n          })\n          .into(\"sonamu_archived_task_items\"),\n      );\n      break;\n\n    case \"process:error\":\n      queries.push(\n        knex\n          .insert({\n            event_type: data.type,\n            info_id: knex.fn.uuidToBin(data.info.id),\n            info_name: data.info.name,\n            timestamp: data.timestamp,\n            task_item_id: knex.fn.uuidToBin(data.task.id),\n            attempt: data.task.attempt,\n            reason: data.reason,\n            error_message: data.error?.message,\n            error_stack: data.error?.stack,\n          })\n          .into(\"sonamu_task_events\"),\n      );\n\n      if (data.task.attempt >= (matched?.data.retry.maxAttempts ?? 1)) {\n        // 최대 실행 횟수를 넘겼을 경우, 에러로 sonamu_archived_task_items로 옮김\n        queries.push(\n          knex(\"sonamu_task_items\").where(\"id\", knex.fn.uuidToBin(data.task.id)).delete(),\n        );\n\n        queries.push(\n          knex\n            .insert({\n              id: knex.fn.uuidToBin(data.task.id),\n              created_at: data.task.createdAt,\n              completed_at: data.timestamp,\n              namespace: data.task.namespace,\n              payload: data.task.payload,\n              attempt: data.task.attempt,\n              status: \"error\",\n            })\n            .into(\"sonamu_archived_task_items\"),\n        );\n      } else {\n        // 재시도 횟수 증가 및 상태 업데이트\n        queries.push(\n          knex(\"sonamu_task_items\")\n            .where(\"id\", knex.fn.uuidToBin(data.task.id))\n            .update({\n              status: \"pending\",\n              attempt: data.task.attempt + 1,\n              updated_at: data.timestamp,\n            }),\n        );\n      }\n      break;\n\n    default:\n      throw new Error(`Unknown task type: ${data}`);\n  }\n\n  await Promise.all(queries);\n}\n\n// Scheduler에서 Remote Task가 돌아갈 때 실행되는 부분\n// TODO: Retry를 지금은 서버에서 처리하기 떄문에 delay가 적용되지 않음.\nexport async function wrapRemoteTask(\n  router: RouterContext<TaskRouterContext & { info: SchedulerInfo }>,\n  info: SchedulerInfo,\n  onEvent: (data: TaskEvent) => void,\n  knex: Knex,\n) {\n  const trx = await knex.transaction();\n  await (async () => {\n    const event: UnroutedTaskEvent = {\n      type: \"fetch\",\n      info: info,\n      timestamp: new Date(),\n    };\n\n    onEvent(event);\n    await saveUnroutedTaskEvent(trx, event);\n  })();\n\n  // NOTE: 대기 처리를 Queue를 별도로 분리한다면 where status = \"pending_for_retry\"를 추가하면 됨.\n  const rawTask = await trx\n    .select(\"id\", \"created_at\", \"updated_at\", \"namespace\", \"status\", \"attempt\", \"payload\")\n    .from(\"sonamu_task_items\")\n    .forUpdate()\n    .skipLocked()\n    .limit(1)\n    .first();\n\n  if (!rawTask) {\n    await trx.rollback();\n    return;\n  }\n\n  const item: TaskItem = {\n    id: knex.fn.binToUuid(rawTask.id),\n    createdAt: rawTask.created_at,\n    updatedAt: rawTask.updated_at,\n    status: rawTask.status,\n    namespace: rawTask.namespace,\n    attempt: rawTask.attempt,\n    payload: rawTask.payload,\n  };\n\n  await (async () => {\n    const event: RoutedTaskEvent = {\n      type: \"process:start\",\n      task: item,\n      timestamp: new Date(),\n      info: info,\n    };\n\n    onEvent(event);\n    await saveRoutedTaskEvent(trx, router, event);\n  })();\n\n  // Router에서 Route를 찾음\n  const matched = findRoute(router, \"\", item.namespace);\n  if (!matched) {\n    await (async () => {\n      const event: RoutedTaskEvent = {\n        type: \"process:error\",\n        task: item,\n        timestamp: new Date(),\n        info: info,\n        reason: \"no_route\",\n      };\n\n      onEvent(event);\n      await saveRoutedTaskEvent(trx, router, event);\n    })();\n    await trx.commit();\n    return;\n  }\n\n  try {\n    await routedAction(matched, item);\n    await (async () => {\n      const event: RoutedTaskEvent = {\n        type: \"process:complete\",\n        task: item,\n        timestamp: new Date(),\n        info: matched.data.info,\n      };\n\n      onEvent(event);\n      await saveRoutedTaskEvent(trx, router, event);\n    })();\n  } catch (err) {\n    let evt: RoutedTaskEvent;\n    if (isSonamuTaskError(err)) {\n      evt = {\n        type: \"process:error\",\n        task: item,\n        timestamp: new Date(),\n        info: matched.data.info,\n        reason: err.type,\n        error: err.cause ?? err,\n      };\n    } else if (err instanceof Error) {\n      evt = {\n        type: \"process:error\",\n        task: item,\n        timestamp: new Date(),\n        info: matched.data.info,\n        reason: \"exception\",\n        error: err,\n      };\n    } else {\n      evt = {\n        type: \"process:error\",\n        task: item,\n        timestamp: new Date(),\n        info: matched.data.info,\n        reason: \"exception\",\n        error: new Error(`Unknown Error: ${err}`),\n      };\n    }\n\n    onEvent(evt);\n    await saveRoutedTaskEvent(trx, router, evt);\n  } finally {\n    await trx.commit();\n  }\n}\n"],"names":["findRoute","isSonamuTaskError","routedAction","saveUnroutedTaskEvent","knex","data","type","insert","event_type","info_id","fn","uuidToBin","info","id","info_name","name","timestamp","into","reason","error_message","error","message","error_stack","stack","Error","saveRoutedTaskEvent","router","queries","matched","task","namespace","push","task_item_id","attempt","where","delete","created_at","createdAt","completed_at","payload","status","retry","maxAttempts","update","updated_at","Promise","all","wrapRemoteTask","onEvent","trx","transaction","event","Date","rawTask","select","from","forUpdate","skipLocked","limit","first","rollback","item","binToUuid","updatedAt","commit","err","evt","cause"],"mappings":"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"}

package/dist/tasks/shared.d.ts

@@ -0,0 +1,8 @@
+import type { MatchedRoute } from "rou3";
+import type { TaskItem, TaskRouterContext, SchedulerInfo } from "../types";
+import { z } from "zod";
+export declare function convertTo<T extends z.ZodType>(schema: T, payload: Buffer | string | any): Promise<z.infer<T>>;
+export declare function routedAction(matched: MatchedRoute<TaskRouterContext & {
+    info: SchedulerInfo;
+}>, taskInfo: TaskItem): Promise<void>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tasks/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tasks/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,wBAAsB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACjD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAC7B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAkBrB;AAGD,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,CAAC,iBAAiB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,EAClE,QAAQ,EAAE,QAAQ,iBAsBnB"}

package/dist/tasks/shared.js

@@ -0,0 +1,41 @@
+import { SonamuTaskError } from "../errors.js";
+// UTF-8 JSON Buffer를 Zod Type으로 변환하는 함수.
+// NOTE: 여기를 잘 처리하면 serialize/parse를 JSON이 아닌 형식으로도 변환할 수 있음.
+export async function convertTo(schema, payload) {
+    try {
+        if (payload instanceof Buffer) {
+            return schema.parseAsync(JSON.parse(payload.toString()));
+        }
+        if (typeof payload === "string") {
+            return schema.parseAsync(JSON.parse(payload));
+        }
+        return schema.parseAsync(payload);
+    } catch (error) {
+        if (error instanceof Error) {
+            throw new SonamuTaskError("validation", error);
+        }
+        throw new SonamuTaskError("validation");
+    }
+}
+// Router에서 매칭 후, 모든 TaskItem의 처리
+export async function routedAction(matched, taskInfo) {
+    const { data: ctx, params } = matched;
+    // 재시도 횟수를 체크함.
+    if (ctx.retry.maxAttempts < taskInfo.attempt) {
+        throw new SonamuTaskError("max_retries_exceeded");
+    }
+    // 데이터를 파싱해서 context를 만들고 실제 route 함수를 실행.
+    const result = ctx.target({
+        taskItem: {
+            ...taskInfo,
+            payload: await convertTo(ctx.schema, taskInfo.payload)
+        },
+        params,
+        retry: ctx.retry
+    });
+    if (result instanceof Promise) {
+        await result;
+    }
+}
+
+//# sourceMappingURL=shared.js.map

package/dist/tasks/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tasks/shared.ts"],"sourcesContent":["import type { MatchedRoute } from \"rou3\";\nimport type { TaskItem, TaskRouterContext, SchedulerInfo } from \"../types\";\nimport { SonamuTaskError } from \"../errors\";\nimport { z } from \"zod\";\n\n// UTF-8 JSON Buffer를 Zod Type으로 변환하는 함수.\n// NOTE: 여기를 잘 처리하면 serialize/parse를 JSON이 아닌 형식으로도 변환할 수 있음.\nexport async function convertTo<T extends z.ZodType>(\n  schema: T,\n  payload: Buffer | string | any,\n): Promise<z.infer<T>> {\n  try {\n    if (payload instanceof Buffer) {\n      return schema.parseAsync(JSON.parse(payload.toString()));\n    }\n\n    if (typeof payload === \"string\") {\n      return schema.parseAsync(JSON.parse(payload));\n    }\n\n    return schema.parseAsync(payload);\n  } catch (error) {\n    if (error instanceof Error) {\n      throw new SonamuTaskError(\"validation\", error);\n    }\n\n    throw new SonamuTaskError(\"validation\");\n  }\n}\n\n// Router에서 매칭 후, 모든 TaskItem의 처리\nexport async function routedAction(\n  matched: MatchedRoute<TaskRouterContext & { info: SchedulerInfo }>,\n  taskInfo: TaskItem,\n) {\n  const { data: ctx, params } = matched;\n\n  // 재시도 횟수를 체크함.\n  if (ctx.retry.maxAttempts < taskInfo.attempt) {\n    throw new SonamuTaskError(\"max_retries_exceeded\");\n  }\n\n  // 데이터를 파싱해서 context를 만들고 실제 route 함수를 실행.\n  const result = ctx.target({\n    taskItem: {\n      ...taskInfo,\n      payload: await convertTo(ctx.schema, taskInfo.payload),\n    },\n    params,\n    retry: ctx.retry,\n  });\n\n  if (result instanceof Promise) {\n    await result;\n  }\n}\n"],"names":["SonamuTaskError","convertTo","schema","payload","Buffer","parseAsync","JSON","parse","toString","error","Error","routedAction","matched","taskInfo","data","ctx","params","retry","maxAttempts","attempt","result","target","taskItem","Promise"],"mappings":"AAEA,SAASA,eAAe,QAAQ,eAAY;AAG5C,yCAAyC;AACzC,6DAA6D;AAC7D,OAAO,eAAeC,UACpBC,MAAS,EACTC,OAA8B;IAE9B,IAAI;QACF,IAAIA,mBAAmBC,QAAQ;YAC7B,OAAOF,OAAOG,UAAU,CAACC,KAAKC,KAAK,CAACJ,QAAQK,QAAQ;QACtD;QAEA,IAAI,OAAOL,YAAY,UAAU;YAC/B,OAAOD,OAAOG,UAAU,CAACC,KAAKC,KAAK,CAACJ;QACtC;QAEA,OAAOD,OAAOG,UAAU,CAACF;IAC3B,EAAE,OAAOM,OAAO;QACd,IAAIA,iBAAiBC,OAAO;YAC1B,MAAM,IAAIV,gBAAgB,cAAcS;QAC1C;QAEA,MAAM,IAAIT,gBAAgB;IAC5B;AACF;AAEA,iCAAiC;AACjC,OAAO,eAAeW,aACpBC,OAAkE,EAClEC,QAAkB;IAElB,MAAM,EAAEC,MAAMC,GAAG,EAAEC,MAAM,EAAE,GAAGJ;IAE9B,eAAe;IACf,IAAIG,IAAIE,KAAK,CAACC,WAAW,GAAGL,SAASM,OAAO,EAAE;QAC5C,MAAM,IAAInB,gBAAgB;IAC5B;IAEA,0CAA0C;IAC1C,MAAMoB,SAASL,IAAIM,MAAM,CAAC;QACxBC,UAAU;YACR,GAAGT,QAAQ;YACXV,SAAS,MAAMF,UAAUc,IAAIb,MAAM,EAAEW,SAASV,OAAO;QACvD;QACAa;QACAC,OAAOF,IAAIE,KAAK;IAClB;IAEA,IAAIG,kBAAkBG,SAAS;QAC7B,MAAMH;IACR;AACF"}

package/dist/testing/connection.d.ts

@@ -0,0 +1,7 @@
+import { type Knex } from "knex";
+import { BackendPostgres } from "../database/backend";
+export declare const KNEX_GLOBAL_CONFIG: Knex.Config;
+export declare function migrate(): Promise<void>;
+export declare function createBackend(): Promise<BackendPostgres>;
+export declare function stopBackend(): Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/testing/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/testing/connection.ts"],"names":[],"mappings":"AACA,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKtD,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,MAY5B,CAAC;AAEX,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAU9D;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}

package/dist/testing/connection.js

@@ -0,0 +1,38 @@
+import { randomUUID } from "node:crypto";
+import knex from "knex";
+import { BackendPostgres } from "../database/backend.js";
+import { migrate as baseMigrate, DEFAULT_SCHEMA } from "../database/base.js";
+let backend = null;
+export const KNEX_GLOBAL_CONFIG = {
+    client: "pg",
+    connection: {
+        host: "127.0.0.1",
+        port: 5432,
+        user: "postgres",
+        password: "miomock123",
+        database: "postgres"
+    },
+    pool: {
+        max: 50
+    }
+};
+export async function migrate() {
+    await baseMigrate(knex(KNEX_GLOBAL_CONFIG), DEFAULT_SCHEMA);
+}
+export async function createBackend() {
+    if (backend) {
+        return backend;
+    }
+    backend = await BackendPostgres.connect(KNEX_GLOBAL_CONFIG, {
+        namespaceId: randomUUID()
+    });
+    return backend;
+}
+export async function stopBackend() {
+    if (backend) {
+        await backend.stop();
+    }
+    backend = null;
+}
+
+//# sourceMappingURL=connection.js.map

package/dist/testing/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/connection.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport knex, { type Knex } from \"knex\";\nimport { BackendPostgres } from \"../database/backend\";\nimport { migrate as baseMigrate, DEFAULT_SCHEMA } from \"../database/base\";\n\nlet backend: BackendPostgres | null = null;\n\nexport const KNEX_GLOBAL_CONFIG: Knex.Config = {\n  client: \"pg\",\n  connection: {\n    host: \"127.0.0.1\",\n    port: 5432,\n    user: \"postgres\",\n    password: \"miomock123\",\n    database: \"postgres\",\n  },\n  pool: {\n    max: 50,\n  },\n} as const;\n\nexport async function migrate(): Promise<void> {\n  await baseMigrate(knex(KNEX_GLOBAL_CONFIG), DEFAULT_SCHEMA);\n}\n\nexport async function createBackend(): Promise<BackendPostgres> {\n  if (backend) {\n    return backend;\n  }\n\n  backend = await BackendPostgres.connect(KNEX_GLOBAL_CONFIG, {\n    namespaceId: randomUUID(),\n  });\n\n  return backend;\n}\n\nexport async function stopBackend(): Promise<void> {\n  if (backend) {\n    await backend.stop();\n  }\n\n  backend = null;\n}\n"],"names":["randomUUID","knex","BackendPostgres","migrate","baseMigrate","DEFAULT_SCHEMA","backend","KNEX_GLOBAL_CONFIG","client","connection","host","port","user","password","database","pool","max","createBackend","connect","namespaceId","stopBackend","stop"],"mappings":"AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,OAAOC,UAAyB,OAAO;AACvC,SAASC,eAAe,QAAQ,yBAAsB;AACtD,SAASC,WAAWC,WAAW,EAAEC,cAAc,QAAQ,sBAAmB;AAE1E,IAAIC,UAAkC;AAEtC,OAAO,MAAMC,qBAAkC;IAC7CC,QAAQ;IACRC,YAAY;QACVC,MAAM;QACNC,MAAM;QACNC,MAAM;QACNC,UAAU;QACVC,UAAU;IACZ;IACAC,MAAM;QACJC,KAAK;IACP;AACF,EAAW;AAEX,OAAO,eAAeb;IACpB,MAAMC,YAAYH,KAAKM,qBAAqBF;AAC9C;AAEA,OAAO,eAAeY;IACpB,IAAIX,SAAS;QACX,OAAOA;IACT;IAEAA,UAAU,MAAMJ,gBAAgBgB,OAAO,CAACX,oBAAoB;QAC1DY,aAAanB;IACf;IAEA,OAAOM;AACT;AAEA,OAAO,eAAec;IACpB,IAAId,SAAS;QACX,MAAMA,QAAQe,IAAI;IACpB;IAEAf,UAAU;AACZ"}

package/dist/types/config.d.ts

@@ -0,0 +1,44 @@
+import type { Knex } from "knex";
+import type { UnroutedTaskEvent } from "./events";
+import type { z } from "zod";
+import type { Duration } from "date-fns";
+import type { TaskRouterContext } from "./context";
+export interface RetryConfig {
+    maxAttempts: number;
+    delay?: Duration | ((attempt: number) => Duration);
+}
+export type OnEventFunction<T extends UnroutedTaskEvent = UnroutedTaskEvent> = (event: T) => void | Promise<void>;
+export interface RemoteTaskConfig {
+    type: "remote";
+    expression: string;
+    options?: {
+        timezone?: string;
+        name?: string;
+        noOverlap?: boolean;
+        maxExecutions?: number;
+        maxRandomDelay?: number;
+    };
+}
+export interface LocalTaskConfig<T extends z.ZodType = z.ZodType> {
+    type: "local";
+    expression: string;
+    namespace: string;
+    payload: Buffer | z.infer<T>;
+    options?: {
+        timezone?: string;
+        name?: string;
+        noOverlap?: boolean;
+        maxExecutions?: number;
+        maxRandomDelay?: number;
+    };
+}
+export interface SchedulerConfig {
+    database: Knex.Config;
+    name?: string;
+    tasks: (RemoteTaskConfig | LocalTaskConfig)[];
+    retry?: RetryConfig;
+    routes: (Omit<TaskRouterContext, "retry"> & {
+        retry?: RetryConfig;
+    })[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,WAAW;IAE1B,WAAW,EAAE,MAAM,CAAC;IAEpB,KAAK,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,CAC7E,KAAK,EAAE,CAAC,KACL,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAG1B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAGD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;IAGtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,EAAE,CAAC,gBAAgB,GAAG,eAAe,CAAC,EAAE,CAAC;IAG9C,KAAK,CAAC,EAAE,WAAW,CAAC;IAGpB,MAAM,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,EAAE,CAAC;CACxE"}

package/dist/types/config.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["import type { Knex } from \"knex\";\nimport type { UnroutedTaskEvent } from \"./events\";\nimport type { z } from \"zod\";\nimport type { Duration } from \"date-fns\";\nimport type { TaskRouterContext } from \"./context\";\n\nexport interface RetryConfig {\n  // 최대 횟수 (def: 1, 재시도를 안함)\n  maxAttempts: number;\n  // 재시도 간격\n  delay?: Duration | ((attempt: number) => Duration);\n}\n\nexport type OnEventFunction<T extends UnroutedTaskEvent = UnroutedTaskEvent> = (\n  event: T,\n) => void | Promise<void>;\n\n// MySQL에서 받아와서 있으면 실행할 태스크\nexport interface RemoteTaskConfig {\n  type: \"remote\";\n  expression: string;\n  options?: {\n    timezone?: string;\n    name?: string;\n    noOverlap?: boolean;\n    maxExecutions?: number;\n    maxRandomDelay?: number;\n  };\n}\n\n// 로컬에서 router로 잡아서 실행할 태스크\nexport interface LocalTaskConfig<T extends z.ZodType = z.ZodType> {\n  type: \"local\";\n  expression: string;\n  // router 태울 namespace\n  namespace: string;\n  payload: Buffer | z.infer<T>;\n  options?: {\n    timezone?: string;\n    name?: string;\n    noOverlap?: boolean;\n    maxExecutions?: number;\n    maxRandomDelay?: number;\n  };\n}\n\nexport interface SchedulerConfig {\n  database: Knex.Config;\n\n  // TaskNode에 이름을 지정할 수 있음\n  name?: string;\n\n  // Task 설정\n  tasks: (RemoteTaskConfig | LocalTaskConfig)[];\n\n  // 전역적 재시도 설정 (없으면 각 Task의 설정을 따름)\n  retry?: RetryConfig;\n\n  // 어느 Namespace의 Task를 어떻게 처리할지\n  routes: (Omit<TaskRouterContext, \"retry\"> & { retry?: RetryConfig })[];\n}\n"],"names":[],"mappings":"AA8CA,WAcC"}

package/dist/types/context.d.ts

@@ -0,0 +1,18 @@
+import type { z } from "zod";
+import type { RetryConfig } from "./config";
+import type { TaskItem } from "./task-items";
+import type { Callback } from "./utils";
+export interface TaskRouterContext<T extends z.ZodType = z.ZodType> {
+    path: string;
+    retry: RetryConfig;
+    schema: T;
+    target: Callback<TaskContext<T>, void>;
+}
+export type TaskContext<T extends z.ZodType = z.ZodType> = {
+    params?: Record<string, string>;
+    retry: RetryConfig;
+    taskItem: Omit<TaskItem, "payload"> & {
+        payload: z.infer<T>;
+    };
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;CACxC;AAGD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;CAC/D,CAAC"}

package/dist/types/context.js

@@ -0,0 +1,4 @@
+// 각 Task Route 함수가 가지고 있을 Context 정보
+export { };
+
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/context.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type { RetryConfig } from \"./config\";\nimport type { TaskItem } from \"./task-items\";\nimport type { Callback } from \"./utils\";\n\n// Router에서 가지고 있을 Context 정보\nexport interface TaskRouterContext<T extends z.ZodType = z.ZodType> {\n  path: string;\n  retry: RetryConfig;\n  schema: T;\n  target: Callback<TaskContext<T>, void>;\n}\n\n// 각 Task Route 함수가 가지고 있을 Context 정보\nexport type TaskContext<T extends z.ZodType = z.ZodType> = {\n  params?: Record<string, string>;\n  retry: RetryConfig;\n  taskItem: Omit<TaskItem, \"payload\"> & { payload: z.infer<T> };\n};\n"],"names":[],"mappings":"AAaA,qCAAqC;AACrC,WAIE"}

package/dist/types/events.d.ts

@@ -0,0 +1,43 @@
+import type { TaskItem } from "./task-items";
+export type EventType = "start" | "stop" | "fetch" | "process:start" | "process:error" | "process:complete";
+export type TerminationReasonEnum = "app_shutdown" | "process_signal" | "unknown";
+export type ProcessErrorReasonEnum = "no_route" | "validation" | "timeout" | "max_retries_exceeded" | "exception";
+export interface SchedulerInfo {
+    id: string;
+    name?: string;
+}
+interface BaseNodeEvent {
+    type: EventType;
+    info: SchedulerInfo;
+    timestamp: Date;
+}
+export interface StartEvent extends BaseNodeEvent {
+    type: "start";
+}
+export interface StopEvent extends BaseNodeEvent {
+    type: "stop";
+    reason: TerminationReasonEnum;
+    error?: Error;
+}
+export interface FetchEvent extends BaseNodeEvent {
+    type: "fetch";
+}
+export interface ProcessStartEvent extends BaseNodeEvent {
+    type: "process:start";
+    task: TaskItem;
+}
+export interface ProcessCompleteEvent extends BaseNodeEvent {
+    type: "process:complete";
+    task: TaskItem;
+}
+export interface ProcessErrorEvent extends BaseNodeEvent {
+    type: "process:error";
+    task: TaskItem;
+    reason: ProcessErrorReasonEnum;
+    error?: Error;
+}
+export type RoutedTaskEvent = ProcessStartEvent | ProcessCompleteEvent | ProcessErrorEvent;
+export type UnroutedTaskEvent = StartEvent | StopEvent | FetchEvent;
+export type TaskEvent = UnroutedTaskEvent | RoutedTaskEvent;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,MAAM,GACN,OAAO,GACP,eAAe,GACf,eAAe,GACf,kBAAkB,CAAC;AAMvB,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAQlF,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,YAAY,GACZ,SAAS,GACT,sBAAsB,GACtB,WAAW,CAAC;AAGhB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAGD,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;CACf;AAGD,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,EAAE,qBAAqB,CAAC;IAE9B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;CACf;AAGD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAGD,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAGD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;IAE/B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAC3F,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,eAAe,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/events.ts"],"sourcesContent":["import type { TaskItem } from \"./task-items\";\n\n// Event에는 시간, Event 타입, Task에 대한 namespace, Task ID, 처리한 Task의 노드 이름, 이벤트에 대한 메타 정보 데이터 등이 들어감.\nexport type EventType =\n  | \"start\"\n  | \"stop\"\n  | \"fetch\"\n  | \"process:start\"\n  | \"process:error\"\n  | \"process:complete\";\n\n// Task가 왜 중단되는지를 남김.\n//  - app_shutdown: 애플리케이션의 정상적인 종료\n//  - process_signal: 외부에서의 프로세스 시그널로 인한 중단\n//  - unknown: 모름, 그래서 call stack을 남겨야함.\nexport type TerminationReasonEnum = \"app_shutdown\" | \"process_signal\" | \"unknown\";\n\n// Process Error 사유\n//  - no_route: Task가 이 namespace를 지원하지 않음\n//  - serialization: 인자 등 데이터의 검증에 실패함\n//  - timeout: 처리 중 타임아웃\n//  - max_retries_exceeded: 최대 재시도 횟수 초과\n//  - exception: 다른 예외 발생\nexport type ProcessErrorReasonEnum =\n  | \"no_route\"\n  | \"validation\"\n  | \"timeout\"\n  | \"max_retries_exceeded\"\n  | \"exception\";\n\n// id는 자동으로 생성된 uuidv7, 이름은 설정을 통해 명시적으로 지정 가능\nexport interface SchedulerInfo {\n  id: string;\n  name?: string;\n}\n\ninterface BaseNodeEvent {\n  type: EventType;\n  info: SchedulerInfo;\n  timestamp: Date;\n}\n\n// Task가 시작될 때 생기는 이벤트\nexport interface StartEvent extends BaseNodeEvent {\n  type: \"start\";\n}\n\n// Task가 종료될 때 생기는 이벤트\nexport interface StopEvent extends BaseNodeEvent {\n  type: \"stop\";\n  // Task가 종료된 이유\n  reason: TerminationReasonEnum;\n  // StopEvent.type가 unknown일 때는 call stack을 기록\n  error?: Error;\n}\n\n// Remote Task에서 Task Item을 가져올 때 생기는 이벤트\nexport interface FetchEvent extends BaseNodeEvent {\n  type: \"fetch\";\n}\n\n// Task에서 TaskItem 처리를 시작할 때 생기는 이벤트\nexport interface ProcessStartEvent extends BaseNodeEvent {\n  type: \"process:start\";\n  task: TaskItem;\n}\n\n// Task에서 TaskItem 처리를 완료했을 때 생기는 이벤트\nexport interface ProcessCompleteEvent extends BaseNodeEvent {\n  type: \"process:complete\";\n  task: TaskItem;\n}\n\n// Task에서 TaskItem 처리를 실패했을 때 생기는 이벤트\nexport interface ProcessErrorEvent extends BaseNodeEvent {\n  type: \"process:error\";\n  task: TaskItem;\n  reason: ProcessErrorReasonEnum;\n  // ProcessErrorEvent.type가 no_route, timeout, max_retries_exceeded이 아닐 때는 call stack을 기록\n  error?: Error;\n}\n\nexport type RoutedTaskEvent = ProcessStartEvent | ProcessCompleteEvent | ProcessErrorEvent;\nexport type UnroutedTaskEvent = StartEvent | StopEvent | FetchEvent;\nexport type TaskEvent = UnroutedTaskEvent | RoutedTaskEvent;\n"],"names":[],"mappings":"AAoFA,WAA4D"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./utils";
+export type * from "./config";
+export type * from "./context";
+export type * from "./events";
+export type * from "./task-items";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export * from "./utils.js";
+
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["export * from \"./utils\";\nexport type * from \"./config\";\nexport type * from \"./context\";\nexport type * from \"./events\";\nexport type * from \"./task-items\";\n"],"names":[],"mappings":"AAAA,cAAc,aAAU"}

package/dist/types/task-items.d.ts

@@ -0,0 +1,12 @@
+import type { z } from "zod";
+export type TaskItemState = "pending" | "error" | "completed";
+export interface TaskItem<T extends z.ZodType = z.ZodType> {
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    status: TaskItemState;
+    namespace: string;
+    attempt: number;
+    payload: Buffer | z.infer<T>;
+}
+//# sourceMappingURL=task-items.d.ts.map

package/dist/types/task-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-items.d.ts","sourceRoot":"","sources":["../../src/types/task-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAC9B"}

package/dist/types/task-items.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=task-items.js.map

package/dist/types/task-items.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/task-items.ts"],"sourcesContent":["import type { z } from \"zod\";\n\n// Task 상태\n//  - pending: 대기 중\n//  - pending_for_retry: 재시도 대기 중\n//  - error: 처리 중 에러 발생 (처리 종료)\n//  - completed: 처리 완료\nexport type TaskItemState = \"pending\" | \"error\" | \"completed\";\n\nexport interface TaskItem<T extends z.ZodType = z.ZodType> {\n  id: string;\n  createdAt: Date;\n  updatedAt: Date;\n  status: TaskItemState;\n  namespace: string;\n  attempt: number;\n  // Task의 payload.\n  payload: Buffer | z.infer<T>;\n}\n"],"names":[],"mappings":"AASA,WASC"}

package/dist/types/utils.d.ts

@@ -0,0 +1,4 @@
+export type Resolvable<T> = T | Promise<T> | (() => T | Promise<T>);
+export type Callback<TArg, TReturn> = ((arg: TArg) => TReturn) | ((arg: TArg) => Promise<TReturn>);
+export declare function resolve<T>(value: Resolvable<T>): Promise<T>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/types/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,MAAM,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnG,wBAAsB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMjE"}

package/dist/types/utils.js

@@ -0,0 +1,8 @@
+export async function resolve(value) {
+    if (value instanceof Function) {
+        return value();
+    }
+    return value;
+}
+
+//# sourceMappingURL=utils.js.map

package/dist/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/utils.ts"],"sourcesContent":["export type Resolvable<T> = T | Promise<T> | (() => T | Promise<T>);\nexport type Callback<TArg, TReturn> = ((arg: TArg) => TReturn) | ((arg: TArg) => Promise<TReturn>);\n\nexport async function resolve<T>(value: Resolvable<T>): Promise<T> {\n  if (value instanceof Function) {\n    return value();\n  }\n\n  return value;\n}\n"],"names":["resolve","value","Function"],"mappings":"AAGA,OAAO,eAAeA,QAAWC,KAAoB;IACnD,IAAIA,iBAAiBC,UAAU;QAC7B,OAAOD;IACT;IAEA,OAAOA;AACT"}