@customyai/customy-sdk 0.1.0

package/dist/index.mjs

@@ -0,0 +1,408 @@
+// src/client.ts
+var CustomyClient = class {
+  baseUrl;
+  apiKey;
+  timeout;
+  fetchFn;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 3e4;
+    this.fetchFn = config.fetch ?? globalThis.fetch;
+  }
+  // ─── HTTP Layer ─────────────────────────────────
+  async request(method, path, body, query) {
+    let url = `${this.baseUrl}${path}`;
+    if (query) {
+      const params = new URLSearchParams(
+        Object.entries(query).filter(([, v]) => v !== void 0)
+      );
+      if (params.toString()) url += `?${params.toString()}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await this.fetchFn(url, {
+        method,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const errorBody = await res.json().catch(() => ({}));
+        throw new CustomyAPIError(
+          res.status,
+          errorBody.error ?? res.statusText,
+          errorBody
+        );
+      }
+      return await res.json();
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ─── Tasks ──────────────────────────────────────
+  tasks = {
+    /** Parse a natural language prompt into a structured task */
+    createFromNaturalLanguage: (prompt) => this.request("POST", "/v2/tasks/natural", { prompt }),
+    /** Create a task with explicit parameters */
+    create: (options) => this.request("POST", "/v2/tasks", options),
+    /** Get a task by ID */
+    get: (id) => this.request("GET", `/v2/tasks/${id}`),
+    /** List tasks with pagination */
+    list: (options) => this.request(
+      "GET",
+      "/v2/tasks",
+      void 0,
+      {
+        page: String(options?.page ?? 1),
+        limit: String(options?.limit ?? 20),
+        ...options?.status ? { status: options.status } : {}
+      }
+    )
+  };
+  // ─── Templates ──────────────────────────────────
+  templates = {
+    /** List all available agent templates */
+    list: (options) => this.request(
+      "GET",
+      "/v2/templates",
+      void 0,
+      {
+        ...options?.vertical ? { vertical: options.vertical } : {},
+        ...options?.tag ? { tag: options.tag } : {}
+      }
+    ),
+    /** Get full template details */
+    get: (id) => this.request("GET", `/v2/templates/${id}`),
+    /** Instantiate a template into an agent config */
+    instantiate: (templateId, options) => this.request(
+      "POST",
+      `/v2/templates/${templateId}/instantiate`,
+      options
+    )
+  };
+  // ─── Marketplace ────────────────────────────────
+  marketplace = {
+    /** Browse marketplace listings */
+    browse: (options) => this.request("GET", "/v2/marketplace", void 0, {
+      ...options?.category ? { category: options.category } : {},
+      ...options?.tag ? { tag: options.tag } : {},
+      ...options?.sort ? { sort: options.sort } : {},
+      page: String(options?.page ?? 1),
+      limit: String(options?.limit ?? 20)
+    }),
+    /** Get listing details */
+    get: (id) => this.request("GET", `/v2/marketplace/${id}`),
+    /** Install a skill from the marketplace */
+    install: (listingId) => this.request(
+      "POST",
+      `/v2/marketplace/${listingId}/install`
+    ),
+    /** Submit a review */
+    review: (listingId, review) => this.request(
+      "POST",
+      `/v2/marketplace/${listingId}/review`,
+      review
+    ),
+    /** List installed skills */
+    installed: () => this.request(
+      "GET",
+      "/v2/marketplace/installed"
+    )
+  };
+  // ─── AI Triggers ────────────────────────────────
+  triggers = {
+    /** Create an AI-powered trigger */
+    createAI: (options) => this.request(
+      "POST",
+      "/v2/triggers/ai",
+      options
+    ),
+    /** Test an AI trigger evaluation */
+    evaluateAI: (options) => this.request(
+      "POST",
+      "/v2/triggers/ai/evaluate",
+      options
+    ),
+    /** List AI triggers */
+    listAI: () => this.request(
+      "GET",
+      "/v2/triggers/ai"
+    )
+  };
+  // ─── Browser Agent ──────────────────────────────
+  browser = {
+    sessions: {
+      /** List browser sessions */
+      list: (options) => this.request(
+        "GET",
+        "/v1/browser/sessions",
+        void 0,
+        options
+      ),
+      /** Get a specific session */
+      get: (sessionId) => this.request("GET", `/v1/browser/sessions/${sessionId}`),
+      /** Revoke a session manually */
+      revoke: (sessionId) => this.request(
+        "DELETE",
+        `/v1/browser/sessions/${sessionId}`
+      )
+    },
+    tasks: {
+      /** List browser tasks */
+      list: (options) => this.request(
+        "GET",
+        "/v1/browser/tasks",
+        void 0,
+        options
+      ),
+      /** Resume a task waiting for human input */
+      resume: (taskId, action) => this.request(
+        "POST",
+        `/v1/browser/tasks/${taskId}/resume`,
+        { action }
+      ),
+      /** Get tasks currently waiting for a human */
+      getWaiting: () => this.request("GET", "/v1/browser/tasks/waiting")
+    },
+    /**
+     * Helper: Executes a browser task and waits for its completion.
+     * Resolves when the task is 'completed', 'failed', 'cancelled', 'timeout', 
+     * or 'waiting_human' (meaning it needs intervention).
+     */
+    executeAndWait: async (taskId, pollIntervalMs = 2e3) => {
+      while (true) {
+        const res = await this.browser.tasks.list({ taskId });
+        const task = res.tasks[0];
+        if (!task) throw new Error(`Task ${taskId} not found`);
+        if (task.status === "completed" || task.status === "failed" || task.status === "cancelled" || task.status === "timeout" || task.status === "waiting_human") {
+          return task;
+        }
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+      }
+    }
+  };
+  // ─── Payments Namespace ─────────────────────────────────────
+  payments = {
+    /** Create a payment intent */
+    createIntent: (options) => this.request("POST", "/v1/payments/intents", options),
+    /** Get payment intent status */
+    getIntent: (intentId) => this.request("GET", `/v1/payments/intents/${intentId}`),
+    /** List payment intents */
+    listIntents: (query) => this.request("GET", "/v1/payments/intents", void 0, query)
+  };
+  // ─── Voice Namespace ────────────────────────────────────────
+  voice = {
+    /** Initiate an autonomous voice call */
+    initiateCall: (options) => this.request("POST", "/v1/voice/calls", options),
+    /** Get voice call details and transcript */
+    getCall: (callId) => this.request("GET", `/v1/voice/calls/${callId}`),
+    /** List voice calls */
+    listCalls: (query) => this.request("GET", "/v1/voice/calls", void 0, query)
+  };
+  // ─── CRM Namespace ──────────────────────────────────────────
+  crm = {
+    /** Create or upsert a contact */
+    createContact: (options) => this.request("POST", "/v1/crm/contacts", options),
+    /** Get contact details */
+    getContact: (contactId) => this.request("GET", `/v1/crm/contacts/${contactId}`),
+    /** List contacts */
+    listContacts: (query) => this.request("GET", "/v1/crm/contacts", void 0, query)
+  };
+  // ─── Events Namespace ───────────────────────────────────────
+  events = {
+    /** Publish an event to the Customy Event Backbone */
+    publish: (options) => this.request("POST", "/v1/events/publish", options)
+  };
+};
+var CustomyAPIError = class extends Error {
+  constructor(status, message, body) {
+    super(`Customy API Error (${status}): ${message}`);
+    this.status = status;
+    this.body = body;
+    this.name = "CustomyAPIError";
+  }
+  status;
+  body;
+};
+
+// src/portfolio.ts
+var CUSTOMY_PRODUCT_KEYS = [
+  "agent",
+  "ads",
+  "analytics",
+  "atlas",
+  "bookings",
+  "campaigns",
+  "commerce",
+  "content",
+  "crm",
+  "data",
+  "design",
+  "domains",
+  "engagement",
+  "flows",
+  "forms",
+  "links",
+  "mission-control",
+  "pages",
+  "payments",
+  "send",
+  "sitesight",
+  "support",
+  "tables",
+  "tasks",
+  "voice",
+  "whatsapp",
+  "work"
+];
+var CUSTOMY_PLATFORM_SERVICE_KEYS = [
+  "access",
+  "audit",
+  "billing",
+  "events",
+  "integrations",
+  "realtime",
+  "scheduler",
+  "storage"
+];
+var CustomySdkError = class extends Error {
+  constructor(product, status, code, body) {
+    super(`Customy ${product} SDK request failed (${status}): ${code}`);
+    this.product = product;
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    this.name = "CustomySdkError";
+  }
+  product;
+  status;
+  code;
+  body;
+};
+function normalizeBaseUrl(value, product) {
+  if (!value) throw new CustomySdkError(product, 0, "SDK_BASE_URL_REQUIRED");
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new CustomySdkError(product, 0, "SDK_BASE_URL_INVALID");
+  }
+  if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash)
+    throw new CustomySdkError(product, 0, "SDK_BASE_URL_INVALID");
+  return url.toString().replace(/\/$/, "");
+}
+function buildUrl(baseUrl, path, query, product) {
+  if (!path.startsWith("/") || path.startsWith("//") || path.includes("..")) throw new CustomySdkError(product, 0, "SDK_PATH_INVALID");
+  const url = new URL(path, `${baseUrl}/`);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    if (value === void 0 || value === null) continue;
+    if (Array.isArray(value)) for (const item of value) url.searchParams.append(key, String(item));
+    else url.searchParams.set(key, String(value));
+  }
+  return url;
+}
+async function readBody(response, maxBytes) {
+  if (response.status === 204) return null;
+  const text = await response.text();
+  if (new TextEncoder().encode(text).byteLength > maxBytes) throw new Error("SDK_RESPONSE_TOO_LARGE");
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+var CustomyProductClient = class {
+  product;
+  configuredBaseUrl;
+  config;
+  fetchImpl;
+  constructor(product, config) {
+    this.product = product;
+    this.config = config;
+    this.configuredBaseUrl = config.baseUrls?.[product] ?? config.baseUrl;
+    this.fetchImpl = config.fetch ?? globalThis.fetch;
+    if (!this.fetchImpl) throw new CustomySdkError(product, 0, "SDK_FETCH_REQUIRED");
+  }
+  get baseUrl() {
+    return normalizeBaseUrl(this.configuredBaseUrl, this.product);
+  }
+  async request(method, path, options = {}) {
+    const url = buildUrl(this.baseUrl, path, options.query, this.product);
+    const controller = new AbortController();
+    const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
+    const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? this.config.timeoutMs ?? 3e4);
+    const headers = { accept: "application/json", ...this.config.headers, ...options.headers };
+    if (options.body !== void 0) headers["content-type"] ??= "application/json";
+    if (this.config.apiKey || this.config.bearerToken) headers.authorization ??= `Bearer ${this.config.bearerToken ?? this.config.apiKey}`;
+    if (this.config.internalKey) headers["x-internal-key"] ??= this.config.internalKey;
+    try {
+      const response = await this.fetchImpl(url, { method, headers, body: options.body === void 0 ? void 0 : JSON.stringify(options.body), cache: "no-store", credentials: "omit", redirect: "error", signal });
+      let body;
+      try {
+        body = await readBody(response, options.maxBytes ?? 4 * 1024 * 1024);
+      } catch (error) {
+        if (error instanceof Error && error.message === "SDK_RESPONSE_TOO_LARGE") throw new CustomySdkError(this.product, 413, "SDK_RESPONSE_TOO_LARGE");
+        throw new CustomySdkError(this.product, 502, "SDK_RESPONSE_INVALID");
+      }
+      if (!response.ok) {
+        const code = body && typeof body === "object" && "code" in body && typeof body.code === "string" ? body.code : `HTTP_${response.status}`;
+        throw new CustomySdkError(this.product, response.status, code, body);
+      }
+      return body;
+    } catch (error) {
+      if (error instanceof CustomySdkError) throw error;
+      if (error instanceof DOMException && error.name === "AbortError") throw new CustomySdkError(this.product, 408, "SDK_TIMEOUT");
+      throw new CustomySdkError(this.product, 503, "SDK_UNAVAILABLE");
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  get(path, options) {
+    return this.request("GET", path, options);
+  }
+  post(path, body, options) {
+    return this.request("POST", path, { ...options, body });
+  }
+  put(path, body, options) {
+    return this.request("PUT", path, { ...options, body });
+  }
+  patch(path, body, options) {
+    return this.request("PATCH", path, { ...options, body });
+  }
+  delete(path, options) {
+    return this.request("DELETE", path, options);
+  }
+};
+var CustomyPortfolioSdk = class {
+  clients;
+  products;
+  platform;
+  constructor(config) {
+    const keys = [...CUSTOMY_PRODUCT_KEYS, ...CUSTOMY_PLATFORM_SERVICE_KEYS];
+    this.clients = Object.fromEntries(keys.map((key) => [key, new CustomyProductClient(key, config)]));
+    this.products = Object.fromEntries(CUSTOMY_PRODUCT_KEYS.map((key) => [key, this.clients[key]]));
+    this.platform = Object.fromEntries(CUSTOMY_PLATFORM_SERVICE_KEYS.map((key) => [key, this.clients[key]]));
+  }
+  product(key) {
+    return this.products[key];
+  }
+  service(key) {
+    return this.platform[key];
+  }
+};
+var createCustomySdk = (config) => new CustomyPortfolioSdk(config);
+export {
+  CUSTOMY_PLATFORM_SERVICE_KEYS,
+  CUSTOMY_PRODUCT_KEYS,
+  CustomyClient,
+  CustomyPortfolioSdk,
+  CustomyProductClient,
+  CustomySdkError,
+  createCustomySdk
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@customyai/customy-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript umbrella SDK for all Customy products and platform services",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "customy",
+    "ai",
+    "agent",
+    "sdk",
+    "api",
+    "client"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/customyco/customynew",
+    "directory": "packages/sdk"
+  },
+  "author": "Customy <hello@customy.ai>"
+}