@omnibase/core-js 0.5.10 → 0.6.0

package/dist/index.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  OmnibaseClient: () => OmnibaseClient
+  OmnibaseClient: () => OmnibaseClient,
+  StorageClient: () => StorageClient
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -662,6 +663,132 @@ var PermissionsClient = class {
   }
 };
 
+// src/storage/index.ts
+var StorageClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Upload a file to storage
+   *
+   * @param path - Full path for the file (e.g., "public/images/avatar.png", "users/123/private/doc.pdf")
+   * @param file - File or Blob to upload
+   * @param options - Upload options including custom metadata
+   *
+   * @example
+   * ```typescript
+   * const result = await storage.upload(
+   *   'public/avatars/user-123.png',
+   *   file,
+   *   {
+   *     metadata: {
+   *       userId: '123',
+   *       uploadedBy: 'john@example.com',
+   *       tags: ['profile', 'avatar']
+   *     }
+   *   }
+   * );
+   *
+   * // File is automatically uploaded to S3 via the presigned URL
+   * console.log('File uploaded to:', result.path);
+   * ```
+   */
+  async upload(path, file, options) {
+    const metadata = {
+      // File metadata
+      filename: file instanceof File ? file.name : "blob",
+      size: file.size,
+      mime_type: file.type,
+      uploaded_at: (/* @__PURE__ */ new Date()).toISOString(),
+      // Merge custom metadata
+      ...options?.metadata || {}
+    };
+    const response = await this.client.fetch("/api/v1/storage/upload", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        path,
+        metadata
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Upload failed" }));
+      throw new Error(error.error || "Failed to get upload URL");
+    }
+    const responseData = await response.json();
+    const result = responseData.data;
+    const uploadResponse = await fetch(result.upload_url, {
+      method: "PUT",
+      body: file,
+      headers: {
+        "Content-Type": file.type
+      }
+    });
+    if (!uploadResponse.ok) {
+      throw new Error("Failed to upload file to storage");
+    }
+    return result;
+  }
+  /**
+   * Download a file from storage
+   *
+   * @param path - Full path to the file
+   *
+   * @example
+   * ```typescript
+   * const { download_url } = await storage.download('public/images/logo.png');
+   *
+   * // Download the file
+   * const response = await fetch(download_url);
+   * const blob = await response.blob();
+   * ```
+   */
+  async download(path) {
+    const response = await this.client.fetch("/api/v1/storage/download", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        path
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Download failed" }));
+      throw new Error(error.error || "Failed to get download URL");
+    }
+    const responseData = await response.json();
+    return responseData.data;
+  }
+  /**
+   * Delete a file from storage
+   *
+   * @param path - Full path to the file
+   *
+   * @example
+   * ```typescript
+   * await storage.delete('users/123/documents/old-report.pdf');
+   * ```
+   */
+  async delete(path) {
+    const response = await this.client.fetch("/api/v1/storage/object", {
+      method: "DELETE",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        path
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Delete failed" }));
+      throw new Error(error.error || "Failed to delete file");
+    }
+  }
+};
+
 // src/tenants/invites.ts
 var TenantInviteManager = class {
   /**
@@ -832,16 +959,15 @@ var TenantInviteManager = class {
    * @public
    * @group User Management
    */
-  async create(tenantId, inviteData) {
-    if (!tenantId) {
-      throw new Error("Tenant ID is required");
-    }
-    if (!inviteData.email || !inviteData.role) {
-      throw new Error("Email and role are required");
+  async create(inviteData) {
+    if (!inviteData.email || !inviteData.role || !inviteData.invite_url) {
+      throw new Error(
+        "Missing data in `create` - email, role, invite_url and tenant_id are required"
+      );
     }
     try {
       const response = await this.omnibaseClient.fetch(
-        `/api/v1/tenants/${tenantId}/invites`,
+        `/api/v1/tenants/invites`,
         {
           method: "POST",
           headers: {
@@ -912,10 +1038,6 @@ var TenantManger = class {
    *   billing_email: 'billing@acme.com',
    *   user_id: 'user_123'
    * });
-   *
-   * console.log(`Created tenant: ${newTenant.data.tenant.name}`);
-   * // Store the token for authenticated requests
-   * localStorage.setItem('tenant_token', newTenant.data.token);
    * ```
    *
    *
@@ -1146,6 +1268,140 @@ var TenantManger = class {
   }
 };
 
+// src/tenants/user.ts
+var TenantUserManager = class {
+  /**
+   * Creates a new tenant user manager
+   *
+   * @param omnibaseClient - Configured OmnibaseClient instance for API communication
+   *
+   * @group Tenant User Management
+   */
+  constructor(omnibaseClient) {
+    this.omnibaseClient = omnibaseClient;
+  }
+  /**
+   * Removes a user from the active tenant
+   *
+   * This method removes a specified user from the current active tenant. The operation
+   * requires the requesting user to have appropriate permissions (admin or owner role).
+   * The user being removed will lose access to the tenant and all its resources.
+   *
+   * Note: You cannot remove yourself from a tenant using this method. To leave a tenant,
+   * use the appropriate leave or delete tenant operations instead.
+   *
+   * @param data - Request data containing the user ID to remove
+   * @param data.user_id - ID of the user to remove from the tenant
+   *
+   * @returns Promise resolving to an API response confirming the removal
+   *
+   * @throws {Error} When user_id is not provided
+   * @throws {Error} When the API request fails (includes status code and error details)
+   * @throws {Error} When the user doesn't have permission to remove users
+   * @throws {Error} When the specified user is not a member of the tenant
+   *
+   * @example
+   * ```typescript
+   * // Remove a user from the active tenant
+   * try {
+   *   await userManager.remove({ user_id: 'user_abc123' });
+   *   console.log('User removed successfully');
+   * } catch (error) {
+   *   if (error.message.includes('403')) {
+   *     console.error('Insufficient permissions to remove user');
+   *   } else if (error.message.includes('404')) {
+   *     console.error('User not found in tenant');
+   *   } else {
+   *     console.error('Failed to remove user:', error);
+   *   }
+   * }
+   * ```
+   *
+   * @since 1.0.0
+   * @public
+   * @group Tenant User Management
+   */
+  async remove(data) {
+    if (!data.user_id) {
+      throw new Error("user_id is required");
+    }
+    const response = await this.omnibaseClient.fetch("/api/v1/tenants/users", {
+      method: "DELETE",
+      body: JSON.stringify(data)
+    });
+    if (!response.ok) {
+      const errorData = await response.text();
+      throw new Error(
+        `Failed to delete user from tenant: ${response.status} - ${errorData}`
+      );
+    }
+    return await response.json();
+  }
+  /**
+   * Updates a user's role within the active tenant
+   *
+   * This method changes the role of a specified user in the current active tenant. The operation
+   * requires the requesting user to have appropriate permissions (typically admin or owner role).
+   * Role updates take effect immediately and affect the user's permissions and access rights
+   * within the tenant.
+   *
+   * Common roles include 'admin', 'member', and 'viewer', but the exact roles available depend
+   * on your tenant's configuration. Changing a user's role will modify their ability to perform
+   * various operations within the tenant.
+   *
+   * @param data - Request data containing the user ID and new role
+   * @param data.user_id - ID of the user whose role is being updated
+   * @param data.role - New role to assign to the user
+   *
+   * @returns Promise resolving to an API response confirming the role update
+   *
+   * @throws {Error} When user_id or role is not provided
+   * @throws {Error} When the API request fails (includes status code and error details)
+   * @throws {Error} When the user doesn't have permission to update roles
+   * @throws {Error} When the specified user is not a member of the tenant
+   * @throws {Error} When the specified role is invalid or not allowed
+   *
+   * @example
+   * ```typescript
+   * // Update a user's role to admin
+   * try {
+   *   const result = await userManager.updateRole({
+   *     user_id: 'user_abc123',
+   *     role: 'admin'
+   *   });
+   *   console.log('Role updated successfully:', result.data.message);
+   * } catch (error) {
+   *   if (error.message.includes('403')) {
+   *     console.error('Insufficient permissions to update roles');
+   *   } else if (error.message.includes('404')) {
+   *     console.error('User not found in tenant');
+   *   } else {
+   *     console.error('Failed to update role:', error);
+   *   }
+   * }
+   * ```
+   *
+   * @since 1.0.0
+   * @public
+   * @group Tenant User Management
+   */
+  async updateRole(data) {
+    if (!data.role || !data.user_id)
+      throw new Error("user_id and role is required");
+    const response = await this.omnibaseClient.fetch("/api/v1/tenants/users", {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+    if (!response.ok) {
+      const errorData = await response.text();
+      throw new Error(
+        `Failed to update users role: ${response.status} - ${errorData}`
+      );
+    }
+    return await response.json();
+  }
+};
+
 // src/tenants/handler.ts
 var TenantHandler = class {
   /**
@@ -1169,10 +1425,27 @@ var TenantHandler = class {
    * @group Tenant Management
    */
   constructor(omnibaseClient) {
-    this.omnibaseClient = omnibaseClient;
-    this.invites = new TenantInviteManager(this.omnibaseClient);
-    this.manage = new TenantManger(this.omnibaseClient);
+    this.invites = new TenantInviteManager(omnibaseClient);
+    this.manage = new TenantManger(omnibaseClient);
+    this.user = new TenantUserManager(omnibaseClient);
   }
+  /**
+   * Tenant user management operations
+   *
+   * Provides access to operations for managing users within tenants, including
+   * removing users from the active tenant. All operations respect user permissions
+   * and tenant ownership rules.
+   *
+   * @example
+   * ```typescript
+   * // Remove a user from the active tenant
+   * await tenantHandler.user.remove({ user_id: 'user_123' });
+   * ```
+   *
+   * @since 1.0.0
+   * @group Tenant Management
+   */
+  user;
   /**
    * Core tenant management operations
    *
@@ -1252,6 +1525,20 @@ var OmnibaseClient = class {
   payments = new PaymentHandler(this);
   tenants = new TenantHandler(this);
   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);
@@ -1263,5 +1550,6 @@ var OmnibaseClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  OmnibaseClient
+  OmnibaseClient,
+  StorageClient
 });

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-PNP3T7XU.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-LMDKQ6Z2.js";
 
 // src/client.ts
 var OmnibaseClient = class {
@@ -41,6 +44,20 @@ var OmnibaseClient = class {
   payments = new PaymentHandler(this);
   tenants = new TenantHandler(this);
   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 +68,6 @@ var OmnibaseClient = class {
   }
 };
 export {
-  OmnibaseClient
+  OmnibaseClient,
+  StorageClient
 };