@memberstack/dom 2.0.2-beta.0 → 2.0.3

package/lib/index.mjs

@@ -191,10 +191,29 @@ var loadPrebuiltUI = (retries = 2) => __async(void 0, null, function* () {
     const script = document.createElement("script");
     script.src = getPrebuiltUIUrl();
     script.async = true;
-    script.onload = () => {
-      prebuiltUILoaded = true;
-      resolve();
-    };
+    script.onload = () => __async(void 0, null, function* () {
+      yield new Promise((r) => setTimeout(r, 0));
+      if (typeof customElements !== "undefined" && customElements.get("memberstack-prebuilt-ui")) {
+        prebuiltUILoaded = true;
+        resolve();
+      } else {
+        prebuiltUILoadPromise = null;
+        script.remove();
+        if (retries > 0) {
+          yield new Promise((r) => setTimeout(r, 1e3));
+          try {
+            yield loadPrebuiltUI(retries - 1);
+            resolve();
+          } catch (e) {
+            reject(e);
+          }
+        } else {
+          reject(new Error(
+            "Failed to load Memberstack modals: the script loaded but the modal component was not registered. This typically happens when the browser blocks the script body (CORS/ORB). If developing locally, set window.__MS_PREBUILT_UI_URL__ to a locally-served copy of the modal script."
+          ));
+        }
+      }
+    });
     script.onerror = () => __async(void 0, null, function* () {
       prebuiltUILoadPromise = null;
       script.remove();
@@ -208,7 +227,7 @@ var loadPrebuiltUI = (retries = 2) => __async(void 0, null, function* () {
         }
       } else {
         reject(new Error(
-          "Failed to load Memberstack modals after multiple attempts. Please check your internet connection."
+          "Failed to load Memberstack modals after multiple attempts. Check your internet connection and browser console for CORS/network errors. For local development, set window.__MS_PREBUILT_UI_URL__ to a locally-served copy."
         ));
       }
     });
@@ -249,7 +268,7 @@ var showMessage = (msg, isError) => __async(void 0, null, function* () {
     return;
   const messageTextBox = messageBox.querySelector("[data-ms-message-text]");
   if (messageTextBox) {
-    messageTextBox.innerHTML = msg;
+    messageTextBox.textContent = msg;
   }
   messageBox.style.display = "block";
   const closeBtn = messageBox.querySelector("[data-ms-message-close]");
@@ -319,6 +338,7 @@ var hideLoader = (element) => {
   (_a = document.querySelector("[data-ms-modal-loader]")) == null ? void 0 : _a.remove();
 };
 var modal = null;
+var resolveModal;
 var openModal = (_0, ..._1) => __async(void 0, [_0, ..._1], function* (type, params = {}) {
   const isInspector = type.toLowerCase() === "inspector";
   const needsLoading = !prebuiltUILoaded;
@@ -328,12 +348,32 @@ var openModal = (_0, ..._1) => __async(void 0, [_0, ..._1], function* (type, par
   }
   try {
     yield loadPrebuiltUI();
+  } catch (error) {
+    if (showLoaderForThisCall) {
+      hideLoader();
+    }
+    console.warn(
+      "[Memberstack] Modal failed to load.",
+      error instanceof Error ? error.message : error,
+      "\nHint: Set window.__MS_PREBUILT_UI_URL__ to override the CDN URL during local development."
+    );
+    throw error;
   } finally {
     if (showLoaderForThisCall) {
       hideLoader();
     }
   }
-  let resolveModal;
+  if (modal) {
+    try {
+      modal.remove();
+    } catch (e) {
+    }
+    if (resolveModal) {
+      resolveModal({ type: "CLOSED" });
+    }
+    modal = null;
+    resolveModal = void 0;
+  }
   const modalPromise = new Promise((resolve) => {
     resolveModal = resolve;
   });
@@ -350,6 +390,11 @@ var hideModal = () => {
     modal == null ? void 0 : modal.remove();
   } catch (e) {
   }
+  if (resolveModal) {
+    resolveModal({ type: "CLOSED" });
+  }
+  modal = null;
+  resolveModal = void 0;
 };
 
 // src/utils/cookies.ts
@@ -410,10 +455,11 @@ var setMemberToken = (token, expires) => {
     localStorage.setItem(memberAuthTokenName, token);
   } else {
     const domain = extractDomainFromHostname(window.location.hostname);
-    Cookie.set(memberAuthTokenName, token, __spreadValues({
+    const isSecure = typeof window !== "undefined" && window.location.protocol === "https:";
+    Cookie.set(memberAuthTokenName, token, __spreadValues(__spreadValues({
       expires: expires && Number(expires) || 14,
       sameSite: "strict"
-    }, setCookieOnRootDomain && { domain }));
+    }, isSecure && { secure: true }), setCookieOnRootDomain && { domain }));
   }
 };
 var removeMemberToken = () => {
@@ -421,14 +467,11 @@ var removeMemberToken = () => {
     localStorage.removeItem(memberAuthTokenName);
   }
   const domain = extractDomainFromHostname(window.location.hostname);
-  Cookie.set(memberAuthTokenName, "", __spreadValues({
-    expires: -1,
-    sameSite: "strict"
-  }, setCookieOnRootDomain && { domain }));
-  Cookie.set(memberAuthTokenName, "", {
+  const isSecure = typeof window !== "undefined" && window.location.protocol === "https:";
+  Cookie.set(memberAuthTokenName, "", __spreadValues(__spreadValues({
     expires: -1,
     sameSite: "strict"
-  });
+  }, isSecure && { secure: true }), setCookieOnRootDomain && { domain }));
 };
 var getMemberToken = () => {
   if (localStorageAvailable) {
@@ -442,8 +485,13 @@ var setMemberTokenIfAvailable = () => {
   if (typeof window !== "undefined") {
     const urlParams = new URLSearchParams(window.location.search);
     const memberToken = urlParams.get("memberToken");
-    if (memberToken)
+    if (memberToken) {
       setMemberToken(memberToken);
+      urlParams.delete("memberToken");
+      const newSearch = urlParams.toString();
+      const newUrl = newSearch ? `${window.location.pathname}?${newSearch}${window.location.hash}` : `${window.location.pathname}${window.location.hash}`;
+      window.history.replaceState({}, "", newUrl);
+    }
   }
 };
 var getSessionId = () => {
@@ -486,6 +534,11 @@ var createRequestHandler = ({
   token,
   customEndpoint
 }) => {
+  if (!publicKey) {
+    throw new Error(
+      "Memberstack: publicKey is required. Pass your public key to memberstack.init({ publicKey: 'pk_...' })"
+    );
+  }
   return {
     sendRequest: (data, options) => __async(void 0, null, function* () {
       var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -503,7 +556,9 @@ var createRequestHandler = ({
           method: data.method,
           data: data.data,
           url: formattedUrl,
-          headers: __spreadProps(__spreadValues(__spreadValues(__spreadProps(__spreadValues(__spreadValues(__spreadValues({}, authHeader && { authorization: `Bearer ${authHeader}` }), publicKey && { ["X-API-Key" /* API_KEY */]: publicKey }), appId && { ["X-APP-ID" /* APP_ID */]: appId }), {
+          headers: __spreadProps(__spreadValues(__spreadValues(__spreadProps(__spreadValues(__spreadProps(__spreadValues({}, authHeader && { authorization: `Bearer ${authHeader}` }), {
+            ["X-API-Key" /* API_KEY */]: publicKey
+          }), appId && { ["X-APP-ID" /* APP_ID */]: appId }), {
             ["X-User-Agent" /* USER_AGENT */]: "@memberstack/client@1.2.0"
           }), data.contentType && { "Content-Type": data.contentType }), sessionToken && {
             ["X-Session-ID" /* SESSION_ID */]: sessionToken
@@ -527,8 +582,12 @@ var createRequestHandler = ({
         return res == null ? void 0 : res.data;
       } catch (e) {
         const error = e;
-        if (!error.response)
-          throw e;
+        if (!error.response) {
+          throw {
+            code: "network-error",
+            message: (error == null ? void 0 : error.message) || "Network request failed. Please check your internet connection."
+          };
+        }
         throw ((_g = (_f = error.response) == null ? void 0 : _f.data) == null ? void 0 : _g.error) || ((_h = error.response) == null ? void 0 : _h.data);
       }
     }),
@@ -543,7 +602,9 @@ var createRequestHandler = ({
           options == null ? void 0 : options.token
         ].find((x) => x);
         const formattedUrl = `${customEndpoint || endpoints.API}${url}`;
-        const fetchHeaders = __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, authHeader && { Authorization: `Bearer ${authHeader}` }), publicKey && { ["X-API-Key" /* API_KEY */]: publicKey }), appId && { ["X-APP-ID" /* APP_ID */]: appId }), {
+        const fetchHeaders = __spreadProps(__spreadValues(__spreadProps(__spreadValues({}, authHeader && { Authorization: `Bearer ${authHeader}` }), {
+          ["X-API-Key" /* API_KEY */]: publicKey
+        }), appId && { ["X-APP-ID" /* APP_ID */]: appId }), {
           ["X-User-Agent" /* USER_AGENT */]: "@memberstack/client@1.2.0",
           "Content-Type": "application/json",
           Referer: window.location.href
@@ -581,8 +642,13 @@ var createRequestHandler = ({
         }
         return result;
       } catch (e) {
-        console.error("Error in sendRequestWithFetch:", e);
-        throw e;
+        if (e && typeof e === "object" && "code" in e && "message" in e) {
+          throw e;
+        }
+        throw {
+          code: "network-error",
+          message: (e == null ? void 0 : e.message) || "Network request failed. Please check your internet connection."
+        };
       }
     })
   };
@@ -607,8 +673,12 @@ var createObservable = () => {
 };
 var observable = createObservable();
 var getPersistedMember = () => {
-  const stored = localStorage == null ? void 0 : localStorage.getItem("_ms-mem");
-  return stored ? JSON.parse(stored) : null;
+  try {
+    const stored = localStorage == null ? void 0 : localStorage.getItem("_ms-mem");
+    return stored ? JSON.parse(stored) : null;
+  } catch (e) {
+    return null;
+  }
 };
 var setPersistedMember = (member) => {
   if (member) {
@@ -634,8 +704,9 @@ var unsetPersistedMember = () => {
   removeSessionId();
   observable.notify(null);
 };
+var nextSubscriberId = 0;
 var onAuthChange = (cb) => {
-  const id = Math.floor(Math.random() * 1e3);
+  const id = nextSubscriberId++;
   observable.subscribe(id, cb);
   return {
     unsubscribe: () => observable.unsubscribe(id)
@@ -799,6 +870,8 @@ var initRequest = ({
      *   window.location.href = '/goodbye';
      * }
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     deleteMember() {
       return __async(this, null, function* () {
@@ -810,6 +883,15 @@ var initRequest = ({
         return data;
       });
     },
+    /**
+     * Sends a typing indicator to a comments channel.
+     * Used internally to show when a member is actively composing a post.
+     *
+     * @internal
+     * @param params - The typing indicator parameters
+     * @param params.channelKey - The key/identifier of the channel
+     * @returns Promise that resolves when the typing indicator is sent
+     */
     postIsTyping(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -821,6 +903,15 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Retrieves information about a comments channel.
+     * Returns channel metadata and configuration.
+     *
+     * @internal
+     * @param params - The channel info parameters
+     * @param params.channelKey - The key/identifier of the channel
+     * @returns Promise resolving to the channel information
+     */
     getChannelInfo(params) {
       return __async(this, null, function* () {
         const queryParams = new URLSearchParams({
@@ -832,6 +923,16 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Manages a member's notification subscription to a comments channel.
+     * Allows members to subscribe or unsubscribe from channel notifications.
+     *
+     * @internal
+     * @param params - The subscription parameters
+     * @param params.channelKey - The key/identifier of the channel
+     * @param params.action - The subscription action: 'NONE' to unsubscribe, 'THREADS_ONLY' to receive thread notifications
+     * @returns Promise that resolves when the subscription is updated
+     */
     subscribeToChannel(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -844,6 +945,27 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Retrieves posts from a comments channel.
+     * Use this to display comments or discussion threads on your site.
+     *
+     * @param params - Query parameters
+     * @param params.channelKey - The key identifying the channel to fetch posts from
+     * @param params.order - Sort order: 'newest' or 'oldest'
+     * @param params.after - Cursor for pagination (post ID to start after)
+     * @param params.limit - Maximum number of posts to return
+     * @returns Promise resolving to an array of posts
+     *
+     * @example
+     * ```typescript
+     * const { data } = await memberstack.getPosts({
+     *   channelKey: 'blog-comments',
+     *   order: 'newest',
+     *   limit: 20
+     * });
+     * data.posts.forEach(post => console.log(post.content));
+     * ```
+     */
     getPosts(params) {
       return __async(this, null, function* () {
         const queryParams = new URLSearchParams(__spreadValues(__spreadValues(__spreadValues({
@@ -861,6 +983,26 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Retrieves threads (replies) for a specific post.
+     *
+     * @param params - Query parameters
+     * @param params.postId - The ID of the parent post
+     * @param params.order - Sort order: 'newest' or 'oldest'
+     * @param params.after - Cursor for pagination (thread ID to start after)
+     * @param params.limit - Maximum number of threads to return
+     * @returns Promise resolving to an array of threads
+     *
+     * @example
+     * ```typescript
+     * const { data } = await memberstack.getThreads({
+     *   postId: 'post_abc123',
+     *   order: 'oldest',
+     *   limit: 50
+     * });
+     * data.threads.forEach(thread => console.log(thread.content));
+     * ```
+     */
     getThreads(params) {
       return __async(this, null, function* () {
         const queryParams = new URLSearchParams(__spreadValues(__spreadValues(__spreadValues({
@@ -878,6 +1020,23 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Creates a new post in a comments channel.
+     *
+     * @param params - Post data
+     * @param params.channelKey - The key of the channel to post in
+     * @param params.content - The content of the post (supports markdown)
+     * @returns Promise resolving to the created post
+     *
+     * @example
+     * ```typescript
+     * const { data: post } = await memberstack.createPost({
+     *   channelKey: 'blog-comments',
+     *   content: 'Great article! Thanks for sharing.'
+     * });
+     * console.log('Posted:', post.id);
+     * ```
+     */
     createPost(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -891,6 +1050,23 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Updates an existing post's content.
+     * Only the post author can update their post.
+     *
+     * @param params - Update data
+     * @param params.postId - The ID of the post to update
+     * @param params.content - The new content for the post
+     * @returns Promise resolving to the updated post
+     *
+     * @example
+     * ```typescript
+     * const { data: post } = await memberstack.updatePost({
+     *   postId: 'post_abc123',
+     *   content: 'Updated: Great article with corrections!'
+     * });
+     * ```
+     */
     updatePost(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -902,6 +1078,29 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Votes on a post (upvote, downvote, or remove vote).
+     *
+     * @param params - Vote data
+     * @param params.postId - The ID of the post to vote on
+     * @param params.vote - Vote type: 'UP', 'DOWN', or 'NONE' to remove vote
+     * @returns Promise resolving when the vote is recorded
+     *
+     * @example
+     * ```typescript
+     * // Upvote a post
+     * await memberstack.postVote({
+     *   postId: 'post_abc123',
+     *   vote: 'UP'
+     * });
+     *
+     * // Remove vote
+     * await memberstack.postVote({
+     *   postId: 'post_abc123',
+     *   vote: 'NONE'
+     * });
+     * ```
+     */
     postVote(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -913,6 +1112,21 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Deletes a post.
+     * Only the post author can delete their post.
+     *
+     * @param params - Delete parameters
+     * @param params.postId - The ID of the post to delete
+     * @returns Promise resolving when the post is deleted
+     *
+     * @example
+     * ```typescript
+     * await memberstack.deletePost({
+     *   postId: 'post_abc123'
+     * });
+     * ```
+     */
     deletePost(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -921,6 +1135,22 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Creates a reply thread on a post.
+     *
+     * @param params - Thread data
+     * @param params.postId - The ID of the post to reply to
+     * @param params.content - The content of the reply (supports markdown)
+     * @returns Promise resolving to the created thread
+     *
+     * @example
+     * ```typescript
+     * const { data: thread } = await memberstack.createThread({
+     *   postId: 'post_abc123',
+     *   content: 'I agree with this point!'
+     * });
+     * ```
+     */
     createThread(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -933,6 +1163,23 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Updates an existing thread's content.
+     * Only the thread author can update their thread.
+     *
+     * @param params - Update data
+     * @param params.threadId - The ID of the thread to update
+     * @param params.content - The new content for the thread
+     * @returns Promise resolving to the updated thread
+     *
+     * @example
+     * ```typescript
+     * const { data: thread } = await memberstack.updateThread({
+     *   threadId: 'thread_xyz789',
+     *   content: 'Updated reply with more details.'
+     * });
+     * ```
+     */
     updateThread(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -944,7 +1191,22 @@ var initRequest = ({
         });
       });
     },
-    // vote thread
+    /**
+     * Votes on a thread (upvote, downvote, or remove vote).
+     *
+     * @param params - Vote data
+     * @param params.threadId - The ID of the thread to vote on
+     * @param params.vote - Vote type: 'UP', 'DOWN', or 'NONE' to remove vote
+     * @returns Promise resolving when the vote is recorded
+     *
+     * @example
+     * ```typescript
+     * await memberstack.threadVote({
+     *   threadId: 'thread_xyz789',
+     *   vote: 'UP'
+     * });
+     * ```
+     */
     threadVote(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -956,6 +1218,21 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Deletes a thread.
+     * Only the thread author can delete their thread.
+     *
+     * @param params - Delete parameters
+     * @param params.threadId - The ID of the thread to delete
+     * @returns Promise resolving when the thread is deleted
+     *
+     * @example
+     * ```typescript
+     * await memberstack.deleteThread({
+     *   threadId: 'thread_xyz789'
+     * });
+     * ```
+     */
     deleteThread(params) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -977,8 +1254,10 @@ var initRequest = ({
      * const { data: content } = await memberstack.getSecureContent({
      *   contentId: 'cnt_abc123'
      * });
-     * document.getElementById('premium-content').innerHTML = content.html;
+     * document.getElementById('premium-content').innerHTML = content.content;
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Protected Content Documentation}
      */
     getSecureContent(params) {
       return __async(this, null, function* () {
@@ -1019,6 +1298,8 @@ var initRequest = ({
      *   plans: [{ planId: 'pln_free' }]
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     signupWithProvider(params) {
       return __async(this, null, function* () {
@@ -1069,6 +1350,8 @@ var initRequest = ({
      *   allowSignup: true
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     loginWithProvider(params) {
       return __async(this, null, function* () {
@@ -1101,6 +1384,8 @@ var initRequest = ({
      * });
      * // Member can now log in with either email/password or Google
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     connectProvider(params) {
       return __async(this, null, function* () {
@@ -1132,6 +1417,8 @@ var initRequest = ({
      * });
      * // Member must now use email/password or another connected provider
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     disconnectProvider(params) {
       return __async(this, null, function* () {
@@ -1144,6 +1431,16 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Retrieves both app configuration and current member data in a single request.
+     * Used internally for initial page load to efficiently fetch all required data.
+     * Also handles session tracking and conversion data.
+     *
+     * @internal
+     * @param params - Optional parameters
+     * @param params.trackPageView - Whether to track this as a page view for analytics (default: false)
+     * @returns Promise resolving to both app and member data
+     */
     getAppAndMember(params) {
       return __async(this, null, function* () {
         var _a2, _b;
@@ -1152,7 +1449,6 @@ var initRequest = ({
           url: `/app-member`,
           data: {
             data: {
-              // @ts-ignore
               includeSSOText: window == null ? void 0 : window.ssoUI,
               trackPageView: params == null ? void 0 : params.trackPageView,
               sessionData: __spreadValues({}, getConversionData())
@@ -1181,12 +1477,14 @@ var initRequest = ({
      * console.log('App name:', app.name);
      * console.log('OAuth providers:', app.authProviders);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/quick-start | Quick Start Documentation}
      */
     getApp() {
       return __async(this, null, function* () {
+        var _a2;
         const queryParams = new URLSearchParams({
-          // @ts-ignore
-          includeSSOText: window == null ? void 0 : window.ssoUI
+          includeSSOText: String((_a2 = window == null ? void 0 : window.ssoUI) != null ? _a2 : "")
         });
         return sendRequest({
           method: "GET" /* GET */,
@@ -1216,6 +1514,8 @@ var initRequest = ({
      *   console.error('Login failed:', error.message);
      * }
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     loginMemberEmailPassword(params, options) {
       return __async(this, null, function* () {
@@ -1253,6 +1553,8 @@ var initRequest = ({
      *
      * // Step 2: Complete login with the code (see loginMemberPasswordless)
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     sendMemberLoginPasswordlessEmail(params, options) {
       return __async(this, null, function* () {
@@ -1282,6 +1584,8 @@ var initRequest = ({
      *
      * // Step 2: Complete signup with the code (see signupMemberPasswordless)
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     sendMemberSignupPasswordlessEmail(params, options) {
       return __async(this, null, function* () {
@@ -1313,6 +1617,8 @@ var initRequest = ({
      * });
      * console.log('Logged in:', data.member.auth.email);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     loginMemberPasswordless(params, options) {
       return __async(this, null, function* () {
@@ -1347,6 +1653,8 @@ var initRequest = ({
      * console.log('Plan:', plan.name);
      * console.log('Prices:', plan.prices);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     getPlan(params) {
       return __async(this, null, function* () {
@@ -1385,6 +1693,8 @@ var initRequest = ({
      *   </div>
      * `).join('');
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     getPlans() {
       return __async(this, null, function* () {
@@ -1409,7 +1719,7 @@ var initRequest = ({
      *
      * groups.forEach(group => {
      *   console.log('Group:', group.name);
-     *   console.log('Required plans:', group.planIds);
+     *   console.log('Required plans:', group.plans.map(p => p.id));
      *   console.log('URLs:', group.urls);
      * });
      * ```
@@ -1456,6 +1766,8 @@ var initRequest = ({
      *   const hasPro = member.planConnections.some(p => p.planId === 'pln_pro');
      * }
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     getCurrentMember(options) {
       return __async(this, null, function* () {
@@ -1494,6 +1806,8 @@ var initRequest = ({
      * console.log('Preferences:', json.preferences);
      * console.log('Last visited:', json.lastVisitedPage);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member JSON Documentation}
      */
     getMemberJSON(options) {
       return __async(this, null, function* () {
@@ -1506,7 +1820,7 @@ var initRequest = ({
     },
     /**
      * Updates the current member's JSON data store.
-     * You can store any JSON-serializable data. Updates are merged with existing data.
+     * You can store any JSON-serializable data. This completely replaces the existing JSON.
      *
      * @param params - JSON data to store
      * @param params.json - Object containing the data to store
@@ -1532,6 +1846,8 @@ var initRequest = ({
      *   }
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member JSON Documentation}
      */
     updateMemberJSON(params, options) {
       return __async(this, null, function* () {
@@ -1560,10 +1876,13 @@ var initRequest = ({
      * });
      * console.log('Plan added, redirect:', data.redirect);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     addPlan(params, options) {
       return __async(this, null, function* () {
-        return sendRequest({
+        var _a2;
+        const result = yield sendRequest({
           method: "POST" /* POST */,
           url: `/member/plans/add`,
           data: {
@@ -1571,6 +1890,10 @@ var initRequest = ({
           },
           headers: addHeaders(options)
         });
+        if ((_a2 = result == null ? void 0 : result.data) == null ? void 0 : _a2.member) {
+          setPersistedMember(result.data.member);
+        }
+        return result;
       });
     },
     /**
@@ -1615,6 +1938,8 @@ var initRequest = ({
      *   cancelUrl: '/pricing'
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     purchasePlansWithCheckout(params, options) {
       return __async(this, null, function* () {
@@ -1683,6 +2008,8 @@ var initRequest = ({
      * });
      * console.log('Portal URL:', data.url);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     launchStripeCustomerPortal(params, options) {
       return __async(this, null, function* () {
@@ -1734,10 +2061,13 @@ var initRequest = ({
      * });
      * // Plan removed/subscription cancelled
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/plan-management | Plan Management Documentation}
      */
     removePlan(params, options) {
       return __async(this, null, function* () {
-        return sendRequest({
+        var _a2;
+        const result = yield sendRequest({
           method: "POST" /* POST */,
           url: `/member/plans/remove`,
           data: {
@@ -1745,6 +2075,10 @@ var initRequest = ({
           },
           headers: addHeaders(options)
         });
+        if ((_a2 = result == null ? void 0 : result.data) == null ? void 0 : _a2.member) {
+          setPersistedMember(result.data.member);
+        }
+        return result;
       });
     },
     /**
@@ -1775,6 +2109,8 @@ var initRequest = ({
      *   }
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     updateMember(params, options) {
       return __async(this, null, function* () {
@@ -1812,6 +2148,8 @@ var initRequest = ({
      *   newPassword: 'newSecurePassword123'
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     updateMemberAuth(params, options) {
       return __async(this, null, function* () {
@@ -1839,6 +2177,8 @@ var initRequest = ({
      * });
      * // Member can now log in with email/password
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     setPassword(params, options) {
       return __async(this, null, function* () {
@@ -1852,6 +2192,33 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Completes passwordless signup using the code sent via email.
+     * Creates a new member account without requiring a password.
+     *
+     * @param params - Signup details
+     * @param params.email - The new member's email address
+     * @param params.passwordlessToken - The one-time code from the signup email
+     * @param params.customFields - Optional custom field values defined in your Memberstack dashboard
+     * @param params.plans - Optional array of plan IDs to assign on signup (for free plans)
+     * @param params.metaData - Optional metadata to store with the member
+     * @returns Promise resolving to the new member data and tokens
+     * @throws When the code is invalid, expired, or email is already in use
+     *
+     * @example Complete passwordless signup flow
+     * ```typescript
+     * // Step 1: Send signup code (see sendMemberSignupPasswordlessEmail)
+     * // Step 2: User enters code, complete signup:
+     * const { data } = await memberstack.signupMemberPasswordless({
+     *   email: 'newuser@example.com',
+     *   passwordlessToken: '123456',
+     *   customFields: { firstName: 'Jane' }
+     * });
+     * console.log('Welcome!', data.member.id);
+     * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
+     */
     signupMemberPasswordless(params, options) {
       return __async(this, null, function* () {
         var _a2, _b, _c;
@@ -1872,9 +2239,7 @@ var initRequest = ({
             options
           }), ((_b = window.Rewardful) == null ? void 0 : _b.referral) && {
             rewardfulData: {
-              // @ts-ignore
               referral: window.Rewardful.referral,
-              // @ts-ignore
               coupon: (_c = window.Rewardful.coupon) == null ? void 0 : _c.id
             }
           })
@@ -1921,6 +2286,8 @@ var initRequest = ({
      *   plans: [{ planId: 'pln_free_tier' }]
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Signup Documentation}
      */
     signupMemberEmailPassword(params, options) {
       return __async(this, null, function* () {
@@ -1944,9 +2311,7 @@ var initRequest = ({
             options
           }), ((_b = window.Rewardful) == null ? void 0 : _b.referral) && {
             rewardfulData: {
-              // @ts-ignore
               referral: window.Rewardful.referral,
-              // @ts-ignore
               coupon: (_c = window.Rewardful.coupon) == null ? void 0 : _c.id
             }
           })
@@ -1957,6 +2322,25 @@ var initRequest = ({
         return data;
       });
     },
+    /**
+     * Joins a team using an invite token.
+     * The invite token is typically sent by a team admin via email.
+     *
+     * @param params - Join parameters
+     * @param params.inviteToken - The invite token received from the team admin
+     * @returns Promise resolving when the member has joined the team
+     *
+     * @example
+     * ```typescript
+     * // Extract token from URL (e.g., /join?token=abc123)
+     * const token = new URLSearchParams(window.location.search).get('token');
+     *
+     * await memberstack.joinTeam({
+     *   inviteToken: token
+     * });
+     * console.log('Successfully joined the team!');
+     * ```
+     */
     joinTeam(params, options) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -1969,6 +2353,21 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Retrieves information about a team the current member belongs to.
+     *
+     * @param params - Team parameters
+     * @param params.teamId - The ID of the team to retrieve
+     * @returns Promise resolving to the team details
+     *
+     * @example
+     * ```typescript
+     * const team = await memberstack.getTeam({
+     *   teamId: 'team_abc123'
+     * });
+     * console.log('Team members:', team);
+     * ```
+     */
     getTeam(params, options) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -1978,6 +2377,24 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Removes a member from a team.
+     * Only team admins can remove other members.
+     *
+     * @param params - Removal parameters
+     * @param params.teamId - The ID of the team
+     * @param params.memberId - The ID of the member to remove
+     * @returns Promise resolving when the member has been removed
+     *
+     * @example
+     * ```typescript
+     * await memberstack.removeMemberFromTeam({
+     *   teamId: 'team_abc123',
+     *   memberId: 'mem_xyz789'
+     * });
+     * console.log('Member removed from team');
+     * ```
+     */
     removeMemberFromTeam(params, options) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -1991,6 +2408,23 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Generates an invite token for a team.
+     * The token can be shared with users to invite them to join the team.
+     *
+     * @param params - Token parameters
+     * @param params.teamId - The ID of the team to generate an invite for
+     * @returns Promise resolving to the generated invite token
+     *
+     * @example
+     * ```typescript
+     * const invite = await memberstack.generateInviteToken({
+     *   teamId: 'team_abc123'
+     * });
+     * // Share the invite link with new team members
+     * const inviteUrl = `${window.location.origin}/join?token=${invite.token}`;
+     * ```
+     */
     generateInviteToken(params, options) {
       return __async(this, null, function* () {
         return sendRequest({
@@ -2004,12 +2438,12 @@ var initRequest = ({
       });
     },
     /**
-     * Uploads a new profile image for the current member.
-     * Accepts a File object (from an input element) or a Blob.
+     * Updates or removes the current member's profile image.
+     * Pass a File to upload a new image, or null to remove the existing image.
      *
      * @param params - Image parameters
-     * @param params.profileImage - The image file to upload
-     * @returns Promise resolving to the new profile image URL
+     * @param params.profileImage - The image file to upload, or null to remove
+     * @returns Promise resolving to the new profile image URL (or null if removed)
      *
      * @example Upload from file input
      * ```typescript
@@ -2021,11 +2455,24 @@ var initRequest = ({
      * });
      * console.log('New image URL:', data.profileImage);
      * ```
+     *
+     * @example Remove profile image
+     * ```typescript
+     * const { data } = await memberstack.updateMemberProfileImage({
+     *   profileImage: null
+     * });
+     * console.log('Image removed:', data.profileImage === null);
+     * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
      */
     updateMemberProfileImage(params) {
       return __async(this, null, function* () {
-        if (!params.profileImage) {
-          throw new Error("profileImage is required");
+        if (params.profileImage === null) {
+          return sendRequest({
+            method: "DELETE" /* DELETE */,
+            url: `/member/profile-image`
+          });
         }
         const formData = new FormData();
         formData.append("profileImage", params.profileImage);
@@ -2037,6 +2484,28 @@ var initRequest = ({
         });
       });
     },
+    /**
+     * Removes the current member's profile image.
+     * After deletion, the member's profileImage field will be null.
+     *
+     * @returns Promise resolving to confirmation that the image was removed
+     *
+     * @example
+     * ```typescript
+     * await memberstack.deleteMemberProfileImage();
+     * console.log('Profile image removed');
+     * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Profile Documentation}
+     */
+    deleteMemberProfileImage() {
+      return __async(this, null, function* () {
+        return sendRequest({
+          method: "DELETE" /* DELETE */,
+          url: `/member/profile-image`
+        });
+      });
+    },
     /**
      * Sends a verification email to the current member.
      * Use this when email verification is enabled in your Memberstack settings.
@@ -2048,6 +2517,8 @@ var initRequest = ({
      * await memberstack.sendMemberVerificationEmail();
      * // Show message: "Verification email sent! Check your inbox."
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Member Verification Documentation}
      */
     sendMemberVerificationEmail() {
       return __async(this, null, function* () {
@@ -2076,6 +2547,8 @@ var initRequest = ({
      * });
      * // Show confirmation: "Check your email for reset instructions"
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Password Reset Documentation}
      */
     sendMemberResetPasswordEmail(params) {
       return __async(this, null, function* () {
@@ -2109,6 +2582,8 @@ var initRequest = ({
      * });
      * // Password updated, redirect to login
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Password Reset Documentation}
      */
     resetMemberPassword(params) {
       return __async(this, null, function* () {
@@ -2142,6 +2617,8 @@ var initRequest = ({
      *   window.location.href = data.redirect;
      * }
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/core-authentication | Authentication Documentation}
      */
     logout(options) {
       return __async(this, null, function* () {
@@ -2163,11 +2640,13 @@ var initRequest = ({
      *
      * @example
      * ```typescript
-     * const { data: tables } = await memberstack.getDataTables();
-     * tables.forEach(table => {
+     * const { data } = await memberstack.getDataTables();
+     * data.tables.forEach(table => {
      *   console.log('Table:', table.name, table.key);
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     getDataTables(options) {
       return __async(this, null, function* () {
@@ -2190,14 +2669,15 @@ var initRequest = ({
      * const { data: table } = await memberstack.getDataTable({
      *   table: 'posts'
      * });
-     * console.log('Columns:', table.columns);
+     * console.log('Fields:', table.fields.map(f => f.name));
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     getDataTable(params, options) {
       return __async(this, null, function* () {
         return sendRequest({
           method: "GET" /* GET */,
-          //@ts-ignore
           url: `/v1/data-tables/${params.table || params.tableKey}`,
           headers: addHeaders(options)
         });
@@ -2226,6 +2706,8 @@ var initRequest = ({
      * });
      * console.log('Records:', data.records);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     getDataRecords(params, options) {
       return __async(this, null, function* () {
@@ -2251,7 +2733,6 @@ var initRequest = ({
           method: "POST" /* POST */,
           url: `/v1/data-records/query`,
           data: {
-            // @ts-ignore
             table: params.table || params.tableKey,
             query: {
               findMany: query
@@ -2290,6 +2771,8 @@ var initRequest = ({
      * });
      * console.log('Created record:', record.id);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     createDataRecord(params, options) {
       return __async(this, null, function* () {
@@ -2320,6 +2803,8 @@ var initRequest = ({
      * });
      * console.log('Post:', record.title);
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     getDataRecord(params, options) {
       return __async(this, null, function* () {
@@ -2361,6 +2846,8 @@ var initRequest = ({
      *   }
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     updateDataRecord(params, options) {
       return __async(this, null, function* () {
@@ -2387,6 +2874,8 @@ var initRequest = ({
      *   recordId: 'rec_abc123'
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     deleteDataRecord(params, options) {
       return __async(this, null, function* () {
@@ -2432,6 +2921,8 @@ var initRequest = ({
      *   }
      * });
      * ```
+     *
+     * @see {@link https://developers.memberstack.com/dom-package/member-journey | Data Tables Documentation}
      */
     queryDataRecords(params, options) {
       return __async(this, null, function* () {
@@ -2439,7 +2930,7 @@ var initRequest = ({
           method: "POST" /* POST */,
           url: `/v1/data-records/query`,
           data: {
-            table: params.table,
+            table: params.table || params.tableKey,
             query: {
               findMany: params.query
             }
@@ -2461,6 +2952,9 @@ function setDebugMode(enabled) {
       "color: #6366f1; font-weight: bold;"
     );
   }
+  if (!enabled && typeof window !== "undefined") {
+    delete window.__MEMBERSTACK_DEBUG__;
+  }
 }
 function debugLog(message, ...args) {
   if (debugEnabled) {
@@ -2479,8 +2973,8 @@ function initDevToolsIntegration(state) {
         publicKey: state.config.publicKey,
         appId: state.config.appId
       },
-      getMember: () => state.member,
-      isAuthenticated: () => state.member !== null,
+      getMember: state.getMember,
+      isAuthenticated: () => state.getMember() !== null,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
     debugLog("DevTools integration initialized. Access via window.__MEMBERSTACK_DEBUG__");
@@ -2489,6 +2983,7 @@ function initDevToolsIntegration(state) {
 
 // src/methods/index.ts
 var SDK_VERSION = "1.2.0";
+var initialized = false;
 var captchaReadyPromise = new Promise((resolve) => {
   if (typeof window !== "undefined") {
     window._hcaptchaReady = resolve;
@@ -2506,6 +3001,16 @@ var methods = {
   _captchaReady: captchaReadyPromise
 };
 function init(props) {
+  if (!props.publicKey) {
+    throw new Error(
+      "Memberstack: publicKey is required. Pass your public key to init({ publicKey: 'pk_...' }). Find your key at https://app.memberstack.com/apps"
+    );
+  }
+  if (!props.publicKey.startsWith("pk_")) {
+    throw new Error(
+      `Memberstack: Invalid publicKey format. Keys should start with "pk_sb_" (sandbox) or "pk_" (live). Received: "${props.publicKey.slice(0, 12)}...". Find your key at https://app.memberstack.com/apps`
+    );
+  }
   if (props.debug) {
     setDebugMode(true);
     debugLog(`Initializing Memberstack SDK v${SDK_VERSION}`);
@@ -2516,6 +3021,17 @@ function init(props) {
       domain: props.domain
     });
   }
+  if (initialized && props.debug) {
+    console.warn(
+      "[Memberstack] init() called multiple times. Previous instance will be replaced. This is usually unintentional \u2014 call init() once at app startup."
+    );
+  }
+  if (props.sessionDurationDays !== void 0) {
+    console.warn(
+      "[Memberstack] sessionDurationDays is deprecated and no longer used. Session duration is now controlled server-side. You can safely remove this option."
+    );
+  }
+  initialized = true;
   const apiDomain2 = props.domain || endpoints.API || "https://client.memberstack.com";
   setApiDomain(apiDomain2);
   if (props.useCookies)
@@ -2527,14 +3043,13 @@ function init(props) {
     token: getMemberToken(),
     domain: apiDomain2
   });
-  const allMethods = Object.assign(methods, requests);
+  const allMethods = Object.assign(methods, requests, { destroy });
   if (typeof window !== "undefined") {
     window.$memberstackDom = allMethods;
     if (props.debug) {
       initDevToolsIntegration({
         config: { publicKey: props.publicKey, appId: props.appId },
-        member: null,
-        // Will be updated by auth state
+        getMember: () => getPersistedMember(),
         version: SDK_VERSION
       });
     }
@@ -2544,6 +3059,14 @@ function init(props) {
   }
   return allMethods;
 }
+function destroy() {
+  unsetPersistedMember();
+  initialized = false;
+  if (typeof window !== "undefined") {
+    delete window.$memberstackDom;
+    delete window.__MEMBERSTACK_DEBUG__;
+  }
+}
 var methods_default = { init: (props) => init(props) };
 
 // src/utils/errors.ts
@@ -2895,10 +3418,266 @@ var ErrorMetadata = {
       "Clear your browser cache and try again"
     ],
     docsUrl: "https://docs.memberstack.com/dom/authentication"
+  },
+  // Authentication — additional
+  [ErrorCodes.MEMBER_NOT_FOUND]: {
+    message: "No member found with this identifier.",
+    category: "authentication",
+    suggestions: [
+      "Verify the email address is correct",
+      "The member may not have signed up yet \u2014 use signupMemberEmailPassword()",
+      "Check if the member exists in the correct environment (SANDBOX vs LIVE)"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/login"
+  },
+  // Account & Social Login — additional
+  [ErrorCodes.ACCOUNT_NOT_FOUND]: {
+    message: "No account found with these credentials.",
+    category: "authentication",
+    suggestions: [
+      "The member may need to sign up first",
+      "Check if the account was created with a different auth method (email vs social)",
+      "Verify the correct environment (SANDBOX vs LIVE)"
+    ]
+  },
+  [ErrorCodes.ACCOUNT_ALREADY_CONNECTED]: {
+    message: "This social account is already connected.",
+    category: "conflict",
+    suggestions: [
+      "Use disconnectProvider() first if you need to reconnect",
+      "Check the member's connected providers with getCurrentMember()"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/social-login"
+  },
+  [ErrorCodes.ACCOUNT_NOT_CONNECTED]: {
+    message: "This social account is not connected to the member.",
+    category: "not_found",
+    suggestions: [
+      "Use connectProvider() to connect the social account first",
+      "Check the member's connected providers with getCurrentMember()"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/social-login"
+  },
+  [ErrorCodes.ACCOUNT_CONNECT_FAILED]: {
+    message: "Failed to connect the social account.",
+    category: "authentication",
+    suggestions: [
+      "Try the connection again \u2014 this may be a temporary issue",
+      "Ensure the social provider is enabled in your Memberstack dashboard",
+      "Check that the OAuth redirect URLs are configured correctly"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/social-login"
+  },
+  [ErrorCodes.ACCOUNT_CONNECT_REQUIRES_LOGIN]: {
+    message: "You must be logged in to connect a social account.",
+    category: "authentication",
+    suggestions: [
+      "Call loginMemberEmailPassword() or loginWithProvider() first",
+      "Use getCurrentMember() to verify the member is authenticated"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/social-login"
+  },
+  [ErrorCodes.ACCOUNT_SET_PASSWORD_FIRST]: {
+    message: "Set a password before disconnecting your last login provider.",
+    category: "authentication",
+    suggestions: [
+      "Use setPassword() to add a password before disconnecting",
+      "This prevents the member from being locked out of their account"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/authentication/social-login"
+  },
+  // Validation — additional
+  [ErrorCodes.INVALID_PASSWORD]: {
+    message: "The password is incorrect.",
+    category: "authentication",
+    suggestions: [
+      "Check that the current password is entered correctly",
+      "Use sendMemberResetPasswordEmail() to reset the password"
+    ]
+  },
+  [ErrorCodes.REQUIRED_FIELD_MISSING]: {
+    message: "A required field is missing.",
+    category: "validation",
+    suggestions: [
+      "Check that all required parameters are provided",
+      "Review the method documentation for required fields",
+      "Custom fields marked as required in the dashboard must be included on signup"
+    ]
+  },
+  [ErrorCodes.INVALID_CAPTCHA]: {
+    message: "CAPTCHA verification failed.",
+    category: "validation",
+    suggestions: [
+      "Ensure the CAPTCHA token is passed as captchaToken in the request",
+      "The token may have expired \u2014 request a new CAPTCHA challenge",
+      "Check that CAPTCHA is correctly configured in your Memberstack dashboard"
+    ]
+  },
+  // Plans — additional
+  [ErrorCodes.NO_PLAN_FOUND]: {
+    message: "The member does not have this plan.",
+    category: "not_found",
+    suggestions: [
+      "Use getCurrentMember() to check the member's current plans",
+      "Verify the plan ID is correct",
+      "The plan may have been removed or expired"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/plans"
+  },
+  [ErrorCodes.PLAN_MEMBER_LIMIT_REACHED]: {
+    message: "This plan has reached its member limit.",
+    category: "limit",
+    suggestions: [
+      "Contact the app owner to increase the plan's member limit",
+      "Check if a different plan is available"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/plans"
+  },
+  [ErrorCodes.PLAN_RESTRICTED_TO_ADMIN]: {
+    message: "This plan can only be assigned by an admin.",
+    category: "authorization",
+    suggestions: [
+      "Plans with this restriction cannot be self-assigned by members",
+      "Use the Admin API or dashboard to assign this plan"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/plans"
+  },
+  [ErrorCodes.DOMAIN_NOT_PERMITTED]: {
+    message: "Your email domain is not permitted for this plan.",
+    category: "authorization",
+    suggestions: [
+      "This plan restricts signup to specific email domains",
+      "Check the plan's domain restrictions in your Memberstack dashboard",
+      "Use an email address with an allowed domain"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/plans"
+  },
+  [ErrorCodes.PRICE_NOT_AVAILABLE]: {
+    message: "This pricing option is no longer available.",
+    category: "not_found",
+    suggestions: [
+      "Use getPlans() to see currently available pricing options",
+      "The price may have been archived or deactivated",
+      "Check your Stripe dashboard for the price status"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/payments"
+  },
+  // Teams — additional
+  [ErrorCodes.ONE_ACTIVE_TEAM_ONLY]: {
+    message: "A member can only belong to one active team.",
+    category: "conflict",
+    suggestions: [
+      "Remove the member from their current team first using removeMemberFromTeam()",
+      "Check the member's current team with getTeam()"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/teams"
+  },
+  [ErrorCodes.CANNOT_CHANGE_TEAM]: {
+    message: "Cannot change team while it has active members.",
+    category: "conflict",
+    suggestions: [
+      "Remove all team members before making this change",
+      "Use removeMemberFromTeam() to remove members first"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/teams"
+  },
+  // Data Tables — additional
+  [ErrorCodes.INVALID_TABLE_KEY]: {
+    message: "The table key format is invalid.",
+    category: "data_tables",
+    suggestions: [
+      "Table keys should be lowercase alphanumeric with hyphens",
+      "Use getDataTables() to list available tables and their keys",
+      "Check the table key in your Memberstack dashboard"
+    ],
+    docsUrl: "https://docs.memberstack.com/data-tables"
+  },
+  [ErrorCodes.UNIQUE_CONSTRAINT_VIOLATION]: {
+    message: "A record with this value already exists (unique constraint).",
+    category: "data_tables",
+    suggestions: [
+      "The field has a unique constraint \u2014 use a different value",
+      "Use queryDataRecords() to check for existing records before creating",
+      "If updating, use updateDataRecord() instead of createDataRecord()"
+    ],
+    docsUrl: "https://docs.memberstack.com/data-tables"
+  },
+  [ErrorCodes.FIELD_LIMIT_EXCEEDED]: {
+    message: "Maximum number of fields reached for this table.",
+    category: "data_tables",
+    suggestions: [
+      "Remove unused fields before adding new ones",
+      "Consider using a separate table for additional data",
+      "Check your plan's field limits in the dashboard"
+    ],
+    docsUrl: "https://docs.memberstack.com/data-tables"
+  },
+  [ErrorCodes.INVALID_FIELD_TYPE]: {
+    message: "This field type is not supported.",
+    category: "data_tables",
+    suggestions: [
+      "Check the supported field types in the documentation",
+      "Use getDataTable() to see the table schema and field types"
+    ],
+    docsUrl: "https://docs.memberstack.com/data-tables"
+  },
+  [ErrorCodes.INVALID_FIELD_VALUE]: {
+    message: "The field value does not match the expected type.",
+    category: "data_tables",
+    suggestions: [
+      "Check the field type \u2014 e.g., number fields require numeric values",
+      "Use getDataTable() to see the expected field types",
+      "Ensure dates are in ISO 8601 format for date fields"
+    ],
+    docsUrl: "https://docs.memberstack.com/data-tables"
+  },
+  // Permissions
+  [ErrorCodes.ACCESS_DENIED]: {
+    message: "You do not have permission to access this resource.",
+    category: "authorization",
+    suggestions: [
+      "Check that the member has the required plan or permissions",
+      "Verify the content group configuration in the dashboard",
+      "Use getCurrentMember() to check the member's permissions array"
+    ],
+    docsUrl: "https://docs.memberstack.com/dom/content-protection"
+  },
+  // Catch-all
+  [ErrorCodes.UNKNOWN_ERROR]: {
+    message: "An unexpected error occurred.",
+    category: "unknown",
+    suggestions: [
+      "Try the request again",
+      "Check the Memberstack status page for any ongoing issues",
+      "If the problem persists, contact support with the error details"
+    ]
   }
 };
+function normalizeErrorCode(code) {
+  return code.toLowerCase().replace(/_/g, "-");
+}
+function getMetadataForCode(code) {
+  if (ErrorMetadata[code]) {
+    return ErrorMetadata[code];
+  }
+  const normalized = normalizeErrorCode(code);
+  for (const key of Object.keys(ErrorMetadata)) {
+    if (normalizeErrorCode(key) === normalized) {
+      return ErrorMetadata[key];
+    }
+  }
+  return void 0;
+}
+var knownErrorCodes = new Set(Object.values(ErrorCodes));
 function isMemberstackError(error) {
-  return typeof error === "object" && error !== null && "code" in error && "message" in error && typeof error.code === "string" && typeof error.message === "string";
+  if (typeof error !== "object" || error === null || !("code" in error) || !("message" in error) || typeof error.code !== "string" || typeof error.message !== "string") {
+    return false;
+  }
+  const code = error.code;
+  if (knownErrorCodes.has(code) || knownErrorCodes.has(normalizeErrorCode(code))) {
+    return true;
+  }
+  return code.includes("-") || code.includes("/");
 }
 function getErrorMessage(error, defaultMessage = "An unexpected error occurred") {
   if (isMemberstackError(error)) {
@@ -2934,7 +3713,7 @@ function getErrorSuggestions(error) {
   if (error.suggestions && error.suggestions.length > 0) {
     return error.suggestions;
   }
-  const metadata = ErrorMetadata[error.code];
+  const metadata = getMetadataForCode(error.code);
   return (metadata == null ? void 0 : metadata.suggestions) || [];
 }
 function getErrorDocsUrl(error) {
@@ -2944,7 +3723,7 @@ function getErrorDocsUrl(error) {
   if (error.docsUrl) {
     return error.docsUrl;
   }
-  const metadata = ErrorMetadata[error.code];
+  const metadata = getMetadataForCode(error.code);
   return metadata == null ? void 0 : metadata.docsUrl;
 }
 function getErrorCategory(error) {
@@ -2954,18 +3733,18 @@ function getErrorCategory(error) {
   if (error.category) {
     return error.category;
   }
-  const metadata = ErrorMetadata[error.code];
+  const metadata = getMetadataForCode(error.code);
   return (metadata == null ? void 0 : metadata.category) || "unknown";
 }
 function formatErrorForUser(error) {
   if (!isMemberstackError(error)) {
     return "An unexpected error occurred. Please try again.";
   }
-  const metadata = ErrorMetadata[error.code];
+  const metadata = getMetadataForCode(error.code);
   if (metadata) {
     return metadata.message;
   }
-  return error.message;
+  return "Something went wrong. Please try again or contact support.";
 }
 function getErrorReport(error) {
   if (!isMemberstackError(error)) {