@weasel-js/labkit 1.4.0-pre.1 → 1.4.1

package/dist/{chunk-LN6JDUGB.js → chunk-HXXTULDN.js}

@@ -102,5 +102,5 @@ function useJob({
 }
 
 export { useJob };
-//# sourceMappingURL=chunk-LN6JDUGB.js.map
-//# sourceMappingURL=chunk-LN6JDUGB.js.map
+//# sourceMappingURL=chunk-HXXTULDN.js.map
+//# sourceMappingURL=chunk-HXXTULDN.js.map

package/dist/{chunk-LN6JDUGB.js.map → chunk-HXXTULDN.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/job/useJob.ts"],"names":[],"mappings":"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","file":"chunk-LN6JDUGB.js","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport type { JobCapability, JobFailure, JobHandle, JobStatus } from './types';\n\nexport interface UseJobOptions<TS, TC, TItem> {\n  capability: JobCapability<TS, TC, TItem>;\n  config: TC;\n  state: TS;\n  setState: (next: TS | ((prev: TS) => TS)) => void;\n}\n\ninterface Progress {\n  status: JobStatus;\n  done: number;\n  total: number | null;\n  failures: JobFailure[];\n  error: string | null;\n}\n\nconst IDLE: Progress = { status: 'idle', done: 0, total: null, failures: [], error: null };\n\nfunction sameKey(a: readonly unknown[] | null, b: readonly unknown[] | null): boolean {\n  if (a === null || b === null) return a === b;\n  return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));\n}\n\nexport function useJob<TS, TC, TItem>({\n  capability,\n  config,\n  state,\n  setState,\n}: UseJobOptions<TS, TC, TItem>): JobHandle {\n  const [progress, setProgress] = useState<Progress>(IDLE);\n\n  // A run is identified by a token. Every result checks its token before touching\n  // state, so a superseded run finishes harmlessly instead of racing the winner.\n  const token = useRef(0);\n  const abort = useRef<AbortController | null>(null);\n\n  // Read through refs: `run` is called once per run and must see the values as of\n  // that moment rather than re-subscribing on every render.\n  const capRef = useRef(capability);\n  capRef.current = capability;\n  const configRef = useRef(config);\n  configRef.current = config;\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  const setStateRef = useRef(setState);\n  setStateRef.current = setState;\n\n  const cancel = useCallback(() => {\n    token.current += 1;\n    abort.current?.abort();\n    abort.current = null;\n    setProgress(IDLE);\n  }, []);\n\n  const start = useCallback(() => {\n    token.current += 1;\n    const mine = token.current;\n    abort.current?.abort();\n    const controller = new AbortController();\n    abort.current = controller;\n    setProgress({ ...IDLE, status: 'running' });\n\n    void (async () => {\n      try {\n        const iterable = capRef.current.run({\n          config: configRef.current,\n          state: stateRef.current,\n          signal: controller.signal,\n        });\n        for await (const event of iterable) {\n          if (token.current !== mine) return;\n          if (event.kind === 'total') {\n            setProgress((p) => ({ ...p, total: event.total }));\n          } else if (event.kind === 'failed') {\n            setProgress((p) => ({\n              ...p,\n              failures: [...p.failures, { index: event.index, error: event.error }],\n            }));\n          } else {\n            const fold = capRef.current.onItem;\n            const item = event.item;\n            setStateRef.current((prev) => fold(item, prev));\n            setProgress((p) => ({ ...p, done: p.done + 1 }));\n          }\n        }\n        if (token.current !== mine) return;\n        setProgress((p) => ({ ...p, status: 'done' }));\n      } catch (err) {\n        if (token.current !== mine) return;\n        setProgress((p) => ({\n          ...p,\n          status: 'error',\n          error: err instanceof Error ? err.message : String(err),\n        }));\n      }\n    })();\n  }, []);\n\n  // Re-run when the declared key changes. `auto` covers the first mount too.\n  const lastKey = useRef<readonly unknown[] | null>(null);\n  const started = useRef(false);\n  const auto = capability.auto === true;\n  const key = capability.key ? capability.key(config, state) : null;\n  // `key` is compared element-wise inside; depending on the array identity here\n  // would restart the job on every render.\n  useEffect(() => {\n    if (!auto) return;\n    if (started.current && sameKey(lastKey.current, key)) return;\n    lastKey.current = key;\n    started.current = true;\n    start();\n  }, [auto, key, start]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(\n    () => () => {\n      token.current += 1;\n      abort.current?.abort();\n      abort.current = null;\n    },\n    [],\n  );\n\n  return {\n    status: progress.status,\n    done: progress.done,\n    total: progress.total,\n    failures: progress.failures,\n    error: progress.error,\n    start,\n    cancel,\n  };\n}\n"]}
+{"version":3,"sources":["../src/job/useJob.ts"],"names":[],"mappings":";;;AAkBA,IAAM,IAAA,GAAiB,EAAE,MAAA,EAAQ,MAAA,EAAQ,IAAA,EAAM,CAAA,EAAG,KAAA,EAAO,IAAA,EAAM,QAAA,EAAU,EAAC,EAAG,KAAA,EAAO,IAAA,EAAK;AAEzF,SAAS,OAAA,CAAQ,GAA8B,CAAA,EAAuC;AACpF,EAAA,IAAI,CAAA,KAAM,IAAA,IAAQ,CAAA,KAAM,IAAA,SAAa,CAAA,KAAM,CAAA;AAC3C,EAAA,OAAO,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,IAAU,EAAE,KAAA,CAAM,CAAC,CAAA,EAAG,CAAA,KAAM,OAAO,EAAA,CAAG,CAAA,EAAG,CAAA,CAAE,CAAC,CAAC,CAAC,CAAA;AACtE;AAEO,SAAS,MAAA,CAAsB;AAAA,EACpC,UAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAA4C;AAC1C,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAI,SAAmB,IAAI,CAAA;AAIvD,EAAA,MAAM,KAAA,GAAQ,OAAO,CAAC,CAAA;AACtB,EAAA,MAAM,KAAA,GAAQ,OAA+B,IAAI,CAAA;AAIjD,EAAA,MAAM,MAAA,GAAS,OAAO,UAAU,CAAA;AAChC,EAAA,MAAA,CAAO,OAAA,GAAU,UAAA;AACjB,EAAA,MAAM,SAAA,GAAY,OAAO,MAAM,CAAA;AAC/B,EAAA,SAAA,CAAU,OAAA,GAAU,MAAA;AACpB,EAAA,MAAM,QAAA,GAAW,OAAO,KAAK,CAAA;AAC7B,EAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AACnB,EAAA,MAAM,WAAA,GAAc,OAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAC/B,IAAA,KAAA,CAAM,OAAA,IAAW,CAAA;AACjB,IAAA,KAAA,CAAM,SAAS,KAAA,EAAM;AACrB,IAAA,KAAA,CAAM,OAAA,GAAU,IAAA;AAChB,IAAA,WAAA,CAAY,IAAI,CAAA;AAAA,EAClB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,KAAA,CAAM,OAAA,IAAW,CAAA;AACjB,IAAA,MAAM,OAAO,KAAA,CAAM,OAAA;AACnB,IAAA,KAAA,CAAM,SAAS,KAAA,EAAM;AACrB,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,KAAA,CAAM,OAAA,GAAU,UAAA;AAChB,IAAA,WAAA,CAAY,EAAE,GAAG,IAAA,EAAM,MAAA,EAAQ,WAAW,CAAA;AAE1C,IAAA,KAAA,CAAM,YAAY;AAChB,MAAA,IAAI;AACF,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,OAAA,CAAQ,GAAA,CAAI;AAAA,UAClC,QAAQ,SAAA,CAAU,OAAA;AAAA,UAClB,OAAO,QAAA,CAAS,OAAA;AAAA,UAChB,QAAQ,UAAA,CAAW;AAAA,SACpB,CAAA;AACD,QAAA,WAAA,MAAiB,SAAS,QAAA,EAAU;AAClC,UAAA,IAAI,KAAA,CAAM,YAAY,IAAA,EAAM;AAC5B,UAAA,IAAI,KAAA,CAAM,SAAS,OAAA,EAAS;AAC1B,YAAA,WAAA,CAAY,CAAC,OAAO,EAAE,GAAG,GAAG,KAAA,EAAO,KAAA,CAAM,OAAM,CAAE,CAAA;AAAA,UACnD,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,QAAA,EAAU;AAClC,YAAA,WAAA,CAAY,CAAC,CAAA,MAAO;AAAA,cAClB,GAAG,CAAA;AAAA,cACH,QAAA,EAAU,CAAC,GAAG,CAAA,CAAE,QAAA,EAAU,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO;AAAA,aACtE,CAAE,CAAA;AAAA,UACJ,CAAA,MAAO;AACL,YAAA,MAAM,IAAA,GAAO,OAAO,OAAA,CAAQ,MAAA;AAC5B,YAAA,MAAM,OAAO,KAAA,CAAM,IAAA;AACnB,YAAA,WAAA,CAAY,QAAQ,CAAC,IAAA,KAAS,IAAA,CAAK,IAAA,EAAM,IAAI,CAAC,CAAA;AAC9C,YAAA,WAAA,CAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAA,EAAM,CAAA,CAAE,IAAA,GAAO,CAAA,EAAE,CAAE,CAAA;AAAA,UACjD;AAAA,QACF;AACA,QAAA,IAAI,KAAA,CAAM,YAAY,IAAA,EAAM;AAC5B,QAAA,WAAA,CAAY,CAAC,CAAA,MAAO,EAAE,GAAG,CAAA,EAAG,MAAA,EAAQ,QAAO,CAAE,CAAA;AAAA,MAC/C,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,KAAA,CAAM,YAAY,IAAA,EAAM;AAC5B,QAAA,WAAA,CAAY,CAAC,CAAA,MAAO;AAAA,UAClB,GAAG,CAAA;AAAA,UACH,MAAA,EAAQ,OAAA;AAAA,UACR,OAAO,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG;AAAA,SACxD,CAAE,CAAA;AAAA,MACJ;AAAA,IACF,CAAA,GAAG;AAAA,EACL,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,MAAM,OAAA,GAAU,OAAkC,IAAI,CAAA;AACtD,EAAA,MAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAC5B,EAAA,MAAM,IAAA,GAAO,WAAW,IAAA,KAAS,IAAA;AACjC,EAAA,MAAM,MAAM,UAAA,CAAW,GAAA,GAAM,WAAW,GAAA,CAAI,MAAA,EAAQ,KAAK,CAAA,GAAI,IAAA;AAG7D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,IAAI,QAAQ,OAAA,IAAW,OAAA,CAAQ,OAAA,CAAQ,OAAA,EAAS,GAAG,CAAA,EAAG;AACtD,IAAA,OAAA,CAAQ,OAAA,GAAU,GAAA;AAClB,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,IAAA,KAAA,EAAM;AAAA,EACR,CAAA,EAAG,CAAC,IAAA,EAAM,GAAA,EAAK,KAAK,CAAC,CAAA;AAErB,EAAA,SAAA;AAAA,IACE,MAAM,MAAM;AACV,MAAA,KAAA,CAAM,OAAA,IAAW,CAAA;AACjB,MAAA,KAAA,CAAM,SAAS,KAAA,EAAM;AACrB,MAAA,KAAA,CAAM,OAAA,GAAU,IAAA;AAAA,IAClB,CAAA;AAAA,IACA;AAAC,GACH;AAEA,EAAA,OAAO;AAAA,IACL,QAAQ,QAAA,CAAS,MAAA;AAAA,IACjB,MAAM,QAAA,CAAS,IAAA;AAAA,IACf,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,UAAU,QAAA,CAAS,QAAA;AAAA,IACnB,OAAO,QAAA,CAAS,KAAA;AAAA,IAChB,KAAA;AAAA,IACA;AAAA,GACF;AACF","file":"chunk-HXXTULDN.js","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport type { JobCapability, JobFailure, JobHandle, JobStatus } from './types';\n\nexport interface UseJobOptions<TS, TC, TItem> {\n  capability: JobCapability<TS, TC, TItem>;\n  config: TC;\n  state: TS;\n  setState: (next: TS | ((prev: TS) => TS)) => void;\n}\n\ninterface Progress {\n  status: JobStatus;\n  done: number;\n  total: number | null;\n  failures: JobFailure[];\n  error: string | null;\n}\n\nconst IDLE: Progress = { status: 'idle', done: 0, total: null, failures: [], error: null };\n\nfunction sameKey(a: readonly unknown[] | null, b: readonly unknown[] | null): boolean {\n  if (a === null || b === null) return a === b;\n  return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));\n}\n\nexport function useJob<TS, TC, TItem>({\n  capability,\n  config,\n  state,\n  setState,\n}: UseJobOptions<TS, TC, TItem>): JobHandle {\n  const [progress, setProgress] = useState<Progress>(IDLE);\n\n  // A run is identified by a token. Every result checks its token before touching\n  // state, so a superseded run finishes harmlessly instead of racing the winner.\n  const token = useRef(0);\n  const abort = useRef<AbortController | null>(null);\n\n  // Read through refs: `run` is called once per run and must see the values as of\n  // that moment rather than re-subscribing on every render.\n  const capRef = useRef(capability);\n  capRef.current = capability;\n  const configRef = useRef(config);\n  configRef.current = config;\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  const setStateRef = useRef(setState);\n  setStateRef.current = setState;\n\n  const cancel = useCallback(() => {\n    token.current += 1;\n    abort.current?.abort();\n    abort.current = null;\n    setProgress(IDLE);\n  }, []);\n\n  const start = useCallback(() => {\n    token.current += 1;\n    const mine = token.current;\n    abort.current?.abort();\n    const controller = new AbortController();\n    abort.current = controller;\n    setProgress({ ...IDLE, status: 'running' });\n\n    void (async () => {\n      try {\n        const iterable = capRef.current.run({\n          config: configRef.current,\n          state: stateRef.current,\n          signal: controller.signal,\n        });\n        for await (const event of iterable) {\n          if (token.current !== mine) return;\n          if (event.kind === 'total') {\n            setProgress((p) => ({ ...p, total: event.total }));\n          } else if (event.kind === 'failed') {\n            setProgress((p) => ({\n              ...p,\n              failures: [...p.failures, { index: event.index, error: event.error }],\n            }));\n          } else {\n            const fold = capRef.current.onItem;\n            const item = event.item;\n            setStateRef.current((prev) => fold(item, prev));\n            setProgress((p) => ({ ...p, done: p.done + 1 }));\n          }\n        }\n        if (token.current !== mine) return;\n        setProgress((p) => ({ ...p, status: 'done' }));\n      } catch (err) {\n        if (token.current !== mine) return;\n        setProgress((p) => ({\n          ...p,\n          status: 'error',\n          error: err instanceof Error ? err.message : String(err),\n        }));\n      }\n    })();\n  }, []);\n\n  // Re-run when the declared key changes. `auto` covers the first mount too.\n  const lastKey = useRef<readonly unknown[] | null>(null);\n  const started = useRef(false);\n  const auto = capability.auto === true;\n  const key = capability.key ? capability.key(config, state) : null;\n  // `key` is compared element-wise inside; depending on the array identity here\n  // would restart the job on every render.\n  useEffect(() => {\n    if (!auto) return;\n    if (started.current && sameKey(lastKey.current, key)) return;\n    lastKey.current = key;\n    started.current = true;\n    start();\n  }, [auto, key, start]);\n\n  useEffect(\n    () => () => {\n      token.current += 1;\n      abort.current?.abort();\n      abort.current = null;\n    },\n    [],\n  );\n\n  return {\n    status: progress.status,\n    done: progress.done,\n    total: progress.total,\n    failures: progress.failures,\n    error: progress.error,\n    start,\n    cancel,\n  };\n}\n"]}