serial-task 1.0.1 → 1.2.0

package/README.md

@@ -21,6 +21,7 @@ pnpm add serial-task
 ## 🎯 Quick Start
 
 > Note: For async functions(tasks/resultWrapper/conditions), use `createSerialTaskAsync` instead.
+> Note: Relies on native `Promise.try` for async tasks, which is currently only supported in Node.js 20+ and modern browsers. For older environments, consider using a polyfill or transpiler that supports this feature.
 
 ```typescript
 import { createSerialTask } from 'serial-task';
@@ -62,8 +63,7 @@ Creates a sync/async serial task function.
   - **skipCondition?**: `function` - Function that determines when to skip a task (default: `() => false`)
   - **resultWrapper?**: `function` - Function that transforms input between tasks, default(means the first task gets original args, subsequent tasks get the last return value):
   ```ts
-  (_task: Fn, index: number, _tasks: Fn[], args: unknown[], lastReturn: unknown) =>
-    index === 0 ? args : [lastReturn];
+  (_task: Fn, index: number, _tasks: Fn[], args: unknown[], lastReturn: unknown) => (index === 0 ? args : [lastReturn]);
   ```
 
 #### Returns
@@ -312,6 +312,7 @@ const dynamicTask = createSerialTask({
 ## 🔄 Async Support
 
 For async functions, use `createSerialTaskAsync`:
+`createSerialTaskAsync` uses native `Promise.try`.
 
 ```typescript
 import { createSerialTaskAsync } from 'serial-task';

package/dist/index.d.ts

@@ -1,55 +1,3 @@
-/**
- * ## Usage
- * Use this when you have async functions in tasks, conditions or result wrapper
- *
- * Creates an async serial task function that executes a series of functions in order
- * - all given functions(`options.tasks`) will be called in order
- * - generated task function will have the same length as the first task function
- * - you can appoint generated task function's name by `options.name`
- * - **Strongly Recommended**: all task functions have same input type and output type
- *   - returned function.length will be the same as the first task function's length
- * @param opts Options for creating a serial task, details in `SerialTaskOptions`
- * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
- *
- * ## About
- * @package SerialTask
- * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 1.0.0 (Last Update: 2025.08.22 17:05:02.346)
- * @license MIT
- * @link https://github.com/baendlorel/serial-task
- * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
- * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
- */
-declare function createSerialTaskAsync<F extends Fn>(opts: SerialTaskOptions<F>): TaskifyAsync<F>;
-
-/**
- * ## Usage
- * **DO NOT Use** this when you have **async functions** in tasks, conditions or result wrapper
- *
- * Creates a serial task function that executes a series of functions in order.
- * - all given functions(`options.tasks`) will be called in order
- *   - the returned value will be `options.resultWrapper`ed then passed to the next task
- * - generated task function will have the same length as the first task function
- * - you can appoint generated task function's name by `options.name`
- * - **Strongly Recommended**: all task functions have same input type and output type
- *   - returned function.length will be the same as the first task function's length
- * @param opts Options for creating a serial task, details in `SerialTaskOptions`
- * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
- *
- * ## About
- * @package SerialTask
- * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 1.0.0 (Last Update: 2025.08.22 17:05:02.346)
- * @license MIT
- * @link https://github.com/baendlorel/serial-task
- * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
- * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
- */
-declare function createSerialTask<F extends Fn>(opts: SerialTaskOptions<F>): Taskify<F>;
-
-export { createSerialTask, createSerialTaskAsync };
-
-// # from: src/global.d.ts
 /* eslint-disable @typescript-eslint/no-explicit-any */
 type Fn = (...args: any[]) => any;
 
@@ -134,13 +82,7 @@ interface SerialTaskOptions<F extends Fn> {
    * }
    * ```
    */
-  resultWrapper?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => unknown[];
+  resultWrapper?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => unknown[];
 
   /**
    * Break the loop and return the last result immediately when this function returns `true`
@@ -153,13 +95,7 @@ interface SerialTaskOptions<F extends Fn> {
    * @param args input value of the whole serial task
    * @param lastReturn returned value of the last task function
    */
-  breakCondition?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => boolean;
+  breakCondition?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => boolean;
 
   /**
    * Give `true` to skip this task item
@@ -172,13 +108,59 @@ interface SerialTaskOptions<F extends Fn> {
    * @param args input value of the whole serial task
    * @param lastReturn returned value of the last task function
    */
-  skipCondition?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => boolean;
+  skipCondition?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => boolean;
 }
 
-type StrictSerialTaskOptions<F extends Fn> = Required<SerialTaskOptions<F>>;
+/**
+ * ## Usage
+ * Use this when you have async functions in tasks, conditions or result wrapper
+ *
+ * Creates an async serial task function that executes a series of functions in order
+ * - all given functions(`options.tasks`) will be called in order
+ * - generated task function will have the same length as the first task function
+ * - you can appoint generated task function's name by `options.name`
+ * - **Strongly Recommended**: all task functions have same input type and output type
+ *   - returned function.length will be the same as the first task function's length
+ * @param opts Options for creating a serial task, details in `SerialTaskOptions`
+ * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
+ *
+ * ## About
+ * @package SerialTask
+ * @author Kasukabe Tsumugi <futami16237@gmail.com>
+ * @version 1.2.0 (Last Update: 2026.02.13 16:27:40.250)
+ * @license MIT
+ * @link https://github.com/baendlorel/serial-task
+ * @link https://baendlorel.github.io/ Welcome to my site!
+ * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
+ * @copyright Copyright (c) 2026 Kasukabe Tsumugi. All rights reserved.
+ */
+declare function createSerialTaskAsync<F extends Fn>(opts: SerialTaskOptions<F>): TaskifyAsync<F>;
+
+/**
+ * ## Usage
+ * **DO NOT Use** this when you have **async functions** in tasks, conditions or result wrapper
+ *
+ * Creates a serial task function that executes a series of functions in order.
+ * - all given functions(`options.tasks`) will be called in order
+ *   - the returned value will be `options.resultWrapper`ed then passed to the next task
+ * - generated task function will have the same length as the first task function
+ * - you can appoint generated task function's name by `options.name`
+ * - **Strongly Recommended**: all task functions have same input type and output type
+ *   - returned function.length will be the same as the first task function's length
+ * @param opts Options for creating a serial task, details in `SerialTaskOptions`
+ * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
+ *
+ * ## About
+ * @package SerialTask
+ * @author Kasukabe Tsumugi <futami16237@gmail.com>
+ * @version 1.2.0 (Last Update: 2026.02.13 16:27:40.250)
+ * @license MIT
+ * @link https://github.com/baendlorel/serial-task
+ * @link https://baendlorel.github.io/ Welcome to my site!
+ * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
+ * @copyright Copyright (c) 2026 Kasukabe Tsumugi. All rights reserved.
+ */
+declare function createSerialTask<F extends Fn>(opts: SerialTaskOptions<F>): Taskify<F>;
+
+export { createSerialTask, createSerialTaskAsync };
+export type { SerialTaskOptions, TaskReturn, Taskify, TaskifyAsync };

package/dist/index.mjs

@@ -1 +1 @@
-const t=Reflect.defineProperty,e=Array.isArray,n=Promise.resolve.bind(Promise),r=Promise.reject.bind(Promise),o=t=>("object"==typeof t&&null!==t||"function"==typeof t)&&("then"in t&&"function"==typeof t.then),i=()=>!1,a=i,s=(t,e,n,r,o)=>0===e?r:[o];function u(t){if("object"!=typeof t||null===t)throw new TypeError("SerialTask: 'options' must be an object");const{name:n="kskbTask",tasks:r,breakCondition:o=i,skipCondition:u=a,resultWrapper:l=s}=t;if("string"!=typeof n)throw new TypeError("SerialTask: 'name' must be a string or omitted");if(!e(r)||r.some(t=>"function"!=typeof t))throw new TypeError("SerialTask: 'tasks' must be a function array");if("function"!=typeof o)throw new TypeError("SerialTask: 'breakCondition' must be a function or omitted");if("function"!=typeof u)throw new TypeError("SerialTask: 'skipCondition' must be a function or omitted");if("function"!=typeof l)throw new TypeError("SerialTask: 'resultWrapper' must be a function or omitted");return{name:n,tasks:r,breakCondition:o,skipCondition:u,resultWrapper:l}}function l(t,e,...i){try{const r=t.apply(e,i);return o(r)?r:n(r)}catch(t){return r(t)}}function c(t,e,i){try{const r=t.apply(e,i);return o(r)?r:n(r)}catch(t){return r(t)}}function f(e){const{name:n,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(e);if(0===r.length){const e=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(e,"name",{value:n,configurable:!0}),e}const s=async function(...t){let e;const n=new Array(r.length);let s=-1;const u=[];for(let f=0;f<r.length;f++){const p=r[f],k=await l(a,null,p,f,r,t,e);if(await l(o,null,p,f,r,t,e)){s=f;break}await l(i,null,p,f,r,t,e)?u.push(f):(e=await c(p,null,k),n[f]=e)}return{value:e,results:n,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:n,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s}function p(e){const{name:n,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(e);if(0===r.length){const e=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(e,"name",{value:n,configurable:!0}),e}const s=function(...t){let e;const n=new Array(r.length);let s=-1;const u=[];for(let l=0;l<r.length;l++){const c=r[l],f=a(c,l,r,t,e);if(o(c,l,r,t,e)){s=l;break}i(c,l,r,t,e)?u.push(l):(e=c.apply(null,f),n[l]=e)}return{value:e,results:n,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:n,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s}export{p as createSerialTask,f as createSerialTaskAsync};
+const e=Reflect.defineProperty,t=Array.isArray,r=()=>!1,n=r,o=(e,t,r,n,o)=>0===t?n:[o];function i(e){if("object"!=typeof e||null===e)throw new TypeError("[SerialTask] 'options' must be an object");const{name:i="",tasks:a,breakCondition:s=r,skipCondition:u=n,resultWrapper:l=o}=e;if("string"!=typeof i)throw new TypeError("[SerialTask] 'name' must be a string or omitted");if(!t(a)||a.some(e=>"function"!=typeof e))throw new TypeError("[SerialTask] 'tasks' must be a function array");if("function"!=typeof s)throw new TypeError("[SerialTask] 'breakCondition' must be a function or omitted");if("function"!=typeof u)throw new TypeError("[SerialTask] 'skipCondition' must be a function or omitted");if("function"!=typeof l)throw new TypeError("[SerialTask] 'resultWrapper' must be a function or omitted");return{name:i,tasks:a,breakCondition:s,skipCondition:u,resultWrapper:l}}function a(t){const{name:r,tasks:n,breakCondition:o,skipCondition:a,resultWrapper:s}=i(t);if(0===n.length){const t=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return e(t,"name",{value:r,configurable:!0}),t}const u=async function(...e){let t;const r=new Array(n.length);let i=-1;const u=[];for(let l=0;l<n.length;l++){const f=n[l],c=await Promise.try(s,f,l,n,e,t);if(await Promise.try(o,f,l,n,e,t)){i=l;break}await Promise.try(a,f,l,n,e,t)?u.push(l):(t=await Promise.try(f,...c),r[l]=t)}return{value:t,results:r,trivial:!1,breakAt:i,skipped:u}};return r&&e(u,"name",{value:r,configurable:!0}),e(u,"length",{value:n[0].length,configurable:!0}),u}function s(t){const{name:r,tasks:n,breakCondition:o,skipCondition:a,resultWrapper:s}=i(t);if(0===n.length){const t=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return e(t,"name",{value:r,configurable:!0}),t}const u=function(...e){let t;const r=new Array(n.length);let i=-1;const u=[];for(let l=0;l<n.length;l++){const f=n[l],c=s(f,l,n,e,t);if(o(f,l,n,e,t)){i=l;break}a(f,l,n,e,t)?u.push(l):(t=f.apply(null,c),r[l]=t)}return{value:t,results:r,trivial:!1,breakAt:i,skipped:u}};return r&&e(u,"name",{value:r,configurable:!0}),e(u,"length",{value:n[0].length,configurable:!0}),u}export{s as createSerialTask,a as createSerialTaskAsync};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "serial-task",
-	"version": "1.0.1",
+	"version": "1.2.0",
 	"author": {
 		"name": "Kasukabe Tsumugi",
 		"email": "futami16237@gmail.com"
@@ -29,32 +29,12 @@
 		"javascript"
 	],
 	"scripts": {
+		"lines": "clear && find ./src -type f \\( -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.mjs\" -o -name \"*.cjs\" -o -name \"*.cpp\" -o -name \"*.h\" -o -name \"*.py\"  -o -name \"*.css\" -o -name \"*.rs\" -o -name \"*.rc\" \\) | xargs wc -l",
 		"test": "clear & vitest",
 		"lint": "oxlint .",
 		"cover": "clear & vitest --coverage",
-		"build": "node ./scripts/rollup.mjs"
+		"build": "tsx ./.scripts/rollup.ts"
 	},
 	"license": "MIT",
-	"devDependencies": {
-		"@babel/plugin-proposal-decorators": "^7.28.0",
-		"@babel/preset-env": "^7.28.3",
-		"@rollup/plugin-alias": "^5.1.1",
-		"@rollup/plugin-babel": "^6.0.4",
-		"@rollup/plugin-commonjs": "^28.0.6",
-		"@rollup/plugin-node-resolve": "^16.0.1",
-		"@rollup/plugin-replace": "^6.0.2",
-		"@rollup/plugin-terser": "^0.4.4",
-		"@rollup/plugin-typescript": "^12.1.4",
-		"@types/node": "^24.3.0",
-		"@vitest/coverage-v8": "^3.2.4",
-		"oxlint": "^1.12.0",
-		"prettier": "^3.6.2",
-		"rimraf": "^6.0.1",
-		"rollup": "^4.47.1",
-		"rollup-plugin-dts": "^6.2.3",
-		"rollup-plugin-dts-merger": "^1.2.3",
-		"tslib": "^2.8.1",
-		"typescript": "^5.9.2",
-		"vitest": "^3.2.4"
-	}
+	"devDependencies": {}
 }