@cabrapi/sdk 1.0.0-alpha.0

package/README.md

@@ -0,0 +1,97 @@
+
+# 🚀 @cabrapi/sdk
+
+## 📋 Visão geral
+
+O `@cabrapi/sdk` fornece uma interface unificada e tipada para comunicação com os serviços da caBRAPI, suportando dois modos de autenticação:
+
+| Modo | Ambiente | Emoji |
+|------|----------|-------|
+| **Público** (`public`) | Cliente (navegador) | 🌐 |
+| **Privado** (`private`) | Servidor (Node.js) | 🔒 |
+
+## 📦 Instalação
+
+```bash
+npm install @cabrapi/sdk
+```
+
+## 🎯 Modos de uso
+
+### 🌐 Modo público (client-side)
+
+> Ideal para SPAs, React, Vue, Angular e qualquer aplicação que rode no navegador.
+
+```typescript
+import { caBRAPI } from '@cabrapi/sdk';
+
+const client = new caBRAPI({
+  type: 'public',
+  config: {} // Configuração vazia para modo público
+});
+```
+
+### 🔒 Modo privado (server-side)
+
+> Para operações seguras no backend com chave de API.
+
+```typescript
+import { caBRAPI } from '@cabrapi/sdk';
+
+const client = new caBRAPI({
+  type: 'private',
+  config: {
+    key: 'SUA_API_KEY' // 🔑 Sua chave de acesso
+  }
+});
+```
+
+### ☁️ CDN 
+
+> Use diretamente no navegador sem ferramentas de build.
+
+```html
+<script type="module">
+  import { caBRAPI } from 'https://cdn.jsdelivr.net/npm/@cabrapi/sdk/dist/index.js';
+  
+  const client = new caBRAPI({
+    type: 'public',
+    config: {}
+  });
+</script>
+```
+
+## ⚙️ Configuração
+
+### Opções do cliente
+
+| Propriedade | Tipo | Obrigatório | Descrição |
+|-------------|------|-------------|-----------|
+| `type` | `'public' \| 'private'` | ✅ | Modo de autenticação |
+| `config` | `PublicConfig \| PrivateConfig` | ✅ | Configurações específicas |
+
+### 📂 Configuração pública (`public`)
+
+| Propriedade | Tipo | Descrição |
+|-------------|------|-------------|
+| - | - | Nenhuma configuração necessária |
+
+### 🔐 Configuração privada (`private`)
+
+| Propriedade | Tipo | Descrição |
+|-------------|------|-------------|
+| `key` | `string` | 🔑 Chave da API para autenticação |
+
+## 📌 Requisitos
+
+| Ambiente | Versão |
+|----------|--------|
+| **Node.js** (modo privado) | `>= 18.x` |
+| **Browsers** (modo público) | ES2020+ |
+| **TypeScript** | Suporte nativo ✅ |
+
+## 📞 Suporte
+
+• 📚 Documentação: https://docs.cabrapi.com.br
+
+• 🐛 Issues: https://github.com/cabrapi/sdk-node-browser/issues

package/dist/index.cjs

@@ -0,0 +1,185 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  caBRAPI: () => caBRAPI
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/http.ts
+var import_axios = __toESM(require("axios"), 1);
+function createAxios(config = {}) {
+  const instance = import_axios.default.create({
+    baseURL: config.baseURL ?? "https://api.cabrapi.com.br",
+    timeout: 3e4,
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use((req) => {
+    const r = req ?? {};
+    if (config.apiKey) {
+      if (!r.headers) r.headers = {};
+      const headers = r.headers;
+      headers.Authorization = `Bearer ${config.apiKey}`;
+    }
+    return r;
+  });
+  instance.interceptors.response.use(
+    (res) => res,
+    (err) => {
+      let message = "Unknown error";
+      if (err && typeof err === "object") {
+        const ae = err;
+        if (typeof ae.message === "string") {
+          message = ae.message;
+        }
+        if (ae.response && typeof ae.response === "object") {
+          const data = ae.response.data;
+          if (data && typeof data === "object") {
+            const d = data;
+            const maybeMsg = d.message ?? d.code;
+            if (typeof maybeMsg === "string") message = maybeMsg;
+          }
+        }
+      } else if (typeof err === "string") {
+        message = err;
+      }
+      return Promise.reject(new Error(message));
+    }
+  );
+  return instance;
+}
+
+// src/core/client.ts
+var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+var CoreClient = class {
+  constructor(options) {
+    this.mode = options.type;
+    this.isBrowser = isBrowser;
+    if (this.mode === "private" && !options.config?.key && !this.isBrowser) {
+      throw new Error("API key \xE9 obrigat\xF3ria no modo 'private'.");
+    }
+    const apiKey = !this.isBrowser && this.mode === "private" ? options.config?.key : void 0;
+    this.http = createAxios({ apiKey });
+    if (this.isBrowser && this.mode === "private") {
+      console.warn(
+        "[caBRAPI] Modo 'private' detectado no navegador. API key ignorada."
+      );
+    }
+  }
+  /**
+   * Está em modo privado (backend)
+   */
+  isPrivate() {
+    return !this.isBrowser && this.mode === "private";
+  }
+  /**
+   * Está em modo público
+   */
+  isPublic() {
+    return this.isBrowser || this.mode === "public";
+  }
+  /**
+   * Garante execução no backend
+   */
+  assertPrivate() {
+    if (!this.isPrivate()) {
+      throw new Error(
+        "Este m\xE9todo \xE9 privado e n\xE3o pode ser usado no navegador."
+      );
+    }
+  }
+};
+
+// src/core/module/pages/http/delete.ts
+async function deletePage(core, domain) {
+  if (!core.isPrivate()) {
+    throw new Error("M\xE9todo privado dispon\xEDvel apenas no backend.");
+  }
+  const { data } = await core.http.delete(
+    `/pages/${domain}`
+  );
+  return data.status;
+}
+
+// src/core/module/pages/http/get.ts
+async function getPage(core, domain) {
+  const { data } = await core.http.get(`/pages/${domain}`);
+  if (!data?.data) {
+    throw new Error(`Page not found: ${domain}`);
+  }
+  return data.data;
+}
+
+// src/core/module/pages/http/upsert.ts
+async function upsertPage(core, input) {
+  if (!core.isPrivate()) {
+    throw new Error("M\xE9todo privado dispon\xEDvel apenas no backend.");
+  }
+  const { data } = await core.http.put(
+    `/pages/${input.domain}`,
+    {
+      html: input.html,
+      template: input.template
+    }
+  );
+  return data.status;
+}
+
+// src/core/module/pages/index.ts
+var Pages = class {
+  constructor(core) {
+    this.core = core;
+  }
+  get(domain) {
+    return getPage(this.core, domain);
+  }
+  upsert(input) {
+    return upsertPage(this.core, input);
+  }
+  delete(domain) {
+    return deletePage(this.core, domain);
+  }
+};
+
+// src/index.ts
+var caBRAPI = class {
+  constructor(options) {
+    const core = new CoreClient(options);
+    this.pages = new Pages(core);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  caBRAPI
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core/http.ts","../src/core/client.ts","../src/core/module/pages/http/delete.ts","../src/core/module/pages/http/get.ts","../src/core/module/pages/http/upsert.ts","../src/core/module/pages/index.ts"],"sourcesContent":["import { type ClientOptions, CoreClient } from \"./core/client\";\nimport { Pages } from \"./core/module/pages/index\";\n\n/**\n * SDK principal da caBRAPI\n */\nexport class caBRAPI {\n  public pages: Pages;\n\n  constructor(options: ClientOptions) {\n    const core = new CoreClient(options);\n\n    this.pages = new Pages(core);\n  }\n}\n","import axios, {\n  type AxiosInstance,\n  type AxiosRequestConfig,\n  type AxiosResponse,\n} from \"axios\";\n\n/**\n * Configurações para criação da instância Axios.\n */\nexport type AxiosConfig = {\n  /**\n   * URL base da API.\n   * @default \"https://api.cabrapi.com.br\"\n   */\n  baseURL?: string;\n\n  /**\n   * Chave da API (modo privado).\n   */\n  apiKey?: string;\n};\n\n/**\n * Cria uma instância HTTP configurada para a caBRAPI.\n */\nexport function createAxios(config: AxiosConfig = {}): AxiosInstance {\n  const instance = axios.create({\n    baseURL: config.baseURL ?? \"https://api.cabrapi.com.br\",\n    timeout: 30000,\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  // 🔐 Request interceptor\n  instance.interceptors.request.use((req?: AxiosRequestConfig) => {\n    const r: AxiosRequestConfig = req ?? {};\n    if (config.apiKey) {\n      if (!r.headers) r.headers = {};\n      const headers = r.headers as Record<string, string | number | boolean>;\n      headers.Authorization = `Bearer ${config.apiKey}`;\n    }\n    return r;\n  });\n\n  // ⚠️ Response interceptor\n  instance.interceptors.response.use(\n    (res: AxiosResponse) => res,\n    (err: unknown) => {\n      let message = \"Unknown error\";\n\n      type MaybeAxiosLike = {\n        message?: unknown;\n        response?: { data?: unknown };\n      };\n      if (err && typeof err === \"object\") {\n        const ae = err as MaybeAxiosLike;\n        if (typeof ae.message === \"string\") {\n          message = ae.message;\n        }\n\n        if (ae.response && typeof ae.response === \"object\") {\n          const data = ae.response.data;\n          if (data && typeof data === \"object\") {\n            const d = data as Record<string, unknown>;\n            const maybeMsg = d.message ?? d.code;\n            if (typeof maybeMsg === \"string\") message = maybeMsg;\n          }\n        }\n      } else if (typeof err === \"string\") {\n        message = err;\n      }\n\n      return Promise.reject(new Error(message));\n    },\n  );\n\n  return instance;\n}\n","import { createAxios } from \"./http\";\n\n/**\n * Tipo derivado da instância do Axios\n * (evita problemas no build de types)\n */\ntype AxiosInstance = ReturnType<typeof createAxios>;\n\n/**\n * Modos disponíveis\n */\nexport type ClientMode = \"public\" | \"private\";\n\n/**\n * Opções do cliente\n */\nexport type ClientOptions = {\n  type: ClientMode;\n  config?: {\n    key?: string;\n  };\n};\n\n/**\n * Detecta ambiente\n */\nconst isBrowser =\n  typeof window !== \"undefined\" && typeof document !== \"undefined\";\n\n/**\n * Cliente base da caBRAPI\n */\nexport class CoreClient {\n  public http: AxiosInstance;\n  public mode: ClientMode;\n  public isBrowser: boolean;\n\n  constructor(options: ClientOptions) {\n    this.mode = options.type;\n    this.isBrowser = isBrowser;\n\n    // 🔒 validação backend\n    if (this.mode === \"private\" && !options.config?.key && !this.isBrowser) {\n      throw new Error(\"API key é obrigatória no modo 'private'.\");\n    }\n\n    // 🔐 só backend usa key\n    const apiKey =\n      !this.isBrowser && this.mode === \"private\"\n        ? options.config?.key\n        : undefined;\n\n    this.http = createAxios({ apiKey });\n\n    // ⚠️ aviso dev\n    if (this.isBrowser && this.mode === \"private\") {\n      console.warn(\n        \"[caBRAPI] Modo 'private' detectado no navegador. API key ignorada.\",\n      );\n    }\n  }\n\n  /**\n   * Está em modo privado (backend)\n   */\n  public isPrivate(): boolean {\n    return !this.isBrowser && this.mode === \"private\";\n  }\n\n  /**\n   * Está em modo público\n   */\n  public isPublic(): boolean {\n    return this.isBrowser || this.mode === \"public\";\n  }\n\n  /**\n   * Garante execução no backend\n   */\n  public assertPrivate(): void {\n    if (!this.isPrivate()) {\n      throw new Error(\n        \"Este método é privado e não pode ser usado no navegador.\",\n      );\n    }\n  }\n}\n","import type { CoreClient } from \"../../../client\";\n\n/**\n * Resposta do endpoint de exclusão de página\n */\ntype DeletePageResponse = {\n  status: boolean;\n  code: string;\n};\n\n/**\n * DELETE /pages/:domain\n *\n * Remove a página publicada de uma loja pelo domínio.\n *\n * 🔒 Endpoint privado (somente backend)\n *\n * @param core - Instância do CoreClient (modo private)\n * @param domain - Domínio da página (ex: \"minhaloja.com.br\")\n *\n * @returns `true` se a exclusão foi bem-sucedida\n *\n * @throws Error se usado no navegador ou se a API retornar erro\n */\nexport async function deletePage(\n  core: CoreClient,\n  domain: string,\n): Promise<boolean> {\n  if (!core.isPrivate()) {\n    throw new Error(\"Método privado disponível apenas no backend.\");\n  }\n\n  const { data } = await core.http.delete<DeletePageResponse>(\n    `/pages/${domain}`,\n  );\n\n  return data.status;\n}\n","import type { CoreClient } from \"../../../client\";\n\n/**\n * Representa a página retornada pela API\n */\nexport type Page = {\n  html: string;\n  template?: string;\n  version?: string;\n  createdAt?: string;\n  updatedAt?: string;\n  store?: {\n    ownerId: string;\n  };\n};\n\n/**\n * Estrutura padrão da resposta da API\n */\ntype PageResponse = {\n  status: boolean;\n  data: Page;\n};\n\n/**\n * GET /pages/:domain\n *\n * Busca a página pública de uma loja pelo domínio.\n *\n * 🔓 Endpoint público (pode ser usado no navegador ou backend)\n *\n * @param core - Instância do CoreClient já configurada\n * @param domain - Domínio da loja (ex: \"minhaloja.com.br\")\n *\n * @returns Dados da página renderizada (HTML + metadados)\n *\n * @throws Error quando a página não existe ou a API retorna erro\n */\nexport async function getPage(core: CoreClient, domain: string): Promise<Page> {\n  const { data } = await core.http.get<PageResponse>(`/pages/${domain}`);\n\n  if (!data?.data) {\n    throw new Error(`Page not found: ${domain}`);\n  }\n\n  return data.data;\n}\n","import type { CoreClient } from \"../../../client\";\n\nexport type PageUpsertInput = {\n  domain: string;\n  html: string;\n  template?: string;\n};\n\n/**\n * Resposta do endpoint de upsert\n */\ntype PageUpsertResponse = {\n  status: boolean;\n  code: string;\n};\n\n/**\n * PUT /pages/:domain\n *\n * Cria ou atualiza a página de uma loja.\n *\n * 🔒 Endpoint privado (somente backend)\n *\n * @param core - Instância do CoreClient (modo private)\n * @param input - Dados da página\n *\n * @returns `true` se operação foi bem-sucedida\n *\n * @throws Error se usado no navegador ou se a API retornar erro\n */\nexport async function upsertPage(\n  core: CoreClient,\n  input: PageUpsertInput,\n): Promise<boolean> {\n  if (!core.isPrivate()) {\n    throw new Error(\"Método privado disponível apenas no backend.\");\n  }\n\n  const { data } = await core.http.put<PageUpsertResponse>(\n    `/pages/${input.domain}`,\n    {\n      html: input.html,\n      template: input.template,\n    },\n  );\n\n  return data.status;\n}\n","import type { CoreClient } from \"../../client\";\nimport { deletePage } from \"./http/delete\";\nimport { getPage } from \"./http/get\";\nimport { upsertPage } from \"./http/upsert\";\n\n/**\n * Representa uma página\n */\nexport type Page = {\n  domain: string;\n  html: string;\n  template?: string;\n};\n\nexport class Pages {\n  constructor(private core: CoreClient) {}\n\n  get(domain: string) {\n    return getPage(this.core, domain);\n  }\n\n  upsert(input: { domain: string; html: string; template?: string }) {\n    return upsertPage(this.core, input);\n  }\n\n  delete(domain: string) {\n    return deletePage(this.core, domain);\n  }\n}\n"],"mappings":"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","names":["axios"]}

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+import { AxiosInstance as AxiosInstance$1 } from 'axios';
+
+/**
+ * Configurações para criação da instância Axios.
+ */
+type AxiosConfig = {
+    /**
+     * URL base da API.
+     * @default "https://api.cabrapi.com.br"
+     */
+    baseURL?: string;
+    /**
+     * Chave da API (modo privado).
+     */
+    apiKey?: string;
+};
+/**
+ * Cria uma instância HTTP configurada para a caBRAPI.
+ */
+declare function createAxios(config?: AxiosConfig): AxiosInstance$1;
+
+/**
+ * Tipo derivado da instância do Axios
+ * (evita problemas no build de types)
+ */
+type AxiosInstance = ReturnType<typeof createAxios>;
+/**
+ * Modos disponíveis
+ */
+type ClientMode = "public" | "private";
+/**
+ * Opções do cliente
+ */
+type ClientOptions = {
+    type: ClientMode;
+    config?: {
+        key?: string;
+    };
+};
+/**
+ * Cliente base da caBRAPI
+ */
+declare class CoreClient {
+    http: AxiosInstance;
+    mode: ClientMode;
+    isBrowser: boolean;
+    constructor(options: ClientOptions);
+    /**
+     * Está em modo privado (backend)
+     */
+    isPrivate(): boolean;
+    /**
+     * Está em modo público
+     */
+    isPublic(): boolean;
+    /**
+     * Garante execução no backend
+     */
+    assertPrivate(): void;
+}
+
+/**
+ * Representa a página retornada pela API
+ */
+type Page = {
+    html: string;
+    template?: string;
+    version?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    store?: {
+        ownerId: string;
+    };
+};
+
+declare class Pages {
+    private core;
+    constructor(core: CoreClient);
+    get(domain: string): Promise<Page>;
+    upsert(input: {
+        domain: string;
+        html: string;
+        template?: string;
+    }): Promise<boolean>;
+    delete(domain: string): Promise<boolean>;
+}
+
+/**
+ * SDK principal da caBRAPI
+ */
+declare class caBRAPI {
+    pages: Pages;
+    constructor(options: ClientOptions);
+}
+
+export { caBRAPI };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { AxiosInstance as AxiosInstance$1 } from 'axios';
+
+/**
+ * Configurações para criação da instância Axios.
+ */
+type AxiosConfig = {
+    /**
+     * URL base da API.
+     * @default "https://api.cabrapi.com.br"
+     */
+    baseURL?: string;
+    /**
+     * Chave da API (modo privado).
+     */
+    apiKey?: string;
+};
+/**
+ * Cria uma instância HTTP configurada para a caBRAPI.
+ */
+declare function createAxios(config?: AxiosConfig): AxiosInstance$1;
+
+/**
+ * Tipo derivado da instância do Axios
+ * (evita problemas no build de types)
+ */
+type AxiosInstance = ReturnType<typeof createAxios>;
+/**
+ * Modos disponíveis
+ */
+type ClientMode = "public" | "private";
+/**
+ * Opções do cliente
+ */
+type ClientOptions = {
+    type: ClientMode;
+    config?: {
+        key?: string;
+    };
+};
+/**
+ * Cliente base da caBRAPI
+ */
+declare class CoreClient {
+    http: AxiosInstance;
+    mode: ClientMode;
+    isBrowser: boolean;
+    constructor(options: ClientOptions);
+    /**
+     * Está em modo privado (backend)
+     */
+    isPrivate(): boolean;
+    /**
+     * Está em modo público
+     */
+    isPublic(): boolean;
+    /**
+     * Garante execução no backend
+     */
+    assertPrivate(): void;
+}
+
+/**
+ * Representa a página retornada pela API
+ */
+type Page = {
+    html: string;
+    template?: string;
+    version?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    store?: {
+        ownerId: string;
+    };
+};
+
+declare class Pages {
+    private core;
+    constructor(core: CoreClient);
+    get(domain: string): Promise<Page>;
+    upsert(input: {
+        domain: string;
+        html: string;
+        template?: string;
+    }): Promise<boolean>;
+    delete(domain: string): Promise<boolean>;
+}
+
+/**
+ * SDK principal da caBRAPI
+ */
+declare class caBRAPI {
+    pages: Pages;
+    constructor(options: ClientOptions);
+}
+
+export { caBRAPI };

package/dist/index.js

@@ -0,0 +1,148 @@
+// src/core/http.ts
+import axios from "axios";
+function createAxios(config = {}) {
+  const instance = axios.create({
+    baseURL: config.baseURL ?? "https://api.cabrapi.com.br",
+    timeout: 3e4,
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use((req) => {
+    const r = req ?? {};
+    if (config.apiKey) {
+      if (!r.headers) r.headers = {};
+      const headers = r.headers;
+      headers.Authorization = `Bearer ${config.apiKey}`;
+    }
+    return r;
+  });
+  instance.interceptors.response.use(
+    (res) => res,
+    (err) => {
+      let message = "Unknown error";
+      if (err && typeof err === "object") {
+        const ae = err;
+        if (typeof ae.message === "string") {
+          message = ae.message;
+        }
+        if (ae.response && typeof ae.response === "object") {
+          const data = ae.response.data;
+          if (data && typeof data === "object") {
+            const d = data;
+            const maybeMsg = d.message ?? d.code;
+            if (typeof maybeMsg === "string") message = maybeMsg;
+          }
+        }
+      } else if (typeof err === "string") {
+        message = err;
+      }
+      return Promise.reject(new Error(message));
+    }
+  );
+  return instance;
+}
+
+// src/core/client.ts
+var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+var CoreClient = class {
+  constructor(options) {
+    this.mode = options.type;
+    this.isBrowser = isBrowser;
+    if (this.mode === "private" && !options.config?.key && !this.isBrowser) {
+      throw new Error("API key \xE9 obrigat\xF3ria no modo 'private'.");
+    }
+    const apiKey = !this.isBrowser && this.mode === "private" ? options.config?.key : void 0;
+    this.http = createAxios({ apiKey });
+    if (this.isBrowser && this.mode === "private") {
+      console.warn(
+        "[caBRAPI] Modo 'private' detectado no navegador. API key ignorada."
+      );
+    }
+  }
+  /**
+   * Está em modo privado (backend)
+   */
+  isPrivate() {
+    return !this.isBrowser && this.mode === "private";
+  }
+  /**
+   * Está em modo público
+   */
+  isPublic() {
+    return this.isBrowser || this.mode === "public";
+  }
+  /**
+   * Garante execução no backend
+   */
+  assertPrivate() {
+    if (!this.isPrivate()) {
+      throw new Error(
+        "Este m\xE9todo \xE9 privado e n\xE3o pode ser usado no navegador."
+      );
+    }
+  }
+};
+
+// src/core/module/pages/http/delete.ts
+async function deletePage(core, domain) {
+  if (!core.isPrivate()) {
+    throw new Error("M\xE9todo privado dispon\xEDvel apenas no backend.");
+  }
+  const { data } = await core.http.delete(
+    `/pages/${domain}`
+  );
+  return data.status;
+}
+
+// src/core/module/pages/http/get.ts
+async function getPage(core, domain) {
+  const { data } = await core.http.get(`/pages/${domain}`);
+  if (!data?.data) {
+    throw new Error(`Page not found: ${domain}`);
+  }
+  return data.data;
+}
+
+// src/core/module/pages/http/upsert.ts
+async function upsertPage(core, input) {
+  if (!core.isPrivate()) {
+    throw new Error("M\xE9todo privado dispon\xEDvel apenas no backend.");
+  }
+  const { data } = await core.http.put(
+    `/pages/${input.domain}`,
+    {
+      html: input.html,
+      template: input.template
+    }
+  );
+  return data.status;
+}
+
+// src/core/module/pages/index.ts
+var Pages = class {
+  constructor(core) {
+    this.core = core;
+  }
+  get(domain) {
+    return getPage(this.core, domain);
+  }
+  upsert(input) {
+    return upsertPage(this.core, input);
+  }
+  delete(domain) {
+    return deletePage(this.core, domain);
+  }
+};
+
+// src/index.ts
+var caBRAPI = class {
+  constructor(options) {
+    const core = new CoreClient(options);
+    this.pages = new Pages(core);
+  }
+};
+export {
+  caBRAPI
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/http.ts","../src/core/client.ts","../src/core/module/pages/http/delete.ts","../src/core/module/pages/http/get.ts","../src/core/module/pages/http/upsert.ts","../src/core/module/pages/index.ts","../src/index.ts"],"sourcesContent":["import axios, {\n  type AxiosInstance,\n  type AxiosRequestConfig,\n  type AxiosResponse,\n} from \"axios\";\n\n/**\n * Configurações para criação da instância Axios.\n */\nexport type AxiosConfig = {\n  /**\n   * URL base da API.\n   * @default \"https://api.cabrapi.com.br\"\n   */\n  baseURL?: string;\n\n  /**\n   * Chave da API (modo privado).\n   */\n  apiKey?: string;\n};\n\n/**\n * Cria uma instância HTTP configurada para a caBRAPI.\n */\nexport function createAxios(config: AxiosConfig = {}): AxiosInstance {\n  const instance = axios.create({\n    baseURL: config.baseURL ?? \"https://api.cabrapi.com.br\",\n    timeout: 30000,\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  // 🔐 Request interceptor\n  instance.interceptors.request.use((req?: AxiosRequestConfig) => {\n    const r: AxiosRequestConfig = req ?? {};\n    if (config.apiKey) {\n      if (!r.headers) r.headers = {};\n      const headers = r.headers as Record<string, string | number | boolean>;\n      headers.Authorization = `Bearer ${config.apiKey}`;\n    }\n    return r;\n  });\n\n  // ⚠️ Response interceptor\n  instance.interceptors.response.use(\n    (res: AxiosResponse) => res,\n    (err: unknown) => {\n      let message = \"Unknown error\";\n\n      type MaybeAxiosLike = {\n        message?: unknown;\n        response?: { data?: unknown };\n      };\n      if (err && typeof err === \"object\") {\n        const ae = err as MaybeAxiosLike;\n        if (typeof ae.message === \"string\") {\n          message = ae.message;\n        }\n\n        if (ae.response && typeof ae.response === \"object\") {\n          const data = ae.response.data;\n          if (data && typeof data === \"object\") {\n            const d = data as Record<string, unknown>;\n            const maybeMsg = d.message ?? d.code;\n            if (typeof maybeMsg === \"string\") message = maybeMsg;\n          }\n        }\n      } else if (typeof err === \"string\") {\n        message = err;\n      }\n\n      return Promise.reject(new Error(message));\n    },\n  );\n\n  return instance;\n}\n","import { createAxios } from \"./http\";\n\n/**\n * Tipo derivado da instância do Axios\n * (evita problemas no build de types)\n */\ntype AxiosInstance = ReturnType<typeof createAxios>;\n\n/**\n * Modos disponíveis\n */\nexport type ClientMode = \"public\" | \"private\";\n\n/**\n * Opções do cliente\n */\nexport type ClientOptions = {\n  type: ClientMode;\n  config?: {\n    key?: string;\n  };\n};\n\n/**\n * Detecta ambiente\n */\nconst isBrowser =\n  typeof window !== \"undefined\" && typeof document !== \"undefined\";\n\n/**\n * Cliente base da caBRAPI\n */\nexport class CoreClient {\n  public http: AxiosInstance;\n  public mode: ClientMode;\n  public isBrowser: boolean;\n\n  constructor(options: ClientOptions) {\n    this.mode = options.type;\n    this.isBrowser = isBrowser;\n\n    // 🔒 validação backend\n    if (this.mode === \"private\" && !options.config?.key && !this.isBrowser) {\n      throw new Error(\"API key é obrigatória no modo 'private'.\");\n    }\n\n    // 🔐 só backend usa key\n    const apiKey =\n      !this.isBrowser && this.mode === \"private\"\n        ? options.config?.key\n        : undefined;\n\n    this.http = createAxios({ apiKey });\n\n    // ⚠️ aviso dev\n    if (this.isBrowser && this.mode === \"private\") {\n      console.warn(\n        \"[caBRAPI] Modo 'private' detectado no navegador. API key ignorada.\",\n      );\n    }\n  }\n\n  /**\n   * Está em modo privado (backend)\n   */\n  public isPrivate(): boolean {\n    return !this.isBrowser && this.mode === \"private\";\n  }\n\n  /**\n   * Está em modo público\n   */\n  public isPublic(): boolean {\n    return this.isBrowser || this.mode === \"public\";\n  }\n\n  /**\n   * Garante execução no backend\n   */\n  public assertPrivate(): void {\n    if (!this.isPrivate()) {\n      throw new Error(\n        \"Este método é privado e não pode ser usado no navegador.\",\n      );\n    }\n  }\n}\n","import type { CoreClient } from \"../../../client\";\n\n/**\n * Resposta do endpoint de exclusão de página\n */\ntype DeletePageResponse = {\n  status: boolean;\n  code: string;\n};\n\n/**\n * DELETE /pages/:domain\n *\n * Remove a página publicada de uma loja pelo domínio.\n *\n * 🔒 Endpoint privado (somente backend)\n *\n * @param core - Instância do CoreClient (modo private)\n * @param domain - Domínio da página (ex: \"minhaloja.com.br\")\n *\n * @returns `true` se a exclusão foi bem-sucedida\n *\n * @throws Error se usado no navegador ou se a API retornar erro\n */\nexport async function deletePage(\n  core: CoreClient,\n  domain: string,\n): Promise<boolean> {\n  if (!core.isPrivate()) {\n    throw new Error(\"Método privado disponível apenas no backend.\");\n  }\n\n  const { data } = await core.http.delete<DeletePageResponse>(\n    `/pages/${domain}`,\n  );\n\n  return data.status;\n}\n","import type { CoreClient } from \"../../../client\";\n\n/**\n * Representa a página retornada pela API\n */\nexport type Page = {\n  html: string;\n  template?: string;\n  version?: string;\n  createdAt?: string;\n  updatedAt?: string;\n  store?: {\n    ownerId: string;\n  };\n};\n\n/**\n * Estrutura padrão da resposta da API\n */\ntype PageResponse = {\n  status: boolean;\n  data: Page;\n};\n\n/**\n * GET /pages/:domain\n *\n * Busca a página pública de uma loja pelo domínio.\n *\n * 🔓 Endpoint público (pode ser usado no navegador ou backend)\n *\n * @param core - Instância do CoreClient já configurada\n * @param domain - Domínio da loja (ex: \"minhaloja.com.br\")\n *\n * @returns Dados da página renderizada (HTML + metadados)\n *\n * @throws Error quando a página não existe ou a API retorna erro\n */\nexport async function getPage(core: CoreClient, domain: string): Promise<Page> {\n  const { data } = await core.http.get<PageResponse>(`/pages/${domain}`);\n\n  if (!data?.data) {\n    throw new Error(`Page not found: ${domain}`);\n  }\n\n  return data.data;\n}\n","import type { CoreClient } from \"../../../client\";\n\nexport type PageUpsertInput = {\n  domain: string;\n  html: string;\n  template?: string;\n};\n\n/**\n * Resposta do endpoint de upsert\n */\ntype PageUpsertResponse = {\n  status: boolean;\n  code: string;\n};\n\n/**\n * PUT /pages/:domain\n *\n * Cria ou atualiza a página de uma loja.\n *\n * 🔒 Endpoint privado (somente backend)\n *\n * @param core - Instância do CoreClient (modo private)\n * @param input - Dados da página\n *\n * @returns `true` se operação foi bem-sucedida\n *\n * @throws Error se usado no navegador ou se a API retornar erro\n */\nexport async function upsertPage(\n  core: CoreClient,\n  input: PageUpsertInput,\n): Promise<boolean> {\n  if (!core.isPrivate()) {\n    throw new Error(\"Método privado disponível apenas no backend.\");\n  }\n\n  const { data } = await core.http.put<PageUpsertResponse>(\n    `/pages/${input.domain}`,\n    {\n      html: input.html,\n      template: input.template,\n    },\n  );\n\n  return data.status;\n}\n","import type { CoreClient } from \"../../client\";\nimport { deletePage } from \"./http/delete\";\nimport { getPage } from \"./http/get\";\nimport { upsertPage } from \"./http/upsert\";\n\n/**\n * Representa uma página\n */\nexport type Page = {\n  domain: string;\n  html: string;\n  template?: string;\n};\n\nexport class Pages {\n  constructor(private core: CoreClient) {}\n\n  get(domain: string) {\n    return getPage(this.core, domain);\n  }\n\n  upsert(input: { domain: string; html: string; template?: string }) {\n    return upsertPage(this.core, input);\n  }\n\n  delete(domain: string) {\n    return deletePage(this.core, domain);\n  }\n}\n","import { type ClientOptions, CoreClient } from \"./core/client\";\nimport { Pages } from \"./core/module/pages/index\";\n\n/**\n * SDK principal da caBRAPI\n */\nexport class caBRAPI {\n  public pages: Pages;\n\n  constructor(options: ClientOptions) {\n    const core = new CoreClient(options);\n\n    this.pages = new Pages(core);\n  }\n}\n"],"mappings":";AAAA,OAAO,WAIA;AAqBA,SAAS,YAAY,SAAsB,CAAC,GAAkB;AACnE,QAAM,WAAW,MAAM,OAAO;AAAA,IAC5B,SAAS,OAAO,WAAW;AAAA,IAC3B,SAAS;AAAA,IACT,SAAS;AAAA,MACP,gBAAgB;AAAA,IAClB;AAAA,EACF,CAAC;AAGD,WAAS,aAAa,QAAQ,IAAI,CAAC,QAA6B;AAC9D,UAAM,IAAwB,OAAO,CAAC;AACtC,QAAI,OAAO,QAAQ;AACjB,UAAI,CAAC,EAAE,QAAS,GAAE,UAAU,CAAC;AAC7B,YAAM,UAAU,EAAE;AAClB,cAAQ,gBAAgB,UAAU,OAAO,MAAM;AAAA,IACjD;AACA,WAAO;AAAA,EACT,CAAC;AAGD,WAAS,aAAa,SAAS;AAAA,IAC7B,CAAC,QAAuB;AAAA,IACxB,CAAC,QAAiB;AAChB,UAAI,UAAU;AAMd,UAAI,OAAO,OAAO,QAAQ,UAAU;AAClC,cAAM,KAAK;AACX,YAAI,OAAO,GAAG,YAAY,UAAU;AAClC,oBAAU,GAAG;AAAA,QACf;AAEA,YAAI,GAAG,YAAY,OAAO,GAAG,aAAa,UAAU;AAClD,gBAAM,OAAO,GAAG,SAAS;AACzB,cAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,kBAAM,IAAI;AACV,kBAAM,WAAW,EAAE,WAAW,EAAE;AAChC,gBAAI,OAAO,aAAa,SAAU,WAAU;AAAA,UAC9C;AAAA,QACF;AAAA,MACF,WAAW,OAAO,QAAQ,UAAU;AAClC,kBAAU;AAAA,MACZ;AAEA,aAAO,QAAQ,OAAO,IAAI,MAAM,OAAO,CAAC;AAAA,IAC1C;AAAA,EACF;AAEA,SAAO;AACT;;;ACpDA,IAAM,YACJ,OAAO,WAAW,eAAe,OAAO,aAAa;AAKhD,IAAM,aAAN,MAAiB;AAAA,EAKtB,YAAY,SAAwB;AAClC,SAAK,OAAO,QAAQ;AACpB,SAAK,YAAY;AAGjB,QAAI,KAAK,SAAS,aAAa,CAAC,QAAQ,QAAQ,OAAO,CAAC,KAAK,WAAW;AACtE,YAAM,IAAI,MAAM,gDAA0C;AAAA,IAC5D;AAGA,UAAM,SACJ,CAAC,KAAK,aAAa,KAAK,SAAS,YAC7B,QAAQ,QAAQ,MAChB;AAEN,SAAK,OAAO,YAAY,EAAE,OAAO,CAAC;AAGlC,QAAI,KAAK,aAAa,KAAK,SAAS,WAAW;AAC7C,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,YAAqB;AAC1B,WAAO,CAAC,KAAK,aAAa,KAAK,SAAS;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKO,WAAoB;AACzB,WAAO,KAAK,aAAa,KAAK,SAAS;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKO,gBAAsB;AAC3B,QAAI,CAAC,KAAK,UAAU,GAAG;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;AC9DA,eAAsB,WACpB,MACA,QACkB;AAClB,MAAI,CAAC,KAAK,UAAU,GAAG;AACrB,UAAM,IAAI,MAAM,oDAA8C;AAAA,EAChE;AAEA,QAAM,EAAE,KAAK,IAAI,MAAM,KAAK,KAAK;AAAA,IAC/B,UAAU,MAAM;AAAA,EAClB;AAEA,SAAO,KAAK;AACd;;;ACCA,eAAsB,QAAQ,MAAkB,QAA+B;AAC7E,QAAM,EAAE,KAAK,IAAI,MAAM,KAAK,KAAK,IAAkB,UAAU,MAAM,EAAE;AAErE,MAAI,CAAC,MAAM,MAAM;AACf,UAAM,IAAI,MAAM,mBAAmB,MAAM,EAAE;AAAA,EAC7C;AAEA,SAAO,KAAK;AACd;;;AChBA,eAAsB,WACpB,MACA,OACkB;AAClB,MAAI,CAAC,KAAK,UAAU,GAAG;AACrB,UAAM,IAAI,MAAM,oDAA8C;AAAA,EAChE;AAEA,QAAM,EAAE,KAAK,IAAI,MAAM,KAAK,KAAK;AAAA,IAC/B,UAAU,MAAM,MAAM;AAAA,IACtB;AAAA,MACE,MAAM,MAAM;AAAA,MACZ,UAAU,MAAM;AAAA,IAClB;AAAA,EACF;AAEA,SAAO,KAAK;AACd;;;ACjCO,IAAM,QAAN,MAAY;AAAA,EACjB,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAEvC,IAAI,QAAgB;AAClB,WAAO,QAAQ,KAAK,MAAM,MAAM;AAAA,EAClC;AAAA,EAEA,OAAO,OAA4D;AACjE,WAAO,WAAW,KAAK,MAAM,KAAK;AAAA,EACpC;AAAA,EAEA,OAAO,QAAgB;AACrB,WAAO,WAAW,KAAK,MAAM,MAAM;AAAA,EACrC;AACF;;;ACtBO,IAAM,UAAN,MAAc;AAAA,EAGnB,YAAY,SAAwB;AAClC,UAAM,OAAO,IAAI,WAAW,OAAO;AAEnC,SAAK,QAAQ,IAAI,MAAM,IAAI;AAAA,EAC7B;AACF;","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@cabrapi/sdk",
+  "version": "1.0.0-alpha.0",
+  "description": "SDK oficial da caBRAPI para Node.js e Browser",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check": "npx @biomejs/biome check --write",
+    "prepublishOnly": "npm run build",
+    "lint": "npx @biomejs/biome lint --write",
+    "format": "npx @biomejs/biome format --write"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}