@neetru/sdk 1.0.0

package/dist/types-PKUaFtBY.d.ts

@@ -0,0 +1,408 @@
+/**
+ * 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;
+    };
+    /**
+     * 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. */
+    readonly entitlements: {
+        /**
+         * Verifica se o portador da apiKey pode usar `feature` do produto `slug`.
+         * Retorna boolean por contrato simplificado v0.1.
+         */
+        check(productSlug: string, feature: string): Promise<boolean>;
+        /** Variante que retorna o objeto completo com `reason`. */
+        checkDetailed(productSlug: string, feature: string): Promise<EntitlementCheck>;
+    };
+    /** Namespace telemetria. */
+    readonly telemetry: {
+        /** Persiste um evento. Não lança em rate-limit não-fatal — relança outros erros. */
+        event(input: TelemetryEventInput): Promise<TelemetryEventAck>;
+        /**
+         * Registra um log estruturado per-product (Sprint 6).
+         *
+         * - Em `NEETRU_ENV=dev`: apenas console.{level} (sem network).
+         * - Em `workspace`/`prod`: POST `/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;
+}
+/**
+ * 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 { 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 };

package/dist/usage.cjs

@@ -0,0 +1,235 @@
+'use strict';
+
+// src/errors.ts
+var NeetruError = class _NeetruError extends Error {
+  code;
+  status;
+  requestId;
+  constructor(code, message, status, requestId) {
+    super(message);
+    this.name = "NeetruError";
+    this.code = code;
+    this.status = status;
+    this.requestId = requestId;
+    Object.setPrototypeOf(this, _NeetruError.prototype);
+  }
+};
+
+// src/http.ts
+function statusToCode(status) {
+  if (status === 401) return "unauthorized";
+  if (status === 403) return "forbidden";
+  if (status === 404) return "not_found";
+  if (status === 422 || status === 400) return "validation_failed";
+  if (status === 429) return "rate_limited";
+  if (status >= 500) return "server_error";
+  return "unknown";
+}
+function buildUrl(baseUrl, path, query) {
+  const base = baseUrl.replace(/\/+$/, "");
+  const p = path.startsWith("/") ? path : `/${path}`;
+  const url = new URL(`${base}${p}`);
+  if (query) {
+    for (const [k, v] of Object.entries(query)) {
+      if (v === void 0) continue;
+      url.searchParams.set(k, String(v));
+    }
+  }
+  return url.toString();
+}
+async function safeJson(res) {
+  const text = await res.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+async function httpRequest(config, opts) {
+  const method = opts.method ?? "GET";
+  const url = buildUrl(config.baseUrl, opts.path, opts.query);
+  const headers = {
+    accept: "application/json",
+    ...opts.headers
+  };
+  if (opts.requireAuth) {
+    if (!config.apiKey) {
+      throw new NeetruError(
+        "missing_api_key",
+        "This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var."
+      );
+    }
+    headers.authorization = `Bearer ${config.apiKey}`;
+  }
+  const init = { method, headers };
+  if (opts.body !== void 0 && method !== "GET" && method !== "DELETE") {
+    headers["content-type"] = "application/json";
+    init.body = JSON.stringify(opts.body);
+  }
+  let res;
+  try {
+    res = await config.fetch(url, init);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "fetch failed";
+    throw new NeetruError("network_error", `Network error: ${message}`);
+  }
+  const requestId = res.headers.get("x-request-id") ?? res.headers.get("x-correlation-id") ?? void 0;
+  if (!res.ok) {
+    const body = await safeJson(res);
+    let code = statusToCode(res.status);
+    let message = `HTTP ${res.status}`;
+    if (body && typeof body === "object" && "error" in body) {
+      const errField = body.error;
+      if (typeof errField === "string") {
+        message = errField;
+      } else if (errField && typeof errField === "object") {
+        if (typeof errField.code === "string") code = errField.code;
+        if (typeof errField.message === "string") message = errField.message;
+      }
+    }
+    throw new NeetruError(code, message, res.status, requestId);
+  }
+  const parsed = await safeJson(res);
+  return parsed;
+}
+
+// src/usage.ts
+function toQuota(metric, raw) {
+  if (!raw || typeof raw !== "object") {
+    throw new NeetruError("invalid_response", "Quota response is not an object");
+  }
+  const r = raw;
+  if (typeof r.used !== "number" || typeof r.limit !== "number") {
+    throw new NeetruError("invalid_response", "Quota response missing used/limit numbers");
+  }
+  return {
+    metric: typeof r.metric === "string" ? r.metric : metric,
+    used: r.used,
+    limit: r.limit,
+    resetsAt: typeof r.resetsAt === "string" ? r.resetsAt : void 0,
+    plan: typeof r.plan === "string" ? r.plan : void 0
+  };
+}
+function createUsageNamespace(config) {
+  return {
+    /**
+     * Persiste um evento de usage. Em dev (mocks ativos via factory) só loga.
+     * Em workspace/prod chama POST /sdk/v1/usage/record.
+     */
+    async track(event, properties) {
+      if (!event || typeof event !== "string") {
+        throw new NeetruError("validation_failed", "event name is required");
+      }
+      if (event.length > 128) {
+        throw new NeetruError("validation_failed", "event name max 128 chars");
+      }
+      const body = { event };
+      if (properties && typeof properties === "object") body.properties = properties;
+      const raw = await httpRequest(config, {
+        method: "POST",
+        path: "/sdk/v1/usage/record",
+        body,
+        requireAuth: true
+      });
+      if (!raw || raw.ok !== true) {
+        throw new NeetruError("invalid_response", "Usage record response missing ok");
+      }
+      return { ok: true };
+    },
+    /**
+     * Lê quota atual de uma métrica. Cacheável (caller decide), SDK não cacheia.
+     */
+    async getQuota(metric) {
+      if (!metric || typeof metric !== "string") {
+        throw new NeetruError("validation_failed", "metric is required");
+      }
+      const raw = await httpRequest(config, {
+        method: "GET",
+        path: "/sdk/v1/usage/quota",
+        query: { metric },
+        requireAuth: true
+      });
+      return toQuota(metric, raw);
+    },
+    /**
+     * v0.3 — Reporta consumo metered. Hit no endpoint canônico Sprint 7.
+     */
+    async report(resource, qty = 1, options) {
+      if (!resource || typeof resource !== "string") {
+        throw new NeetruError("validation_failed", "resource is required");
+      }
+      if (!Number.isFinite(qty) || qty <= 0) {
+        throw new NeetruError("validation_failed", "qty must be positive integer");
+      }
+      const productId = options?.productId ?? config.productId;
+      const tenantId = options?.tenantId ?? config.tenantId;
+      if (!productId) {
+        throw new NeetruError(
+          "validation_failed",
+          "productId required (pass to options or set on createNeetruClient)"
+        );
+      }
+      if (!tenantId) {
+        throw new NeetruError(
+          "validation_failed",
+          "tenantId required (pass to options or set on createNeetruClient)"
+        );
+      }
+      const raw = await httpRequest(config, {
+        method: "POST",
+        path: "/sdk/v1/usage/record",
+        body: { productId, tenantId, resource, qty: Math.floor(qty) },
+        requireAuth: true
+      });
+      if (!raw || raw.ok !== true) {
+        throw new NeetruError("invalid_response", "usage.report response missing ok");
+      }
+      return {
+        ok: true,
+        counterId: raw.counterId,
+        value: raw.value,
+        limit: raw.limit,
+        remaining: raw.remaining,
+        status: raw.status
+      };
+    },
+    /**
+     * v0.3 — Verifica entitlement de um resource via GET /sdk/v1/entitlements.
+     */
+    async check(resource, options) {
+      if (!resource || typeof resource !== "string") {
+        throw new NeetruError("validation_failed", "resource is required");
+      }
+      const productId = options?.productId ?? config.productId;
+      const tenantId = options?.tenantId ?? config.tenantId;
+      if (!productId || !tenantId) {
+        throw new NeetruError(
+          "validation_failed",
+          "productId and tenantId required"
+        );
+      }
+      const raw = await httpRequest(config, {
+        method: "GET",
+        path: "/sdk/v1/entitlements",
+        query: { productId, tenantId, feature: resource },
+        requireAuth: true
+      });
+      if (!raw || typeof raw.allowed !== "boolean") {
+        throw new NeetruError("invalid_response", "usage.check response missing allowed");
+      }
+      return {
+        allowed: raw.allowed,
+        reason: raw.reason,
+        remaining: raw.remaining,
+        limit: raw.limit,
+        planId: raw.planId,
+        planFeatures: raw.planFeatures
+      };
+    }
+  };
+}
+
+exports.createUsageNamespace = createUsageNamespace;
+//# sourceMappingURL=usage.cjs.map
+//# sourceMappingURL=usage.cjs.map

package/dist/usage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/usage.ts"],"names":[],"mappings":"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","file":"usage.cjs","sourcesContent":["/**\n * Erros tipados do SDK.\n *\n * Todo erro lançado pelo SDK estende `NeetruError` — caller pode discriminar\n * por `.code` (string estável) sem parsing de message.\n */\n\n/** Códigos de erro estáveis do SDK. Adicionar aqui requer minor bump. */\nexport type NeetruErrorCode =\n  | 'invalid_config'\n  | 'missing_api_key'\n  | 'unauthorized'\n  | 'forbidden'\n  | 'not_found'\n  | 'rate_limited'\n  | 'validation_failed'\n  | 'network_error'\n  | 'invalid_response'\n  | 'server_error'\n  | 'unknown';\n\n/**\n * Erro tipado padrão do SDK. Sempre lançado em vez de Error genérico.\n *\n * @example\n * ```ts\n * try { await client.catalog.list(); }\n * catch (e) {\n *   if (e instanceof NeetruError && e.code === 'rate_limited') retry();\n * }\n * ```\n */\nexport class NeetruError extends Error {\n  public readonly code: NeetruErrorCode | string;\n  public readonly status?: number;\n  public readonly requestId?: string;\n\n  constructor(\n    code: NeetruErrorCode | string,\n    message: string,\n    status?: number,\n    requestId?: string,\n  ) {\n    super(message);\n    this.name = 'NeetruError';\n    this.code = code;\n    this.status = status;\n    this.requestId = requestId;\n    // Preserva o prototype chain ao herdar de Error (downlevel quirk de TS).\n    Object.setPrototypeOf(this, NeetruError.prototype);\n  }\n}\n","/**\n * HTTP transport interno do SDK.\n *\n * Responsabilidades:\n *   - Construir URL absoluta a partir de `baseUrl` + path\n *   - Injetar Bearer token quando `requireAuth=true`\n *   - Mapear status HTTP → `NeetruError` com `code` estável\n *   - Parse defensivo de JSON (não lança em body vazio em 204)\n *\n * Não faz retry/backoff em v0.1 (carry-over Sprint 3+).\n */\nimport { NeetruError, type NeetruErrorCode } from './errors';\nimport type { ResolvedConfig } from './types';\n\n/** Opções da request HTTP. */\nexport interface HttpRequestOptions {\n  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n  /** Path relativo (ex: `/api/v1/cli/catalog`). Concatenado a `baseUrl`. */\n  path: string;\n  /** Query string params (chave → valor primitivo). Valores `undefined` ignorados. */\n  query?: Record<string, string | number | boolean | undefined>;\n  /** Body JSON-serializável. Ignorado em GET/DELETE. */\n  body?: unknown;\n  /**\n   * Se true, injeta `Authorization: Bearer <apiKey>`. Lança `missing_api_key`\n   * se config.apiKey ausente. Default false.\n   */\n  requireAuth?: boolean;\n  /** Cabeçalhos extras. */\n  headers?: Record<string, string>;\n}\n\n/** Mapeamento status → code estável do NeetruError. */\nfunction statusToCode(status: number): NeetruErrorCode {\n  if (status === 401) return 'unauthorized';\n  if (status === 403) return 'forbidden';\n  if (status === 404) return 'not_found';\n  if (status === 422 || status === 400) return 'validation_failed';\n  if (status === 429) return 'rate_limited';\n  if (status >= 500) return 'server_error';\n  return 'unknown';\n}\n\nfunction buildUrl(baseUrl: string, path: string, query?: HttpRequestOptions['query']): string {\n  // Trim trailing slash em base e leading em path pra evitar `//`.\n  const base = baseUrl.replace(/\\/+$/, '');\n  const p = path.startsWith('/') ? path : `/${path}`;\n  const url = new URL(`${base}${p}`);\n  if (query) {\n    for (const [k, v] of Object.entries(query)) {\n      if (v === undefined) continue;\n      url.searchParams.set(k, String(v));\n    }\n  }\n  return url.toString();\n}\n\n/** Parse JSON defensivo — retorna `undefined` em body vazio. */\nasync function safeJson(res: Response): Promise<unknown> {\n  const text = await res.text();\n  if (!text) return undefined;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Executa request HTTP. Em sucesso retorna body parseado; em erro lança\n * `NeetruError` com `code` derivado do status.\n */\nexport async function httpRequest<T>(\n  config: ResolvedConfig,\n  opts: HttpRequestOptions,\n): Promise<T> {\n  const method = opts.method ?? 'GET';\n  const url = buildUrl(config.baseUrl, opts.path, opts.query);\n\n  const headers: Record<string, string> = {\n    accept: 'application/json',\n    ...opts.headers,\n  };\n\n  if (opts.requireAuth) {\n    if (!config.apiKey) {\n      throw new NeetruError(\n        'missing_api_key',\n        'This operation requires an apiKey. Pass it to createNeetruClient({ apiKey }) or set NEETRU_API_KEY env var.',\n      );\n    }\n    headers.authorization = `Bearer ${config.apiKey}`;\n  }\n\n  const init: RequestInit = { method, headers };\n  if (opts.body !== undefined && method !== 'GET' && method !== 'DELETE') {\n    headers['content-type'] = 'application/json';\n    init.body = JSON.stringify(opts.body);\n  }\n\n  let res: Response;\n  try {\n    res = await config.fetch(url, init);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : 'fetch failed';\n    throw new NeetruError('network_error', `Network error: ${message}`);\n  }\n\n  const requestId = res.headers.get('x-request-id') ?? res.headers.get('x-correlation-id') ?? undefined;\n\n  if (!res.ok) {\n    const body = (await safeJson(res)) as { error?: { code?: string; message?: string } | string } | undefined;\n    let code: string = statusToCode(res.status);\n    let message = `HTTP ${res.status}`;\n    if (body && typeof body === 'object' && 'error' in body) {\n      const errField = body.error;\n      if (typeof errField === 'string') {\n        message = errField;\n      } else if (errField && typeof errField === 'object') {\n        if (typeof errField.code === 'string') code = errField.code;\n        if (typeof errField.message === 'string') message = errField.message;\n      }\n    }\n    throw new NeetruError(code, message, res.status, requestId);\n  }\n\n  const parsed = await safeJson(res);\n  // Caller é responsável por validar shape; SDK assume backend correto.\n  return parsed as T;\n}\n","/**\n * Usage namespace — track usage events e ler quotas (v0.2).\n *\n * Endpoints consumidos (em prod):\n *   - `POST /sdk/v1/usage/record` — record event\n *   - `GET  /sdk/v1/usage/quota?metric=X` — ler quota da metric\n *\n * Comportamento por env:\n *   - `dev` → MockUsage (in-memory, retornado pelo factory).\n *   - `workspace`/`prod` → HTTP real.\n *\n * Diferença vs `telemetry`: telemetry é evento analítico (event sourcing pra\n * BigQuery). usage é meterado (consumo cobrado), com quota explícita por plano.\n */\nimport { NeetruError } from './errors';\nimport { httpRequest } from './http';\nimport type { ResolvedConfig, UsageNamespace, UsageQuota } from './types';\n\ninterface RawUsageAck {\n  ok?: boolean;\n  recordId?: string;\n}\n\ninterface RawUsageQuota {\n  metric?: string;\n  used?: number;\n  limit?: number;\n  resetsAt?: string;\n  plan?: string;\n}\n\nfunction toQuota(metric: string, raw: unknown): UsageQuota {\n  if (!raw || typeof raw !== 'object') {\n    throw new NeetruError('invalid_response', 'Quota response is not an object');\n  }\n  const r = raw as RawUsageQuota;\n  if (typeof r.used !== 'number' || typeof r.limit !== 'number') {\n    throw new NeetruError('invalid_response', 'Quota response missing used/limit numbers');\n  }\n  return {\n    metric: typeof r.metric === 'string' ? r.metric : metric,\n    used: r.used,\n    limit: r.limit,\n    resetsAt: typeof r.resetsAt === 'string' ? r.resetsAt : undefined,\n    plan: typeof r.plan === 'string' ? r.plan : undefined,\n  };\n}\n\nexport function createUsageNamespace(config: ResolvedConfig): UsageNamespace {\n  return {\n    /**\n     * Persiste um evento de usage. Em dev (mocks ativos via factory) só loga.\n     * Em workspace/prod chama POST /sdk/v1/usage/record.\n     */\n    async track(\n      event: string,\n      properties?: Record<string, string | number | boolean | null>,\n    ): Promise<{ ok: true }> {\n      if (!event || typeof event !== 'string') {\n        throw new NeetruError('validation_failed', 'event name is required');\n      }\n      if (event.length > 128) {\n        throw new NeetruError('validation_failed', 'event name max 128 chars');\n      }\n\n      const body: Record<string, unknown> = { event };\n      if (properties && typeof properties === 'object') body.properties = properties;\n\n      const raw = await httpRequest<RawUsageAck>(config, {\n        method: 'POST',\n        path: '/sdk/v1/usage/record',\n        body,\n        requireAuth: true,\n      });\n\n      if (!raw || raw.ok !== true) {\n        throw new NeetruError('invalid_response', 'Usage record response missing ok');\n      }\n      return { ok: true };\n    },\n\n    /**\n     * Lê quota atual de uma métrica. Cacheável (caller decide), SDK não cacheia.\n     */\n    async getQuota(metric: string): Promise<UsageQuota> {\n      if (!metric || typeof metric !== 'string') {\n        throw new NeetruError('validation_failed', 'metric is required');\n      }\n      const raw = await httpRequest<RawUsageQuota>(config, {\n        method: 'GET',\n        path: '/sdk/v1/usage/quota',\n        query: { metric },\n        requireAuth: true,\n      });\n      return toQuota(metric, raw);\n    },\n\n    /**\n     * v0.3 — Reporta consumo metered. Hit no endpoint canônico Sprint 7.\n     */\n    async report(\n      resource: string,\n      qty: number = 1,\n      options?: { productId?: string; tenantId?: string },\n    ) {\n      if (!resource || typeof resource !== 'string') {\n        throw new NeetruError('validation_failed', 'resource is required');\n      }\n      if (!Number.isFinite(qty) || qty <= 0) {\n        throw new NeetruError('validation_failed', 'qty must be positive integer');\n      }\n      const productId = options?.productId ?? config.productId;\n      const tenantId = options?.tenantId ?? config.tenantId;\n      if (!productId) {\n        throw new NeetruError(\n          'validation_failed',\n          'productId required (pass to options or set on createNeetruClient)',\n        );\n      }\n      if (!tenantId) {\n        throw new NeetruError(\n          'validation_failed',\n          'tenantId required (pass to options or set on createNeetruClient)',\n        );\n      }\n\n      const raw = await httpRequest<{\n        ok?: boolean;\n        counterId?: string;\n        value?: number;\n        limit?: number;\n        remaining?: number;\n        status?: string;\n      }>(config, {\n        method: 'POST',\n        path: '/sdk/v1/usage/record',\n        body: { productId, tenantId, resource, qty: Math.floor(qty) },\n        requireAuth: true,\n      });\n      if (!raw || raw.ok !== true) {\n        throw new NeetruError('invalid_response', 'usage.report response missing ok');\n      }\n      return {\n        ok: true as const,\n        counterId: raw.counterId,\n        value: raw.value,\n        limit: raw.limit,\n        remaining: raw.remaining,\n        status: raw.status,\n      };\n    },\n\n    /**\n     * v0.3 — Verifica entitlement de um resource via GET /sdk/v1/entitlements.\n     */\n    async check(\n      resource: string,\n      options?: { productId?: string; tenantId?: string },\n    ) {\n      if (!resource || typeof resource !== 'string') {\n        throw new NeetruError('validation_failed', 'resource is required');\n      }\n      const productId = options?.productId ?? config.productId;\n      const tenantId = options?.tenantId ?? config.tenantId;\n      if (!productId || !tenantId) {\n        throw new NeetruError(\n          'validation_failed',\n          'productId and tenantId required',\n        );\n      }\n      const raw = await httpRequest<{\n        allowed?: boolean;\n        reason?: string;\n        remaining?: number;\n        limit?: number;\n        planId?: string | null;\n        planFeatures?: string[];\n      }>(config, {\n        method: 'GET',\n        path: '/sdk/v1/entitlements',\n        query: { productId, tenantId, feature: resource },\n        requireAuth: true,\n      });\n      if (!raw || typeof raw.allowed !== 'boolean') {\n        throw new NeetruError('invalid_response', 'usage.check response missing allowed');\n      }\n      return {\n        allowed: raw.allowed,\n        reason: raw.reason,\n        remaining: raw.remaining,\n        limit: raw.limit,\n        planId: raw.planId,\n        planFeatures: raw.planFeatures,\n      };\n    },\n  };\n}\n"]}