@sonamu-kit/tasks 0.0.1 → 0.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonamu-kit/tasks",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "type": "module",
   "description": "Sonamu Task - Simple & Distributed Task Queue",
   "main": "./dist/index.js",
@@ -16,17 +16,6 @@
       "development": "./src/internal.ts"
     }
   },
-  "scripts": {
-    "dev": "nodemon exec",
-    "build": "swc src --config-file .swcrc -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
-    "check": "tsc --noEmit && biome format --write ./src/**/*.ts",
-    "check:type": "tsc --noEmit",
-    "check:format": "biome format --write ./src/**/*.ts",
-    "pretest": "tsx scripts/migrate.ts",
-    "test": "vitest run",
-    "test:watch": "vitest watch --standalone",
-    "test:coverage": "vitest run --coverage"
-  },
   "author": "CartaNova <dev@cartanova.ai>",
   "repository": {
     "type": "git",
@@ -41,14 +30,14 @@
     "pg": "^8.16.3",
     "rou3": "^0.7.10",
     "uuid": "^13.0.0",
-    "zod": "^4.1.12"
+    "zod": "^4.1.12",
+    "c12": "^3.3.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.7",
     "@swc/cli": "^0.7.8",
     "@swc/core": "^1.15.3",
     "@types/node": "^24.9.2",
-    "c12": "^3.3.2",
     "nodemon": "^3.1.10",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
@@ -59,5 +48,16 @@
   },
   "optionalDependencies": {
     "pg-native": "^3.5.2"
+  },
+  "scripts": {
+    "dev": "nodemon exec",
+    "build": "swc src --config-file .swcrc -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "check": "tsc --noEmit && biome format --write ./src/**/*.ts",
+    "check:type": "tsc --noEmit",
+    "check:format": "biome format --write ./src/**/*.ts",
+    "pretest": "tsx scripts/migrate.ts",
+    "test": "vitest run",
+    "test:watch": "vitest watch --standalone",
+    "test:coverage": "vitest run --coverage"
   }
-}
+}

package/dist/errors.d.ts

@@ -1,8 +0,0 @@
-import { ProcessErrorReasonEnum } from "./types";
-export declare class SonamuTaskError extends Error {
-    cause: Error | undefined;
-    type: ProcessErrorReasonEnum;
-    constructor(type?: ProcessErrorReasonEnum, cause?: Error);
-}
-export declare function isSonamuTaskError(error: unknown): error is SonamuTaskError;
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,sBAAsB,CAAC;gBAEjB,IAAI,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,KAAK;CAazD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/errors.js

@@ -1,21 +0,0 @@
-export class SonamuTaskError extends Error {
-    cause;
-    type;
-    constructor(type, cause){
-        if (!type) {
-            type = "exception";
-        }
-        super(`SonamuTaskError: ${type}`);
-        this.name = "SonamuTaskError";
-        this.type = type;
-        if (cause) {
-            this.cause = cause;
-            this.stack = cause.stack;
-        }
-    }
-}
-export function isSonamuTaskError(error) {
-    return error instanceof SonamuTaskError;
-}
-
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["import { ProcessErrorReasonEnum } from \"./types\";\n\nexport class SonamuTaskError extends Error {\n  cause: Error | undefined;\n  type: ProcessErrorReasonEnum;\n\n  constructor(type?: ProcessErrorReasonEnum, cause?: Error) {\n    if (!type) {\n      type = \"exception\";\n    }\n\n    super(`SonamuTaskError: ${type}`);\n    this.name = \"SonamuTaskError\";\n    this.type = type;\n    if (cause) {\n      this.cause = cause;\n      this.stack = cause.stack;\n    }\n  }\n}\n\nexport function isSonamuTaskError(error: unknown): error is SonamuTaskError {\n  return error instanceof SonamuTaskError;\n}\n"],"names":["SonamuTaskError","Error","cause","type","name","stack","isSonamuTaskError","error"],"mappings":"AAEA,OAAO,MAAMA,wBAAwBC;IACnCC,MAAyB;IACzBC,KAA6B;IAE7B,YAAYA,IAA6B,EAAED,KAAa,CAAE;QACxD,IAAI,CAACC,MAAM;YACTA,OAAO;QACT;QAEA,KAAK,CAAC,CAAC,iBAAiB,EAAEA,MAAM;QAChC,IAAI,CAACC,IAAI,GAAG;QACZ,IAAI,CAACD,IAAI,GAAGA;QACZ,IAAID,OAAO;YACT,IAAI,CAACA,KAAK,GAAGA;YACb,IAAI,CAACG,KAAK,GAAGH,MAAMG,KAAK;QAC1B;IACF;AACF;AAEA,OAAO,SAASC,kBAAkBC,KAAc;IAC9C,OAAOA,iBAAiBP;AAC1B"}

package/dist/practices/01-remote.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=01-remote.d.ts.map

package/dist/practices/01-remote.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"01-remote.d.ts","sourceRoot":"","sources":["../../src/practices/01-remote.ts"],"names":[],"mappings":""}

package/dist/practices/01-remote.js

@@ -1,87 +0,0 @@
-import { z } from "zod";
-import { createScheduler } from "../scheduler.js";
-import assert from "node:assert";
-function getConfig() {
-    const schema = z.object();
-    return {
-        database: {
-            client: "mysql2",
-            pool: {
-                min: 1,
-                max: 5
-            },
-            connection: {
-                database: "miomock",
-                host: "0.0.0.0",
-                port: 3306,
-                user: "root",
-                password: "miomock123",
-                typeCast: function(field, next) {
-                    if (field.type === "TINY" && field.length === 1) {
-                        const value = field.string();
-                        return value ? value === "1" : null;
-                    }
-                    // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)
-                    if (field.type === "DATE") {
-                        return field.string();
-                    }
-                    return next();
-                }
-            }
-        },
-        routes: [
-            {
-                path: "/test",
-                schema: schema,
-                target: async (ctx)=>{
-                    console.log("Processed", ctx);
-                }
-            },
-            {
-                path: "/test2",
-                retry: {
-                    maxAttempts: 3,
-                    delay: {
-                        seconds: 1
-                    }
-                },
-                schema: schema,
-                target: async ({ taskItem, retry })=>{
-                    if (taskItem.attempt !== retry.maxAttempts) {
-                        throw new Error("실패!");
-                    }
-                }
-            }
-        ],
-        retry: {
-            delay: {},
-            maxAttempts: 1
-        },
-        tasks: [
-            {
-                type: "remote",
-                // node-cron은 초까지 지원하기 때문에 이렇게 10초마다 돌릴 수 있음.
-                expression: "*/10 * * * * *",
-                options: {
-                    timezone: "Asia/Seoul",
-                    name: "remote-job",
-                    noOverlap: false
-                }
-            }
-        ]
-    };
-}
-(async ()=>{
-    const scheduler = await createScheduler(getConfig());
-    // name이 *일 경우엔 모든 이벤트를 수신할 수 있음.
-    scheduler.on("*", (evt)=>{
-        console.log("Event: ", evt);
-    });
-    scheduler.on("process:start", (evt)=>{
-        assert(evt.type === "process:start");
-        console.log("[Process Started] Task Item: ", evt.task.id);
-    });
-    scheduler.start();
-})();
-
-//# sourceMappingURL=01-remote.js.map

package/dist/practices/01-remote.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/practices/01-remote.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { createScheduler } from \"../scheduler\";\nimport type { TaskContext, SchedulerConfig, TaskEvent } from \"../types\";\nimport assert from \"node:assert\";\n\nfunction getConfig(): SchedulerConfig {\n  const schema = z.object();\n\n  return {\n    database: {\n      client: \"mysql2\",\n      pool: { min: 1, max: 5 },\n      connection: {\n        database: \"miomock\",\n        host: \"0.0.0.0\",\n        port: 3306,\n        user: \"root\",\n        password: \"miomock123\",\n        typeCast: function (field: any, next: any) {\n          if (field.type === \"TINY\" && field.length === 1) {\n            const value = field.string();\n            return value ? value === \"1\" : null;\n          }\n          // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)\n          if (field.type === \"DATE\") {\n            return field.string();\n          }\n          return next();\n        },\n      },\n    },\n    routes: [\n      {\n        path: \"/test\",\n        schema: schema,\n        target: async (ctx: TaskContext<typeof schema>) => {\n          console.log(\"Processed\", ctx);\n        },\n      },\n      {\n        path: \"/test2\",\n        retry: { maxAttempts: 3, delay: { seconds: 1 } },\n        schema: schema,\n        target: async ({ taskItem, retry }: TaskContext<typeof schema>) => {\n          if (taskItem.attempt !== retry.maxAttempts) {\n            throw new Error(\"실패!\");\n          }\n        },\n      },\n    ],\n\n    retry: {\n      delay: {},\n      maxAttempts: 1,\n    },\n\n    tasks: [\n      {\n        type: \"remote\",\n        // node-cron은 초까지 지원하기 때문에 이렇게 10초마다 돌릴 수 있음.\n        expression: \"*/10 * * * * *\",\n        options: {\n          timezone: \"Asia/Seoul\",\n          name: \"remote-job\",\n          noOverlap: false,\n        },\n      },\n    ],\n  };\n}\n\n(async () => {\n  const scheduler = await createScheduler(getConfig());\n\n  // name이 *일 경우엔 모든 이벤트를 수신할 수 있음.\n  scheduler.on(\"*\", (evt: TaskEvent) => {\n    console.log(\"Event: \", evt);\n  });\n\n  scheduler.on(\"process:start\", (evt: TaskEvent) => {\n    assert(evt.type === \"process:start\");\n    console.log(\"[Process Started] Task Item: \", evt.task.id);\n  });\n\n  scheduler.start();\n})();\n"],"names":["z","createScheduler","assert","getConfig","schema","object","database","client","pool","min","max","connection","host","port","user","password","typeCast","field","next","type","length","value","string","routes","path","target","ctx","console","log","retry","maxAttempts","delay","seconds","taskItem","attempt","Error","tasks","expression","options","timezone","name","noOverlap","scheduler","on","evt","task","id","start"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,kBAAe;AAE/C,OAAOC,YAAY,cAAc;AAEjC,SAASC;IACP,MAAMC,SAASJ,EAAEK,MAAM;IAEvB,OAAO;QACLC,UAAU;YACRC,QAAQ;YACRC,MAAM;gBAAEC,KAAK;gBAAGC,KAAK;YAAE;YACvBC,YAAY;gBACVL,UAAU;gBACVM,MAAM;gBACNC,MAAM;gBACNC,MAAM;gBACNC,UAAU;gBACVC,UAAU,SAAUC,KAAU,EAAEC,IAAS;oBACvC,IAAID,MAAME,IAAI,KAAK,UAAUF,MAAMG,MAAM,KAAK,GAAG;wBAC/C,MAAMC,QAAQJ,MAAMK,MAAM;wBAC1B,OAAOD,QAAQA,UAAU,MAAM;oBACjC;oBACA,mCAAmC;oBACnC,IAAIJ,MAAME,IAAI,KAAK,QAAQ;wBACzB,OAAOF,MAAMK,MAAM;oBACrB;oBACA,OAAOJ;gBACT;YACF;QACF;QACAK,QAAQ;YACN;gBACEC,MAAM;gBACNpB,QAAQA;gBACRqB,QAAQ,OAAOC;oBACbC,QAAQC,GAAG,CAAC,aAAaF;gBAC3B;YACF;YACA;gBACEF,MAAM;gBACNK,OAAO;oBAAEC,aAAa;oBAAGC,OAAO;wBAAEC,SAAS;oBAAE;gBAAE;gBAC/C5B,QAAQA;gBACRqB,QAAQ,OAAO,EAAEQ,QAAQ,EAAEJ,KAAK,EAA8B;oBAC5D,IAAII,SAASC,OAAO,KAAKL,MAAMC,WAAW,EAAE;wBAC1C,MAAM,IAAIK,MAAM;oBAClB;gBACF;YACF;SACD;QAEDN,OAAO;YACLE,OAAO,CAAC;YACRD,aAAa;QACf;QAEAM,OAAO;YACL;gBACEjB,MAAM;gBACN,6CAA6C;gBAC7CkB,YAAY;gBACZC,SAAS;oBACPC,UAAU;oBACVC,MAAM;oBACNC,WAAW;gBACb;YACF;SACD;IACH;AACF;AAEC,CAAA;IACC,MAAMC,YAAY,MAAMzC,gBAAgBE;IAExC,iCAAiC;IACjCuC,UAAUC,EAAE,CAAC,KAAK,CAACC;QACjBjB,QAAQC,GAAG,CAAC,WAAWgB;IACzB;IAEAF,UAAUC,EAAE,CAAC,iBAAiB,CAACC;QAC7B1C,OAAO0C,IAAIzB,IAAI,KAAK;QACpBQ,QAAQC,GAAG,CAAC,iCAAiCgB,IAAIC,IAAI,CAACC,EAAE;IAC1D;IAEAJ,UAAUK,KAAK;AACjB,CAAA"}

package/dist/practices/02-local.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=02-local.d.ts.map

package/dist/practices/02-local.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"02-local.d.ts","sourceRoot":"","sources":["../../src/practices/02-local.ts"],"names":[],"mappings":""}

package/dist/practices/02-local.js

@@ -1,84 +0,0 @@
-import { z } from "zod";
-import { createScheduler } from "../scheduler.js";
-function getConfig() {
-    const schema = z.object();
-    return {
-        database: {
-            client: "mysql2",
-            pool: {
-                min: 1,
-                max: 5
-            },
-            connection: {
-                database: "miomock",
-                host: "0.0.0.0",
-                port: 3306,
-                user: "root",
-                password: "miomock123",
-                typeCast: function(field, next) {
-                    if (field.type === "TINY" && field.length === 1) {
-                        const value = field.string();
-                        return value ? value === "1" : null;
-                    }
-                    // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)
-                    if (field.type === "DATE") {
-                        return field.string();
-                    }
-                    return next();
-                }
-            }
-        },
-        routes: [
-            {
-                path: "/test",
-                schema: schema,
-                target: async (ctx)=>{
-                    console.log("Processed", ctx);
-                }
-            },
-            {
-                path: "/test2",
-                retry: {
-                    maxAttempts: 3,
-                    delay: {
-                        seconds: 1
-                    }
-                },
-                schema: schema,
-                target: async ({ taskItem, retry })=>{
-                    // 마지막 시도에서만 성공하게 함.
-                    if (taskItem.attempt !== retry.maxAttempts) {
-                        throw new Error("실패!");
-                    }
-                }
-            }
-        ],
-        retry: {
-            delay: {},
-            maxAttempts: 1
-        },
-        tasks: [
-            {
-                type: "local",
-                expression: "*/10 * * * * *",
-                // local에서 실행할 때는 어느 namespace에서 어느 payload로 실행할지를 넣어야 함.
-                payload: {},
-                namespace: "/test2",
-                // node-cron에서 쓰는 options를 공유함.
-                options: {
-                    timezone: "Asia/Seoul",
-                    noOverlap: false
-                }
-            }
-        ]
-    };
-}
-(async ()=>{
-    const scheduler = await createScheduler(getConfig());
-    scheduler.on("*", (evt)=>{
-        console.log("Event:", evt);
-    });
-    scheduler.start();
-})();
-
-//# sourceMappingURL=02-local.js.map

package/dist/practices/02-local.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/practices/02-local.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { createScheduler } from \"../scheduler\";\nimport type { TaskContext, SchedulerConfig, TaskEvent } from \"../types\";\n\nfunction getConfig(): SchedulerConfig {\n  const schema = z.object();\n\n  return {\n    database: {\n      client: \"mysql2\",\n      pool: { min: 1, max: 5 },\n      connection: {\n        database: \"miomock\",\n        host: \"0.0.0.0\",\n        port: 3306,\n        user: \"root\",\n        password: \"miomock123\",\n        typeCast: function (field: any, next: any) {\n          if (field.type === \"TINY\" && field.length === 1) {\n            const value = field.string();\n            return value ? value === \"1\" : null;\n          }\n          // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)\n          if (field.type === \"DATE\") {\n            return field.string();\n          }\n          return next();\n        },\n      },\n    },\n    routes: [\n      {\n        path: \"/test\",\n        schema: schema,\n        target: async (ctx: TaskContext<typeof schema>) => {\n          console.log(\"Processed\", ctx);\n        },\n      },\n      {\n        path: \"/test2\",\n        retry: { maxAttempts: 3, delay: { seconds: 1 } },\n        schema: schema,\n        target: async ({ taskItem, retry }: TaskContext<typeof schema>) => {\n          // 마지막 시도에서만 성공하게 함.\n          if (taskItem.attempt !== retry.maxAttempts) {\n            throw new Error(\"실패!\");\n          }\n        },\n      },\n    ],\n\n    retry: {\n      delay: {},\n      maxAttempts: 1,\n    },\n\n    tasks: [\n      {\n        type: \"local\",\n        expression: \"*/10 * * * * *\",\n\n        // local에서 실행할 때는 어느 namespace에서 어느 payload로 실행할지를 넣어야 함.\n        payload: {},\n        namespace: \"/test2\",\n\n        // node-cron에서 쓰는 options를 공유함.\n        options: {\n          timezone: \"Asia/Seoul\",\n          noOverlap: false,\n        },\n      },\n    ],\n  };\n}\n\n(async () => {\n  const scheduler = await createScheduler(getConfig());\n  scheduler.on(\"*\", (evt: TaskEvent) => {\n    console.log(\"Event:\", evt);\n  });\n\n  scheduler.start();\n})();\n"],"names":["z","createScheduler","getConfig","schema","object","database","client","pool","min","max","connection","host","port","user","password","typeCast","field","next","type","length","value","string","routes","path","target","ctx","console","log","retry","maxAttempts","delay","seconds","taskItem","attempt","Error","tasks","expression","payload","namespace","options","timezone","noOverlap","scheduler","on","evt","start"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,kBAAe;AAG/C,SAASC;IACP,MAAMC,SAASH,EAAEI,MAAM;IAEvB,OAAO;QACLC,UAAU;YACRC,QAAQ;YACRC,MAAM;gBAAEC,KAAK;gBAAGC,KAAK;YAAE;YACvBC,YAAY;gBACVL,UAAU;gBACVM,MAAM;gBACNC,MAAM;gBACNC,MAAM;gBACNC,UAAU;gBACVC,UAAU,SAAUC,KAAU,EAAEC,IAAS;oBACvC,IAAID,MAAME,IAAI,KAAK,UAAUF,MAAMG,MAAM,KAAK,GAAG;wBAC/C,MAAMC,QAAQJ,MAAMK,MAAM;wBAC1B,OAAOD,QAAQA,UAAU,MAAM;oBACjC;oBACA,mCAAmC;oBACnC,IAAIJ,MAAME,IAAI,KAAK,QAAQ;wBACzB,OAAOF,MAAMK,MAAM;oBACrB;oBACA,OAAOJ;gBACT;YACF;QACF;QACAK,QAAQ;YACN;gBACEC,MAAM;gBACNpB,QAAQA;gBACRqB,QAAQ,OAAOC;oBACbC,QAAQC,GAAG,CAAC,aAAaF;gBAC3B;YACF;YACA;gBACEF,MAAM;gBACNK,OAAO;oBAAEC,aAAa;oBAAGC,OAAO;wBAAEC,SAAS;oBAAE;gBAAE;gBAC/C5B,QAAQA;gBACRqB,QAAQ,OAAO,EAAEQ,QAAQ,EAAEJ,KAAK,EAA8B;oBAC5D,oBAAoB;oBACpB,IAAII,SAASC,OAAO,KAAKL,MAAMC,WAAW,EAAE;wBAC1C,MAAM,IAAIK,MAAM;oBAClB;gBACF;YACF;SACD;QAEDN,OAAO;YACLE,OAAO,CAAC;YACRD,aAAa;QACf;QAEAM,OAAO;YACL;gBACEjB,MAAM;gBACNkB,YAAY;gBAEZ,yDAAyD;gBACzDC,SAAS,CAAC;gBACVC,WAAW;gBAEX,+BAA+B;gBAC/BC,SAAS;oBACPC,UAAU;oBACVC,WAAW;gBACb;YACF;SACD;IACH;AACF;AAEC,CAAA;IACC,MAAMC,YAAY,MAAMzC,gBAAgBC;IACxCwC,UAAUC,EAAE,CAAC,KAAK,CAACC;QACjBlB,QAAQC,GAAG,CAAC,UAAUiB;IACxB;IAEAF,UAAUG,KAAK;AACjB,CAAA"}

package/dist/practices/03-local-retry.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=03-local-retry.d.ts.map

package/dist/practices/03-local-retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"03-local-retry.d.ts","sourceRoot":"","sources":["../../src/practices/03-local-retry.ts"],"names":[],"mappings":""}

package/dist/practices/03-local-retry.js

@@ -1,85 +0,0 @@
-import { z } from "zod";
-import { createScheduler } from "../scheduler.js";
-function getConfig() {
-    const schema = z.object();
-    return {
-        database: {
-            client: "mysql2",
-            pool: {
-                min: 1,
-                max: 5
-            },
-            connection: {
-                database: "miomock",
-                host: "0.0.0.0",
-                port: 3306,
-                user: "root",
-                password: "miomock123",
-                typeCast: function(field, next) {
-                    if (field.type === "TINY" && field.length === 1) {
-                        const value = field.string();
-                        return value ? value === "1" : null;
-                    }
-                    // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)
-                    if (field.type === "DATE") {
-                        return field.string();
-                    }
-                    return next();
-                }
-            }
-        },
-        routes: [
-            {
-                path: "/test",
-                schema: schema,
-                target: async (ctx)=>{
-                    console.log("Processed", ctx);
-                }
-            },
-            {
-                path: "/test2",
-                retry: {
-                    maxAttempts: 3,
-                    // delay는 함수로 넘겨서 Exponential Backoff 등을 구현할 수 있음.
-                    delay: (attempt)=>{
-                        return {
-                            seconds: Math.pow(3, attempt)
-                        };
-                    }
-                },
-                schema: schema,
-                target: async ({ taskItem, retry })=>{
-                    console.log(`Attempt: ${taskItem.attempt}, Max Attempts: ${retry.maxAttempts}, Time: ${new Date()}`);
-                    // 마지막 시도에서만 성공하게 함.
-                    if (taskItem.attempt !== retry.maxAttempts) {
-                        throw new Error("실패!");
-                    }
-                }
-            }
-        ],
-        retry: {
-            delay: {},
-            maxAttempts: 1
-        },
-        tasks: [
-            {
-                type: "local",
-                expression: "*/10 * * * * *",
-                // local에서 실행할 때는 어느 namespace에서 어느 payload로 실행할지를 넣어야 함.
-                payload: {},
-                namespace: "/test2",
-                // node-cron에서 쓰는 options를 공유함.
-                options: {
-                    timezone: "Asia/Seoul",
-                    noOverlap: false
-                }
-            }
-        ]
-    };
-}
-(async ()=>{
-    const scheduler = await createScheduler(getConfig());
-    scheduler.start();
-})();
-
-//# sourceMappingURL=03-local-retry.js.map

package/dist/practices/03-local-retry.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/practices/03-local-retry.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { createScheduler } from \"../scheduler\";\nimport type { TaskContext, SchedulerConfig } from \"../types\";\n\nfunction getConfig(): SchedulerConfig {\n  const schema = z.object();\n\n  return {\n    database: {\n      client: \"mysql2\",\n      pool: { min: 1, max: 5 },\n      connection: {\n        database: \"miomock\",\n        host: \"0.0.0.0\",\n        port: 3306,\n        user: \"root\",\n        password: \"miomock123\",\n        typeCast: function (field: any, next: any) {\n          if (field.type === \"TINY\" && field.length === 1) {\n            const value = field.string();\n            return value ? value === \"1\" : null;\n          }\n          // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)\n          if (field.type === \"DATE\") {\n            return field.string();\n          }\n          return next();\n        },\n      },\n    },\n    routes: [\n      {\n        path: \"/test\",\n        schema: schema,\n        target: async (ctx: TaskContext<typeof schema>) => {\n          console.log(\"Processed\", ctx);\n        },\n      },\n      {\n        path: \"/test2\",\n        retry: {\n          maxAttempts: 3,\n          // delay는 함수로 넘겨서 Exponential Backoff 등을 구현할 수 있음.\n          delay: (attempt: number) => {\n            return { seconds: Math.pow(3, attempt) };\n          },\n        },\n        schema: schema,\n        target: async ({ taskItem, retry }: TaskContext<typeof schema>) => {\n          console.log(\n            `Attempt: ${taskItem.attempt}, Max Attempts: ${retry.maxAttempts}, Time: ${new Date()}`,\n          );\n\n          // 마지막 시도에서만 성공하게 함.\n          if (taskItem.attempt !== retry.maxAttempts) {\n            throw new Error(\"실패!\");\n          }\n        },\n      },\n    ],\n\n    retry: {\n      delay: {},\n      maxAttempts: 1,\n    },\n\n    tasks: [\n      {\n        type: \"local\",\n        expression: \"*/10 * * * * *\",\n\n        // local에서 실행할 때는 어느 namespace에서 어느 payload로 실행할지를 넣어야 함.\n        payload: {},\n        namespace: \"/test2\",\n\n        // node-cron에서 쓰는 options를 공유함.\n        options: {\n          timezone: \"Asia/Seoul\",\n          noOverlap: false,\n        },\n      },\n    ],\n  };\n}\n\n(async () => {\n  const scheduler = await createScheduler(getConfig());\n  scheduler.start();\n})();\n"],"names":["z","createScheduler","getConfig","schema","object","database","client","pool","min","max","connection","host","port","user","password","typeCast","field","next","type","length","value","string","routes","path","target","ctx","console","log","retry","maxAttempts","delay","attempt","seconds","Math","pow","taskItem","Date","Error","tasks","expression","payload","namespace","options","timezone","noOverlap","scheduler","start"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,kBAAe;AAG/C,SAASC;IACP,MAAMC,SAASH,EAAEI,MAAM;IAEvB,OAAO;QACLC,UAAU;YACRC,QAAQ;YACRC,MAAM;gBAAEC,KAAK;gBAAGC,KAAK;YAAE;YACvBC,YAAY;gBACVL,UAAU;gBACVM,MAAM;gBACNC,MAAM;gBACNC,MAAM;gBACNC,UAAU;gBACVC,UAAU,SAAUC,KAAU,EAAEC,IAAS;oBACvC,IAAID,MAAME,IAAI,KAAK,UAAUF,MAAMG,MAAM,KAAK,GAAG;wBAC/C,MAAMC,QAAQJ,MAAMK,MAAM;wBAC1B,OAAOD,QAAQA,UAAU,MAAM;oBACjC;oBACA,mCAAmC;oBACnC,IAAIJ,MAAME,IAAI,KAAK,QAAQ;wBACzB,OAAOF,MAAMK,MAAM;oBACrB;oBACA,OAAOJ;gBACT;YACF;QACF;QACAK,QAAQ;YACN;gBACEC,MAAM;gBACNpB,QAAQA;gBACRqB,QAAQ,OAAOC;oBACbC,QAAQC,GAAG,CAAC,aAAaF;gBAC3B;YACF;YACA;gBACEF,MAAM;gBACNK,OAAO;oBACLC,aAAa;oBACb,kDAAkD;oBAClDC,OAAO,CAACC;wBACN,OAAO;4BAAEC,SAASC,KAAKC,GAAG,CAAC,GAAGH;wBAAS;oBACzC;gBACF;gBACA5B,QAAQA;gBACRqB,QAAQ,OAAO,EAAEW,QAAQ,EAAEP,KAAK,EAA8B;oBAC5DF,QAAQC,GAAG,CACT,CAAC,SAAS,EAAEQ,SAASJ,OAAO,CAAC,gBAAgB,EAAEH,MAAMC,WAAW,CAAC,QAAQ,EAAE,IAAIO,QAAQ;oBAGzF,oBAAoB;oBACpB,IAAID,SAASJ,OAAO,KAAKH,MAAMC,WAAW,EAAE;wBAC1C,MAAM,IAAIQ,MAAM;oBAClB;gBACF;YACF;SACD;QAEDT,OAAO;YACLE,OAAO,CAAC;YACRD,aAAa;QACf;QAEAS,OAAO;YACL;gBACEpB,MAAM;gBACNqB,YAAY;gBAEZ,yDAAyD;gBACzDC,SAAS,CAAC;gBACVC,WAAW;gBAEX,+BAA+B;gBAC/BC,SAAS;oBACPC,UAAU;oBACVC,WAAW;gBACb;YACF;SACD;IACH;AACF;AAEC,CAAA;IACC,MAAMC,YAAY,MAAM5C,gBAAgBC;IACxC2C,UAAUC,KAAK;AACjB,CAAA"}

package/dist/practices/04-scheduler-dispose.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=04-scheduler-dispose.d.ts.map

package/dist/practices/04-scheduler-dispose.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"04-scheduler-dispose.d.ts","sourceRoot":"","sources":["../../src/practices/04-scheduler-dispose.ts"],"names":[],"mappings":""}

package/dist/practices/04-scheduler-dispose.js

@@ -1,65 +0,0 @@
-import { z } from "zod";
-import { createScheduler } from "../scheduler.js";
-function getConfig() {
-    const schema = z.object();
-    return {
-        database: {
-            client: "mysql2",
-            pool: {
-                min: 1,
-                max: 5
-            },
-            connection: {
-                database: "miomock",
-                host: "0.0.0.0",
-                port: 3306,
-                user: "root",
-                password: "miomock123",
-                typeCast: function(field, next) {
-                    if (field.type === "TINY" && field.length === 1) {
-                        const value = field.string();
-                        return value ? value === "1" : null;
-                    }
-                    // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)
-                    if (field.type === "DATE") {
-                        return field.string();
-                    }
-                    return next();
-                }
-            }
-        },
-        routes: [
-            {
-                path: "/test",
-                schema: schema,
-                target: async (ctx)=>{
-                    console.log("Processed", ctx);
-                }
-            }
-        ],
-        retry: {
-            delay: {},
-            maxAttempts: 1
-        },
-        tasks: [
-            {
-                type: "remote",
-                expression: "5 * * * *",
-                options: {
-                    timezone: "Asia/Seoul",
-                    noOverlap: false
-                }
-            }
-        ]
-    };
-}
-// scheduler를 dispose하면 대기 중인 Promise가 없기 때문에 프로그램은 1분 뒤에 바로 종료된다.
-(async ()=>{
-    const scheduler = await createScheduler(getConfig());
-    setTimeout(()=>{
-        scheduler.dispose();
-    }, 60 * 1000);
-    scheduler.start();
-})();
-
-//# sourceMappingURL=04-scheduler-dispose.js.map

package/dist/practices/04-scheduler-dispose.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/practices/04-scheduler-dispose.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { createScheduler } from \"../scheduler\";\nimport type { TaskContext, SchedulerConfig } from \"../types\";\n\nfunction getConfig(): SchedulerConfig {\n  const schema = z.object();\n\n  return {\n    database: {\n      client: \"mysql2\",\n      pool: { min: 1, max: 5 },\n      connection: {\n        database: \"miomock\",\n        host: \"0.0.0.0\",\n        port: 3306,\n        user: \"root\",\n        password: \"miomock123\",\n        typeCast: function (field: any, next: any) {\n          if (field.type === \"TINY\" && field.length === 1) {\n            const value = field.string();\n            return value ? value === \"1\" : null;\n          }\n          // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)\n          if (field.type === \"DATE\") {\n            return field.string();\n          }\n          return next();\n        },\n      },\n    },\n    routes: [\n      {\n        path: \"/test\",\n        schema: schema,\n        target: async (ctx: TaskContext<typeof schema>) => {\n          console.log(\"Processed\", ctx);\n        },\n      },\n    ],\n\n    retry: {\n      delay: {},\n      maxAttempts: 1,\n    },\n\n    tasks: [\n      {\n        type: \"remote\",\n        expression: \"5 * * * *\",\n        options: {\n          timezone: \"Asia/Seoul\",\n          noOverlap: false,\n        },\n      },\n    ],\n  };\n}\n// scheduler를 dispose하면 대기 중인 Promise가 없기 때문에 프로그램은 1분 뒤에 바로 종료된다.\n(async () => {\n  const scheduler = await createScheduler(getConfig());\n  setTimeout(() => {\n    scheduler.dispose();\n  }, 60 * 1000);\n\n  scheduler.start();\n})();\n"],"names":["z","createScheduler","getConfig","schema","object","database","client","pool","min","max","connection","host","port","user","password","typeCast","field","next","type","length","value","string","routes","path","target","ctx","console","log","retry","delay","maxAttempts","tasks","expression","options","timezone","noOverlap","scheduler","setTimeout","dispose","start"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,kBAAe;AAG/C,SAASC;IACP,MAAMC,SAASH,EAAEI,MAAM;IAEvB,OAAO;QACLC,UAAU;YACRC,QAAQ;YACRC,MAAM;gBAAEC,KAAK;gBAAGC,KAAK;YAAE;YACvBC,YAAY;gBACVL,UAAU;gBACVM,MAAM;gBACNC,MAAM;gBACNC,MAAM;gBACNC,UAAU;gBACVC,UAAU,SAAUC,KAAU,EAAEC,IAAS;oBACvC,IAAID,MAAME,IAAI,KAAK,UAAUF,MAAMG,MAAM,KAAK,GAAG;wBAC/C,MAAMC,QAAQJ,MAAMK,MAAM;wBAC1B,OAAOD,QAAQA,UAAU,MAAM;oBACjC;oBACA,mCAAmC;oBACnC,IAAIJ,MAAME,IAAI,KAAK,QAAQ;wBACzB,OAAOF,MAAMK,MAAM;oBACrB;oBACA,OAAOJ;gBACT;YACF;QACF;QACAK,QAAQ;YACN;gBACEC,MAAM;gBACNpB,QAAQA;gBACRqB,QAAQ,OAAOC;oBACbC,QAAQC,GAAG,CAAC,aAAaF;gBAC3B;YACF;SACD;QAEDG,OAAO;YACLC,OAAO,CAAC;YACRC,aAAa;QACf;QAEAC,OAAO;YACL;gBACEb,MAAM;gBACNc,YAAY;gBACZC,SAAS;oBACPC,UAAU;oBACVC,WAAW;gBACb;YACF;SACD;IACH;AACF;AACA,kEAAkE;AACjE,CAAA;IACC,MAAMC,YAAY,MAAMnC,gBAAgBC;IACxCmC,WAAW;QACTD,UAAUE,OAAO;IACnB,GAAG,KAAK;IAERF,UAAUG,KAAK;AACjB,CAAA"}

package/dist/practices/05-router.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=05-router.d.ts.map

package/dist/practices/05-router.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"05-router.d.ts","sourceRoot":"","sources":["../../src/practices/05-router.ts"],"names":[],"mappings":""}

package/dist/practices/05-router.js

@@ -1,80 +0,0 @@
-import { z } from "zod";
-import { createScheduler } from "../scheduler.js";
-function getConfig() {
-    const schema = z.object();
-    return {
-        database: {
-            client: "mysql2",
-            pool: {
-                min: 1,
-                max: 5
-            },
-            connection: {
-                database: "miomock",
-                host: "0.0.0.0",
-                port: 3306,
-                user: "root",
-                password: "miomock123",
-                typeCast: function(field, next) {
-                    if (field.type === "TINY" && field.length === 1) {
-                        const value = field.string();
-                        return value ? value === "1" : null;
-                    }
-                    // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)
-                    if (field.type === "DATE") {
-                        return field.string();
-                    }
-                    return next();
-                }
-            }
-        },
-        routes: [
-            {
-                path: "/test",
-                schema: schema,
-                target: async (ctx)=>{
-                    console.log("Processed", ctx);
-                }
-            },
-            {
-                // rou3을 쓰기 때문에, task의 path는 HTTP Router 문법에 대응됨.
-                path: "/test/:complexId",
-                retry: {
-                    maxAttempts: 3,
-                    delay: {
-                        seconds: 1
-                    }
-                },
-                schema: schema,
-                target: async ({ params })=>{
-                    // router를 통해 complexId가 전달됨.
-                    console.log(params?.complexId);
-                }
-            }
-        ],
-        retry: {
-            delay: {},
-            maxAttempts: 1
-        },
-        tasks: [
-            {
-                type: "local",
-                expression: "*/10 * * * * *",
-                // rou3을 쓰기 때문에, task의 path는 HTTP Router 문법에 대응됨.
-                namespace: "/test/some-complex-data",
-                payload: {},
-                options: {
-                    timezone: "Asia/Seoul",
-                    name: "local-router-test",
-                    noOverlap: false
-                }
-            }
-        ]
-    };
-}
-(async ()=>{
-    const scheduler = await createScheduler(getConfig());
-    scheduler.start();
-})();
-
-//# sourceMappingURL=05-router.js.map

package/dist/practices/05-router.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/practices/05-router.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { createScheduler } from \"../scheduler\";\nimport type { TaskContext, SchedulerConfig } from \"../types\";\n\nfunction getConfig(): SchedulerConfig {\n  const schema = z.object();\n\n  return {\n    database: {\n      client: \"mysql2\",\n      pool: { min: 1, max: 5 },\n      connection: {\n        database: \"miomock\",\n        host: \"0.0.0.0\",\n        port: 3306,\n        user: \"root\",\n        password: \"miomock123\",\n        typeCast: function (field: any, next: any) {\n          if (field.type === \"TINY\" && field.length === 1) {\n            const value = field.string();\n            return value ? value === \"1\" : null;\n          }\n          // DATE 타입은 문자열로 유지 (YYYY-MM-dd 형태)\n          if (field.type === \"DATE\") {\n            return field.string();\n          }\n          return next();\n        },\n      },\n    },\n    routes: [\n      {\n        path: \"/test\",\n        schema: schema,\n        target: async (ctx: TaskContext<typeof schema>) => {\n          console.log(\"Processed\", ctx);\n        },\n      },\n      {\n        // rou3을 쓰기 때문에, task의 path는 HTTP Router 문법에 대응됨.\n        path: \"/test/:complexId\",\n        retry: { maxAttempts: 3, delay: { seconds: 1 } },\n        schema: schema,\n        target: async ({ params }: TaskContext<typeof schema>) => {\n          // router를 통해 complexId가 전달됨.\n          console.log(params?.complexId);\n        },\n      },\n    ],\n\n    retry: {\n      delay: {},\n      maxAttempts: 1,\n    },\n\n    tasks: [\n      {\n        type: \"local\",\n        expression: \"*/10 * * * * *\",\n        // rou3을 쓰기 때문에, task의 path는 HTTP Router 문법에 대응됨.\n        namespace: \"/test/some-complex-data\",\n        payload: {},\n        options: {\n          timezone: \"Asia/Seoul\",\n          name: \"local-router-test\",\n          noOverlap: false,\n        },\n      },\n    ],\n  };\n}\n\n(async () => {\n  const scheduler = await createScheduler(getConfig());\n  scheduler.start();\n})();\n"],"names":["z","createScheduler","getConfig","schema","object","database","client","pool","min","max","connection","host","port","user","password","typeCast","field","next","type","length","value","string","routes","path","target","ctx","console","log","retry","maxAttempts","delay","seconds","params","complexId","tasks","expression","namespace","payload","options","timezone","name","noOverlap","scheduler","start"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,QAAQ,kBAAe;AAG/C,SAASC;IACP,MAAMC,SAASH,EAAEI,MAAM;IAEvB,OAAO;QACLC,UAAU;YACRC,QAAQ;YACRC,MAAM;gBAAEC,KAAK;gBAAGC,KAAK;YAAE;YACvBC,YAAY;gBACVL,UAAU;gBACVM,MAAM;gBACNC,MAAM;gBACNC,MAAM;gBACNC,UAAU;gBACVC,UAAU,SAAUC,KAAU,EAAEC,IAAS;oBACvC,IAAID,MAAME,IAAI,KAAK,UAAUF,MAAMG,MAAM,KAAK,GAAG;wBAC/C,MAAMC,QAAQJ,MAAMK,MAAM;wBAC1B,OAAOD,QAAQA,UAAU,MAAM;oBACjC;oBACA,mCAAmC;oBACnC,IAAIJ,MAAME,IAAI,KAAK,QAAQ;wBACzB,OAAOF,MAAMK,MAAM;oBACrB;oBACA,OAAOJ;gBACT;YACF;QACF;QACAK,QAAQ;YACN;gBACEC,MAAM;gBACNpB,QAAQA;gBACRqB,QAAQ,OAAOC;oBACbC,QAAQC,GAAG,CAAC,aAAaF;gBAC3B;YACF;YACA;gBACE,iDAAiD;gBACjDF,MAAM;gBACNK,OAAO;oBAAEC,aAAa;oBAAGC,OAAO;wBAAEC,SAAS;oBAAE;gBAAE;gBAC/C5B,QAAQA;gBACRqB,QAAQ,OAAO,EAAEQ,MAAM,EAA8B;oBACnD,6BAA6B;oBAC7BN,QAAQC,GAAG,CAACK,QAAQC;gBACtB;YACF;SACD;QAEDL,OAAO;YACLE,OAAO,CAAC;YACRD,aAAa;QACf;QAEAK,OAAO;YACL;gBACEhB,MAAM;gBACNiB,YAAY;gBACZ,iDAAiD;gBACjDC,WAAW;gBACXC,SAAS,CAAC;gBACVC,SAAS;oBACPC,UAAU;oBACVC,MAAM;oBACNC,WAAW;gBACb;YACF;SACD;IACH;AACF;AAEC,CAAA;IACC,MAAMC,YAAY,MAAMzC,gBAAgBC;IACxCwC,UAAUC,KAAK;AACjB,CAAA"}

package/dist/scheduler.d.ts

@@ -1,22 +0,0 @@
-import { type Knex } from "knex";
-import { type RouterContext } from "rou3";
-import { type EventType, type LocalTaskConfig, type SchedulerInfo, type OnEventFunction, type RemoteTaskConfig, type Resolvable, type RetryConfig, type SchedulerConfig, type TaskRouterContext } from "./types";
-export declare class SonamuScheduler {
-    #private;
-    readonly info: SchedulerInfo;
-    constructor(knex: Knex, router: RouterContext<TaskRouterContext & {
-        info: SchedulerInfo;
-    }>, info: SchedulerInfo, retry?: RetryConfig);
-    [Symbol.asyncDispose](): Promise<void>;
-    addRoute(...routes: (Omit<TaskRouterContext, "retry"> & {
-        retry?: RetryConfig;
-    })[]): void;
-    addTask(...tasks: (RemoteTaskConfig | LocalTaskConfig)[]): void;
-    start(): void;
-    stop(): void;
-    dispose(): Promise<void>;
-    on(name: EventType | "*", fn: OnEventFunction): void;
-    off(name: EventType | "*", fn: OnEventFunction): void;
-}
-export declare function createScheduler(input: Resolvable<SchedulerConfig>): Promise<SonamuScheduler>;
-//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AACA,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,MAAM,CAAC;AAGlE,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,WAAW,EAEhB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAGjB,qBAAa,eAAe;;IAQ1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAG3B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,aAAa,CAAC,iBAAiB,GAAG;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC,EAClE,IAAI,EAAE,aAAa,EACnB,KAAK,CAAC,EAAE,WAAW;IAWf,CAAC,MAAM,CAAC,YAAY,CAAC;IAI3B,QAAQ,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,EAAE;IAclF,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC,gBAAgB,GAAG,eAAe,CAAC,EAAE;IA2BxD,KAAK;IASL,IAAI;IASE,OAAO;IAcb,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,EAAE,EAAE,eAAe;IAM7C,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,EAAE,EAAE,eAAe;CAW/C;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC,CAY1B"}