@neetru/sdk 3.7.0 → 3.8.1

package/dist/entitlements.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/errors.ts
-var e = class o extends Error {
+var e = class i extends Error {
   code;
   status;
   requestId;
@@ -14,31 +14,38 @@ var e = class o extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(t, r, n, s, a) {
-    super(r), this.name = "NeetruError", this.code = t, this.status = n, this.requestId = s, this.reason = a, Object.setPrototypeOf(this, o.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 c = "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 i() {
-  throw new e("validation_failed", c);
+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 l(o) {
+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(t, r, n) {
-      i();
+      o();
     },
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
     async checkDetailed(t, r, n) {
-      i();
+      o();
     },
     /** Test helper legado — no-op (não há mais cache). Mantido por compat. */
     __resetCache() {
@@ -46,4 +53,4 @@ function l(o) {
   };
 }
 
-exports.createEntitlementsNamespace = l;
+exports.createEntitlementsNamespace = p;

package/dist/entitlements.d.cts

@@ -1,4 +1,4 @@
-import { ag as ResolvedConfig, O as EntitlementCheck } from './types-Bx4kTLmk.cjs';
+import { ah as ResolvedConfig, P as EntitlementCheck } from './types-yv3EDKg2.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-Dx0IrOSF.js';
+import { ah as ResolvedConfig, P as EntitlementCheck } from './types-BYPk_3HR.js';
 import 'drizzle-orm/node-postgres';
 import './errors.js';
 

package/dist/entitlements.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var e = class o extends Error {
+var e = class i extends Error {
   code;
   status;
   requestId;
@@ -12,31 +12,38 @@ var e = class o extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(t, r, n, s, a) {
-    super(r), this.name = "NeetruError", this.code = t, this.status = n, this.requestId = s, this.reason = a, Object.setPrototypeOf(this, o.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 c = "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 i() {
-  throw new e("validation_failed", c);
+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 l(o) {
+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(t, r, n) {
-      i();
+      o();
     },
     /**
      * @deprecated Endpoint morto no Core — sempre retornava `not_subscribed`.
      * Lança `NeetruError`. Use `client.usage.check(resource, {productId, tenantId})`.
      */
     async checkDetailed(t, r, n) {
-      i();
+      o();
     },
     /** Test helper legado — no-op (não há mais cache). Mantido por compat. */
     __resetCache() {
@@ -44,4 +51,4 @@ function l(o) {
   };
 }
 
-export { l as createEntitlementsNamespace };
+export { p as createEntitlementsNamespace };

package/dist/errors.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/errors.ts
-var o = class e extends Error {
+var s = class e extends Error {
   code;
   status;
   requestId;
@@ -14,14 +14,21 @@ var o = class e extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(r, t, i, n, d) {
-    super(t), this.name = "NeetruError", this.code = r, this.status = i, this.requestId = n, this.reason = d, Object.setPrototypeOf(this, e.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);
   }
-}, s = class e extends o {
-  constructor(r, t, i, n) {
-    super("auth_required", r, i, n, t), this.name = "NeetruAuthRequiredError", 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.NeetruAuthRequiredError = s;
-exports.NeetruError = o;
+exports.NeetruAuthRequiredError = d;
+exports.NeetruError = s;

package/dist/errors.d.cts

@@ -34,7 +34,21 @@ type NeetruErrorCode = 'invalid_config' | 'missing_api_key' | 'unauthorized' | '
  */
  | 'auth_required'
 /** 3.7.0: HTTP 410 — endpoint descontinuado/removido no Core. */
- | 'gone' | 'unknown';
+ | '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.
  *
@@ -59,7 +73,14 @@ 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
@@ -86,7 +107,7 @@ declare class NeetruError extends Error {
  * ```
  */
 declare class NeetruAuthRequiredError extends NeetruError {
-    constructor(message: string, reason: string, status?: number, requestId?: string);
+    constructor(message: string, reason: string, status?: number, requestId?: string, correlationId?: string);
 }
 
 export { NeetruAuthRequiredError, NeetruError, type NeetruErrorCode };

package/dist/errors.d.ts

@@ -34,7 +34,21 @@ type NeetruErrorCode = 'invalid_config' | 'missing_api_key' | 'unauthorized' | '
  */
  | 'auth_required'
 /** 3.7.0: HTTP 410 — endpoint descontinuado/removido no Core. */
- | 'gone' | 'unknown';
+ | '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.
  *
@@ -59,7 +73,14 @@ 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
@@ -86,7 +107,7 @@ declare class NeetruError extends Error {
  * ```
  */
 declare class NeetruAuthRequiredError extends NeetruError {
-    constructor(message: string, reason: string, status?: number, requestId?: string);
+    constructor(message: string, reason: string, status?: number, requestId?: string, correlationId?: string);
 }
 
 export { NeetruAuthRequiredError, NeetruError, type NeetruErrorCode };

package/dist/errors.mjs

@@ -1,5 +1,5 @@
 // src/errors.ts
-var o = class e extends Error {
+var s = class e extends Error {
   code;
   status;
   requestId;
@@ -12,13 +12,20 @@ var o = class e extends Error {
    * para um `NeetruDbErrorCode` mais específico (recuperável vs não).
    */
   reason;
-  constructor(r, t, i, n, d) {
-    super(t), this.name = "NeetruError", this.code = r, this.status = i, this.requestId = n, this.reason = d, Object.setPrototypeOf(this, e.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);
   }
-}, s = class e extends o {
-  constructor(r, t, i, n) {
-    super("auth_required", r, i, n, t), this.name = "NeetruAuthRequiredError", 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 { s as NeetruAuthRequiredError, o as NeetruError };
+export { d as NeetruAuthRequiredError, s as NeetruError };

package/dist/firestore-compat.d.cts

@@ -1,4 +1,4 @@
-import { Y as NeetruDb, E as DbCollectionRef, P as FieldSentinel, K as DbQuery } from './types-Bx4kTLmk.cjs';
+import { Z as NeetruDb, E as DbCollectionRef, Q as FieldSentinel, K as DbQuery } from './types-yv3EDKg2.cjs';
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';
 

package/dist/firestore-compat.d.ts

@@ -1,4 +1,4 @@
-import { Y as NeetruDb, E as DbCollectionRef, P as FieldSentinel, K as DbQuery } from './types-Dx0IrOSF.js';
+import { Z as NeetruDb, E as DbCollectionRef, Q as FieldSentinel, K as DbQuery } from './types-BYPk_3HR.js';
 import 'drizzle-orm/node-postgres';
 import './errors.js';