jdisposer 0.0.1

package/README.md

@@ -0,0 +1,39 @@
+# jdisposer - A Resource Management Library
+
+Manage cleanup of resources with AbortSignal integration.
+
+### Sample Usage
+
+```typescript
+import { makeDisposer } from 'jdisposer'
+
+const disposer = makeDisposer()
+
+// Use with fetch API
+fetch('/api/data', { signal: disposer.signal })
+
+// Add cleanup functions
+disposer.add(() => console.log('Cleanup 1'))
+disposer.add(() => console.log('Cleanup 2'))
+
+// Clean up everything (aborts signal and calls cleanup functions)
+disposer.dispose() // Subsequent calls are no-op
+```
+
+### API
+
+`makeDisposer()`: Creates a new Disposer instance
+`Disposer` object has the following properties:
+- `dispose()`: Abort signal and call all cleanup functions (no-op if already disposed)
+- `signal`: AbortSignal that's aborted when disposed
+- `add(fn?)`: Add cleanup function
+	- Ignores falsy values
+	- Calls immediately if already disposed
+	- Functions called in reverse order on dispose
+
+`makeReset()`: Creates a resettable disposer pattern
+- Returns a reset function that when called:
+	- Disposes the current disposer
+	- Creates and returns a new disposer instance
+- Useful for managing resources that need periodic cleanup and recreation
+

package/index.d.ts

@@ -0,0 +1,11 @@
+export type Disposer = ReturnType<typeof makeDisposer>;
+export declare function makeDisposer(): {
+    add(this: void, dispose?: void | (() => void)): void;
+    dispose(this: void): void;
+    signal: AbortSignal;
+};
+export declare function makeReset(): () => {
+    add(this: void, dispose?: void | (() => void)): void;
+    dispose(this: void): void;
+    signal: AbortSignal;
+};

package/index.js

@@ -0,0 +1,29 @@
+export function makeDisposer() {
+    const disposeFns = [];
+    const abortController = new AbortController();
+    return {
+        add(dispose) {
+            if (!dispose)
+                return;
+            if (abortController.signal.aborted)
+                dispose();
+            else
+                disposeFns.push(dispose);
+        },
+        dispose() {
+            if (abortController.signal.aborted)
+                return;
+            abortController.abort();
+            for (const dispose of disposeFns.slice().reverse())
+                dispose();
+        },
+        signal: abortController.signal,
+    };
+}
+export function makeReset() {
+    let disposer = makeDisposer();
+    return () => {
+        disposer.dispose();
+        return (disposer = makeDisposer());
+    };
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+	"name": "jdisposer",
+	"version": "0.0.1",
+	"scripts": {
+		"prepublishOnly": "npx tsc index.ts --lib esnext,dom --target esnext --declaration --skipLibCheck",
+		"test": "node --test *.test.ts",
+		"test:coverage": "node --test --experimental-test-coverage *.test.ts"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/tranvansang/jdisposer.git"
+	},
+	"files": [
+		"index.js",
+		"index.d.ts"
+	],
+	"devDependencies": {
+		"@types/node": "^24.10.1",
+		"typescript": "^5.9.3"
+	}
+}