@sudobility/types 1.9.37 → 1.9.38

package/dist/types/entity/entity.cjs

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * @fileoverview Entity Type Definitions
+ * @description Core types for the entity/organization system used across shapeshyft and whisperly
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvitationStatus = exports.EntityRole = exports.EntityType = void 0;
+// ========================================
+// ENUMS
+// ========================================
+/**
+ * Type of entity.
+ * - personal: Auto-created for each user, cannot be deleted
+ * - organization: User-created, supports multiple members
+ */
+var EntityType;
+(function (EntityType) {
+    EntityType["PERSONAL"] = "personal";
+    EntityType["ORGANIZATION"] = "organization";
+})(EntityType || (exports.EntityType = EntityType = {}));
+/**
+ * Role of a user within an entity.
+ * Determines permissions for various operations.
+ */
+var EntityRole;
+(function (EntityRole) {
+    /** Full access: manage entity, members, projects, and API keys */
+    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";
+})(EntityRole || (exports.EntityRole = EntityRole = {}));
+/**
+ * Status of an entity invitation.
+ */
+var InvitationStatus;
+(function (InvitationStatus) {
+    /** Invitation sent, awaiting response */
+    InvitationStatus["PENDING"] = "pending";
+    /** Invitation accepted, user is now a member */
+    InvitationStatus["ACCEPTED"] = "accepted";
+    /** Invitation declined by the invitee */
+    InvitationStatus["DECLINED"] = "declined";
+    /** Invitation expired (not accepted within time limit) */
+    InvitationStatus["EXPIRED"] = "expired";
+})(InvitationStatus || (exports.InvitationStatus = InvitationStatus = {}));
+//# sourceMappingURL=entity.js.map

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

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Entity Type Definitions
+ * @description Core types for the entity/organization system used across shapeshyft and whisperly
+ */
+/**
+ * Type of entity.
+ * - personal: Auto-created for each user, cannot be deleted
+ * - organization: User-created, supports multiple members
+ */
+export declare enum EntityType {
+    PERSONAL = "personal",
+    ORGANIZATION = "organization"
+}
+/**
+ * Role of a user within an entity.
+ * Determines permissions for various operations.
+ */
+export declare enum EntityRole {
+    /** Full access: manage entity, members, projects, and API keys */
+    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"
+}
+/**
+ * Status of an entity invitation.
+ */
+export declare enum InvitationStatus {
+    /** Invitation sent, awaiting response */
+    PENDING = "pending",
+    /** Invitation accepted, user is now a member */
+    ACCEPTED = "accepted",
+    /** Invitation declined by the invitee */
+    DECLINED = "declined",
+    /** Invitation expired (not accepted within time limit) */
+    EXPIRED = "expired"
+}
+/**
+ * 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).
+ */
+export interface Entity {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** URL-friendly slug (8-12 alphanumeric characters) */
+    entitySlug: string;
+    /** Type of entity: personal or organization */
+    entityType: EntityType;
+    /** Display name shown in UI */
+    displayName: string;
+    /** Optional description */
+    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 */
+    updatedAt: string;
+}
+/**
+ * Entity with the current user's role included.
+ * Used when listing entities for a user.
+ */
+export interface EntityWithRole extends Entity {
+    /** Current user's role in this entity */
+    userRole: EntityRole;
+}
+/**
+ * Minimal user information for display in member lists.
+ */
+export interface EntityMemberUser {
+    /** User's unique identifier */
+    id: string;
+    /** User's email address */
+    email: string | null;
+    /** User's display name */
+    displayName: string | null;
+}
+/**
+ * A membership record linking a user to an entity with a specific role.
+ */
+export interface EntityMember {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Entity this membership belongs to */
+    entityId: string;
+    /** User who is a member */
+    userId: string;
+    /** User's role in the entity */
+    role: EntityRole;
+    /** ISO 8601 timestamp when user joined */
+    joinedAt: string;
+    /** ISO 8601 timestamp of record creation */
+    createdAt: string;
+    /** ISO 8601 timestamp of last update */
+    updatedAt: string;
+    /** Populated user information (when joined) */
+    user?: EntityMemberUser;
+}
+/**
+ * An invitation for a user to join an entity.
+ * Stored with email address to support inviting users who haven't signed up yet.
+ */
+export interface EntityInvitation {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Entity the user is invited to join */
+    entityId: string;
+    /** Email address of the invitee */
+    email: string;
+    /** Role the user will have upon accepting */
+    role: EntityRole;
+    /** Current status of the invitation */
+    status: InvitationStatus;
+    /** User ID of who sent the invitation */
+    invitedByUserId: string;
+    /** Unique token for accepting/declining (included in invitation link) */
+    token: string;
+    /** ISO 8601 timestamp when invitation expires */
+    expiresAt: string;
+    /** ISO 8601 timestamp when invitation was accepted (null if not accepted) */
+    acceptedAt: string | null;
+    /** ISO 8601 timestamp of creation */
+    createdAt: string;
+    /** ISO 8601 timestamp of last update */
+    updatedAt: string;
+    /** Populated entity information (when joined) */
+    entity?: Entity;
+    /** Populated inviter information (when joined) */
+    invitedBy?: EntityMemberUser;
+}
+//# sourceMappingURL=entity.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/entity/entity.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * @fileoverview Entity Type Definitions
+ * @description Core types for the entity/organization system used across shapeshyft and whisperly
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvitationStatus = exports.EntityRole = exports.EntityType = void 0;
+// ========================================
+// ENUMS
+// ========================================
+/**
+ * Type of entity.
+ * - personal: Auto-created for each user, cannot be deleted
+ * - organization: User-created, supports multiple members
+ */
+var EntityType;
+(function (EntityType) {
+    EntityType["PERSONAL"] = "personal";
+    EntityType["ORGANIZATION"] = "organization";
+})(EntityType || (exports.EntityType = EntityType = {}));
+/**
+ * Role of a user within an entity.
+ * Determines permissions for various operations.
+ */
+var EntityRole;
+(function (EntityRole) {
+    /** Full access: manage entity, members, projects, and API keys */
+    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";
+})(EntityRole || (exports.EntityRole = EntityRole = {}));
+/**
+ * Status of an entity invitation.
+ */
+var InvitationStatus;
+(function (InvitationStatus) {
+    /** Invitation sent, awaiting response */
+    InvitationStatus["PENDING"] = "pending";
+    /** Invitation accepted, user is now a member */
+    InvitationStatus["ACCEPTED"] = "accepted";
+    /** Invitation declined by the invitee */
+    InvitationStatus["DECLINED"] = "declined";
+    /** Invitation expired (not accepted within time limit) */
+    InvitationStatus["EXPIRED"] = "expired";
+})(InvitationStatus || (exports.InvitationStatus = InvitationStatus = {}));
+//# sourceMappingURL=entity.js.map

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

@@ -0,0 +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"}

package/dist/types/entity/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @fileoverview Entity Types Module
+ * @description Exports all entity-related types for organization/workspace management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core entity types and enums
+__exportStar(require("./entity"), exports);
+// Request types
+__exportStar(require("./requests"), exports);
+// Response types
+__exportStar(require("./responses"), exports);
+// Permission types and utilities
+__exportStar(require("./permissions"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Entity Types Module
+ * @description Exports all entity-related types for organization/workspace management
+ */
+export * from './entity';
+export * from './requests';
+export * from './responses';
+export * from './permissions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/entity/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC"}

package/dist/types/entity/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @fileoverview Entity Types Module
+ * @description Exports all entity-related types for organization/workspace management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core entity types and enums
+__exportStar(require("./entity"), exports);
+// Request types
+__exportStar(require("./requests"), exports);
+// Response types
+__exportStar(require("./responses"), exports);
+// Permission types and utilities
+__exportStar(require("./permissions"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/entity/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,8BAA8B;AAC9B,2CAAyB;AAEzB,gBAAgB;AAChB,6CAA2B;AAE3B,iBAAiB;AACjB,8CAA4B;AAE5B,iCAAiC;AACjC,gDAA8B"}

package/dist/types/entity/permissions.cjs

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @fileoverview Entity Permission Type Definitions
+ * @description Permission types and constants for role-based access control
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_PERMISSIONS = void 0;
+exports.getPermissionsForRole = getPermissionsForRole;
+exports.hasPermission = hasPermission;
+const entity_1 = require("./entity");
+// ========================================
+// ROLE PERMISSION MAPPINGS
+// ========================================
+/**
+ * Permission set for the Admin role.
+ * Full access to all entity operations.
+ */
+const ADMIN_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: true,
+    canDeleteEntity: true,
+    canManageMembers: true,
+    canInviteMembers: true,
+    canManageProjects: true,
+    canCreateProjects: true,
+    canViewProjects: true,
+    canManageApiKeys: true,
+    canViewApiKeys: true,
+};
+/**
+ * Permission set for the Manager role.
+ * Can manage projects and API keys, but not entity settings or members.
+ */
+const MANAGER_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: false,
+    canDeleteEntity: false,
+    canManageMembers: false,
+    canInviteMembers: false,
+    canManageProjects: true,
+    canCreateProjects: true,
+    canViewProjects: true,
+    canManageApiKeys: true,
+    canViewApiKeys: true,
+};
+/**
+ * Permission set for the Viewer role.
+ * Read-only access to projects and API keys.
+ */
+const VIEWER_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: false,
+    canDeleteEntity: false,
+    canManageMembers: false,
+    canInviteMembers: false,
+    canManageProjects: false,
+    canCreateProjects: false,
+    canViewProjects: true,
+    canManageApiKeys: false,
+    canViewApiKeys: true,
+};
+/**
+ * Maps each role to its permission set.
+ * Used by permission checking utilities.
+ */
+exports.ROLE_PERMISSIONS = {
+    [entity_1.EntityRole.ADMIN]: ADMIN_PERMISSIONS,
+    [entity_1.EntityRole.MANAGER]: MANAGER_PERMISSIONS,
+    [entity_1.EntityRole.VIEWER]: VIEWER_PERMISSIONS,
+};
+// ========================================
+// UTILITY FUNCTIONS
+// ========================================
+/**
+ * Get permissions for a given role.
+ * @param role - The entity role
+ * @returns The permission set for that role
+ */
+function getPermissionsForRole(role) {
+    return exports.ROLE_PERMISSIONS[role];
+}
+/**
+ * Check if a role has a specific permission.
+ * @param role - The entity role to check
+ * @param permission - The permission key to check
+ * @returns Whether the role has the permission
+ */
+function hasPermission(role, permission) {
+    return exports.ROLE_PERMISSIONS[role][permission];
+}
+//# sourceMappingURL=permissions.js.map

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

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Entity Permission Type Definitions
+ * @description Permission types and constants for role-based access control
+ */
+import { EntityRole } from './entity';
+/**
+ * Defines all available permissions within an entity.
+ * Each permission maps to a specific action a user can perform.
+ */
+export interface EntityPermissions {
+    /** Can view entity details and settings */
+    canViewEntity: boolean;
+    /** Can edit entity name, description, avatar */
+    canEditEntity: boolean;
+    /** Can delete the entity (organizations only) */
+    canDeleteEntity: boolean;
+    /** Can add, remove, and change roles of members */
+    canManageMembers: boolean;
+    /** Can send invitations to new members */
+    canInviteMembers: boolean;
+    /** Can create, edit, and delete projects */
+    canManageProjects: boolean;
+    /** Can create new projects */
+    canCreateProjects: boolean;
+    /** Can view projects and their details */
+    canViewProjects: boolean;
+    /** Can create, edit, and delete API keys */
+    canManageApiKeys: boolean;
+    /** Can view and use API keys for invocations */
+    canViewApiKeys: boolean;
+}
+/**
+ * Maps each role to its permission set.
+ * Used by permission checking utilities.
+ */
+export declare const ROLE_PERMISSIONS: Record<EntityRole, EntityPermissions>;
+/**
+ * Get permissions for a given role.
+ * @param role - The entity role
+ * @returns The permission set for that role
+ */
+export declare function getPermissionsForRole(role: EntityRole): EntityPermissions;
+/**
+ * Check if a role has a specific permission.
+ * @param role - The entity role to check
+ * @param permission - The permission key to check
+ * @returns Whether the role has the permission
+ */
+export declare function hasPermission(role: EntityRole, permission: keyof EntityPermissions): boolean;
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/entity/permissions.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @fileoverview Entity Permission Type Definitions
+ * @description Permission types and constants for role-based access control
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_PERMISSIONS = void 0;
+exports.getPermissionsForRole = getPermissionsForRole;
+exports.hasPermission = hasPermission;
+const entity_1 = require("./entity");
+// ========================================
+// ROLE PERMISSION MAPPINGS
+// ========================================
+/**
+ * Permission set for the Admin role.
+ * Full access to all entity operations.
+ */
+const ADMIN_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: true,
+    canDeleteEntity: true,
+    canManageMembers: true,
+    canInviteMembers: true,
+    canManageProjects: true,
+    canCreateProjects: true,
+    canViewProjects: true,
+    canManageApiKeys: true,
+    canViewApiKeys: true,
+};
+/**
+ * Permission set for the Manager role.
+ * Can manage projects and API keys, but not entity settings or members.
+ */
+const MANAGER_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: false,
+    canDeleteEntity: false,
+    canManageMembers: false,
+    canInviteMembers: false,
+    canManageProjects: true,
+    canCreateProjects: true,
+    canViewProjects: true,
+    canManageApiKeys: true,
+    canViewApiKeys: true,
+};
+/**
+ * Permission set for the Viewer role.
+ * Read-only access to projects and API keys.
+ */
+const VIEWER_PERMISSIONS = {
+    canViewEntity: true,
+    canEditEntity: false,
+    canDeleteEntity: false,
+    canManageMembers: false,
+    canInviteMembers: false,
+    canManageProjects: false,
+    canCreateProjects: false,
+    canViewProjects: true,
+    canManageApiKeys: false,
+    canViewApiKeys: true,
+};
+/**
+ * Maps each role to its permission set.
+ * Used by permission checking utilities.
+ */
+exports.ROLE_PERMISSIONS = {
+    [entity_1.EntityRole.ADMIN]: ADMIN_PERMISSIONS,
+    [entity_1.EntityRole.MANAGER]: MANAGER_PERMISSIONS,
+    [entity_1.EntityRole.VIEWER]: VIEWER_PERMISSIONS,
+};
+// ========================================
+// UTILITY FUNCTIONS
+// ========================================
+/**
+ * Get permissions for a given role.
+ * @param role - The entity role
+ * @returns The permission set for that role
+ */
+function getPermissionsForRole(role) {
+    return exports.ROLE_PERMISSIONS[role];
+}
+/**
+ * Check if a role has a specific permission.
+ * @param role - The entity role to check
+ * @param permission - The permission key to check
+ * @returns Whether the role has the permission
+ */
+function hasPermission(role, permission) {
+    return exports.ROLE_PERMISSIONS[role][permission];
+}
+//# sourceMappingURL=permissions.js.map

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

@@ -0,0 +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"}

package/dist/types/entity/requests.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Entity Request Type Definitions
+ * @description Request types for entity API endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=requests.js.map

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

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Entity Request Type Definitions
+ * @description Request types for entity API endpoints
+ */
+import type { EntityRole } from './entity';
+/**
+ * Request to create a new organization entity.
+ * Personal entities are created automatically and cannot be created via API.
+ */
+export interface CreateEntityRequest {
+    /** Display name for the organization */
+    displayName: string;
+    /** Optional custom slug (8-12 alphanumeric). Auto-generated if not provided */
+    entitySlug?: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Request to update an entity's details.
+ * Only admins can update entity settings.
+ */
+export interface UpdateEntityRequest {
+    /** New display name */
+    displayName?: string;
+    /** New slug (must be unique and available) */
+    entitySlug?: string;
+    /** New description */
+    description?: string;
+    /** New avatar URL */
+    avatarUrl?: string;
+}
+/**
+ * Request to update a member's role.
+ * Only admins can update member roles.
+ */
+export interface UpdateMemberRoleRequest {
+    /** New role for the member */
+    role: EntityRole;
+}
+/**
+ * Request to invite a user to join an entity.
+ * Only admins can send invitations.
+ */
+export interface InviteMemberRequest {
+    /** Email address of the user to invite */
+    email: string;
+    /** Role to assign when invitation is accepted */
+    role: EntityRole;
+}
+/**
+ * Request to accept an invitation using its token.
+ */
+export interface AcceptInvitationRequest {
+    /** Unique invitation token from the invitation link */
+    token: string;
+}
+/**
+ * Request to decline an invitation using its token.
+ */
+export interface DeclineInvitationRequest {
+    /** Unique invitation token from the invitation link */
+    token: string;
+}
+//# sourceMappingURL=requests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../src/types/entity/requests.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/entity/requests.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Entity Request Type Definitions
+ * @description Request types for entity API endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=requests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../../src/types/entity/requests.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/entity/responses.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Entity Response Type Definitions
+ * @description Response types for entity API endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=responses.js.map

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Entity Response Type Definitions
+ * @description Response types for entity API endpoints
+ */
+import type { BaseResponse } from '../common';
+import type { Entity, EntityWithRole, EntityMember, EntityInvitation } from './entity';
+/**
+ * Response for single entity operations (get, create, update).
+ */
+export type EntityResponse = BaseResponse<Entity>;
+/**
+ * Response for listing user's entities.
+ * Includes the user's role in each entity.
+ */
+export type EntityWithRoleListResponse = BaseResponse<EntityWithRole[]>;
+/**
+ * Response for getting a single entity with role.
+ */
+export type EntityWithRoleResponse = BaseResponse<EntityWithRole>;
+/**
+ * Response for single member operations (add, update role).
+ */
+export type EntityMemberResponse = BaseResponse<EntityMember>;
+/**
+ * Response for listing entity members.
+ */
+export type EntityMemberListResponse = BaseResponse<EntityMember[]>;
+/**
+ * Response for single invitation operations (create, accept, decline).
+ */
+export type EntityInvitationResponse = BaseResponse<EntityInvitation>;
+/**
+ * Response for listing invitations.
+ */
+export type EntityInvitationListResponse = BaseResponse<EntityInvitation[]>;
+/**
+ * Response for checking if an entity slug is available.
+ */
+export interface SlugAvailabilityData {
+    /** The slug that was checked */
+    slug: string;
+    /** Whether the slug is available for use */
+    available: boolean;
+    /** Suggested alternative if not available */
+    suggestion?: string;
+}
+export type SlugAvailabilityResponse = BaseResponse<SlugAvailabilityData>;
+//# sourceMappingURL=responses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/types/entity/responses.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAMlB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAMlE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;AAMpE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/types/entity/responses.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Entity Response Type Definitions
+ * @description Response types for entity API endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=responses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../../src/types/entity/responses.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/index.cjs

@@ -26,4 +26,6 @@ __exportStar(require("./config"), exports);
 __exportStar(require("./infrastructure"), exports);
 // Subscription types (rate limits, etc.)
 __exportStar(require("./subscription"), exports);
+// Entity types (organizations, workspaces, members)
+__exportStar(require("./entity"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.d.ts

@@ -4,4 +4,5 @@ export * from './blockchain';
 export * from './config';
 export * from './infrastructure';
 export * from './subscription';
+export * from './entity';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC"}

package/dist/types/index.js

@@ -26,4 +26,6 @@ __exportStar(require("./config"), exports);
 __exportStar(require("./infrastructure"), exports);
 // Subscription types (rate limits, etc.)
 __exportStar(require("./subscription"), exports);
+// Entity types (organizations, workspaces, members)
+__exportStar(require("./entity"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uBAAuB;AACvB,2CAAyB;AAEzB,wBAAwB;AACxB,6CAA2B;AAE3B,8BAA8B;AAC9B,+CAA6B;AAE7B,4BAA4B;AAC5B,2CAAyB;AAEzB,uBAAuB;AACvB,mDAAiC;AAEjC,yCAAyC;AACzC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uBAAuB;AACvB,2CAAyB;AAEzB,wBAAwB;AACxB,6CAA2B;AAE3B,8BAA8B;AAC9B,+CAA6B;AAE7B,4BAA4B;AAC5B,2CAAyB;AAEzB,uBAAuB;AACvB,mDAAiC;AAEjC,yCAAyC;AACzC,iDAA+B;AAE/B,oDAAoD;AACpD,2CAAyB"}

package/package.json

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