@amplifyup/sdk 0.1.1 → 0.1.3

package/README.md

@@ -4,7 +4,28 @@ AmplifyUp Tracking SDK - CDP-agnostic event tracking library.
 
 ## Overview
 
-This SDK provides event tracking that sends events directly to AWS API Gateway. All URLs are hardcoded in the SDK - no configuration needed except `trackingId`.
+This SDK provides event tracking and personalization against AmplifyUp backends.
+Configure a `trackingId`, and optionally a `target` for which environment to use.
+
+## Environment targets
+
+Two environments — `local` and `production`. Legacy `dev` maps to `local`.
+
+| Target | Layouts / config (Neon) | Events + personalize |
+|--------|-------------------------|----------------------|
+| `local` | `NEXT_PUBLIC_ORCHESTRATOR_URL` (e.g. `http://localhost:5001`) | `https://api-dev.amplifyup.ai` (AWS development) |
+| `production` | `https://amplifyup.ai` | `https://api.amplifyup.ai` |
+
+```bash
+# Demo on http://localhost:5000 — pages from local Neon, events to AWS-dev
+NEXT_PUBLIC_ORCHESTRATOR_URL=http://localhost:5001
+NEXT_PUBLIC_AMPLIFYUP_TARGET=local
+
+# Optional: override AWS API base used by local (default api-dev)
+# NEXT_PUBLIC_AMPLIFYUP_API_URL=https://api-dev.amplifyup.ai
+```
+
+Check active URLs in the browser: `AmplifyUp.getStatus()`
 
 ## Installation
 
@@ -19,10 +40,9 @@ npm install @amplifyup/sdk
 ```typescript
 import { init } from '@amplifyup/sdk';
 
-// Initialize the SDK (URLs are hardcoded)
 await init({
   trackingId: 'your-tracking-id',
-  debug: true, // Optional, enables debug logging
+  debug: true,
 });
 ```
 
@@ -100,21 +120,6 @@ npm run dev
 npm run lint
 ```
 
-## Publishing (maintainers)
-
-CI publishes via **npm Trusted Publishing** (GitHub ↔ npm, no long-lived token).
-
-**One-time setup on npm:**
-
-1. **If the package has never been published:** Publish once with a token so the package exists: add `NPM_TOKEN` (Automation token) in repo Secrets, run the workflow, then remove the token and continue below.
-2. On [npmjs.com](https://www.npmjs.com): sign in → **Packages** → **@amplifyup/sdk** → **Settings** → **Trusted publishing**.
-3. Under “Select your publisher” choose **GitHub Actions** and set:
-   - **Workflow filename:** `publish-sdk.yml` (must match exactly)
-   - Repository/owner as prompted.
-4. Save. Future runs publish with no `NPM_TOKEN` secret.
-
-Requires Node 22.14+ and npm 11.5.1+ (workflow uses Node 22).
-
 ## License
 
 MIT

package/dist/AmplifyRenderer.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { P as PageConfig } from './types-B9nHG2Cl.mjs';
+import { P as PageConfig } from './types-Xv9P55Dj.mjs';
 
 interface AmplifyRendererProps {
     /**

package/dist/AmplifyRenderer.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { P as PageConfig } from './types-B9nHG2Cl.js';
+import { P as PageConfig } from './types-Xv9P55Dj.js';
 
 interface AmplifyRendererProps {
     /**

package/dist/AmplifyRenderer.js

@@ -1,3 +1,4 @@
+'use client';
 'use strict';
 
 var react = require('react');
@@ -220,9 +221,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;
@@ -230,7 +291,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;
@@ -313,46 +379,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 {
@@ -369,6 +430,7 @@ var AmplifyUpSDK = class {
           getInstanceId: () => this.getInstanceId(),
           getUserId: () => this.getUserId(),
           getTrackingId: () => this.getTrackingId(),
+          getTarget: () => this.getTarget(),
           getDiagnostics: () => this.getDiagnostics(),
           getStatus: () => {
             console.log(this.getStatus());
@@ -389,7 +451,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();
@@ -401,11 +463,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);
@@ -606,6 +677,7 @@ var AmplifyUpSDK = class {
       instanceId,
       userId,
       trackingId: this.config?.trackingId,
+      target: this.target,
       config: {
         apiGatewayUrl: this.apiGatewayUrl,
         decisionApiUrl: this.decisionApiUrl,
@@ -614,6 +686,9 @@ var AmplifyUpSDK = class {
       }
     };
   }
+  getTarget() {
+    return this.target;
+  }
   /**
    * Test tracking by sending a test event
    */
@@ -671,6 +746,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"}
@@ -682,11 +758,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