[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_163":164,"_165":166},"routes/_app.x.$handle.$name",{"_94":93,"_32":45,"_102":84,"_27":103,"_13":14,"_104":-5,"_11":105,"_106":107,"_108":109,"_110":111,"_112":113,"_20":-5,"_114":-5,"_115":-5,"_116":25,"_117":118,"_119":25,"_120":-5,"_121":-5,"_122":123},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":-5,"_57":49,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":-5,"_67":-5,"_68":69,"_70":69,"_71":72,"_73":72,"_74":72,"_75":69,"_76":69,"_77":78,"_79":80,"_81":82,"_83":25},"version",3,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","main.tsx","latestPath","fileId","f25260be-275f-11f0-86ff-569c3dd06744","name","fileType","script","content","import type { MaybePromise } from \"https://esm.town/v/postpostscript/typeUtils\";\n\nexport function $chain(method: InterruptibleChainMethod): InterruptibleChain;\nexport function $chain(): InterruptibleChain;\nexport function $chain(\n method?: InterruptibleChainMethod,\n): InterruptibleChain | InterruptibleChain {\n if (!method) {\n const chain = $chain(() => {\n // never called\n return undefined;\n });\n chain.index = -1;\n return chain;\n }\n return new InterruptibleChain(method);\n}\n\nexport class InterruptibleChain {\n index = 0;\n parent: InterruptibleChain | undefined;\n method: InterruptibleChainMethod;\n\n constructor(method: InterruptibleChainMethod) {\n this.method = method;\n }\n\n then(method: InterruptibleChainMethod): InterruptibleChain {\n const child = new InterruptibleChain(method);\n child.index = this.index + 1;\n child.parent = this;\n return child;\n }\n\n init(state: InterruptibleChainState = {\n index: 0,\n value: void 0,\n }) {\n return new InterruptibleChainHandle(this, state);\n }\n}\n\nexport class InterruptibleChainHandle {\n state: InterruptibleChainState;\n chain: InterruptibleChain;\n interrupt: Interrupt | undefined = undefined;\n\n constructor(chain: InterruptibleChain, state: InterruptibleChainState = {\n index: 0,\n value: void 0,\n }) {\n this.chain = chain;\n this.state = state;\n }\n\n get done() {\n return this.state.index === this.chain.index + 1;\n }\n\n async advance(): Promise> {\n if (this.done) {\n throw new Error(\"chain is complete\");\n }\n this.interrupt = undefined;\n let chain: InterruptibleChain = this.chain;\n while (this.state.index < chain.index) {\n chain = chain.parent!;\n }\n let value: T | Interrupt;\n try {\n value = await chain.method(this.state.value, (reason) => new Interrupt(reason, chain));\n } catch (err) {\n if (err instanceof Interrupt) {\n value = err;\n } else {\n value = new Interrupt(err, chain);\n }\n }\n if (value instanceof Interrupt) {\n this.interrupt = value;\n return this;\n }\n this.state.value = value;\n this.state.index += 1;\n return this;\n }\n\n async untilDone(): Promise<\n {\n done: true;\n value: T;\n handle: InterruptibleChainHandle;\n } | {\n done: false;\n interrupt: Interrupt;\n handle: InterruptibleChainHandle;\n }\n > {\n this.interrupt = undefined;\n while (!(this.done || this.interrupt)) {\n await this.advance();\n }\n if (this.interrupt) {\n return {\n done: false,\n interrupt: this.interrupt,\n handle: this,\n };\n }\n return {\n done: true,\n value: this.state.value,\n handle: this,\n };\n }\n}\n\nexport class Interrupt {\n reason: T;\n chain: InterruptibleChain;\n\n constructor(reason: T, chain: InterruptibleChain) {\n this.reason = reason;\n this.chain = chain;\n }\n}\n\nexport type InterruptibleChainMethod = (\n result: P,\n interrupt: (reason: R) => Interrupt,\n) => MaybePromise;\n\nexport type InterruptibleChainState = {\n index: number;\n value: any;\n};","import type { MaybePromise } from \"https://esm.town/v/postpostscript/typeUtils\";\n\nexport function $chain(method: InterruptibleChainMethod): InterruptibleChain;\nexport function $chain(): InterruptibleChain;\nexport function $chain(\n method?: InterruptibleChainMethod,\n): InterruptibleChain | InterruptibleChain {\n if (!method) {\n const chain = $chain(() => {\n // never called\n return undefined;\n });\n chain.index = -1;\n return chain;\n }\n return new InterruptibleChain(method);\n}\n\nexport class InterruptibleChain {\n index = 0;\n parent: InterruptibleChain | undefined;\n method: InterruptibleChainMethod;\n\n constructor(method: InterruptibleChainMethod) {\n this.method = method;\n }\n\n then(method: InterruptibleChainMethod | InterruptibleChain): InterruptibleChain {\n let _method = typeof method === \"object\" ? subchainMethod(method) : method;\n const child = new InterruptibleChain(_method);\n if (this.index === -1) {\n return child;\n }\n child.index = this.index + 1;\n child.parent = this;\n return child;\n }\n\n init(state: InterruptibleChainState = {\n index: 0,\n value: undefined,\n }) {\n return new InterruptibleChainHandle(this, state);\n }\n}\n\nexport class InterruptibleChainHandle {\n state: InterruptibleChainState;\n chain: InterruptibleChain;\n interrupt: Interrupt | undefined = undefined;\n\n constructor(chain: InterruptibleChain, state: InterruptibleChainState = {\n index: 0,\n value: undefined,\n }) {\n this.chain = chain;\n this.state = state;\n }\n\n get done() {\n return this.state.index === this.chain.index + 1;\n }\n\n async advance(): Promise> {\n if (this.done) {\n throw new Error(\"chain is complete\");\n }\n this.interrupt = undefined;\n let chain: InterruptibleChain = this.chain;\n while (this.state.index < chain.index) {\n chain = chain.parent!;\n }\n let value: T | Interrupt;\n try {\n value = await chain.method(this.state.value, (reason, intermediateState) => {\n return new Interrupt(reason, chain, intermediateState);\n }, this.state.intermediateState);\n } catch (err) {\n if (err instanceof Interrupt) {\n value = err;\n } else {\n value = new Interrupt(err, chain);\n }\n }\n if (value instanceof Interrupt) {\n this.interrupt = value;\n if (value.intermediateState !== undefined) {\n this.state.intermediateState = value.intermediateState;\n } else if (\"intermediateState\" in this.state) {\n delete this.state.intermediateState;\n }\n return this;\n }\n this.state.value = value;\n if (\"intermediateState\" in this.state) {\n delete this.state.intermediateState;\n }\n this.state.index += 1;\n return this;\n }\n\n async untilDone(): Promise<\n {\n done: true;\n value: T;\n handle: InterruptibleChainHandle;\n } | {\n done: false;\n interrupt: Interrupt;\n handle: InterruptibleChainHandle;\n }\n > {\n this.interrupt = undefined;\n while (!(this.done || this.interrupt)) {\n await this.advance();\n }\n if (this.interrupt) {\n return {\n done: false,\n interrupt: this.interrupt,\n handle: this,\n };\n }\n return {\n done: true,\n value: this.state.value,\n handle: this,\n };\n }\n}\n\nexport class Interrupt {\n reason: T;\n chain: InterruptibleChain;\n intermediateState: IntermediateState | undefined;\n\n constructor(reason: T, chain: InterruptibleChain, intermediateState?: IntermediateState) {\n this.reason = reason;\n this.chain = chain;\n this.intermediateState = intermediateState;\n }\n}\n\nexport type IntermediateState = any;\n\nexport type InterruptibleChainMethod = (\n result: P,\n interrupt: (reason: R, intermediateState?: IntermediateState) => Interrupt,\n intermediateState?: IntermediateState,\n) => MaybePromise;\n\nexport type InterruptibleChainState = {\n index: number;\n value: any;\n intermediateState?: IntermediateState;\n};\n\ntype SubchainState = InterruptibleChainState | undefined;\n\nexport function subchainMethod(chain: InterruptibleChain): InterruptibleChainMethod {\n return async (previous, interrupt, intermediateState: SubchainState) => {\n const status = await chain.init(\n intermediateState || {\n index: 0,\n value: previous,\n },\n ).untilDone();\n\n if (status.done) {\n return status.value;\n } else {\n return interrupt(\n `subchain interrupted: ${status.interrupt.reason}`,\n status.handle.state,\n );\n }\n };\n}\n\nexport function join[]>(\n ...chains: Chains\n): InterruptibleChain> {\n let chain: InterruptibleChain = $chain((previous) => [[], previous]);\n\n for (const subchain of chains) {\n chain = chain.then(async ([result, previous], interrupt, intermediateState: SubchainState) => {\n const value = await subchainMethod(subchain)(undefined, interrupt, intermediateState);\n\n if (value instanceof Interrupt) {\n return value;\n }\n\n return [[\n ...result,\n value,\n ], undefined];\n });\n }\n\n chain = chain.then(([result, _]) => result);\n\n return chain as InterruptibleChain>;\n}\n\nexport type InterruptibleChainJoinResult[], Return extends any[] = []> =\n List extends [infer Chain extends InterruptibleChain, ...infer Rest extends InterruptibleChain[]]\n ? InterruptibleChainJoinResult<\n Rest,\n [...Return, (Chain extends InterruptibleChain ? Awaited : never)]\n >\n : Return;\n\nexport function append[]>(\n ...chains: Chains\n): InterruptibleChain> {\n let chain = chains[0];\n\n for (const next of chains) {\n chain = chain.then(next);\n }\n\n return chain;\n}\n\nexport type AppendResult[]> = List extends\n [infer Chain extends InterruptibleChain]\n ? (Chain extends InterruptibleChain ? Awaited : never)\n : (List extends [any, ...infer Rest extends InterruptibleChain[]] ? AppendResult<\n Rest\n >\n : never);","createdAt",["D",1736392468981],"branchVersion","branchId","f24fd81c-275f-11f0-86ff-569c3dd06744","id","f24f84c0-275f-11f0-86ff-569c3dd06744","interruptibleChain",["D",1746195348913],"deletedAt","legacyEnvVars",true,"privacy","public","httpPrivacy","description","imageUrl","4bfb99a9-2008-40e0-bacb-7c7d84227cee","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","1073b191-f665-405d-9530-545465c93575","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_94":93,"_101":97},"org",{"_94":93,"_95":-5,"_96":97,"_18":55,"_98":99,"_100":25},"branch",{"_13":14,"_32":84,"_43":42,"_85":44,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":45,"_92":93},"isOwned","main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","postpostscript","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJjdlhaRXl0WXVNSlhZcWU0ckI2c1BOMjNhQSJ9","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":159,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":-5,"_57":49,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":-5,"_67":-5,"_68":69,"_70":69,"_71":72,"_73":72,"_74":72,"_75":69,"_76":69,"_77":160,"_79":161,"_81":162,"_83":25},"tree",[150,151],"files",[150,151],"counts",{"_140":61,"_141":136,"_142":61,"_143":144,"_145":146},"contents",[124,125],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":133,"_32":134,"_30":135,"_127":-5,"_41":42,"_40":136,"_128":49,"_38":137,"_13":61,"_33":20,"_35":138,"_24":25,"_131":-5,"_27":139},{"_43":126,"_32":28,"_30":31,"_127":-5,"_41":42,"_40":14,"_128":49,"_38":129,"_13":130,"_33":34,"_35":37,"_24":25,"_131":-5,"_27":132},"f25ea5c2-275f-11f0-86ff-569c3dd06744","parentId","latest",["D",1736392468981],2,"label",[28],"f25265aa-275f-11f0-86ff-569c3dd06744","README.md","f2526636-275f-11f0-86ff-569c3dd06744",1,["D",1736214381259],"# interruptibleChain: simple interface for pausing and resuming execution chains\n\n[⚠️ Moved to GitHub ⚠️](https://github.com/postpostscript/chain)\n\n```ts\nimport { $chain } from \"https://esm.town/v/postpostscript/interruptibleChain\";\n\nconst multiply = $chain()\n .then(() => 1)\n .then((x) => x + 3)\n .then(async (x) => {\n await new Promise((resolve) => setTimeout(resolve, 1000));\n return x * 2;\n });\n\nconst handle = multiply.init();\nconsole.log(await handle.untilDone());\n// { done: true, value: 8, handle: InterruptibleChainHandle { ... } }\n\nconst handle2 = multiply.init({\n index: 2,\n value: 4,\n});\nawait handle2.advance();\nconsole.log(handle2.done, handle2.state);\n// true { index: 3, value: 8 }\n\n/**** Interrupts ****/\n\nconst handle3 = $chain().then(() => {\n throw new Error(\"failed\");\n}).init();\nawait handle3.advance();\nconsole.log(handle3.done, handle3.interrupt);\n// false Interrupt { reason: Error: failed, chain: InterruptibleChain { index: 0 } }\n\nconsole.log(await handle3.untilDone());\n// { done: false, interrupt: Interrupt { ... }, handle: InterruptibleChainHandle { ... } }\n\nconst handle4 = $chain().then((_, interrupt) => {\n return interrupt(\"call me later\");\n}).init();\nawait handle4.advance()\nconsole.log(handle4.done, handle4.interrupt);\n// false Interrupt { reason: \"call me later\", chain: InterruptibleChain { index: 0 } }\n```\n\nMigrated from folder: Archive/interruptibleChain",[134],"pulls","branches","forks","envVars",{"_147":61,"_149":61},"connections",{"_147":61,"_148":61},"count","unfilledCount","emptyCount",{"_43":133,"_32":134,"_30":135,"_127":-5,"_41":42,"_40":136,"_128":49,"_38":156,"_13":61,"_33":20,"_35":138,"_24":25,"_131":-5,"_153":157,"_27":158},{"_43":126,"_32":28,"_30":31,"_127":-5,"_41":42,"_40":14,"_128":49,"_38":152,"_13":130,"_33":34,"_35":37,"_24":25,"_131":-5,"_153":154,"_27":155},["D",1736392468981],"children",[],[28],["D",1736214381259],[],[134],["D",1746195348913],{"_94":93,"_101":97},{"_94":93,"_95":-5,"_96":97,"_18":55,"_98":99,"_100":25},{"_13":14,"_32":84,"_43":42,"_85":44,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":45,"_92":93},"ctx",{"_77":-5,"_121":196,"_197":198,"_199":200,"_201":25,"_202":25,"_203":25,"_204":49,"_205":-5,"_206":-7,"_207":-7,"_208":61,"_209":25,"_210":25,"_211":-5,"_212":25,"_213":25,"_214":25,"_215":-5},"ENV",{"_167":168,"_169":170,"_171":84,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193,"_194":195},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v3