@neetru/sdk 1.0.0 → 1.1.1

package/dist/mocks.d.cts

@@ -1,4 +1,4 @@
-import { j as NeetruUser, A as AuthNamespace, S as SignInOptions, b as AuthStateListener, g as DbNamespace, e as DbCollectionRef, E as EntitlementCheck, m as SupportNamespace, d as CreateTicketInput, p as SupportTicket, r as UsageNamespace, s as UsageQuota } from './types-PKUaFtBY.cjs';
+import { p as NeetruUser, A as AuthNamespace, S as SignInOptions, b as AuthStateListener, m as DbNamespace, k as DbCollectionRef, E as EntitlementCheck, s as SupportNamespace, j as CreateTicketInput, v as SupportTicket, x as UsageNamespace, y as UsageQuota } from './types-BA53dd8S.cjs';
 
 /**
  * Mocks determinísticos do SDK — overridáveis em tests do consumer ou

package/dist/mocks.d.ts

@@ -1,4 +1,4 @@
-import { j as NeetruUser, A as AuthNamespace, S as SignInOptions, b as AuthStateListener, g as DbNamespace, e as DbCollectionRef, E as EntitlementCheck, m as SupportNamespace, d as CreateTicketInput, p as SupportTicket, r as UsageNamespace, s as UsageQuota } from './types-PKUaFtBY.js';
+import { p as NeetruUser, A as AuthNamespace, S as SignInOptions, b as AuthStateListener, m as DbNamespace, k as DbCollectionRef, E as EntitlementCheck, s as SupportNamespace, j as CreateTicketInput, v as SupportTicket, x as UsageNamespace, y as UsageQuota } from './types-BA53dd8S.js';
 
 /**
  * Mocks determinísticos do SDK — overridáveis em tests do consumer ou

package/dist/react.cjs

@@ -0,0 +1,158 @@
+'use strict';
+
+var React = require('react');
+
+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 React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/react.ts
+function CheckoutLink({
+  client,
+  productId,
+  planId,
+  callbackUrl,
+  tenantType,
+  tenantId,
+  children,
+  onIntentCreated,
+  onError,
+  noAutoRedirect,
+  ...rest
+}) {
+  const [submitting, setSubmitting] = React__namespace.useState(false);
+  const checkout = client.checkout;
+  const handleClick = React__namespace.useCallback(
+    async (event) => {
+      event.preventDefault();
+      if (submitting) return;
+      if (!checkout || typeof checkout.start !== "function") {
+        onError?.(new Error("SDK client missing `checkout` namespace. Upgrade @neetru/sdk to 1.1+."));
+        return;
+      }
+      setSubmitting(true);
+      try {
+        const result = await checkout.start({
+          productId,
+          planId,
+          callbackUrl,
+          tenantType,
+          tenantId,
+          autoRedirect: !noAutoRedirect
+        });
+        onIntentCreated?.(result);
+      } catch (err) {
+        onError?.(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        setSubmitting(false);
+      }
+    },
+    [submitting, checkout, productId, planId, callbackUrl, tenantType, tenantId, noAutoRedirect, onIntentCreated, onError]
+  );
+  return React__namespace.createElement(
+    "a",
+    {
+      ...rest,
+      href: rest.href ?? "#",
+      onClick: handleClick,
+      "aria-busy": submitting || void 0,
+      "data-neetru-checkout-link": "true"
+    },
+    children
+  );
+}
+var EntitlementContext = React__namespace.createContext({
+  readonly: false
+});
+function useEntitlementContext() {
+  return React__namespace.useContext(EntitlementContext);
+}
+function EntitlementGate({
+  client,
+  feature,
+  productSlug,
+  mode = "block",
+  fallback,
+  loading,
+  children
+}) {
+  const [state, setState] = React__namespace.useState({
+    status: "loading"
+  });
+  const resolvedSlug = productSlug ?? client.config.productId ?? "";
+  React__namespace.useEffect(() => {
+    let cancelled = false;
+    const run = async () => {
+      try {
+        let result2;
+        const usage = client.usage;
+        if (usage && typeof usage.check === "function") {
+          const res = await usage.check(feature, { productId: resolvedSlug });
+          result2 = {
+            allowed: res.allowed === true,
+            reason: res.reason,
+            limit: res.limit,
+            currentUsage: res.currentUsage,
+            behavior: res.behavior
+          };
+        } else {
+          const allowed2 = await client.entitlements.check(resolvedSlug, feature);
+          result2 = { allowed: allowed2 };
+        }
+        if (!cancelled) setState({ status: "ready", result: result2 });
+      } catch (err) {
+        if (!cancelled) {
+          setState({ status: "ready", result: { allowed: false, reason: "check_failed" } });
+        }
+        if (typeof console !== "undefined") console.warn("[EntitlementGate] check failed", err);
+      }
+    };
+    run();
+    return () => {
+      cancelled = true;
+    };
+  }, [client, feature, resolvedSlug]);
+  if (state.status === "loading") {
+    return React__namespace.createElement(React__namespace.Fragment, null, loading ?? null);
+  }
+  const result = state.result;
+  const allowed = result?.allowed === true;
+  const isReadonly = !allowed && (mode === "readonly" || result?.behavior === "readonly");
+  if (!allowed && mode === "block" && !isReadonly) {
+    return React__namespace.createElement(React__namespace.Fragment, null, fallback ?? null);
+  }
+  return React__namespace.createElement(
+    EntitlementContext.Provider,
+    {
+      value: {
+        readonly: isReadonly,
+        reason: result?.reason,
+        limit: result?.limit,
+        currentUsage: result?.currentUsage
+      }
+    },
+    children
+  );
+}
+
+exports.CheckoutLink = CheckoutLink;
+exports.EntitlementGate = EntitlementGate;
+exports.useEntitlementContext = useEntitlementContext;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"names":["React","result","allowed"],"mappings":"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","file":"react.cjs","sourcesContent":["/**\n * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.\n *\n * Helpers leves pra React 18+/19. Não puxa `react` como dep direta — caller\n * fornece via peer (alinhado com `@stripe/react-stripe-js` / `firebase`).\n *\n * Exports:\n *   - `<CheckoutLink>` — wrapper de `<a>` que chama `client.checkout.start()` no click.\n *   - `<EntitlementGate>` — wrapper que gateia children por entitlement check\n *     (suporte a `mode='readonly'` pro decisão CEO §5).\n *   - `useEntitlementContext()` — hook pra ler estado de readonly do contexto.\n *\n * **Bundle**: este file SÓ é carregado por quem importa `@neetru/sdk/react`.\n * Tree-shake garante que SDK consumers Node-only (CLI, edge handlers) não\n * puxam React mesmo via transitive.\n */\nimport * as React from 'react';\nimport type { NeetruClient } from './types';\nimport type { CheckoutStartInput, CheckoutStartResult } from './checkout';\n\n// ─── <CheckoutLink> ─────────────────────────────────────────────────────────\n\nexport interface CheckoutLinkProps\n  extends Omit<\n    React.AnchorHTMLAttributes<HTMLAnchorElement>,\n    'href' | 'onClick' | 'onError'\n  > {\n  /** Cliente SDK Neetru. Passado explicitamente pra evitar context provider. */\n  client: NeetruClient;\n  /** Slug do produto (ex: `neetru-pulse`). */\n  productId: string;\n  /** Plan id (ex: `pro_monthly`). */\n  planId: string;\n  /** Pra onde o produto SaaS quer voltar pós-checkout. */\n  callbackUrl: string;\n  /** Override pra checkout em nome de uma org. Default: PF do uid logado. */\n  tenantType?: 'pf' | 'pj';\n  tenantId?: string;\n  /** Children — texto/JSX do CTA. */\n  children: React.ReactNode;\n  /** Callback quando intent foi criada (antes de redirect). */\n  onIntentCreated?: (result: CheckoutStartResult) => void;\n  /** Callback de erro. */\n  onError?: (err: Error) => void;\n  /** Quando true, NÃO redireciona automaticamente — caller controla. */\n  noAutoRedirect?: boolean;\n  /** Override de href (default: `#`). */\n  href?: string;\n}\n\n/**\n * Wrapper de `<a>` que dispara `client.checkout.start()` no click.\n *\n * Uso típico:\n * ```tsx\n * <CheckoutLink\n *   client={client}\n *   productId=\"meu-saas\"\n *   planId=\"pro_monthly\"\n *   callbackUrl=\"https://meu-saas.com/billing/success\"\n * >\n *   Assinar Pro\n * </CheckoutLink>\n * ```\n *\n * `href` é stub (`#`) — preventDefault no click. Mantido pra a11y / preview\n * de URL no hover (pode ser sobrescrito via prop spread).\n */\nexport function CheckoutLink({\n  client,\n  productId,\n  planId,\n  callbackUrl,\n  tenantType,\n  tenantId,\n  children,\n  onIntentCreated,\n  onError,\n  noAutoRedirect,\n  ...rest\n}: CheckoutLinkProps): React.ReactElement {\n  const [submitting, setSubmitting] = React.useState(false);\n\n  // Lazy access — `client.checkout` foi adicionado em SDK 1.1, fall back gracioso\n  // se caller passar um client antigo (mesmo que types resolvam, runtime check).\n  const checkout = (client as { checkout?: { start: (input: CheckoutStartInput) => Promise<CheckoutStartResult> } }).checkout;\n\n  const handleClick = React.useCallback(\n    async (event: React.MouseEvent<HTMLAnchorElement>) => {\n      event.preventDefault();\n      if (submitting) return;\n      if (!checkout || typeof checkout.start !== 'function') {\n        onError?.(new Error('SDK client missing `checkout` namespace. Upgrade @neetru/sdk to 1.1+.'));\n        return;\n      }\n      setSubmitting(true);\n      try {\n        const result = await checkout.start({\n          productId,\n          planId,\n          callbackUrl,\n          tenantType,\n          tenantId,\n          autoRedirect: !noAutoRedirect,\n        });\n        onIntentCreated?.(result);\n      } catch (err) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        setSubmitting(false);\n      }\n    },\n    [submitting, checkout, productId, planId, callbackUrl, tenantType, tenantId, noAutoRedirect, onIntentCreated, onError],\n  );\n\n  return React.createElement(\n    'a',\n    {\n      ...rest,\n      href: rest.href ?? '#',\n      onClick: handleClick,\n      'aria-busy': submitting || undefined,\n      'data-neetru-checkout-link': 'true',\n    },\n    children,\n  );\n}\n\n// ─── <EntitlementGate> + useEntitlementContext ────────────────────────────\n\n/** Modo de gate quando entitlement não é permitido. */\nexport type EntitlementGateMode = 'block' | 'readonly';\n\ninterface EntitlementContextValue {\n  /** True quando feature está em modo read-only (limit exceeded). */\n  readonly: boolean;\n  /** Reason code da última check. */\n  reason?: string;\n  /** Limite atual (free tier). */\n  limit?: number;\n  /** Uso atual. */\n  currentUsage?: number;\n}\n\nconst EntitlementContext = React.createContext<EntitlementContextValue>({\n  readonly: false,\n});\n\n/** Hook pra ler estado de readonly. Componentes filhos consomem isso pra\n * desabilitar inputs/botões de escrita. */\nexport function useEntitlementContext(): EntitlementContextValue {\n  return React.useContext(EntitlementContext);\n}\n\nexport interface EntitlementGateProps {\n  /** Cliente SDK Neetru. */\n  client: NeetruClient;\n  /** Feature key a checar (ex: `export.csv`). */\n  feature: string;\n  /** Slug do produto. Default: lê do client.config se ausente. */\n  productSlug?: string;\n  /** Modo:\n   *  - `block` (default): renderiza fallback quando não permitido.\n   *  - `readonly`: sempre renderiza children mas injeta `readonly: true` no contexto. */\n  mode?: EntitlementGateMode;\n  /** Fallback UI quando `mode='block'` e check retorna `allowed=false`. */\n  fallback?: React.ReactNode;\n  /** Loading UI enquanto check resolve (Suspense-like). */\n  loading?: React.ReactNode;\n  children: React.ReactNode;\n}\n\ninterface EntitlementCheckResult {\n  allowed: boolean;\n  reason?: string;\n  limit?: number;\n  currentUsage?: number;\n  behavior?: 'readonly' | null;\n}\n\n/**\n * Wrapper que gateia children por entitlement check.\n *\n * Quando `mode='readonly'` + check retorna `behavior='readonly'`:\n *   - Children renderizam normalmente.\n *   - Context injeta `{readonly: true}`.\n *   - Componentes filhos chamam `useEntitlementContext()` pra desabilitar\n *     escritas (botões, forms, inputs).\n *\n * Quando `mode='block'` + check retorna `allowed=false`:\n *   - `fallback` é renderizado (ex: paywall, upsell modal).\n *\n * Decisão CEO §5 (overage): plataforma usa `readonly` sempre — produto SaaS\n * deve preferir `mode='readonly'` pra preservar engajamento (não hard-block).\n */\nexport function EntitlementGate({\n  client,\n  feature,\n  productSlug,\n  mode = 'block',\n  fallback,\n  loading,\n  children,\n}: EntitlementGateProps): React.ReactElement {\n  const [state, setState] = React.useState<{ status: 'loading' | 'ready'; result?: EntitlementCheckResult }>({\n    status: 'loading',\n  });\n\n  // Resolve productSlug from prop or client.config\n  const resolvedSlug =\n    productSlug ?? (client.config as { productId?: string }).productId ?? '';\n\n  React.useEffect(() => {\n    let cancelled = false;\n    const run = async () => {\n      try {\n        // Try usage.check first (returns full {allowed, reason, behavior, ...})\n        // Falls back to entitlements.check (just boolean) if usage.check unavailable.\n        let result: EntitlementCheckResult;\n        const usage = (client as { usage?: { check: (resource: string, opts?: { productId?: string }) => Promise<EntitlementCheckResult> } }).usage;\n        if (usage && typeof usage.check === 'function') {\n          const res = await usage.check(feature, { productId: resolvedSlug });\n          result = {\n            allowed: res.allowed === true,\n            reason: res.reason,\n            limit: res.limit,\n            currentUsage: res.currentUsage,\n            behavior: res.behavior,\n          };\n        } else {\n          const allowed = await client.entitlements.check(resolvedSlug, feature);\n          result = { allowed };\n        }\n        if (!cancelled) setState({ status: 'ready', result });\n      } catch (err) {\n        // Fail open in dev/prod — caller pode decidir via onError pattern futuro.\n        if (!cancelled) {\n          setState({ status: 'ready', result: { allowed: false, reason: 'check_failed' } });\n        }\n        if (typeof console !== 'undefined') console.warn('[EntitlementGate] check failed', err);\n      }\n    };\n    run();\n    return () => {\n      cancelled = true;\n    };\n  }, [client, feature, resolvedSlug]);\n\n  if (state.status === 'loading') {\n    return React.createElement(React.Fragment, null, loading ?? null);\n  }\n\n  const result = state.result;\n  const allowed = result?.allowed === true;\n  const isReadonly = !allowed && (mode === 'readonly' || result?.behavior === 'readonly');\n\n  if (!allowed && mode === 'block' && !isReadonly) {\n    return React.createElement(React.Fragment, null, fallback ?? null);\n  }\n\n  return React.createElement(\n    EntitlementContext.Provider,\n    {\n      value: {\n        readonly: isReadonly,\n        reason: result?.reason,\n        limit: result?.limit,\n        currentUsage: result?.currentUsage,\n      },\n    },\n    children,\n  );\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,112 @@
+import * as React from 'react';
+import { a as NeetruClient, h as CheckoutStartResult } from './types-BA53dd8S.cjs';
+
+/**
+ * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.
+ *
+ * Helpers leves pra React 18+/19. Não puxa `react` como dep direta — caller
+ * fornece via peer (alinhado com `@stripe/react-stripe-js` / `firebase`).
+ *
+ * Exports:
+ *   - `<CheckoutLink>` — wrapper de `<a>` que chama `client.checkout.start()` no click.
+ *   - `<EntitlementGate>` — wrapper que gateia children por entitlement check
+ *     (suporte a `mode='readonly'` pro decisão CEO §5).
+ *   - `useEntitlementContext()` — hook pra ler estado de readonly do contexto.
+ *
+ * **Bundle**: este file SÓ é carregado por quem importa `@neetru/sdk/react`.
+ * Tree-shake garante que SDK consumers Node-only (CLI, edge handlers) não
+ * puxam React mesmo via transitive.
+ */
+
+interface CheckoutLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'onClick' | 'onError'> {
+    /** Cliente SDK Neetru. Passado explicitamente pra evitar context provider. */
+    client: NeetruClient;
+    /** Slug do produto (ex: `neetru-pulse`). */
+    productId: string;
+    /** Plan id (ex: `pro_monthly`). */
+    planId: string;
+    /** Pra onde o produto SaaS quer voltar pós-checkout. */
+    callbackUrl: string;
+    /** Override pra checkout em nome de uma org. Default: PF do uid logado. */
+    tenantType?: 'pf' | 'pj';
+    tenantId?: string;
+    /** Children — texto/JSX do CTA. */
+    children: React.ReactNode;
+    /** Callback quando intent foi criada (antes de redirect). */
+    onIntentCreated?: (result: CheckoutStartResult) => void;
+    /** Callback de erro. */
+    onError?: (err: Error) => void;
+    /** Quando true, NÃO redireciona automaticamente — caller controla. */
+    noAutoRedirect?: boolean;
+    /** Override de href (default: `#`). */
+    href?: string;
+}
+/**
+ * Wrapper de `<a>` que dispara `client.checkout.start()` no click.
+ *
+ * Uso típico:
+ * ```tsx
+ * <CheckoutLink
+ *   client={client}
+ *   productId="meu-saas"
+ *   planId="pro_monthly"
+ *   callbackUrl="https://meu-saas.com/billing/success"
+ * >
+ *   Assinar Pro
+ * </CheckoutLink>
+ * ```
+ *
+ * `href` é stub (`#`) — preventDefault no click. Mantido pra a11y / preview
+ * de URL no hover (pode ser sobrescrito via prop spread).
+ */
+declare function CheckoutLink({ client, productId, planId, callbackUrl, tenantType, tenantId, children, onIntentCreated, onError, noAutoRedirect, ...rest }: CheckoutLinkProps): React.ReactElement;
+/** Modo de gate quando entitlement não é permitido. */
+type EntitlementGateMode = 'block' | 'readonly';
+interface EntitlementContextValue {
+    /** True quando feature está em modo read-only (limit exceeded). */
+    readonly: boolean;
+    /** Reason code da última check. */
+    reason?: string;
+    /** Limite atual (free tier). */
+    limit?: number;
+    /** Uso atual. */
+    currentUsage?: number;
+}
+/** Hook pra ler estado de readonly. Componentes filhos consomem isso pra
+ * desabilitar inputs/botões de escrita. */
+declare function useEntitlementContext(): EntitlementContextValue;
+interface EntitlementGateProps {
+    /** Cliente SDK Neetru. */
+    client: NeetruClient;
+    /** Feature key a checar (ex: `export.csv`). */
+    feature: string;
+    /** Slug do produto. Default: lê do client.config se ausente. */
+    productSlug?: string;
+    /** Modo:
+     *  - `block` (default): renderiza fallback quando não permitido.
+     *  - `readonly`: sempre renderiza children mas injeta `readonly: true` no contexto. */
+    mode?: EntitlementGateMode;
+    /** Fallback UI quando `mode='block'` e check retorna `allowed=false`. */
+    fallback?: React.ReactNode;
+    /** Loading UI enquanto check resolve (Suspense-like). */
+    loading?: React.ReactNode;
+    children: React.ReactNode;
+}
+/**
+ * Wrapper que gateia children por entitlement check.
+ *
+ * Quando `mode='readonly'` + check retorna `behavior='readonly'`:
+ *   - Children renderizam normalmente.
+ *   - Context injeta `{readonly: true}`.
+ *   - Componentes filhos chamam `useEntitlementContext()` pra desabilitar
+ *     escritas (botões, forms, inputs).
+ *
+ * Quando `mode='block'` + check retorna `allowed=false`:
+ *   - `fallback` é renderizado (ex: paywall, upsell modal).
+ *
+ * Decisão CEO §5 (overage): plataforma usa `readonly` sempre — produto SaaS
+ * deve preferir `mode='readonly'` pra preservar engajamento (não hard-block).
+ */
+declare function EntitlementGate({ client, feature, productSlug, mode, fallback, loading, children, }: EntitlementGateProps): React.ReactElement;
+
+export { CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, useEntitlementContext };

package/dist/react.d.ts

@@ -0,0 +1,112 @@
+import * as React from 'react';
+import { a as NeetruClient, h as CheckoutStartResult } from './types-BA53dd8S.js';
+
+/**
+ * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.
+ *
+ * Helpers leves pra React 18+/19. Não puxa `react` como dep direta — caller
+ * fornece via peer (alinhado com `@stripe/react-stripe-js` / `firebase`).
+ *
+ * Exports:
+ *   - `<CheckoutLink>` — wrapper de `<a>` que chama `client.checkout.start()` no click.
+ *   - `<EntitlementGate>` — wrapper que gateia children por entitlement check
+ *     (suporte a `mode='readonly'` pro decisão CEO §5).
+ *   - `useEntitlementContext()` — hook pra ler estado de readonly do contexto.
+ *
+ * **Bundle**: este file SÓ é carregado por quem importa `@neetru/sdk/react`.
+ * Tree-shake garante que SDK consumers Node-only (CLI, edge handlers) não
+ * puxam React mesmo via transitive.
+ */
+
+interface CheckoutLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'onClick' | 'onError'> {
+    /** Cliente SDK Neetru. Passado explicitamente pra evitar context provider. */
+    client: NeetruClient;
+    /** Slug do produto (ex: `neetru-pulse`). */
+    productId: string;
+    /** Plan id (ex: `pro_monthly`). */
+    planId: string;
+    /** Pra onde o produto SaaS quer voltar pós-checkout. */
+    callbackUrl: string;
+    /** Override pra checkout em nome de uma org. Default: PF do uid logado. */
+    tenantType?: 'pf' | 'pj';
+    tenantId?: string;
+    /** Children — texto/JSX do CTA. */
+    children: React.ReactNode;
+    /** Callback quando intent foi criada (antes de redirect). */
+    onIntentCreated?: (result: CheckoutStartResult) => void;
+    /** Callback de erro. */
+    onError?: (err: Error) => void;
+    /** Quando true, NÃO redireciona automaticamente — caller controla. */
+    noAutoRedirect?: boolean;
+    /** Override de href (default: `#`). */
+    href?: string;
+}
+/**
+ * Wrapper de `<a>` que dispara `client.checkout.start()` no click.
+ *
+ * Uso típico:
+ * ```tsx
+ * <CheckoutLink
+ *   client={client}
+ *   productId="meu-saas"
+ *   planId="pro_monthly"
+ *   callbackUrl="https://meu-saas.com/billing/success"
+ * >
+ *   Assinar Pro
+ * </CheckoutLink>
+ * ```
+ *
+ * `href` é stub (`#`) — preventDefault no click. Mantido pra a11y / preview
+ * de URL no hover (pode ser sobrescrito via prop spread).
+ */
+declare function CheckoutLink({ client, productId, planId, callbackUrl, tenantType, tenantId, children, onIntentCreated, onError, noAutoRedirect, ...rest }: CheckoutLinkProps): React.ReactElement;
+/** Modo de gate quando entitlement não é permitido. */
+type EntitlementGateMode = 'block' | 'readonly';
+interface EntitlementContextValue {
+    /** True quando feature está em modo read-only (limit exceeded). */
+    readonly: boolean;
+    /** Reason code da última check. */
+    reason?: string;
+    /** Limite atual (free tier). */
+    limit?: number;
+    /** Uso atual. */
+    currentUsage?: number;
+}
+/** Hook pra ler estado de readonly. Componentes filhos consomem isso pra
+ * desabilitar inputs/botões de escrita. */
+declare function useEntitlementContext(): EntitlementContextValue;
+interface EntitlementGateProps {
+    /** Cliente SDK Neetru. */
+    client: NeetruClient;
+    /** Feature key a checar (ex: `export.csv`). */
+    feature: string;
+    /** Slug do produto. Default: lê do client.config se ausente. */
+    productSlug?: string;
+    /** Modo:
+     *  - `block` (default): renderiza fallback quando não permitido.
+     *  - `readonly`: sempre renderiza children mas injeta `readonly: true` no contexto. */
+    mode?: EntitlementGateMode;
+    /** Fallback UI quando `mode='block'` e check retorna `allowed=false`. */
+    fallback?: React.ReactNode;
+    /** Loading UI enquanto check resolve (Suspense-like). */
+    loading?: React.ReactNode;
+    children: React.ReactNode;
+}
+/**
+ * Wrapper que gateia children por entitlement check.
+ *
+ * Quando `mode='readonly'` + check retorna `behavior='readonly'`:
+ *   - Children renderizam normalmente.
+ *   - Context injeta `{readonly: true}`.
+ *   - Componentes filhos chamam `useEntitlementContext()` pra desabilitar
+ *     escritas (botões, forms, inputs).
+ *
+ * Quando `mode='block'` + check retorna `allowed=false`:
+ *   - `fallback` é renderizado (ex: paywall, upsell modal).
+ *
+ * Decisão CEO §5 (overage): plataforma usa `readonly` sempre — produto SaaS
+ * deve preferir `mode='readonly'` pra preservar engajamento (não hard-block).
+ */
+declare function EntitlementGate({ client, feature, productSlug, mode, fallback, loading, children, }: EntitlementGateProps): React.ReactElement;
+
+export { CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, useEntitlementContext };

package/dist/react.mjs

@@ -0,0 +1,134 @@
+import * as React from 'react';
+
+// src/react.ts
+function CheckoutLink({
+  client,
+  productId,
+  planId,
+  callbackUrl,
+  tenantType,
+  tenantId,
+  children,
+  onIntentCreated,
+  onError,
+  noAutoRedirect,
+  ...rest
+}) {
+  const [submitting, setSubmitting] = React.useState(false);
+  const checkout = client.checkout;
+  const handleClick = React.useCallback(
+    async (event) => {
+      event.preventDefault();
+      if (submitting) return;
+      if (!checkout || typeof checkout.start !== "function") {
+        onError?.(new Error("SDK client missing `checkout` namespace. Upgrade @neetru/sdk to 1.1+."));
+        return;
+      }
+      setSubmitting(true);
+      try {
+        const result = await checkout.start({
+          productId,
+          planId,
+          callbackUrl,
+          tenantType,
+          tenantId,
+          autoRedirect: !noAutoRedirect
+        });
+        onIntentCreated?.(result);
+      } catch (err) {
+        onError?.(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        setSubmitting(false);
+      }
+    },
+    [submitting, checkout, productId, planId, callbackUrl, tenantType, tenantId, noAutoRedirect, onIntentCreated, onError]
+  );
+  return React.createElement(
+    "a",
+    {
+      ...rest,
+      href: rest.href ?? "#",
+      onClick: handleClick,
+      "aria-busy": submitting || void 0,
+      "data-neetru-checkout-link": "true"
+    },
+    children
+  );
+}
+var EntitlementContext = React.createContext({
+  readonly: false
+});
+function useEntitlementContext() {
+  return React.useContext(EntitlementContext);
+}
+function EntitlementGate({
+  client,
+  feature,
+  productSlug,
+  mode = "block",
+  fallback,
+  loading,
+  children
+}) {
+  const [state, setState] = React.useState({
+    status: "loading"
+  });
+  const resolvedSlug = productSlug ?? client.config.productId ?? "";
+  React.useEffect(() => {
+    let cancelled = false;
+    const run = async () => {
+      try {
+        let result2;
+        const usage = client.usage;
+        if (usage && typeof usage.check === "function") {
+          const res = await usage.check(feature, { productId: resolvedSlug });
+          result2 = {
+            allowed: res.allowed === true,
+            reason: res.reason,
+            limit: res.limit,
+            currentUsage: res.currentUsage,
+            behavior: res.behavior
+          };
+        } else {
+          const allowed2 = await client.entitlements.check(resolvedSlug, feature);
+          result2 = { allowed: allowed2 };
+        }
+        if (!cancelled) setState({ status: "ready", result: result2 });
+      } catch (err) {
+        if (!cancelled) {
+          setState({ status: "ready", result: { allowed: false, reason: "check_failed" } });
+        }
+        if (typeof console !== "undefined") console.warn("[EntitlementGate] check failed", err);
+      }
+    };
+    run();
+    return () => {
+      cancelled = true;
+    };
+  }, [client, feature, resolvedSlug]);
+  if (state.status === "loading") {
+    return React.createElement(React.Fragment, null, loading ?? null);
+  }
+  const result = state.result;
+  const allowed = result?.allowed === true;
+  const isReadonly = !allowed && (mode === "readonly" || result?.behavior === "readonly");
+  if (!allowed && mode === "block" && !isReadonly) {
+    return React.createElement(React.Fragment, null, fallback ?? null);
+  }
+  return React.createElement(
+    EntitlementContext.Provider,
+    {
+      value: {
+        readonly: isReadonly,
+        reason: result?.reason,
+        limit: result?.limit,
+        currentUsage: result?.currentUsage
+      }
+    },
+    children
+  );
+}
+
+export { CheckoutLink, EntitlementGate, useEntitlementContext };
+//# sourceMappingURL=react.mjs.map
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"names":["result","allowed"],"mappings":"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","file":"react.mjs","sourcesContent":["/**\n * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.\n *\n * Helpers leves pra React 18+/19. Não puxa `react` como dep direta — caller\n * fornece via peer (alinhado com `@stripe/react-stripe-js` / `firebase`).\n *\n * Exports:\n *   - `<CheckoutLink>` — wrapper de `<a>` que chama `client.checkout.start()` no click.\n *   - `<EntitlementGate>` — wrapper que gateia children por entitlement check\n *     (suporte a `mode='readonly'` pro decisão CEO §5).\n *   - `useEntitlementContext()` — hook pra ler estado de readonly do contexto.\n *\n * **Bundle**: este file SÓ é carregado por quem importa `@neetru/sdk/react`.\n * Tree-shake garante que SDK consumers Node-only (CLI, edge handlers) não\n * puxam React mesmo via transitive.\n */\nimport * as React from 'react';\nimport type { NeetruClient } from './types';\nimport type { CheckoutStartInput, CheckoutStartResult } from './checkout';\n\n// ─── <CheckoutLink> ─────────────────────────────────────────────────────────\n\nexport interface CheckoutLinkProps\n  extends Omit<\n    React.AnchorHTMLAttributes<HTMLAnchorElement>,\n    'href' | 'onClick' | 'onError'\n  > {\n  /** Cliente SDK Neetru. Passado explicitamente pra evitar context provider. */\n  client: NeetruClient;\n  /** Slug do produto (ex: `neetru-pulse`). */\n  productId: string;\n  /** Plan id (ex: `pro_monthly`). */\n  planId: string;\n  /** Pra onde o produto SaaS quer voltar pós-checkout. */\n  callbackUrl: string;\n  /** Override pra checkout em nome de uma org. Default: PF do uid logado. */\n  tenantType?: 'pf' | 'pj';\n  tenantId?: string;\n  /** Children — texto/JSX do CTA. */\n  children: React.ReactNode;\n  /** Callback quando intent foi criada (antes de redirect). */\n  onIntentCreated?: (result: CheckoutStartResult) => void;\n  /** Callback de erro. */\n  onError?: (err: Error) => void;\n  /** Quando true, NÃO redireciona automaticamente — caller controla. */\n  noAutoRedirect?: boolean;\n  /** Override de href (default: `#`). */\n  href?: string;\n}\n\n/**\n * Wrapper de `<a>` que dispara `client.checkout.start()` no click.\n *\n * Uso típico:\n * ```tsx\n * <CheckoutLink\n *   client={client}\n *   productId=\"meu-saas\"\n *   planId=\"pro_monthly\"\n *   callbackUrl=\"https://meu-saas.com/billing/success\"\n * >\n *   Assinar Pro\n * </CheckoutLink>\n * ```\n *\n * `href` é stub (`#`) — preventDefault no click. Mantido pra a11y / preview\n * de URL no hover (pode ser sobrescrito via prop spread).\n */\nexport function CheckoutLink({\n  client,\n  productId,\n  planId,\n  callbackUrl,\n  tenantType,\n  tenantId,\n  children,\n  onIntentCreated,\n  onError,\n  noAutoRedirect,\n  ...rest\n}: CheckoutLinkProps): React.ReactElement {\n  const [submitting, setSubmitting] = React.useState(false);\n\n  // Lazy access — `client.checkout` foi adicionado em SDK 1.1, fall back gracioso\n  // se caller passar um client antigo (mesmo que types resolvam, runtime check).\n  const checkout = (client as { checkout?: { start: (input: CheckoutStartInput) => Promise<CheckoutStartResult> } }).checkout;\n\n  const handleClick = React.useCallback(\n    async (event: React.MouseEvent<HTMLAnchorElement>) => {\n      event.preventDefault();\n      if (submitting) return;\n      if (!checkout || typeof checkout.start !== 'function') {\n        onError?.(new Error('SDK client missing `checkout` namespace. Upgrade @neetru/sdk to 1.1+.'));\n        return;\n      }\n      setSubmitting(true);\n      try {\n        const result = await checkout.start({\n          productId,\n          planId,\n          callbackUrl,\n          tenantType,\n          tenantId,\n          autoRedirect: !noAutoRedirect,\n        });\n        onIntentCreated?.(result);\n      } catch (err) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        setSubmitting(false);\n      }\n    },\n    [submitting, checkout, productId, planId, callbackUrl, tenantType, tenantId, noAutoRedirect, onIntentCreated, onError],\n  );\n\n  return React.createElement(\n    'a',\n    {\n      ...rest,\n      href: rest.href ?? '#',\n      onClick: handleClick,\n      'aria-busy': submitting || undefined,\n      'data-neetru-checkout-link': 'true',\n    },\n    children,\n  );\n}\n\n// ─── <EntitlementGate> + useEntitlementContext ────────────────────────────\n\n/** Modo de gate quando entitlement não é permitido. */\nexport type EntitlementGateMode = 'block' | 'readonly';\n\ninterface EntitlementContextValue {\n  /** True quando feature está em modo read-only (limit exceeded). */\n  readonly: boolean;\n  /** Reason code da última check. */\n  reason?: string;\n  /** Limite atual (free tier). */\n  limit?: number;\n  /** Uso atual. */\n  currentUsage?: number;\n}\n\nconst EntitlementContext = React.createContext<EntitlementContextValue>({\n  readonly: false,\n});\n\n/** Hook pra ler estado de readonly. Componentes filhos consomem isso pra\n * desabilitar inputs/botões de escrita. */\nexport function useEntitlementContext(): EntitlementContextValue {\n  return React.useContext(EntitlementContext);\n}\n\nexport interface EntitlementGateProps {\n  /** Cliente SDK Neetru. */\n  client: NeetruClient;\n  /** Feature key a checar (ex: `export.csv`). */\n  feature: string;\n  /** Slug do produto. Default: lê do client.config se ausente. */\n  productSlug?: string;\n  /** Modo:\n   *  - `block` (default): renderiza fallback quando não permitido.\n   *  - `readonly`: sempre renderiza children mas injeta `readonly: true` no contexto. */\n  mode?: EntitlementGateMode;\n  /** Fallback UI quando `mode='block'` e check retorna `allowed=false`. */\n  fallback?: React.ReactNode;\n  /** Loading UI enquanto check resolve (Suspense-like). */\n  loading?: React.ReactNode;\n  children: React.ReactNode;\n}\n\ninterface EntitlementCheckResult {\n  allowed: boolean;\n  reason?: string;\n  limit?: number;\n  currentUsage?: number;\n  behavior?: 'readonly' | null;\n}\n\n/**\n * Wrapper que gateia children por entitlement check.\n *\n * Quando `mode='readonly'` + check retorna `behavior='readonly'`:\n *   - Children renderizam normalmente.\n *   - Context injeta `{readonly: true}`.\n *   - Componentes filhos chamam `useEntitlementContext()` pra desabilitar\n *     escritas (botões, forms, inputs).\n *\n * Quando `mode='block'` + check retorna `allowed=false`:\n *   - `fallback` é renderizado (ex: paywall, upsell modal).\n *\n * Decisão CEO §5 (overage): plataforma usa `readonly` sempre — produto SaaS\n * deve preferir `mode='readonly'` pra preservar engajamento (não hard-block).\n */\nexport function EntitlementGate({\n  client,\n  feature,\n  productSlug,\n  mode = 'block',\n  fallback,\n  loading,\n  children,\n}: EntitlementGateProps): React.ReactElement {\n  const [state, setState] = React.useState<{ status: 'loading' | 'ready'; result?: EntitlementCheckResult }>({\n    status: 'loading',\n  });\n\n  // Resolve productSlug from prop or client.config\n  const resolvedSlug =\n    productSlug ?? (client.config as { productId?: string }).productId ?? '';\n\n  React.useEffect(() => {\n    let cancelled = false;\n    const run = async () => {\n      try {\n        // Try usage.check first (returns full {allowed, reason, behavior, ...})\n        // Falls back to entitlements.check (just boolean) if usage.check unavailable.\n        let result: EntitlementCheckResult;\n        const usage = (client as { usage?: { check: (resource: string, opts?: { productId?: string }) => Promise<EntitlementCheckResult> } }).usage;\n        if (usage && typeof usage.check === 'function') {\n          const res = await usage.check(feature, { productId: resolvedSlug });\n          result = {\n            allowed: res.allowed === true,\n            reason: res.reason,\n            limit: res.limit,\n            currentUsage: res.currentUsage,\n            behavior: res.behavior,\n          };\n        } else {\n          const allowed = await client.entitlements.check(resolvedSlug, feature);\n          result = { allowed };\n        }\n        if (!cancelled) setState({ status: 'ready', result });\n      } catch (err) {\n        // Fail open in dev/prod — caller pode decidir via onError pattern futuro.\n        if (!cancelled) {\n          setState({ status: 'ready', result: { allowed: false, reason: 'check_failed' } });\n        }\n        if (typeof console !== 'undefined') console.warn('[EntitlementGate] check failed', err);\n      }\n    };\n    run();\n    return () => {\n      cancelled = true;\n    };\n  }, [client, feature, resolvedSlug]);\n\n  if (state.status === 'loading') {\n    return React.createElement(React.Fragment, null, loading ?? null);\n  }\n\n  const result = state.result;\n  const allowed = result?.allowed === true;\n  const isReadonly = !allowed && (mode === 'readonly' || result?.behavior === 'readonly');\n\n  if (!allowed && mode === 'block' && !isReadonly) {\n    return React.createElement(React.Fragment, null, fallback ?? null);\n  }\n\n  return React.createElement(\n    EntitlementContext.Provider,\n    {\n      value: {\n        readonly: isReadonly,\n        reason: result?.reason,\n        limit: result?.limit,\n        currentUsage: result?.currentUsage,\n      },\n    },\n    children,\n  );\n}\n"]}

package/dist/support.cjs

@@ -67,10 +67,14 @@ async function httpRequest(config, opts) {
     headers["content-type"] = "application/json";
     init.body = JSON.stringify(opts.body);
   }
+  init.signal = AbortSignal.timeout(3e4);
   let res;
   try {
     res = await config.fetch(url, init);
   } catch (err) {
+    if (err instanceof DOMException && err.name === "TimeoutError") {
+      throw new NeetruError("network_error", "Network error: timeout after 30s");
+    }
     const message = err instanceof Error ? err.message : "fetch failed";
     throw new NeetruError("network_error", `Network error: ${message}`);
   }