@customyai/customy-sdk 0.2.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/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-2TLSPDBG.mjs → chunk-25MIDL7U.mjs}

@@ -1,3 +1,16 @@
+// 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",
@@ -167,6 +180,7 @@ var CustomyPortfolioSdk = class {
   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]]));
@@ -181,4 +195,4 @@ var CustomyPortfolioSdk = class {
 };
 var createCustomySdk = (config) => new CustomyPortfolioSdk(config);
 
-export { CUSTOMY_PLATFORM_SERVICE_KEYS, CUSTOMY_PRODUCT_KEYS, CustomyPortfolioSdk, CustomyProductClient, CustomySdkError, createCustomySdk };
+export { CUSTOMY_PLATFORM_SERVICE_KEYS, CUSTOMY_PRODUCT_KEYS, CustomyPortfolioSdk, CustomyProductClient, CustomySdkError, createCustomySdk, warnDeprecated };

package/dist/{chunk-CE5MONHF.cjs → chunk-YYMC3WOQ.cjs}

@@ -1,5 +1,18 @@
 '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",
@@ -169,6 +182,7 @@ var CustomyPortfolioSdk = class {
   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]]));
@@ -189,3 +203,4 @@ exports.CustomyPortfolioSdk = CustomyPortfolioSdk;
 exports.CustomyProductClient = CustomyProductClient;
 exports.CustomySdkError = CustomySdkError;
 exports.createCustomySdk = createCustomySdk;
+exports.warnDeprecated = warnDeprecated;

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkCE5MONHF_cjs = require('./chunk-CE5MONHF.cjs');
+var chunkYYMC3WOQ_cjs = require('./chunk-YYMC3WOQ.cjs');
 
 // src/client.ts
 var CustomyClient = class {
@@ -9,6 +9,7 @@ var CustomyClient = class {
   timeout;
   fetchFn;
   constructor(config) {
+    chunkYYMC3WOQ_cjs.warnDeprecated("@customyai/customy-sdk", "use @customyai/sdk (createCustomy and product(key)).");
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.apiKey = config.apiKey;
     this.timeout = config.timeout ?? 3e4;
@@ -236,26 +237,26 @@ var CustomyAPIError = class extends Error {
 
 Object.defineProperty(exports, "CUSTOMY_PLATFORM_SERVICE_KEYS", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.CUSTOMY_PLATFORM_SERVICE_KEYS; }
+  get: function () { return chunkYYMC3WOQ_cjs.CUSTOMY_PLATFORM_SERVICE_KEYS; }
 });
 Object.defineProperty(exports, "CUSTOMY_PRODUCT_KEYS", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.CUSTOMY_PRODUCT_KEYS; }
+  get: function () { return chunkYYMC3WOQ_cjs.CUSTOMY_PRODUCT_KEYS; }
 });
 Object.defineProperty(exports, "CustomyPortfolioSdk", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.CustomyPortfolioSdk; }
+  get: function () { return chunkYYMC3WOQ_cjs.CustomyPortfolioSdk; }
 });
 Object.defineProperty(exports, "CustomyProductClient", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.CustomyProductClient; }
+  get: function () { return chunkYYMC3WOQ_cjs.CustomyProductClient; }
 });
 Object.defineProperty(exports, "CustomySdkError", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.CustomySdkError; }
+  get: function () { return chunkYYMC3WOQ_cjs.CustomySdkError; }
 });
 Object.defineProperty(exports, "createCustomySdk", {
   enumerable: true,
-  get: function () { return chunkCE5MONHF_cjs.createCustomySdk; }
+  get: function () { return chunkYYMC3WOQ_cjs.createCustomySdk; }
 });
 exports.CustomyClient = CustomyClient;

package/dist/index.mjs

@@ -1,4 +1,5 @@
-export { CUSTOMY_PLATFORM_SERVICE_KEYS, CUSTOMY_PRODUCT_KEYS, CustomyPortfolioSdk, CustomyProductClient, CustomySdkError, createCustomySdk } from './chunk-2TLSPDBG.mjs';
+import { warnDeprecated } from './chunk-25MIDL7U.mjs';
+export { CUSTOMY_PLATFORM_SERVICE_KEYS, CUSTOMY_PRODUCT_KEYS, CustomyPortfolioSdk, CustomyProductClient, CustomySdkError, createCustomySdk } from './chunk-25MIDL7U.mjs';
 
 // src/client.ts
 var CustomyClient = class {
@@ -7,6 +8,7 @@ var CustomyClient = class {
   timeout;
   fetchFn;
   constructor(config) {
+    warnDeprecated("@customyai/customy-sdk", "use @customyai/sdk (createCustomy and product(key)).");
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.apiKey = config.apiKey;
     this.timeout = config.timeout ?? 3e4;

package/dist/server.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkCE5MONHF_cjs = require('./chunk-CE5MONHF.cjs');
-var server = require('@customyai/customy-access/server');
+var chunkYYMC3WOQ_cjs = require('./chunk-YYMC3WOQ.cjs');
+var sdk = require('@customyai/sdk');
 var sendSdk = require('@customyai/send-sdk');
 var linksSdk = require('@customyai/links-sdk');
 
@@ -363,30 +363,52 @@ var AppUsageClient = class {
     return body;
   }
 };
+function legacyPlatformError(error) {
+  if (!(error instanceof sdk.CustomySdkError)) return error;
+  const { code, status } = error;
+  let message = null;
+  if (code === "SDK_DISCOVERY_FAILED") message = status ? `CUSTOMY_DISCOVERY_FAILED: ${status}` : "CUSTOMY_DISCOVERY_FAILED";
+  else if (code === "SDK_DISCOVERY_INVALID") message = "CUSTOMY_DISCOVERY_INVALID";
+  else if (code === "SDK_ISSUER_INVALID") message = "CUSTOMY_ACCESS_ISSUER_INVALID";
+  else if (code.startsWith("SDK_MACHINE_TOKEN_") && status > 0) {
+    const reason = code === "SDK_MACHINE_TOKEN_FAILED" ? "" : code.slice("SDK_MACHINE_TOKEN_".length).toLowerCase();
+    message = `CUSTOMY_MACHINE_TOKEN_FAILED: ${status} ${reason}`.trim();
+  } else if (code === "SDK_MACHINE_TOKEN_FAILED") message = "CUSTOMY_MACHINE_TOKEN_FAILED";
+  else if (code.startsWith("SDK_MACHINE_")) message = `CUSTOMY_${code.slice(4)}`;
+  if (!message) return error;
+  const legacy = new Error(message);
+  legacy.cause = error;
+  return legacy;
+}
 
 // src/server.ts
 async function createCustomy(options) {
   if (!options.clientId || !options.clientSecret) throw new Error("CUSTOMY_MACHINE_CREDENTIALS_REQUIRED");
-  const fetchImpl = options.fetch ?? globalThis.fetch;
-  const platform = await server.discoverPlatform(options.issuer, fetchImpl);
-  const providers = /* @__PURE__ */ new Map();
+  chunkYYMC3WOQ_cjs.warnDeprecated("@customyai/customy-sdk", "use createCustomy from @customyai/sdk (same options; billing.report becomes billing.usage.report).");
+  const shared = await sdk.createCustomy({
+    issuer: options.issuer,
+    clientId: options.clientId,
+    clientSecret: options.clientSecret,
+    fetch: options.fetch,
+    scopes: options.scopes
+  }).catch((error) => {
+    throw legacyPlatformError(error);
+  });
+  const platform = shared.platform;
   const clients = /* @__PURE__ */ new Map();
   function entry(product) {
     const found = platform.products[product];
     if (!found) throw new Error(`CUSTOMY_PRODUCT_NOT_DISCOVERED: ${product}`);
     return found;
   }
+  const providers = /* @__PURE__ */ new Map();
   function token(product) {
+    entry(product);
     let provider = providers.get(product);
     if (!provider) {
-      provider = server.createMachineTokenProvider({
-        issuer: platform.issuer,
-        tokenEndpoint: platform.tokenEndpoint,
-        clientId: options.clientId,
-        clientSecret: options.clientSecret,
-        audience: entry(product).audience,
-        scopes: options.scopes?.[product],
-        fetch: fetchImpl
+      const source = shared.token(product);
+      provider = () => Promise.resolve().then(() => source()).catch((error) => {
+        throw legacyPlatformError(error);
       });
       providers.set(product, provider);
     }
@@ -400,8 +422,8 @@ async function createCustomy(options) {
     platform,
     token,
     product(product) {
-      if (!platform.products[product]) throw new chunkCE5MONHF_cjs.CustomySdkError(product, 0, "SDK_PRODUCT_NOT_DISCOVERED");
-      return once(`product:${product}`, () => new chunkCE5MONHF_cjs.CustomyProductClient(product, {
+      if (!platform.products[product]) throw new chunkYYMC3WOQ_cjs.CustomySdkError(product, 0, "SDK_PRODUCT_NOT_DISCOVERED");
+      return once(`product:${product}`, () => new chunkYYMC3WOQ_cjs.CustomyProductClient(product, {
         baseUrl: entry(product).baseUrl,
         accessToken: token(product),
         fetch: options.fetch,

package/dist/server.d.cts

@@ -124,11 +124,12 @@ declare class AppUsageClient {
 /**
  * @customyai/customy-sdk/server — `createCustomy()`: una sola identidad de app para todo el ecosistema.
  *
- * Lee el discovery del issuer (`/.well-known/customy-configuration`), crea un
- * proveedor de tokens de máquina por audiencia de producto y entrega los
- * clientes de cada producto ya apuntando a su URL y con su proveedor. No añade
- * transporte propio: compone los SDK de cada servicio. Solo para servidor —
- * usa el secreto de la app.
+ * @deprecated Usa `createCustomy` de `@customyai/sdk`: misma forma
+ * (`{ issuer, clientId, clientSecret }`, `token`, `product`), con los clientes
+ * de los paquetes nuevos. Este módulo es su adaptador durante un ciclo major:
+ * el discovery y los tokens de máquina son los de `@customyai/sdk` (y
+ * `@customyai/core`); `send`, `links`, `data` y `billing` conservan las clases
+ * de 0.x.
  *
  *   const customy = await createCustomy({ issuer, clientId, clientSecret });
  *   await customy.send.emails.send({ ... });

package/dist/server.d.ts

@@ -124,11 +124,12 @@ declare class AppUsageClient {
 /**
  * @customyai/customy-sdk/server — `createCustomy()`: una sola identidad de app para todo el ecosistema.
  *
- * Lee el discovery del issuer (`/.well-known/customy-configuration`), crea un
- * proveedor de tokens de máquina por audiencia de producto y entrega los
- * clientes de cada producto ya apuntando a su URL y con su proveedor. No añade
- * transporte propio: compone los SDK de cada servicio. Solo para servidor —
- * usa el secreto de la app.
+ * @deprecated Usa `createCustomy` de `@customyai/sdk`: misma forma
+ * (`{ issuer, clientId, clientSecret }`, `token`, `product`), con los clientes
+ * de los paquetes nuevos. Este módulo es su adaptador durante un ciclo major:
+ * el discovery y los tokens de máquina son los de `@customyai/sdk` (y
+ * `@customyai/core`); `send`, `links`, `data` y `billing` conservan las clases
+ * de 0.x.
  *
  *   const customy = await createCustomy({ issuer, clientId, clientSecret });
  *   await customy.send.emails.send({ ... });

package/dist/server.mjs

@@ -1,5 +1,5 @@
-import { CustomySdkError, CustomyProductClient } from './chunk-2TLSPDBG.mjs';
-import { discoverPlatform, createMachineTokenProvider } from '@customyai/customy-access/server';
+import { warnDeprecated, CustomySdkError, CustomyProductClient } from './chunk-25MIDL7U.mjs';
+import { createCustomy as createCustomy$1, CustomySdkError as CustomySdkError$1 } from '@customyai/sdk';
 import { CustomySend } from '@customyai/send-sdk';
 import { CustomyLinks } from '@customyai/links-sdk';
 
@@ -361,30 +361,52 @@ var AppUsageClient = class {
     return body;
   }
 };
+function legacyPlatformError(error) {
+  if (!(error instanceof CustomySdkError$1)) return error;
+  const { code, status } = error;
+  let message = null;
+  if (code === "SDK_DISCOVERY_FAILED") message = status ? `CUSTOMY_DISCOVERY_FAILED: ${status}` : "CUSTOMY_DISCOVERY_FAILED";
+  else if (code === "SDK_DISCOVERY_INVALID") message = "CUSTOMY_DISCOVERY_INVALID";
+  else if (code === "SDK_ISSUER_INVALID") message = "CUSTOMY_ACCESS_ISSUER_INVALID";
+  else if (code.startsWith("SDK_MACHINE_TOKEN_") && status > 0) {
+    const reason = code === "SDK_MACHINE_TOKEN_FAILED" ? "" : code.slice("SDK_MACHINE_TOKEN_".length).toLowerCase();
+    message = `CUSTOMY_MACHINE_TOKEN_FAILED: ${status} ${reason}`.trim();
+  } else if (code === "SDK_MACHINE_TOKEN_FAILED") message = "CUSTOMY_MACHINE_TOKEN_FAILED";
+  else if (code.startsWith("SDK_MACHINE_")) message = `CUSTOMY_${code.slice(4)}`;
+  if (!message) return error;
+  const legacy = new Error(message);
+  legacy.cause = error;
+  return legacy;
+}
 
 // src/server.ts
 async function createCustomy(options) {
   if (!options.clientId || !options.clientSecret) throw new Error("CUSTOMY_MACHINE_CREDENTIALS_REQUIRED");
-  const fetchImpl = options.fetch ?? globalThis.fetch;
-  const platform = await discoverPlatform(options.issuer, fetchImpl);
-  const providers = /* @__PURE__ */ new Map();
+  warnDeprecated("@customyai/customy-sdk", "use createCustomy from @customyai/sdk (same options; billing.report becomes billing.usage.report).");
+  const shared = await createCustomy$1({
+    issuer: options.issuer,
+    clientId: options.clientId,
+    clientSecret: options.clientSecret,
+    fetch: options.fetch,
+    scopes: options.scopes
+  }).catch((error) => {
+    throw legacyPlatformError(error);
+  });
+  const platform = shared.platform;
   const clients = /* @__PURE__ */ new Map();
   function entry(product) {
     const found = platform.products[product];
     if (!found) throw new Error(`CUSTOMY_PRODUCT_NOT_DISCOVERED: ${product}`);
     return found;
   }
+  const providers = /* @__PURE__ */ new Map();
   function token(product) {
+    entry(product);
     let provider = providers.get(product);
     if (!provider) {
-      provider = createMachineTokenProvider({
-        issuer: platform.issuer,
-        tokenEndpoint: platform.tokenEndpoint,
-        clientId: options.clientId,
-        clientSecret: options.clientSecret,
-        audience: entry(product).audience,
-        scopes: options.scopes?.[product],
-        fetch: fetchImpl
+      const source = shared.token(product);
+      provider = () => Promise.resolve().then(() => source()).catch((error) => {
+        throw legacyPlatformError(error);
       });
       providers.set(product, provider);
     }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@customyai/customy-sdk",
-  "version": "0.2.0",
-  "description": "TypeScript umbrella SDK for all Customy products and platform services",
+  "version": "0.3.2",
+  "description": "Deprecated: use @customyai/sdk. Adapter of the Customy umbrella SDK (createCustomy, portfolio clients) kept for one major cycle.",
   "license": "MIT",
   "author": "Customy <hello@customy.ai>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/customyco/customy-js.git",
-    "directory": "packages/sdk"
+    "directory": "packages/customy-sdk"
   },
   "bugs": {
     "url": "https://github.com/customyco/customy-js/issues"
@@ -57,7 +57,8 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"
@@ -68,9 +69,10 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@customyai/customy-access": "^0.6.0",
-    "@customyai/links-sdk": "^0.2.0",
-    "@customyai/send-sdk": "^1.1.0"
+    "@customyai/customy-access": "^0.8.2",
+    "@customyai/links-sdk": "^0.3.0",
+    "@customyai/sdk": "^0.1.1",
+    "@customyai/send-sdk": "^1.3.0"
   },
   "devDependencies": {
     "typescript": "^5.5.0",