@xylabs/forget 2.6.4

package/dist/docs.json

@@ -0,0 +1,110 @@
+{
+	"id": 0,
+	"name": "@xylabs/forget",
+	"kind": 1,
+	"kindString": "Project",
+	"flags": {},
+	"originalName": "",
+	"children": [
+		{
+			"id": 5,
+			"name": "default",
+			"kind": 8388608,
+			"kindString": "Reference",
+			"flags": {},
+			"sources": [
+				{
+					"fileName": "index.ts",
+					"line": 6,
+					"character": 0,
+					"url": "https://github.com/xylabs/sdk-js/blob/ff7d0bd/packages/forget/src/index.ts#L6"
+				}
+			],
+			"target": 1
+		},
+		{
+			"id": 1,
+			"name": "forget",
+			"kind": 64,
+			"kindString": "Function",
+			"flags": {},
+			"sources": [
+				{
+					"fileName": "forget.ts",
+					"line": 73,
+					"character": 13,
+					"url": "https://github.com/xylabs/sdk-js/blob/ff7d0bd/packages/forget/src/forget.ts#L73"
+				}
+			],
+			"signatures": [
+				{
+					"id": 2,
+					"name": "forget",
+					"kind": 4096,
+					"kindString": "Call signature",
+					"flags": {},
+					"parameters": [
+						{
+							"id": 3,
+							"name": "promise",
+							"kind": 32768,
+							"kindString": "Parameter",
+							"flags": {},
+							"type": {
+								"type": "reference",
+								"typeArguments": [
+									{
+										"type": "intrinsic",
+										"name": "unknown"
+									}
+								],
+								"name": "Promise",
+								"qualifiedName": "Promise",
+								"package": "typescript"
+							}
+						},
+						{
+							"id": 4,
+							"name": "timeout",
+							"kind": 32768,
+							"kindString": "Parameter",
+							"flags": {
+								"isOptional": true
+							},
+							"type": {
+								"type": "reference",
+								"name": "ForgetTimeoutConfig"
+							}
+						}
+					],
+					"type": {
+						"type": "intrinsic",
+						"name": "void"
+					}
+				}
+			]
+		}
+	],
+	"groups": [
+		{
+			"title": "References",
+			"children": [
+				5
+			]
+		},
+		{
+			"title": "Functions",
+			"children": [
+				1
+			]
+		}
+	],
+	"sources": [
+		{
+			"fileName": "index.ts",
+			"line": 1,
+			"character": 0,
+			"url": "https://github.com/xylabs/sdk-js/blob/ff7d0bd/packages/forget/src/index.ts#L1"
+		}
+	]
+}

package/dist/esm/browser/Buffer.d.ts

@@ -0,0 +1,3 @@
+import { Buffer as BrowserBuffer } from 'buffer/';
+export { BrowserBuffer };
+//# sourceMappingURL=Buffer.d.ts.map

package/dist/esm/browser/Buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Buffer.d.ts","sourceRoot":"","sources":["../../../src/browser/Buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAEjD,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/esm/browser/Buffer.js

@@ -0,0 +1,3 @@
+import { Buffer as BrowserBuffer } from 'buffer/';
+export { BrowserBuffer };
+//# sourceMappingURL=Buffer.js.map

package/dist/esm/browser/Buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Buffer.js","sourceRoot":"","sources":["../../../src/browser/Buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAEjD,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/esm/browser/bufferPolyfill.d.ts

@@ -0,0 +1,2 @@
+export declare const bufferPolyfillBrowser: () => void;
+//# sourceMappingURL=bufferPolyfill.d.ts.map

package/dist/esm/browser/bufferPolyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferPolyfill.d.ts","sourceRoot":"","sources":["../../../src/browser/bufferPolyfill.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,YAQjC,CAAA"}

package/dist/esm/browser/bufferPolyfill.js

@@ -0,0 +1,11 @@
+import { BrowserBuffer } from './Buffer';
+export const bufferPolyfillBrowser = () => {
+    if (window !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const global = window;
+        if (global.Buffer === undefined) {
+            global.Buffer = BrowserBuffer;
+        }
+    }
+};
+//# sourceMappingURL=bufferPolyfill.js.map

package/dist/esm/browser/bufferPolyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferPolyfill.js","sourceRoot":"","sources":["../../../src/browser/bufferPolyfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,IAAI,MAAM,KAAK,SAAS,EAAE;QACxB,8DAA8D;QAC9D,MAAM,MAAM,GAAG,MAAa,CAAA;QAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE;YAC/B,MAAM,CAAC,MAAM,GAAG,aAAa,CAAA;SAC9B;KACF;AACH,CAAC,CAAA"}

package/dist/esm/browser/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Buffer';
+export * from './bufferPolyfill';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/esm/browser/index.js

@@ -0,0 +1,3 @@
+export * from './Buffer';
+export * from './bufferPolyfill';
+//# sourceMappingURL=index.js.map

package/dist/esm/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/esm/browserIndex.d.ts

@@ -0,0 +1,3 @@
+export * from './browser';
+export { BrowserBuffer as Buffer, bufferPolyfillBrowser as bufferPolyfill } from './browser';
+//# sourceMappingURL=browserIndex.d.ts.map

package/dist/esm/browserIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserIndex.d.ts","sourceRoot":"","sources":["../../src/browserIndex.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/esm/browserIndex.js

@@ -0,0 +1,3 @@
+export * from './browser';
+export { BrowserBuffer as Buffer, bufferPolyfillBrowser as bufferPolyfill } from './browser';
+//# sourceMappingURL=browserIndex.js.map

package/dist/esm/browserIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserIndex.js","sourceRoot":"","sources":["../../src/browserIndex.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/esm/delay.d.ts

@@ -0,0 +1,2 @@
+export declare const delay: (ms: number) => Promise<unknown>;
+//# sourceMappingURL=delay.d.ts.map

package/dist/esm/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../src/delay.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,OAAQ,MAAM,qBAE/B,CAAA"}

package/dist/esm/delay.js

@@ -0,0 +1,4 @@
+export const delay = (ms) => {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+};
+//# sourceMappingURL=delay.js.map

package/dist/esm/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/delay.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC,CAAA"}

package/dist/esm/forget.d.ts

@@ -0,0 +1,12 @@
+export interface ForgetTimeoutConfig {
+    delay: number;
+    cancel: () => void;
+}
+export declare class ForgetPromise {
+    static get active(): boolean;
+    static activeForgets: number;
+    static awaitInactive(interval?: number, timeout?: number): Promise<number>;
+    static forget(promise: Promise<unknown>, timeout?: ForgetTimeoutConfig): void;
+}
+export declare const forget: (promise: Promise<unknown>, timeout?: ForgetTimeoutConfig) => void;
+//# sourceMappingURL=forget.d.ts.map

package/dist/esm/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/forget.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,qBAAa,aAAa;IACxB,MAAM,KAAK,MAAM,YAEhB;IAED,MAAM,CAAC,aAAa,SAAI;WAEX,aAAa,CAAC,QAAQ,SAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAe3D,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAwCvE;AAGD,eAAO,MAAM,MAAM,YAAa,QAAQ,OAAO,CAAC,YAAY,mBAAmB,SAE9E,CAAA"}

package/dist/esm/forget.js

@@ -0,0 +1,61 @@
+import { delay } from '@xylabs/delay';
+export class ForgetPromise {
+    static get active() {
+        return this.activeForgets > 0;
+    }
+    static activeForgets = 0;
+    static async awaitInactive(interval = 100, timeout) {
+        let timeoutRemaining = timeout;
+        while (this.active) {
+            await delay(interval);
+            if (timeoutRemaining !== undefined) {
+                timeoutRemaining -= interval;
+                if (timeoutRemaining <= 0) {
+                    return this.activeForgets;
+                }
+            }
+        }
+        return 0;
+    }
+    //used to explicitly launch an async function (or Promise) with awaiting it
+    static forget(promise, timeout) {
+        let completed = false;
+        this.activeForgets++;
+        const promiseWrapper = async () => {
+            await promise
+                .then(() => {
+                this.activeForgets--;
+                completed = true;
+            })
+                .catch(() => {
+                this.activeForgets--;
+                completed = true;
+            });
+        };
+        const promises = [promiseWrapper()];
+        //if there is a timeout, add it to the race
+        if (timeout) {
+            const timeoutFunc = async () => {
+                await delay(timeout.delay);
+                if (!completed) {
+                    console.log(`forget promise timeout out after ${timeout.delay}ms [Cancelling]`);
+                    timeout.cancel?.();
+                }
+            };
+            promises.push(timeoutFunc());
+        }
+        const all = Promise.race(promises);
+        all
+            .then(() => {
+            return;
+        })
+            .catch(() => {
+            return;
+        });
+    }
+}
+//used to explicitly launch an async function (or Promise) with awaiting it
+export const forget = (promise, timeout) => {
+    ForgetPromise.forget(promise, timeout);
+};
+//# sourceMappingURL=forget.js.map

package/dist/esm/forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.js","sourceRoot":"","sources":["../../src/forget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAOrC,MAAM,OAAO,aAAa;IACxB,MAAM,KAAK,MAAM;QACf,OAAO,IAAI,CAAC,aAAa,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,MAAM,CAAC,aAAa,GAAG,CAAC,CAAA;IAExB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,GAAG,GAAG,EAAE,OAAgB;QACzD,IAAI,gBAAgB,GAAG,OAAO,CAAA;QAC9B,OAAO,IAAI,CAAC,MAAM,EAAE;YAClB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAA;YACrB,IAAI,gBAAgB,KAAK,SAAS,EAAE;gBAClC,gBAAgB,IAAI,QAAQ,CAAA;gBAC5B,IAAI,gBAAgB,IAAI,CAAC,EAAE;oBACzB,OAAO,IAAI,CAAC,aAAa,CAAA;iBAC1B;aACF;SACF;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,MAAM,CAAC,OAAyB,EAAE,OAA6B;QACpE,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,aAAa,EAAE,CAAA;QAEpB,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;YAChC,MAAM,OAAO;iBACV,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,SAAS,GAAG,IAAI,CAAA;YAClB,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,SAAS,GAAG,IAAI,CAAA;YAClB,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QAED,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,CAAC,CAAA;QAEnC,2CAA2C;QAC3C,IAAI,OAAO,EAAE;YACX,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;gBAC7B,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC1B,IAAI,CAAC,SAAS,EAAE;oBACd,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,CAAC,KAAK,iBAAiB,CAAC,CAAA;oBAC/E,OAAO,CAAC,MAAM,EAAE,EAAE,CAAA;iBACnB;YACH,CAAC,CAAA;YACD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;SAC7B;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAElC,GAAG;aACA,IAAI,CAAC,GAAG,EAAE;YACT,OAAM;QACR,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,OAAM;QACR,CAAC,CAAC,CAAA;IACN,CAAC;;AAGH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAyB,EAAE,OAA6B,EAAE,EAAE;IACjF,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACxC,CAAC,CAAA"}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import { forget } from './forget';
+export { forget };
+export default forget;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,MAAM,EAAE,CAAA;AAGjB,eAAe,MAAM,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { forget } from './forget';
+export { forget };
+// eslint-disable-next-line import/no-default-export
+export default forget;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,oDAAoD;AACpD,eAAe,MAAM,CAAA"}

package/dist/esm/node/Buffer.d.ts

@@ -0,0 +1,3 @@
+import { Buffer } from 'buffer';
+export { Buffer as NodeBuffer };
+//# sourceMappingURL=Buffer.d.ts.map

package/dist/esm/node/Buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Buffer.d.ts","sourceRoot":"","sources":["../../../src/node/Buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,CAAA"}

package/dist/esm/node/Buffer.js

@@ -0,0 +1,3 @@
+import { Buffer } from 'buffer';
+export { Buffer as NodeBuffer };
+//# sourceMappingURL=Buffer.js.map

package/dist/esm/node/Buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Buffer.js","sourceRoot":"","sources":["../../../src/node/Buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,CAAA"}

package/dist/esm/node/bufferPolyfill.d.ts

@@ -0,0 +1,2 @@
+export declare const bufferPolyfillNode: () => void;
+//# sourceMappingURL=bufferPolyfill.d.ts.map

package/dist/esm/node/bufferPolyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferPolyfill.d.ts","sourceRoot":"","sources":["../../../src/node/bufferPolyfill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,YAE9B,CAAA"}

package/dist/esm/node/bufferPolyfill.js

@@ -0,0 +1,4 @@
+export const bufferPolyfillNode = () => {
+    return;
+};
+//# sourceMappingURL=bufferPolyfill.js.map

package/dist/esm/node/bufferPolyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferPolyfill.js","sourceRoot":"","sources":["../../../src/node/bufferPolyfill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAM;AACR,CAAC,CAAA"}

package/dist/esm/node/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Buffer';
+export * from './bufferPolyfill';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/esm/node/index.js

@@ -0,0 +1,3 @@
+export * from './Buffer';
+export * from './bufferPolyfill';
+//# sourceMappingURL=index.js.map

package/dist/esm/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/esm/nodeIndex.d.ts

@@ -0,0 +1,3 @@
+export * from './node';
+export { NodeBuffer as Buffer, bufferPolyfillNode as bufferPolyfill } from './node';
+//# sourceMappingURL=nodeIndex.d.ts.map

package/dist/esm/nodeIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeIndex.d.ts","sourceRoot":"","sources":["../../src/nodeIndex.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,kBAAkB,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAA"}

package/dist/esm/nodeIndex.js

@@ -0,0 +1,3 @@
+export * from './node';
+export { NodeBuffer as Buffer, bufferPolyfillNode as bufferPolyfill } from './node';
+//# sourceMappingURL=nodeIndex.js.map

package/dist/esm/nodeIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeIndex.js","sourceRoot":"","sources":["../../src/nodeIndex.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,kBAAkB,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAA"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "license": "LGPL-3.0",
+  "name": "@xylabs/forget",
+  "author": {
+    "email": "support@xylabs.com",
+    "name": "XY Labs Development Team",
+    "url": "https://xylabs.com"
+  },
+  "bugs": {
+    "email": "support@xylabs.com",
+    "url": "https://github.com/xylabs/sdk-js/issues"
+  },
+  "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
+  "browser": "dist/esm/index.js",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "docs": "dist/docs.json",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/cjs/index.js"
+      },
+      "browser": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/cjs/index.js"
+      },
+      "default": "./dist/esm/index.js"
+    },
+    "./dist/docs.json": {
+      "default": "./dist/docs.json"
+    },
+    "./package.json": "./package.json"
+  },
+  "homepage": "https://xylabs.com",
+  "keywords": [
+    "xylabs",
+    "utility",
+    "typescript",
+    "esm"
+  ],
+  "dependencies": {
+    "@xylabs/delay": "^2.6.4",
+    "tslib": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.6.5",
+    "@xylabs/tsconfig": "^2.5.75"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xylabs/sdk-js.git"
+  },
+  "resolutions": {
+    "uuid": "^8"
+  },
+  "sideEffects": false,
+  "version": "2.6.4"
+}

package/src/forget.spec.ts

@@ -0,0 +1,37 @@
+import { delay } from '@xylabs/delay'
+
+import { forget, ForgetPromise } from './forget'
+
+describe('forget', () => {
+  test('checking happy path', async () => {
+    let cancelled = false
+    forget(delay(100), { cancel: () => (cancelled = true), delay: 200 })
+    await delay(300)
+    expect(cancelled).toBeFalsy()
+  })
+  test('checking unhappy path', async () => {
+    let cancelled = false
+    forget(delay(200), { cancel: () => (cancelled = true), delay: 100 })
+    await delay(300)
+    expect(cancelled).toBeTruthy()
+  })
+  test('forget active', async () => {
+    forget(delay(300))
+    expect(ForgetPromise.active).toBeTruthy()
+    await delay(600)
+    expect(ForgetPromise.active).toBeFalsy()
+  })
+  test('forget active async', async () => {
+    forget(delay(1000))
+    await ForgetPromise.awaitInactive()
+    expect(ForgetPromise.active).toBeFalsy()
+  })
+  test('forget active async w/timeout', async () => {
+    forget(delay(300))
+    const activeCount = await ForgetPromise.awaitInactive(100, 200)
+    expect(activeCount).toBe(1)
+    expect(ForgetPromise.active).toBeTruthy()
+    await ForgetPromise.awaitInactive()
+    expect(ForgetPromise.active).toBeFalsy()
+  })
+})

package/src/forget.ts

@@ -0,0 +1,75 @@
+import { delay } from '@xylabs/delay'
+
+export interface ForgetTimeoutConfig {
+  delay: number
+  cancel: () => void
+}
+
+export class ForgetPromise {
+  static get active() {
+    return this.activeForgets > 0
+  }
+
+  static activeForgets = 0
+
+  static async awaitInactive(interval = 100, timeout?: number) {
+    let timeoutRemaining = timeout
+    while (this.active) {
+      await delay(interval)
+      if (timeoutRemaining !== undefined) {
+        timeoutRemaining -= interval
+        if (timeoutRemaining <= 0) {
+          return this.activeForgets
+        }
+      }
+    }
+    return 0
+  }
+
+  //used to explicitly launch an async function (or Promise) with awaiting it
+  static forget(promise: Promise<unknown>, timeout?: ForgetTimeoutConfig) {
+    let completed = false
+    this.activeForgets++
+
+    const promiseWrapper = async () => {
+      await promise
+        .then(() => {
+          this.activeForgets--
+          completed = true
+        })
+        .catch(() => {
+          this.activeForgets--
+          completed = true
+        })
+    }
+
+    const promises = [promiseWrapper()]
+
+    //if there is a timeout, add it to the race
+    if (timeout) {
+      const timeoutFunc = async () => {
+        await delay(timeout.delay)
+        if (!completed) {
+          console.log(`forget promise timeout out after ${timeout.delay}ms [Cancelling]`)
+          timeout.cancel?.()
+        }
+      }
+      promises.push(timeoutFunc())
+    }
+
+    const all = Promise.race(promises)
+
+    all
+      .then(() => {
+        return
+      })
+      .catch(() => {
+        return
+      })
+  }
+}
+
+//used to explicitly launch an async function (or Promise) with awaiting it
+export const forget = (promise: Promise<unknown>, timeout?: ForgetTimeoutConfig) => {
+  ForgetPromise.forget(promise, timeout)
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+import { forget } from './forget'
+
+export { forget }
+
+// eslint-disable-next-line import/no-default-export
+export default forget

package/tsconfig.build.cjs.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "module": "CommonJS",
+    "outDir": "./dist/cjs",
+    "target": "ES6"
+  },
+  "exclude": ["src/**/*.spec.ts"],
+  "extends": "./tsconfig.json",
+  "include": ["src"]
+}

package/tsconfig.build.esm.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "module": "ES2022",
+    "outDir": "./dist/esm",
+    "target": "ES2022"
+  },
+  "exclude": ["src/**/*.spec.ts"],
+  "extends": "./tsconfig.json",
+  "include": ["src"]
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "outDir": "dist",
+    "sourceMap": true
+  },
+  "exclude": [".yarn/**/*", "dist", "node_modules"],
+  "extends": "@xylabs/tsconfig"
+}

package/tsconfig.test.json

@@ -0,0 +1,5 @@
+{
+  "exclude": ["dist/**/*"],
+  "extends": "@xylabs/tsconfig-dom",
+  "include": ["**/*.spec.ts"]
+}