@neetru/sdk 3.1.14 → 3.1.15

package/dist/build-guard.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+
+// src/build-guard.ts
+function withNeetruBuildGuard(nextConfig, options = {}) {
+  const prevWebpack = nextConfig.webpack;
+  return {
+    ...nextConfig,
+    webpack(config, context) {
+      const result = typeof prevWebpack === "function" ? prevWebpack(config, context) : config;
+      if (!context.dev && context.isServer) {
+        try {
+          const outDir = path__namespace.resolve(process.cwd(), options.outputDir ?? ".next");
+          fs__namespace.mkdirSync(outDir, { recursive: true });
+          const manifest = {
+            builtEnv: process.env.NEXT_PUBLIC_NEETRU_ENV ?? null,
+            productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID ?? null,
+            oidcClientId: process.env.NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID ?? null,
+            builtAt: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          fs__namespace.writeFileSync(
+            path__namespace.join(outDir, "neetru-build-manifest.json"),
+            JSON.stringify(manifest, null, 2),
+            "utf8"
+          );
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              "[neetru-sdk] withNeetruBuildGuard: falha ao gravar neetru-build-manifest.json (ignorado, build segue):",
+              err
+            );
+          }
+        }
+      }
+      return result;
+    }
+  };
+}
+
+exports.withNeetruBuildGuard = withNeetruBuildGuard;
+//# sourceMappingURL=build-guard.cjs.map
+//# sourceMappingURL=build-guard.cjs.map

package/dist/build-guard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build-guard.ts"],"names":["path","fs"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFO,SAAS,oBAAA,CACd,UAAA,EACA,OAAA,GAAuC,EAAC,EACrC;AACH,EAAA,MAAM,cAAc,UAAA,CAAW,OAAA;AAE/B,EAAA,OAAO;AAAA,IACL,GAAG,UAAA;AAAA,IACH,OAAA,CAAQ,QAAiB,OAAA,EAAyC;AAChE,MAAA,MAAM,SAAS,OAAO,WAAA,KAAgB,aAAa,WAAA,CAAY,MAAA,EAAQ,OAAO,CAAA,GAAI,MAAA;AAKlF,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,QAAA,EAAU;AACpC,QAAA,IAAI;AACF,UAAA,MAAM,SAAcA,eAAA,CAAA,OAAA,CAAQ,OAAA,CAAQ,KAAI,EAAG,OAAA,CAAQ,aAAa,OAAO,CAAA;AACvE,UAAGC,aAAA,CAAA,SAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACxC,UAAA,MAAM,QAAA,GAAgC;AAAA,YACpC,QAAA,EAAU,OAAA,CAAQ,GAAA,CAAI,sBAAA,IAA0B,IAAA;AAAA,YAChD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,6BAAA,IAAiC,IAAA;AAAA,YACxD,YAAA,EAAc,OAAA,CAAQ,GAAA,CAAI,iCAAA,IAAqC,IAAA;AAAA,YAC/D,OAAA,EAAA,iBAAS,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,WAClC;AACA,UAAGA,aAAA,CAAA,aAAA;AAAA,YACID,eAAA,CAAA,IAAA,CAAK,QAAQ,4BAA4B,CAAA;AAAA,YAC9C,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,IAAA,EAAM,CAAC,CAAA;AAAA,YAChC;AAAA,WACF;AAAA,QACF,SAAS,GAAA,EAAK;AAMZ,UAAA,IAAI,OAAO,YAAY,WAAA,EAAa;AAClC,YAAA,OAAA,CAAQ,IAAA;AAAA,cACN,wGAAA;AAAA,cACA;AAAA,aACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF","file":"build-guard.cjs","sourcesContent":["/**\r\n * `withNeetruBuildGuard` — wrapper de `next.config.mjs` que grava\r\n * `.next/neetru-build-manifest.json` ao final do build com os valores\r\n * `NEXT_PUBLIC_NEETRU_*` que realmente foram resolvidos pelo Next.js.\r\n *\r\n * Existe pra fechar um bug de precedência de env do Next.js (incidente\r\n * 2026-07-22, pdv-agiliza): `.env.local` (fica no disco do dev) vence\r\n * `.env.production` durante `next build` pra qualquer chave em comum —\r\n * então um build \"de prod\" podia compilar com `NEXT_PUBLIC_NEETRU_ENV=dev`\r\n * sem nenhum aviso, ativando `MockAuth` no bundle do browser em produção\r\n * (o botão \"Entrar com Neetru\" não fazia nada, porque `MockAuth.signIn()`\r\n * só finge um login em memória — nunca navega pro IdP real).\r\n *\r\n * O manifesto não inspeciona o JS compilado (minificação/webpack\r\n * `DefinePlugin` tornam isso frágil — o nome da chave some, só sobra o\r\n * literal). Em vez disso grava, em texto puro, o que o processo Node do\r\n * build efetivamente tinha em `process.env` no momento da compilação\r\n * server-side — reflete fielmente a resolução real do Next.js/dotenv,\r\n * incluindo qualquer override via spawn-env (`@neetru/cli` injeta\r\n * `NEXT_PUBLIC_NEETRU_ENV` assim desde a v2.26.2). `neetru build` lê este\r\n * arquivo depois do build e recusa empacotar o tarball se o valor não\r\n * bater com o ambiente esperado do deploy.\r\n *\r\n * Uso, em `next.config.mjs`:\r\n * ```js\r\n * import { withNeetruBuildGuard } from '@neetru/sdk/build-guard';\r\n * export default withNeetruBuildGuard({ ...nextConfig });\r\n * ```\r\n *\r\n * Subpath dedicado (`@neetru/sdk/build-guard`, não o barrel `.`) de\r\n * propósito: este arquivo é o único no SDK que importa `node:fs`/`node:path`\r\n * estaticamente. O entry `.` promete rodar em browser/Node/Edge sem Node\r\n * builtins — reexportar o guard ali vazaria essa dependência pro bundle\r\n * universal (achado real da revisão: `esbuild --platform=browser` falha com\r\n * \"Could not resolve fs/path\" se o guard entra no barrel principal).\r\n *\r\n * IMPORTANTE — isto NÃO é uma checagem universal de \"o env está certo\": o\r\n * guard grava literalmente as 3 env vars `NEXT_PUBLIC_NEETRU_ENV` /\r\n * `_PRODUCT_ID` / `_OIDC_CLIENT_ID`, que são a convenção recomendada de\r\n * bootstrap Next.js do ecossistema Neetru (o que `neetru-pdvagiliza` e\r\n * outros produtos usam em `src/lib/neetru/client.ts` pra montar\r\n * `createNeetruClient({env, productId, oidcClientId})`) — **não** é o mesmo\r\n * que o fallback interno `NEETRU_ENV`/`globalThis.NEETRU_ENV` que\r\n * `resolveEnv()` (`src/auth.ts`) usa quando NENHUM `env` é passado\r\n * explicitamente pro client. Se o seu produto bootstrap o client de outra\r\n * forma (nome de env var diferente, ou sem prefixo `NEXT_PUBLIC_`, ou\r\n * hardcoded), este guard não detecta drift pra esse caso — ele só confirma\r\n * que a convenção documentada acima foi respeitada.\r\n *\r\n * Composável com qualquer wrapper que já use a chave `webpack` do config\r\n * (ex: `next-pwa`) — a função `webpack` anterior, se houver, é chamada\r\n * primeiro e o retorno dela é repassado adiante sem alteração.\r\n */\r\nimport * as fs from 'node:fs';\r\nimport * as path from 'node:path';\r\n\r\n/** Formato do `.next/neetru-build-manifest.json`. */\r\nexport interface NeetruBuildManifest {\r\n  /** `NEXT_PUBLIC_NEETRU_ENV` resolvido no momento do build (`dev|workspace|prod`), ou `null` se ausente. */\r\n  builtEnv: string | null;\r\n  /** `NEXT_PUBLIC_NEETRU_PRODUCT_ID` resolvido, ou `null`. */\r\n  productId: string | null;\r\n  /** `NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID` resolvido, ou `null`. */\r\n  oidcClientId: string | null;\r\n  /** ISO timestamp de quando o manifesto foi gravado. */\r\n  builtAt: string;\r\n}\r\n\r\nexport interface WithNeetruBuildGuardOptions {\r\n  /** Diretório de saída do Next (default `.next`, relativo ao cwd do build). */\r\n  outputDir?: string;\r\n}\r\n\r\n/**\r\n * Formato mínimo de `next.config.mjs` que o wrapper precisa entender — só\r\n * o suficiente pra compor a chave `webpack` sem acoplar o SDK ao pacote\r\n * `next` como dependência de tipos.\r\n */\r\ntype MinimalWebpackContext = {\r\n  buildId: string;\r\n  dev: boolean;\r\n  isServer: boolean;\r\n  [key: string]: unknown;\r\n};\r\ntype MinimalNextConfig = Record<string, unknown> & {\r\n  webpack?: (config: unknown, context: MinimalWebpackContext) => unknown;\r\n};\r\n\r\nexport function withNeetruBuildGuard<T extends MinimalNextConfig>(\r\n  nextConfig: T,\r\n  options: WithNeetruBuildGuardOptions = {},\r\n): T {\r\n  const prevWebpack = nextConfig.webpack;\r\n\r\n  return {\r\n    ...nextConfig,\r\n    webpack(config: unknown, context: MinimalWebpackContext): unknown {\r\n      const result = typeof prevWebpack === 'function' ? prevWebpack(config, context) : config;\r\n\r\n      // Grava só na passada server (roda 1x por build, diferente da passada\r\n      // client que pode rodar múltiplas vezes) e só fora de `next dev` —\r\n      // `next build` é sempre produção de artefato de deploy.\r\n      if (!context.dev && context.isServer) {\r\n        try {\r\n          const outDir = path.resolve(process.cwd(), options.outputDir ?? '.next');\r\n          fs.mkdirSync(outDir, { recursive: true });\r\n          const manifest: NeetruBuildManifest = {\r\n            builtEnv: process.env.NEXT_PUBLIC_NEETRU_ENV ?? null,\r\n            productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID ?? null,\r\n            oidcClientId: process.env.NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID ?? null,\r\n            builtAt: new Date().toISOString(),\r\n          };\r\n          fs.writeFileSync(\r\n            path.join(outDir, 'neetru-build-manifest.json'),\r\n            JSON.stringify(manifest, null, 2),\r\n            'utf8',\r\n          );\r\n        } catch (err) {\r\n          // Best-effort — o guard nunca pode quebrar o build do produto,\r\n          // mas uma falha de escrita silenciosa aqui esconderia o problema\r\n          // (achado da revisão: sem log, ninguém percebe que o manifesto não\r\n          // foi gravado e `neetru build` trata \"manifesto ausente\" como\r\n          // aviso, não bloqueio — visibilidade aqui é a única forma de notar).\r\n          if (typeof console !== 'undefined') {\r\n            console.warn(\r\n              '[neetru-sdk] withNeetruBuildGuard: falha ao gravar neetru-build-manifest.json (ignorado, build segue):',\r\n              err,\r\n            );\r\n          }\r\n        }\r\n      }\r\n\r\n      return result;\r\n    },\r\n  } as T;\r\n}\r\n"]}

package/dist/build-guard.d.cts

@@ -0,0 +1,32 @@
+/** Formato do `.next/neetru-build-manifest.json`. */
+interface NeetruBuildManifest {
+    /** `NEXT_PUBLIC_NEETRU_ENV` resolvido no momento do build (`dev|workspace|prod`), ou `null` se ausente. */
+    builtEnv: string | null;
+    /** `NEXT_PUBLIC_NEETRU_PRODUCT_ID` resolvido, ou `null`. */
+    productId: string | null;
+    /** `NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID` resolvido, ou `null`. */
+    oidcClientId: string | null;
+    /** ISO timestamp de quando o manifesto foi gravado. */
+    builtAt: string;
+}
+interface WithNeetruBuildGuardOptions {
+    /** Diretório de saída do Next (default `.next`, relativo ao cwd do build). */
+    outputDir?: string;
+}
+/**
+ * Formato mínimo de `next.config.mjs` que o wrapper precisa entender — só
+ * o suficiente pra compor a chave `webpack` sem acoplar o SDK ao pacote
+ * `next` como dependência de tipos.
+ */
+type MinimalWebpackContext = {
+    buildId: string;
+    dev: boolean;
+    isServer: boolean;
+    [key: string]: unknown;
+};
+type MinimalNextConfig = Record<string, unknown> & {
+    webpack?: (config: unknown, context: MinimalWebpackContext) => unknown;
+};
+declare function withNeetruBuildGuard<T extends MinimalNextConfig>(nextConfig: T, options?: WithNeetruBuildGuardOptions): T;
+
+export { type NeetruBuildManifest, type WithNeetruBuildGuardOptions, withNeetruBuildGuard };

package/dist/build-guard.d.ts

@@ -0,0 +1,32 @@
+/** Formato do `.next/neetru-build-manifest.json`. */
+interface NeetruBuildManifest {
+    /** `NEXT_PUBLIC_NEETRU_ENV` resolvido no momento do build (`dev|workspace|prod`), ou `null` se ausente. */
+    builtEnv: string | null;
+    /** `NEXT_PUBLIC_NEETRU_PRODUCT_ID` resolvido, ou `null`. */
+    productId: string | null;
+    /** `NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID` resolvido, ou `null`. */
+    oidcClientId: string | null;
+    /** ISO timestamp de quando o manifesto foi gravado. */
+    builtAt: string;
+}
+interface WithNeetruBuildGuardOptions {
+    /** Diretório de saída do Next (default `.next`, relativo ao cwd do build). */
+    outputDir?: string;
+}
+/**
+ * Formato mínimo de `next.config.mjs` que o wrapper precisa entender — só
+ * o suficiente pra compor a chave `webpack` sem acoplar o SDK ao pacote
+ * `next` como dependência de tipos.
+ */
+type MinimalWebpackContext = {
+    buildId: string;
+    dev: boolean;
+    isServer: boolean;
+    [key: string]: unknown;
+};
+type MinimalNextConfig = Record<string, unknown> & {
+    webpack?: (config: unknown, context: MinimalWebpackContext) => unknown;
+};
+declare function withNeetruBuildGuard<T extends MinimalNextConfig>(nextConfig: T, options?: WithNeetruBuildGuardOptions): T;
+
+export { type NeetruBuildManifest, type WithNeetruBuildGuardOptions, withNeetruBuildGuard };

package/dist/build-guard.mjs

@@ -0,0 +1,42 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+// src/build-guard.ts
+function withNeetruBuildGuard(nextConfig, options = {}) {
+  const prevWebpack = nextConfig.webpack;
+  return {
+    ...nextConfig,
+    webpack(config, context) {
+      const result = typeof prevWebpack === "function" ? prevWebpack(config, context) : config;
+      if (!context.dev && context.isServer) {
+        try {
+          const outDir = path.resolve(process.cwd(), options.outputDir ?? ".next");
+          fs.mkdirSync(outDir, { recursive: true });
+          const manifest = {
+            builtEnv: process.env.NEXT_PUBLIC_NEETRU_ENV ?? null,
+            productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID ?? null,
+            oidcClientId: process.env.NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID ?? null,
+            builtAt: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          fs.writeFileSync(
+            path.join(outDir, "neetru-build-manifest.json"),
+            JSON.stringify(manifest, null, 2),
+            "utf8"
+          );
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              "[neetru-sdk] withNeetruBuildGuard: falha ao gravar neetru-build-manifest.json (ignorado, build segue):",
+              err
+            );
+          }
+        }
+      }
+      return result;
+    }
+  };
+}
+
+export { withNeetruBuildGuard };
+//# sourceMappingURL=build-guard.mjs.map
+//# sourceMappingURL=build-guard.mjs.map

package/dist/build-guard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build-guard.ts"],"names":[],"mappings":";;;;AAwFO,SAAS,oBAAA,CACd,UAAA,EACA,OAAA,GAAuC,EAAC,EACrC;AACH,EAAA,MAAM,cAAc,UAAA,CAAW,OAAA;AAE/B,EAAA,OAAO;AAAA,IACL,GAAG,UAAA;AAAA,IACH,OAAA,CAAQ,QAAiB,OAAA,EAAyC;AAChE,MAAA,MAAM,SAAS,OAAO,WAAA,KAAgB,aAAa,WAAA,CAAY,MAAA,EAAQ,OAAO,CAAA,GAAI,MAAA;AAKlF,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,QAAA,EAAU;AACpC,QAAA,IAAI;AACF,UAAA,MAAM,SAAc,IAAA,CAAA,OAAA,CAAQ,OAAA,CAAQ,KAAI,EAAG,OAAA,CAAQ,aAAa,OAAO,CAAA;AACvE,UAAG,EAAA,CAAA,SAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACxC,UAAA,MAAM,QAAA,GAAgC;AAAA,YACpC,QAAA,EAAU,OAAA,CAAQ,GAAA,CAAI,sBAAA,IAA0B,IAAA;AAAA,YAChD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,6BAAA,IAAiC,IAAA;AAAA,YACxD,YAAA,EAAc,OAAA,CAAQ,GAAA,CAAI,iCAAA,IAAqC,IAAA;AAAA,YAC/D,OAAA,EAAA,iBAAS,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,WAClC;AACA,UAAG,EAAA,CAAA,aAAA;AAAA,YACI,IAAA,CAAA,IAAA,CAAK,QAAQ,4BAA4B,CAAA;AAAA,YAC9C,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,IAAA,EAAM,CAAC,CAAA;AAAA,YAChC;AAAA,WACF;AAAA,QACF,SAAS,GAAA,EAAK;AAMZ,UAAA,IAAI,OAAO,YAAY,WAAA,EAAa;AAClC,YAAA,OAAA,CAAQ,IAAA;AAAA,cACN,wGAAA;AAAA,cACA;AAAA,aACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF","file":"build-guard.mjs","sourcesContent":["/**\r\n * `withNeetruBuildGuard` — wrapper de `next.config.mjs` que grava\r\n * `.next/neetru-build-manifest.json` ao final do build com os valores\r\n * `NEXT_PUBLIC_NEETRU_*` que realmente foram resolvidos pelo Next.js.\r\n *\r\n * Existe pra fechar um bug de precedência de env do Next.js (incidente\r\n * 2026-07-22, pdv-agiliza): `.env.local` (fica no disco do dev) vence\r\n * `.env.production` durante `next build` pra qualquer chave em comum —\r\n * então um build \"de prod\" podia compilar com `NEXT_PUBLIC_NEETRU_ENV=dev`\r\n * sem nenhum aviso, ativando `MockAuth` no bundle do browser em produção\r\n * (o botão \"Entrar com Neetru\" não fazia nada, porque `MockAuth.signIn()`\r\n * só finge um login em memória — nunca navega pro IdP real).\r\n *\r\n * O manifesto não inspeciona o JS compilado (minificação/webpack\r\n * `DefinePlugin` tornam isso frágil — o nome da chave some, só sobra o\r\n * literal). Em vez disso grava, em texto puro, o que o processo Node do\r\n * build efetivamente tinha em `process.env` no momento da compilação\r\n * server-side — reflete fielmente a resolução real do Next.js/dotenv,\r\n * incluindo qualquer override via spawn-env (`@neetru/cli` injeta\r\n * `NEXT_PUBLIC_NEETRU_ENV` assim desde a v2.26.2). `neetru build` lê este\r\n * arquivo depois do build e recusa empacotar o tarball se o valor não\r\n * bater com o ambiente esperado do deploy.\r\n *\r\n * Uso, em `next.config.mjs`:\r\n * ```js\r\n * import { withNeetruBuildGuard } from '@neetru/sdk/build-guard';\r\n * export default withNeetruBuildGuard({ ...nextConfig });\r\n * ```\r\n *\r\n * Subpath dedicado (`@neetru/sdk/build-guard`, não o barrel `.`) de\r\n * propósito: este arquivo é o único no SDK que importa `node:fs`/`node:path`\r\n * estaticamente. O entry `.` promete rodar em browser/Node/Edge sem Node\r\n * builtins — reexportar o guard ali vazaria essa dependência pro bundle\r\n * universal (achado real da revisão: `esbuild --platform=browser` falha com\r\n * \"Could not resolve fs/path\" se o guard entra no barrel principal).\r\n *\r\n * IMPORTANTE — isto NÃO é uma checagem universal de \"o env está certo\": o\r\n * guard grava literalmente as 3 env vars `NEXT_PUBLIC_NEETRU_ENV` /\r\n * `_PRODUCT_ID` / `_OIDC_CLIENT_ID`, que são a convenção recomendada de\r\n * bootstrap Next.js do ecossistema Neetru (o que `neetru-pdvagiliza` e\r\n * outros produtos usam em `src/lib/neetru/client.ts` pra montar\r\n * `createNeetruClient({env, productId, oidcClientId})`) — **não** é o mesmo\r\n * que o fallback interno `NEETRU_ENV`/`globalThis.NEETRU_ENV` que\r\n * `resolveEnv()` (`src/auth.ts`) usa quando NENHUM `env` é passado\r\n * explicitamente pro client. Se o seu produto bootstrap o client de outra\r\n * forma (nome de env var diferente, ou sem prefixo `NEXT_PUBLIC_`, ou\r\n * hardcoded), este guard não detecta drift pra esse caso — ele só confirma\r\n * que a convenção documentada acima foi respeitada.\r\n *\r\n * Composável com qualquer wrapper que já use a chave `webpack` do config\r\n * (ex: `next-pwa`) — a função `webpack` anterior, se houver, é chamada\r\n * primeiro e o retorno dela é repassado adiante sem alteração.\r\n */\r\nimport * as fs from 'node:fs';\r\nimport * as path from 'node:path';\r\n\r\n/** Formato do `.next/neetru-build-manifest.json`. */\r\nexport interface NeetruBuildManifest {\r\n  /** `NEXT_PUBLIC_NEETRU_ENV` resolvido no momento do build (`dev|workspace|prod`), ou `null` se ausente. */\r\n  builtEnv: string | null;\r\n  /** `NEXT_PUBLIC_NEETRU_PRODUCT_ID` resolvido, ou `null`. */\r\n  productId: string | null;\r\n  /** `NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID` resolvido, ou `null`. */\r\n  oidcClientId: string | null;\r\n  /** ISO timestamp de quando o manifesto foi gravado. */\r\n  builtAt: string;\r\n}\r\n\r\nexport interface WithNeetruBuildGuardOptions {\r\n  /** Diretório de saída do Next (default `.next`, relativo ao cwd do build). */\r\n  outputDir?: string;\r\n}\r\n\r\n/**\r\n * Formato mínimo de `next.config.mjs` que o wrapper precisa entender — só\r\n * o suficiente pra compor a chave `webpack` sem acoplar o SDK ao pacote\r\n * `next` como dependência de tipos.\r\n */\r\ntype MinimalWebpackContext = {\r\n  buildId: string;\r\n  dev: boolean;\r\n  isServer: boolean;\r\n  [key: string]: unknown;\r\n};\r\ntype MinimalNextConfig = Record<string, unknown> & {\r\n  webpack?: (config: unknown, context: MinimalWebpackContext) => unknown;\r\n};\r\n\r\nexport function withNeetruBuildGuard<T extends MinimalNextConfig>(\r\n  nextConfig: T,\r\n  options: WithNeetruBuildGuardOptions = {},\r\n): T {\r\n  const prevWebpack = nextConfig.webpack;\r\n\r\n  return {\r\n    ...nextConfig,\r\n    webpack(config: unknown, context: MinimalWebpackContext): unknown {\r\n      const result = typeof prevWebpack === 'function' ? prevWebpack(config, context) : config;\r\n\r\n      // Grava só na passada server (roda 1x por build, diferente da passada\r\n      // client que pode rodar múltiplas vezes) e só fora de `next dev` —\r\n      // `next build` é sempre produção de artefato de deploy.\r\n      if (!context.dev && context.isServer) {\r\n        try {\r\n          const outDir = path.resolve(process.cwd(), options.outputDir ?? '.next');\r\n          fs.mkdirSync(outDir, { recursive: true });\r\n          const manifest: NeetruBuildManifest = {\r\n            builtEnv: process.env.NEXT_PUBLIC_NEETRU_ENV ?? null,\r\n            productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID ?? null,\r\n            oidcClientId: process.env.NEXT_PUBLIC_NEETRU_OIDC_CLIENT_ID ?? null,\r\n            builtAt: new Date().toISOString(),\r\n          };\r\n          fs.writeFileSync(\r\n            path.join(outDir, 'neetru-build-manifest.json'),\r\n            JSON.stringify(manifest, null, 2),\r\n            'utf8',\r\n          );\r\n        } catch (err) {\r\n          // Best-effort — o guard nunca pode quebrar o build do produto,\r\n          // mas uma falha de escrita silenciosa aqui esconderia o problema\r\n          // (achado da revisão: sem log, ninguém percebe que o manifesto não\r\n          // foi gravado e `neetru build` trata \"manifesto ausente\" como\r\n          // aviso, não bloqueio — visibilidade aqui é a única forma de notar).\r\n          if (typeof console !== 'undefined') {\r\n            console.warn(\r\n              '[neetru-sdk] withNeetruBuildGuard: falha ao gravar neetru-build-manifest.json (ignorado, build segue):',\r\n              err,\r\n            );\r\n          }\r\n        }\r\n      }\r\n\r\n      return result;\r\n    },\r\n  } as T;\r\n}\r\n"]}

package/dist/index.cjs

@@ -7122,7 +7122,7 @@ function createNeetruClient(config = {}) {
 init_errors();
 init_db_errors();
 init_http();
-var VERSION = "3.1.13";
+var VERSION = "3.1.15";
 
 exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
 exports.DEV_FIXTURE_USER = DEV_FIXTURE_USER;