@amplifyup/sdk 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as EventTrackingConfig$1 } from './types-B9nHG2Cl.mjs';
-export { P as PageConfig, Z as ZoneConfig } from './types-B9nHG2Cl.mjs';
+import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-Xv9P55Dj.mjs';
+export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-Xv9P55Dj.mjs';
 
 /**
  * AmplifyUp Tracking SDK
@@ -24,7 +24,12 @@ declare class AmplifyUpSDK {
     private apiGatewayUrl;
     private orchestratorUrl;
     private decisionApiUrl;
+    private target;
     private initialized;
+    /** Prevents overlapping init() from React Strict Mode double-mount */
+    private initPromise;
+    /** Ensures auto page() on init fires once per page load */
+    private initialPageSent;
     private highlightingEnabled;
     private componentRegistry;
     private messageListener;
@@ -49,22 +54,12 @@ declare class AmplifyUpSDK {
      * Check if we're in preview/composer mode (should disable tracking)
      */
     private isPreviewMode;
-    /**
-     * Get production URLs
-     *
-     * URLs are baked in at build time via tsup.config.ts
-     *
-     * API Gateway endpoints:
-     * - /v1/track - Event tracking (ingestion)
-     * - /v1/page - Page view tracking (ingestion)
-     * - /v1/personalize - Decision engine (personalization)
-     */
-    private getProductionUrls;
     /**
      * Initialize the SDK
-     * Automatically reads env vars and sets up tracking
+     * Resolves local | dev | production targets for ingestion + personalization URLs.
      */
     init(config: AmplifyUpConfig): Promise<void>;
+    private performInit;
     /**
      * Check if SDK is initialized
      */
@@ -130,6 +125,7 @@ declare class AmplifyUpSDK {
         instanceId: string;
         userId: string | null;
         trackingId: string | undefined;
+        target: AmplifyUpTarget;
         config: {
             apiGatewayUrl?: string;
             decisionApiUrl?: string;
@@ -137,6 +133,7 @@ declare class AmplifyUpSDK {
             debug?: boolean;
         };
     };
+    getTarget(): AmplifyUpTarget;
     /**
      * Test tracking by sending a test event
      */
@@ -266,6 +263,7 @@ declare const reset: () => void;
 declare const getInstanceId: () => string;
 declare const getUserId: () => string | null;
 declare const getTrackingId: () => string | undefined;
+declare const getTarget: () => AmplifyUpTarget;
 declare const getOrchestratorUrl: () => string | undefined;
 declare const buildLayoutProviderUrl: (route: string, preview?: boolean) => string;
 declare const buildPageRenderUrl: (route: string, preview?: boolean) => string;
@@ -278,6 +276,7 @@ declare const getDiagnostics: () => {
     instanceId: string;
     userId: string | null;
     trackingId: string | undefined;
+    target: AmplifyUpTarget;
     config: {
         apiGatewayUrl?: string;
         decisionApiUrl?: string;
@@ -290,6 +289,7 @@ declare const getStatus: () => {
     instanceId: string;
     userId: string | null;
     trackingId: string | undefined;
+    target: AmplifyUpTarget;
     config: {
         apiGatewayUrl?: string;
         decisionApiUrl?: string;
@@ -306,4 +306,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { AmplifyUpConfig, AmplifyUpSDK, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as EventTrackingConfig$1 } from './types-B9nHG2Cl.js';
-export { P as PageConfig, Z as ZoneConfig } from './types-B9nHG2Cl.js';
+import { C as CDPAdapter, A as AmplifyUpConfig, E as EventProperties, I as IdentifyTraits, a as AmplifyUpTarget, b as EventTrackingConfig$1 } from './types-Xv9P55Dj.js';
+export { P as PageConfig, Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, c as resolveAmplifyUpUrls } from './types-Xv9P55Dj.js';
 
 /**
  * AmplifyUp Tracking SDK
@@ -24,7 +24,12 @@ declare class AmplifyUpSDK {
     private apiGatewayUrl;
     private orchestratorUrl;
     private decisionApiUrl;
+    private target;
     private initialized;
+    /** Prevents overlapping init() from React Strict Mode double-mount */
+    private initPromise;
+    /** Ensures auto page() on init fires once per page load */
+    private initialPageSent;
     private highlightingEnabled;
     private componentRegistry;
     private messageListener;
@@ -49,22 +54,12 @@ declare class AmplifyUpSDK {
      * Check if we're in preview/composer mode (should disable tracking)
      */
     private isPreviewMode;
-    /**
-     * Get production URLs
-     *
-     * URLs are baked in at build time via tsup.config.ts
-     *
-     * API Gateway endpoints:
-     * - /v1/track - Event tracking (ingestion)
-     * - /v1/page - Page view tracking (ingestion)
-     * - /v1/personalize - Decision engine (personalization)
-     */
-    private getProductionUrls;
     /**
      * Initialize the SDK
-     * Automatically reads env vars and sets up tracking
+     * Resolves local | dev | production targets for ingestion + personalization URLs.
      */
     init(config: AmplifyUpConfig): Promise<void>;
+    private performInit;
     /**
      * Check if SDK is initialized
      */
@@ -130,6 +125,7 @@ declare class AmplifyUpSDK {
         instanceId: string;
         userId: string | null;
         trackingId: string | undefined;
+        target: AmplifyUpTarget;
         config: {
             apiGatewayUrl?: string;
             decisionApiUrl?: string;
@@ -137,6 +133,7 @@ declare class AmplifyUpSDK {
             debug?: boolean;
         };
     };
+    getTarget(): AmplifyUpTarget;
     /**
      * Test tracking by sending a test event
      */
@@ -266,6 +263,7 @@ declare const reset: () => void;
 declare const getInstanceId: () => string;
 declare const getUserId: () => string | null;
 declare const getTrackingId: () => string | undefined;
+declare const getTarget: () => AmplifyUpTarget;
 declare const getOrchestratorUrl: () => string | undefined;
 declare const buildLayoutProviderUrl: (route: string, preview?: boolean) => string;
 declare const buildPageRenderUrl: (route: string, preview?: boolean) => string;
@@ -278,6 +276,7 @@ declare const getDiagnostics: () => {
     instanceId: string;
     userId: string | null;
     trackingId: string | undefined;
+    target: AmplifyUpTarget;
     config: {
         apiGatewayUrl?: string;
         decisionApiUrl?: string;
@@ -290,6 +289,7 @@ declare const getStatus: () => {
     instanceId: string;
     userId: string | null;
     trackingId: string | undefined;
+    target: AmplifyUpTarget;
     config: {
         apiGatewayUrl?: string;
         decisionApiUrl?: string;
@@ -306,4 +306,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { AmplifyUpConfig, AmplifyUpSDK, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, IdentifyTraits, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId, identify, init, page, refreshEventTracking, reset, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.js

@@ -171,6 +171,16 @@ var AWSAdapter = class {
 // src/storage.ts
 var INSTANCE_ID_KEY = "amplifyup_instance_id";
 var USER_ID_KEY = "amplifyup_user_id";
+function generateGuid() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
 function getInstanceId() {
   if (typeof window === "undefined") {
     return "";
@@ -179,7 +189,7 @@ function getInstanceId() {
   if (stored) {
     return stored;
   }
-  const instanceId = `anon_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+  const instanceId = `browser_${generateGuid()}`;
   localStorage.setItem(INSTANCE_ID_KEY, instanceId);
   return instanceId;
 }
@@ -203,9 +213,69 @@ function clearIds() {
   localStorage.removeItem(USER_ID_KEY);
 }
 
+// src/targets.ts
+var AWS_DEV_API = "https://api-dev.amplifyup.ai";
+var AWS_PROD_API = "https://api.amplifyup.ai";
+var PROD_ORCHESTRATOR = "https://amplifyup.ai";
+function isAmplifyUpTarget(value) {
+  return value === "local" || value === "dev" || value === "production";
+}
+function normalizeAmplifyUpTarget(value) {
+  return value === "dev" ? "local" : value;
+}
+function resolveAmplifyUpTarget(options) {
+  if (options?.configTarget && isAmplifyUpTarget(options.configTarget)) {
+    return normalizeAmplifyUpTarget(options.configTarget);
+  }
+  if (options?.configDev === true) {
+    return "local";
+  }
+  const envTarget = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_AMPLIFYUP_TARGET : void 0;
+  if (isAmplifyUpTarget(envTarget)) {
+    return normalizeAmplifyUpTarget(envTarget);
+  }
+  if (typeof window !== "undefined") {
+    const host = window.location.hostname;
+    if (host === "localhost" || host === "127.0.0.1") {
+      return "local";
+    }
+  }
+  return "production";
+}
+function localOrchestratorUrl() {
+  const fromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_ORCHESTRATOR_URL : void 0;
+  return (fromEnv || "http://localhost:5001").replace(/\/$/, "");
+}
+function localAwsApiUrl() {
+  const fromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_AMPLIFYUP_API_URL : void 0;
+  return (fromEnv || AWS_DEV_API).replace(/\/$/, "");
+}
+function resolveAmplifyUpUrls(target) {
+  if (target === "local") {
+    const orchestratorUrl2 = localOrchestratorUrl();
+    const apiGatewayUrl = localAwsApiUrl();
+    return {
+      target: "local",
+      // Layouts / site config / composer APIs → local orchestrator + Neon
+      orchestratorUrl: orchestratorUrl2,
+      // Events + personalize → AWS development stack
+      apiGatewayUrl,
+      decisionApiUrl: `${apiGatewayUrl}/v1/personalize`
+    };
+  }
+  const resolvedApi = typeof process !== "undefined" && process.env.NEXT_PUBLIC_AMPLIFYUP_API_URL?.replace(/\/$/, "") || AWS_PROD_API;
+  const orchestratorFromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_ORCHESTRATOR_URL : void 0;
+  const isLocalOrchestrator = !!orchestratorFromEnv && (orchestratorFromEnv.includes("localhost") || orchestratorFromEnv.includes("127.0.0.1"));
+  const orchestratorUrl = isLocalOrchestrator || !orchestratorFromEnv ? PROD_ORCHESTRATOR : orchestratorFromEnv.replace(/\/$/, "");
+  return {
+    target: "production",
+    apiGatewayUrl: resolvedApi,
+    orchestratorUrl,
+    decisionApiUrl: `${resolvedApi}/v1/personalize`
+  };
+}
+
 // src/index.ts
-var PROD_API_URL = "https://api.amplifyup.ai" ;
-var PROD_ORCHESTRATOR_URL = "https://amplifyup.ai" ;
 var AmplifyUpSDK = class {
   constructor(adapter) {
     this.config = null;
@@ -213,7 +283,12 @@ var AmplifyUpSDK = class {
     this.apiGatewayUrl = "";
     this.orchestratorUrl = "";
     this.decisionApiUrl = "";
+    this.target = "local";
     this.initialized = false;
+    /** Prevents overlapping init() from React Strict Mode double-mount */
+    this.initPromise = null;
+    /** Ensures auto page() on init fires once per page load */
+    this.initialPageSent = false;
     this.highlightingEnabled = false;
     this.componentRegistry = [];
     this.messageListener = null;
@@ -296,46 +371,41 @@ var AmplifyUpSDK = class {
     }
     return false;
   }
-  /**
-   * Get production URLs
-   * 
-   * URLs are baked in at build time via tsup.config.ts
-   * 
-   * API Gateway endpoints:
-   * - /v1/track - Event tracking (ingestion)
-   * - /v1/page - Page view tracking (ingestion)  
-   * - /v1/personalize - Decision engine (personalization)
-   */
-  getProductionUrls() {
-    return {
-      apiGatewayUrl: PROD_API_URL,
-      orchestratorUrl: PROD_ORCHESTRATOR_URL,
-      decisionApiUrl: `${PROD_API_URL}/v1/personalize`
-    };
-  }
   /**
    * Initialize the SDK
-   * Automatically reads env vars and sets up tracking
+   * Resolves local | dev | production targets for ingestion + personalization URLs.
    */
   async init(config) {
+    if (this.initialized && this.adapter?.isInitialized()) {
+      return;
+    }
+    if (this.initPromise) {
+      return this.initPromise;
+    }
+    this.initPromise = this.performInit(config);
+    try {
+      await this.initPromise;
+    } finally {
+      this.initPromise = null;
+    }
+  }
+  async performInit(config) {
     if (!this.adapter) {
       this.adapter = new AWSAdapter();
     }
-    const isLocalhost = typeof window !== "undefined" && (window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1");
-    if (isLocalhost || config.dev === true) {
-      this.apiGatewayUrl = "http://localhost:5001/api";
-      this.orchestratorUrl = "http://localhost:5001";
-      this.decisionApiUrl = "http://localhost:5001/api/v1/personalize";
-    } else {
-      const urls = this.getProductionUrls();
-      this.apiGatewayUrl = urls.apiGatewayUrl;
-      this.orchestratorUrl = urls.orchestratorUrl;
-      this.decisionApiUrl = urls.decisionApiUrl;
-    }
+    this.target = resolveAmplifyUpTarget({
+      configTarget: config.target,
+      configDev: config.dev
+    });
+    const urls = resolveAmplifyUpUrls(this.target);
+    this.apiGatewayUrl = urls.apiGatewayUrl;
+    this.orchestratorUrl = urls.orchestratorUrl;
+    this.decisionApiUrl = urls.decisionApiUrl;
     this.config = {
       trackingId: config.trackingId,
       debug: config.debug ?? true,
       // Enable debug by default
+      target: this.target,
       dev: config.dev
     };
     try {
@@ -352,6 +422,7 @@ var AmplifyUpSDK = class {
           getInstanceId: () => this.getInstanceId(),
           getUserId: () => this.getUserId(),
           getTrackingId: () => this.getTrackingId(),
+          getTarget: () => this.getTarget(),
           getDiagnostics: () => this.getDiagnostics(),
           getStatus: () => {
             console.log(this.getStatus());
@@ -372,7 +443,7 @@ var AmplifyUpSDK = class {
         };
         if (this.config?.debug) {
           console.log("AmplifyUp SDK: Diagnostic methods available on window.AmplifyUp");
-          console.log("Try: AmplifyUp.getStatus() or AmplifyUp.verifyAWSConnection()");
+          console.log("Try: AmplifyUp.getStatus() or AmplifyUp.testTracking()");
         }
       }
       this.clearTrackingIntervals();
@@ -384,11 +455,20 @@ var AmplifyUpSDK = class {
         if (this.isPreviewMode()) {
           return;
         }
-        const url = window.location.pathname;
-        this.page(url);
+        if (!this.initialPageSent) {
+          this.initialPageSent = true;
+          const url = window.location.pathname;
+          this.page(url);
+        }
       }
       if (this.config?.debug && this.initialized) {
-        console.log("AmplifyUp SDK: Initialized successfully", { trackingId: config.trackingId });
+        console.log("AmplifyUp SDK: Initialized successfully", {
+          trackingId: config.trackingId,
+          target: this.target,
+          apiGatewayUrl: this.apiGatewayUrl,
+          orchestratorUrl: this.orchestratorUrl,
+          decisionApiUrl: this.decisionApiUrl || "(orchestrator fallback)"
+        });
       }
     } catch (error) {
       console.error("AmplifyUp SDK: Initialization failed", error);
@@ -589,6 +669,7 @@ var AmplifyUpSDK = class {
       instanceId,
       userId,
       trackingId: this.config?.trackingId,
+      target: this.target,
       config: {
         apiGatewayUrl: this.apiGatewayUrl,
         decisionApiUrl: this.decisionApiUrl,
@@ -597,6 +678,9 @@ var AmplifyUpSDK = class {
       }
     };
   }
+  getTarget() {
+    return this.target;
+  }
   /**
    * Test tracking by sending a test event
    */
@@ -654,6 +738,7 @@ var AmplifyUpSDK = class {
 AmplifyUp SDK Status:
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 Initialized: ${diag.initialized ? "\u2705 Yes" : "\u274C No"}
+Target: ${diag.target}
 Instance ID: ${diag.instanceId}
 User ID: ${diag.userId || "Not identified"}
 Tracking ID: ${diag.trackingId || "Not set"}
@@ -665,11 +750,11 @@ Config:
   API Gateway: ${this.apiGatewayUrl || "Not set (required)"}
   Decision API: ${this.decisionApiUrl || "Not set (using Orchestrator fallback)"}
   Orchestrator: ${this.orchestratorUrl || "Not set"}
-  Debug: ${diag.config.debug ? "Enabled" : "Disabled"}
 
 Available Console Commands:
   AmplifyUp.getStatus()        - Show this status
   AmplifyUp.getDiagnostics()   - Get full diagnostic object
+  AmplifyUp.getTarget()        - Current environment target
   AmplifyUp.getInstanceId()    - Get instance ID (browser/session ID)
   AmplifyUp.getUserId()        - Get user ID if identified
   AmplifyUp.testTracking()     - Send a test event
@@ -1392,6 +1477,7 @@ var reset = () => getSDK().reset();
 var getInstanceId2 = () => getSDK().getInstanceId();
 var getUserId2 = () => getSDK().getUserId();
 var getTrackingId = () => getSDK().getTrackingId();
+var getTarget = () => getSDK().getTarget();
 var getOrchestratorUrl = () => getSDK().getOrchestratorUrl();
 var buildLayoutProviderUrl = (route, preview) => getSDK().buildLayoutProviderUrl(route, preview);
 var buildPageRenderUrl = (route, preview) => getSDK().buildLayoutProviderUrl(route, preview);
@@ -1425,13 +1511,18 @@ exports.getInstanceId = getInstanceId2;
 exports.getOrchestratorUrl = getOrchestratorUrl;
 exports.getSDK = getSDK;
 exports.getStatus = getStatus;
+exports.getTarget = getTarget;
 exports.getTrackingId = getTrackingId;
 exports.getUserId = getUserId2;
 exports.identify = identify;
 exports.init = init;
+exports.isAmplifyUpTarget = isAmplifyUpTarget;
+exports.normalizeAmplifyUpTarget = normalizeAmplifyUpTarget;
 exports.page = page;
 exports.refreshEventTracking = refreshEventTracking;
 exports.reset = reset;
+exports.resolveAmplifyUpTarget = resolveAmplifyUpTarget;
+exports.resolveAmplifyUpUrls = resolveAmplifyUpUrls;
 exports.setupEventTracking = setupEventTracking;
 exports.testTracking = testTracking;
 exports.track = track;