@neetru/sdk 1.0.0 → 1.1.0

package/dist/{types-PKUaFtBY.d.cts → types-BA53dd8S.d.cts}

@@ -1,3 +1,83 @@
+/** Tipo do tenant alvo da subscription (PF=uid, PJ=orgId). */
+type CheckoutTenantType = 'pf' | 'pj';
+/** Status do `checkout_intents/{intentId}` no Core. */
+type CheckoutIntentStatus = 'pending' | 'kyc_in_progress' | 'stripe_redirected' | 'completed' | 'expired' | 'cancelled';
+interface CheckoutStartInput {
+    /** Slug do produto no catálogo (ex: `neetru-pulse`). */
+    productId: string;
+    /** Slug do plano no catálogo do produto (ex: `pro_monthly`). */
+    planId: string;
+    /** Pra onde o produto SaaS quer voltar pós-checkout. https obrigatório (ou http://localhost em dev). */
+    callbackUrl: string;
+    /** Override pra checkout em nome de uma org. Default: PF do uid logado. */
+    tenantType?: CheckoutTenantType;
+    /** Quando `tenantType='pj'`, id da org. Ignorado quando PF. */
+    tenantId?: string;
+    /**
+     * Em browsers, default `true` — SDK faz `window.location.href = redirectUrl`.
+     * Passe `false` se quiser controlar o redirect manualmente.
+     */
+    autoRedirect?: boolean;
+}
+interface CheckoutStartResult {
+    intentId: string;
+    redirectUrl: string;
+    status: CheckoutIntentStatus;
+    expiresAt: string;
+    /** True se KYC ainda precisa ser coletado no portal. UI pode mostrar hint. */
+    requiresKyc: boolean;
+}
+interface CheckoutIntentInfo {
+    intentId: string;
+    uid: string;
+    targetTenantId: string;
+    targetTenantType: CheckoutTenantType;
+    productId: string;
+    planId: string;
+    callbackUrl: string;
+    status: CheckoutIntentStatus;
+    /** Stripe Checkout Session id quando avançou pra `stripe_redirected`. */
+    stripeSessionId?: string | null;
+    expiresAt: string;
+    /** True se já passou `expiresAt` mas Core ainda não marcou expired. */
+    isStale?: boolean;
+}
+interface CheckoutNamespace {
+    /**
+     * Inicia checkout. Em browser, redireciona automaticamente pro portal.
+     * Em Node/SSR, retorna o resultado sem efeitos colaterais — caller decide
+     * o que fazer com `redirectUrl`.
+     *
+     * Dev mode (`NEETRU_ENV=dev`): retorna URL fake `https://localhost:9003/portal/checkout/mock-XXXX`.
+     */
+    start(input: CheckoutStartInput): Promise<CheckoutStartResult>;
+    /** Lê estado atual do intent (Core). */
+    get(intentId: string): Promise<CheckoutIntentInfo>;
+    /** Cancela um intent que ainda não virou `stripe_redirected`. */
+    cancel(intentId: string): Promise<{
+        ok: true;
+        alreadyCancelled: boolean;
+    }>;
+}
+/**
+ * Mock dev — retorna URL fake `https://localhost:9003/portal/checkout/mock-XXXX`
+ * sem tocar no Core. Útil pra dev externo SaaS testar UI/redirect sem precisar
+ * de Bearer token Neetru.
+ *
+ * Dev mode persiste intents em mapa in-memory pro `get`/`cancel` retornarem
+ * resultado consistente.
+ */
+declare class MockCheckout implements CheckoutNamespace {
+    private readonly intents;
+    start(input: CheckoutStartInput): Promise<CheckoutStartResult>;
+    get(intentId: string): Promise<CheckoutIntentInfo>;
+    cancel(intentId: string): Promise<{
+        ok: true;
+        alreadyCancelled: boolean;
+    }>;
+}
+declare function createCheckoutNamespace(config: ResolvedConfig): CheckoutNamespace;
+
 /**
  * Tipos públicos do SDK Neetru.
  *
@@ -199,6 +279,8 @@ interface NeetruClient {
     readonly support: SupportNamespace;
     /** Namespace db (v0.3 — coleções tenant-scoped). */
     readonly db: DbNamespace;
+    /** Namespace checkout (v1.1 — start/get/cancel intent + auto-redirect). */
+    readonly checkout: CheckoutNamespace;
 }
 /**
  * User retornado pelo OIDC ID token. Schema neutro — não vaza Firebase
@@ -405,4 +487,4 @@ interface CatalogListOptions {
     includeDrafts?: boolean;
 }
 
-export { type AuthNamespace as A, type CatalogListOptions as C, DEFAULT_BASE_URL as D, type EntitlementCheck as E, type NeetruClientConfig as N, type Product as P, type ResolvedConfig as R, type SignInOptions as S, type TelemetryEventAck as T, type UsageEventInput as U, type NeetruClient as a, type AuthStateListener as b, type CatalogListResponse as c, type CreateTicketInput as d, type DbCollectionRef as e, type DbListOptions as f, type DbNamespace as g, type DbWhereFilter as h, type NeetruEnv as i, type NeetruUser as j, type ProductPlan as k, type ProductStatus as l, type SupportNamespace as m, type SupportSeverity as n, type SupportStatus as o, type SupportTicket as p, type TelemetryEventInput as q, type UsageNamespace as r, type UsageQuota as s, type TelemetryLogInput as t, type TelemetryLogAck as u };
+export { type AuthNamespace as A, type TelemetryLogInput as B, type CatalogListOptions as C, DEFAULT_BASE_URL as D, type EntitlementCheck as E, type TelemetryLogAck as F, MockCheckout as M, type NeetruClientConfig as N, type Product as P, type ResolvedConfig as R, type SignInOptions as S, type TelemetryEventAck as T, type UsageEventInput as U, type NeetruClient as a, type AuthStateListener as b, type CatalogListResponse as c, type CheckoutIntentInfo as d, type CheckoutIntentStatus as e, type CheckoutNamespace as f, type CheckoutStartInput as g, type CheckoutStartResult as h, type CheckoutTenantType as i, type CreateTicketInput as j, type DbCollectionRef as k, type DbListOptions as l, type DbNamespace as m, type DbWhereFilter as n, type NeetruEnv as o, type NeetruUser as p, type ProductPlan as q, type ProductStatus as r, type SupportNamespace as s, type SupportSeverity as t, type SupportStatus as u, type SupportTicket as v, type TelemetryEventInput as w, type UsageNamespace as x, type UsageQuota as y, createCheckoutNamespace as z };

package/dist/{types-PKUaFtBY.d.ts → types-BA53dd8S.d.ts}

@@ -1,3 +1,83 @@
+/** Tipo do tenant alvo da subscription (PF=uid, PJ=orgId). */
+type CheckoutTenantType = 'pf' | 'pj';
+/** Status do `checkout_intents/{intentId}` no Core. */
+type CheckoutIntentStatus = 'pending' | 'kyc_in_progress' | 'stripe_redirected' | 'completed' | 'expired' | 'cancelled';
+interface CheckoutStartInput {
+    /** Slug do produto no catálogo (ex: `neetru-pulse`). */
+    productId: string;
+    /** Slug do plano no catálogo do produto (ex: `pro_monthly`). */
+    planId: string;
+    /** Pra onde o produto SaaS quer voltar pós-checkout. https obrigatório (ou http://localhost em dev). */
+    callbackUrl: string;
+    /** Override pra checkout em nome de uma org. Default: PF do uid logado. */
+    tenantType?: CheckoutTenantType;
+    /** Quando `tenantType='pj'`, id da org. Ignorado quando PF. */
+    tenantId?: string;
+    /**
+     * Em browsers, default `true` — SDK faz `window.location.href = redirectUrl`.
+     * Passe `false` se quiser controlar o redirect manualmente.
+     */
+    autoRedirect?: boolean;
+}
+interface CheckoutStartResult {
+    intentId: string;
+    redirectUrl: string;
+    status: CheckoutIntentStatus;
+    expiresAt: string;
+    /** True se KYC ainda precisa ser coletado no portal. UI pode mostrar hint. */
+    requiresKyc: boolean;
+}
+interface CheckoutIntentInfo {
+    intentId: string;
+    uid: string;
+    targetTenantId: string;
+    targetTenantType: CheckoutTenantType;
+    productId: string;
+    planId: string;
+    callbackUrl: string;
+    status: CheckoutIntentStatus;
+    /** Stripe Checkout Session id quando avançou pra `stripe_redirected`. */
+    stripeSessionId?: string | null;
+    expiresAt: string;
+    /** True se já passou `expiresAt` mas Core ainda não marcou expired. */
+    isStale?: boolean;
+}
+interface CheckoutNamespace {
+    /**
+     * Inicia checkout. Em browser, redireciona automaticamente pro portal.
+     * Em Node/SSR, retorna o resultado sem efeitos colaterais — caller decide
+     * o que fazer com `redirectUrl`.
+     *
+     * Dev mode (`NEETRU_ENV=dev`): retorna URL fake `https://localhost:9003/portal/checkout/mock-XXXX`.
+     */
+    start(input: CheckoutStartInput): Promise<CheckoutStartResult>;
+    /** Lê estado atual do intent (Core). */
+    get(intentId: string): Promise<CheckoutIntentInfo>;
+    /** Cancela um intent que ainda não virou `stripe_redirected`. */
+    cancel(intentId: string): Promise<{
+        ok: true;
+        alreadyCancelled: boolean;
+    }>;
+}
+/**
+ * Mock dev — retorna URL fake `https://localhost:9003/portal/checkout/mock-XXXX`
+ * sem tocar no Core. Útil pra dev externo SaaS testar UI/redirect sem precisar
+ * de Bearer token Neetru.
+ *
+ * Dev mode persiste intents em mapa in-memory pro `get`/`cancel` retornarem
+ * resultado consistente.
+ */
+declare class MockCheckout implements CheckoutNamespace {
+    private readonly intents;
+    start(input: CheckoutStartInput): Promise<CheckoutStartResult>;
+    get(intentId: string): Promise<CheckoutIntentInfo>;
+    cancel(intentId: string): Promise<{
+        ok: true;
+        alreadyCancelled: boolean;
+    }>;
+}
+declare function createCheckoutNamespace(config: ResolvedConfig): CheckoutNamespace;
+
 /**
  * Tipos públicos do SDK Neetru.
  *
@@ -199,6 +279,8 @@ interface NeetruClient {
     readonly support: SupportNamespace;
     /** Namespace db (v0.3 — coleções tenant-scoped). */
     readonly db: DbNamespace;
+    /** Namespace checkout (v1.1 — start/get/cancel intent + auto-redirect). */
+    readonly checkout: CheckoutNamespace;
 }
 /**
  * User retornado pelo OIDC ID token. Schema neutro — não vaza Firebase
@@ -405,4 +487,4 @@ interface CatalogListOptions {
     includeDrafts?: boolean;
 }
 
-export { type AuthNamespace as A, type CatalogListOptions as C, DEFAULT_BASE_URL as D, type EntitlementCheck as E, type NeetruClientConfig as N, type Product as P, type ResolvedConfig as R, type SignInOptions as S, type TelemetryEventAck as T, type UsageEventInput as U, type NeetruClient as a, type AuthStateListener as b, type CatalogListResponse as c, type CreateTicketInput as d, type DbCollectionRef as e, type DbListOptions as f, type DbNamespace as g, type DbWhereFilter as h, type NeetruEnv as i, type NeetruUser as j, type ProductPlan as k, type ProductStatus as l, type SupportNamespace as m, type SupportSeverity as n, type SupportStatus as o, type SupportTicket as p, type TelemetryEventInput as q, type UsageNamespace as r, type UsageQuota as s, type TelemetryLogInput as t, type TelemetryLogAck as u };
+export { type AuthNamespace as A, type TelemetryLogInput as B, type CatalogListOptions as C, DEFAULT_BASE_URL as D, type EntitlementCheck as E, type TelemetryLogAck as F, MockCheckout as M, type NeetruClientConfig as N, type Product as P, type ResolvedConfig as R, type SignInOptions as S, type TelemetryEventAck as T, type UsageEventInput as U, type NeetruClient as a, type AuthStateListener as b, type CatalogListResponse as c, type CheckoutIntentInfo as d, type CheckoutIntentStatus as e, type CheckoutNamespace as f, type CheckoutStartInput as g, type CheckoutStartResult as h, type CheckoutTenantType as i, type CreateTicketInput as j, type DbCollectionRef as k, type DbListOptions as l, type DbNamespace as m, type DbWhereFilter as n, type NeetruEnv as o, type NeetruUser as p, type ProductPlan as q, type ProductStatus as r, type SupportNamespace as s, type SupportSeverity as t, type SupportStatus as u, type SupportTicket as v, type TelemetryEventInput as w, type UsageNamespace as x, type UsageQuota as y, createCheckoutNamespace as z };

package/dist/usage.d.cts

@@ -1,4 +1,4 @@
-import { R as ResolvedConfig, r as UsageNamespace } from './types-PKUaFtBY.cjs';
+import { R as ResolvedConfig, x as UsageNamespace } from './types-BA53dd8S.cjs';
 
 declare function createUsageNamespace(config: ResolvedConfig): UsageNamespace;
 

package/dist/usage.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolvedConfig, r as UsageNamespace } from './types-PKUaFtBY.js';
+import { R as ResolvedConfig, x as UsageNamespace } from './types-BA53dd8S.js';
 
 declare function createUsageNamespace(config: ResolvedConfig): UsageNamespace;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neetru/sdk",
-  "version": "1.0.0",
-  "description": "Neetru SDK 1.0 GA — biblioteca runtime estável para consumir o ecossistema Neetru (auth OIDC, catalog, entitlements, telemetry, usage metering, support tickets, datastore).",
+  "version": "1.1.0",
+  "description": "Neetru SDK 1.1 — biblioteca runtime estável para consumir o ecossistema Neetru (auth OIDC, catalog, entitlements, telemetry, usage metering, support tickets, datastore, checkout).",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -56,8 +56,24 @@
       "types": "./dist/errors.d.ts",
       "import": "./dist/errors.mjs",
       "require": "./dist/errors.cjs"
+    },
+    "./checkout": {
+      "types": "./dist/checkout.d.ts",
+      "import": "./dist/checkout.mjs",
+      "require": "./dist/checkout.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.cjs"
     }
   },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
   "sideEffects": false,
   "scripts": {
     "build": "tsup",