@neetru/sdk 3.6.0 → 3.8.0

package/dist/entitlements.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var e = class i extends Error {
   code;
   status;
   requestId;
@@ -14,37 +14,38 @@ var NeetruError = class _NeetruError extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(code, message, status, requestId, reason) {
-    super(message);
-    this.name = "NeetruError";
-    this.code = code;
-    this.status = status;
-    this.requestId = requestId;
-    this.reason = reason;
-    Object.setPrototypeOf(this, _NeetruError.prototype);
+  /**
+   * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+   * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+   * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+   * `undefined` em erros que acontecem antes de qualquer requisição.
+   */
+  correlationId;
+  constructor(t, r, n, s, a, c) {
+    super(r), this.name = "NeetruError", this.code = t, this.status = n, this.requestId = s, this.reason = a, this.correlationId = c, Object.setPrototypeOf(this, i.prototype);
   }
 };
 
 // src/entitlements.ts
-var DEPRECATION_MESSAGE = "client.entitlements.check()/checkDetailed() est\xE3o DEPRECADOS \u2014 apontavam para GET /api/v1/sdk/entitlements/check, um endpoint que o Core nunca escreve (sempre retornava not_subscribed). Use client.usage.check(resource, { productId, tenantId }) no lugar \u2014 mesmo resultado (allowed/reason/remaining/limit/behavior), endpoint real.";
-function throwDeprecated() {
-  throw new NeetruError("validation_failed", DEPRECATION_MESSAGE);
+var d = "client.entitlements.check()/checkDetailed() est\xE3o DEPRECADOS \u2014 apontavam para GET /api/v1/sdk/entitlements/check, um endpoint que o Core nunca escreve (sempre retornava not_subscribed). Use client.usage.check(resource, { productId, tenantId }) no lugar \u2014 mesmo resultado (allowed/reason/remaining/limit/behavior), endpoint real.";
+function o() {
+  throw new e("validation_failed", d);
 }
-function createEntitlementsNamespace(_config) {
+function p(i) {
   return {
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
-    async check(_productSlug, _feature, _opts) {
-      throwDeprecated();
+    async check(t, r, n) {
+      o();
     },
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
-    async checkDetailed(_productSlug, _feature, _opts) {
-      throwDeprecated();
+    async checkDetailed(t, r, n) {
+      o();
     },
     /** Test helper legado — no-op (não há mais cache). Mantido por compat. */
     __resetCache() {
@@ -52,6 +53,4 @@ function createEntitlementsNamespace(_config) {
   };
 }
 
-exports.createEntitlementsNamespace = createEntitlementsNamespace;
-//# sourceMappingURL=entitlements.cjs.map
-//# sourceMappingURL=entitlements.cjs.map
+exports.createEntitlementsNamespace = p;

package/dist/entitlements.d.cts

@@ -1,4 +1,4 @@
-import { ag as ResolvedConfig, O as EntitlementCheck } from './types-Du_iioJ7.cjs';
+import { ah as ResolvedConfig, P as EntitlementCheck } from './types-D-9bjlM0.cjs';
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';
 

package/dist/entitlements.d.ts

@@ -1,4 +1,4 @@
-import { ag as ResolvedConfig, O as EntitlementCheck } from './types-BPATkXYu.js';
+import { ah as ResolvedConfig, P as EntitlementCheck } from './types-bVztFQTI.js';
 import 'drizzle-orm/node-postgres';
 import './errors.js';
 

package/dist/entitlements.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var e = class i extends Error {
   code;
   status;
   requestId;
@@ -12,37 +12,38 @@ var NeetruError = class _NeetruError extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(code, message, status, requestId, reason) {
-    super(message);
-    this.name = "NeetruError";
-    this.code = code;
-    this.status = status;
-    this.requestId = requestId;
-    this.reason = reason;
-    Object.setPrototypeOf(this, _NeetruError.prototype);
+  /**
+   * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+   * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+   * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+   * `undefined` em erros que acontecem antes de qualquer requisição.
+   */
+  correlationId;
+  constructor(t, r, n, s, a, c) {
+    super(r), this.name = "NeetruError", this.code = t, this.status = n, this.requestId = s, this.reason = a, this.correlationId = c, Object.setPrototypeOf(this, i.prototype);
   }
 };
 
 // src/entitlements.ts
-var DEPRECATION_MESSAGE = "client.entitlements.check()/checkDetailed() est\xE3o DEPRECADOS \u2014 apontavam para GET /api/v1/sdk/entitlements/check, um endpoint que o Core nunca escreve (sempre retornava not_subscribed). Use client.usage.check(resource, { productId, tenantId }) no lugar \u2014 mesmo resultado (allowed/reason/remaining/limit/behavior), endpoint real.";
-function throwDeprecated() {
-  throw new NeetruError("validation_failed", DEPRECATION_MESSAGE);
+var d = "client.entitlements.check()/checkDetailed() est\xE3o DEPRECADOS \u2014 apontavam para GET /api/v1/sdk/entitlements/check, um endpoint que o Core nunca escreve (sempre retornava not_subscribed). Use client.usage.check(resource, { productId, tenantId }) no lugar \u2014 mesmo resultado (allowed/reason/remaining/limit/behavior), endpoint real.";
+function o() {
+  throw new e("validation_failed", d);
 }
-function createEntitlementsNamespace(_config) {
+function p(i) {
   return {
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
-    async check(_productSlug, _feature, _opts) {
-      throwDeprecated();
+    async check(t, r, n) {
+      o();
     },
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
-    async checkDetailed(_productSlug, _feature, _opts) {
-      throwDeprecated();
+    async checkDetailed(t, r, n) {
+      o();
     },
     /** Test helper legado — no-op (não há mais cache). Mantido por compat. */
     __resetCache() {
@@ -50,6 +51,4 @@ function createEntitlementsNamespace(_config) {
   };
 }
 
-export { createEntitlementsNamespace };
-//# sourceMappingURL=entitlements.mjs.map
-//# sourceMappingURL=entitlements.mjs.map
+export { p as createEntitlementsNamespace };

package/dist/errors.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var s = class e extends Error {
   code;
   status;
   requestId;
@@ -14,17 +14,21 @@ var NeetruError = class _NeetruError extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(code, message, status, requestId, reason) {
-    super(message);
-    this.name = "NeetruError";
-    this.code = code;
-    this.status = status;
-    this.requestId = requestId;
-    this.reason = reason;
-    Object.setPrototypeOf(this, _NeetruError.prototype);
+  /**
+   * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+   * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+   * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+   * `undefined` em erros que acontecem antes de qualquer requisição.
+   */
+  correlationId;
+  constructor(r, t, i, n, o, a) {
+    super(t), this.name = "NeetruError", this.code = r, this.status = i, this.requestId = n, this.reason = o, this.correlationId = a, Object.setPrototypeOf(this, e.prototype);
+  }
+}, d = class e extends s {
+  constructor(r, t, i, n, o) {
+    super("auth_required", r, i, n, t, o), this.name = "NeetruAuthRequiredError", Object.setPrototypeOf(this, e.prototype);
   }
 };
 
-exports.NeetruError = NeetruError;
-//# sourceMappingURL=errors.cjs.map
-//# sourceMappingURL=errors.cjs.map
+exports.NeetruAuthRequiredError = d;
+exports.NeetruError = s;

package/dist/errors.d.cts

@@ -26,7 +26,29 @@ type NeetruErrorCode = 'invalid_config' | 'missing_api_key' | 'unauthorized' | '
  */
  | 'token_exchange_failed'
 /** HTTP 409 — colisão de idempotência ou conflito de recurso. */
- | 'conflict' | 'unknown';
+ | 'conflict'
+/**
+ * 3.7.0: a operação exige um usuário final logado (id_token OIDC) e não há
+ * nenhum — ou o Core recusou o token (`end_user_token_required` /
+ * `invalid_end_user_token`). Lançado como {@link NeetruAuthRequiredError}.
+ */
+ | 'auth_required'
+/** 3.7.0: HTTP 410 — endpoint descontinuado/removido no Core. */
+ | 'gone'
+/**
+ * 3.8.0: a credencial `nrt_` do produto (só de servidor) chegou a um runtime
+ * de navegador ou React Native com `strictServerOnlyKey: true` — ou ao
+ * entrypoint `@neetru/sdk/mobile`, que recusa chave sempre.
+ */
+ | 'server_only_key'
+/**
+ * 3.8.0: o token apresentado não é um access_token OIDC válido para esta API
+ * (ex.: é um id_token, um refresh_token ou a chave `nrt_`; falta `jti`/`scope`;
+ * `client_id` diverge do `aud`; token de máquina sem `allowClientCredentials`).
+ */
+ | 'token_invalid'
+/** 3.8.0: o access_token é válido mas não tem todos os escopos exigidos (HTTP 403). */
+ | 'insufficient_scope' | 'unknown';
 /**
  * Erro tipado padrão do SDK. Sempre lançado em vez de Error genérico.
  *
@@ -51,7 +73,41 @@ declare class NeetruError extends Error {
      * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
      */
     readonly reason?: string;
-    constructor(code: NeetruErrorCode | string, message: string, status?: number, requestId?: string, reason?: string);
+    /**
+     * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+     * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+     * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+     * `undefined` em erros que acontecem antes de qualquer requisição.
+     */
+    readonly correlationId?: string;
+    constructor(code: NeetruErrorCode | string, message: string, status?: number, requestId?: string, reason?: string, correlationId?: string);
+}
+/**
+ * 3.7.0 — a operação exige a identidade do USUÁRIO FINAL (id_token OIDC do
+ * usuário logado no produto), que vai no header `X-Neetru-End-User-Token`.
+ *
+ * Lançado quando:
+ *  - não há usuário logado (`client.auth.getIdToken()` devolve `null`) numa
+ *    operação que o Core restringe ao dono (listar "meus tickets", contestar,
+ *    avaliar...) → `reason: 'no_signed_in_user'`, SEM request;
+ *  - o Core respondeu 403 `end_user_token_required` →
+ *    `reason: 'end_user_token_required'`;
+ *  - o Core respondeu 401 `invalid_end_user_token` (token expirado/inválido) →
+ *    `reason: 'invalid_end_user_token'`.
+ *
+ * `code` é sempre `'auth_required'`; `instanceof NeetruError` continua valendo.
+ * Ação típica do app: `client.auth.signIn()` e tentar de novo.
+ *
+ * @example
+ * ```ts
+ * try { await client.support.listMyTickets(); }
+ * catch (e) {
+ *   if (e instanceof NeetruAuthRequiredError) await client.auth.signIn();
+ * }
+ * ```
+ */
+declare class NeetruAuthRequiredError extends NeetruError {
+    constructor(message: string, reason: string, status?: number, requestId?: string, correlationId?: string);
 }
 
-export { NeetruError, type NeetruErrorCode };
+export { NeetruAuthRequiredError, NeetruError, type NeetruErrorCode };

package/dist/errors.d.ts

@@ -26,7 +26,29 @@ type NeetruErrorCode = 'invalid_config' | 'missing_api_key' | 'unauthorized' | '
  */
  | 'token_exchange_failed'
 /** HTTP 409 — colisão de idempotência ou conflito de recurso. */
- | 'conflict' | 'unknown';
+ | 'conflict'
+/**
+ * 3.7.0: a operação exige um usuário final logado (id_token OIDC) e não há
+ * nenhum — ou o Core recusou o token (`end_user_token_required` /
+ * `invalid_end_user_token`). Lançado como {@link NeetruAuthRequiredError}.
+ */
+ | 'auth_required'
+/** 3.7.0: HTTP 410 — endpoint descontinuado/removido no Core. */
+ | 'gone'
+/**
+ * 3.8.0: a credencial `nrt_` do produto (só de servidor) chegou a um runtime
+ * de navegador ou React Native com `strictServerOnlyKey: true` — ou ao
+ * entrypoint `@neetru/sdk/mobile`, que recusa chave sempre.
+ */
+ | 'server_only_key'
+/**
+ * 3.8.0: o token apresentado não é um access_token OIDC válido para esta API
+ * (ex.: é um id_token, um refresh_token ou a chave `nrt_`; falta `jti`/`scope`;
+ * `client_id` diverge do `aud`; token de máquina sem `allowClientCredentials`).
+ */
+ | 'token_invalid'
+/** 3.8.0: o access_token é válido mas não tem todos os escopos exigidos (HTTP 403). */
+ | 'insufficient_scope' | 'unknown';
 /**
  * Erro tipado padrão do SDK. Sempre lançado em vez de Error genérico.
  *
@@ -51,7 +73,41 @@ declare class NeetruError extends Error {
      * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
      */
     readonly reason?: string;
-    constructor(code: NeetruErrorCode | string, message: string, status?: number, requestId?: string, reason?: string);
+    /**
+     * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+     * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+     * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+     * `undefined` em erros que acontecem antes de qualquer requisição.
+     */
+    readonly correlationId?: string;
+    constructor(code: NeetruErrorCode | string, message: string, status?: number, requestId?: string, reason?: string, correlationId?: string);
+}
+/**
+ * 3.7.0 — a operação exige a identidade do USUÁRIO FINAL (id_token OIDC do
+ * usuário logado no produto), que vai no header `X-Neetru-End-User-Token`.
+ *
+ * Lançado quando:
+ *  - não há usuário logado (`client.auth.getIdToken()` devolve `null`) numa
+ *    operação que o Core restringe ao dono (listar "meus tickets", contestar,
+ *    avaliar...) → `reason: 'no_signed_in_user'`, SEM request;
+ *  - o Core respondeu 403 `end_user_token_required` →
+ *    `reason: 'end_user_token_required'`;
+ *  - o Core respondeu 401 `invalid_end_user_token` (token expirado/inválido) →
+ *    `reason: 'invalid_end_user_token'`.
+ *
+ * `code` é sempre `'auth_required'`; `instanceof NeetruError` continua valendo.
+ * Ação típica do app: `client.auth.signIn()` e tentar de novo.
+ *
+ * @example
+ * ```ts
+ * try { await client.support.listMyTickets(); }
+ * catch (e) {
+ *   if (e instanceof NeetruAuthRequiredError) await client.auth.signIn();
+ * }
+ * ```
+ */
+declare class NeetruAuthRequiredError extends NeetruError {
+    constructor(message: string, reason: string, status?: number, requestId?: string, correlationId?: string);
 }
 
-export { NeetruError, type NeetruErrorCode };
+export { NeetruAuthRequiredError, NeetruError, type NeetruErrorCode };

package/dist/errors.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var NeetruError = class _NeetruError extends Error {
+var s = class e extends Error {
   code;
   status;
   requestId;
@@ -12,17 +12,20 @@ var NeetruError = class _NeetruError extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(code, message, status, requestId, reason) {
-    super(message);
-    this.name = "NeetruError";
-    this.code = code;
-    this.status = status;
-    this.requestId = requestId;
-    this.reason = reason;
-    Object.setPrototypeOf(this, _NeetruError.prototype);
+  /**
+   * 3.8.0: `x-correlation-id` da requisição que falhou. O SDK gera um UUID por
+   * chamada (ou usa o que o chamador passou) e manda no header; o Core grava o
+   * mesmo id nos logs/auditoria — cite-o ao abrir um ticket de suporte.
+   * `undefined` em erros que acontecem antes de qualquer requisição.
+   */
+  correlationId;
+  constructor(r, t, i, n, o, a) {
+    super(t), this.name = "NeetruError", this.code = r, this.status = i, this.requestId = n, this.reason = o, this.correlationId = a, Object.setPrototypeOf(this, e.prototype);
+  }
+}, d = class e extends s {
+  constructor(r, t, i, n, o) {
+    super("auth_required", r, i, n, t, o), this.name = "NeetruAuthRequiredError", Object.setPrototypeOf(this, e.prototype);
   }
 };
 
-export { NeetruError };
-//# sourceMappingURL=errors.mjs.map
-//# sourceMappingURL=errors.mjs.map
+export { d as NeetruAuthRequiredError, s as NeetruError };