@dynamic-labs-sdk/client 0.0.1-alpha.4 → 0.0.1-alpha.5

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.0.1-alpha.5 (2025-06-04)
+
+### 🩹 Fixes
+
+- support server side rendering ([#92](https://github.com/dynamic-labs/dynamic-sdk/pull/92))
+
 ## 0.0.1-alpha.4 (2025-05-28)
 
 ### 🚀 Features

package/getClient.cjs.js

@@ -68,7 +68,7 @@ function _extends() {
     return _extends.apply(this, arguments);
 }
 
-var version = "0.0.1-alpha.4";
+var version = "0.0.1-alpha.5";
 var dependencies = {
     "@dynamic-labs/sdk-api-core": "0.0.630"};
 

package/getClient.esm.js

@@ -66,7 +66,7 @@ function _extends() {
     return _extends.apply(this, arguments);
 }
 
-var version = "0.0.1-alpha.4";
+var version = "0.0.1-alpha.5";
 var dependencies = {
     "@dynamic-labs/sdk-api-core": "0.0.630"};
 

package/index.cjs.js

@@ -266,6 +266,11 @@ class ClientAlreadyInitializedError extends getClient.BaseError {
     }
 };
 
+/**
+ * Indicates if the code is running in a server-side environment.
+ */ // eslint-disable-next-line no-restricted-globals
+const isServerSideRendering = ()=>typeof window === 'undefined';
+
 const createDeferredPromise = ()=>{
     let resolve;
     let reject;
@@ -329,10 +334,26 @@ const createDeferredPromise = ()=>{
 
 const createEventEmitter = ()=>new EventEmitter();
 
+class UnavailableInServerSideError extends getClient.BaseError {
+    constructor(unavailableFeature){
+        super({
+            cause: null,
+            docsUrl: null,
+            name: 'UnavailableInServerSideError',
+            shortMessage: `This function is not available in server-side rendering: ${unavailableFeature}`
+        });
+    }
+}
+
 /**
  * Creates a fetch instance that uses the native window.fetch API.
- */ // eslint-disable-next-line no-restricted-globals -- this is the abstraction for fetch
-const createWebFetch = ()=>window.fetch;
+ */ const createWebFetch = ()=>{
+    if (isServerSideRendering()) {
+        return ()=>Promise.reject(new UnavailableInServerSideError('createWebFetch'));
+    }
+    // eslint-disable-next-line no-restricted-globals -- this is the abstraction for fetch
+    return window.fetch;
+};
 
 /**
  * Log levels and their corresponding numeric values
@@ -380,6 +401,9 @@ const defaultConsole = console;
 /**
  * Creates a deeplink opener that uses the native window.open API.
  */ const createWebDeeplinkOpener = ()=>{
+    if (isServerSideRendering()) {
+        return ()=>Promise.reject(new UnavailableInServerSideError('createWebDeeplinkOpener'));
+    }
     return async (url)=>{
         // eslint-disable-next-line no-restricted-globals -- this is the abstraction for opening a deeplink
         window.open(url, '_blank');
@@ -524,7 +548,17 @@ const createObservableState = (getInitialState)=>{
     };
 };
 
-const createDynamicClient = (config)=>{
+/**
+ * Creates a new DynamicClient instance.
+ *
+ * Notice the `autoInitialize` flag is true by default (unless you're running
+ * in SSR), so the client will be automatically initialized when created — if
+ * you want to manually initialize the client, you can set the `autoInitialize`
+ * flag to false and then later call the `initializeClient` function.
+ *
+ * Manually calling `initializeClient` also allows you to catch any potential
+ * errors that may occur during initialization.
+ */ const createDynamicClient = (config)=>{
     const core = createCore(config);
     const client = {
         get __core () {
@@ -544,8 +578,8 @@ const createDynamicClient = (config)=>{
         }
     };
     var _config_autoInitialize;
-    const autoInitialize = (_config_autoInitialize = config.autoInitialize) != null ? _config_autoInitialize : true;
-    if (autoInitialize) {
+    const shouldAutoInitialize = (_config_autoInitialize = config.autoInitialize) != null ? _config_autoInitialize : !isServerSideRendering();
+    if (shouldAutoInitialize) {
         void initializeClient(client);
     }
     return client;

package/index.esm.js

@@ -265,6 +265,11 @@ class ClientAlreadyInitializedError extends BaseError {
     }
 };
 
+/**
+ * Indicates if the code is running in a server-side environment.
+ */ // eslint-disable-next-line no-restricted-globals
+const isServerSideRendering = ()=>typeof window === 'undefined';
+
 const createDeferredPromise = ()=>{
     let resolve;
     let reject;
@@ -328,10 +333,26 @@ const createDeferredPromise = ()=>{
 
 const createEventEmitter = ()=>new EventEmitter$1();
 
+class UnavailableInServerSideError extends BaseError {
+    constructor(unavailableFeature){
+        super({
+            cause: null,
+            docsUrl: null,
+            name: 'UnavailableInServerSideError',
+            shortMessage: `This function is not available in server-side rendering: ${unavailableFeature}`
+        });
+    }
+}
+
 /**
  * Creates a fetch instance that uses the native window.fetch API.
- */ // eslint-disable-next-line no-restricted-globals -- this is the abstraction for fetch
-const createWebFetch = ()=>window.fetch;
+ */ const createWebFetch = ()=>{
+    if (isServerSideRendering()) {
+        return ()=>Promise.reject(new UnavailableInServerSideError('createWebFetch'));
+    }
+    // eslint-disable-next-line no-restricted-globals -- this is the abstraction for fetch
+    return window.fetch;
+};
 
 /**
  * Log levels and their corresponding numeric values
@@ -379,6 +400,9 @@ const defaultConsole = console;
 /**
  * Creates a deeplink opener that uses the native window.open API.
  */ const createWebDeeplinkOpener = ()=>{
+    if (isServerSideRendering()) {
+        return ()=>Promise.reject(new UnavailableInServerSideError('createWebDeeplinkOpener'));
+    }
     return async (url)=>{
         // eslint-disable-next-line no-restricted-globals -- this is the abstraction for opening a deeplink
         window.open(url, '_blank');
@@ -523,7 +547,17 @@ const createObservableState = (getInitialState)=>{
     };
 };
 
-const createDynamicClient = (config)=>{
+/**
+ * Creates a new DynamicClient instance.
+ *
+ * Notice the `autoInitialize` flag is true by default (unless you're running
+ * in SSR), so the client will be automatically initialized when created — if
+ * you want to manually initialize the client, you can set the `autoInitialize`
+ * flag to false and then later call the `initializeClient` function.
+ *
+ * Manually calling `initializeClient` also allows you to catch any potential
+ * errors that may occur during initialization.
+ */ const createDynamicClient = (config)=>{
     const core = createCore(config);
     const client = {
         get __core () {
@@ -543,8 +577,8 @@ const createDynamicClient = (config)=>{
         }
     };
     var _config_autoInitialize;
-    const autoInitialize = (_config_autoInitialize = config.autoInitialize) != null ? _config_autoInitialize : true;
-    if (autoInitialize) {
+    const shouldAutoInitialize = (_config_autoInitialize = config.autoInitialize) != null ? _config_autoInitialize : !isServerSideRendering();
+    if (shouldAutoInitialize) {
         void initializeClient(client);
     }
     return client;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs-sdk/client",
-  "version": "0.0.1-alpha.4",
+  "version": "0.0.1-alpha.5",
   "type": "module",
   "main": "./index.esm.js",
   "module": "./index.esm.js",

package/src/client/createDynamicClient/createDynamicClient.d.ts

@@ -1,3 +1,14 @@
 import type { DynamicClient, DynamicClientConfig } from '../types';
+/**
+ * Creates a new DynamicClient instance.
+ *
+ * Notice the `autoInitialize` flag is true by default (unless you're running
+ * in SSR), so the client will be automatically initialized when created — if
+ * you want to manually initialize the client, you can set the `autoInitialize`
+ * flag to false and then later call the `initializeClient` function.
+ *
+ * Manually calling `initializeClient` also allows you to catch any potential
+ * errors that may occur during initialization.
+ */
 export declare const createDynamicClient: (config: DynamicClientConfig) => DynamicClient;
 //# sourceMappingURL=createDynamicClient.d.ts.map

package/src/client/createDynamicClient/createDynamicClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDynamicClient.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/client/createDynamicClient/createDynamicClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEnE,eAAO,MAAM,mBAAmB,WACtB,mBAAmB,KAC1B,aA4BF,CAAC"}
+{"version":3,"file":"createDynamicClient.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/client/createDynamicClient/createDynamicClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,WACtB,mBAAmB,KAC1B,aA6BF,CAAC"}

package/src/errors/UnavailableInServerSideError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './base/BaseError';
+export declare class UnavailableInServerSideError extends BaseError {
+    constructor(unavailableFeature: string);
+}
+//# sourceMappingURL=UnavailableInServerSideError.d.ts.map

package/src/errors/UnavailableInServerSideError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnavailableInServerSideError.d.ts","sourceRoot":"","sources":["../../../../../packages/client/src/errors/UnavailableInServerSideError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,4BAA6B,SAAQ,SAAS;gBAC7C,kBAAkB,EAAE,MAAM;CAQvC"}

package/src/services/fetch/createWebFetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createWebFetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/services/fetch/createWebFetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AAEH,eAAO,MAAM,cAAc,QAAO,KAAqB,CAAC"}
+{"version":3,"file":"createWebFetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/services/fetch/createWebFetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,KAQjC,CAAC"}

package/src/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createWebDeeplinkOpener.d.ts","sourceRoot":"","sources":["../../../../../../../packages/client/src/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,YAK1C,CAAC"}
+{"version":3,"file":"createWebDeeplinkOpener.d.ts","sourceRoot":"","sources":["../../../../../../../packages/client/src/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,YAY1C,CAAC"}

package/src/utils/isServerSideRendering/index.d.ts

@@ -0,0 +1,2 @@
+export { isServerSideRendering } from './isServerSideRendering';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/isServerSideRendering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/utils/isServerSideRendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/src/utils/isServerSideRendering/isServerSideRendering.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Indicates if the code is running in a server-side environment.
+ */
+export declare const isServerSideRendering: () => boolean;
+//# sourceMappingURL=isServerSideRendering.d.ts.map

package/src/utils/isServerSideRendering/isServerSideRendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isServerSideRendering.d.ts","sourceRoot":"","sources":["../../../../../../packages/client/src/utils/isServerSideRendering/isServerSideRendering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,qBAAqB,eAAsC,CAAC"}