{"id":50946537,"url":"https://github.com/jfet97/resumabletcf","last_synced_at":"2026-06-17T20:38:35.581Z","repository":{"id":35048270,"uuid":"200526881","full_name":"jfet97/resumabletcf","owner":"jfet97","description":"A package that let recover failed computations inside try blocks.","archived":false,"fork":false,"pushed_at":"2023-01-04T06:16:27.000Z","size":809,"stargazers_count":1,"open_issues_count":12,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-17T20:38:34.105Z","etag":null,"topics":["es6","generators","javascript","resume","try-catch","yield"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jfet97.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-04T18:17:58.000Z","updated_at":"2020-07-08T05:13:08.000Z","dependencies_parsed_at":"2023-01-15T12:44:10.805Z","dependency_job_id":null,"html_url":"https://github.com/jfet97/resumabletcf","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jfet97/resumabletcf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfet97%2Fresumabletcf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfet97%2Fresumabletcf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfet97%2Fresumabletcf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfet97%2Fresumabletcf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jfet97","download_url":"https://codeload.github.com/jfet97/resumabletcf/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfet97%2Fresumabletcf/sbom","scorecard":{"id":517416,"data":{"date":"2025-08-11","repo":{"name":"github.com/jfet97/resumabletcf","commit":"b4eb294df6166c4cc79a29ed3a584367c8bcbff3"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/24 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"53 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-6chw-6frg-f759","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-w8qv-6jwh-64r5","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3","Warn: Project is vulnerable to: MAL-2023-462","Warn: Project is vulnerable to: GHSA-w457-6q6x-cgp9","Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f","Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p","Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv","Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8","Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65","Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh","Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44","Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9","Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw","Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc","Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh","Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T02:11:23.999Z","repository_id":35048270,"created_at":"2025-08-20T02:11:23.999Z","updated_at":"2025-08-20T02:11:23.999Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34465322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["es6","generators","javascript","resume","try-catch","yield"],"created_at":"2026-06-17T20:38:34.792Z","updated_at":"2026-06-17T20:38:35.576Z","avatar_url":"https://github.com/jfet97.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![NPM version](https://img.shields.io/npm/v/resumabletcf.svg)](https://www.npmjs.com/package/resumabletcf) [![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/jfet97/resumabletcf/blob/master/LICENSE) ![](https://img.shields.io/badge/dependencies-no%20dependencies-%231e88e5%20.svg) ![](https://img.shields.io/node/v/resumabletcf.svg) ![](https://img.shields.io/bundlephobia/minzip/resumabletcf.svg) ![](https://img.shields.io/npm/dt/resumabletcf.svg)\n# resumabletcf\n\nA ultra-lightweigh UMD compiled package that helps resuming the flow inside a failed try block.\n\n## install\n```sh\n$ npm i -S resumabletcf\n```\n\n## menu\n* [motivation](#motivation)\n* [readme](#readme)\n* [sync example](#sync-example)\n* [async example](#async-example)\n* [how does it work](#how-does-it-work)\n\n## motivation\nAfter an error is thrown inside a function, we cannot recover the original code in the point where the error raised up. It's too late because of _stack unwinding_.\nThis package give to us at least the possibility to try again the failed computation from the client perspective and, if it is the case, replace its value with a fallback one.\n\n## readme\nI've written an [exhaustive article](https://dev.to/jfet97/how-to-resume-the-flow-inside-a-failed-try-block-computation-without-algebraic-effects-pbo) about this package.\nPlease read it to make me happy :D.\\\nYou'll find the background of the package, a more detailed example of its use to connect to some remote API and an example of its limitations.\n\n## sync example\nHere you can see how two different sync functions that may throw are handled.\\\nThe former will be replayed at most 5 times in case of failure, and the numeric value `0` is used as a fallback value. The latter will be replayed at most 5 times in case of failure, but no fallback value is used, therefore if we ran out of attempts an exception will be thrown.\n\n\n```js\nconst { performSync, computeSync } = require(\"resumabletcf\");\n\nlet value = null;\n\ntry {\n    value = performSync(function*() {\n        // computeSync(unitOfWork, howManyTimesToRetry, fallbackValue)\n        const res1 = yield computeSync(itMayThrow, 5, 0);\n        const res2 = yield computeSync(() =\u003e itMayThrowToo(res1), 5);\n\n        return res2 / res1;\n    });\n\n} catch(e) {\n    console.log(e);\n}\n```\n\n## async example\nThere is no much difference between this example and the previous, except that now we are in the async realm.\n\n\n```js\nconst { performAsync, computeAsync } = require(\"resumabletcf\");\n\n;(async () =\u003e {\n    let value = null;\n\n    try {\n        value = await performAsync(async function*() {\n            // computeAsync(unitOfWork, howManyTimesToRetry, fallbackValue)\n            const res1 = yield computeAsync(itMayThrow, 5, 0);\n            const res2 = yield computeAsync(() =\u003e asyncItMayThrowToo(res1), 5);\n\n            return res2 / res1;\n        });\n\n    } catch(e) {\n        console.log(e);\n    }\n})();\n```\n\n## how does it work\nBoth the `performSync` and the `performAsync` functions take a generator, a _sync_ and an _async_ one respectively, and have the task to handle what they yield out. Only a particular type of function that embraces the problematic piece of computation must be yielded out, to then be properly managed by the generator runner, and we can create it thanks to the `compute` helpers.\nIf the generator reaches the end, the returned value will be given back by the `perform` functions, as a normal value in the `performSync` case or contained in a Promise in the `performAsync` case.\n\nThese helpers require __three__ arguments: the unit of work to perform, how many times to retry it in case of failure (default value is __0__) and a fallback value to be used if we ran out of attempts.\nIf you don't want to let the `perform` runner use a fallback value for a specific computation, preferring to rethrow the exception that has caused the unit of work to fail, simply do not pass the third parameter.\nBe aware of the fact that passing `undefined` as the third parameter __is not the same__ as passing only two parameters; this ensures you can use `undefined` as a fallback value.\n\nThree more points to keep in mind:\n* `performAsync` always returns a Promise that will be fulfilled only if the async generator reaches the end, otherwise it will be rejected with the exception that causes its interruption as the reason\n* the function resulting from calling `computeAsync` always `await` the unit of work you have passed to the helper\n* you are not forced to return something from the generators\n\n##\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfet97%2Fresumabletcf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjfet97%2Fresumabletcf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfet97%2Fresumabletcf/lists"}