@sudobility/types 1.9.42 → 1.9.44

package/CLAUDE.md

@@ -1,8 +1,15 @@
 # Claude AI Assistant Configuration
 
+This file provides comprehensive guidance for AI assistants (Claude Code, GitHub Copilot, Cursor, etc.) working with this codebase.
+
 ## Project Overview
 
-This is `@sudobility/types` v1.8.29, a comprehensive TypeScript types library for Web3 email applications. It provides shared type definitions, interfaces, enums, and utility functions used across multiple Web3 email platform projects.
+**Package**: `@sudobility/types`
+**Version**: 1.9.43
+**Type**: ES Module + CommonJS (dual output)
+**Test Coverage**: 107 tests across 7 test files
+
+A comprehensive TypeScript types library for Web3 email applications. It provides shared type definitions, interfaces, enums, and utility functions used across multiple Web3 email platform projects.
 
 ## Key Architecture
 
@@ -78,7 +85,7 @@ bun run build
 # Watch mode for development
 bun run dev
 
-# Run all 219 tests
+# Run all 107 tests
 bun test
 
 # Type checking
@@ -111,7 +118,7 @@ bun run ai:docs          # Generate AI documentation
 ## Testing Strategy
 
 - **Framework**: Vitest for fast unit testing
-- **Coverage**: 219 comprehensive tests covering all utilities and type guards
+- **Coverage**: 107 comprehensive tests covering all utilities and type guards
 - **Structure**: Tests mirror source structure in `test/` directory
 - **Focus**: Type guards, validation functions, utility functions, and API contracts
 
@@ -225,13 +232,13 @@ bun run test:coverage
 4. **Verification**: Comprehensive quality pipeline
 
 ### Quality Standards:
-- **267 tests passing**: Complete test coverage maintained
+- **107 tests passing**: Complete test coverage maintained
 - **Zero lint errors**: ESLint v9 with strict TypeScript rules
 - **Perfect formatting**: Prettier integration
 - **Type safety**: Strict TypeScript with comprehensive checking
 - **Documentation**: JSDoc comments on all public APIs
 
-## Recent Changes (v1.8.29)
+## Recent Changes (v1.9.43)
 
 ### Type System Improvements
 - **Enum Conversion**: Converted 11 string literal types to enums for better type safety

package/dist/types/entity/entity.cjs

@@ -21,15 +21,18 @@ var EntityType;
 /**
  * Role of a user within an entity.
  * Determines permissions for various operations.
+ * - OWNER: Only for organizations. Full access including user management.
+ * - ADMIN: Can manage projects and endpoints. Used for personal entities.
+ * - MEMBER: Read-only access to projects and endpoints.
  */
 var EntityRole;
 (function (EntityRole) {
-    /** Full access: manage entity, members, projects, and API keys */
+    /** Organization owner: full access including invite users, change roles, manage projects/endpoints */
+    EntityRole["OWNER"] = "owner";
+    /** Can manage projects and endpoints, but cannot manage users. Default role for personal entities. */
     EntityRole["ADMIN"] = "admin";
-    /** Can create/edit projects and API keys, but cannot manage members */
-    EntityRole["MANAGER"] = "manager";
-    /** Read-only access to projects and API keys */
-    EntityRole["VIEWER"] = "viewer";
+    /** Read-only access to projects and endpoints */
+    EntityRole["MEMBER"] = "member";
 })(EntityRole || (exports.EntityRole = EntityRole = {}));
 /**
  * Status of an entity invitation.

package/dist/types/entity/entity.d.ts

@@ -14,14 +14,17 @@ export declare enum EntityType {
 /**
  * Role of a user within an entity.
  * Determines permissions for various operations.
+ * - OWNER: Only for organizations. Full access including user management.
+ * - ADMIN: Can manage projects and endpoints. Used for personal entities.
+ * - MEMBER: Read-only access to projects and endpoints.
  */
 export declare enum EntityRole {
-    /** Full access: manage entity, members, projects, and API keys */
+    /** Organization owner: full access including invite users, change roles, manage projects/endpoints */
+    OWNER = "owner",
+    /** Can manage projects and endpoints, but cannot manage users. Default role for personal entities. */
     ADMIN = "admin",
-    /** Can create/edit projects and API keys, but cannot manage members */
-    MANAGER = "manager",
-    /** Read-only access to projects and API keys */
-    VIEWER = "viewer"
+    /** Read-only access to projects and endpoints */
+    MEMBER = "member"
 }
 /**
  * Status of an entity invitation.
@@ -39,6 +42,8 @@ export declare enum InvitationStatus {
 /**
  * An entity represents a workspace that can own projects and API keys.
  * Can be either a personal workspace (one per user) or an organization (shared).
+ * - Personal entities: User has 'admin' role (no user management needed).
+ * - Organizations: Creator has 'owner' role (can manage users, projects, endpoints).
  */
 export interface Entity {
     /** Unique identifier (UUID) */
@@ -53,8 +58,6 @@ export interface Entity {
     description: string | null;
     /** Optional avatar URL */
     avatarUrl: string | null;
-    /** User ID of the entity owner/creator */
-    ownerUserId: string;
     /** ISO 8601 timestamp of creation */
     createdAt: string;
     /** ISO 8601 timestamp of last update */
@@ -81,16 +84,19 @@ export interface EntityMemberUser {
 }
 /**
  * A membership record linking a user to an entity with a specific role.
+ * This table manages all user-entity roles including organization ownership.
  */
 export interface EntityMember {
     /** Unique identifier (UUID) */
     id: string;
     /** Entity this membership belongs to */
     entityId: string;
-    /** User who is a member */
+    /** User who is a member (firebase_uid) */
     userId: string;
-    /** User's role in the entity */
+    /** User's role in the entity (owner, admin, member) */
     role: EntityRole;
+    /** Whether this membership is active (false = soft deleted) */
+    isActive: boolean;
     /** ISO 8601 timestamp when user joined */
     joinedAt: string;
     /** ISO 8601 timestamp of record creation */

package/dist/types/entity/entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/entity/entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;CAC9B;AAED;;;GAGG;AACH,oBAAY,UAAU;IACpB,kEAAkE;IAClE,KAAK,UAAU;IACf,uEAAuE;IACvE,OAAO,YAAY;IACnB,gDAAgD;IAChD,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,QAAQ,aAAa;IACrB,yCAAyC;IACzC,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,OAAO,YAAY;CACpB;AAMD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,UAAU,CAAC;IACvB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,yCAAyC;IACzC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B"}
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/entity/entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;CAC9B;AAED;;;;;;GAMG;AACH,oBAAY,UAAU;IACpB,sGAAsG;IACtG,KAAK,UAAU;IACf,sGAAsG;IACtG,KAAK,UAAU;IACf,iDAAiD;IACjD,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,QAAQ,aAAa;IACrB,yCAAyC;IACzC,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,OAAO,YAAY;CACpB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,UAAU,CAAC;IACvB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,yCAAyC;IACzC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,IAAI,EAAE,UAAU,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B"}

package/dist/types/entity/entity.js

@@ -21,15 +21,18 @@ var EntityType;
 /**
  * Role of a user within an entity.
  * Determines permissions for various operations.
+ * - OWNER: Only for organizations. Full access including user management.
+ * - ADMIN: Can manage projects and endpoints. Used for personal entities.
+ * - MEMBER: Read-only access to projects and endpoints.
  */
 var EntityRole;
 (function (EntityRole) {
-    /** Full access: manage entity, members, projects, and API keys */
+    /** Organization owner: full access including invite users, change roles, manage projects/endpoints */
+    EntityRole["OWNER"] = "owner";
+    /** Can manage projects and endpoints, but cannot manage users. Default role for personal entities. */
     EntityRole["ADMIN"] = "admin";
-    /** Can create/edit projects and API keys, but cannot manage members */
-    EntityRole["MANAGER"] = "manager";
-    /** Read-only access to projects and API keys */
-    EntityRole["VIEWER"] = "viewer";
+    /** Read-only access to projects and endpoints */
+    EntityRole["MEMBER"] = "member";
 })(EntityRole || (exports.EntityRole = EntityRole = {}));
 /**
  * Status of an entity invitation.

package/dist/types/entity/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/types/entity/entity.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAA2C;AAC3C,QAAQ;AACR,2CAA2C;AAE3C;;;;GAIG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,mCAAqB,CAAA;IACrB,2CAA6B,CAAA;AAC/B,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED;;;GAGG;AACH,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,kEAAkE;IAClE,6BAAe,CAAA;IACf,uEAAuE;IACvE,iCAAmB,CAAA;IACnB,gDAAgD;IAChD,+BAAiB,CAAA;AACnB,CAAC,EAPW,UAAU,0BAAV,UAAU,QAOrB;AAED;;GAEG;AACH,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,yCAAyC;IACzC,uCAAmB,CAAA;IACnB,gDAAgD;IAChD,yCAAqB,CAAA;IACrB,yCAAyC;IACzC,yCAAqB,CAAA;IACrB,0DAA0D;IAC1D,uCAAmB,CAAA;AACrB,CAAC,EATW,gBAAgB,gCAAhB,gBAAgB,QAS3B"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/types/entity/entity.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAA2C;AAC3C,QAAQ;AACR,2CAA2C;AAE3C;;;;GAIG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,mCAAqB,CAAA;IACrB,2CAA6B,CAAA;AAC/B,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED;;;;;;GAMG;AACH,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,sGAAsG;IACtG,6BAAe,CAAA;IACf,sGAAsG;IACtG,6BAAe,CAAA;IACf,iDAAiD;IACjD,+BAAiB,CAAA;AACnB,CAAC,EAPW,UAAU,0BAAV,UAAU,QAOrB;AAED;;GAEG;AACH,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,yCAAyC;IACzC,uCAAmB,CAAA;IACnB,gDAAgD;IAChD,yCAAqB,CAAA;IACrB,yCAAyC;IACzC,yCAAqB,CAAA;IACrB,0DAA0D;IAC1D,uCAAmB,CAAA;AACrB,CAAC,EATW,gBAAgB,gCAAhB,gBAAgB,QAS3B"}

package/dist/types/entity/permissions.cjs

@@ -12,10 +12,11 @@ const entity_1 = require("./entity");
 // ROLE PERMISSION MAPPINGS
 // ========================================
 /**
- * Permission set for the Admin role.
- * Full access to all entity operations.
+ * Permission set for the Owner role (organizations only).
+ * Full access including user management, project and endpoint management.
+ * Organizations have exactly one owner; personal entities don't use this role.
  */
-const ADMIN_PERMISSIONS = {
+const OWNER_PERMISSIONS = {
     canViewEntity: true,
     canEditEntity: true,
     canDeleteEntity: true,
@@ -28,12 +29,13 @@ const ADMIN_PERMISSIONS = {
     canViewApiKeys: true,
 };
 /**
- * Permission set for the Manager role.
- * Can manage projects and API keys, but not entity settings or members.
+ * Permission set for the Admin role.
+ * Can manage projects and endpoints, but cannot manage users.
+ * This is the default role for personal entities.
  */
-const MANAGER_PERMISSIONS = {
+const ADMIN_PERMISSIONS = {
     canViewEntity: true,
-    canEditEntity: false,
+    canEditEntity: true,
     canDeleteEntity: false,
     canManageMembers: false,
     canInviteMembers: false,
@@ -44,10 +46,10 @@ const MANAGER_PERMISSIONS = {
     canViewApiKeys: true,
 };
 /**
- * Permission set for the Viewer role.
- * Read-only access to projects and API keys.
+ * Permission set for the Member role.
+ * Read-only access to projects and endpoints.
  */
-const VIEWER_PERMISSIONS = {
+const MEMBER_PERMISSIONS = {
     canViewEntity: true,
     canEditEntity: false,
     canDeleteEntity: false,
@@ -64,9 +66,9 @@ const VIEWER_PERMISSIONS = {
  * Used by permission checking utilities.
  */
 exports.ROLE_PERMISSIONS = {
+    [entity_1.EntityRole.OWNER]: OWNER_PERMISSIONS,
     [entity_1.EntityRole.ADMIN]: ADMIN_PERMISSIONS,
-    [entity_1.EntityRole.MANAGER]: MANAGER_PERMISSIONS,
-    [entity_1.EntityRole.VIEWER]: VIEWER_PERMISSIONS,
+    [entity_1.EntityRole.MEMBER]: MEMBER_PERMISSIONS,
 };
 // ========================================
 // UTILITY FUNCTIONS

package/dist/types/entity/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/types/entity/permissions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AAyDD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAIlE,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,iBAAiB,GAClC,OAAO,CAET"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/types/entity/permissions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AA2DD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAIlE,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,iBAAiB,GAClC,OAAO,CAET"}

package/dist/types/entity/permissions.js

@@ -12,10 +12,11 @@ const entity_1 = require("./entity");
 // ROLE PERMISSION MAPPINGS
 // ========================================
 /**
- * Permission set for the Admin role.
- * Full access to all entity operations.
+ * Permission set for the Owner role (organizations only).
+ * Full access including user management, project and endpoint management.
+ * Organizations have exactly one owner; personal entities don't use this role.
  */
-const ADMIN_PERMISSIONS = {
+const OWNER_PERMISSIONS = {
     canViewEntity: true,
     canEditEntity: true,
     canDeleteEntity: true,
@@ -28,12 +29,13 @@ const ADMIN_PERMISSIONS = {
     canViewApiKeys: true,
 };
 /**
- * Permission set for the Manager role.
- * Can manage projects and API keys, but not entity settings or members.
+ * Permission set for the Admin role.
+ * Can manage projects and endpoints, but cannot manage users.
+ * This is the default role for personal entities.
  */
-const MANAGER_PERMISSIONS = {
+const ADMIN_PERMISSIONS = {
     canViewEntity: true,
-    canEditEntity: false,
+    canEditEntity: true,
     canDeleteEntity: false,
     canManageMembers: false,
     canInviteMembers: false,
@@ -44,10 +46,10 @@ const MANAGER_PERMISSIONS = {
     canViewApiKeys: true,
 };
 /**
- * Permission set for the Viewer role.
- * Read-only access to projects and API keys.
+ * Permission set for the Member role.
+ * Read-only access to projects and endpoints.
  */
-const VIEWER_PERMISSIONS = {
+const MEMBER_PERMISSIONS = {
     canViewEntity: true,
     canEditEntity: false,
     canDeleteEntity: false,
@@ -64,9 +66,9 @@ const VIEWER_PERMISSIONS = {
  * Used by permission checking utilities.
  */
 exports.ROLE_PERMISSIONS = {
+    [entity_1.EntityRole.OWNER]: OWNER_PERMISSIONS,
     [entity_1.EntityRole.ADMIN]: ADMIN_PERMISSIONS,
-    [entity_1.EntityRole.MANAGER]: MANAGER_PERMISSIONS,
-    [entity_1.EntityRole.VIEWER]: VIEWER_PERMISSIONS,
+    [entity_1.EntityRole.MEMBER]: MEMBER_PERMISSIONS,
 };
 // ========================================
 // UTILITY FUNCTIONS

package/dist/types/entity/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/types/entity/permissions.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA6GH,sDAEC;AAQD,sCAKC;AA1HD,qCAAsC;AAiCtC,2CAA2C;AAC3C,2BAA2B;AAC3B,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,iBAAiB,GAAsB;IAC3C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,mBAAmB,GAAsB;IAC7C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAsB;IAC5C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;GAGG;AACU,QAAA,gBAAgB,GAA0C;IACrE,CAAC,mBAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB;IACrC,CAAC,mBAAU,CAAC,OAAO,CAAC,EAAE,mBAAmB;IACzC,CAAC,mBAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB;CACxC,CAAC;AAEF,2CAA2C;AAC3C,oBAAoB;AACpB,2CAA2C;AAE3C;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,IAAgB;IACpD,OAAO,wBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,IAAgB,EAChB,UAAmC;IAEnC,OAAO,wBAAgB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/types/entity/permissions.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA+GH,sDAEC;AAQD,sCAKC;AA5HD,qCAAsC;AAiCtC,2CAA2C;AAC3C,2BAA2B;AAC3B,2CAA2C;AAE3C;;;;GAIG;AACH,MAAM,iBAAiB,GAAsB;IAC3C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,iBAAiB,GAAsB;IAC3C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAsB;IAC5C,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;GAGG;AACU,QAAA,gBAAgB,GAA0C;IACrE,CAAC,mBAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB;IACrC,CAAC,mBAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB;IACrC,CAAC,mBAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB;CACxC,CAAC;AAEF,2CAA2C;AAC3C,oBAAoB;AACpB,2CAA2C;AAE3C;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,IAAgB;IACpD,OAAO,wBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,IAAgB,EAChB,UAAmC;IAEnC,OAAO,wBAAgB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/types",
-  "version": "1.9.42",
+  "version": "1.9.44",
   "description": "Comprehensive TypeScript types, interfaces, and utilities for Web3 email applications - optimized for AI-assisted development",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",