@omnibase/core-js 0.7.2 → 0.7.4

package/dist/payments/index.d.cts

@@ -1211,21 +1211,41 @@ interface UpdateRoleRequest {
 /**
  * Request body for assigning a role to a user
  *
+ * Supports assigning by either role ID or role name for flexibility.
+ * When using role_name, the system will find the role by name within
+ * the current tenant's scope (including system roles).
+ *
  * @example
+ * By role ID:
  * ```typescript
  * {
  *   role_id: 'role_456'
  * }
  * ```
  *
+ * @example
+ * By role name:
+ * ```typescript
+ * {
+ *   role_name: 'owner'
+ * }
+ * ```
+ *
  * @since 0.7.0
  * @public
  */
 interface AssignRoleRequest {
     /**
      * ID of the role to assign to the user
+     * Use either role_id or role_name, not both
      */
-    role_id: string;
+    role_id?: string;
+    /**
+     * Name of the role to assign to the user
+     * Use either role_id or role_name, not both
+     * @example 'owner', 'admin', 'billing_manager'
+     */
+    role_name?: string;
 }
 
 /**
@@ -1378,18 +1398,42 @@ declare class RolesHandler {
      * Keto relationship tuples based on the role's permissions. The user
      * immediately gains all permissions defined in the role.
      *
+     * Supports assignment by either role ID or role name for flexibility.
+     *
      * @param userId - ID of user to assign role to
-     * @param request - Assignment request with role ID
+     * @param request - Assignment request with either role_id or role_name
      *
      * @example
+     * Assign by role ID:
      * ```typescript
-     * // Assign billing manager role to user
      * await omnibase.permissions.roles.assign('user_123', {
      *   role_id: 'role_456'
      * });
+     * ```
+     *
+     * @example
+     * Assign by role name (system or custom role):
+     * ```typescript
+     * // Assign system role
+     * await omnibase.permissions.roles.assign('user_123', {
+     *   role_name: 'owner'
+     * });
      *
-     * // User now has all permissions from the role
-     * const canManageBilling = await omnibase.permissions.permissions.checkPermission(
+     * // Assign custom role
+     * await omnibase.permissions.roles.assign('user_456', {
+     *   role_name: 'billing_manager'
+     * });
+     * ```
+     *
+     * @example
+     * Verify permissions after assignment:
+     * ```typescript
+     * await omnibase.permissions.roles.assign('user_123', {
+     *   role_name: 'admin'
+     * });
+     *
+     * // User now has all permissions from the admin role
+     * const canManage = await omnibase.permissions.permissions.checkPermission(
      *   undefined,
      *   {
      *     namespace: 'Tenant',
@@ -1398,7 +1442,7 @@ declare class RolesHandler {
      *     subjectId: 'user_123'
      *   }
      * );
-     * // canManageBilling.data.allowed === true
+     * // canManage.data.allowed === true
      * ```
      */
     assign(userId: string, request: AssignRoleRequest): Promise<void>;
@@ -2314,8 +2358,6 @@ declare class TenantManger {
      * - Billing subscriptions are cancelled (if applicable)
      * - Audit logs for deletion are maintained for compliance
      *
-     * @param tenantId - The unique identifier of the tenant to delete
-     *
      * @returns Promise resolving to a confirmation message
      *
      * @throws {Error} When the tenantId parameter is missing or empty
@@ -2327,8 +2369,6 @@ declare class TenantManger {
      *
      * @example
      * ```typescript
-     * const tenantToDelete = 'tenant_abc123';
-     *
      * // Always confirm before deleting
      * const userConfirmed = confirm(
      *   'Are you sure you want to delete this tenant? This action cannot be undone.'
@@ -2336,7 +2376,7 @@ declare class TenantManger {
      *
      * if (userConfirmed) {
      *   try {
-     *     const result = await tenantManager.deleteTenant(tenantToDelete);
+     *     const result = await tenantManager.deleteTenant();
      *     console.log(result.data.message);
      *
      *     // Redirect user away from deleted tenant
@@ -2351,7 +2391,7 @@ declare class TenantManger {
      * @public
      * @group Tenant Management
      */
-    deleteTenant(tenantId: string): Promise<DeleteTenantResponse>;
+    deleteTenant(): Promise<DeleteTenantResponse>;
     /**
      * Switches the user's active tenant context
      *

package/dist/payments/index.d.ts

@@ -1211,21 +1211,41 @@ interface UpdateRoleRequest {
 /**
  * Request body for assigning a role to a user
  *
+ * Supports assigning by either role ID or role name for flexibility.
+ * When using role_name, the system will find the role by name within
+ * the current tenant's scope (including system roles).
+ *
  * @example
+ * By role ID:
  * ```typescript
  * {
  *   role_id: 'role_456'
  * }
  * ```
  *
+ * @example
+ * By role name:
+ * ```typescript
+ * {
+ *   role_name: 'owner'
+ * }
+ * ```
+ *
  * @since 0.7.0
  * @public
  */
 interface AssignRoleRequest {
     /**
      * ID of the role to assign to the user
+     * Use either role_id or role_name, not both
      */
-    role_id: string;
+    role_id?: string;
+    /**
+     * Name of the role to assign to the user
+     * Use either role_id or role_name, not both
+     * @example 'owner', 'admin', 'billing_manager'
+     */
+    role_name?: string;
 }
 
 /**
@@ -1378,18 +1398,42 @@ declare class RolesHandler {
      * Keto relationship tuples based on the role's permissions. The user
      * immediately gains all permissions defined in the role.
      *
+     * Supports assignment by either role ID or role name for flexibility.
+     *
      * @param userId - ID of user to assign role to
-     * @param request - Assignment request with role ID
+     * @param request - Assignment request with either role_id or role_name
      *
      * @example
+     * Assign by role ID:
      * ```typescript
-     * // Assign billing manager role to user
      * await omnibase.permissions.roles.assign('user_123', {
      *   role_id: 'role_456'
      * });
+     * ```
+     *
+     * @example
+     * Assign by role name (system or custom role):
+     * ```typescript
+     * // Assign system role
+     * await omnibase.permissions.roles.assign('user_123', {
+     *   role_name: 'owner'
+     * });
      *
-     * // User now has all permissions from the role
-     * const canManageBilling = await omnibase.permissions.permissions.checkPermission(
+     * // Assign custom role
+     * await omnibase.permissions.roles.assign('user_456', {
+     *   role_name: 'billing_manager'
+     * });
+     * ```
+     *
+     * @example
+     * Verify permissions after assignment:
+     * ```typescript
+     * await omnibase.permissions.roles.assign('user_123', {
+     *   role_name: 'admin'
+     * });
+     *
+     * // User now has all permissions from the admin role
+     * const canManage = await omnibase.permissions.permissions.checkPermission(
      *   undefined,
      *   {
      *     namespace: 'Tenant',
@@ -1398,7 +1442,7 @@ declare class RolesHandler {
      *     subjectId: 'user_123'
      *   }
      * );
-     * // canManageBilling.data.allowed === true
+     * // canManage.data.allowed === true
      * ```
      */
     assign(userId: string, request: AssignRoleRequest): Promise<void>;
@@ -2314,8 +2358,6 @@ declare class TenantManger {
      * - Billing subscriptions are cancelled (if applicable)
      * - Audit logs for deletion are maintained for compliance
      *
-     * @param tenantId - The unique identifier of the tenant to delete
-     *
      * @returns Promise resolving to a confirmation message
      *
      * @throws {Error} When the tenantId parameter is missing or empty
@@ -2327,8 +2369,6 @@ declare class TenantManger {
      *
      * @example
      * ```typescript
-     * const tenantToDelete = 'tenant_abc123';
-     *
      * // Always confirm before deleting
      * const userConfirmed = confirm(
      *   'Are you sure you want to delete this tenant? This action cannot be undone.'
@@ -2336,7 +2376,7 @@ declare class TenantManger {
      *
      * if (userConfirmed) {
      *   try {
-     *     const result = await tenantManager.deleteTenant(tenantToDelete);
+     *     const result = await tenantManager.deleteTenant();
      *     console.log(result.data.message);
      *
      *     // Redirect user away from deleted tenant
@@ -2351,7 +2391,7 @@ declare class TenantManger {
      * @public
      * @group Tenant Management
      */
-    deleteTenant(tenantId: string): Promise<DeleteTenantResponse>;
+    deleteTenant(): Promise<DeleteTenantResponse>;
     /**
      * Switches the user's active tenant context
      *

package/dist/permissions/index.cjs

@@ -52,9 +52,12 @@ var RolesHandler = class {
    * ```
    */
   async getDefinitions() {
-    const response = await this.client.fetch("/api/v1/roles/definitions", {
-      method: "GET"
-    });
+    const response = await this.client.fetch(
+      "/api/v1/permissions/definitions",
+      {
+        method: "GET"
+      }
+    );
     const data = await response.json();
     if (!response.ok || data.error) {
       throw new Error(data.error || "Failed to fetch definitions");
@@ -81,7 +84,7 @@ var RolesHandler = class {
    * ```
    */
   async list() {
-    const response = await this.client.fetch("/api/v1/roles/roles", {
+    const response = await this.client.fetch("/api/v1/permissions/roles", {
       method: "GET"
     });
     const data = await response.json();
@@ -127,7 +130,7 @@ var RolesHandler = class {
    * ```
    */
   async create(request) {
-    const response = await this.client.fetch("/api/v1/roles/roles", {
+    const response = await this.client.fetch("/api/v1/permissions/roles", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(request)
@@ -163,11 +166,14 @@ var RolesHandler = class {
    * ```
    */
   async update(roleId, request) {
-    const response = await this.client.fetch(`/api/v1/roles/roles/${roleId}`, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(request)
-    });
+    const response = await this.client.fetch(
+      `/api/v1/permissions/roles/${roleId}`,
+      {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(request)
+      }
+    );
     const data = await response.json();
     if (!response.ok || data.error) {
       throw new Error(data.error || "Failed to update role");
@@ -189,9 +195,12 @@ var RolesHandler = class {
    * ```
    */
   async delete(roleId) {
-    const response = await this.client.fetch(`/api/v1/roles/roles/${roleId}`, {
-      method: "DELETE"
-    });
+    const response = await this.client.fetch(
+      `/api/v1/permissions/roles/${roleId}`,
+      {
+        method: "DELETE"
+      }
+    );
     const data = await response.json();
     if (!response.ok || data.error) {
       throw new Error(data.error || "Failed to delete role");
@@ -204,18 +213,42 @@ var RolesHandler = class {
    * Keto relationship tuples based on the role's permissions. The user
    * immediately gains all permissions defined in the role.
    *
+   * Supports assignment by either role ID or role name for flexibility.
+   *
    * @param userId - ID of user to assign role to
-   * @param request - Assignment request with role ID
+   * @param request - Assignment request with either role_id or role_name
    *
    * @example
+   * Assign by role ID:
    * ```typescript
-   * // Assign billing manager role to user
    * await omnibase.permissions.roles.assign('user_123', {
    *   role_id: 'role_456'
    * });
+   * ```
+   *
+   * @example
+   * Assign by role name (system or custom role):
+   * ```typescript
+   * // Assign system role
+   * await omnibase.permissions.roles.assign('user_123', {
+   *   role_name: 'owner'
+   * });
+   *
+   * // Assign custom role
+   * await omnibase.permissions.roles.assign('user_456', {
+   *   role_name: 'billing_manager'
+   * });
+   * ```
+   *
+   * @example
+   * Verify permissions after assignment:
+   * ```typescript
+   * await omnibase.permissions.roles.assign('user_123', {
+   *   role_name: 'admin'
+   * });
    *
-   * // User now has all permissions from the role
-   * const canManageBilling = await omnibase.permissions.permissions.checkPermission(
+   * // User now has all permissions from the admin role
+   * const canManage = await omnibase.permissions.permissions.checkPermission(
    *   undefined,
    *   {
    *     namespace: 'Tenant',
@@ -224,12 +257,12 @@ var RolesHandler = class {
    *     subjectId: 'user_123'
    *   }
    * );
-   * // canManageBilling.data.allowed === true
+   * // canManage.data.allowed === true
    * ```
    */
   async assign(userId, request) {
     const response = await this.client.fetch(
-      `/api/v1/roles/users/${userId}/roles`,
+      `/api/v1/permissions/users/${userId}/roles`,
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },

package/dist/permissions/index.js

@@ -1,7 +1,7 @@
 import {
   PermissionsClient,
   RolesHandler
-} from "../chunk-JNM7XP7L.js";
+} from "../chunk-V4FWENQQ.js";
 export {
   PermissionsClient,
   RolesHandler

package/dist/tenants/index.cjs

@@ -303,8 +303,6 @@ var TenantManger = class {
    * - Billing subscriptions are cancelled (if applicable)
    * - Audit logs for deletion are maintained for compliance
    *
-   * @param tenantId - The unique identifier of the tenant to delete
-   *
    * @returns Promise resolving to a confirmation message
    *
    * @throws {Error} When the tenantId parameter is missing or empty
@@ -316,8 +314,6 @@ var TenantManger = class {
    *
    * @example
    * ```typescript
-   * const tenantToDelete = 'tenant_abc123';
-   *
    * // Always confirm before deleting
    * const userConfirmed = confirm(
    *   'Are you sure you want to delete this tenant? This action cannot be undone.'
@@ -325,7 +321,7 @@ var TenantManger = class {
    *
    * if (userConfirmed) {
    *   try {
-   *     const result = await tenantManager.deleteTenant(tenantToDelete);
+   *     const result = await tenantManager.deleteTenant();
    *     console.log(result.data.message);
    *
    *     // Redirect user away from deleted tenant
@@ -340,21 +336,15 @@ var TenantManger = class {
    * @public
    * @group Tenant Management
    */
-  async deleteTenant(tenantId) {
-    if (!tenantId) {
-      throw new Error("Tenant ID is required");
-    }
+  async deleteTenant() {
     try {
-      const response = await this.omnibaseClient.fetch(
-        `/api/v1/tenants/${tenantId}`,
-        {
-          method: "DELETE",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          credentials: "include"
-        }
-      );
+      const response = await this.omnibaseClient.fetch(`/api/v1/tenants`, {
+        method: "DELETE",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        credentials: "include"
+      });
       if (!response.ok) {
         const errorData = await response.text();
         throw new Error(

package/dist/tenants/index.js

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

package/package.json

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