@operaris/license-sdk 1.0.0

package/README.md

@@ -0,0 +1,138 @@
+# @operaris/license-sdk
+
+SDK para validação de licenças do Operaris no ERP/PDV.
+
+## Instalação
+
+```bash
+npm install @operaris/license-sdk
+```
+
+## Uso rápido
+
+```typescript
+import { LicenseClient } from '@operaris/license-sdk'
+
+const client = new LicenseClient({
+  apiUrl:     'https://api.operaris.com.br',
+  apiKey:     process.env.OPERARIS_API_KEY!,
+  licenseKey: process.env.OPERARIS_LICENSE_KEY!,
+})
+
+// Na inicialização do ERP — lança erro se licença inválida
+const license = await client.validateOrThrow({
+  fingerprint: getMachineFingerprint(),
+  hostname:    os.hostname(),
+  os:          process.platform,
+})
+
+console.log('Licença válida até:', license.validUntil)
+console.log('Máx. dispositivos:', license.maxDevices)
+```
+
+## Configuração
+
+| Opção         | Tipo     | Padrão   | Descrição                                              |
+|---------------|----------|----------|--------------------------------------------------------|
+| `apiUrl`      | `string` | —        | URL base da API Operaris (obrigatório)                 |
+| `apiKey`      | `string` | —        | Chave de API fornecida pela Operaris (obrigatório)     |
+| `licenseKey`  | `string` | —        | Chave da licença do estabelecimento (obrigatório)      |
+| `cacheTtlMs`  | `number` | `300000` | TTL do cache em ms (padrão: 5 minutos)                 |
+| `timeoutMs`   | `number` | `10000`  | Timeout da requisição em ms (padrão: 10 segundos)      |
+| `retries`     | `number` | `2`      | Tentativas em falha de rede (não retenta em 4xx/5xx)   |
+
+## Métodos
+
+### `validate(input): Promise<ValidateResult>`
+
+Valida a licença. Retorna o resultado do cache se ainda válido (dentro do TTL).
+Em falha de rede, retorna o último cache como **fallback offline** (mesmo que expirado).
+
+```typescript
+const result = await client.validate({ fingerprint: '...', hostname: '...', os: '...' })
+
+if (result.valid) {
+  // result.status           — 'ACTIVE' | 'GRACE'
+  // result.validUntil       — Date
+  // result.graceDaysRemaining — number | undefined
+  // result.maxDevices       — number
+  // result.features         — Record<string, unknown>
+  // result.establishment    — { id, name, city, state }
+  // result.fromCache        — boolean
+  // result.offlineFallback  — boolean (true = API inacessível, usando cache antigo)
+} else {
+  // result.reason — motivo da rejeição
+}
+```
+
+**Valores possíveis de `reason`:**
+
+| Valor                    | Descrição                                          |
+|--------------------------|----------------------------------------------------|
+| `LICENSE_NOT_FOUND`      | Licença não existe                                 |
+| `LICENSE_EXPIRED`        | Licença expirada (além do período de carência)     |
+| `LICENSE_CANCELLED`      | Licença cancelada                                  |
+| `LICENSE_REVOKED`        | Licença revogada                                   |
+| `DEVICE_NOT_REGISTERED`  | Fingerprint não registrado nesta licença           |
+| `MAX_DEVICES_REACHED`    | Limite de dispositivos atingido                    |
+| `DEVICE_INACTIVE`        | Dispositivo desativado manualmente                 |
+| `API_UNREACHABLE`        | API inacessível e sem cache disponível             |
+
+### `validateOrThrow(input): Promise<ValidateSuccess>`
+
+Igual ao `validate`, mas **lança erro** se a licença for inválida.
+Ideal para bloquear a inicialização do ERP.
+
+```typescript
+try {
+  const license = await client.validateOrThrow({ fingerprint, hostname, os })
+  // prossegue normalmente
+} catch (err) {
+  if (err instanceof LicenseValidationError) {
+    console.error('Licença inválida:', err.reason)
+    process.exit(1)
+  }
+  if (err instanceof LicenseApiUnreachableError) {
+    console.error('API inacessível e sem cache — verifique a conexão')
+    process.exit(1)
+  }
+}
+```
+
+### `clearCache(): void`
+
+Invalida o cache local, forçando nova consulta na próxima chamada.
+
+## Comportamento offline
+
+O SDK mantém um cache em memória do último resultado válido. Em caso de falha de rede:
+
+- Se houver cache (mesmo expirado) → retorna o cache com `offlineFallback: true`
+- Se não houver cache → retorna `{ valid: false, reason: 'API_UNREACHABLE' }`
+
+Isso garante que o ERP continue funcionando por um período durante instabilidades de rede.
+
+## Erros
+
+```typescript
+import { LicenseValidationError, LicenseApiUnreachableError } from '@operaris/license-sdk'
+
+// LicenseValidationError
+err.reason   // string — motivo da rejeição
+err.message  // string — mensagem legível
+
+// LicenseApiUnreachableError
+err.message  // 'License API is unreachable and no cache is available'
+```
+
+## Build
+
+```bash
+npm run build   # compila para dist/
+npm run dev     # watch mode
+```
+
+## Requisitos
+
+- Node.js >= 20
+- `fetch` nativo (disponível a partir do Node 18)

package/dist/LicenseClient.d.ts

@@ -0,0 +1,27 @@
+import { LicenseClientConfig, ValidateInput, ValidateResult, ValidateSuccess } from './types';
+export declare class LicenseClient {
+    private readonly apiUrl;
+    private readonly apiKey;
+    private readonly licenseKey;
+    private readonly cacheTtlMs;
+    private readonly timeoutMs;
+    private readonly retries;
+    private cache;
+    constructor(config: LicenseClientConfig);
+    /**
+     * Valida a licença do dispositivo.
+     * Retorna resultado do cache se ainda válido.
+     * Em falha de rede, retorna o último cache como fallback offline.
+     */
+    validate(input: ValidateInput): Promise<ValidateResult>;
+    /**
+     * Valida a licença e lança erro se inválida.
+     * Útil para bloquear a inicialização do ERP.
+     */
+    validateOrThrow(input: ValidateInput): Promise<ValidateSuccess>;
+    /** Invalida o cache forçando nova consulta na próxima chamada. */
+    clearCache(): void;
+    private fetchWithRetry;
+    private fetchValidate;
+}
+//# sourceMappingURL=LicenseClient.d.ts.map

package/dist/LicenseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LicenseClient.d.ts","sourceRoot":"","sources":["../src/LicenseClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAA;AAQhB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEhC,OAAO,CAAC,KAAK,CAA0B;gBAE3B,MAAM,EAAE,mBAAmB;IASvC;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAqD7D;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAarE,kEAAkE;IAClE,UAAU,IAAI,IAAI;YAIJ,cAAc;YAgBd,aAAa;CA6B5B"}

package/dist/LicenseClient.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LicenseClient = void 0;
+const errors_1 = require("./errors");
+class LicenseClient {
+    apiUrl;
+    apiKey;
+    licenseKey;
+    cacheTtlMs;
+    timeoutMs;
+    retries;
+    cache = null;
+    constructor(config) {
+        this.apiUrl = config.apiUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.licenseKey = config.licenseKey;
+        this.cacheTtlMs = config.cacheTtlMs ?? 300_000;
+        this.timeoutMs = config.timeoutMs ?? 10_000;
+        this.retries = config.retries ?? 2;
+    }
+    /**
+     * Valida a licença do dispositivo.
+     * Retorna resultado do cache se ainda válido.
+     * Em falha de rede, retorna o último cache como fallback offline.
+     */
+    async validate(input) {
+        // Cache hit dentro do TTL
+        if (this.cache && Date.now() - this.cache.cachedAt < this.cacheTtlMs) {
+            return { ...this.cache.result, fromCache: true, offlineFallback: false };
+        }
+        try {
+            const raw = await this.fetchWithRetry(input);
+            if (raw.valid) {
+                const result = {
+                    valid: true,
+                    status: raw.status,
+                    licenseKey: raw.licenseKey,
+                    validUntil: new Date(raw.validUntil),
+                    graceDaysRemaining: raw.graceDaysRemaining,
+                    maxDevices: raw.maxDevices,
+                    features: raw.features,
+                    establishment: raw.establishment,
+                    fromCache: false,
+                    offlineFallback: false,
+                };
+                this.cache = { result, cachedAt: Date.now() };
+                return result;
+            }
+            // Resposta inválida da API — limpa o cache para não retornar stale
+            this.cache = null;
+            return {
+                valid: false,
+                reason: raw.reason,
+                fromCache: false,
+                offlineFallback: false,
+            };
+        }
+        catch (err) {
+            // Fallback offline: API inacessível mas temos cache (mesmo expirado)
+            if (this.cache) {
+                return {
+                    ...this.cache.result,
+                    fromCache: true,
+                    offlineFallback: true,
+                };
+            }
+            return {
+                valid: false,
+                reason: 'API_UNREACHABLE',
+                fromCache: false,
+                offlineFallback: false,
+            };
+        }
+    }
+    /**
+     * Valida a licença e lança erro se inválida.
+     * Útil para bloquear a inicialização do ERP.
+     */
+    async validateOrThrow(input) {
+        const result = await this.validate(input);
+        if (!result.valid) {
+            if (result.reason === 'API_UNREACHABLE') {
+                throw new errors_1.LicenseApiUnreachableError();
+            }
+            throw new errors_1.LicenseValidationError(result.reason);
+        }
+        return result;
+    }
+    /** Invalida o cache forçando nova consulta na próxima chamada. */
+    clearCache() {
+        this.cache = null;
+    }
+    async fetchWithRetry(input) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.retries; attempt++) {
+            try {
+                return await this.fetchValidate(input);
+            }
+            catch (err) {
+                lastError = err;
+                // Não retenta em erros de resposta (4xx/5xx) — só em falhas de rede
+                if (err instanceof ApiResponseError)
+                    throw err;
+            }
+        }
+        throw lastError;
+    }
+    async fetchValidate(input) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(`${this.apiUrl}/api/validate`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.apiKey,
+                },
+                body: JSON.stringify({
+                    licenseKey: this.licenseKey,
+                    fingerprint: input.fingerprint,
+                    hostname: input.hostname,
+                    os: input.os,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok && response.status !== 403) {
+                throw new ApiResponseError(response.status);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+exports.LicenseClient = LicenseClient;
+class ApiResponseError extends Error {
+    status;
+    constructor(status) {
+        super(`API responded with status ${status}`);
+        this.status = status;
+    }
+}
+//# sourceMappingURL=LicenseClient.js.map

package/dist/LicenseClient.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class LicenseValidationError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message?: string);
+}
+export declare class LicenseApiUnreachableError extends Error {
+    constructor(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,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,CAAC,EAAE,MAAM;CAKnB;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,KAAK,CAAC,EAAE,OAAO;CAK5B"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LicenseApiUnreachableError = exports.LicenseValidationError = void 0;
+class LicenseValidationError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message ?? `License validation failed: ${reason}`);
+        this.reason = reason;
+        this.name = 'LicenseValidationError';
+    }
+}
+exports.LicenseValidationError = LicenseValidationError;
+class LicenseApiUnreachableError extends Error {
+    constructor(cause) {
+        super('License API is unreachable');
+        this.name = 'LicenseApiUnreachableError';
+        if (cause)
+            this.cause = cause;
+    }
+}
+exports.LicenseApiUnreachableError = LicenseApiUnreachableError;
+//# 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,MAAa,sBAAuB,SAAQ,KAAK;IAE7B;IADlB,YACkB,MAAc,EAC9B,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,8BAA8B,MAAM,EAAE,CAAC,CAAA;QAHxC,WAAM,GAAN,MAAM,CAAQ;QAI9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AARD,wDAQC;AAED,MAAa,0BAA2B,SAAQ,KAAK;IACnD,YAAY,KAAe;QACzB,KAAK,CAAC,4BAA4B,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IAC/B,CAAC;CACF;AAND,gEAMC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { LicenseClient } from './LicenseClient';
+export { LicenseValidationError, LicenseApiUnreachableError } from './errors';
+export type { LicenseClientConfig, ValidateInput, ValidateResult, ValidateSuccess, ValidateFailure, } from './types';
+//# 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,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAC7E,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LicenseApiUnreachableError = exports.LicenseValidationError = exports.LicenseClient = void 0;
+var LicenseClient_1 = require("./LicenseClient");
+Object.defineProperty(exports, "LicenseClient", { enumerable: true, get: function () { return LicenseClient_1.LicenseClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "LicenseValidationError", { enumerable: true, get: function () { return errors_1.LicenseValidationError; } });
+Object.defineProperty(exports, "LicenseApiUnreachableError", { enumerable: true, get: function () { return errors_1.LicenseApiUnreachableError; } });
+//# 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,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,mCAA6E;AAApE,gHAAA,sBAAsB,OAAA;AAAE,oHAAA,0BAA0B,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface LicenseClientConfig {
+    /** URL base da API SaaS. Ex: https://saas.operaris.com.br */
+    apiUrl: string;
+    /** Chave de API do ERP (x-api-key) */
+    apiKey: string;
+    /** UUID da licença do estabelecimento */
+    licenseKey: string;
+    /**
+     * TTL do cache de validação em ms.
+     * Durante o TTL, o SDK retorna o resultado em memória sem bater na API.
+     * @default 300_000 (5 minutos)
+     */
+    cacheTtlMs?: number;
+    /**
+     * Timeout de cada requisição em ms.
+     * @default 10_000 (10 segundos)
+     */
+    timeoutMs?: number;
+    /**
+     * Número de retentativas em caso de falha de rede.
+     * @default 2
+     */
+    retries?: number;
+}
+export interface ValidateInput {
+    /** Identificador único e estável do dispositivo (hash de hardware, MAC, etc.) */
+    fingerprint: string;
+    /** Nome da máquina (opcional, para exibição no painel) */
+    hostname?: string;
+    /** Sistema operacional (opcional, para exibição no painel) */
+    os?: string;
+}
+export interface ValidateSuccess {
+    valid: true;
+    status: 'ACTIVE' | 'GRACE';
+    licenseKey: string;
+    validUntil: Date;
+    graceDaysRemaining: number;
+    maxDevices: number;
+    features: Record<string, unknown>;
+    establishment: {
+        id: string;
+        name: string;
+    };
+    /** true quando o resultado veio do cache local */
+    fromCache: boolean;
+    /** true quando a API estava inacessível e foi usado o último cache válido */
+    offlineFallback: boolean;
+}
+export interface ValidateFailure {
+    valid: false;
+    reason: 'LICENSE_NOT_FOUND' | 'LICENSE_REVOKED' | 'LICENSE_SUSPENDED' | 'LICENSE_EXPIRED' | 'DEVICE_DEACTIVATED' | 'DEVICE_LIMIT_REACHED' | 'API_UNREACHABLE';
+    offlineFallback: false;
+    fromCache: false;
+}
+export type ValidateResult = ValidateSuccess | ValidateFailure;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,CAAA;IACX,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,IAAI,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,aAAa,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAA;IAClB,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EACF,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,GACpB,sBAAsB,GACtB,iBAAiB,CAAA;IACrB,eAAe,EAAE,KAAK,CAAA;IACtB,SAAS,EAAE,KAAK,CAAA;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,eAAe,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@operaris/license-sdk",
+  "version": "1.0.0",
+  "description": "SDK para validação de licenças do ERP Operaris",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}