@neetru/sdk 1.2.0 → 2.1.0

package/dist/types-CQAfwqUS.d.cts

@@ -1,654 +0,0 @@
-/** 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;
-
-type ProductNotificationSeverity = 'info' | 'success' | 'warning' | 'error';
-interface ProductNotification {
-    id: string;
-    /** UID do usuário final (do produto, não staff Neetru). */
-    userId: string;
-    /** Identificador semântico do evento (ex: `order.received`). */
-    kind: string;
-    severity: ProductNotificationSeverity;
-    title: string;
-    body?: string;
-    /** Link opcional pra ação. */
-    link?: string;
-    /** Metadata livre (serializável). */
-    metadata?: Record<string, string | number | boolean | null>;
-    createdAt: string;
-    /** ISO quando user marcou lida. */
-    readAt?: string;
-    /** ISO quando user descartou. */
-    dismissedAt?: string;
-}
-interface SendNotificationInput {
-    userId: string;
-    kind: string;
-    title: string;
-    severity?: ProductNotificationSeverity;
-    body?: string;
-    link?: string;
-    metadata?: Record<string, string | number | boolean | null>;
-    /**
-     * Dedup — se já existir notificação com mesmo fingerprint dentro de 24h,
-     * NÃO cria duplicata. Útil pra evitar spam quando webhook reentrega.
-     */
-    fingerprint?: string;
-}
-interface ListNotificationsOptions {
-    /** Inclui notificações dismissed (default false). */
-    includeDismissed?: boolean;
-    /** Filtro por unread. */
-    onlyUnread?: boolean;
-    /** Máx itens (default 50, máx 200). */
-    limit?: number;
-}
-interface NotificationsNamespace {
-    /** Produto envia uma notificação pra um usuário do produto. */
-    send(input: SendNotificationInput): Promise<ProductNotification>;
-    /** Lista notificações de um usuário. */
-    list(userId: string, options?: ListNotificationsOptions): Promise<ProductNotification[]>;
-    /** Marca como lida. */
-    markRead(id: string): Promise<{
-        ok: true;
-    }>;
-    /** Descarta. */
-    dismiss(id: string): Promise<{
-        ok: true;
-    }>;
-}
-declare function createNotificationsNamespace(config: ResolvedConfig): NotificationsNamespace;
-declare class MockNotifications implements NotificationsNamespace {
-    private notifications;
-    private nextId;
-    send(input: SendNotificationInput): Promise<ProductNotification>;
-    list(userId: string, options?: ListNotificationsOptions): Promise<ProductNotification[]>;
-    markRead(id: string): Promise<{
-        ok: true;
-    }>;
-    dismiss(id: string): Promise<{
-        ok: true;
-    }>;
-}
-
-/** Eventos Neetru que produtos podem assinar. Lista expansível por minor bump. */
-type WebhookEvent = 'subscription.activated' | 'subscription.cancelled' | 'subscription.payment_failed' | 'subscription.trial_ending' | 'usage.quota_exceeded' | 'account.suspended' | 'account.reactivated' | 'support.ticket_replied';
-interface WebhookEndpoint {
-    id: string;
-    url: string;
-    events: WebhookEvent[];
-    /** Quando true, `X-Neetru-Signature` é enviado em cada dispatch. */
-    hasSecret: boolean;
-    status: 'active' | 'degraded' | 'disabled';
-    /** ISO timestamp do último dispatch bem-sucedido. */
-    lastDeliveryAt?: string;
-    /** Quantos dispatches falharam consecutivos (resetado em sucesso). */
-    consecutiveFailures?: number;
-    createdAt: string;
-}
-interface RegisterWebhookInput {
-    url: string;
-    events: WebhookEvent[];
-    /**
-     * Secret pra HMAC SHA-256 (mín 16 chars). Recomendado.
-     * Quando ausente, dispatches vão sem assinatura — produto deve ter
-     * IP allowlist ou outra defesa.
-     */
-    secret?: string;
-}
-interface WebhookTestResult {
-    ok: boolean;
-    statusCode?: number;
-    durationMs?: number;
-    error?: string;
-}
-interface WebhooksNamespace {
-    /** Registra um novo endpoint. */
-    register(input: RegisterWebhookInput): Promise<WebhookEndpoint>;
-    /** Lista endpoints registrados pelo produto. */
-    list(): Promise<WebhookEndpoint[]>;
-    /** Remove um endpoint. */
-    unregister(id: string): Promise<{
-        ok: true;
-    }>;
-    /** Dispara evento de teste pra validar conectividade. */
-    test(id: string): Promise<WebhookTestResult>;
-}
-/**
- * Verifica assinatura HMAC SHA-256 de payload de webhook recebido pelo
- * produto consumer. Constant-time compare pra resistir a timing attack.
- *
- * @param payload Corpo cru da request (string ou Buffer). NÃO use o objeto
- *                parseado — JSON.stringify pode diferir do que foi assinado.
- * @param signature Header `X-Neetru-Signature` recebido (formato `sha256=<hex>`).
- * @param secret Secret registrado em `webhooks.register({ secret })`.
- * @returns true se assinatura confere, false caso contrário.
- *
- * @example
- * ```ts
- * // Express handler
- * app.post('/webhooks/neetru', express.raw({ type: 'application/json' }), (req, res) => {
- *   const sig = req.header('X-Neetru-Signature');
- *   if (!verifyWebhookSignature(req.body, sig, process.env.WEBHOOK_SECRET!)) {
- *     return res.status(401).end();
- *   }
- *   const event = JSON.parse(req.body.toString('utf8'));
- *   // ... handle event
- *   res.json({ ok: true });
- * });
- * ```
- */
-declare function verifyWebhookSignature(payload: string | Uint8Array, signature: string | null | undefined, secret: string): boolean;
-declare function createWebhooksNamespace(config: ResolvedConfig): WebhooksNamespace;
-declare class MockWebhooks implements WebhooksNamespace {
-    private endpoints;
-    private nextId;
-    register(input: RegisterWebhookInput): Promise<WebhookEndpoint>;
-    list(): Promise<WebhookEndpoint[]>;
-    unregister(id: string): Promise<{
-        ok: true;
-    }>;
-    test(id: string): Promise<WebhookTestResult>;
-}
-
-/**
- * Tipos públicos do SDK Neetru.
- *
- * Vendor-neutral: nada aqui referencia `firebase/*`, `stripe`, ou qualquer
- * provider interno. Caller só vê superfície neutra (Product, Entitlement, ...).
- */
-/** Default base URL pra API pública Neetru. */
-declare const DEFAULT_BASE_URL = "https://api.neetru.com";
-/**
- * Configuração passada pra `createNeetruClient`.
- */
-interface NeetruClientConfig {
-    /**
-     * Bearer token Neetru (formato `nrt_<keyId>_<secret>`). Opcional —
-     * se ausente, o SDK tenta `process.env.NEETRU_API_KEY` em Node.
-     *
-     * Endpoints públicos (catalog) funcionam sem apiKey. Endpoints autenticados
-     * (entitlements, telemetry) lançam `missing_api_key` se ausente.
-     */
-    apiKey?: string;
-    /**
-     * URL base da API Neetru. Default: `https://api.neetru.com`.
-     * Útil em testes apontando pra staging ou mock server.
-     */
-    baseUrl?: string;
-    /**
-     * Implementação de fetch customizada. Default: `globalThis.fetch`.
-     * Necessário em runtimes que não exponham fetch global por default.
-     */
-    fetch?: typeof globalThis.fetch;
-    /**
-     * Modo de runtime. `dev` ativa mocks (auth retorna user fixture, usage só
-     * loga, support retorna lista fake). `workspace` e `prod` chamam HTTP real.
-     *
-     * Default: lê `process.env.NEETRU_ENV` (Node) ou `globalThis.NEETRU_ENV`
-     * (browser); fallback `prod`.
-     */
-    env?: 'dev' | 'workspace' | 'prod';
-    /**
-     * Override de mocks — útil em tests do consumer pra injetar fixtures
-     * determinísticos (sem depender de NEETRU_ENV=dev).
-     */
-    mocks?: {
-        auth?: AuthNamespace;
-        usage?: UsageNamespace;
-        support?: SupportNamespace;
-        entitlements?: NeetruClient['entitlements'];
-        db?: DbNamespace;
-        webhooks?: WebhooksNamespace;
-        notifications?: NotificationsNamespace;
-    };
-    /**
-     * v0.3 — productId default usado por `usage.report()` / `usage.check()` /
-     * `db.collection()` quando não passado explicitamente nas options.
-     */
-    productId?: string;
-    /**
-     * v0.3 — tenantId default usado por `usage.report()` / `usage.check()` /
-     * `db.collection()` quando não passado explicitamente nas options.
-     */
-    tenantId?: string;
-}
-/**
- * Status do produto no catálogo público.
- */
-type ProductStatus = 'live' | 'soon' | 'beta';
-/**
- * Produto SaaS publicado pelo Neetru Core.
- *
- * Schema neutro — alinhado com `public_products/{slug}` no backend mas
- * nunca expõe campos internos (Firestore Timestamps, draft state, etc).
- */
-interface Product {
-    /** Identificador estável do produto, ex: `neetru-pulse`. */
-    slug: string;
-    /** Nome de exibição, ex: `Neetru Pulse`. */
-    name: string;
-    /** Subtítulo curto, ex: `Gestão de operações`. */
-    tagline?: string;
-    /** Descrição longa em prosa. */
-    description?: string;
-    /** Status público do produto. */
-    status?: ProductStatus;
-    /** Hint de ícone (catálogo de keys interno do Core). */
-    iconKey?: string;
-    /** Link override do CTA principal (default: página do produto). */
-    ctaHref?: string;
-    /** Label override do CTA. */
-    ctaLabel?: string;
-    /** Lista opcional de planos cobrados. Pode ser preenchida v0.2+. */
-    plans?: ProductPlan[];
-}
-/** Plano cobrado de um produto (placeholder v0.1 — schema final v0.2). */
-interface ProductPlan {
-    id: string;
-    name: string;
-    /** Preço mensal em centavos (BRL). Pode ser undefined em planos custom. */
-    amountCents?: number;
-    features?: string[];
-}
-/**
- * Resposta do `client.catalog.list()`.
- */
-interface CatalogListResponse {
-    products: Product[];
-    fetchedAt: string;
-}
-/**
- * Resposta do `client.entitlements.check(productSlug, feature)`.
- *
- * `allowed` é o sinal forte; `reason` ajuda a debugar (não exibir pro user
- * final).
- */
-interface EntitlementCheck {
-    allowed: boolean;
-    productSlug: string;
-    feature: string;
-    /** Reason code estável: `granted` | `not_subscribed` | `feature_not_in_plan` | `expired`. */
-    reason?: string;
-}
-/**
- * Payload pra `client.telemetry.event()`.
- */
-interface TelemetryEventInput {
-    /** Nome do evento, ex: `dashboard_opened`, `report_exported`. */
-    name: string;
-    /** Atributos adicionais (chave → valor primitivo). */
-    properties?: Record<string, string | number | boolean | null>;
-    /** Timestamp ISO opcional; default = server time. */
-    timestamp?: string;
-}
-/**
- * Confirmação de aceitação do evento de telemetria.
- */
-interface TelemetryEventAck {
-    ok: true;
-    /** ID gerado pelo backend pra evento (`usage_events/{id}`). */
-    eventId: string;
-}
-type TelemetryLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-interface TelemetryLogInput {
-    level: TelemetryLogLevel;
-    message: string;
-    metadata?: Record<string, unknown>;
-    /** Override correlationId (default: lê dos headers/env automaticamente). */
-    correlationId?: string;
-    /** Slug do produto referenciado. Backend infere do escopo do token se ausente. */
-    productSlug?: string;
-}
-interface TelemetryLogAck {
-    ok: true;
-    /** ID do log gravado (`logs/{productId}/{yyyymmdd}/{logId}`) — opcional em mocks. */
-    logId?: string;
-    /** Indicador de modo (mock vs http). */
-    mode: 'mock' | 'http';
-}
-/**
- * Handle imutável retornado por `createNeetruClient`. Carrega namespaces
- * `auth`, `catalog`, `entitlements`, `telemetry`, `usage`, `support`.
- *
- * Cada namespace é exposto como objeto chamável — espelha API Firebase
- * (`auth`, `firestore`) ou Stripe (`paymentIntents`, `customers`).
- */
-interface NeetruClient {
-    /** Configuração resolvida (apiKey, baseUrl, fetch). Read-only. */
-    readonly config: ResolvedConfig;
-    /** Namespace auth (v0.2 — OIDC + mocks dev). */
-    readonly auth: AuthNamespace;
-    /** Namespace catálogo público de produtos. */
-    readonly catalog: {
-        /** Lista produtos publicados. */
-        list(opts?: CatalogListOptions): Promise<CatalogListResponse>;
-        /** Busca produto único por slug. */
-        get(slug: string): Promise<Product>;
-    };
-    /** Namespace entitlements (v1.2: cache LRU 60s TTL). */
-    readonly entitlements: {
-        /**
-         * Verifica se o portador da apiKey pode usar `feature` do produto `slug`.
-         * Cacheado 60s. `{ cacheBust: true }` força ida ao servidor.
-         */
-        check(productSlug: string, feature: string, opts?: {
-            cacheBust?: boolean;
-        }): Promise<boolean>;
-        /** Variante que retorna o objeto completo com `reason`. */
-        checkDetailed(productSlug: string, feature: string, opts?: {
-            cacheBust?: boolean;
-        }): Promise<EntitlementCheck>;
-    };
-    /** Namespace telemetria (v1.2: track fire-and-forget + flush). */
-    readonly telemetry: {
-        /** Persiste um evento single-shot. await retorna { ok, eventId }. */
-        event(input: TelemetryEventInput): Promise<TelemetryEventAck>;
-        /** Fire-and-forget: enqueue + flush 500ms debounce. Sem retorno. */
-        track(input: TelemetryEventInput): void;
-        /** Força flush da queue do track() (chamar antes de unload). */
-        flush(): Promise<void>;
-        /**
-         * Registra um log estruturado per-product (Sprint 6).
-         *
-         * - Em `NEETRU_ENV=dev`: apenas console.{level} (sem network).
-         * - Em `workspace`/`prod`: POST `/api/sdk/v1/telemetry/log` com Bearer + correlationId.
-         */
-        log(input: TelemetryLogInput): Promise<TelemetryLogAck>;
-    };
-    /** Namespace usage (v0.2 — track + quota; v0.3 — report + check). */
-    readonly usage: UsageNamespace;
-    /** Namespace support (v0.2 — tickets). */
-    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;
-    /** Namespace webhooks (v1.2 — register/list/unregister/test). */
-    readonly webhooks: WebhooksNamespace;
-    /** Namespace notifications (v1.2 — send/list/markRead/dismiss). */
-    readonly notifications: NotificationsNamespace;
-}
-/**
- * User retornado pelo OIDC ID token. Schema neutro — não vaza Firebase
- * decoded token shape. Subset estável do RFC 7519 + custom claims Neetru.
- */
-interface NeetruUser {
-    /** Subject — uid estável. */
-    uid: string;
-    email: string;
-    emailVerified?: boolean;
-    displayName?: string;
-    photoURL?: string;
-    /** Custom claim Neetru — true quando staff. */
-    isStaff?: boolean;
-    /** Custom claim Neetru — true quando customer enrolled. */
-    isCustomer?: boolean;
-    /** Tenant assigned (multi-tenant deployments). */
-    tenantId?: string;
-    /** Outros claims OIDC (aud, iss, iat, exp). */
-    [extra: string]: unknown;
-}
-interface SignInOptions {
-    /** OIDC redirect_uri override. Default = window.location origin. */
-    redirectUri?: string;
-    /** OIDC scope. Default `openid profile email`. */
-    scope?: string;
-    /** Onde mandar após login completo. Default = window.location.href. */
-    postLoginRedirect?: string;
-}
-type AuthStateListener = (user: NeetruUser | null) => void;
-interface AuthNamespace {
-    /**
-     * Inicia fluxo de login OIDC. Em dev (`NEETRU_ENV=dev`) retorna mock user
-     * direto sem redirect. Em prod redireciona pro authorize endpoint.
-     */
-    signIn(options?: SignInOptions): Promise<NeetruUser | void>;
-    /** Limpa session local + revoga refresh token no servidor. */
-    signOut(): Promise<void>;
-    /** Retorna o user atual (do id_token cached) ou `null` se não logado. */
-    getUser(): NeetruUser | null;
-    /**
-     * Subscreve a mudanças de estado de auth. Listener é invocado imediatamente
-     * com user atual. Retorna função de unsubscribe.
-     */
-    onAuthStateChanged(listener: AuthStateListener): () => void;
-}
-interface UsageEventInput {
-    /** Nome do evento, ex: `report_generated`, `api_call`. */
-    event: string;
-    /** Atributos do evento. Valores primitivos serializáveis. */
-    properties?: Record<string, string | number | boolean | null>;
-    /** Quantidade — default 1 (1 evento). Útil pra batch. */
-    quantity?: number;
-}
-interface UsageQuota {
-    metric: string;
-    /** Quantidade já consumida no período. */
-    used: number;
-    /** Limite total. -1 = unlimited. */
-    limit: number;
-    /** ISO timestamp do reset (próximo período). */
-    resetsAt?: string;
-    /** Plano que define o limite. */
-    plan?: string;
-}
-interface UsageNamespace {
-    /** Persiste um evento de uso. Mock em dev, POST `/sdk/v1/usage/record` em prod. */
-    track(event: string, props?: UsageEventInput['properties']): Promise<{
-        ok: true;
-    }>;
-    /** Lê quota atual de uma métrica. Mock em dev, GET `/sdk/v1/usage/quota` em prod. */
-    getQuota(metric: string): Promise<UsageQuota>;
-    /**
-     * v0.3 — Reporta consumo de um resource metered (POST /sdk/v1/usage/record
-     * com `{productId, tenantId, resource, qty}`). Em dev acumula no mock.
-     *
-     * Diferente de `track()`: usa o endpoint canônico Sprint 7 que incrementa
-     * `usage_counters/{tenantId}_{productId}_{resource}_{yyyymm}` atomicamente.
-     *
-     * `productId`/`tenantId` são lidos do contexto resolvido do client se
-     * ausentes nas options.
-     */
-    report(resource: string, qty?: number, options?: {
-        productId?: string;
-        tenantId?: string;
-    }): Promise<{
-        ok: true;
-        counterId?: string;
-        value?: number;
-        limit?: number;
-        remaining?: number;
-        status?: string;
-    }>;
-    /**
-     * v0.3 — Verifica entitlement de um resource/feature. Wrapper em
-     * GET /sdk/v1/entitlements. Em dev consulta MockEntitlements + MockUsage.
-     */
-    check(resource: string, options?: {
-        productId?: string;
-        tenantId?: string;
-    }): Promise<{
-        allowed: boolean;
-        reason?: string;
-        remaining?: number;
-        limit?: number;
-        planId?: string | null;
-        planFeatures?: string[];
-    }>;
-}
-/**
- * Namespace `db` (v0.3) — wrapper minimalista para CRUD em coleções tenant-scoped
- * via Core REST. Em dev retorna fixtures in-memory por collection.
- *
- * O Core injeta automaticamente o tenantId no path do Firestore:
- * `tenant_{tid}_{name}/{docId}`.
- */
-/** Filtro `where` simples — alinhado com endpoint REST `field:op:value`. */
-interface DbWhereFilter {
-    field: string;
-    op: '==' | '!=' | '<' | '<=' | '>' | '>=' | 'in';
-    value: string | number | boolean | null | Array<string | number | boolean>;
-}
-interface DbListOptions {
-    limit?: number;
-    /** Lista de filtros — máximo 5 (alinhado ao backend). */
-    where?: DbWhereFilter[];
-}
-interface DbCollectionRef {
-    /** Lista documentos com filtros opcionais. */
-    list<T = Record<string, unknown>>(opts?: DbListOptions): Promise<T[]>;
-    /** Lê um documento por id. Retorna `null` se não existe. */
-    get<T = Record<string, unknown>>(id: string): Promise<T | null>;
-    /** Cria/upsert um documento com id explícito. */
-    set(id: string, data: Record<string, unknown>): Promise<{
-        ok: true;
-    }>;
-    /**
-     * v0.3.1 — Adiciona doc com id auto-gerado pelo backend. Retorna `{id}` do
-     * doc criado. Diferente de `set(id, data)` que requer caller fornecer id.
-     */
-    add(data: Record<string, unknown>): Promise<{
-        ok: true;
-        id: string;
-    }>;
-    /** Atualiza doc com merge — só campos passados em `data`. */
-    update(id: string, data: Record<string, unknown>): Promise<{
-        ok: true;
-    }>;
-    /** Deleta um documento. */
-    remove(id: string): Promise<{
-        ok: true;
-    }>;
-}
-interface DbNamespace {
-    collection(name: string): DbCollectionRef;
-}
-type SupportSeverity = 'low' | 'normal' | 'high' | 'urgent';
-type SupportStatus = 'open' | 'pending' | 'resolved' | 'closed';
-interface SupportTicket {
-    id: string;
-    subject: string;
-    message: string;
-    severity: SupportSeverity;
-    status: SupportStatus;
-    createdAt: string;
-    updatedAt?: string;
-    /** Slug do produto referenciado. */
-    productSlug?: string;
-}
-interface CreateTicketInput {
-    subject: string;
-    message: string;
-    severity?: SupportSeverity;
-    productSlug?: string;
-}
-interface SupportNamespace {
-    /** Cria um novo ticket. Mock em dev, POST `/api/v1/products/{slug}/tickets` em prod. */
-    createTicket(input: CreateTicketInput): Promise<SupportTicket>;
-    /** Lista meus tickets abertos. */
-    listMyTickets(): Promise<SupportTicket[]>;
-}
-/**
- * Modo do SDK. `dev` ativa mocks automáticos (úteis pra testes e
- * desenvolvimento sem precisar de backend rodando).
- */
-type NeetruEnv = 'dev' | 'workspace' | 'prod';
-/**
- * Configuração resolvida (defaults aplicados, fetch garantido).
- */
-interface ResolvedConfig {
-    readonly apiKey?: string;
-    readonly baseUrl: string;
-    readonly fetch: typeof globalThis.fetch;
-    /** Resolved env — `dev` | `workspace` | `prod`. Default `prod`. */
-    readonly env: NeetruEnv;
-    /** Default productId (v0.3). */
-    readonly productId?: string;
-    /** Default tenantId (v0.3). */
-    readonly tenantId?: string;
-}
-/** Opções pra `catalog.list()`. */
-interface CatalogListOptions {
-    /** Inclui rascunhos (apenas com Bearer staff). Default false. */
-    includeDrafts?: boolean;
-}
-
-export { verifyWebhookSignature as $, type AuthNamespace as A, type SupportSeverity as B, type CatalogListOptions as C, DEFAULT_BASE_URL as D, type EntitlementCheck as E, type SupportStatus as F, type SupportTicket as G, type TelemetryEventInput as H, type UsageNamespace as I, type UsageQuota as J, type WebhookEvent as K, type ListNotificationsOptions as L, MockCheckout as M, type NeetruClientConfig as N, type WebhookTestResult as O, type Product as P, type WebhooksNamespace as Q, type RegisterWebhookInput as R, type SendNotificationInput as S, type TelemetryEventAck as T, type UsageEventInput as U, createCheckoutNamespace as V, type WebhookEndpoint as W, createNotificationsNamespace as X, createWebhooksNamespace as Y, type TelemetryLogInput as Z, type TelemetryLogAck as _, 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, MockNotifications as o, MockWebhooks as p, type NeetruEnv as q, type NeetruUser as r, type NotificationsNamespace as s, type ProductNotification as t, type ProductNotificationSeverity as u, type ProductPlan as v, type ProductStatus as w, type ResolvedConfig as x, type SignInOptions as y, type SupportNamespace as z };