@neetru/sdk 3.1.4 → 3.1.7

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to `@neetru/sdk` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.5] - 2026-06-18 — **fix: drift de versão + exemplos quebrados no README**
+
+Release **patch**. Item I4 do Conselho de UI (version/reference drift).
+
+### Fixed
+
+- **`VERSION` exportado** agora bate com o `package.json` (`3.1.5`). Estava pinado em `'3.1.3'` enquanto o pacote publicado já era `3.1.4` → consumers liam a versão errada via `import { VERSION } from '@neetru/sdk'`.
+- **README** parou de mostrar `usage.track()` / `usage.getQuota()` como exemplos vivos — são métodos REMOVIDOS no 3.0 (o próprio README/CHANGELOG documenta a remoção). Trocados por `usage.report(resource, qty)` (devolve `{value, limit, remaining}` inline) e `usage.check(resource)`.
+
 ## [3.1.0] - 2026-06-05 — **feat: subpath `firestore-compat` + hooks de dados React (frente-B P0)**
 
 Release **minor** — só adições, nenhum export removido nem assinatura alterada (a suite de snapshot SDK-QW-5 confirma que a superfície pública 3.0 segue intacta). Upgrade direto de qualquer 3.0.x.

package/README.md

@@ -194,10 +194,14 @@ const detailed = await neetru.entitlements.detailed('gestovendas', 'ai_recommend
 ### Usage tracking
 
 ```ts
-await neetru.usage.track('report_generated', { count: 42, format: 'pdf' });
-
-const quota = await neetru.usage.getQuota('reports_per_month');
-// → { used: 15, limit: 100, resetsAt: '...', plan: 'starter' }
+// Reporta consumo (resource, qty) — devolve {value, limit, remaining} inline,
+// sem precisar de uma chamada de quota separada. Idempotency-Key automático.
+const usage = await neetru.usage.report('reports_generated', 1);
+// → { value: 16, limit: 100, remaining: 84, status: 'ok' }
+
+// Verifica entitlement de um resource (sem incrementar o contador).
+const ent = await neetru.usage.check('reports_per_month');
+// → { allowed, limit?, remaining? }
 ```
 
 ### Support

package/dist/auth.cjs

@@ -5469,9 +5469,19 @@ var DEV_FIXTURE_USER = Object.freeze({
 var MockAuth = class {
   _user;
   _listeners;
-  constructor(initialUser = null) {
+  _allowUnsignedDecode;
+  constructor(initialUser = null, options) {
     this._user = initialUser;
     this._listeners = /* @__PURE__ */ new Set();
+    this._allowUnsignedDecode = options?.allowUnsignedDecode ?? false;
+    if (this._allowUnsignedDecode) {
+      const isTestEnv = typeof process !== "undefined" && (process.env?.NODE_ENV === "test" || process.env?.VITEST === "true" || process.env?.VITEST != null);
+      if (!isTestEnv && typeof console !== "undefined") {
+        console.warn(
+          "[neetru-sdk] MockAuth.verifyToken est\xE1 em modo allowUnsignedDecode=true: tokens N\xC3O t\xEAm assinatura verificada. Este modo \xE9 exclusivo para testes \u2014 NUNCA use como security boundary em c\xF3digo deployado."
+        );
+      }
+    }
   }
   async signIn(_options) {
     if (!this._user) this._user = { ...DEV_FIXTURE_USER };
@@ -5496,18 +5506,27 @@ var MockAuth = class {
     };
   }
   /**
-   * Mock de `verifyToken` — decodifica o JWT sem verificar assinatura (pra testes).
-   * Em dev, retorna o user atual do mock se já estiver logado. Aceita qualquer token
-   * não-vazio sem chamar rede.
+   * Mock de `verifyToken` — por default lança `unauthorized` pra prevenir uso
+   * acidental como security boundary em código deployado.
+   *
+   * Para decodificar JWTs sem verificar assinatura em testes, crie a instância
+   * com `new MockAuth(user, { allowUnsignedDecode: true })`. Isso é um opt-in
+   * explícito — nunca acontece silenciosamente.
    *
-   * Para simular falhas em testes, use `MockAuth.__mockVerifyToken(fn)`.
+   * Para simular falhas ou resultados customizados, use `__mockVerifyToken(fn)`.
    */
   async verifyToken(token) {
     if (this._verifyTokenOverride) {
       return this._verifyTokenOverride(token);
     }
     if (!token) {
-      throw Object.assign(new Error("Token inv\xE1lido"), { code: "token_invalid_signature" });
+      throw new NeetruError("token_invalid_signature", "Token inv\xE1lido: string vazia");
+    }
+    if (!this._allowUnsignedDecode) {
+      throw new NeetruError(
+        "unauthorized",
+        "MockAuth.verifyToken n\xE3o verifica assinaturas JWT e N\xC3O deve ser usado como security boundary em c\xF3digo deployado. Em testes, use new MockAuth(user, { allowUnsignedDecode: true }) para habilitar decodifica\xE7\xE3o sem assinatura, ou __mockVerifyToken(fn) para injetar resultado customizado."
+      );
     }
     try {
       const parts = token.split(".");
@@ -5534,7 +5553,7 @@ var MockAuth = class {
     } catch {
     }
     if (this._user) return this._user;
-    throw Object.assign(new Error("Nenhum user mock dispon\xEDvel"), { code: "token_invalid_signature" });
+    throw new NeetruError("token_invalid_signature", "Nenhum user mock dispon\xEDvel e JWT sem sub v\xE1lido");
   }
   /**
    * Mock de `handleRedirectCallback` (Bug 2 / 3.1.3) — não há redirect real no
@@ -6094,13 +6113,20 @@ function createOidcAuthNamespace(config) {
       const issuer = idpOrigin;
       const jwksUrl = `${idpOrigin}/api/v1/oauth/.well-known/jwks.json`;
       const cacheTtlMs = options?.jwksCacheTtlMs ?? DEFAULT_JWKS_TTL_MS;
+      const audienceFromOptions = options?.audience;
       const parsedKey = tryParseApiKey(config.apiKey);
-      const audience = parsedKey?.keyId;
+      const audience = audienceFromOptions ?? parsedKey?.keyId;
+      if (!audience) {
+        throw new NeetruError(
+          "invalid_config",
+          "verifyToken requires an audience: provide apiKey on the client or pass options.audience. Calling jwtVerify without an audience allows tokens issued for other OIDC clients to pass."
+        );
+      }
       const jwks = _getJwks(jwksUrl, cacheTtlMs);
       try {
         const { payload } = await jose.jwtVerify(token, jwks, {
           issuer,
-          ...audience ? { audience } : {},
+          audience,
           algorithms: ["RS256"]
         });
         return _jwtPayloadToUser(payload);