@corelicense/node 0.5.0 → 0.5.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CoreLicense
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,193 +1,83 @@
 # @corelicense/node
 
-CoreLicense Node.js SDK — runtime license và policy layer cho ứng dụng Node.js.
+Runtime license và policy layer cho ứng dụng Node.js — không chỉ middleware HTTP, mà là lớp kiểm soát **bootstrap**, **module registry**, **DI**, **worker/CLI**, **quota** và **feature gate** theo policy đã ký.
 
-> **Trạng thái:** v0.4 — tích hợp sâu (module registry & DI), production default URL, revoke handling.
+**Phiên bản:** `0.5.1`  
+**License:** [MIT](./LICENSE)  
+**Repository:** [github.com/trailanglc/corelicense](https://github.com/trailanglc/corelicense)  
+**Docs trực tuyến:** [corelicense.net/docs](https://corelicense.net/docs/nodejs-sdk/quick-start)
 
-## Triết lý
+---
 
-CoreLicense không chỉ là middleware. SDK được thiết kế như một **Runtime Layer** nằm sâu trong bootstrap, runtime config, module registry, service guard, worker/CLI guard và quota enforcement.
+## CoreLicense là gì?
 
-## Cài đặt
+CoreLicense gồm **License Server** (API Go) và **Node.js SDK** (package này). Admin cấp license key + policy (features, limits, quotas). SDK:
 
-```bash
-npm install @corelicense/node
-```
-
-Peer dependencies tùy chọn (chỉ cài khi dùng integration tương ứng):
-
-```bash
-npm install express          # Express middleware
-npm install fastify          # Fastify plugin
-npm install @nestjs/common     # NestJS module/guard
-```
-
-## Quick start
-
-Chỉ cần **2 biến môi trường**. SDK mặc định kết nối `https://api.corelicense.net` — không cần cấu hình thêm cho production.
-
-License key mới (CL1.*) vẫn ưu tiên URL nhúng trong key nếu server generate với `SDK_PUBLIC_URL` khác.
-
-```env
-CORELICENSE_KEY=CL1.xxxxx.CL-AAAAA-BBBBB-...
-CORELICENSE_PRODUCT_ID=demo
-```
-
-`CORELICENSE_PUBLIC_KEY` **optional** — pin public key (enterprise / air-gapped).
-`CORELICENSE_API_URL` **optional** — override thủ công (dev local hoặc legacy key).
-
-Dev local với server Go chạy localhost:
-
-```env
-CORELICENSE_API_URL=http://localhost:8080
-```
-
-```ts
-import express from 'express';
-import { CoreLicense, loadOptionsFromEnv } from '@corelicense/node';
+1. Kích hoạt / kiểm tra license với server
+2. Verify **policy token** bằng public key (EdDSA)
+3. Cache policy local, refresh định kỳ
+4. Chặn runtime khi revoke / suspend / expired
+5. (Tùy chọn) Chỉ bind module & service được cấp trong policy
 
-const app = express();
+---
 
-const license = new CoreLicense(loadOptionsFromEnv({
-  cachePath: './storage/corelicense',
-  instance: {
-    strategy: 'install-id-domain-hash',
-    domain: process.env.APP_DOMAIN,
-  },
-}));
+## Tài liệu
 
-async function main() {
-  await license.boot();
+| Tài liệu | Nội dung |
+|----------|----------|
+| [Cài đặt](./docs/installation.md) | `npm install`, biến môi trường, boot lần đầu, dev/prod |
+| [Tích hợp](./docs/integration.md) | **Hướng dẫn chi tiết** — Express, Fastify, NestJS, registry/DI, worker, quota, production |
+| [API Reference](./docs/api-reference.md) | Public API, options, error codes |
+| [LICENSE](./LICENSE) | MIT |
 
-  app.use(license.express({
-    allowPaths: ['/health', '/license/status'],
-  }));
+> Dành cho agent / CI: đọc [docs/integration.md](./docs/integration.md) trước khi generate code tích hợp.
 
-  app.get('/license/status', async (_req, res) => {
-    res.json(await license.getStatus());
-  });
+---
 
-  app.listen(3000);
-}
+## Quick links
 
-main().catch(console.error);
+```bash
+npm install @corelicense/node
 ```
 
-### Pin public key (optional)
+Production mặc định: `https://api.corelicense.net` — chỉ cần `CORELICENSE_KEY` + `CORELICENSE_PRODUCT_ID`.
 
 ```ts
-const license = new CoreLicense(loadOptionsFromEnv({
-  publicKey: process.env.CORELICENSE_PUBLIC_KEY, // pinned mode
-}));
-```
-
-Khi pin, SDK không fetch keys từ server. Nếu verify fail sau key rotation, cập nhật `CORELICENSE_PUBLIC_KEY` thủ công.
-
-## Public API
-
-| Method | Mô tả |
-|--------|-------|
-| `boot()` | Khởi tạo SDK, fetch/cache public keys, load cache, verify token |
-| `refresh()` | Refresh policy token từ server |
-| `requireActive()` | Yêu cầu license active |
-| `requireFeature(name)` | Kiểm tra feature flag |
-| `checkLimit(name, value)` | Kiểm tra limit |
-| `consumeQuota(name, amount?)` | Tiêu thụ quota local |
-| `getStatus()` | Trạng thái license hiện tại |
-| `getPolicy()` | Policy đang active |
-| `getRuntimeConfig()` | Runtime config cho app bootstrap |
-| `express(options?)` | Express middleware |
-| `fastifyPlugin(options?)` | Fastify plugin |
-| `guardWorker(name)` | Guard worker |
-| `guardCommand(name)` | Guard CLI/cron command |
-| `createLicensedRegistry()` | Module registry gắn license |
-| `createLicensedContainer()` | DI container gắn license |
-| `bootstrap(options?)` | Bootstrap modules + services theo policy |
-
-## Tích hợp sâu (v0.4)
+import { CoreLicense, loadOptionsFromEnv } from '@corelicense/node';
 
-```ts
+const license = new CoreLicense(loadOptionsFromEnv({ cachePath: './storage/corelicense' }));
 await license.boot();
-
-const { modules, services, skipped } = await license.bootstrap({
-  modules: [
-    { name: 'automation', feature: 'automation', factory: ({ license }) => new AutomationModule(license) },
-  ],
-  services: [
-    { name: 'ExportService', feature: 'export', factory: ({ license }) => new ExportService(license) },
-  ],
-});
-
-const automation = await modules.get<AutomationModule>('automation');
-const exportService = await services.resolve<ExportService>('ExportService');
-
-import { registerLicensedRoutes } from '@corelicense/node';
-registerLicensedRoutes(app, modules, [
-  { path: '/automation', module: 'automation', router: automationRouter },
-]);
-```
-
-`get()` và `resolve()` gọi `requireFeature` mỗi lần truy cập — revoke/suspend chặn ngay. Đổi feature trong policy vẫn cần **restart** để bind/unbind module mới.
-
-Xem [Tích hợp sâu](https://corelicense.net/docs/nodejs-sdk/deep-integration) trên docs site.
-
-## Xử lý lỗi
-
-Mọi lỗi SDK đều có `code` (mã định vị) và `source` (module SDK phát sinh):
-
-```ts
-import { isLicenseError, formatLicenseError, LicenseErrorCode } from '@corelicense/node';
-
-try {
-  await license.boot();
-} catch (error) {
-  if (isLicenseError(error)) {
-    console.error(error.code, error.source); // e.g. CONFIG_MISSING_ENV, load-options-from-env
-  }
-}
 ```
 
-Dùng `error.toJSON()` hoặc `formatLicenseError(error)` khi trả lỗi qua HTTP API.
-
-## Production deploy
+Chi tiết: [docs/installation.md](./docs/installation.md) → [docs/integration.md](./docs/integration.md).
 
-**SDK:** `cd SDK/corelicense-node && npm test && npm run build && npm publish --access public`
+---
 
-**API (Go):** deploy backend với `SDK_PUBLIC_URL=https://api.corelicense.net`, policy signer configured, và `APP_ENV=production`. Production validate yêu cầu HTTPS URL (không localhost) và secrets không dùng `change-me`.
+## Subpath exports
 
-## Cấu trúc module
-
-```txt
-src/
-  core-license.ts       # Class chính
-  types/                # TypeScript interfaces
-  errors/               # Error hierarchy
-  crypto/               # Policy token verification + public key resolver
-  client/               # License API + public keys client
-  cache/                # File/memory cache
-  instance/             # Instance ID resolution
-  guards/               # Express, Fastify, NestJS, worker, CLI
-  runtime/              # Runtime config, module registry, DI container
-  audit/                # Local audit log
-  events/               # Event bus
-```
+| Import | Mục đích |
+|--------|----------|
+| `@corelicense/node` | Core API |
+| `@corelicense/node/express` | Express middleware |
+| `@corelicense/node/fastify` | Fastify plugin |
+| `@corelicense/node/nestjs` | NestJS module, guards, filter |
 
-## Tài liệu thiết kế
+---
 
-Xem [CoreLicense Node.js SDK — Tài liệu thiết kế & tích hợp sâu](../../docs/CoreLicense_NodeJS_SDK_Deep_Integration.md).
+## Yêu cầu
 
-## Roadmap
+- Node.js **≥ 18**
+- License Server reachable (hoặc cache + offline grace hợp lệ)
 
-- **v0.1** — Types, errors, boot, express middleware, file cache, local audit
-- **v0.2** — Auto-fetch public keys, key rotation retry, worker/CLI guard, offline grace
-- **v0.3** — Production default URL, activate flow, revoke handling, server contract sync
-- **v0.4** — Licensed module registry, DI container, Express routes, NestJS `@RequireFeature`
-- **v0.4.1** — Runtime re-check license trên `get()` / `resolve()`, fix `ModuleNotLicensedError` status
-- **v0.4.2** — Mã lỗi (`code`) + `source` trên mọi `LicenseError`, `LicenseErrorCode`, `formatLicenseError()`
-- **v0.4.3** — Re-check registry/DI không ghi audit; middleware 403 trả `source` qua `toClientPayload()`
-- **v0.5.0** — Fail-closed offline boot, quota/limit gates, apiUrl pin, Nest 403 filter, sync mutex
-- **v1.0** — Stable API, production-ready, security review
+---
 
-## License
+## Changelog (tóm tắt)
 
-MIT
+| Version | Highlights |
+|---------|------------|
+| **0.5.1** | Tách tài liệu (installation, integration, api-reference), sửa repository URL |
+| **0.5.0** | Fail-closed offline boot, quota/limit gates, apiUrl pin, sync mutex, Nest 403 filter |
+| **0.4.x** | Deep integration (registry/DI), error `code` + `source`, runtime re-check |
+| **0.3.x** | Production default URL, activate/revoke sync |
+| **0.2.x** | Auto-fetch public keys, worker/CLI guard |
+| **0.1.x** | Boot, express middleware, file cache |

package/dist/client/http-error-utils.d.ts

@@ -0,0 +1,10 @@
+export interface ApiErrorBody {
+    code?: string;
+    message?: string;
+}
+export declare function parseApiErrorBody(response: Response): Promise<ApiErrorBody | null>;
+export declare function isNetworkUnreachable(error: unknown): boolean;
+/** Retry only when a repeat request may succeed (transient server/network errors). */
+export declare function isRetryableHttpStatus(status: number): boolean;
+export declare function serverMessage(body: ApiErrorBody | null, fallback: string): string;
+//# sourceMappingURL=http-error-utils.d.ts.map

package/dist/client/http-error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error-utils.d.ts","sourceRoot":"","sources":["../../src/client/http-error-utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAUxF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAsB5D;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF"}

package/dist/client/http-error-utils.js

@@ -0,0 +1,38 @@
+export async function parseApiErrorBody(response) {
+    try {
+        const data = (await response.json());
+        if (data && (typeof data.code === 'string' || typeof data.message === 'string')) {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isNetworkUnreachable(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const code = error.code;
+    if (code === 'ECONNREFUSED' || code === 'ENOTFOUND' || code === 'EHOSTUNREACH' || code === 'ENETUNREACH') {
+        return true;
+    }
+    const cause = error.cause;
+    if (cause instanceof Error) {
+        const causeCode = cause.code;
+        return (causeCode === 'ECONNREFUSED' ||
+            causeCode === 'ENOTFOUND' ||
+            causeCode === 'EHOSTUNREACH' ||
+            causeCode === 'ENETUNREACH');
+    }
+    return false;
+}
+/** Retry only when a repeat request may succeed (transient server/network errors). */
+export function isRetryableHttpStatus(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+export function serverMessage(body, fallback) {
+    return body?.message?.trim() || fallback;
+}
+//# sourceMappingURL=http-error-utils.js.map

package/dist/client/http-error-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error-utils.js","sourceRoot":"","sources":["../../src/client/http-error-utils.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;QACrD,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;YAChF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QACzG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAI,KAA+B,CAAC,IAAI,CAAC;QACxD,OAAO,CACL,SAAS,KAAK,cAAc;YAC5B,SAAS,KAAK,WAAW;YACzB,SAAS,KAAK,cAAc;YAC5B,SAAS,KAAK,aAAa,CAC5B,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAyB,EAAE,QAAgB;IACvE,OAAO,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC;AAC3C,CAAC"}

package/dist/client/license-api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"license-api-client.d.ts","sourceRoot":"","sources":["../../src/client/license-api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIxE,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIlE,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAI5D,aAAa;YAuBb,IAAI;CA+CnB"}
+{"version":3,"file":"license-api-client.d.ts","sourceRoot":"","sources":["../../src/client/license-api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAY7B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAcD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIxE,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIlE,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAI5D,aAAa;YAuBb,IAAI;CA6DnB"}

package/dist/client/license-api-client.js

@@ -1,7 +1,16 @@
 import { LicenseApiError } from '../errors/api-error.js';
 import { LicenseErrorCode } from '../errors/codes.js';
 import { LicenseRateLimitError } from '../errors/license-error.js';
+import { isNetworkUnreachable, isRetryableHttpStatus, parseApiErrorBody, serverMessage, } from './http-error-utils.js';
 const RETRY_DELAYS_MS = [1000, 3000];
+function mapHttpError(status, statusText, body) {
+    const message = serverMessage(body, `License API error: ${status} ${statusText}`);
+    return new LicenseApiError(message, {
+        code: LicenseErrorCode.LICENSE_API_ERROR,
+        httpStatus: status,
+        retryable: isRetryableHttpStatus(status),
+    });
+}
 export class LicenseApiClient {
     options;
     constructor(options) {
@@ -39,17 +48,17 @@ export class LicenseApiClient {
         try {
             const response = await fetch(url, {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
+                headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
                 body: JSON.stringify(body),
                 signal: controller.signal,
             });
             if (response.status === 429) {
-                throw new LicenseRateLimitError();
+                const body = await parseApiErrorBody(response);
+                throw new LicenseRateLimitError(serverMessage(body, 'License API rate limit exceeded'));
             }
             if (!response.ok) {
-                throw new LicenseApiError(`License API error: ${response.status} ${response.statusText}`, {
-                    httpStatus: response.status,
-                });
+                const errorBody = await parseApiErrorBody(response);
+                throw mapHttpError(response.status, response.statusText, errorBody);
             }
             return (await response.json());
         }
@@ -61,9 +70,20 @@ export class LicenseApiClient {
                 throw new LicenseApiError('License API request timed out', {
                     code: LicenseErrorCode.LICENSE_API_TIMEOUT,
                     cause: error,
+                    retryable: true,
+                });
+            }
+            if (isNetworkUnreachable(error)) {
+                throw new LicenseApiError('License API is unreachable', {
+                    code: LicenseErrorCode.LICENSE_API_UNREACHABLE,
+                    cause: error,
+                    retryable: true,
                 });
             }
-            throw new LicenseApiError('License API request failed', { cause: error });
+            throw new LicenseApiError('License API request failed', {
+                cause: error,
+                retryable: true,
+            });
         }
         finally {
             clearTimeout(timeout);

package/dist/client/license-api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"license-api-client.js","sourceRoot":"","sources":["../../src/client/license-api-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAErC,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAEjE,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,OAAO,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA4B;QACtC,OAAO,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,OAAO,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAY,EACZ,IAAkD;QAElD,IAAI,SAAkB,CAAC;QAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAC;gBAElB,IAAI,CAAC,CAAC,KAAK,YAAY,qBAAqB,CAAC,IAAI,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;oBACnF,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,IAAkD;QAElD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI,CACtC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,qBAAqB,EAAE,CAAC;YACpC,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,eAAe,CAAC,sBAAsB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE;oBACxF,UAAU,EAAE,QAAQ,CAAC,MAAM;iBAC5B,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,qBAAqB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBAC/E,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,eAAe,CAAC,+BAA+B,EAAE;oBACzD,IAAI,EAAE,gBAAgB,CAAC,mBAAmB;oBAC1C,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,eAAe,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"license-api-client.js","sourceRoot":"","sources":["../../src/client/license-api-client.ts"],"names":[],"mappings":"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"}

package/dist/client/map-client-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-client-error.d.ts","sourceRoot":"","sources":["../../src/client/map-client-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAEL,YAAY,EAMb,MAAM,4BAA4B,CAAC;AAyBpC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAUhF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,CAgC3E"}
+{"version":3,"file":"map-client-error.d.ts","sourceRoot":"","sources":["../../src/client/map-client-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAEL,YAAY,EAMb,MAAM,4BAA4B,CAAC;AA2BpC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAUhF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,CAuD3E"}

package/dist/client/map-client-error.js

@@ -1,3 +1,4 @@
+import { LicenseErrorCode } from '../errors/codes.js';
 import { InstanceBlockedError, LicenseExpiredError, LicenseInvalidError, LicenseRevokedError, LicenseSuspendedError, MaxInstancesError, } from '../errors/license-error.js';
 import { PolicySignatureError } from '../errors/policy-error.js';
 const TERMINAL_STATUSES = new Set([
@@ -13,6 +14,8 @@ const TERMINAL_CODES = new Set([
     'LICENSE_SUSPENDED',
     'LICENSE_EXPIRED',
     'LICENSE_INVALID',
+    'LICENSE_NOT_FOUND',
+    'PRODUCT_NOT_FOUND',
     'INVALID_LICENSE',
     'INVALID_PRODUCT',
     'INSTANCE_BLOCKED',
@@ -31,33 +34,56 @@ export function isTerminalClientResponse(response) {
 }
 export function mapClientError(response) {
     const message = response.message ?? 'License check failed';
+    const source = 'map-client-error';
     switch (response.code) {
         case 'LICENSE_REVOKED':
-            return new LicenseRevokedError(message);
+            return new LicenseRevokedError(message, source);
         case 'LICENSE_SUSPENDED':
-            return new LicenseSuspendedError(message);
+            return new LicenseSuspendedError(message, source);
         case 'LICENSE_EXPIRED':
-            return new LicenseExpiredError(message);
+            return new LicenseExpiredError(message, source);
+        case 'LICENSE_NOT_STARTED':
+            return new LicenseInvalidError(message, {
+                code: LicenseErrorCode.LICENSE_NOT_STARTED,
+                source,
+            });
+        case 'PRODUCT_NOT_FOUND':
+        case 'INVALID_PRODUCT':
+            return new LicenseInvalidError(message, {
+                code: LicenseErrorCode.PRODUCT_NOT_FOUND,
+                source,
+            });
+        case 'LICENSE_NOT_FOUND':
+            return new LicenseInvalidError(message, {
+                code: LicenseErrorCode.LICENSE_NOT_FOUND,
+                source,
+            });
+        case 'LICENSE_INVALID':
+        case 'INVALID_LICENSE':
+            return new LicenseInvalidError(message, {
+                code: LicenseErrorCode.LICENSE_INVALID,
+                source,
+            });
         case 'INSTANCE_BLOCKED':
-            return new InstanceBlockedError(message);
+            return new InstanceBlockedError(message, source);
         case 'MAX_INSTANCES':
-            return new MaxInstancesError(message);
+            return new MaxInstancesError(message, source);
         case 'POLICY_SIGN_FAILED':
-            return new PolicySignatureError(message, {
-                source: 'map-client-error',
-            });
+            return new PolicySignatureError(message, { source });
         default:
             break;
     }
     switch (response.status) {
         case 'revoked':
-            return new LicenseRevokedError(message);
+            return new LicenseRevokedError(message, source);
         case 'suspended':
-            return new LicenseSuspendedError(message);
+            return new LicenseSuspendedError(message, source);
         case 'expired':
-            return new LicenseExpiredError(message);
+            return new LicenseExpiredError(message, source);
+        case 'blocked':
+            return new InstanceBlockedError(message, source);
         default:
-            return new LicenseInvalidError(message);
+            return new LicenseInvalidError(message, { source });
     }
 }
 //# sourceMappingURL=map-client-error.js.map

package/dist/client/map-client-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-client-error.js","sourceRoot":"","sources":["../../src/client/map-client-error.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EAEpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,SAAS;IACT,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,oBAAoB;IACpB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,QAA8B;IACrE,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA8B;IAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,sBAAsB,CAAC;IAE3D,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,iBAAiB;YACpB,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,mBAAmB;YACtB,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,iBAAiB;YACpB,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,kBAAkB;YACrB,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,eAAe;YAClB,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,oBAAoB;YACvB,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE;gBACvC,MAAM,EAAE,kBAAkB;aAC3B,CAAC,CAAC;QACL;YACE,MAAM;IACV,CAAC;IAED,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,WAAW;YACd,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C;YACE,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}
+{"version":3,"file":"map-client-error.js","sourceRoot":"","sources":["../../src/client/map-client-error.ts"],"names":[],"mappings":"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"}

package/dist/client/public-keys-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-keys-client.d.ts","sourceRoot":"","sources":["../../src/client/public-keys-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA+CxE"}
+{"version":3,"file":"public-keys-client.d.ts","sourceRoot":"","sources":["../../src/client/public-keys-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAWnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2CD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA2DxE"}

package/dist/client/public-keys-client.js

@@ -1,5 +1,38 @@
 import { PublicKeysError } from '../errors/api-error.js';
 import { LicenseErrorCode } from '../errors/codes.js';
+import { isNetworkUnreachable, isRetryableHttpStatus, parseApiErrorBody, serverMessage, } from './http-error-utils.js';
+function mapHttpError(status, statusText, body) {
+    const message = serverMessage(body, `Public keys API error: ${status} ${statusText}`);
+    const retryable = isRetryableHttpStatus(status);
+    if (status === 429 || body?.code === 'RATE_LIMITED') {
+        return new PublicKeysError(message, {
+            code: LicenseErrorCode.RATE_LIMITED,
+            httpStatus: status,
+            retryable: true,
+        });
+    }
+    if (status === 404) {
+        if (body?.code === 'PRODUCT_NOT_FOUND') {
+            return new PublicKeysError(message, {
+                code: LicenseErrorCode.PRODUCT_NOT_FOUND,
+                httpStatus: status,
+                retryable: false,
+            });
+        }
+        if (body?.code === 'PUBLIC_KEYS_NOT_PUBLISHED' || body?.code === 'NOT_FOUND') {
+            return new PublicKeysError(message, {
+                code: LicenseErrorCode.PUBLIC_KEYS_NOT_PUBLISHED,
+                httpStatus: status,
+                retryable: false,
+            });
+        }
+    }
+    return new PublicKeysError(message, {
+        code: LicenseErrorCode.PUBLIC_KEYS_FETCH_FAILED,
+        httpStatus: status,
+        retryable,
+    });
+}
 export class PublicKeysClient {
     options;
     constructor(options) {
@@ -17,14 +50,14 @@ export class PublicKeysClient {
                 signal: controller.signal,
             });
             if (!response.ok) {
-                throw new PublicKeysError(`Public keys API error: ${response.status} ${response.statusText}`, {
-                    httpStatus: response.status,
-                });
+                const body = await parseApiErrorBody(response);
+                throw mapHttpError(response.status, response.statusText, body);
             }
             const data = (await response.json());
             if (!data.keys?.length) {
                 throw new PublicKeysError('Public keys API returned no keys', {
                     code: LicenseErrorCode.PUBLIC_KEYS_EMPTY,
+                    retryable: false,
                 });
             }
             return data;
@@ -37,9 +70,20 @@ export class PublicKeysClient {
                 throw new PublicKeysError('Public keys API request timed out', {
                     code: LicenseErrorCode.LICENSE_API_TIMEOUT,
                     cause: error,
+                    retryable: true,
+                });
+            }
+            if (isNetworkUnreachable(error)) {
+                throw new PublicKeysError('Public keys API is unreachable', {
+                    code: LicenseErrorCode.LICENSE_API_UNREACHABLE,
+                    cause: error,
+                    retryable: true,
                 });
             }
-            throw new PublicKeysError('Public keys API request failed', { cause: error });
+            throw new PublicKeysError('Public keys API request failed', {
+                cause: error,
+                retryable: true,
+            });
         }
         finally {
             clearTimeout(timeout);

package/dist/client/public-keys-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-keys-client.js","sourceRoot":"","sources":["../../src/client/public-keys-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOtD,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAEjE,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,MAAM,IAAI,GAAG,uBAAuB,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI,CACtC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACvC,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,eAAe,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE;oBAC5F,UAAU,EAAE,QAAQ,CAAC,MAAM;iBAC5B,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;gBACvB,MAAM,IAAI,eAAe,CAAC,kCAAkC,EAAE;oBAC5D,IAAI,EAAE,gBAAgB,CAAC,iBAAiB;iBACzC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,eAAe,CAAC,mCAAmC,EAAE;oBAC7D,IAAI,EAAE,gBAAgB,CAAC,mBAAmB;oBAC1C,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,eAAe,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"public-keys-client.js","sourceRoot":"","sources":["../../src/client/public-keys-client.ts"],"names":[],"mappings":"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"}

package/dist/core-license.js

@@ -25,7 +25,7 @@ import { PolicySignatureError } from './errors/policy-error.js';
 import { throwForTerminalStatus } from './errors/throw-for-status.js';
 import { resolveApiUrl, parseEmbeddedApiUrl } from './env/resolve-api-url.js';
 const SDK_NAME = '@corelicense/node';
-const SDK_VERSION = '0.5.0';
+const SDK_VERSION = '0.5.1';
 const DEFAULT_CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000;
 function hashPolicyToken(token) {
     return createHash('sha256').update(token).digest('hex');

package/dist/crypto/key-loader.d.ts

@@ -1,4 +1,4 @@
-export type KeyFormat = 'spki' | 'pkcs8';
+export type KeyFormat = 'spki' | 'pkcs8' | 'raw';
 export declare function loadPublicKey(keyMaterial: string, algorithm?: 'Ed25519' | 'RS256' | 'ES256'): Promise<CryptoKey>;
 export declare function loadPrivateKey(keyMaterial: string, algorithm?: 'Ed25519' | 'RS256' | 'ES256'): Promise<CryptoKey>;
 //# sourceMappingURL=key-loader.d.ts.map

package/dist/crypto/key-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"key-loader.d.ts","sourceRoot":"","sources":["../../src/crypto/key-loader.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,SAAS,GAAG,OAAO,GAAG,OAAmB,GACnD,OAAO,CAAC,SAAS,CAAC,CAGpB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,SAAS,GAAG,OAAO,GAAG,OAAmB,GACnD,OAAO,CAAC,SAAS,CAAC,CAGpB"}
+{"version":3,"file":"key-loader.d.ts","sourceRoot":"","sources":["../../src/crypto/key-loader.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAIjD,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,SAAS,GAAG,OAAO,GAAG,OAAmB,GACnD,OAAO,CAAC,SAAS,CAAC,CAcpB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,SAAS,GAAG,OAAO,GAAG,OAAmB,GACnD,OAAO,CAAC,SAAS,CAAC,CAQpB"}