@webneat/loop 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Amine Ben hammou
+
+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/dist/index.cjs

@@ -0,0 +1,90 @@
+"use strict";
+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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  done: () => done,
+  loop: () => loop,
+  stores: () => stores_exports
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/done.ts
+var DONE = /* @__PURE__ */ Symbol("loop:done");
+function done() {
+  return DONE;
+}
+
+// src/loop.ts
+function loop(act) {
+  return async (initial, store) => {
+    let state = store ? await store.load() : void 0;
+    if (state === void 0) state = initial;
+    while (true) {
+      const next_state = await act(state);
+      if (next_state === DONE) return state;
+      state = next_state;
+      if (store) await store.save(state);
+    }
+  };
+}
+
+// src/stores.ts
+var stores_exports = {};
+__export(stores_exports, {
+  json: () => json,
+  memory: () => memory
+});
+var import_promises = require("fs/promises");
+function memory() {
+  let state;
+  return {
+    load: async () => state,
+    save: async (next_state) => {
+      state = next_state;
+    }
+  };
+}
+function json(path) {
+  return {
+    load: async () => {
+      if (!await file_exists(path)) return void 0;
+      return JSON.parse(await (0, import_promises.readFile)(path, "utf8"));
+    },
+    save: async (state) => {
+      await (0, import_promises.writeFile)(path, JSON.stringify(state), "utf8");
+    }
+  };
+}
+async function file_exists(filename) {
+  try {
+    await (0, import_promises.access)(filename);
+    return true;
+  } catch {
+    return false;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  done,
+  loop,
+  stores
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/done.ts","../src/loop.ts","../src/stores.ts"],"sourcesContent":["export type { Store } from './types'\nexport { done } from './done'\nexport { loop } from './loop'\nexport * as stores from './stores'\n","export const DONE = Symbol('loop:done')\n\nexport function done(): typeof DONE {\n  return DONE\n}\n","import { DONE } from './done'\nimport type { ActFn, RunFn } from './types'\n\nexport function loop<State, const NextState extends State = State>(act: ActFn<State, NextState>): RunFn<State> {\n  return async (initial, store) => {\n    let state: State | undefined = store ? await store.load() : undefined\n    if (state === undefined) state = initial\n\n    while (true) {\n      const next_state = await act(state)\n      if (next_state === DONE) return state\n\n      state = next_state\n      if (store) await store.save(state)\n    }\n  }\n}\n","import { readFile, writeFile, access } from 'fs/promises'\nimport type { Store } from './types'\n\nexport function memory<State>(): Store<State> {\n  let state: State | undefined\n  return {\n    load: async () => state,\n    save: async (next_state) => {\n      state = next_state\n    },\n  }\n}\n\nexport function json<State>(path: string): Store<State> {\n  return {\n    load: async () => {\n      if (! await file_exists(path)) return undefined\n      return JSON.parse(await readFile(path, 'utf8'))\n    },\n    save: async (state) => {\n      await writeFile(path, JSON.stringify(state), 'utf8')\n    },\n  }\n}\n\nasync function file_exists(filename: string) {\n  try {\n    await access(filename)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,OAAO,uBAAO,WAAW;AAE/B,SAAS,OAAoB;AAClC,SAAO;AACT;;;ACDO,SAAS,KAAmD,KAA4C;AAC7G,SAAO,OAAO,SAAS,UAAU;AAC/B,QAAI,QAA2B,QAAQ,MAAM,MAAM,KAAK,IAAI;AAC5D,QAAI,UAAU,OAAW,SAAQ;AAEjC,WAAO,MAAM;AACX,YAAM,aAAa,MAAM,IAAI,KAAK;AAClC,UAAI,eAAe,KAAM,QAAO;AAEhC,cAAQ;AACR,UAAI,MAAO,OAAM,MAAM,KAAK,KAAK;AAAA,IACnC;AAAA,EACF;AACF;;;AChBA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAA4C;AAGrC,SAAS,SAA8B;AAC5C,MAAI;AACJ,SAAO;AAAA,IACL,MAAM,YAAY;AAAA,IAClB,MAAM,OAAO,eAAe;AAC1B,cAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEO,SAAS,KAAY,MAA4B;AACtD,SAAO;AAAA,IACL,MAAM,YAAY;AAChB,UAAI,CAAE,MAAM,YAAY,IAAI,EAAG,QAAO;AACtC,aAAO,KAAK,MAAM,UAAM,0BAAS,MAAM,MAAM,CAAC;AAAA,IAChD;AAAA,IACA,MAAM,OAAO,UAAU;AACrB,gBAAM,2BAAU,MAAM,KAAK,UAAU,KAAK,GAAG,MAAM;AAAA,IACrD;AAAA,EACF;AACF;AAEA,eAAe,YAAY,UAAkB;AAC3C,MAAI;AACF,cAAM,wBAAO,QAAQ;AACrB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+declare const DONE: unique symbol;
+declare function done(): typeof DONE;
+
+interface Store<State> {
+    load(): Promise<State | undefined>;
+    save(state: State): Promise<void>;
+}
+type ActFn<State, NextState extends State = State> = (state: State) => Promise<NextState | ReturnType<typeof done>>;
+type RunFn<State> = (initial: State, store?: Store<State>) => Promise<State>;
+
+declare function loop<State, const NextState extends State = State>(act: ActFn<State, NextState>): RunFn<State>;
+
+declare function memory<State>(): Store<State>;
+declare function json<State>(path: string): Store<State>;
+
+declare const stores_json: typeof json;
+declare const stores_memory: typeof memory;
+declare namespace stores {
+  export { stores_json as json, stores_memory as memory };
+}
+
+export { type Store, done, loop, stores };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+declare const DONE: unique symbol;
+declare function done(): typeof DONE;
+
+interface Store<State> {
+    load(): Promise<State | undefined>;
+    save(state: State): Promise<void>;
+}
+type ActFn<State, NextState extends State = State> = (state: State) => Promise<NextState | ReturnType<typeof done>>;
+type RunFn<State> = (initial: State, store?: Store<State>) => Promise<State>;
+
+declare function loop<State, const NextState extends State = State>(act: ActFn<State, NextState>): RunFn<State>;
+
+declare function memory<State>(): Store<State>;
+declare function json<State>(path: string): Store<State>;
+
+declare const stores_json: typeof json;
+declare const stores_memory: typeof memory;
+declare namespace stores {
+  export { stores_json as json, stores_memory as memory };
+}
+
+export { type Store, done, loop, stores };

package/dist/index.js

@@ -0,0 +1,67 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/done.ts
+var DONE = /* @__PURE__ */ Symbol("loop:done");
+function done() {
+  return DONE;
+}
+
+// src/loop.ts
+function loop(act) {
+  return async (initial, store) => {
+    let state = store ? await store.load() : void 0;
+    if (state === void 0) state = initial;
+    while (true) {
+      const next_state = await act(state);
+      if (next_state === DONE) return state;
+      state = next_state;
+      if (store) await store.save(state);
+    }
+  };
+}
+
+// src/stores.ts
+var stores_exports = {};
+__export(stores_exports, {
+  json: () => json,
+  memory: () => memory
+});
+import { readFile, writeFile, access } from "fs/promises";
+function memory() {
+  let state;
+  return {
+    load: async () => state,
+    save: async (next_state) => {
+      state = next_state;
+    }
+  };
+}
+function json(path) {
+  return {
+    load: async () => {
+      if (!await file_exists(path)) return void 0;
+      return JSON.parse(await readFile(path, "utf8"));
+    },
+    save: async (state) => {
+      await writeFile(path, JSON.stringify(state), "utf8");
+    }
+  };
+}
+async function file_exists(filename) {
+  try {
+    await access(filename);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  done,
+  loop,
+  stores_exports as stores
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/done.ts","../src/loop.ts","../src/stores.ts"],"sourcesContent":["export const DONE = Symbol('loop:done')\n\nexport function done(): typeof DONE {\n  return DONE\n}\n","import { DONE } from './done'\nimport type { ActFn, RunFn } from './types'\n\nexport function loop<State, const NextState extends State = State>(act: ActFn<State, NextState>): RunFn<State> {\n  return async (initial, store) => {\n    let state: State | undefined = store ? await store.load() : undefined\n    if (state === undefined) state = initial\n\n    while (true) {\n      const next_state = await act(state)\n      if (next_state === DONE) return state\n\n      state = next_state\n      if (store) await store.save(state)\n    }\n  }\n}\n","import { readFile, writeFile, access } from 'fs/promises'\nimport type { Store } from './types'\n\nexport function memory<State>(): Store<State> {\n  let state: State | undefined\n  return {\n    load: async () => state,\n    save: async (next_state) => {\n      state = next_state\n    },\n  }\n}\n\nexport function json<State>(path: string): Store<State> {\n  return {\n    load: async () => {\n      if (! await file_exists(path)) return undefined\n      return JSON.parse(await readFile(path, 'utf8'))\n    },\n    save: async (state) => {\n      await writeFile(path, JSON.stringify(state), 'utf8')\n    },\n  }\n}\n\nasync function file_exists(filename: string) {\n  try {\n    await access(filename)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":";;;;;;;AAAO,IAAM,OAAO,uBAAO,WAAW;AAE/B,SAAS,OAAoB;AAClC,SAAO;AACT;;;ACDO,SAAS,KAAmD,KAA4C;AAC7G,SAAO,OAAO,SAAS,UAAU;AAC/B,QAAI,QAA2B,QAAQ,MAAM,MAAM,KAAK,IAAI;AAC5D,QAAI,UAAU,OAAW,SAAQ;AAEjC,WAAO,MAAM;AACX,YAAM,aAAa,MAAM,IAAI,KAAK;AAClC,UAAI,eAAe,KAAM,QAAO;AAEhC,cAAQ;AACR,UAAI,MAAO,OAAM,MAAM,KAAK,KAAK;AAAA,IACnC;AAAA,EACF;AACF;;;AChBA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,UAAU,WAAW,cAAc;AAGrC,SAAS,SAA8B;AAC5C,MAAI;AACJ,SAAO;AAAA,IACL,MAAM,YAAY;AAAA,IAClB,MAAM,OAAO,eAAe;AAC1B,cAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEO,SAAS,KAAY,MAA4B;AACtD,SAAO;AAAA,IACL,MAAM,YAAY;AAChB,UAAI,CAAE,MAAM,YAAY,IAAI,EAAG,QAAO;AACtC,aAAO,KAAK,MAAM,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,IAChD;AAAA,IACA,MAAM,OAAO,UAAU;AACrB,YAAM,UAAU,MAAM,KAAK,UAAU,KAAK,GAAG,MAAM;AAAA,IACrD;AAAA,EACF;AACF;AAEA,eAAe,YAAY,UAAkB;AAC3C,MAAI;AACF,UAAM,OAAO,QAAQ;AACrB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@webneat/loop",
+  "version": "0.0.3",
+  "description": "Resumable loops with persisted state",
+  "license": "MIT",
+  "author": "Amine Ben hammou",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "volta": {
+    "node": "26.8.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test-watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write ."
+  }
+}