@customyai/customy-sdk 0.1.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# @customyai/customy-sdk
+
+## 0.3.2
+
+### Patch Changes
+
+- Dependencias actualizadas:
+  - @customyai/customy-access@0.8.2
+  - @customyai/sdk@0.1.1
+
+## 0.3.1
+
+### Patch Changes
+
+- Dependencias actualizadas:
+  - @customyai/customy-access@0.8.1
+
+## 0.3.0
+
+### Minor Changes
+
+- En desuso: usa `@customyai/sdk`. `./server` toma ahora el discovery y los tokens de máquina de `@customyai/sdk` (y `@customyai/core`) y avisa una vez por proceso (`DeprecationWarning` `CUSTOMY_SDK_DEPRECATED`; `console.warn` fuera de Node); `createCustomy`, `token`, `product`, `send`, `links`, `data` y `billing` conservan su forma y sus mensajes de error (`CUSTOMY_DISCOVERY_FAILED: <estado>`, `CUSTOMY_MACHINE_TOKEN_FAILED: <estado> <motivo>`, con el error de `@customyai/core` en `cause`). `CustomyClient` y los clientes de cartera (`createCustomySdk`) no tienen equivalente en los paquetes nuevos y siguen igual, con el mismo aviso.
+
+### Patch Changes
+
+- `customy.send` recoge lo nuevo de `@customyai/send-sdk` para push: contenido rico, programación, cancelar/retirar, categorías, ajustes y preferencias por persona. Solo añade.
+- `customy.send` (en `@customyai/customy-sdk/server`) incluye las notificaciones de Customy Send: enviar con clave de idempotencia, dispositivos y credenciales de push nativo, bandeja e in-app. Solo añade: nada existente cambia.
+- Dependencias actualizadas:
+  - @customyai/customy-access@0.8.0
+  - @customyai/links-sdk@0.3.0
+  - @customyai/sdk@0.1.0
+  - @customyai/send-sdk@1.3.0
+
+## 0.2.0
+
+- `./server`: `createCustomy({ issuer, clientId, clientSecret })` discovers the
+  platform, keeps one machine token per audience and returns ready clients for
+  Send, Links, Data and Billing, plus a generic `product(key)`.
+
+## 0.1.0
+
+- Initial portfolio umbrella SDK with isolated clients for every Customy product
+  and platform service.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Customy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,7 @@
 # @customyai/customy-sdk
 
+> **Deprecated.** Use [`@customyai/sdk`](../sdk): `createCustomy({ issuer, clientId, clientSecret })` and `product(key)` keep their shape, and each product comes from its own package (`@customyai/send`, `@customyai/links`, `@customyai/data`, `@customyai/billing`, `@customyai/access`). This package stays for one major cycle as an adapter: `./server` takes discovery and machine tokens from `@customyai/sdk`; `CustomyClient` and the portfolio clients are unchanged. It warns once per process.
+
 Umbrella SDK for the Customy portfolio. It exposes one isolated client per
 product and platform service while keeping the base URL of each boundary
 explicit. It never guesses staging or production URLs.

package/dist/chunk-25MIDL7U.mjs

@@ -0,0 +1,198 @@
+// src/deprecation.ts
+var SEEN = /* @__PURE__ */ Symbol.for("customy.sdk.deprecations");
+function warnDeprecated(name, message) {
+  const registry = globalThis;
+  const seen = registry[SEEN] ??= /* @__PURE__ */ new Set();
+  if (seen.has(name)) return;
+  seen.add(name);
+  const text = `${name} is deprecated: ${message}`;
+  const proc = globalThis.process;
+  if (typeof proc?.emitWarning === "function") proc.emitWarning(text, { type: "DeprecationWarning", code: "CUSTOMY_SDK_DEPRECATED" });
+  else if (typeof console !== "undefined" && typeof console.warn === "function") console.warn(text);
+}
+
+// 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, allowLoopbackHttp = false) {
+  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");
+  }
+  const internalHttp = url.protocol === "http:" && /^customy-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(url.hostname) && (!url.port || /^[0-9]{1,5}$/.test(url.port));
+  const loopbackHttp = allowLoopbackHttp && url.protocol === "http:" && (url.hostname === "127.0.0.1" || url.hostname === "[::1]") && (!url.port || /^[0-9]{1,5}$/.test(url.port));
+  if (!internalHttp && !loopbackHttp && 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;
+  let text;
+  try {
+    text = await response.text();
+  } catch {
+    throw new Error("SDK_RESPONSE_READ_FAILED");
+  }
+  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, Boolean(this.config.fetch));
+  }
+  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 {
+      if (this.config.accessToken && !headers.authorization) {
+        try {
+          headers.authorization = `Bearer ${await this.config.accessToken()}`;
+        } catch {
+          throw new CustomySdkError(this.product, 401, "SDK_ACCESS_TOKEN_UNAVAILABLE");
+        }
+      }
+      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");
+        if (error instanceof Error && error.message === "SDK_RESPONSE_READ_FAILED") throw new CustomySdkError(this.product, 503, "SDK_RESPONSE_READ_FAILED");
+        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) {
+    warnDeprecated("@customyai/customy-sdk", "use @customyai/sdk (createCustomy and product(key)).");
+    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, CustomyPortfolioSdk, CustomyProductClient, CustomySdkError, createCustomySdk, warnDeprecated };

package/dist/chunk-YYMC3WOQ.cjs

@@ -0,0 +1,206 @@
+'use strict';
+
+// src/deprecation.ts
+var SEEN = /* @__PURE__ */ Symbol.for("customy.sdk.deprecations");
+function warnDeprecated(name, message) {
+  const registry = globalThis;
+  const seen = registry[SEEN] ??= /* @__PURE__ */ new Set();
+  if (seen.has(name)) return;
+  seen.add(name);
+  const text = `${name} is deprecated: ${message}`;
+  const proc = globalThis.process;
+  if (typeof proc?.emitWarning === "function") proc.emitWarning(text, { type: "DeprecationWarning", code: "CUSTOMY_SDK_DEPRECATED" });
+  else if (typeof console !== "undefined" && typeof console.warn === "function") console.warn(text);
+}
+
+// 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, allowLoopbackHttp = false) {
+  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");
+  }
+  const internalHttp = url.protocol === "http:" && /^customy-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(url.hostname) && (!url.port || /^[0-9]{1,5}$/.test(url.port));
+  const loopbackHttp = allowLoopbackHttp && url.protocol === "http:" && (url.hostname === "127.0.0.1" || url.hostname === "[::1]") && (!url.port || /^[0-9]{1,5}$/.test(url.port));
+  if (!internalHttp && !loopbackHttp && 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;
+  let text;
+  try {
+    text = await response.text();
+  } catch {
+    throw new Error("SDK_RESPONSE_READ_FAILED");
+  }
+  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, Boolean(this.config.fetch));
+  }
+  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 {
+      if (this.config.accessToken && !headers.authorization) {
+        try {
+          headers.authorization = `Bearer ${await this.config.accessToken()}`;
+        } catch {
+          throw new CustomySdkError(this.product, 401, "SDK_ACCESS_TOKEN_UNAVAILABLE");
+        }
+      }
+      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");
+        if (error instanceof Error && error.message === "SDK_RESPONSE_READ_FAILED") throw new CustomySdkError(this.product, 503, "SDK_RESPONSE_READ_FAILED");
+        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) {
+    warnDeprecated("@customyai/customy-sdk", "use @customyai/sdk (createCustomy and product(key)).");
+    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);
+
+exports.CUSTOMY_PLATFORM_SERVICE_KEYS = CUSTOMY_PLATFORM_SERVICE_KEYS;
+exports.CUSTOMY_PRODUCT_KEYS = CUSTOMY_PRODUCT_KEYS;
+exports.CustomyPortfolioSdk = CustomyPortfolioSdk;
+exports.CustomyProductClient = CustomyProductClient;
+exports.CustomySdkError = CustomySdkError;
+exports.createCustomySdk = createCustomySdk;
+exports.warnDeprecated = warnDeprecated;