@thangnv-dev/context-common 0.0.1

package/dist/context.d.ts

@@ -0,0 +1,24 @@
+import 'temporal-polyfill/global';
+export type ContextKey<T = unknown> = symbol & {
+    readonly __contextValue?: T;
+};
+export declare class Context {
+    private static readonly backgroundController;
+    private static readonly backgroundContext;
+    readonly parent: Context | null;
+    readonly signal: AbortSignal;
+    readonly abortSignal: AbortSignal;
+    private readonly valueSlot;
+    private constructor();
+    static background(): Context;
+    static todo(): Context;
+    static createKey<T = unknown>(description?: string): ContextKey<T>;
+    withValue<T>(key: ContextKey<T> | symbol | string, valueData: T): Context;
+    value<T>(key: ContextKey<T> | symbol | string): T | undefined;
+    withSignal(nextSignal: AbortSignal): Context;
+    withTimeout(durationInput: Temporal.Duration): Context;
+    done(): AbortSignal;
+    err(): unknown | null;
+    throwIfCanceled(): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAA;AAGjC,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAmB9E,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAwB;IACpE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAIxC;IAED,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,OAAO;IAOP,MAAM,CAAC,UAAU,IAAI,OAAO;IAI5B,MAAM,CAAC,IAAI,IAAI,OAAO;IAItB,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,WAAW,SAAgB,GAAG,UAAU,CAAC,CAAC,CAAC;IAIzE,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO;IAOzE,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;IAe7D,UAAU,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO;IAsC5C,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO;IAWtD,IAAI,IAAI,WAAW;IAInB,GAAG,IAAI,OAAO,GAAG,IAAI;IAOrB,eAAe,IAAI,IAAI;CAMxB"}

package/dist/context.js

@@ -0,0 +1,111 @@
+import 'temporal-polyfill/global';
+import { ContextCanceledError } from './errors.js';
+function durationToTimeoutMs(duration) {
+    const totalMilliseconds = duration.total({ unit: 'milliseconds' });
+    if (!Number.isFinite(totalMilliseconds)) {
+        throw new TypeError('duration must resolve to a finite number of milliseconds');
+    }
+    return Math.min(2_147_483_647, Math.max(0, Math.ceil(totalMilliseconds)));
+}
+function getAbortReason(signal) {
+    return signal.reason ?? new ContextCanceledError();
+}
+export class Context {
+    static backgroundController = new AbortController();
+    static backgroundContext = new Context(null, Context.backgroundController.signal, null);
+    parent;
+    signal;
+    abortSignal;
+    valueSlot;
+    constructor(parent, signal, valueSlot) {
+        this.parent = parent;
+        this.signal = signal;
+        this.abortSignal = signal;
+        this.valueSlot = valueSlot;
+    }
+    static background() {
+        return Context.backgroundContext;
+    }
+    static todo() {
+        return Context.backgroundContext;
+    }
+    static createKey(description = 'context-key') {
+        return Symbol(description);
+    }
+    withValue(key, valueData) {
+        if (key === undefined || key === null) {
+            throw new TypeError('key must not be null or undefined');
+        }
+        return new Context(this, this.signal, { key, data: valueData });
+    }
+    value(key) {
+        if (this.valueSlot && this.valueSlot.key === key) {
+            return this.valueSlot.data;
+        }
+        let current = this.parent;
+        while (current !== null) {
+            if (current.valueSlot && current.valueSlot.key === key) {
+                return current.valueSlot.data;
+            }
+            current = current.parent;
+        }
+        return undefined;
+    }
+    withSignal(nextSignal) {
+        const controller = new AbortController();
+        const onParentAbort = () => {
+            if (!controller.signal.aborted) {
+                controller.abort(getAbortReason(this.signal));
+            }
+        };
+        const onSignalAbort = () => {
+            if (!controller.signal.aborted) {
+                controller.abort(getAbortReason(nextSignal));
+            }
+        };
+        if (this.signal.aborted) {
+            onParentAbort();
+        }
+        else {
+            this.signal.addEventListener('abort', onParentAbort, { once: true });
+        }
+        if (!controller.signal.aborted) {
+            if (nextSignal.aborted) {
+                onSignalAbort();
+            }
+            else {
+                nextSignal.addEventListener('abort', onSignalAbort, { once: true });
+            }
+        }
+        const cleanup = () => {
+            this.signal.removeEventListener('abort', onParentAbort);
+            nextSignal.removeEventListener('abort', onSignalAbort);
+        };
+        controller.signal.addEventListener('abort', cleanup, { once: true });
+        return new Context(this, controller.signal, null);
+    }
+    withTimeout(durationInput) {
+        const duration = Temporal.Duration.from(durationInput);
+        if (duration.sign < 0) {
+            throw new TypeError('duration must not be negative');
+        }
+        const timeoutMs = durationToTimeoutMs(duration);
+        return this.withSignal(AbortSignal.timeout(timeoutMs));
+    }
+    done() {
+        return this.signal;
+    }
+    err() {
+        if (!this.signal.aborted) {
+            return null;
+        }
+        return this.signal.reason ?? new ContextCanceledError();
+    }
+    throwIfCanceled() {
+        const currentError = this.err();
+        if (currentError) {
+            throw currentError;
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+import { StandardError } from '@thangnv-dev/error-common';
+export declare class ContextCanceledError extends StandardError {
+    constructor(message?: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAIzD,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,SAAqB,EAAE,KAAK,CAAC,EAAE,OAAO;CAS1D"}

package/dist/errors.js

@@ -0,0 +1,14 @@
+import { StandardError } from '@thangnv-dev/error-common';
+const CONTEXT_PACKAGE = '@thangnv-dev/context-common';
+export class ContextCanceledError extends StandardError {
+    constructor(message = 'context canceled', cause) {
+        super({
+            package: CONTEXT_PACKAGE,
+            code: 'CONTEXT_CANCELED',
+            cause,
+            message,
+        });
+        this.name = 'ContextCanceledError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,eAAe,GAAG,6BAA6B,CAAA;AAErD,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAO,GAAG,kBAAkB,EAAE,KAAe;QACvD,KAAK,CAAC;YACJ,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,kBAAkB;YACxB,KAAK;YACL,OAAO;SACR,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Context } from './context.js';
+export { ContextCanceledError } from './errors.js';
+export type { ContextKey } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Context } from './context.js';
+export { ContextCanceledError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@thangnv-dev/context-common",
+  "version": "0.0.1",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@thangnv-dev/error-common": "workspace:^"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^10.0.0",
+    "temporal-polyfill": "^0.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "temporal-polyfill": "*"
+  }
+}