@amplifyup/sdk 0.1.4 → 0.1.6

package/README.md

@@ -9,24 +9,62 @@ Configure a `trackingId`, and optionally a `target` for which environment to use
 
 ## Environment targets
 
-Two environments — `local` and `production`. Legacy `dev` maps to `local`.
+**Default: production (live).** Hosting your site on `localhost` does not switch environments.
 
-| 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` |
+Opt into `local` only when developing inside the AmplifyUp monorepo:
+
+| Target | When | Layouts / config | Events + personalize |
+|--------|------|------------------|----------------------|
+| `production` (default) | Customer sites, staging, production | `https://amplifyup.ai` | `https://api.amplifyup.ai` |
+| `local` (explicit) | AmplifyUp monorepo dev | `NEXT_PUBLIC_ORCHESTRATOR_URL` | `https://api-dev.amplifyup.ai` |
 
 ```bash
-# Demo on http://localhost:5000 — pages from local Neon, events to AWS-dev
+# AmplifyUp monorepo only (apps/demo, apps/orchestrator locally)
 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
+# Customer sites: omit NEXT_PUBLIC_AMPLIFYUP_TARGET — always live
 ```
 
 Check active URLs in the browser: `AmplifyUp.getStatus()`
 
+### Hybrid pages (native content + Composer)
+
+For pages with native content that should only appear for real visitors:
+
+```tsx
+// app/insights/page.tsx (server)
+import { isPreviewRequest } from '@amplifyup/sdk';
+import { AmplifyPageContent } from '@amplifyup/sdk/react';
+
+export default async function InsightsPage({ searchParams }) {
+  const params = await searchParams;
+
+  if (isPreviewRequest(params)) {
+    // Composer: no blog fetch, no native fallback HTML
+    return (
+      <Layout>
+        <AmplifyPageContent renderComponent={renderAmplifyComponent} />
+      </Layout>
+    );
+  }
+
+  const posts = await getPosts();
+  return (
+    <Layout>
+      <PostsProvider value={posts}>
+        <AmplifyPageContent
+          fallback={<InsightsFallback />}
+          renderComponent={renderAmplifyComponent}
+        />
+      </PostsProvider>
+    </Layout>
+  );
+}
+```
+
+In Composer preview, `AmplifyPageContent` shows an empty layout canvas — never `fallback`.
+
 ## Installation
 
 ```bash

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-Xv9P55Dj.mjs';
+import { P as PageConfig } from './types-B2Swk8BW.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-Xv9P55Dj.js';
+import { P as PageConfig } from './types-B2Swk8BW.js';
 
 interface AmplifyRendererProps {
     /**

package/dist/AmplifyRenderer.js

@@ -242,14 +242,16 @@ function resolveAmplifyUpTarget(options) {
   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 isRemoteOrchestratorUrl(orchestratorUrl) {
+  try {
+    const host = new URL(orchestratorUrl).hostname.toLowerCase();
+    return host !== "localhost" && host !== "127.0.0.1" && host !== "::1";
+  } catch {
+    return false;
+  }
+}
 function localOrchestratorUrl() {
   const fromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_ORCHESTRATOR_URL : void 0;
   return (fromEnv || "http://localhost:5001").replace(/\/$/, "");
@@ -405,6 +407,7 @@ var AmplifyUpSDK = class {
    */
   async init(config) {
     if (this.initialized && this.adapter?.isInitialized()) {
+      this.ensureWindowBridge();
       return;
     }
     if (this.initPromise) {
@@ -417,6 +420,32 @@ var AmplifyUpSDK = class {
       this.initPromise = null;
     }
   }
+  /** Attach console helpers to window (idempotent; survives Fast Refresh). */
+  ensureWindowBridge() {
+    if (typeof window === "undefined") return;
+    window.AmplifyUp = {
+      getInstanceId: () => this.getInstanceId(),
+      getUserId: () => this.getUserId(),
+      getTrackingId: () => this.getTrackingId(),
+      getTarget: () => this.getTarget(),
+      getDiagnostics: () => this.getDiagnostics(),
+      getStatus: () => {
+        console.log(this.getStatus());
+        return this.getDiagnostics();
+      },
+      testTracking: () => this.testTracking(),
+      verifyAWSConnection: () => {
+        const result = this.verifyAWSConnection();
+        console.log("AWS Connection Verification:", result.message);
+        console.log("Full details:", result);
+        return result;
+      },
+      isInitialized: () => this.isInitialized(),
+      page: (url, properties) => this.page(url, properties),
+      track: (eventName, properties) => this.track(eventName, properties),
+      identify: (userId, traits) => this.identify(userId, traits)
+    };
+  }
   async performInit(config) {
     if (!this.adapter) {
       this.adapter = new AWSAdapter();
@@ -432,6 +461,12 @@ var AmplifyUpSDK = class {
     const previewOverrides = readPreviewQueryOverrides();
     if (previewOverrides.orchestratorUrl) {
       this.orchestratorUrl = previewOverrides.orchestratorUrl;
+      if (isRemoteOrchestratorUrl(previewOverrides.orchestratorUrl)) {
+        const prodUrls = resolveAmplifyUpUrls("production");
+        this.target = "production";
+        this.apiGatewayUrl = prodUrls.apiGatewayUrl;
+        this.decisionApiUrl = prodUrls.decisionApiUrl;
+      }
     }
     this.config = {
       trackingId: previewOverrides.trackingId || config.trackingId,
@@ -449,34 +484,10 @@ var AmplifyUpSDK = class {
       };
       await this.adapter.init(adapterConfig);
       this.initialized = this.adapter.isInitialized();
-      if (typeof window !== "undefined") {
-        window.AmplifyUp = {
-          getInstanceId: () => this.getInstanceId(),
-          getUserId: () => this.getUserId(),
-          getTrackingId: () => this.getTrackingId(),
-          getTarget: () => this.getTarget(),
-          getDiagnostics: () => this.getDiagnostics(),
-          getStatus: () => {
-            console.log(this.getStatus());
-            return this.getDiagnostics();
-          },
-          testTracking: () => this.testTracking(),
-          verifyAWSConnection: () => {
-            const result = this.verifyAWSConnection();
-            console.log("AWS Connection Verification:", result.message);
-            console.log("Full details:", result);
-            return result;
-          },
-          isInitialized: () => this.isInitialized(),
-          // Re-export main tracking methods for convenience
-          page: (url, properties) => this.page(url, properties),
-          track: (eventName, properties) => this.track(eventName, properties),
-          identify: (userId, traits) => this.identify(userId, traits)
-        };
-        if (this.config?.debug) {
-          console.log("AmplifyUp SDK: Diagnostic methods available on window.AmplifyUp");
-          console.log("Try: AmplifyUp.getStatus() or AmplifyUp.testTracking()");
-        }
+      this.ensureWindowBridge();
+      if (this.config?.debug) {
+        console.log("AmplifyUp SDK: Diagnostic methods available on window.AmplifyUp");
+        console.log("Try: AmplifyUp.getStatus() or AmplifyUp.testTracking()");
       }
       this.clearTrackingIntervals();
       if (this.isPreviewMode()) {
@@ -1487,10 +1498,17 @@ Available Console Commands:
   }
 };
 var sdkInstance = null;
+if (typeof window !== "undefined" && window.__AMPLIFYUP_SDK__) {
+  sdkInstance = window.__AMPLIFYUP_SDK__;
+}
 function getSDK(adapter) {
   if (!sdkInstance) {
     sdkInstance = new AmplifyUpSDK(adapter);
+    if (typeof window !== "undefined") {
+      window.__AMPLIFYUP_SDK__ = sdkInstance;
+    }
   }
+  sdkInstance.ensureWindowBridge();
   return sdkInstance;
 }
 var trackContentView = (contentId, contentType, properties) => getSDK().trackContentView(contentId, contentType, properties);