@liteguard/liteguard-node 0.2.20260314

package/README.md

@@ -0,0 +1,50 @@
+# @liteguard/liteguard-node
+
+[![JavaScript SDK](https://github.com/liteguard/liteguard/actions/workflows/test-js.yml/badge.svg)](https://github.com/liteguard/liteguard/actions/workflows/test-js.yml)
+[![npm](https://img.shields.io/npm/v/@liteguard/liteguard-node)](https://www.npmjs.com/package/@liteguard/liteguard-node)
+
+Liteguard for Node.js.
+
+## Installation
+
+```bash
+npm install @liteguard/liteguard-node
+```
+
+## Quick Start
+
+```ts
+import { LiteguardClient } from "@liteguard/liteguard-node";
+
+const client = await LiteguardClient.create("pckid-...", {
+  environment: "production",
+});
+
+const scope = client.createScope({ userId: "user-123", plan: "pro" });
+
+if (scope.isOpen("payments.checkout")) {
+  // ...
+}
+
+await client.shutdown();
+```
+
+## Primary API
+
+- `LiteguardClient.create()` creates and starts a client.
+- `client.createScope()` creates an immutable scope.
+- `scope.isOpen()` evaluates locally.
+- `scope.executeIfOpen()` and `scope.executeIfOpenAsync()` measure guarded work.
+- `scope.withProperties()` and `scope.withProtectedContext()` derive child scopes.
+- `client.flush()` flushes buffered telemetry.
+- `client.shutdown()` flushes and stops background work.
+
+## Notes
+
+- Evaluation is local after the initial bundle fetch.
+- Prefer explicit client and scope usage.
+- Unadopted guards default open and emit no signals.
+
+## License
+
+Apache 2.0 — see [LICENSE](https://github.com/liteguard/liteguard/blob/main/LICENSE).

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+import { BaseLiteguardClient, ClientOptions } from '@liteguard/core';
+export { ClientOptions, FlushOptions, GetGuardsRequest, GetGuardsResponse, Guard, GuardCheckPerformance, GuardExecutionPerformance, LiteguardChangeListener, LiteguardScope, Operator, Options, Properties, PropertyValue, ProtectedContext, Rule, ScopedOptions, SendUnadoptedGuardsRequest, SendUnadoptedGuardsResponse, Signal, SignalPerformance, TraceContext, evaluateGuard } from '@liteguard/core';
+
+/**
+ * Liteguard client for Node.js environments.
+ *
+ * Uses `AsyncLocalStorage` for per-request scope propagation and
+ * `process.hrtime` / `process.memoryUsage` for performance measurement.
+ *
+ * @example
+ * ```ts
+ * import { LiteguardClient } from '@liteguard/liteguard-node';
+ *
+ * const client = new LiteguardClient('pk_live_...');
+ * await client.start();
+ *
+ * if (client.isOpen('feature.beta')) {
+ *   // new code path
+ * }
+ * ```
+ */
+declare class LiteguardClient extends BaseLiteguardClient {
+    /**
+     * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.
+     * @param options - Optional SDK configuration overrides.
+     */
+    constructor(projectClientKeyId: string, options?: ClientOptions);
+}
+
+export { LiteguardClient };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { BaseLiteguardClient, ClientOptions } from '@liteguard/core';
+export { ClientOptions, FlushOptions, GetGuardsRequest, GetGuardsResponse, Guard, GuardCheckPerformance, GuardExecutionPerformance, LiteguardChangeListener, LiteguardScope, Operator, Options, Properties, PropertyValue, ProtectedContext, Rule, ScopedOptions, SendUnadoptedGuardsRequest, SendUnadoptedGuardsResponse, Signal, SignalPerformance, TraceContext, evaluateGuard } from '@liteguard/core';
+
+/**
+ * Liteguard client for Node.js environments.
+ *
+ * Uses `AsyncLocalStorage` for per-request scope propagation and
+ * `process.hrtime` / `process.memoryUsage` for performance measurement.
+ *
+ * @example
+ * ```ts
+ * import { LiteguardClient } from '@liteguard/liteguard-node';
+ *
+ * const client = new LiteguardClient('pk_live_...');
+ * await client.start();
+ *
+ * if (client.isOpen('feature.beta')) {
+ *   // new code path
+ * }
+ * ```
+ */
+declare class LiteguardClient extends BaseLiteguardClient {
+    /**
+     * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.
+     * @param options - Optional SDK configuration overrides.
+     */
+    constructor(projectClientKeyId: string, options?: ClientOptions);
+}
+
+export { LiteguardClient };

package/dist/index.js

@@ -0,0 +1,128 @@
+"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, {
+  LiteguardClient: () => LiteguardClient,
+  evaluateGuard: () => import_core2.evaluateGuard
+});
+module.exports = __toCommonJS(index_exports);
+var import_core2 = require("@liteguard/core");
+
+// src/client.ts
+var import_core = require("@liteguard/core");
+
+// src/runtime.ts
+var import_node_async_hooks = require("async_hooks");
+var executionStorage = new import_node_async_hooks.AsyncLocalStorage();
+var requestScopeStorage = new import_node_async_hooks.AsyncLocalStorage();
+var executionAdapter = {
+  /** Return the current execution context for correlated signal emission. */
+  getStore() {
+    return executionStorage.getStore();
+  },
+  /** Run a callback inside a new correlated execution context. */
+  run(initialState, fn) {
+    return executionStorage.run(initialState, fn);
+  }
+};
+var requestScopeAdapter = {
+  /** Return the current request-scope context for this async call chain. */
+  getStore() {
+    return requestScopeStorage.getStore();
+  },
+  /** Run a callback with a request scope bound to the current async chain. */
+  run(initialState, fn) {
+    return requestScopeStorage.run(initialState, fn);
+  }
+};
+var measurementAdapter = {
+  /** Capture a high-resolution start time for a guarded execution. */
+  beginGuardExecution() {
+    return process.hrtime.bigint();
+  },
+  /** Capture point-in-time runtime metrics for a `guard_check` signal. */
+  captureGuardCheck() {
+    const memoryUsage = process.memoryUsage();
+    const cpuUsage = process.cpuUsage();
+    return {
+      guardCheck: {
+        rssBytes: memoryUsage.rss,
+        heapUsedBytes: memoryUsage.heapUsed,
+        heapTotalBytes: memoryUsage.heapTotal,
+        cpuTimeNs: (cpuUsage.user + cpuUsage.system) * 1e3
+      }
+    };
+  },
+  /** Capture completion metrics for a guarded code path on Node.js. */
+  captureGuardExecution(startToken, completed, error) {
+    const start = typeof startToken === "bigint" ? startToken : process.hrtime.bigint();
+    const memoryUsage = process.memoryUsage();
+    const cpuUsage = process.cpuUsage();
+    const durationNs = Number(process.hrtime.bigint() - start);
+    return {
+      guardExecution: {
+        durationNs,
+        rssEndBytes: memoryUsage.rss,
+        heapUsedEndBytes: memoryUsage.heapUsed,
+        heapTotalEndBytes: memoryUsage.heapTotal,
+        cpuTimeEndNs: (cpuUsage.user + cpuUsage.system) * 1e3,
+        completed,
+        ...error && error instanceof Error && error.name ? { errorClass: error.name } : {}
+      }
+    };
+  }
+};
+var nodeRuntime = {
+  name: "node",
+  supportsAsyncContextPropagation: true,
+  internalStackMarkers: ["/packages/core/src/", "/packages/liteguard-node/src/", "/sdk/js/packages/"],
+  execution: executionAdapter,
+  requestScope: requestScopeAdapter,
+  measurement: measurementAdapter,
+  now: () => Date.now(),
+  monotonicNow: () => performance.now(),
+  fetch: (input, init) => globalThis.fetch(input, init),
+  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),
+  clearTimeout: (handle) => globalThis.clearTimeout(handle),
+  setInterval: (callback, ms) => globalThis.setInterval(callback, ms),
+  clearInterval: (handle) => globalThis.clearInterval(handle),
+  detachTimer: (handle) => {
+    const maybeTimer = handle;
+    maybeTimer.unref?.();
+  }
+};
+
+// src/client.ts
+var LiteguardClient = class extends import_core.BaseLiteguardClient {
+  /**
+   * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.
+   * @param options - Optional SDK configuration overrides.
+   */
+  constructor(projectClientKeyId, options = {}) {
+    super(nodeRuntime, projectClientKeyId, options);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LiteguardClient,
+  evaluateGuard
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/runtime.ts"],"sourcesContent":["export type {\n  GetGuardsRequest,\n  GetGuardsResponse,\n  Guard,\n  GuardCheckPerformance,\n  GuardExecutionPerformance,\n  ClientOptions,\n  FlushOptions,\n  LiteguardChangeListener,\n  LiteguardScope,\n  Options,\n  Operator,\n  Properties,\n  PropertyValue,\n  ProtectedContext,\n  Rule,\n  SendUnadoptedGuardsRequest,\n  SendUnadoptedGuardsResponse,\n  Signal,\n  SignalPerformance,\n  ScopedOptions,\n  TraceContext,\n} from '@liteguard/core';\nexport { evaluateGuard } from '@liteguard/core';\nexport { LiteguardClient } from './client.js';\n","import { BaseLiteguardClient } from '@liteguard/core';\nimport type { ClientOptions } from '@liteguard/core';\nimport { nodeRuntime } from './runtime.js';\n\n/**\n * Liteguard client for Node.js environments.\n *\n * Uses `AsyncLocalStorage` for per-request scope propagation and\n * `process.hrtime` / `process.memoryUsage` for performance measurement.\n *\n * @example\n * ```ts\n * import { LiteguardClient } from '@liteguard/liteguard-node';\n *\n * const client = new LiteguardClient('pk_live_...');\n * await client.start();\n *\n * if (client.isOpen('feature.beta')) {\n *   // new code path\n * }\n * ```\n */\nexport class LiteguardClient extends BaseLiteguardClient {\n  /**\n   * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.\n   * @param options - Optional SDK configuration overrides.\n   */\n  constructor(projectClientKeyId: string, options: ClientOptions = {}) {\n    super(nodeRuntime, projectClientKeyId, options);\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type {\n  ExecutionAdapter,\n  ExecutionState,\n  MeasurementAdapter,\n  RequestScopeAdapter,\n  RequestScopeStore,\n  RuntimeAdapter,\n  Signal,\n} from '@liteguard/core';\n\nconst executionStorage = new AsyncLocalStorage<ExecutionState>();\nconst requestScopeStorage = new AsyncLocalStorage<RequestScopeStore>();\n\nconst executionAdapter: ExecutionAdapter = {\n  /** Return the current execution context for correlated signal emission. */\n  getStore(): ExecutionState | undefined {\n    return executionStorage.getStore();\n  },\n  /** Run a callback inside a new correlated execution context. */\n  run<T>(initialState: ExecutionState, fn: () => T): T {\n    return executionStorage.run(initialState, fn);\n  },\n};\n\nconst requestScopeAdapter: RequestScopeAdapter = {\n  /** Return the current request-scope context for this async call chain. */\n  getStore(): RequestScopeStore | undefined {\n    return requestScopeStorage.getStore();\n  },\n  /** Run a callback with a request scope bound to the current async chain. */\n  run<T>(initialState: RequestScopeStore, fn: () => T): T {\n    return requestScopeStorage.run(initialState, fn);\n  },\n};\n\nconst measurementAdapter: MeasurementAdapter = {\n  /** Capture a high-resolution start time for a guarded execution. */\n  beginGuardExecution(): bigint {\n    return process.hrtime.bigint();\n  },\n  /** Capture point-in-time runtime metrics for a `guard_check` signal. */\n  captureGuardCheck(): NonNullable<Signal['measurement']> {\n    const memoryUsage = process.memoryUsage();\n    const cpuUsage = process.cpuUsage();\n    return {\n      guardCheck: {\n        rssBytes: memoryUsage.rss,\n        heapUsedBytes: memoryUsage.heapUsed,\n        heapTotalBytes: memoryUsage.heapTotal,\n        cpuTimeNs: (cpuUsage.user + cpuUsage.system) * 1_000,\n      },\n    };\n  },\n  /** Capture completion metrics for a guarded code path on Node.js. */\n  captureGuardExecution(startToken: unknown, completed: boolean, error?: unknown): NonNullable<Signal['measurement']> {\n    const start = typeof startToken === 'bigint' ? startToken : process.hrtime.bigint();\n    const memoryUsage = process.memoryUsage();\n    const cpuUsage = process.cpuUsage();\n    const durationNs = Number(process.hrtime.bigint() - start);\n    return {\n      guardExecution: {\n        durationNs,\n        rssEndBytes: memoryUsage.rss,\n        heapUsedEndBytes: memoryUsage.heapUsed,\n        heapTotalEndBytes: memoryUsage.heapTotal,\n        cpuTimeEndNs: (cpuUsage.user + cpuUsage.system) * 1_000,\n        completed,\n        ...(error && error instanceof Error && error.name ? { errorClass: error.name } : {}),\n      },\n    };\n  },\n};\n\n/** Node.js runtime adapter used by the platform-specific Liteguard client. */\nexport const nodeRuntime: RuntimeAdapter = {\n  name: 'node',\n  supportsAsyncContextPropagation: true,\n  internalStackMarkers: ['/packages/core/src/', '/packages/liteguard-node/src/', '/sdk/js/packages/'],\n  execution: executionAdapter,\n  requestScope: requestScopeAdapter,\n  measurement: measurementAdapter,\n  now: () => Date.now(),\n  monotonicNow: () => performance.now(),\n  fetch: (input, init) => globalThis.fetch(input, init),\n  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n  clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n  setInterval: (callback, ms) => globalThis.setInterval(callback, ms),\n  clearInterval: (handle) => globalThis.clearInterval(handle as ReturnType<typeof setInterval>),\n  detachTimer: (handle) => {\n    const maybeTimer = handle as { unref?: () => void };\n    maybeTimer.unref?.();\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBA,IAAAA,eAA8B;;;ACvB9B,kBAAoC;;;ACApC,8BAAkC;AAWlC,IAAM,mBAAmB,IAAI,0CAAkC;AAC/D,IAAM,sBAAsB,IAAI,0CAAqC;AAErE,IAAM,mBAAqC;AAAA;AAAA,EAEzC,WAAuC;AACrC,WAAO,iBAAiB,SAAS;AAAA,EACnC;AAAA;AAAA,EAEA,IAAO,cAA8B,IAAgB;AACnD,WAAO,iBAAiB,IAAI,cAAc,EAAE;AAAA,EAC9C;AACF;AAEA,IAAM,sBAA2C;AAAA;AAAA,EAE/C,WAA0C;AACxC,WAAO,oBAAoB,SAAS;AAAA,EACtC;AAAA;AAAA,EAEA,IAAO,cAAiC,IAAgB;AACtD,WAAO,oBAAoB,IAAI,cAAc,EAAE;AAAA,EACjD;AACF;AAEA,IAAM,qBAAyC;AAAA;AAAA,EAE7C,sBAA8B;AAC5B,WAAO,QAAQ,OAAO,OAAO;AAAA,EAC/B;AAAA;AAAA,EAEA,oBAAwD;AACtD,UAAM,cAAc,QAAQ,YAAY;AACxC,UAAM,WAAW,QAAQ,SAAS;AAClC,WAAO;AAAA,MACL,YAAY;AAAA,QACV,UAAU,YAAY;AAAA,QACtB,eAAe,YAAY;AAAA,QAC3B,gBAAgB,YAAY;AAAA,QAC5B,YAAY,SAAS,OAAO,SAAS,UAAU;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAEA,sBAAsB,YAAqB,WAAoB,OAAqD;AAClH,UAAM,QAAQ,OAAO,eAAe,WAAW,aAAa,QAAQ,OAAO,OAAO;AAClF,UAAM,cAAc,QAAQ,YAAY;AACxC,UAAM,WAAW,QAAQ,SAAS;AAClC,UAAM,aAAa,OAAO,QAAQ,OAAO,OAAO,IAAI,KAAK;AACzD,WAAO;AAAA,MACL,gBAAgB;AAAA,QACd;AAAA,QACA,aAAa,YAAY;AAAA,QACzB,kBAAkB,YAAY;AAAA,QAC9B,mBAAmB,YAAY;AAAA,QAC/B,eAAe,SAAS,OAAO,SAAS,UAAU;AAAA,QAClD;AAAA,QACA,GAAI,SAAS,iBAAiB,SAAS,MAAM,OAAO,EAAE,YAAY,MAAM,KAAK,IAAI,CAAC;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,cAA8B;AAAA,EACzC,MAAM;AAAA,EACN,iCAAiC;AAAA,EACjC,sBAAsB,CAAC,uBAAuB,iCAAiC,mBAAmB;AAAA,EAClG,WAAW;AAAA,EACX,cAAc;AAAA,EACd,aAAa;AAAA,EACb,KAAK,MAAM,KAAK,IAAI;AAAA,EACpB,cAAc,MAAM,YAAY,IAAI;AAAA,EACpC,OAAO,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,EACpD,YAAY,CAAC,UAAU,OAAO,WAAW,WAAW,UAAU,EAAE;AAAA,EAChE,cAAc,CAAC,WAAW,WAAW,aAAa,MAAuC;AAAA,EACzF,aAAa,CAAC,UAAU,OAAO,WAAW,YAAY,UAAU,EAAE;AAAA,EAClE,eAAe,CAAC,WAAW,WAAW,cAAc,MAAwC;AAAA,EAC5F,aAAa,CAAC,WAAW;AACvB,UAAM,aAAa;AACnB,eAAW,QAAQ;AAAA,EACrB;AACF;;;ADvEO,IAAM,kBAAN,cAA8B,gCAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKvD,YAAY,oBAA4B,UAAyB,CAAC,GAAG;AACnE,UAAM,aAAa,oBAAoB,OAAO;AAAA,EAChD;AACF;","names":["import_core"]}

package/dist/index.mjs

@@ -0,0 +1,102 @@
+// src/index.ts
+import { evaluateGuard } from "@liteguard/core";
+
+// src/client.ts
+import { BaseLiteguardClient } from "@liteguard/core";
+
+// src/runtime.ts
+import { AsyncLocalStorage } from "async_hooks";
+var executionStorage = new AsyncLocalStorage();
+var requestScopeStorage = new AsyncLocalStorage();
+var executionAdapter = {
+  /** Return the current execution context for correlated signal emission. */
+  getStore() {
+    return executionStorage.getStore();
+  },
+  /** Run a callback inside a new correlated execution context. */
+  run(initialState, fn) {
+    return executionStorage.run(initialState, fn);
+  }
+};
+var requestScopeAdapter = {
+  /** Return the current request-scope context for this async call chain. */
+  getStore() {
+    return requestScopeStorage.getStore();
+  },
+  /** Run a callback with a request scope bound to the current async chain. */
+  run(initialState, fn) {
+    return requestScopeStorage.run(initialState, fn);
+  }
+};
+var measurementAdapter = {
+  /** Capture a high-resolution start time for a guarded execution. */
+  beginGuardExecution() {
+    return process.hrtime.bigint();
+  },
+  /** Capture point-in-time runtime metrics for a `guard_check` signal. */
+  captureGuardCheck() {
+    const memoryUsage = process.memoryUsage();
+    const cpuUsage = process.cpuUsage();
+    return {
+      guardCheck: {
+        rssBytes: memoryUsage.rss,
+        heapUsedBytes: memoryUsage.heapUsed,
+        heapTotalBytes: memoryUsage.heapTotal,
+        cpuTimeNs: (cpuUsage.user + cpuUsage.system) * 1e3
+      }
+    };
+  },
+  /** Capture completion metrics for a guarded code path on Node.js. */
+  captureGuardExecution(startToken, completed, error) {
+    const start = typeof startToken === "bigint" ? startToken : process.hrtime.bigint();
+    const memoryUsage = process.memoryUsage();
+    const cpuUsage = process.cpuUsage();
+    const durationNs = Number(process.hrtime.bigint() - start);
+    return {
+      guardExecution: {
+        durationNs,
+        rssEndBytes: memoryUsage.rss,
+        heapUsedEndBytes: memoryUsage.heapUsed,
+        heapTotalEndBytes: memoryUsage.heapTotal,
+        cpuTimeEndNs: (cpuUsage.user + cpuUsage.system) * 1e3,
+        completed,
+        ...error && error instanceof Error && error.name ? { errorClass: error.name } : {}
+      }
+    };
+  }
+};
+var nodeRuntime = {
+  name: "node",
+  supportsAsyncContextPropagation: true,
+  internalStackMarkers: ["/packages/core/src/", "/packages/liteguard-node/src/", "/sdk/js/packages/"],
+  execution: executionAdapter,
+  requestScope: requestScopeAdapter,
+  measurement: measurementAdapter,
+  now: () => Date.now(),
+  monotonicNow: () => performance.now(),
+  fetch: (input, init) => globalThis.fetch(input, init),
+  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),
+  clearTimeout: (handle) => globalThis.clearTimeout(handle),
+  setInterval: (callback, ms) => globalThis.setInterval(callback, ms),
+  clearInterval: (handle) => globalThis.clearInterval(handle),
+  detachTimer: (handle) => {
+    const maybeTimer = handle;
+    maybeTimer.unref?.();
+  }
+};
+
+// src/client.ts
+var LiteguardClient = class extends BaseLiteguardClient {
+  /**
+   * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.
+   * @param options - Optional SDK configuration overrides.
+   */
+  constructor(projectClientKeyId, options = {}) {
+    super(nodeRuntime, projectClientKeyId, options);
+  }
+};
+export {
+  LiteguardClient,
+  evaluateGuard
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/runtime.ts"],"sourcesContent":["export type {\n  GetGuardsRequest,\n  GetGuardsResponse,\n  Guard,\n  GuardCheckPerformance,\n  GuardExecutionPerformance,\n  ClientOptions,\n  FlushOptions,\n  LiteguardChangeListener,\n  LiteguardScope,\n  Options,\n  Operator,\n  Properties,\n  PropertyValue,\n  ProtectedContext,\n  Rule,\n  SendUnadoptedGuardsRequest,\n  SendUnadoptedGuardsResponse,\n  Signal,\n  SignalPerformance,\n  ScopedOptions,\n  TraceContext,\n} from '@liteguard/core';\nexport { evaluateGuard } from '@liteguard/core';\nexport { LiteguardClient } from './client.js';\n","import { BaseLiteguardClient } from '@liteguard/core';\nimport type { ClientOptions } from '@liteguard/core';\nimport { nodeRuntime } from './runtime.js';\n\n/**\n * Liteguard client for Node.js environments.\n *\n * Uses `AsyncLocalStorage` for per-request scope propagation and\n * `process.hrtime` / `process.memoryUsage` for performance measurement.\n *\n * @example\n * ```ts\n * import { LiteguardClient } from '@liteguard/liteguard-node';\n *\n * const client = new LiteguardClient('pk_live_...');\n * await client.start();\n *\n * if (client.isOpen('feature.beta')) {\n *   // new code path\n * }\n * ```\n */\nexport class LiteguardClient extends BaseLiteguardClient {\n  /**\n   * @param projectClientKeyId - Your project client key ID from the Liteguard dashboard.\n   * @param options - Optional SDK configuration overrides.\n   */\n  constructor(projectClientKeyId: string, options: ClientOptions = {}) {\n    super(nodeRuntime, projectClientKeyId, options);\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type {\n  ExecutionAdapter,\n  ExecutionState,\n  MeasurementAdapter,\n  RequestScopeAdapter,\n  RequestScopeStore,\n  RuntimeAdapter,\n  Signal,\n} from '@liteguard/core';\n\nconst executionStorage = new AsyncLocalStorage<ExecutionState>();\nconst requestScopeStorage = new AsyncLocalStorage<RequestScopeStore>();\n\nconst executionAdapter: ExecutionAdapter = {\n  /** Return the current execution context for correlated signal emission. */\n  getStore(): ExecutionState | undefined {\n    return executionStorage.getStore();\n  },\n  /** Run a callback inside a new correlated execution context. */\n  run<T>(initialState: ExecutionState, fn: () => T): T {\n    return executionStorage.run(initialState, fn);\n  },\n};\n\nconst requestScopeAdapter: RequestScopeAdapter = {\n  /** Return the current request-scope context for this async call chain. */\n  getStore(): RequestScopeStore | undefined {\n    return requestScopeStorage.getStore();\n  },\n  /** Run a callback with a request scope bound to the current async chain. */\n  run<T>(initialState: RequestScopeStore, fn: () => T): T {\n    return requestScopeStorage.run(initialState, fn);\n  },\n};\n\nconst measurementAdapter: MeasurementAdapter = {\n  /** Capture a high-resolution start time for a guarded execution. */\n  beginGuardExecution(): bigint {\n    return process.hrtime.bigint();\n  },\n  /** Capture point-in-time runtime metrics for a `guard_check` signal. */\n  captureGuardCheck(): NonNullable<Signal['measurement']> {\n    const memoryUsage = process.memoryUsage();\n    const cpuUsage = process.cpuUsage();\n    return {\n      guardCheck: {\n        rssBytes: memoryUsage.rss,\n        heapUsedBytes: memoryUsage.heapUsed,\n        heapTotalBytes: memoryUsage.heapTotal,\n        cpuTimeNs: (cpuUsage.user + cpuUsage.system) * 1_000,\n      },\n    };\n  },\n  /** Capture completion metrics for a guarded code path on Node.js. */\n  captureGuardExecution(startToken: unknown, completed: boolean, error?: unknown): NonNullable<Signal['measurement']> {\n    const start = typeof startToken === 'bigint' ? startToken : process.hrtime.bigint();\n    const memoryUsage = process.memoryUsage();\n    const cpuUsage = process.cpuUsage();\n    const durationNs = Number(process.hrtime.bigint() - start);\n    return {\n      guardExecution: {\n        durationNs,\n        rssEndBytes: memoryUsage.rss,\n        heapUsedEndBytes: memoryUsage.heapUsed,\n        heapTotalEndBytes: memoryUsage.heapTotal,\n        cpuTimeEndNs: (cpuUsage.user + cpuUsage.system) * 1_000,\n        completed,\n        ...(error && error instanceof Error && error.name ? { errorClass: error.name } : {}),\n      },\n    };\n  },\n};\n\n/** Node.js runtime adapter used by the platform-specific Liteguard client. */\nexport const nodeRuntime: RuntimeAdapter = {\n  name: 'node',\n  supportsAsyncContextPropagation: true,\n  internalStackMarkers: ['/packages/core/src/', '/packages/liteguard-node/src/', '/sdk/js/packages/'],\n  execution: executionAdapter,\n  requestScope: requestScopeAdapter,\n  measurement: measurementAdapter,\n  now: () => Date.now(),\n  monotonicNow: () => performance.now(),\n  fetch: (input, init) => globalThis.fetch(input, init),\n  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n  clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n  setInterval: (callback, ms) => globalThis.setInterval(callback, ms),\n  clearInterval: (handle) => globalThis.clearInterval(handle as ReturnType<typeof setInterval>),\n  detachTimer: (handle) => {\n    const maybeTimer = handle as { unref?: () => void };\n    maybeTimer.unref?.();\n  },\n};\n"],"mappings":";AAuBA,SAAS,qBAAqB;;;ACvB9B,SAAS,2BAA2B;;;ACApC,SAAS,yBAAyB;AAWlC,IAAM,mBAAmB,IAAI,kBAAkC;AAC/D,IAAM,sBAAsB,IAAI,kBAAqC;AAErE,IAAM,mBAAqC;AAAA;AAAA,EAEzC,WAAuC;AACrC,WAAO,iBAAiB,SAAS;AAAA,EACnC;AAAA;AAAA,EAEA,IAAO,cAA8B,IAAgB;AACnD,WAAO,iBAAiB,IAAI,cAAc,EAAE;AAAA,EAC9C;AACF;AAEA,IAAM,sBAA2C;AAAA;AAAA,EAE/C,WAA0C;AACxC,WAAO,oBAAoB,SAAS;AAAA,EACtC;AAAA;AAAA,EAEA,IAAO,cAAiC,IAAgB;AACtD,WAAO,oBAAoB,IAAI,cAAc,EAAE;AAAA,EACjD;AACF;AAEA,IAAM,qBAAyC;AAAA;AAAA,EAE7C,sBAA8B;AAC5B,WAAO,QAAQ,OAAO,OAAO;AAAA,EAC/B;AAAA;AAAA,EAEA,oBAAwD;AACtD,UAAM,cAAc,QAAQ,YAAY;AACxC,UAAM,WAAW,QAAQ,SAAS;AAClC,WAAO;AAAA,MACL,YAAY;AAAA,QACV,UAAU,YAAY;AAAA,QACtB,eAAe,YAAY;AAAA,QAC3B,gBAAgB,YAAY;AAAA,QAC5B,YAAY,SAAS,OAAO,SAAS,UAAU;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAEA,sBAAsB,YAAqB,WAAoB,OAAqD;AAClH,UAAM,QAAQ,OAAO,eAAe,WAAW,aAAa,QAAQ,OAAO,OAAO;AAClF,UAAM,cAAc,QAAQ,YAAY;AACxC,UAAM,WAAW,QAAQ,SAAS;AAClC,UAAM,aAAa,OAAO,QAAQ,OAAO,OAAO,IAAI,KAAK;AACzD,WAAO;AAAA,MACL,gBAAgB;AAAA,QACd;AAAA,QACA,aAAa,YAAY;AAAA,QACzB,kBAAkB,YAAY;AAAA,QAC9B,mBAAmB,YAAY;AAAA,QAC/B,eAAe,SAAS,OAAO,SAAS,UAAU;AAAA,QAClD;AAAA,QACA,GAAI,SAAS,iBAAiB,SAAS,MAAM,OAAO,EAAE,YAAY,MAAM,KAAK,IAAI,CAAC;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,cAA8B;AAAA,EACzC,MAAM;AAAA,EACN,iCAAiC;AAAA,EACjC,sBAAsB,CAAC,uBAAuB,iCAAiC,mBAAmB;AAAA,EAClG,WAAW;AAAA,EACX,cAAc;AAAA,EACd,aAAa;AAAA,EACb,KAAK,MAAM,KAAK,IAAI;AAAA,EACpB,cAAc,MAAM,YAAY,IAAI;AAAA,EACpC,OAAO,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,EACpD,YAAY,CAAC,UAAU,OAAO,WAAW,WAAW,UAAU,EAAE;AAAA,EAChE,cAAc,CAAC,WAAW,WAAW,aAAa,MAAuC;AAAA,EACzF,aAAa,CAAC,UAAU,OAAO,WAAW,YAAY,UAAU,EAAE;AAAA,EAClE,eAAe,CAAC,WAAW,WAAW,cAAc,MAAwC;AAAA,EAC5F,aAAa,CAAC,WAAW;AACvB,UAAM,aAAa;AACnB,eAAW,QAAQ;AAAA,EACrB;AACF;;;ADvEO,IAAM,kBAAN,cAA8B,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKvD,YAAY,oBAA4B,UAAyB,CAAC,GAAG;AACnE,UAAM,aAAa,oBAAoB,OAAO;AAAA,EAChD;AACF;","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+    "name": "@liteguard/liteguard-node",
+    "version": "0.2.20260314",
+    "description": "Liteguard SDK for Node.js runtimes — feature guards, observability, and security response evaluated locally with zero network overhead per check",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "license": "Apache-2.0",
+    "homepage": "https://liteguard.io",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/liteguard/liteguard.git",
+        "directory": "sdk/js/packages/liteguard-node"
+    },
+    "keywords": [
+        "feature-flags",
+        "feature-guards",
+        "feature-toggles",
+        "liteguard",
+        "observability",
+        "security",
+        "node"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "sideEffects": false,
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts --sourcemap --clean"
+    },
+    "dependencies": {
+        "@liteguard/core": "*"
+    }
+}