@reauth-dev/sdk 0.1.0 → 0.3.0

package/dist/types-DKUKhCNE.d.mts

@@ -0,0 +1,349 @@
+/** Response from GET /api/public/auth/session */
+type ReauthSession = {
+    valid: boolean;
+    end_user_id: string | null;
+    email: string | null;
+    roles: string[] | null;
+    /** Active organization ID */
+    active_org_id: string | null;
+    /** User's role in the active organization ("owner" | "member") */
+    org_role: string | null;
+    waitlist_position: number | null;
+    /** Whether the user has linked their Google account */
+    google_linked: boolean | null;
+    /** Whether the user has linked their X (Twitter) account */
+    twitter_linked: boolean | null;
+    error: string | null;
+    /** Error code (e.g., "ACCOUNT_SUSPENDED", "SESSION_VERIFICATION_FAILED") */
+    error_code: string | null;
+    /** Subscription information (if billing is configured) */
+    subscription?: {
+        status: string;
+        plan_code: string | null;
+        plan_name: string | null;
+        current_period_end: number | null;
+        cancel_at_period_end: boolean | null;
+        trial_ends_at: number | null;
+    };
+};
+/** Authenticated user object (basic) */
+type User = {
+    id: string;
+    email: string;
+    roles: string[];
+    /** Active organization ID */
+    activeOrgId: string;
+    /** User's role in the active organization ("owner" | "member") */
+    orgRole: string;
+};
+/** Full user details (from Developer API) */
+type UserDetails = {
+    id: string;
+    email: string;
+    roles: string[];
+    emailVerifiedAt: string | null;
+    lastLoginAt: string | null;
+    isFrozen: boolean;
+    isWhitelisted: boolean;
+    createdAt: string | null;
+};
+/** JWT claims for domain end-user tokens */
+type DomainEndUserClaims = {
+    /** User ID (subject) */
+    sub: string;
+    /** Domain ID */
+    domain_id: string;
+    /** Root domain (e.g., "example.com") */
+    domain: string;
+    /** Active organization ID */
+    active_org_id: string;
+    /** User's role in the active organization ("owner" | "member") */
+    org_role: string;
+    /** User roles */
+    roles: string[];
+    /** Subscription information */
+    subscription: {
+        status: string;
+        plan_code: string | null;
+        plan_name: string | null;
+        current_period_end: number | null;
+        cancel_at_period_end: boolean | null;
+        trial_ends_at: number | null;
+    };
+    /** Token expiration (Unix timestamp) */
+    exp: number;
+    /** Token issued at (Unix timestamp) */
+    iat: number;
+};
+/** Configuration for browser-side reauth client */
+type ReauthConfig = {
+    /** Your verified domain (e.g., "yourdomain.com") */
+    domain: string;
+    /** Request timeout in milliseconds. Defaults to 10 seconds if not specified. */
+    timeout?: number;
+};
+/** Configuration for server-side reauth client */
+type ReauthServerConfig = ReauthConfig & {
+    /** API key for server-to-server authentication (required, e.g., "sk_live_...") */
+    apiKey: string;
+};
+/** Role within an organization */
+type OrgRole = "owner" | "member";
+/** Organization details */
+type Organization = {
+    id: string;
+    name: string;
+    isPersonal: boolean;
+    createdAt: string | null;
+};
+/** Organization member */
+type OrgMember = {
+    id: string;
+    orgId: string;
+    endUserId: string;
+    role: OrgRole;
+    joinedAt: string | null;
+};
+/** Email invitation to an organization */
+type OrgInvitation = {
+    id: string;
+    orgId: string;
+    email: string;
+    token: string;
+    role: OrgRole;
+    status: "pending" | "accepted";
+    expiresAt: string;
+    acceptedAt: string | null;
+    createdAt: string | null;
+};
+/** Shareable invite link for an organization */
+type OrgInviteLink = {
+    id: string;
+    orgId: string;
+    token: string;
+    role: OrgRole;
+    isActive: boolean;
+    expiresAt: string;
+    createdAt: string | null;
+};
+/** Result of accepting an invite or switching org */
+type SwitchOrgResult = {
+    activeOrgId: string;
+    orgRole: OrgRole;
+    subscription: SubscriptionInfo;
+};
+/** Subscription status values */
+type SubscriptionStatus = "active" | "past_due" | "canceled" | "trialing" | "incomplete" | "incomplete_expired" | "unpaid" | "paused" | "none";
+/** Subscription info included in JWT claims */
+type SubscriptionInfo = {
+    /** Current subscription status */
+    status: SubscriptionStatus;
+    /** Machine-readable plan identifier (e.g., "pro") */
+    planCode: string | null;
+    /** Human-readable plan name (e.g., "Pro Plan") */
+    planName: string | null;
+    /** Unix timestamp when current period ends */
+    currentPeriodEnd: number | null;
+    /** Whether subscription will cancel at period end */
+    cancelAtPeriodEnd: boolean | null;
+    /** Unix timestamp when trial ends (if applicable) */
+    trialEndsAt: number | null;
+};
+/** Authentication result from verifyToken/authenticate */
+type AuthResult = {
+    valid: boolean;
+    user: {
+        id: string;
+        roles: string[];
+        /** Active organization ID */
+        activeOrgId: string;
+        /** User's role in the active organization ("owner" | "member") */
+        orgRole: string;
+        subscription: SubscriptionInfo;
+    } | null;
+    claims: DomainEndUserClaims | null;
+    error?: string;
+};
+/** Request-like object for extractToken/authenticate */
+type RequestLike = {
+    headers?: {
+        authorization?: string;
+        cookie?: string;
+    };
+};
+/** Response from GET /auth/token endpoint */
+type TokenResponse = {
+    /** The JWT access token */
+    accessToken: string;
+    /** Token expiration time in seconds */
+    expiresIn: number;
+    /** Token type (always "Bearer") */
+    tokenType: string;
+};
+/** A single feature attached to a subscription plan */
+type PlanFeature = {
+    code: string;
+    name: string;
+    featureType: "boolean" | "numeric";
+    numericValue: number | null;
+    unitLabel: string | null;
+};
+/** Plan type determines how a user subscribes */
+type PlanType = "self_service" | "sales";
+/** Subscription plan available for purchase */
+type SubscriptionPlan = {
+    id: string;
+    code: string;
+    name: string;
+    description: string | null;
+    priceCents: number;
+    currency: string;
+    interval: "monthly" | "yearly" | "custom";
+    intervalCount: number;
+    trialDays: number;
+    features: PlanFeature[];
+    displayOrder: number;
+    creditsAmount: number;
+    planType: PlanType;
+    contactUrl: string | null;
+};
+/** Current subscription details */
+type Subscription = {
+    id: string | null;
+    planCode: string | null;
+    planName: string | null;
+    status: SubscriptionStatus;
+    currentPeriodEnd: number | null;
+    trialEnd: number | null;
+    cancelAtPeriodEnd: boolean | null;
+};
+/** Checkout session response */
+type CheckoutSession = {
+    checkoutUrl: string;
+};
+/** A single balance transaction record */
+type BalanceTransaction = {
+    id: string;
+    amountDelta: number;
+    reason: Record<string, unknown>;
+    balanceAfter: number;
+    createdAt: string;
+};
+/** Options for charging a user's balance */
+type ChargeOptions = {
+    amount: number;
+    requestUuid: string;
+    note?: string;
+};
+/** Options for depositing to a user's balance */
+type DepositOptions = {
+    amount: number;
+    requestUuid: string;
+    note?: string;
+};
+/** Pagination options for transaction queries */
+type TransactionsPaginationOptions = {
+    limit?: number;
+    offset?: number;
+};
+/** Symbol position for display formatting */
+type SymbolPosition = "left" | "right";
+/** Domain credits configuration (public subset) */
+type CreditsConfig = {
+    creditsEnabled: boolean;
+    creditsPerDollar: number;
+    displayName: string;
+    displaySymbol: string | null;
+    displaySymbolPosition: SymbolPosition;
+    displayDecimals: number;
+    minPurchaseCents: number;
+    maxPurchaseCents: number;
+    manualTopUpAvailable: boolean;
+    autoTopUpAvailable: boolean;
+    overdrawEnabled: boolean;
+};
+/** A stored payment method */
+type PaymentMethod = {
+    id: string;
+    provider: string;
+    methodType: string;
+    cardBrand: string | null;
+    cardLast4: string | null;
+    cardExpMonth: number | null;
+    cardExpYear: number | null;
+    priority: number;
+    createdAt: number;
+};
+/** Result of creating a SetupIntent for Stripe.js */
+type SetupIntentResult = {
+    clientSecret: string;
+    setupIntentId: string;
+};
+/** Options for purchasing credits */
+type PurchaseCreditsOptions = {
+    amountCents: number;
+    paymentMethodId: string;
+    idempotencyKey: string;
+};
+/** Result of a credit purchase */
+type CreditPurchaseResult = {
+    creditsPurchased: number;
+    newBalance: number;
+    paymentIntentId: string;
+};
+/** Auto top-up configuration and status */
+type AutoTopUpStatus = {
+    enabled: boolean;
+    thresholdCents: number;
+    purchaseAmountCents: number;
+    status: string;
+    lastFailureReason?: string;
+    retriesRemaining?: number;
+    nextRetryAt?: string;
+};
+/** Options for updating auto top-up configuration */
+type UpdateAutoTopUpOptions = {
+    enabled: boolean;
+    thresholdCents: number;
+    purchaseAmountCents: number;
+};
+/** Public domain configuration (from GET /config) */
+type DomainConfig = {
+    domain: string;
+    authMethods: {
+        magicLink: boolean;
+        googleOauth: boolean;
+        twitterOauth: boolean;
+    };
+    redirectUrl: string | null;
+    headlessEnabled: boolean;
+};
+/** Options for requesting a magic link */
+type RequestMagicLinkOptions = {
+    email: string;
+    callbackUrl?: string;
+};
+/** Options for verifying a magic link */
+type VerifyMagicLinkOptions = {
+    token: string;
+};
+/** Result of verifying a magic link */
+type MagicLinkVerifyResult = {
+    success: boolean;
+    redirectUrl: string | null;
+    endUserId: string | null;
+    email: string | null;
+    waitlistPosition: number | null;
+};
+/** Result of starting Google OAuth */
+type GoogleOAuthStartResult = {
+    authUrl: string;
+    state: string;
+};
+/** Result of starting X (Twitter) OAuth */
+type TwitterOAuthStartResult = {
+    authUrl: string;
+    state: string;
+};
+
+export type { AutoTopUpStatus as A, BalanceTransaction as B, CheckoutSession as C, DomainConfig as D, GoogleOAuthStartResult as G, MagicLinkVerifyResult as M, Organization as O, PaymentMethod as P, ReauthConfig as R, SubscriptionPlan as S, TokenResponse as T, UpdateAutoTopUpOptions as U, VerifyMagicLinkOptions as V, ReauthSession as a, RequestMagicLinkOptions as b, TwitterOAuthStartResult as c, Subscription as d, TransactionsPaginationOptions as e, CreditsConfig as f, SetupIntentResult as g, PurchaseCreditsOptions as h, CreditPurchaseResult as i, OrgMember as j, OrgRole as k, SwitchOrgResult as l, OrgInvitation as m, OrgInviteLink as n, User as o, UserDetails as p, ReauthServerConfig as q, AuthResult as r, RequestLike as s, DomainEndUserClaims as t, SubscriptionInfo as u, SubscriptionStatus as v, PlanFeature as w, ChargeOptions as x, DepositOptions as y, SymbolPosition as z };

package/dist/types-DKUKhCNE.d.ts

@@ -0,0 +1,349 @@
+/** Response from GET /api/public/auth/session */
+type ReauthSession = {
+    valid: boolean;
+    end_user_id: string | null;
+    email: string | null;
+    roles: string[] | null;
+    /** Active organization ID */
+    active_org_id: string | null;
+    /** User's role in the active organization ("owner" | "member") */
+    org_role: string | null;
+    waitlist_position: number | null;
+    /** Whether the user has linked their Google account */
+    google_linked: boolean | null;
+    /** Whether the user has linked their X (Twitter) account */
+    twitter_linked: boolean | null;
+    error: string | null;
+    /** Error code (e.g., "ACCOUNT_SUSPENDED", "SESSION_VERIFICATION_FAILED") */
+    error_code: string | null;
+    /** Subscription information (if billing is configured) */
+    subscription?: {
+        status: string;
+        plan_code: string | null;
+        plan_name: string | null;
+        current_period_end: number | null;
+        cancel_at_period_end: boolean | null;
+        trial_ends_at: number | null;
+    };
+};
+/** Authenticated user object (basic) */
+type User = {
+    id: string;
+    email: string;
+    roles: string[];
+    /** Active organization ID */
+    activeOrgId: string;
+    /** User's role in the active organization ("owner" | "member") */
+    orgRole: string;
+};
+/** Full user details (from Developer API) */
+type UserDetails = {
+    id: string;
+    email: string;
+    roles: string[];
+    emailVerifiedAt: string | null;
+    lastLoginAt: string | null;
+    isFrozen: boolean;
+    isWhitelisted: boolean;
+    createdAt: string | null;
+};
+/** JWT claims for domain end-user tokens */
+type DomainEndUserClaims = {
+    /** User ID (subject) */
+    sub: string;
+    /** Domain ID */
+    domain_id: string;
+    /** Root domain (e.g., "example.com") */
+    domain: string;
+    /** Active organization ID */
+    active_org_id: string;
+    /** User's role in the active organization ("owner" | "member") */
+    org_role: string;
+    /** User roles */
+    roles: string[];
+    /** Subscription information */
+    subscription: {
+        status: string;
+        plan_code: string | null;
+        plan_name: string | null;
+        current_period_end: number | null;
+        cancel_at_period_end: boolean | null;
+        trial_ends_at: number | null;
+    };
+    /** Token expiration (Unix timestamp) */
+    exp: number;
+    /** Token issued at (Unix timestamp) */
+    iat: number;
+};
+/** Configuration for browser-side reauth client */
+type ReauthConfig = {
+    /** Your verified domain (e.g., "yourdomain.com") */
+    domain: string;
+    /** Request timeout in milliseconds. Defaults to 10 seconds if not specified. */
+    timeout?: number;
+};
+/** Configuration for server-side reauth client */
+type ReauthServerConfig = ReauthConfig & {
+    /** API key for server-to-server authentication (required, e.g., "sk_live_...") */
+    apiKey: string;
+};
+/** Role within an organization */
+type OrgRole = "owner" | "member";
+/** Organization details */
+type Organization = {
+    id: string;
+    name: string;
+    isPersonal: boolean;
+    createdAt: string | null;
+};
+/** Organization member */
+type OrgMember = {
+    id: string;
+    orgId: string;
+    endUserId: string;
+    role: OrgRole;
+    joinedAt: string | null;
+};
+/** Email invitation to an organization */
+type OrgInvitation = {
+    id: string;
+    orgId: string;
+    email: string;
+    token: string;
+    role: OrgRole;
+    status: "pending" | "accepted";
+    expiresAt: string;
+    acceptedAt: string | null;
+    createdAt: string | null;
+};
+/** Shareable invite link for an organization */
+type OrgInviteLink = {
+    id: string;
+    orgId: string;
+    token: string;
+    role: OrgRole;
+    isActive: boolean;
+    expiresAt: string;
+    createdAt: string | null;
+};
+/** Result of accepting an invite or switching org */
+type SwitchOrgResult = {
+    activeOrgId: string;
+    orgRole: OrgRole;
+    subscription: SubscriptionInfo;
+};
+/** Subscription status values */
+type SubscriptionStatus = "active" | "past_due" | "canceled" | "trialing" | "incomplete" | "incomplete_expired" | "unpaid" | "paused" | "none";
+/** Subscription info included in JWT claims */
+type SubscriptionInfo = {
+    /** Current subscription status */
+    status: SubscriptionStatus;
+    /** Machine-readable plan identifier (e.g., "pro") */
+    planCode: string | null;
+    /** Human-readable plan name (e.g., "Pro Plan") */
+    planName: string | null;
+    /** Unix timestamp when current period ends */
+    currentPeriodEnd: number | null;
+    /** Whether subscription will cancel at period end */
+    cancelAtPeriodEnd: boolean | null;
+    /** Unix timestamp when trial ends (if applicable) */
+    trialEndsAt: number | null;
+};
+/** Authentication result from verifyToken/authenticate */
+type AuthResult = {
+    valid: boolean;
+    user: {
+        id: string;
+        roles: string[];
+        /** Active organization ID */
+        activeOrgId: string;
+        /** User's role in the active organization ("owner" | "member") */
+        orgRole: string;
+        subscription: SubscriptionInfo;
+    } | null;
+    claims: DomainEndUserClaims | null;
+    error?: string;
+};
+/** Request-like object for extractToken/authenticate */
+type RequestLike = {
+    headers?: {
+        authorization?: string;
+        cookie?: string;
+    };
+};
+/** Response from GET /auth/token endpoint */
+type TokenResponse = {
+    /** The JWT access token */
+    accessToken: string;
+    /** Token expiration time in seconds */
+    expiresIn: number;
+    /** Token type (always "Bearer") */
+    tokenType: string;
+};
+/** A single feature attached to a subscription plan */
+type PlanFeature = {
+    code: string;
+    name: string;
+    featureType: "boolean" | "numeric";
+    numericValue: number | null;
+    unitLabel: string | null;
+};
+/** Plan type determines how a user subscribes */
+type PlanType = "self_service" | "sales";
+/** Subscription plan available for purchase */
+type SubscriptionPlan = {
+    id: string;
+    code: string;
+    name: string;
+    description: string | null;
+    priceCents: number;
+    currency: string;
+    interval: "monthly" | "yearly" | "custom";
+    intervalCount: number;
+    trialDays: number;
+    features: PlanFeature[];
+    displayOrder: number;
+    creditsAmount: number;
+    planType: PlanType;
+    contactUrl: string | null;
+};
+/** Current subscription details */
+type Subscription = {
+    id: string | null;
+    planCode: string | null;
+    planName: string | null;
+    status: SubscriptionStatus;
+    currentPeriodEnd: number | null;
+    trialEnd: number | null;
+    cancelAtPeriodEnd: boolean | null;
+};
+/** Checkout session response */
+type CheckoutSession = {
+    checkoutUrl: string;
+};
+/** A single balance transaction record */
+type BalanceTransaction = {
+    id: string;
+    amountDelta: number;
+    reason: Record<string, unknown>;
+    balanceAfter: number;
+    createdAt: string;
+};
+/** Options for charging a user's balance */
+type ChargeOptions = {
+    amount: number;
+    requestUuid: string;
+    note?: string;
+};
+/** Options for depositing to a user's balance */
+type DepositOptions = {
+    amount: number;
+    requestUuid: string;
+    note?: string;
+};
+/** Pagination options for transaction queries */
+type TransactionsPaginationOptions = {
+    limit?: number;
+    offset?: number;
+};
+/** Symbol position for display formatting */
+type SymbolPosition = "left" | "right";
+/** Domain credits configuration (public subset) */
+type CreditsConfig = {
+    creditsEnabled: boolean;
+    creditsPerDollar: number;
+    displayName: string;
+    displaySymbol: string | null;
+    displaySymbolPosition: SymbolPosition;
+    displayDecimals: number;
+    minPurchaseCents: number;
+    maxPurchaseCents: number;
+    manualTopUpAvailable: boolean;
+    autoTopUpAvailable: boolean;
+    overdrawEnabled: boolean;
+};
+/** A stored payment method */
+type PaymentMethod = {
+    id: string;
+    provider: string;
+    methodType: string;
+    cardBrand: string | null;
+    cardLast4: string | null;
+    cardExpMonth: number | null;
+    cardExpYear: number | null;
+    priority: number;
+    createdAt: number;
+};
+/** Result of creating a SetupIntent for Stripe.js */
+type SetupIntentResult = {
+    clientSecret: string;
+    setupIntentId: string;
+};
+/** Options for purchasing credits */
+type PurchaseCreditsOptions = {
+    amountCents: number;
+    paymentMethodId: string;
+    idempotencyKey: string;
+};
+/** Result of a credit purchase */
+type CreditPurchaseResult = {
+    creditsPurchased: number;
+    newBalance: number;
+    paymentIntentId: string;
+};
+/** Auto top-up configuration and status */
+type AutoTopUpStatus = {
+    enabled: boolean;
+    thresholdCents: number;
+    purchaseAmountCents: number;
+    status: string;
+    lastFailureReason?: string;
+    retriesRemaining?: number;
+    nextRetryAt?: string;
+};
+/** Options for updating auto top-up configuration */
+type UpdateAutoTopUpOptions = {
+    enabled: boolean;
+    thresholdCents: number;
+    purchaseAmountCents: number;
+};
+/** Public domain configuration (from GET /config) */
+type DomainConfig = {
+    domain: string;
+    authMethods: {
+        magicLink: boolean;
+        googleOauth: boolean;
+        twitterOauth: boolean;
+    };
+    redirectUrl: string | null;
+    headlessEnabled: boolean;
+};
+/** Options for requesting a magic link */
+type RequestMagicLinkOptions = {
+    email: string;
+    callbackUrl?: string;
+};
+/** Options for verifying a magic link */
+type VerifyMagicLinkOptions = {
+    token: string;
+};
+/** Result of verifying a magic link */
+type MagicLinkVerifyResult = {
+    success: boolean;
+    redirectUrl: string | null;
+    endUserId: string | null;
+    email: string | null;
+    waitlistPosition: number | null;
+};
+/** Result of starting Google OAuth */
+type GoogleOAuthStartResult = {
+    authUrl: string;
+    state: string;
+};
+/** Result of starting X (Twitter) OAuth */
+type TwitterOAuthStartResult = {
+    authUrl: string;
+    state: string;
+};
+
+export type { AutoTopUpStatus as A, BalanceTransaction as B, CheckoutSession as C, DomainConfig as D, GoogleOAuthStartResult as G, MagicLinkVerifyResult as M, Organization as O, PaymentMethod as P, ReauthConfig as R, SubscriptionPlan as S, TokenResponse as T, UpdateAutoTopUpOptions as U, VerifyMagicLinkOptions as V, ReauthSession as a, RequestMagicLinkOptions as b, TwitterOAuthStartResult as c, Subscription as d, TransactionsPaginationOptions as e, CreditsConfig as f, SetupIntentResult as g, PurchaseCreditsOptions as h, CreditPurchaseResult as i, OrgMember as j, OrgRole as k, SwitchOrgResult as l, OrgInvitation as m, OrgInviteLink as n, User as o, UserDetails as p, ReauthServerConfig as q, AuthResult as r, RequestLike as s, DomainEndUserClaims as t, SubscriptionInfo as u, SubscriptionStatus as v, PlanFeature as w, ChargeOptions as x, DepositOptions as y, SymbolPosition as z };