nfkit 1.0.1

package/.eslintignore

@@ -0,0 +1,4 @@
+webpack.config.js
+dist/*
+build/*
+*.js

package/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir : __dirname, 
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+  },
+};

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Nanahira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,3 @@
+# nfkit
+
+Common kits

package/dist/index.cjs

@@ -0,0 +1,121 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  WF_NODE: () => WF_NODE,
+  workflow: () => workflow
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/workflow.ts
+var Node = class _Node {
+  constructor(source, parent, op) {
+    this.source = source;
+    this.parent = parent;
+    this.op = op;
+  }
+  run() {
+    if (!this.memo) {
+      this.memo = (async () => {
+        if (!this.parent) {
+          return await this.source;
+        }
+        const base = await this.parent.run();
+        return this.op ? this.op(base) : base;
+      })();
+    }
+    return this.memo;
+  }
+  // 工厂：衍生子节点（分叉 = 复用同一个 parent）
+  child(op) {
+    return new _Node(this.source, this, op);
+  }
+  // 拿到“相同节点”的句柄（显式 fork）
+  fork() {
+    return new _Node(this.source, this.parent, this.op);
+  }
+};
+var WF_NODE = Symbol("@@workflow/node");
+function isWorkflowChain(x) {
+  return !!x && typeof x === "function" && x[WF_NODE] instanceof Node;
+}
+function workflow(source) {
+  if (isWorkflowChain(source)) {
+    return source;
+  }
+  const root = new Node(source, null, null);
+  return makeProxy(root);
+}
+function makeProxy(node) {
+  const runOnce = () => node.run();
+  const rootHandler = {
+    get(_t, prop) {
+      if (prop === WF_NODE) return node;
+      if (prop === "then")
+        return (res, rej) => runOnce().then(res, rej);
+      if (prop === "catch") return (rej) => runOnce().catch(rej);
+      if (prop === "finally") return (fin) => runOnce().finally(fin);
+      return linkProxy(prop);
+    },
+    // 支持对“当前值”直接二次调用： foo()()
+    apply(_t, _this, argArray) {
+      const child = node.child((cur) => {
+        if (typeof cur !== "function")
+          throw new TypeError("Current value is not callable");
+        return cur(...argArray);
+      });
+      return makeProxy(child);
+    }
+  };
+  const linkProxy = (prop) => new Proxy(function() {
+  }, {
+    // 把 “.foo(…args)” 记录为 Call
+    apply(_t, _this, argArray) {
+      const child = node.child((cur) => {
+        const fn = cur[prop];
+        if (typeof fn !== "function") {
+          throw new TypeError(`${String(prop)} is not a function`);
+        }
+        return fn.apply(cur, argArray);
+      });
+      return makeProxy(child);
+    },
+    // 把 “.bar” 记录为 Get；继续深入时在这个 Get 的结果上再处理
+    get(_t, next) {
+      if (next === WF_NODE) return node;
+      if (next === "then")
+        return (r, j) => node.child((cur) => cur[prop]).run().then(r, j);
+      if (next === "catch")
+        return (rej) => node.child((cur) => cur[prop]).run().catch(rej);
+      if (next === "finally")
+        return (fin) => node.child((cur) => cur[prop]).run().finally(fin);
+      const child = node.child((cur) => cur[prop]);
+      return makeProxy(child)[next];
+    }
+  });
+  return new Proxy(function() {
+  }, rootHandler);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WF_NODE,
+  workflow
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../index.ts", "../src/workflow.ts"],
+  "sourcesContent": ["export * from './src/workflow';\n", "// ========== \u7C7B\u578B\u5DE5\u5177 ==========\ntype AwaitedLike<T> = T extends Promise<infer R> ? R : T;\ntype AnyFn = (...args: any[]) => any;\n\ntype Chain<T> = Promise<AwaitedLike<T>> &\n  (T extends AnyFn\n    ? (...a: Parameters<T>) => Chain<AwaitedLike<ReturnType<T>>>\n    : {}) & {\n    [K in keyof T]: T[K] extends (...a: infer A) => infer R\n      ? (...a: A) => Chain<AwaitedLike<R>>\n      : Chain<AwaitedLike<T[K]>>;\n  };\n\n// ========== \u6838\u5FC3\uFF1A\u4E0D\u53EF\u53D8\u8282\u70B9 ==========\nclass Node {\n  private memo?: Promise<any>;\n  constructor(\n    private readonly source: any, // \u53EA\u6709\u6839\u8282\u70B9\u6709\u610F\u4E49\uFF1B\u5B50\u8282\u70B9\u53EF\u590D\u7528\u6839\u7684 source\n    private readonly parent: Node | null, // \u524D\u7F00\n    private readonly op: ((x: any) => any) | null, // \u4ECE parent \u7ED3\u679C\u5230\u672C\u8282\u70B9\u7ED3\u679C\u7684\u53D8\u6362\n  ) {}\n\n  run(): Promise<any> {\n    if (!this.memo) {\n      this.memo = (async () => {\n        if (!this.parent) {\n          // \u6839\uFF1A\u628A source \u89E3\u4E00\u6B21\u5373\u53EF\n          return await this.source;\n        }\n        // \u5148\u62FF\u5230\u7236\u8282\u70B9\u7ED3\u679C\uFF08\u4F1A\u8BB0\u5FC6\u5316\uFF09\n        const base = await this.parent.run();\n        // \u5E94\u7528\u672C\u8282\u70B9\u7684\u53D8\u6362\uFF08\u5141\u8BB8\u8FD4\u56DE\u540C\u6B65\u6216\u5F02\u6B65\uFF09\n        return this.op ? this.op(base) : base;\n      })();\n    }\n    return this.memo;\n  }\n\n  // \u5DE5\u5382\uFF1A\u884D\u751F\u5B50\u8282\u70B9\uFF08\u5206\u53C9 = \u590D\u7528\u540C\u4E00\u4E2A parent\uFF09\n  child(op: (x: any) => any): Node {\n    return new Node(this.source, this, op);\n  }\n\n  // \u62FF\u5230\u201C\u76F8\u540C\u8282\u70B9\u201D\u7684\u53E5\u67C4\uFF08\u663E\u5F0F fork\uFF09\n  fork(): Node {\n    return new Node(this.source, this.parent, this.op);\n  }\n}\n\nexport const WF_NODE = Symbol('@@workflow/node');\n\nfunction isWorkflowChain(x: any): x is Chain<any> {\n  return !!x && typeof x === 'function' && x[WF_NODE] instanceof Node;\n}\n\n// ========== \u5BF9\u5916 API\uFF1Aworkflow ==========\nexport function workflow<T>(source: T | Promise<T>): Chain<T> {\n  if (isWorkflowChain(source)) {\n    return source as unknown as Chain<T>;\n  }\n  const root = new Node(source, null, null);\n  return makeProxy<T>(root) as any;\n}\n\n// ========== \u4EE3\u7406\u5C42\uFF1A\u628A Node \u66B4\u9732\u6210\u94FE\u5F0F API ==========\nfunction makeProxy<T>(node: Node): Chain<T> {\n  const runOnce = () => node.run(); // \u8BB0\u5FC6\u5316\u5728 Node \u5185\u90E8\n\n  const rootHandler: ProxyHandler<any> = {\n    get(_t, prop) {\n      if (prop === WF_NODE) return node;\n      // \u7ED3\u675F\u4FE1\u53F7\uFF1A\u6240\u6709 then/catch/finally \u590D\u7528\u540C\u4E00\u4E2A Promise\n      if (prop === 'then')\n        return (res: any, rej?: any) => runOnce().then(res, rej);\n      if (prop === 'catch') return (rej: any) => runOnce().catch(rej);\n      if (prop === 'finally') return (fin: any) => runOnce().finally(fin);\n\n      // \u8BBF\u95EE\u4E00\u4E2A\u5C5E\u6027\uFF1A\u751F\u6210\u4E00\u4E2A\u201CGet\u201D\u5B50\u8282\u70B9\uFF0C\u4F46\u4E0D\u6267\u884C\n      return linkProxy(prop);\n    },\n    // \u652F\u6301\u5BF9\u201C\u5F53\u524D\u503C\u201D\u76F4\u63A5\u4E8C\u6B21\u8C03\u7528\uFF1A foo()()\n    apply(_t, _this, argArray) {\n      const child = node.child((cur: any) => {\n        if (typeof cur !== 'function')\n          throw new TypeError('Current value is not callable');\n        return cur(...argArray);\n      });\n      return makeProxy<any>(child);\n    },\n  };\n\n  const linkProxy = (prop: PropertyKey) =>\n    new Proxy(function () {}, {\n      // \u628A \u201C.foo(\u2026args)\u201D \u8BB0\u5F55\u4E3A Call\n      apply(_t, _this, argArray) {\n        const child = node.child((cur: any) => {\n          const fn = (cur as any)[prop];\n          if (typeof fn !== 'function') {\n            throw new TypeError(`${String(prop)} is not a function`);\n          }\n          return fn.apply(cur, argArray);\n        });\n        return makeProxy<any>(child);\n      },\n      // \u628A \u201C.bar\u201D \u8BB0\u5F55\u4E3A Get\uFF1B\u7EE7\u7EED\u6DF1\u5165\u65F6\u5728\u8FD9\u4E2A Get \u7684\u7ED3\u679C\u4E0A\u518D\u5904\u7406\n      get(_t, next) {\n        if (next === WF_NODE) return node;\n        if (next === 'then')\n          return (r: any, j?: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .then(r, j);\n        if (next === 'catch')\n          return (rej: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .catch(rej);\n        if (next === 'finally')\n          return (fin: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .finally(fin);\n\n        const child = node.child((cur: any) => (cur as any)[prop]);\n        return (makeProxy as any)(child)[next];\n      },\n    });\n\n  return new Proxy(function () {}, rootHandler) as any;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './src/workflow';

package/dist/index.mjs

@@ -0,0 +1,94 @@
+// src/workflow.ts
+var Node = class _Node {
+  constructor(source, parent, op) {
+    this.source = source;
+    this.parent = parent;
+    this.op = op;
+  }
+  run() {
+    if (!this.memo) {
+      this.memo = (async () => {
+        if (!this.parent) {
+          return await this.source;
+        }
+        const base = await this.parent.run();
+        return this.op ? this.op(base) : base;
+      })();
+    }
+    return this.memo;
+  }
+  // 工厂：衍生子节点（分叉 = 复用同一个 parent）
+  child(op) {
+    return new _Node(this.source, this, op);
+  }
+  // 拿到“相同节点”的句柄（显式 fork）
+  fork() {
+    return new _Node(this.source, this.parent, this.op);
+  }
+};
+var WF_NODE = Symbol("@@workflow/node");
+function isWorkflowChain(x) {
+  return !!x && typeof x === "function" && x[WF_NODE] instanceof Node;
+}
+function workflow(source) {
+  if (isWorkflowChain(source)) {
+    return source;
+  }
+  const root = new Node(source, null, null);
+  return makeProxy(root);
+}
+function makeProxy(node) {
+  const runOnce = () => node.run();
+  const rootHandler = {
+    get(_t, prop) {
+      if (prop === WF_NODE) return node;
+      if (prop === "then")
+        return (res, rej) => runOnce().then(res, rej);
+      if (prop === "catch") return (rej) => runOnce().catch(rej);
+      if (prop === "finally") return (fin) => runOnce().finally(fin);
+      return linkProxy(prop);
+    },
+    // 支持对“当前值”直接二次调用： foo()()
+    apply(_t, _this, argArray) {
+      const child = node.child((cur) => {
+        if (typeof cur !== "function")
+          throw new TypeError("Current value is not callable");
+        return cur(...argArray);
+      });
+      return makeProxy(child);
+    }
+  };
+  const linkProxy = (prop) => new Proxy(function() {
+  }, {
+    // 把 “.foo(…args)” 记录为 Call
+    apply(_t, _this, argArray) {
+      const child = node.child((cur) => {
+        const fn = cur[prop];
+        if (typeof fn !== "function") {
+          throw new TypeError(`${String(prop)} is not a function`);
+        }
+        return fn.apply(cur, argArray);
+      });
+      return makeProxy(child);
+    },
+    // 把 “.bar” 记录为 Get；继续深入时在这个 Get 的结果上再处理
+    get(_t, next) {
+      if (next === WF_NODE) return node;
+      if (next === "then")
+        return (r, j) => node.child((cur) => cur[prop]).run().then(r, j);
+      if (next === "catch")
+        return (rej) => node.child((cur) => cur[prop]).run().catch(rej);
+      if (next === "finally")
+        return (fin) => node.child((cur) => cur[prop]).run().finally(fin);
+      const child = node.child((cur) => cur[prop]);
+      return makeProxy(child)[next];
+    }
+  });
+  return new Proxy(function() {
+  }, rootHandler);
+}
+export {
+  WF_NODE,
+  workflow
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/workflow.ts"],
+  "sourcesContent": ["// ========== \u7C7B\u578B\u5DE5\u5177 ==========\ntype AwaitedLike<T> = T extends Promise<infer R> ? R : T;\ntype AnyFn = (...args: any[]) => any;\n\ntype Chain<T> = Promise<AwaitedLike<T>> &\n  (T extends AnyFn\n    ? (...a: Parameters<T>) => Chain<AwaitedLike<ReturnType<T>>>\n    : {}) & {\n    [K in keyof T]: T[K] extends (...a: infer A) => infer R\n      ? (...a: A) => Chain<AwaitedLike<R>>\n      : Chain<AwaitedLike<T[K]>>;\n  };\n\n// ========== \u6838\u5FC3\uFF1A\u4E0D\u53EF\u53D8\u8282\u70B9 ==========\nclass Node {\n  private memo?: Promise<any>;\n  constructor(\n    private readonly source: any, // \u53EA\u6709\u6839\u8282\u70B9\u6709\u610F\u4E49\uFF1B\u5B50\u8282\u70B9\u53EF\u590D\u7528\u6839\u7684 source\n    private readonly parent: Node | null, // \u524D\u7F00\n    private readonly op: ((x: any) => any) | null, // \u4ECE parent \u7ED3\u679C\u5230\u672C\u8282\u70B9\u7ED3\u679C\u7684\u53D8\u6362\n  ) {}\n\n  run(): Promise<any> {\n    if (!this.memo) {\n      this.memo = (async () => {\n        if (!this.parent) {\n          // \u6839\uFF1A\u628A source \u89E3\u4E00\u6B21\u5373\u53EF\n          return await this.source;\n        }\n        // \u5148\u62FF\u5230\u7236\u8282\u70B9\u7ED3\u679C\uFF08\u4F1A\u8BB0\u5FC6\u5316\uFF09\n        const base = await this.parent.run();\n        // \u5E94\u7528\u672C\u8282\u70B9\u7684\u53D8\u6362\uFF08\u5141\u8BB8\u8FD4\u56DE\u540C\u6B65\u6216\u5F02\u6B65\uFF09\n        return this.op ? this.op(base) : base;\n      })();\n    }\n    return this.memo;\n  }\n\n  // \u5DE5\u5382\uFF1A\u884D\u751F\u5B50\u8282\u70B9\uFF08\u5206\u53C9 = \u590D\u7528\u540C\u4E00\u4E2A parent\uFF09\n  child(op: (x: any) => any): Node {\n    return new Node(this.source, this, op);\n  }\n\n  // \u62FF\u5230\u201C\u76F8\u540C\u8282\u70B9\u201D\u7684\u53E5\u67C4\uFF08\u663E\u5F0F fork\uFF09\n  fork(): Node {\n    return new Node(this.source, this.parent, this.op);\n  }\n}\n\nexport const WF_NODE = Symbol('@@workflow/node');\n\nfunction isWorkflowChain(x: any): x is Chain<any> {\n  return !!x && typeof x === 'function' && x[WF_NODE] instanceof Node;\n}\n\n// ========== \u5BF9\u5916 API\uFF1Aworkflow ==========\nexport function workflow<T>(source: T | Promise<T>): Chain<T> {\n  if (isWorkflowChain(source)) {\n    return source as unknown as Chain<T>;\n  }\n  const root = new Node(source, null, null);\n  return makeProxy<T>(root) as any;\n}\n\n// ========== \u4EE3\u7406\u5C42\uFF1A\u628A Node \u66B4\u9732\u6210\u94FE\u5F0F API ==========\nfunction makeProxy<T>(node: Node): Chain<T> {\n  const runOnce = () => node.run(); // \u8BB0\u5FC6\u5316\u5728 Node \u5185\u90E8\n\n  const rootHandler: ProxyHandler<any> = {\n    get(_t, prop) {\n      if (prop === WF_NODE) return node;\n      // \u7ED3\u675F\u4FE1\u53F7\uFF1A\u6240\u6709 then/catch/finally \u590D\u7528\u540C\u4E00\u4E2A Promise\n      if (prop === 'then')\n        return (res: any, rej?: any) => runOnce().then(res, rej);\n      if (prop === 'catch') return (rej: any) => runOnce().catch(rej);\n      if (prop === 'finally') return (fin: any) => runOnce().finally(fin);\n\n      // \u8BBF\u95EE\u4E00\u4E2A\u5C5E\u6027\uFF1A\u751F\u6210\u4E00\u4E2A\u201CGet\u201D\u5B50\u8282\u70B9\uFF0C\u4F46\u4E0D\u6267\u884C\n      return linkProxy(prop);\n    },\n    // \u652F\u6301\u5BF9\u201C\u5F53\u524D\u503C\u201D\u76F4\u63A5\u4E8C\u6B21\u8C03\u7528\uFF1A foo()()\n    apply(_t, _this, argArray) {\n      const child = node.child((cur: any) => {\n        if (typeof cur !== 'function')\n          throw new TypeError('Current value is not callable');\n        return cur(...argArray);\n      });\n      return makeProxy<any>(child);\n    },\n  };\n\n  const linkProxy = (prop: PropertyKey) =>\n    new Proxy(function () {}, {\n      // \u628A \u201C.foo(\u2026args)\u201D \u8BB0\u5F55\u4E3A Call\n      apply(_t, _this, argArray) {\n        const child = node.child((cur: any) => {\n          const fn = (cur as any)[prop];\n          if (typeof fn !== 'function') {\n            throw new TypeError(`${String(prop)} is not a function`);\n          }\n          return fn.apply(cur, argArray);\n        });\n        return makeProxy<any>(child);\n      },\n      // \u628A \u201C.bar\u201D \u8BB0\u5F55\u4E3A Get\uFF1B\u7EE7\u7EED\u6DF1\u5165\u65F6\u5728\u8FD9\u4E2A Get \u7684\u7ED3\u679C\u4E0A\u518D\u5904\u7406\n      get(_t, next) {\n        if (next === WF_NODE) return node;\n        if (next === 'then')\n          return (r: any, j?: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .then(r, j);\n        if (next === 'catch')\n          return (rej: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .catch(rej);\n        if (next === 'finally')\n          return (fin: any) =>\n            node\n              .child((cur: any) => (cur as any)[prop])\n              .run()\n              .finally(fin);\n\n        const child = node.child((cur: any) => (cur as any)[prop]);\n        return (makeProxy as any)(child)[next];\n      },\n    });\n\n  return new Proxy(function () {}, rootHandler) as any;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/dual-object.d.ts

@@ -0,0 +1,12 @@
+export type Dual<T> = T & PromiseLike<T>;
+/** 仅允许填入 “返回 Promise 的方法名” */
+export type AsyncMethodKeys<T> = {
+    [K in keyof T]-?: T[K] extends (...args: any[]) => Promise<any> ? K : never;
+}[keyof T];
+export interface DualizeOptions<T> {
+    /** 这些方法在 undecided/pending 时会返回一个延迟执行函数，等待对象 Promise 完成后再调用 */
+    asyncMethods?: readonly AsyncMethodKeys<T>[];
+}
+export declare function dualizeAny<T>(sync: () => T, // 同步构造；若抛错则视为 rejected
+asyncFn: () => Promise<T>, // 异步构造
+options?: DualizeOptions<T>): Dual<T>;

package/dist/src/workflow.d.ts

@@ -0,0 +1,8 @@
+type AwaitedLike<T> = T extends Promise<infer R> ? R : T;
+type AnyFn = (...args: any[]) => any;
+type Chain<T> = Promise<AwaitedLike<T>> & (T extends AnyFn ? (...a: Parameters<T>) => Chain<AwaitedLike<ReturnType<T>>> : {}) & {
+    [K in keyof T]: T[K] extends (...a: infer A) => infer R ? (...a: A) => Chain<AwaitedLike<R>> : Chain<AwaitedLike<T[K]>>;
+};
+export declare const WF_NODE: unique symbol;
+export declare function workflow<T>(source: T | Promise<T>): Chain<T>;
+export {};

package/index.ts

@@ -0,0 +1 @@
+export * from './src/workflow';

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "nfkit",
+  "description": "Common kits",
+  "version": "1.0.1",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "lint": "eslint --fix .",
+    "compile:cjs": "esbuild index.ts --outfile=dist/index.cjs --bundle --sourcemap --platform=node --target=es2019 --external:js-base64",
+    "compile:esm": "esbuild index.ts --outfile=dist/index.mjs --bundle --sourcemap --platform=neutral --target=esnext --external:js-base64",
+    "compile:types": "tsc --emitDeclarationOnly --declaration",
+    "build": "rimraf dist && npm run compile:cjs && npm run compile:esm && npm run compile:types",
+    "test": "jest --passWithNoTests",
+    "start": "node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://code.moenext.com/nanahira/nfkit.git"
+  },
+  "author": "Nanahira <nanahira@momobako.com>",
+  "license": "MIT",
+  "keywords": [],
+  "bugs": {
+    "url": "https://code.moenext.com/nanahira/nfkit/issues"
+  },
+  "homepage": "https://code.moenext.com/nanahira/nfkit",
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "tests",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.9.1",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "esbuild": "^0.25.11",
+    "esbuild-register": "^3.6.0",
+    "eslint": "8.22.0",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^30.2.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+	"compilerOptions": {
+		"outDir": "dist",
+		"module": "commonjs",
+		"target": "es2021",
+		"esModuleInterop": true,
+		"emitDecoratorMetadata": true,
+		"experimentalDecorators": true,
+		"declaration": true,
+		"sourceMap": true
+	},
+	"compileOnSave": true,
+	"allowJs": true,
+	"include": [
+		"*.ts",
+		"src/**/*.ts",
+		"test/**/*.ts",
+		"tests/**/*.ts"
+	]
+}