@reauth-dev/sdk 0.2.0 → 0.3.0

package/dist/index.js

@@ -160,6 +160,126 @@ function createReauthClient(config) {
       }
     },
     // ========================================================================
+    // Headless Auth Methods
+    // ========================================================================
+    /**
+     * Get the domain's public auth configuration.
+     * Returns enabled auth methods and whether headless auth is available.
+     */
+    async getConfig() {
+      const res = await fetch(`${baseUrl}/config`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to get config: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        domain: data.domain,
+        authMethods: {
+          magicLink: data.auth_methods.magic_link,
+          googleOauth: data.auth_methods.google_oauth,
+          twitterOauth: data.auth_methods.twitter_oauth
+        },
+        redirectUrl: data.redirect_url,
+        headlessEnabled: data.headless_enabled
+      };
+    },
+    /**
+     * Request a magic link email for headless authentication.
+     * When callbackUrl is provided, the email link will point to your custom URL
+     * with the token as a query parameter.
+     * @param opts Options including email and optional callbackUrl
+     */
+    async requestMagicLink(opts) {
+      const body = { email: opts.email };
+      if (opts.callbackUrl) {
+        body.callback_url = opts.callbackUrl;
+      }
+      const res = await fetch(`${baseUrl}/auth/request-magic-link`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify(body)
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to request magic link: ${res.status}`);
+      }
+    },
+    /**
+     * Verify a magic link token received from the email callback URL.
+     * On success, session cookies are set automatically.
+     * @param opts Options including the token from the callback URL
+     */
+    async verifyMagicLink(opts) {
+      const res = await fetch(`${baseUrl}/auth/verify-magic-link`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ token: opts.token })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to verify magic link: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        success: data.success,
+        redirectUrl: data.redirect_url,
+        endUserId: data.end_user_id,
+        email: data.email,
+        waitlistPosition: data.waitlist_position
+      };
+    },
+    /**
+     * Start a Google OAuth flow for headless authentication.
+     * Returns the Google authorization URL to redirect the user to.
+     * After Google authentication, the portal handles the callback and
+     * redirects to the domain's configured redirect_url.
+     */
+    async startGoogleOAuth() {
+      const res = await fetch(`${baseUrl}/auth/google/start`, {
+        method: "POST",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to start Google OAuth: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        authUrl: data.auth_url,
+        state: data.state
+      };
+    },
+    /**
+     * Start an X (Twitter) OAuth flow for headless authentication.
+     * Returns the X authorization URL to redirect the user to.
+     * After X authentication, the portal handles the callback and
+     * redirects to the domain's configured redirect_url.
+     */
+    async startTwitterOAuth() {
+      const res = await fetch(`${baseUrl}/auth/twitter/start`, {
+        method: "POST",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to start Twitter OAuth: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        authUrl: data.auth_url,
+        state: data.state
+      };
+    },
+    // ========================================================================
     // Billing Methods
     // ========================================================================
     /**
@@ -354,9 +474,595 @@ function createReauthClient(config) {
           })
         )
       };
+    },
+    // ========================================================================
+    // Credits Methods
+    // ========================================================================
+    /**
+     * Get the domain's credits configuration.
+     * Returns exchange rate, display settings, and purchase limits.
+     */
+    async getCreditsConfig() {
+      const res = await fetch(`${baseUrl}/billing/credits-config`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        throw new Error(`Failed to get credits config: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        creditsEnabled: data.credits_enabled,
+        creditsPerDollar: data.credits_per_dollar,
+        displayName: data.display_name,
+        displaySymbol: data.display_symbol,
+        displaySymbolPosition: data.display_symbol_position,
+        displayDecimals: data.display_decimals,
+        minPurchaseCents: data.min_purchase_cents,
+        maxPurchaseCents: data.max_purchase_cents,
+        manualTopUpAvailable: data.manual_top_up_available,
+        autoTopUpAvailable: data.auto_top_up_available,
+        overdrawEnabled: data.overdraw_enabled
+      };
+    },
+    // ========================================================================
+    // Payment Method Methods
+    // ========================================================================
+    /**
+     * List the current user's stored payment methods.
+     * Sorted by priority (lower number = higher priority).
+     */
+    async getPaymentMethods() {
+      const res = await fetch(`${baseUrl}/billing/payment-methods`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        throw new Error(`Failed to get payment methods: ${res.status}`);
+      }
+      const data = await res.json();
+      return data.map(
+        (pm) => ({
+          id: pm.id,
+          provider: pm.provider,
+          methodType: pm.method_type,
+          cardBrand: pm.card_brand,
+          cardLast4: pm.card_last4,
+          cardExpMonth: pm.card_exp_month,
+          cardExpYear: pm.card_exp_year,
+          priority: pm.priority,
+          createdAt: pm.created_at
+        })
+      );
+    },
+    /**
+     * Create a Stripe SetupIntent for adding a new payment method.
+     * Use the returned clientSecret with Stripe.js `confirmCardSetup()`.
+     */
+    async createSetupIntent() {
+      const res = await fetch(`${baseUrl}/billing/setup-intent`, {
+        method: "POST",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        throw new Error(`Failed to create setup intent: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        clientSecret: data.client_secret,
+        setupIntentId: data.setup_intent_id
+      };
+    },
+    /**
+     * Delete a stored payment method.
+     * @param id UUID of the payment method to delete
+     */
+    async deletePaymentMethod(id) {
+      const res = await fetch(`${baseUrl}/billing/payment-methods/${id}`, {
+        method: "DELETE",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        if (res.status === 404) throw new Error("Payment method not found");
+        throw new Error(`Failed to delete payment method: ${res.status}`);
+      }
+    },
+    /**
+     * Reorder payment method priorities.
+     * @param paymentMethodIds Array of payment method UUIDs in desired priority order
+     */
+    async reorderPaymentMethods(paymentMethodIds) {
+      const res = await fetch(`${baseUrl}/billing/payment-methods/reorder`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ payment_method_ids: paymentMethodIds })
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        throw new Error(`Failed to reorder payment methods: ${res.status}`);
+      }
+    },
+    /**
+     * Purchase credits using a stored payment method.
+     * @param opts Purchase options (amount, payment method, idempotency key)
+     */
+    async purchaseCredits(opts) {
+      const res = await fetch(`${baseUrl}/billing/credits/purchase`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({
+          amount_cents: opts.amountCents,
+          payment_method_id: opts.paymentMethodId,
+          idempotency_key: opts.idempotencyKey
+        })
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to purchase credits: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        creditsPurchased: data.credits_purchased,
+        newBalance: data.new_balance,
+        paymentIntentId: data.payment_intent_id
+      };
+    },
+    // ========================================================================
+    // Auto Top-Up Methods
+    // ========================================================================
+    /**
+     * Get the current user's auto top-up configuration and status.
+     */
+    async getAutoTopUpStatus() {
+      const res = await fetch(`${baseUrl}/billing/auto-top-up`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        throw new Error(`Failed to get auto top-up status: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        enabled: data.enabled,
+        thresholdCents: data.threshold_cents,
+        purchaseAmountCents: data.purchase_amount_cents,
+        status: data.status,
+        lastFailureReason: data.last_failure_reason,
+        retriesRemaining: data.retries_remaining,
+        nextRetryAt: data.next_retry_at
+      };
+    },
+    /**
+     * Update the current user's auto top-up configuration.
+     * @param opts New auto top-up settings
+     */
+    async updateAutoTopUp(opts) {
+      const res = await fetch(`${baseUrl}/billing/auto-top-up`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({
+          enabled: opts.enabled,
+          threshold_cents: opts.thresholdCents,
+          purchase_amount_cents: opts.purchaseAmountCents
+        })
+      });
+      if (!res.ok) {
+        if (res.status === 401) throw new Error("Not authenticated");
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to update auto top-up: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        enabled: data.enabled,
+        thresholdCents: data.threshold_cents,
+        purchaseAmountCents: data.purchase_amount_cents,
+        status: data.status,
+        lastFailureReason: data.last_failure_reason,
+        retriesRemaining: data.retries_remaining,
+        nextRetryAt: data.next_retry_at
+      };
+    },
+    // ========================================================================
+    // Organization Methods
+    // ========================================================================
+    /**
+     * Create a new organization.
+     * @param name The organization name
+     * @returns The created organization
+     */
+    async createOrg(name) {
+      const res = await fetch(`${baseUrl}/auth/orgs`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ name })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to create org: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformOrg(data);
+    },
+    /**
+     * List all organizations the current user belongs to.
+     */
+    async listOrgs() {
+      const res = await fetch(`${baseUrl}/auth/orgs`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to list orgs: ${res.status}`);
+      }
+      const data = await res.json();
+      return data.map(transformOrg);
+    },
+    /**
+     * Get organization details.
+     * @param orgId The organization ID
+     */
+    async getOrg(orgId) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        if (res.status === 404) throw new Error("Organization not found");
+        throw new Error(`Failed to get org: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformOrg(data);
+    },
+    /**
+     * Update an organization's name. Requires owner role.
+     * @param orgId The organization ID
+     * @param name The new name
+     */
+    async updateOrg(orgId, name) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ name })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to update org: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformOrg(data);
+    },
+    /**
+     * Delete an organization. Requires owner role.
+     * @param orgId The organization ID
+     */
+    async deleteOrg(orgId) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}`, {
+        method: "DELETE",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to delete org: ${res.status}`);
+      }
+    },
+    // ========================================================================
+    // Organization Member Methods
+    // ========================================================================
+    /**
+     * List members of an organization. Requires membership.
+     * @param orgId The organization ID
+     */
+    async listOrgMembers(orgId) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/members`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to list org members: ${res.status}`);
+      }
+      const data = await res.json();
+      return data.map(transformOrgMember);
+    },
+    /**
+     * Remove a member from an organization. Requires owner role.
+     * @param orgId The organization ID
+     * @param userId The user ID to remove
+     */
+    async removeOrgMember(orgId, userId) {
+      const res = await fetch(
+        `${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`,
+        {
+          method: "DELETE",
+          credentials: "include",
+          signal: AbortSignal.timeout(timeoutMs)
+        }
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to remove org member: ${res.status}`);
+      }
+    },
+    /**
+     * Update a member's role. Requires owner role.
+     * @param orgId The organization ID
+     * @param userId The user ID to update
+     * @param role The new role
+     */
+    async updateMemberRole(orgId, userId, role) {
+      const res = await fetch(
+        `${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`,
+        {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          credentials: "include",
+          signal: AbortSignal.timeout(timeoutMs),
+          body: JSON.stringify({ role })
+        }
+      );
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to update member role: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformOrgMember(data);
+    },
+    // ========================================================================
+    // Organization Context Methods
+    // ========================================================================
+    /**
+     * Switch the active organization. Re-issues session tokens with new org context.
+     * @param orgId The organization ID to switch to
+     * @returns The new active org context with subscription info
+     */
+    async switchOrg(orgId) {
+      const res = await fetch(`${baseUrl}/auth/switch-org`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ org_id: orgId })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to switch org: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        activeOrgId: data.active_org_id,
+        orgRole: data.org_role,
+        subscription: {
+          status: data.subscription.status,
+          planCode: data.subscription.plan_code,
+          planName: data.subscription.plan_name,
+          currentPeriodEnd: data.subscription.current_period_end,
+          cancelAtPeriodEnd: data.subscription.cancel_at_period_end,
+          trialEndsAt: data.subscription.trial_ends_at
+        }
+      };
+    },
+    /**
+     * Get the active organization from the current session.
+     * @returns Active org ID and role, or null if no active org
+     */
+    async getActiveOrg() {
+      const session = await this.getSession();
+      if (!session.valid || !session.active_org_id || !session.org_role) {
+        return null;
+      }
+      return {
+        id: session.active_org_id,
+        role: session.org_role
+      };
+    },
+    // ========================================================================
+    // Invitation Methods
+    // ========================================================================
+    /**
+     * Send an email invite to join an organization. Requires owner role.
+     * @param orgId The organization ID
+     * @param email The email address to invite
+     * @param role Optional role (defaults to "member")
+     */
+    async inviteToOrg(orgId, email, role) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invites`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ email, role: role ?? "member" })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to send invite: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformInvitation(data);
+    },
+    /**
+     * List pending invites for an organization. Requires owner role.
+     * @param orgId The organization ID
+     */
+    async listPendingInvites(orgId) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invites`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to list invites: ${res.status}`);
+      }
+      const data = await res.json();
+      return data.map(transformInvitation);
+    },
+    /**
+     * Revoke a pending invite. Requires owner role.
+     * @param orgId The organization ID
+     * @param inviteId The invite ID to revoke
+     */
+    async revokeInvite(orgId, inviteId) {
+      const res = await fetch(
+        `${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invites/${encodeURIComponent(inviteId)}`,
+        {
+          method: "DELETE",
+          credentials: "include",
+          signal: AbortSignal.timeout(timeoutMs)
+        }
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to revoke invite: ${res.status}`);
+      }
+    },
+    /**
+     * Accept an email invite using the invite token.
+     * @param token The invite token from the email
+     * @returns The org ID and role assigned
+     */
+    async acceptInvite(token) {
+      const res = await fetch(
+        `${baseUrl}/auth/orgs/invites/${encodeURIComponent(token)}/accept`,
+        {
+          method: "POST",
+          credentials: "include",
+          signal: AbortSignal.timeout(timeoutMs)
+        }
+      );
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to accept invite: ${res.status}`);
+      }
+      const data = await res.json();
+      return {
+        orgId: data.org_id,
+        role: data.role
+      };
+    },
+    /**
+     * Create a shareable invite link for an organization. Requires owner role.
+     * @param orgId The organization ID
+     * @param role Optional role for joiners (defaults to "member")
+     */
+    async createInviteLink(orgId, role) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invite-links`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs),
+        body: JSON.stringify({ role: role ?? "member" })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to create invite link: ${res.status}`);
+      }
+      const data = await res.json();
+      return transformInviteLink(data);
+    },
+    /**
+     * List invite links for an organization. Requires owner role.
+     * @param orgId The organization ID
+     */
+    async listInviteLinks(orgId) {
+      const res = await fetch(`${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invite-links`, {
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        throw new Error(`Failed to list invite links: ${res.status}`);
+      }
+      const data = await res.json();
+      return data.map(transformInviteLink);
+    },
+    /**
+     * Revoke an invite link. Requires owner role.
+     * @param orgId The organization ID
+     * @param linkId The invite link ID to revoke
+     */
+    async revokeInviteLink(orgId, linkId) {
+      const res = await fetch(
+        `${baseUrl}/auth/orgs/${encodeURIComponent(orgId)}/invite-links/${encodeURIComponent(linkId)}`,
+        {
+          method: "DELETE",
+          credentials: "include",
+          signal: AbortSignal.timeout(timeoutMs)
+        }
+      );
+      if (!res.ok) {
+        throw new Error(`Failed to revoke invite link: ${res.status}`);
+      }
+    },
+    /**
+     * Join an organization via an invite link token.
+     * @param token The invite link token
+     */
+    async joinViaLink(token) {
+      const res = await fetch(`${baseUrl}/auth/orgs/join/${encodeURIComponent(token)}`, {
+        method: "POST",
+        credentials: "include",
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.message || `Failed to join via link: ${res.status}`);
+      }
     }
   };
 }
+function transformOrg(data) {
+  return {
+    id: data.id,
+    name: data.name,
+    isPersonal: data.is_personal,
+    createdAt: data.created_at
+  };
+}
+function transformOrgMember(data) {
+  return {
+    id: data.id,
+    orgId: data.org_id,
+    endUserId: data.end_user_id,
+    role: data.role,
+    joinedAt: data.joined_at
+  };
+}
+function transformInvitation(data) {
+  return {
+    id: data.id,
+    orgId: data.org_id,
+    email: data.email,
+    token: data.token,
+    role: data.role,
+    status: data.status,
+    expiresAt: data.expires_at,
+    acceptedAt: data.accepted_at,
+    createdAt: data.created_at
+  };
+}
+function transformInviteLink(data) {
+  return {
+    id: data.id,
+    orgId: data.org_id,
+    token: data.token,
+    role: data.role,
+    isActive: data.is_active,
+    expiresAt: data.expires_at,
+    createdAt: data.created_at
+  };
+}
 
 // src/errors.ts
 var ReauthErrorCode = /* @__PURE__ */ ((ReauthErrorCode2) => {