@omnibase/core-js 0.7.4 → 0.7.6

package/dist/payments/index.d.ts

@@ -2440,6 +2440,263 @@ declare class TenantManger {
     switchActiveTenant(tenantId: string): Promise<SwitchActiveTenantResponse>;
 }
 
+/**
+ * Active subscription data returned from the API
+ *
+ * Represents a tenant's active Stripe subscription with config-based price IDs
+ * instead of raw Stripe IDs. Includes legacy price detection for historical
+ * billing configurations.
+ *
+ * @example
+ * ```typescript
+ * const subscription: TenantSubscription = {
+ *   subscription_id: 'sub_1234567890',
+ *   config_price_id: 'price_pro_monthly',
+ *   status: 'active',
+ *   is_legacy_price: false,
+ *   current_period_end: 1735416000
+ * };
+ * ```
+ *
+ * @since 0.6.0
+ * @public
+ * @group Tenant Subscriptions
+ */
+type TenantSubscription = {
+    /** Stripe subscription ID */
+    subscription_id: string;
+    /** Config-based price ID from your billing configuration */
+    config_price_id: string;
+    /** Subscription status (active, trialing, past_due) */
+    status: string;
+    /** Whether this price is from a legacy billing configuration */
+    is_legacy_price: boolean;
+    /** Unix timestamp when the current billing period ends */
+    current_period_end: number;
+};
+/**
+ * Response structure for getting active subscriptions
+ *
+ * @since 0.6.0
+ * @public
+ * @group Tenant Subscriptions
+ */
+type GetActiveSubscriptionsResponse = ApiResponse<TenantSubscription[]>;
+/**
+ * Billing status information for a tenant
+ *
+ * Indicates whether the tenant has valid billing information configured
+ * in their Stripe customer account.
+ *
+ * @example
+ * ```typescript
+ * const status: BillingStatus = {
+ *   has_billing_info: true,
+ *   is_active: true
+ * };
+ * ```
+ *
+ * @since 0.6.0
+ * @public
+ * @group Tenant Subscriptions
+ */
+type BillingStatus = {
+    /** Whether the tenant has payment method(s) configured */
+    has_billing_info: boolean;
+    /** Whether the billing information is active and valid */
+    is_active: boolean;
+};
+/**
+ * Response structure for billing status check
+ *
+ * @since 0.6.0
+ * @public
+ * @group Tenant Subscriptions
+ */
+type GetBillingStatusResponse = ApiResponse<BillingStatus>;
+/**
+ * Tenant subscription and billing management
+ *
+ * Provides access to the active tenant's Stripe subscriptions and billing
+ * status. All operations are automatically scoped to the user's currently
+ * active tenant via session authentication.
+ *
+ * Key features:
+ * - View all active subscriptions with config-based price IDs
+ * - Legacy price detection for historical billing configurations
+ * - Billing status verification (payment method availability)
+ * - Automatic tenant scoping via session context
+ *
+ * @example
+ * ```typescript
+ * const subscriptionManager = new TenantSubscriptionManager(omnibaseClient);
+ *
+ * // Get all active subscriptions for the current tenant
+ * const subscriptions = await subscriptionManager.getActive();
+ * console.log(`Active subscriptions: ${subscriptions.data.length}`);
+ *
+ * // Check if tenant has billing configured
+ * const status = await subscriptionManager.getBillingStatus();
+ * if (!status.data.has_billing_info) {
+ *   console.log('Please add a payment method');
+ * }
+ * ```
+ *
+ * @since 0.6.0
+ * @public
+ * @group Tenant Subscriptions
+ */
+declare class TenantSubscriptionManager {
+    private omnibaseClient;
+    /**
+     * Creates a new TenantSubscriptionManager instance
+     *
+     * @param omnibaseClient - Configured Omnibase client instance
+     *
+     * @group Tenant Subscriptions
+     */
+    constructor(omnibaseClient: OmnibaseClient);
+    /**
+     * Get all active subscriptions for the current tenant
+     *
+     * Retrieves all active Stripe subscriptions associated with the user's
+     * currently active tenant. Returns subscriptions with config-based price IDs
+     * instead of raw Stripe IDs, making it easier to match against your billing
+     * configuration.
+     *
+     * The endpoint automatically:
+     * - Fetches subscriptions from Stripe API
+     * - Maps Stripe price IDs to your config price IDs
+     * - Checks both current and historical price mappings
+     * - Flags legacy prices from old billing configurations
+     * - Filters to only active/trialing/past_due subscriptions
+     *
+     * Returns an empty array if:
+     * - Tenant has no Stripe customer ID configured
+     * - Tenant has no active subscriptions
+     * - User is not authenticated
+     *
+     * @returns Promise resolving to array of active subscriptions
+     *
+     * @throws {Error} When the user is not authenticated
+     * @throws {Error} When the API request fails due to network issues
+     * @throws {Error} When the server returns an error response (4xx, 5xx)
+     *
+     * @example
+     * ```typescript
+     * const response = await subscriptionManager.getActive();
+     *
+     * if (response.data.length === 0) {
+     *   console.log('No active subscriptions');
+     * } else {
+     *   response.data.forEach(sub => {
+     *     console.log(`Plan: ${sub.config_price_id}`);
+     *     console.log(`Status: ${sub.status}`);
+     *     if (sub.is_legacy_price) {
+     *       console.log('⚠️ Using legacy pricing');
+     *     }
+     *   });
+     * }
+     * ```
+     *
+     * @since 0.6.0
+     * @public
+     * @group Tenant Subscriptions
+     */
+    getActive(): Promise<GetActiveSubscriptionsResponse>;
+    /**
+     * Check if the current tenant has billing information configured
+     *
+     * Verifies whether the tenant has valid payment methods attached to their
+     * Stripe customer account. This is useful for:
+     * - Showing billing setup prompts
+     * - Gating premium features behind payment method requirement
+     * - Displaying billing status indicators in UI
+     * - Determining if customer portal access should be shown
+     *
+     * The check verifies:
+     * - Default payment source (card, bank account, etc.)
+     * - Default payment method in invoice settings
+     * - Whether the payment method is valid and active
+     *
+     * Returns `false` if:
+     * - Tenant has no Stripe customer ID
+     * - No payment methods are configured
+     * - User is not authenticated
+     *
+     * @returns Promise resolving to billing status information
+     *
+     * @throws {Error} When the user is not authenticated
+     * @throws {Error} When the API request fails due to network issues
+     * @throws {Error} When the server returns an error response (4xx, 5xx)
+     *
+     * @example
+     * ```typescript
+     * const response = await subscriptionManager.getBillingStatus();
+     *
+     * if (!response.data.has_billing_info) {
+     *   // Show billing setup prompt
+     *   showBillingSetupModal();
+     * } else if (!response.data.is_active) {
+     *   // Payment method exists but may be expired/invalid
+     *   showPaymentMethodUpdatePrompt();
+     * } else {
+     *   // All good - show customer portal link
+     *   showManageBillingButton();
+     * }
+     * ```
+     *
+     * @since 0.6.0
+     * @public
+     * @group Tenant Subscriptions
+     */
+    getBillingStatus(): Promise<GetBillingStatusResponse>;
+}
+
+/**
+ * Response structure for a tenant user
+ *
+ * Represents a user's information within a tenant, including their
+ * identification details and assigned role.
+ *
+ * @example
+ * ```typescript
+ * const user: TenantUser = {
+ *   user_id: 'user_abc123',
+ *   first_name: 'John',
+ *   last_name: 'Doe',
+ *   email: 'john@example.com',
+ *   role: 'admin'
+ * };
+ * ```
+ *
+ * @since 1.0.0
+ * @public
+ * @group Tenant User Management
+ */
+type TenantUser = {
+    /** Unique identifier for the user */
+    user_id: string;
+    /** User's first name */
+    first_name: string;
+    /** User's last name */
+    last_name: string;
+    /** User's email address */
+    email: string;
+    /** User's role within the tenant */
+    role: string;
+};
+/**
+ * Response from fetching all users in a tenant
+ *
+ * This type represents the API response structure returned when fetching
+ * the list of all users in the active tenant.
+ *
+ * @since 1.0.0
+ * @public
+ * @group Tenant User Management
+ */
+type GetAllUsersResponse = ApiResponse<TenantUser[]>;
 /**
  * Request parameters for updating a user's role within a tenant
  *
@@ -2536,6 +2793,47 @@ declare class TenantUserManager {
      * @group Tenant User Management
      */
     constructor(omnibaseClient: OmnibaseClient);
+    /**
+     * Retrieves all users in the active tenant
+     *
+     * This method fetches a list of all users who are members of the current active tenant,
+     * including their basic information (name, email) and assigned role. The operation
+     * requires the requesting user to have appropriate permissions to view tenant users
+     * (typically requires `view_users` permission).
+     *
+     * The returned list includes all tenant members regardless of their role, ordered by
+     * when they joined the tenant (newest first).
+     *
+     * @returns Promise resolving to an array of tenant users with their details
+     *
+     * @throws {Error} When the API request fails (includes status code and error details)
+     * @throws {Error} When the user doesn't have permission to view users
+     * @throws {Error} When the user is not authenticated or no active tenant is set
+     *
+     * @example
+     * ```typescript
+     * // Fetch all users in the active tenant
+     * try {
+     *   const result = await userManager.getAll();
+     *   console.log(`Found ${result.data.length} users`);
+     *
+     *   result.data.forEach(user => {
+     *     console.log(`${user.first_name} ${user.last_name} (${user.email}) - ${user.role}`);
+     *   });
+     * } catch (error) {
+     *   if (error.message.includes('403')) {
+     *     console.error('Insufficient permissions to view users');
+     *   } else {
+     *     console.error('Failed to fetch users:', error);
+     *   }
+     * }
+     * ```
+     *
+     * @since 1.0.0
+     * @public
+     * @group Tenant User Management
+     */
+    getAll(): Promise<GetAllUsersResponse>;
     /**
      * Removes a user from the active tenant
      *
@@ -2759,6 +3057,30 @@ declare class TenantHandler {
      * ```
      */
     readonly invites: TenantInviteManager;
+    /**
+     * Tenant subscription and billing management
+     *
+     * Provides access to subscription data and billing status for the
+     * active tenant, including legacy price detection and payment method
+     * verification. All operations are automatically scoped to the user's
+     * currently active tenant.
+     *
+     * @example
+     * ```typescript
+     * // Get active subscriptions
+     * const subs = await tenantHandler.subscriptions.getActive();
+     *
+     * // Check billing status
+     * const status = await tenantHandler.subscriptions.getBillingStatus();
+     * if (!status.data.has_billing_info) {
+     *   console.log('No payment method configured');
+     * }
+     * ```
+     *
+     * @since 0.6.0
+     * @group Tenant Management
+     */
+    readonly subscriptions: TenantSubscriptionManager;
 }
 
 type OmnibaseClientConfig = {
@@ -2895,4 +3217,4 @@ declare class OmnibaseClient {
     fetch(endpoint: string, options?: RequestInit): Promise<Response>;
 }
 
-export { type AssignRoleRequest as A, type CreateRoleRequest as C, CheckoutManager, type CheckoutOptions, ConfigManager, type CreateCheckoutResponse, type CreateCustomerPortalResponse, type DownloadResult as D, type NamespaceDefinition as N, type OmnibaseClientConfig as O, PermissionsClient as P, PaymentHandler, PortalManager, type PortalOptions, type Price, type PriceDisplay, type PriceLimit, type PriceUI, type Product, type ProductUI, type ProductWithPricingUI, RolesHandler as R, StorageClient as S, type StripeConfigResponse, type StripeConfiguration, TenantHandler as T, type Tier, type UpdateRoleRequest as U, UsageManager, type UsageOptions, type Role as a, type UploadOptions as b, type UploadResult as c, type AcceptTenantInviteRequest as d, type AcceptTenantInviteResponse as e, type CreateTenantUserInviteResponse as f, type TenantInvite as g, type CreateTenantUserInviteRequest as h, TenantInviteManager as i, type SwitchActiveTenantResponse as j, type DeleteTenantResponse as k, type CreateTenantResponse as l, type Tenant as m, type CreateTenantRequest as n, TenantManger as o, OmnibaseClient as p, type ApiResponse as q };
+export { type AssignRoleRequest as A, type BillingStatus as B, type CreateRoleRequest as C, CheckoutManager, type CheckoutOptions, ConfigManager, type CreateCheckoutResponse, type CreateCustomerPortalResponse, type DownloadResult as D, type GetActiveSubscriptionsResponse as G, type NamespaceDefinition as N, type OmnibaseClientConfig as O, PermissionsClient as P, PaymentHandler, PortalManager, type PortalOptions, type Price, type PriceDisplay, type PriceLimit, type PriceUI, type Product, type ProductUI, type ProductWithPricingUI, RolesHandler as R, StorageClient as S, type StripeConfigResponse, type StripeConfiguration, TenantHandler as T, type Tier, type UpdateRoleRequest as U, UsageManager, type UsageOptions, type Role as a, type UploadOptions as b, type UploadResult as c, type AcceptTenantInviteRequest as d, type AcceptTenantInviteResponse as e, type CreateTenantUserInviteResponse as f, type TenantInvite as g, type CreateTenantUserInviteRequest as h, TenantInviteManager as i, type SwitchActiveTenantResponse as j, type DeleteTenantResponse as k, type CreateTenantResponse as l, type Tenant as m, type CreateTenantRequest as n, TenantManger as o, type TenantSubscription as p, type GetBillingStatusResponse as q, TenantSubscriptionManager as r, OmnibaseClient as s, type ApiResponse as t };

package/dist/tenants/index.cjs

@@ -437,6 +437,157 @@ var TenantManger = class {
   }
 };
 
+// src/tenants/subscriptions.ts
+var TenantSubscriptionManager = class {
+  /**
+   * Creates a new TenantSubscriptionManager instance
+   *
+   * @param omnibaseClient - Configured Omnibase client instance
+   *
+   * @group Tenant Subscriptions
+   */
+  constructor(omnibaseClient) {
+    this.omnibaseClient = omnibaseClient;
+  }
+  /**
+   * Get all active subscriptions for the current tenant
+   *
+   * Retrieves all active Stripe subscriptions associated with the user's
+   * currently active tenant. Returns subscriptions with config-based price IDs
+   * instead of raw Stripe IDs, making it easier to match against your billing
+   * configuration.
+   *
+   * The endpoint automatically:
+   * - Fetches subscriptions from Stripe API
+   * - Maps Stripe price IDs to your config price IDs
+   * - Checks both current and historical price mappings
+   * - Flags legacy prices from old billing configurations
+   * - Filters to only active/trialing/past_due subscriptions
+   *
+   * Returns an empty array if:
+   * - Tenant has no Stripe customer ID configured
+   * - Tenant has no active subscriptions
+   * - User is not authenticated
+   *
+   * @returns Promise resolving to array of active subscriptions
+   *
+   * @throws {Error} When the user is not authenticated
+   * @throws {Error} When the API request fails due to network issues
+   * @throws {Error} When the server returns an error response (4xx, 5xx)
+   *
+   * @example
+   * ```typescript
+   * const response = await subscriptionManager.getActive();
+   *
+   * if (response.data.length === 0) {
+   *   console.log('No active subscriptions');
+   * } else {
+   *   response.data.forEach(sub => {
+   *     console.log(`Plan: ${sub.config_price_id}`);
+   *     console.log(`Status: ${sub.status}`);
+   *     if (sub.is_legacy_price) {
+   *       console.log('⚠️ Using legacy pricing');
+   *     }
+   *   });
+   * }
+   * ```
+   *
+   * @since 0.6.0
+   * @public
+   * @group Tenant Subscriptions
+   */
+  async getActive() {
+    try {
+      const response = await this.omnibaseClient.fetch(
+        `/api/v1/tenants/subscriptions`,
+        {
+          method: "GET",
+          credentials: "include"
+        }
+      );
+      if (!response.ok) {
+        const errorData = await response.text();
+        throw new Error(
+          `Failed to fetch subscriptions: ${response.status} - ${errorData}`
+        );
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      console.error("Error fetching tenant subscriptions:", error);
+      throw error;
+    }
+  }
+  /**
+   * Check if the current tenant has billing information configured
+   *
+   * Verifies whether the tenant has valid payment methods attached to their
+   * Stripe customer account. This is useful for:
+   * - Showing billing setup prompts
+   * - Gating premium features behind payment method requirement
+   * - Displaying billing status indicators in UI
+   * - Determining if customer portal access should be shown
+   *
+   * The check verifies:
+   * - Default payment source (card, bank account, etc.)
+   * - Default payment method in invoice settings
+   * - Whether the payment method is valid and active
+   *
+   * Returns `false` if:
+   * - Tenant has no Stripe customer ID
+   * - No payment methods are configured
+   * - User is not authenticated
+   *
+   * @returns Promise resolving to billing status information
+   *
+   * @throws {Error} When the user is not authenticated
+   * @throws {Error} When the API request fails due to network issues
+   * @throws {Error} When the server returns an error response (4xx, 5xx)
+   *
+   * @example
+   * ```typescript
+   * const response = await subscriptionManager.getBillingStatus();
+   *
+   * if (!response.data.has_billing_info) {
+   *   // Show billing setup prompt
+   *   showBillingSetupModal();
+   * } else if (!response.data.is_active) {
+   *   // Payment method exists but may be expired/invalid
+   *   showPaymentMethodUpdatePrompt();
+   * } else {
+   *   // All good - show customer portal link
+   *   showManageBillingButton();
+   * }
+   * ```
+   *
+   * @since 0.6.0
+   * @public
+   * @group Tenant Subscriptions
+   */
+  async getBillingStatus() {
+    try {
+      const response = await this.omnibaseClient.fetch(
+        `/api/v1/tenants/billing-status`,
+        {
+          method: "GET",
+          credentials: "include"
+        }
+      );
+      if (!response.ok) {
+        const errorData = await response.text();
+        throw new Error(
+          `Failed to fetch billing status: ${response.status} - ${errorData}`
+        );
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      console.error("Error fetching billing status:", error);
+      throw error;
+    }
+  }
+};
+
 // src/tenants/user.ts
 var TenantUserManager = class {
   /**
@@ -449,6 +600,58 @@ var TenantUserManager = class {
   constructor(omnibaseClient) {
     this.omnibaseClient = omnibaseClient;
   }
+  /**
+   * Retrieves all users in the active tenant
+   *
+   * This method fetches a list of all users who are members of the current active tenant,
+   * including their basic information (name, email) and assigned role. The operation
+   * requires the requesting user to have appropriate permissions to view tenant users
+   * (typically requires `view_users` permission).
+   *
+   * The returned list includes all tenant members regardless of their role, ordered by
+   * when they joined the tenant (newest first).
+   *
+   * @returns Promise resolving to an array of tenant users with their details
+   *
+   * @throws {Error} When the API request fails (includes status code and error details)
+   * @throws {Error} When the user doesn't have permission to view users
+   * @throws {Error} When the user is not authenticated or no active tenant is set
+   *
+   * @example
+   * ```typescript
+   * // Fetch all users in the active tenant
+   * try {
+   *   const result = await userManager.getAll();
+   *   console.log(`Found ${result.data.length} users`);
+   *
+   *   result.data.forEach(user => {
+   *     console.log(`${user.first_name} ${user.last_name} (${user.email}) - ${user.role}`);
+   *   });
+   * } catch (error) {
+   *   if (error.message.includes('403')) {
+   *     console.error('Insufficient permissions to view users');
+   *   } else {
+   *     console.error('Failed to fetch users:', error);
+   *   }
+   * }
+   * ```
+   *
+   * @since 1.0.0
+   * @public
+   * @group Tenant User Management
+   */
+  async getAll() {
+    const response = await this.omnibaseClient.fetch("/api/v1/tenants/users", {
+      method: "GET"
+    });
+    if (!response.ok) {
+      const errorData = await response.text();
+      throw new Error(
+        `Failed to fetch tenant users: ${response.status} - ${errorData}`
+      );
+    }
+    return await response.json();
+  }
   /**
    * Removes a user from the active tenant
    *
@@ -596,6 +799,7 @@ var TenantHandler = class {
   constructor(omnibaseClient) {
     this.invites = new TenantInviteManager(omnibaseClient);
     this.manage = new TenantManger(omnibaseClient);
+    this.subscriptions = new TenantSubscriptionManager(omnibaseClient);
     this.user = new TenantUserManager(omnibaseClient);
   }
   /**
@@ -660,6 +864,30 @@ var TenantHandler = class {
    * ```
    */
   invites;
+  /**
+   * Tenant subscription and billing management
+   *
+   * Provides access to subscription data and billing status for the
+   * active tenant, including legacy price detection and payment method
+   * verification. All operations are automatically scoped to the user's
+   * currently active tenant.
+   *
+   * @example
+   * ```typescript
+   * // Get active subscriptions
+   * const subs = await tenantHandler.subscriptions.getActive();
+   *
+   * // Check billing status
+   * const status = await tenantHandler.subscriptions.getBillingStatus();
+   * if (!status.data.has_billing_info) {
+   *   console.log('No payment method configured');
+   * }
+   * ```
+   *
+   * @since 0.6.0
+   * @group Tenant Management
+   */
+  subscriptions;
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/tenants/index.d.cts

@@ -1,2 +1,2 @@
-export { d as AcceptTenantInviteRequest, e as AcceptTenantInviteResponse, n as CreateTenantRequest, l as CreateTenantResponse, h as CreateTenantUserInviteRequest, f as CreateTenantUserInviteResponse, k as DeleteTenantResponse, j as SwitchActiveTenantResponse, m as Tenant, T as TenantHandler, g as TenantInvite, i as TenantInviteManager, o as TenantManger } from '../payments/index.cjs';
+export { d as AcceptTenantInviteRequest, e as AcceptTenantInviteResponse, B as BillingStatus, n as CreateTenantRequest, l as CreateTenantResponse, h as CreateTenantUserInviteRequest, f as CreateTenantUserInviteResponse, k as DeleteTenantResponse, G as GetActiveSubscriptionsResponse, q as GetBillingStatusResponse, j as SwitchActiveTenantResponse, m as Tenant, T as TenantHandler, g as TenantInvite, i as TenantInviteManager, o as TenantManger, p as TenantSubscription, r as TenantSubscriptionManager } from '../payments/index.cjs';
 import '@ory/client';

package/dist/tenants/index.d.ts

@@ -1,2 +1,2 @@
-export { d as AcceptTenantInviteRequest, e as AcceptTenantInviteResponse, n as CreateTenantRequest, l as CreateTenantResponse, h as CreateTenantUserInviteRequest, f as CreateTenantUserInviteResponse, k as DeleteTenantResponse, j as SwitchActiveTenantResponse, m as Tenant, T as TenantHandler, g as TenantInvite, i as TenantInviteManager, o as TenantManger } from '../payments/index.js';
+export { d as AcceptTenantInviteRequest, e as AcceptTenantInviteResponse, B as BillingStatus, n as CreateTenantRequest, l as CreateTenantResponse, h as CreateTenantUserInviteRequest, f as CreateTenantUserInviteResponse, k as DeleteTenantResponse, G as GetActiveSubscriptionsResponse, q as GetBillingStatusResponse, j as SwitchActiveTenantResponse, m as Tenant, T as TenantHandler, g as TenantInvite, i as TenantInviteManager, o as TenantManger, p as TenantSubscription, r as TenantSubscriptionManager } from '../payments/index.js';
 import '@ory/client';

package/dist/tenants/index.js

@@ -1,6 +1,6 @@
 import {
   TenantHandler
-} from "../chunk-DQBFDKRC.js";
+} from "../chunk-TFAV5P6I.js";
 export {
   TenantHandler
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnibase/core-js",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "OmniBase core Javascript SDK - framework agnostic",
   "files": [
     "dist/**/*"