@omnibase/core-js 0.5.10 → 0.7.0

package/dist/index.d.cts

@@ -1,3 +1,3 @@
-export { j as ApiResponse, i as OmnibaseClient, O as OmnibaseClientConfig } from './payments/index.cjs';
+export { m as ApiResponse, D as DownloadResult, l as OmnibaseClient, O as OmnibaseClientConfig, S as StorageClient, U as UploadOptions, a as UploadResult } from './payments/index.cjs';
 import './permissions/index.cjs';
 import '@ory/client';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { j as ApiResponse, i as OmnibaseClient, O as OmnibaseClientConfig } from './payments/index.js';
+export { m as ApiResponse, D as DownloadResult, l as OmnibaseClient, O as OmnibaseClientConfig, S as StorageClient, U as UploadOptions, a as UploadResult } from './payments/index.js';
 import './permissions/index.js';
 import '@ory/client';

package/dist/index.js

@@ -1,12 +1,15 @@
+import {
+  PaymentHandler
+} from "./chunk-QPW6G4PA.js";
 import {
   PermissionsClient
 } from "./chunk-DDFBRGMG.js";
 import {
-  PaymentHandler
-} from "./chunk-PNP3T7XU.js";
+  StorageClient
+} from "./chunk-I6DMWC32.js";
 import {
   TenantHandler
-} from "./chunk-L7EZC6WP.js";
+} from "./chunk-6OGESVXW.js";
 
 // src/client.ts
 var OmnibaseClient = class {
@@ -39,8 +42,105 @@ var OmnibaseClient = class {
    * ```
    */
   payments = new PaymentHandler(this);
+  /**
+   * Main tenant management handler
+   *
+   * This is the primary entry point for all tenant-related operations in the
+   * Omnibase SDK. It provides a unified interface to tenant management,
+   * user management, and invitation functionality through dedicated manager instances.
+   *
+   * The handler follows the composition pattern, combining specialized managers
+   * for different aspects of tenant functionality:
+   * - `manage`: Core tenant operations (create, delete, switch)
+   * - `invites`: User invitation management (create, accept)
+   * - `user`: Tenant user operations (remove, update role)
+   *
+   * All operations are performed within the context of the authenticated user
+   * and respect tenant-level permissions and row-level security policies.
+   *
+   * @example
+   * ```typescript
+   * // Create a new tenant
+   * const tenant = await omnibase.tenants.manage.createTenant({
+   *   name: 'My Company',
+   *   billing_email: 'billing@company.com',
+   *   user_id: 'user_123'
+   * });
+   *
+   * // Invite users to the tenant
+   * const invite = await omnibase.tenants.invites.create({
+   *   email: 'colleague@company.com',
+   *   role: 'member',
+   *   invite_url: 'https://yourapp.com/accept-invite'
+   * });
+   *
+   * // Switch to the new tenant
+   * await omnibase.tenants.manage.switchActiveTenant(tenant.data.tenant.id);
+   * ```
+   *
+   * @since 0.6.0
+   * @public
+   * @group Tenant Management
+   */
   tenants = new TenantHandler(this);
+  /**
+   * Client for managing permissions and relationships using Ory Keto
+   *
+   * This client provides access to Ory Keto's permission system, allowing you to
+   * create, manage, and check relationships between subjects and objects. It handles
+   * both read operations (permission checks) and write operations (relationship management).
+   *
+   * The client automatically configures separate endpoints for read and write operations
+   * to optimize performance and security by following Ory Keto's recommended architecture.
+   *
+   * @example
+   * ```typescript
+   * // Check if a user can view a tenant
+   * const canView = await omnibase.permissions.permissions.checkPermission(
+   *   undefined,
+   *   {
+   *     namespace: 'Tenant',
+   *     object: 'tenant_123',
+   *     relation: 'view',
+   *     subjectId: 'user_456'
+   *   }
+   * );
+   *
+   * if (canView.data.allowed) {
+   *   console.log('User can view the tenant');
+   * }
+   *
+   * // Create a relationship making a user an owner of a tenant
+   * await omnibase.permissions.relationships.createRelationship(
+   *   undefined,
+   *   {
+   *     namespace: 'Tenant',
+   *     object: 'tenant_123',
+   *     relation: 'owners',
+   *     subjectId: 'user_456'
+   *   }
+   * );
+   * ```
+   *
+   * @since 0.6.0
+   * @public
+   * @group Permissions
+   */
   permissions;
+  /**
+   * Storage client for file upload/download operations
+   *
+   * @example
+   * ```typescript
+   * // Upload with metadata
+   * await omnibase.storage.bucket('documents').upload(
+   *   'report.pdf',
+   *   file,
+   *   { metadata: { department: 'engineering' } }
+   * );
+   * ```
+   */
+  storage = new StorageClient(this);
   async fetch(endpoint, options = {}) {
     if (this.config.fetch)
       return this.config.fetch(this.config.api_url + endpoint, options);
@@ -51,5 +151,6 @@ var OmnibaseClient = class {
   }
 };
 export {
-  OmnibaseClient
+  OmnibaseClient,
+  StorageClient
 };

package/dist/payments/index.cjs

@@ -60,31 +60,20 @@ var CheckoutManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * Creating a checkout session (mode is auto-detected):
    * ```typescript
    * const session = await checkoutManager.createSession({
-   *   price_id: 'price_one_time_product',
+   *   price_id: 'price_monthly_pro',
    *   success_url: 'https://app.com/success',
    *   cancel_url: 'https://app.com/cancel'
    * });
    *
    * // Redirect to Stripe checkout
-   * window.location.href = session.data.url;
-   * ```
-   *
-   * @example
-   * Checkout with session tracking:
-   * ```typescript
-   * const session = await checkoutManager.createSession({
-   *   price_id: 'price_monthly_plan',
-   *   success_url: 'https://app.com/dashboard?session_id={CHECKOUT_SESSION_ID}',
-   *   cancel_url: 'https://app.com/pricing',
-   * });
-   *
-   * console.log(`Session created: ${session.data.sessionId}`);
+   * if (session.data?.url) {
+   *   window.location.href = session.data.url;
+   * }
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Checkout
    */
   async createSession(options) {
@@ -305,7 +294,7 @@ var PortalManager = class {
   /**
    * Initialize the portal manager
    *
-   * @param paymentHandler - Payment handler instance for API communication
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @group Portal
    */
@@ -332,32 +321,18 @@ var PortalManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * Basic portal creation:
    * ```typescript
    * const portal = await portalManager.create({
    *   return_url: 'https://myapp.com/account/billing'
    * });
    *
    * // Redirect user to portal
-   * window.location.href = portal.data.url;
-   * ```
-   *
-   * @example
-   * With error handling:
-   * ```typescript
-   * try {
-   *   const portal = await portalManager.create({
-   *     return_url: window.location.origin + '/billing'
-   *   });
-   *
+   * if (portal.data?.url) {
    *   window.location.href = portal.data.url;
-   * } catch (error) {
-   *   console.error('Failed to create portal session:', error);
-   *   showErrorMessage('Unable to access billing portal. Please try again.');
    * }
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Portal
    */
   async create(options) {
@@ -387,7 +362,7 @@ var UsageManager = class {
   /**
    * Initialize the usage manager
    *
-   * @param paymentHandler - Payment handler instance for API communication
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @group Usage
    */
@@ -416,7 +391,6 @@ var UsageManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * API call tracking:
    * ```typescript
    * // Record each API call
    * await usageManager.recordUsage({
@@ -425,37 +399,7 @@ var UsageManager = class {
    * });
    * ```
    *
-   * @example
-   * Batch usage recording:
-   * ```typescript
-   * // Record multiple operations at once
-   * const usageEvents = [
-   *   { meter_event_name: 'compute_hours', value: '0.5' },
-   *   { meter_event_name: 'storage_gb', value: '10' },
-   *   { meter_event_name: 'api_calls', value: '50' }
-   * ];
-   *
-   * for (const event of usageEvents) {
-   *   await usageManager.recordUsage(event);
-   * }
-   * ```
-   *
-   * @example
-   * With error handling:
-   * ```typescript
-   * try {
-   *   await usageManager.recordUsage({
-   *     meter_event_name: 'file_uploads',
-   *     value: String(uploadedFiles.length)
-   *   });
-   * } catch (error) {
-   *   console.error('Failed to record usage:', error);
-   *   // Usage recording failure shouldn't block user operations
-   *   // but should be logged for billing accuracy
-   * }
-   * ```
-   *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Usage
    */
   async recordUsage(options) {
@@ -480,20 +424,20 @@ var UsageManager = class {
 // src/payments/handler.ts
 var PaymentHandler = class {
   /**
-   * Initialize the payment handler with API configuration
+   * Initialize the payment handler with OmnibaseClient
    *
-   * Creates a new payment handler instance that will communicate with
-   * the specified API endpoint. The handler automatically handles
-   * request formatting and authentication headers.
+   * Creates a new payment handler instance with access to all payment
+   * operations including checkout, configuration, portal, and usage tracking.
+   * The handler uses the provided OmnibaseClient for API communication.
    *
-   * @param apiUrl - Base URL for the payment API endpoint
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @example
    * ```typescript
-   * const paymentHandler = new PaymentHandler('https://api.myapp.com');
+   * const paymentHandler = new PaymentHandler(omnibaseClient);
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Client
    */
   constructor(omnibaseClient) {
@@ -512,10 +456,14 @@ var PaymentHandler = class {
    * @example
    * ```typescript
    * const session = await paymentHandler.checkout.createSession({
-   *   price_id: 'price_monthly',
+   *   price_id: 'price_monthly_pro',
    *   success_url: window.location.origin + '/success',
    *   cancel_url: window.location.origin + '/pricing'
    * });
+   *
+   * if (session.data?.url) {
+   *   window.location.href = session.data.url;
+   * }
    * ```
    */
   checkout;