veo-sdk 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -33,8 +33,6 @@ interface VeoAutocaptureConfig {
 interface VeoConfig {
     /** API key pública del workspace (formato pk_xxx). */
     apiKey: string;
-    /** URL base del backend de Veo. */
-    apiUrl: string;
     /** Intervalo en ms para flush automático de la queue. Default: 5000. */
     flushInterval?: number;
     /** Tamaño máximo del batch antes de flush. Default: 20. */
@@ -243,10 +241,8 @@ declare function spaRouterPlugin(): VeoPlugin;
  * ```ts
  * import { init } from '@veo/sdk';
  *
- * const veo = init({
- *   apiKey: 'pk_xxx',
- *   apiUrl: 'https://api.veo.io'
- * });
+ * // apiUrl es opcional: por defecto apunta al backend gestionado de Veo.
+ * const veo = init({ apiKey: 'pk_xxx' });
  *
  * veo.identify({ visitor: { id: 'user_123' } });
  * veo.track('button_clicked');

package/dist/index.d.ts

@@ -33,8 +33,6 @@ interface VeoAutocaptureConfig {
 interface VeoConfig {
     /** API key pública del workspace (formato pk_xxx). */
     apiKey: string;
-    /** URL base del backend de Veo. */
-    apiUrl: string;
     /** Intervalo en ms para flush automático de la queue. Default: 5000. */
     flushInterval?: number;
     /** Tamaño máximo del batch antes de flush. Default: 20. */
@@ -243,10 +241,8 @@ declare function spaRouterPlugin(): VeoPlugin;
  * ```ts
  * import { init } from '@veo/sdk';
  *
- * const veo = init({
- *   apiKey: 'pk_xxx',
- *   apiUrl: 'https://api.veo.io'
- * });
+ * // apiUrl es opcional: por defecto apunta al backend gestionado de Veo.
+ * const veo = init({ apiKey: 'pk_xxx' });
  *
  * veo.identify({ visitor: { id: 'user_123' } });
  * veo.track('button_clicked');

package/dist/index.mjs

@@ -1,25 +1,28 @@
-import { definePlugin, hasWindow, hasDocument, uuidv7, DEFAULT_AUTOCAPTURE_CONFIG, MAX_ANCESTORS, hasLocalStorage, hasNavigatorSendBeacon, ALWAYS_BLOCK_SELECTORS, buildSelectorPath, filterHumanClasses, PRIORITY_ATTRIBUTES, SENSITIVE_ATTRIBUTES, guidesPlugin, runPreviewMode, previewGuide, closeGuidePreview } from './chunk-BBAA5BRS.mjs';
-export { closeGuidePreview, definePlugin, guidesPlugin, previewGuide } from './chunk-BBAA5BRS.mjs';
+import { definePlugin, guidesPlugin, runPreviewMode } from './chunk-G5CKTGEG.mjs';
+export { definePlugin, guidesPlugin } from './chunk-G5CKTGEG.mjs';
+import { hasWindow, hasDocument, uuidv7, DEFAULT_AUTOCAPTURE_CONFIG, MAX_ANCESTORS, hasLocalStorage, hasNavigatorSendBeacon, ALWAYS_BLOCK_SELECTORS, buildSelectorPath, resolveBuilderToken, filterHumanClasses, PRIORITY_ATTRIBUTES, SENSITIVE_ATTRIBUTES, isBuilderMode, previewGuide, closeGuidePreview } from './chunk-CI7NWEH2.mjs';
+export { closeGuidePreview, previewGuide } from './chunk-CI7NWEH2.mjs';
+import './chunk-JIU5JLI3.mjs';
 
-// src/core/builder-loader.ts
-var BUILDER_TOKEN_PARAM = "veoBuilder";
-function isBuilderMode() {
-  if (!hasWindow()) return false;
-  try {
-    return new URLSearchParams(window.location.search).has(BUILDER_TOKEN_PARAM);
-  } catch {
-    return false;
-  }
+// src/contract/v1.ts
+var SDK_VERSION = "0.0.1";
+var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
+var DEFAULT_FLUSH_BATCH_SIZE = 20;
+var DEFAULT_API_URL = "https://veo-backend-production-8c78.up.railway.app";
+
+// src/core/api-url.ts
+function resolveApiUrl(config) {
+  const fromConfig = config?.apiUrl;
+  if (typeof fromConfig === "string" && fromConfig.trim()) return fromConfig;
+  const fromGlobal = globalThis.__VEO_API_URL__;
+  if (typeof fromGlobal === "string" && fromGlobal.trim()) return fromGlobal;
+  return DEFAULT_API_URL;
 }
+
+// src/core/builder-loader.ts
 function maybeLoadBuilder(opts) {
   if (!hasWindow() || !hasDocument()) return;
-  let params;
-  try {
-    params = new URLSearchParams(window.location.search);
-  } catch {
-    return;
-  }
-  if (!params.has(BUILDER_TOKEN_PARAM)) return;
+  if (resolveBuilderToken() === null) return;
   if (opts.apiKey && opts.apiUrl) {
     window.__veoBuilder = {
       apiKey: opts.apiKey,
@@ -28,20 +31,26 @@ function maybeLoadBuilder(opts) {
   }
   if (window.veoBuilder) return;
   const url = opts.builderUrl ?? deriveBuilderUrl();
-  if (!url) {
+  if (url) {
+    if (document.querySelector(`script[src="${url}"]`)) return;
+    const script = document.createElement("script");
+    script.src = url;
+    script.async = true;
     if (opts.debug) {
-      console.warn("[veo] builder mode pedido pero no pude resolver la URL de veo-builder.js");
+      script.addEventListener("error", () => console.error("[veo] no pude cargar", url));
     }
+    document.head.appendChild(script);
+    return;
+  }
+  if (opts.loadBuilder) {
+    void opts.loadBuilder().catch((err) => {
+      if (opts.debug) console.error("[veo] no pude cargar el builder (import din\xE1mico)", err);
+    });
     return;
   }
-  if (document.querySelector(`script[src="${url}"]`)) return;
-  const script = document.createElement("script");
-  script.src = url;
-  script.async = true;
   if (opts.debug) {
-    script.addEventListener("error", () => console.error("[veo] no pude cargar", url));
+    console.warn("[veo] builder mode pedido pero no pude resolver la URL de veo-builder.js");
   }
-  document.head.appendChild(script);
 }
 function deriveBuilderUrl() {
   const scripts = document.querySelectorAll("script[src]");
@@ -294,11 +303,6 @@ function spaRouterPlugin() {
   });
 }
 
-// src/contract/v1.ts
-var SDK_VERSION = "0.0.1";
-var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
-var DEFAULT_FLUSH_BATCH_SIZE = 20;
-
 // src/core/queue.ts
 var RETRY_MAX_DELAY_MS = 3e4;
 var Queue = class {
@@ -606,12 +610,11 @@ var Client = class {
       identify: /* @__PURE__ */ new Set()
     };
     if (!config.apiKey) throw new Error("apiKey is required");
-    if (!config.apiUrl) throw new Error("apiUrl is required");
     this.storage = createStorage(config.storage ?? "localStorage");
     this.session = new Session(this.storage);
     this.transport = new Transport({
       apiKey: config.apiKey,
-      apiUrl: config.apiUrl.replace(/\/$/, ""),
+      apiUrl: resolveApiUrl(config).replace(/\/$/, ""),
       sdkVersion: SDK_VERSION
     });
     this.queue = new Queue({
@@ -787,7 +790,7 @@ var Client = class {
 };
 
 // src/core/setup.ts
-function setupClient(config, onGuides) {
+function setupClient(config, onGuides, loadBuilder) {
   const client = new Client(config);
   client.use(spaRouterPlugin());
   if (config.autocapture !== false) {
@@ -815,7 +818,8 @@ function setupClient(config, onGuides) {
       ...config.builderUrl !== void 0 ? { builderUrl: config.builderUrl } : {},
       ...config.debug !== void 0 ? { debug: config.debug } : {},
       ...config.apiKey !== void 0 ? { apiKey: config.apiKey } : {},
-      ...config.apiUrl !== void 0 ? { apiUrl: config.apiUrl } : {}
+      apiUrl: resolveApiUrl(config),
+      ...loadBuilder ? { loadBuilder } : {}
     });
   }
   return client;
@@ -823,28 +827,36 @@ function setupClient(config, onGuides) {
 
 // src/index.ts
 function init(config) {
-  return setupClient(config, (client) => {
-    const previewToken = getPreviewToken();
-    if (config.guides === true && !isBuilderMode() && previewToken === null) {
-      client.use(
-        guidesPlugin({
-          apiUrl: config.apiUrl,
+  const apiUrl = resolveApiUrl(config);
+  return setupClient(
+    config,
+    (client) => {
+      const previewToken = getPreviewToken();
+      if (config.guides === true && !isBuilderMode() && previewToken === null) {
+        client.use(
+          guidesPlugin({
+            apiUrl,
+            apiKey: config.apiKey,
+            ...config.debug !== void 0 ? { debug: config.debug } : {}
+          })
+        );
+      }
+      if (previewToken !== null) {
+        void runPreviewMode({
           apiKey: config.apiKey,
+          apiUrl,
+          token: previewToken,
           ...config.debug !== void 0 ? { debug: config.debug } : {}
-        })
-      );
-    }
-    if (previewToken !== null) {
-      void runPreviewMode({
-        apiKey: config.apiKey,
-        apiUrl: config.apiUrl,
-        token: previewToken,
-        ...config.debug !== void 0 ? { debug: config.debug } : {}
-      });
-    }
-    client.preview = previewGuide;
-    client.closePreview = closeGuidePreview;
-  });
+        });
+      }
+      client.preview = previewGuide;
+      client.closePreview = closeGuidePreview;
+    },
+    // Fallback de carga del builder para bundlers: `import()` dinámico → el bundler
+    // lo code-splitea (solo se descarga en modo builder). Así el consumidor por
+    // bundler NO necesita copiar `veo-builder.js` ni setear `builderUrl`.
+    () => import('./builder-UEGKG2UR.mjs').then((m) => m.initBuilderMode())
+  );
 }
 
 export { Client, SDK_VERSION, autocapturePlugin, init, spaRouterPlugin };