feat: add scopeExit

Author: giladgd

.github/workflows/build.yml

@@ -47,7 +47,9 @@ jobs:
           lfs: true
       - uses: actions/setup-node@v4
         with:
-          node-version: "20"
+          node-version: "22"
+      - name: Update npm
+        run: npm install -g npm@latest
       - name: Install modules
         run: npm ci
       - uses: actions/download-artifact@v4
@@ -59,7 +61,6 @@ jobs:
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npx semantic-release
       - name: Set npm package url to GITHUB_OUTPUT
         id: set-npm-url

README.md

@@ -460,6 +460,47 @@ const parts = splitText("Hello <and> world [then] !", ["<and>", "[then]"]);
 console.log(parts); // ["Hello ", new Separator("<and>"), " world ", new Separator("[then]"), " !"]
 ```
 
+### `scopeExit`
+Create a scope exit handle that will call the provided callback when disposed, to be used with `using` or `await using`.
+
+For example, this code:
+```typescript
+import {scopeExit} from "lifecycle-utils";
+
+function example() {
+    using exitHandle = scopeExit(() => {
+        console.log("exiting scope");
+    });
+    console.log("inside scope");
+}
+
+async function asyncExample() {
+    await using exitHandle = scopeExit(async () => {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        console.log("exiting async scope");
+    });
+    console.log("inside async scope");
+}
+
+example();
+console.log("example done");
+console.log()
+
+await asyncExample();
+console.log("asyncExample done");
+```
+
+Will print this:
+```
+inside scope
+exiting scope
+example done
+
+inside async scope
+exiting async scope
+asyncExample done
+```
+
 ## Contributing
 To contribute to `lifecycle-utils` see [CONTRIBUTING.md](https://github.com/giladgd/lifecycle-utils/blob/master/CONTRIBUTING.md).
 

eslint.config.js

@@ -153,7 +153,8 @@ export default tseslint.config({
             args: "none",
             ignoreRestSiblings: true,
             varsIgnorePattern: "^set",
-            caughtErrors: "none"
+            caughtErrors: "none",
+            ignoreUsingDeclarations: true
         }],
         "@typescript-eslint/no-empty-object-type": ["off"],
         "@typescript-eslint/member-ordering": ["warn", {