@dream-api/sdk 0.1.33 → 0.1.35

package/dist/index.d.mts

@@ -325,6 +325,28 @@ declare class AuthHelpers {
     getCustomerPortalUrl(options?: {
         returnUrl?: string;
     }): string;
+    /**
+     * Get the refresh URL for updating JWT after plan changes.
+     *
+     * Use this as Stripe's success_url to ensure the JWT is refreshed
+     * with updated plan metadata after checkout completes.
+     *
+     * @example
+     * ```typescript
+     * const refreshUrl = api.auth.getRefreshUrl({ redirect: '/dashboard' });
+     * // Use as Stripe success_url
+     * await api.billing.createCheckout({
+     *   tier: 'pro',
+     *   successUrl: refreshUrl,
+     * });
+     * ```
+     */
+    getRefreshUrl(options: AuthUrlOptions): string;
+    /**
+     * Convert a relative path to an absolute URL using current origin.
+     * Already-absolute URLs are returned unchanged.
+     */
+    private makeAbsoluteUrl;
 }
 
 /**

package/dist/index.d.ts

@@ -325,6 +325,28 @@ declare class AuthHelpers {
     getCustomerPortalUrl(options?: {
         returnUrl?: string;
     }): string;
+    /**
+     * Get the refresh URL for updating JWT after plan changes.
+     *
+     * Use this as Stripe's success_url to ensure the JWT is refreshed
+     * with updated plan metadata after checkout completes.
+     *
+     * @example
+     * ```typescript
+     * const refreshUrl = api.auth.getRefreshUrl({ redirect: '/dashboard' });
+     * // Use as Stripe success_url
+     * await api.billing.createCheckout({
+     *   tier: 'pro',
+     *   successUrl: refreshUrl,
+     * });
+     * ```
+     */
+    getRefreshUrl(options: AuthUrlOptions): string;
+    /**
+     * Convert a relative path to an absolute URL using current origin.
+     * Already-absolute URLs are returned unchanged.
+     */
+    private makeAbsoluteUrl;
 }
 
 /**

package/dist/index.js

@@ -478,9 +478,10 @@ var AuthHelpers = class {
       throw new Error("DreamAPI: publishableKey required for auth URLs");
     }
     const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
     const params = new URLSearchParams({
       pk,
-      redirect: options.redirect
+      redirect: redirectUrl
     });
     return `${baseUrl}/signup?${params.toString()}`;
   }
@@ -502,9 +503,10 @@ var AuthHelpers = class {
       throw new Error("DreamAPI: publishableKey required for auth URLs");
     }
     const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
     const params = new URLSearchParams({
       pk,
-      redirect: options.redirect
+      redirect: redirectUrl
     });
     return `${baseUrl}/signin?${params.toString()}`;
   }
@@ -530,12 +532,55 @@ var AuthHelpers = class {
     }
     const baseUrl = this.client.getSignupBaseUrl();
     const returnUrl = options?.returnUrl || (typeof window !== "undefined" ? window.location.href : "/");
+    const redirectUrl = this.makeAbsoluteUrl(returnUrl);
     const params = new URLSearchParams({
       pk,
-      redirect: returnUrl
+      redirect: redirectUrl
     });
     return `${baseUrl}/account?${params.toString()}`;
   }
+  /**
+   * Get the refresh URL for updating JWT after plan changes.
+   *
+   * Use this as Stripe's success_url to ensure the JWT is refreshed
+   * with updated plan metadata after checkout completes.
+   *
+   * @example
+   * ```typescript
+   * const refreshUrl = api.auth.getRefreshUrl({ redirect: '/dashboard' });
+   * // Use as Stripe success_url
+   * await api.billing.createCheckout({
+   *   tier: 'pro',
+   *   successUrl: refreshUrl,
+   * });
+   * ```
+   */
+  getRefreshUrl(options) {
+    const pk = this.client.getPublishableKey();
+    if (!pk) {
+      throw new Error("DreamAPI: publishableKey required for auth URLs");
+    }
+    const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
+    const params = new URLSearchParams({
+      pk,
+      redirect: redirectUrl
+    });
+    return `${baseUrl}/refresh?${params.toString()}`;
+  }
+  /**
+   * Convert a relative path to an absolute URL using current origin.
+   * Already-absolute URLs are returned unchanged.
+   */
+  makeAbsoluteUrl(path) {
+    if (path.startsWith("http://") || path.startsWith("https://")) {
+      return path;
+    }
+    if (typeof window !== "undefined") {
+      return new URL(path, window.location.origin).toString();
+    }
+    return path;
+  }
 };
 
 // src/index.ts

package/dist/index.mjs

@@ -450,9 +450,10 @@ var AuthHelpers = class {
       throw new Error("DreamAPI: publishableKey required for auth URLs");
     }
     const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
     const params = new URLSearchParams({
       pk,
-      redirect: options.redirect
+      redirect: redirectUrl
     });
     return `${baseUrl}/signup?${params.toString()}`;
   }
@@ -474,9 +475,10 @@ var AuthHelpers = class {
       throw new Error("DreamAPI: publishableKey required for auth URLs");
     }
     const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
     const params = new URLSearchParams({
       pk,
-      redirect: options.redirect
+      redirect: redirectUrl
     });
     return `${baseUrl}/signin?${params.toString()}`;
   }
@@ -502,12 +504,55 @@ var AuthHelpers = class {
     }
     const baseUrl = this.client.getSignupBaseUrl();
     const returnUrl = options?.returnUrl || (typeof window !== "undefined" ? window.location.href : "/");
+    const redirectUrl = this.makeAbsoluteUrl(returnUrl);
     const params = new URLSearchParams({
       pk,
-      redirect: returnUrl
+      redirect: redirectUrl
     });
     return `${baseUrl}/account?${params.toString()}`;
   }
+  /**
+   * Get the refresh URL for updating JWT after plan changes.
+   *
+   * Use this as Stripe's success_url to ensure the JWT is refreshed
+   * with updated plan metadata after checkout completes.
+   *
+   * @example
+   * ```typescript
+   * const refreshUrl = api.auth.getRefreshUrl({ redirect: '/dashboard' });
+   * // Use as Stripe success_url
+   * await api.billing.createCheckout({
+   *   tier: 'pro',
+   *   successUrl: refreshUrl,
+   * });
+   * ```
+   */
+  getRefreshUrl(options) {
+    const pk = this.client.getPublishableKey();
+    if (!pk) {
+      throw new Error("DreamAPI: publishableKey required for auth URLs");
+    }
+    const baseUrl = this.client.getSignupBaseUrl();
+    const redirectUrl = this.makeAbsoluteUrl(options.redirect);
+    const params = new URLSearchParams({
+      pk,
+      redirect: redirectUrl
+    });
+    return `${baseUrl}/refresh?${params.toString()}`;
+  }
+  /**
+   * Convert a relative path to an absolute URL using current origin.
+   * Already-absolute URLs are returned unchanged.
+   */
+  makeAbsoluteUrl(path) {
+    if (path.startsWith("http://") || path.startsWith("https://")) {
+      return path;
+    }
+    if (typeof window !== "undefined") {
+      return new URL(path, window.location.origin).toString();
+    }
+    return path;
+  }
 };
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dream-api/sdk",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Official SDK for Dream API - Auth, billing, and usage tracking in one API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",