portal-aiatende-api 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# portal-aiatende-api
+
+Cliente TypeScript tipado para a API interna do Portal AI Atende (`portal.aiatende.com.br`).
+
+## Instalação
+
+```bash
+npm install portal-aiatende-api
+```
+
+## Uso
+
+```typescript
+import { PortalClient } from 'portal-aiatende-api';
+
+const portal = new PortalClient({
+  apiKey: process.env.AIATENDE_API_KEY!,
+});
+
+const client = await portal.clients.getByKommoSubdomain('meusubdominio');
+const client2 = await portal.clients.getByWazzupChannelId('channel-id');
+
+const context = await portal.knowledge.getInternalContext({
+  clientId: client!.id,
+  userQuery: embeddingVector, // number[]
+});
+```
+
+## Tratamento de erros
+
+```typescript
+import { PortalApiError } from 'portal-aiatende-api';
+
+try {
+  await portal.clients.getByKommoSubdomain('subdominio-invalido');
+} catch (err) {
+  if (err instanceof PortalApiError) {
+    console.log(err.status);
+    console.log(err.raw);
+  }
+}
+```
+
+## Escopo
+
+Cobre hoje apenas os endpoints consumidos pelo `atende360-assistant`:
+`GET /api/clients` (por `kommo_subdomain` ou `channelId`) e `POST /api/knowledge/internal/context`.
+Novos endpoints podem ser adicionados sob demanda, seguindo o mesmo padrão de recursos
+(`src/resources/<nome>/{index.ts,types.ts}`).

package/dist/index.d.mts

@@ -0,0 +1,251 @@
+import { AxiosInstance } from 'axios';
+
+interface PortalClientConfig {
+    /**
+     * Valor usado tanto no header `x-api-key` (endpoints de clients) quanto em
+     * `x-internal-token` (endpoints internos, ex: knowledge/internal). O Portal
+     * aceita o mesmo valor sob os dois nomes de header — o cliente já manda os dois.
+     */
+    apiKey: string;
+    /** @default "https://portal.aiatende.com.br" */
+    baseUrl?: string;
+}
+
+declare abstract class BaseResource {
+    protected client: AxiosInstance;
+    constructor(client: AxiosInstance);
+}
+
+interface Client {
+    id: number;
+    name: string;
+    email: string;
+    phone: string;
+    document: string;
+    type: 'individual' | 'company';
+    status: 'active' | 'onboarding' | 'churned' | 'suspended';
+    origin: string;
+    address: object;
+    modules_data: object;
+    calendarConfig: CalendarConfig;
+    startDate: Date;
+    predictedStartDate: Date;
+    deliveryDate: Date;
+    predictedDeliveryDate: Date;
+    kommoConfig: KommoConfig;
+    aiConfig: AiConfig;
+    wazzup: Wazzup;
+    createdAt: Date;
+    updatedAt: Date;
+    [key: string]: any;
+}
+interface BusinessHours {
+    monday?: string[];
+    tuesday?: string[];
+    wednesday?: string[];
+    thursday?: string[];
+    friday?: string[];
+    saturday?: string[];
+    sunday?: string[];
+}
+interface CalendarConfig {
+    defaultId?: string;
+    mappings?: Record<string, string>;
+    businessHours?: BusinessHours;
+}
+interface AiConfig {
+    id: string;
+    clientId: string;
+    name: string;
+    isActive: boolean;
+    model: string;
+    apiKey: string;
+    temperature: number;
+    topP: number;
+    maxTokens: number;
+    frequencyPenalty: number;
+    presencePenalty: number;
+    stopSequences: string[];
+    processingDelay: number;
+    enabled_tools?: {
+        name: string;
+        description: string;
+    }[];
+    vapi_api_key: string;
+    vapi_phone_id: string;
+    updatedAt: Date;
+    prompts: AiPrompt[];
+    nudgeSettings: NudgeSettings;
+    experiments?: AiExperimentConfig;
+    schedule?: AiActivationSchedule;
+    splitMessages?: boolean;
+    [key: string]: any;
+}
+interface AiExperimentCriteria {
+    utm_source?: string | null;
+    utm_campaign?: string | null;
+    utm_content?: string | null;
+    tag?: string | null;
+    channel?: string | null;
+    [key: string]: any;
+}
+interface AiExperimentVariant {
+    model?: string | null;
+    system_prompt_addon?: string | null;
+    temperature?: number | null;
+    topP?: number | null;
+    maxTokens?: number | null;
+    [key: string]: any;
+}
+interface AiExperiment {
+    id: string;
+    name: string;
+    status: 'active' | 'paused' | 'draft' | 'completed';
+    startDate?: string | Date | null;
+    endDate?: string | Date | null;
+    criteria?: AiExperimentCriteria;
+    variant_b: AiExperimentVariant;
+    split: number;
+    split_strategy: 'deterministic' | 'random';
+}
+interface AiExperimentConfig {
+    active_experiments: AiExperiment[];
+}
+interface NudgeSettings {
+    isActive: boolean;
+    intervals: number[];
+}
+interface AiPrompt {
+    id: string;
+    aiConfigId: string;
+    role: 'system' | 'user' | 'assistant' | 'policy' | 'rag_topics' | 'nudge';
+    content: string;
+    version: string;
+    isActive: boolean;
+    createdAt: Date;
+    [key: string]: any;
+}
+interface Wazzup {
+    token: string;
+    channels: WazzupChannel[];
+}
+interface WazzupChannel {
+    channelId: string;
+    transport: string;
+    plainId: string;
+    state: string;
+}
+interface LossReasonMapping {
+    id: number;
+    name: string;
+    ai_can_move: boolean;
+    ai_move_reason?: string;
+}
+interface StageMapping {
+    stage_id: number;
+    stage_name: string;
+    color: string;
+    sort: number;
+    ai_can_move: boolean;
+    ai_move_reason?: string;
+    loss_reasons?: LossReasonMapping[];
+}
+interface PipelineMapping {
+    pipeline_id: number;
+    pipeline_name: string;
+    sort?: number;
+    is_unsorted_on: boolean;
+    stages: StageMapping[];
+}
+interface KommoConfig {
+    id: string;
+    clientId: string;
+    assistant_bot_id: string;
+    subdomain: string;
+    accounts: KommoAccount[];
+    funnels_mapping?: PipelineMapping[];
+    [key: string]: any;
+}
+interface KommoAccount {
+    subdomain: string;
+    label: string;
+    [key: string]: any;
+}
+interface TimeRange {
+    from: string;
+    to: string;
+}
+interface DateException {
+    date: string;
+    label?: string;
+    activeRanges: TimeRange[];
+}
+interface AiActivationSchedule {
+    enabled: boolean;
+    timezone: string;
+    weeklyHours: {
+        monday: TimeRange[];
+        tuesday: TimeRange[];
+        wednesday: TimeRange[];
+        thursday: TimeRange[];
+        friday: TimeRange[];
+        saturday: TimeRange[];
+        sunday: TimeRange[];
+        [key: string]: TimeRange[];
+    };
+    dateExceptions: DateException[];
+    offHoursMessage: string | null;
+    offHoursRepeat?: {
+        maxCount: number;
+        intervalMinutes: number;
+    } | null;
+    crmFunnel?: string | null;
+    crmStage?: string | null;
+}
+interface ClientsListResponse {
+    data: Client[];
+    meta?: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+
+declare class ClientsResource extends BaseResource {
+    /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
+    getByKommoSubdomain(subdomain: string): Promise<Client | null>;
+    /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
+    getByWazzupChannelId(channelId: string): Promise<Client | null>;
+}
+
+interface GetInternalContextParams {
+    clientId: number | string;
+    /** Embedding da mensagem do usuário (vetor numérico). */
+    userQuery: number[];
+}
+interface InternalContextResult {
+    found: boolean;
+    contextData?: string;
+}
+
+declare class KnowledgeResource extends BaseResource {
+    /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+    getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
+}
+
+declare class PortalClient {
+    config: PortalClientConfig;
+    httpClient: AxiosInstance;
+    clients: ClientsResource;
+    knowledge: KnowledgeResource;
+    constructor(config: PortalClientConfig);
+}
+
+declare class PortalApiError extends Error {
+    status?: number;
+    raw?: unknown;
+    constructor(message: string, info?: Partial<PortalApiError>);
+}
+
+export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };

package/dist/index.d.ts

@@ -0,0 +1,251 @@
+import { AxiosInstance } from 'axios';
+
+interface PortalClientConfig {
+    /**
+     * Valor usado tanto no header `x-api-key` (endpoints de clients) quanto em
+     * `x-internal-token` (endpoints internos, ex: knowledge/internal). O Portal
+     * aceita o mesmo valor sob os dois nomes de header — o cliente já manda os dois.
+     */
+    apiKey: string;
+    /** @default "https://portal.aiatende.com.br" */
+    baseUrl?: string;
+}
+
+declare abstract class BaseResource {
+    protected client: AxiosInstance;
+    constructor(client: AxiosInstance);
+}
+
+interface Client {
+    id: number;
+    name: string;
+    email: string;
+    phone: string;
+    document: string;
+    type: 'individual' | 'company';
+    status: 'active' | 'onboarding' | 'churned' | 'suspended';
+    origin: string;
+    address: object;
+    modules_data: object;
+    calendarConfig: CalendarConfig;
+    startDate: Date;
+    predictedStartDate: Date;
+    deliveryDate: Date;
+    predictedDeliveryDate: Date;
+    kommoConfig: KommoConfig;
+    aiConfig: AiConfig;
+    wazzup: Wazzup;
+    createdAt: Date;
+    updatedAt: Date;
+    [key: string]: any;
+}
+interface BusinessHours {
+    monday?: string[];
+    tuesday?: string[];
+    wednesday?: string[];
+    thursday?: string[];
+    friday?: string[];
+    saturday?: string[];
+    sunday?: string[];
+}
+interface CalendarConfig {
+    defaultId?: string;
+    mappings?: Record<string, string>;
+    businessHours?: BusinessHours;
+}
+interface AiConfig {
+    id: string;
+    clientId: string;
+    name: string;
+    isActive: boolean;
+    model: string;
+    apiKey: string;
+    temperature: number;
+    topP: number;
+    maxTokens: number;
+    frequencyPenalty: number;
+    presencePenalty: number;
+    stopSequences: string[];
+    processingDelay: number;
+    enabled_tools?: {
+        name: string;
+        description: string;
+    }[];
+    vapi_api_key: string;
+    vapi_phone_id: string;
+    updatedAt: Date;
+    prompts: AiPrompt[];
+    nudgeSettings: NudgeSettings;
+    experiments?: AiExperimentConfig;
+    schedule?: AiActivationSchedule;
+    splitMessages?: boolean;
+    [key: string]: any;
+}
+interface AiExperimentCriteria {
+    utm_source?: string | null;
+    utm_campaign?: string | null;
+    utm_content?: string | null;
+    tag?: string | null;
+    channel?: string | null;
+    [key: string]: any;
+}
+interface AiExperimentVariant {
+    model?: string | null;
+    system_prompt_addon?: string | null;
+    temperature?: number | null;
+    topP?: number | null;
+    maxTokens?: number | null;
+    [key: string]: any;
+}
+interface AiExperiment {
+    id: string;
+    name: string;
+    status: 'active' | 'paused' | 'draft' | 'completed';
+    startDate?: string | Date | null;
+    endDate?: string | Date | null;
+    criteria?: AiExperimentCriteria;
+    variant_b: AiExperimentVariant;
+    split: number;
+    split_strategy: 'deterministic' | 'random';
+}
+interface AiExperimentConfig {
+    active_experiments: AiExperiment[];
+}
+interface NudgeSettings {
+    isActive: boolean;
+    intervals: number[];
+}
+interface AiPrompt {
+    id: string;
+    aiConfigId: string;
+    role: 'system' | 'user' | 'assistant' | 'policy' | 'rag_topics' | 'nudge';
+    content: string;
+    version: string;
+    isActive: boolean;
+    createdAt: Date;
+    [key: string]: any;
+}
+interface Wazzup {
+    token: string;
+    channels: WazzupChannel[];
+}
+interface WazzupChannel {
+    channelId: string;
+    transport: string;
+    plainId: string;
+    state: string;
+}
+interface LossReasonMapping {
+    id: number;
+    name: string;
+    ai_can_move: boolean;
+    ai_move_reason?: string;
+}
+interface StageMapping {
+    stage_id: number;
+    stage_name: string;
+    color: string;
+    sort: number;
+    ai_can_move: boolean;
+    ai_move_reason?: string;
+    loss_reasons?: LossReasonMapping[];
+}
+interface PipelineMapping {
+    pipeline_id: number;
+    pipeline_name: string;
+    sort?: number;
+    is_unsorted_on: boolean;
+    stages: StageMapping[];
+}
+interface KommoConfig {
+    id: string;
+    clientId: string;
+    assistant_bot_id: string;
+    subdomain: string;
+    accounts: KommoAccount[];
+    funnels_mapping?: PipelineMapping[];
+    [key: string]: any;
+}
+interface KommoAccount {
+    subdomain: string;
+    label: string;
+    [key: string]: any;
+}
+interface TimeRange {
+    from: string;
+    to: string;
+}
+interface DateException {
+    date: string;
+    label?: string;
+    activeRanges: TimeRange[];
+}
+interface AiActivationSchedule {
+    enabled: boolean;
+    timezone: string;
+    weeklyHours: {
+        monday: TimeRange[];
+        tuesday: TimeRange[];
+        wednesday: TimeRange[];
+        thursday: TimeRange[];
+        friday: TimeRange[];
+        saturday: TimeRange[];
+        sunday: TimeRange[];
+        [key: string]: TimeRange[];
+    };
+    dateExceptions: DateException[];
+    offHoursMessage: string | null;
+    offHoursRepeat?: {
+        maxCount: number;
+        intervalMinutes: number;
+    } | null;
+    crmFunnel?: string | null;
+    crmStage?: string | null;
+}
+interface ClientsListResponse {
+    data: Client[];
+    meta?: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+
+declare class ClientsResource extends BaseResource {
+    /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
+    getByKommoSubdomain(subdomain: string): Promise<Client | null>;
+    /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
+    getByWazzupChannelId(channelId: string): Promise<Client | null>;
+}
+
+interface GetInternalContextParams {
+    clientId: number | string;
+    /** Embedding da mensagem do usuário (vetor numérico). */
+    userQuery: number[];
+}
+interface InternalContextResult {
+    found: boolean;
+    contextData?: string;
+}
+
+declare class KnowledgeResource extends BaseResource {
+    /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+    getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
+}
+
+declare class PortalClient {
+    config: PortalClientConfig;
+    httpClient: AxiosInstance;
+    clients: ClientsResource;
+    knowledge: KnowledgeResource;
+    constructor(config: PortalClientConfig);
+}
+
+declare class PortalApiError extends Error {
+    status?: number;
+    raw?: unknown;
+    constructor(message: string, info?: Partial<PortalApiError>);
+}
+
+export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, type Wazzup, type WazzupChannel };

package/dist/index.js

@@ -0,0 +1,136 @@
+"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, {
+  ClientsResource: () => ClientsResource,
+  KnowledgeResource: () => KnowledgeResource,
+  PortalApiError: () => PortalApiError,
+  PortalClient: () => PortalClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_axios = __toESM(require("axios"));
+
+// src/base.ts
+var BaseResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+};
+
+// src/resources/clients/index.ts
+var ClientsResource = class extends BaseResource {
+  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
+  async getByKommoSubdomain(subdomain) {
+    const response = await this.client.get("/api/clients", {
+      params: { kommo_subdomain: subdomain, includeConfigs: true }
+    });
+    return response.data.data[0] ?? null;
+  }
+  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
+  async getByWazzupChannelId(channelId) {
+    const response = await this.client.get("/api/clients", {
+      params: { channelId, includeConfigs: true }
+    });
+    return response.data.data[0] ?? null;
+  }
+};
+
+// src/resources/knowledge/index.ts
+var KnowledgeResource = class extends BaseResource {
+  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+  async getInternalContext(params) {
+    const response = await this.client.post("/api/knowledge/internal/context", {
+      clientId: params.clientId,
+      userQuery: params.userQuery
+    });
+    return response.data;
+  }
+};
+
+// src/errors.ts
+var PortalApiError = class extends Error {
+  status;
+  raw;
+  constructor(message, info) {
+    super(message);
+    this.name = "PortalApiError";
+    if (info) {
+      this.status = info.status;
+      this.raw = info.raw;
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://portal.aiatende.com.br";
+var PortalClient = class {
+  config;
+  httpClient;
+  clients;
+  knowledge;
+  constructor(config) {
+    this.config = config;
+    this.httpClient = import_axios.default.create({
+      baseURL: config.baseUrl || DEFAULT_BASE_URL,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": config.apiKey,
+        "x-internal-token": config.apiKey
+      }
+    });
+    this.httpClient.interceptors.response.use(
+      (response) => response,
+      (error) => {
+        if (error.response) {
+          const errData = error.response.data;
+          throw new PortalApiError(errData?.error || "Portal API Error", {
+            status: error.response.status,
+            raw: errData
+          });
+        }
+        throw error;
+      }
+    );
+    this.clients = new ClientsResource(this.httpClient);
+    this.knowledge = new KnowledgeResource(this.httpClient);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ClientsResource,
+  KnowledgeResource,
+  PortalApiError,
+  PortalClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["export * from './client';\nexport * from './types';\nexport * from './errors';\nexport * from './resources/clients';\nexport * from './resources/clients/types';\nexport * from './resources/knowledge';\nexport * from './resources/knowledge/types';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      clientId: params.clientId,\n      userQuery: params.userQuery\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAqC;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IACpB,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACZO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,aAAAA,QAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":["axios"]}

package/dist/index.mjs

@@ -0,0 +1,96 @@
+// src/client.ts
+import axios from "axios";
+
+// src/base.ts
+var BaseResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+};
+
+// src/resources/clients/index.ts
+var ClientsResource = class extends BaseResource {
+  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
+  async getByKommoSubdomain(subdomain) {
+    const response = await this.client.get("/api/clients", {
+      params: { kommo_subdomain: subdomain, includeConfigs: true }
+    });
+    return response.data.data[0] ?? null;
+  }
+  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
+  async getByWazzupChannelId(channelId) {
+    const response = await this.client.get("/api/clients", {
+      params: { channelId, includeConfigs: true }
+    });
+    return response.data.data[0] ?? null;
+  }
+};
+
+// src/resources/knowledge/index.ts
+var KnowledgeResource = class extends BaseResource {
+  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */
+  async getInternalContext(params) {
+    const response = await this.client.post("/api/knowledge/internal/context", {
+      clientId: params.clientId,
+      userQuery: params.userQuery
+    });
+    return response.data;
+  }
+};
+
+// src/errors.ts
+var PortalApiError = class extends Error {
+  status;
+  raw;
+  constructor(message, info) {
+    super(message);
+    this.name = "PortalApiError";
+    if (info) {
+      this.status = info.status;
+      this.raw = info.raw;
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://portal.aiatende.com.br";
+var PortalClient = class {
+  config;
+  httpClient;
+  clients;
+  knowledge;
+  constructor(config) {
+    this.config = config;
+    this.httpClient = axios.create({
+      baseURL: config.baseUrl || DEFAULT_BASE_URL,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": config.apiKey,
+        "x-internal-token": config.apiKey
+      }
+    });
+    this.httpClient.interceptors.response.use(
+      (response) => response,
+      (error) => {
+        if (error.response) {
+          const errData = error.response.data;
+          throw new PortalApiError(errData?.error || "Portal API Error", {
+            status: error.response.status,
+            raw: errData
+          });
+        }
+        throw error;
+      }
+    );
+    this.clients = new ClientsResource(this.httpClient);
+    this.knowledge = new KnowledgeResource(this.httpClient);
+  }
+};
+export {
+  ClientsResource,
+  KnowledgeResource,
+  PortalApiError,
+  PortalClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n}\n","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera contexto da base RAG do cliente para uma query já embeddada (`POST /api/knowledge/internal/context`). */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<InternalContextResult>('/api/knowledge/internal/context', {\n      clientId: params.clientId,\n      userQuery: params.userQuery\n    });\n    return response.data;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n"],"mappings":";AAAA,OAAO,WAA8B;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IACpB,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACZO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,MAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":[]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "portal-aiatende-api",
+  "version": "0.1.0",
+  "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "aiatende",
+    "portal",
+    "api",
+    "sdk",
+    "typescript"
+  ],
+  "author": "Douglas",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "axios": "^1.15.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.2"
+  }
+}