@nextsparkjs/core 0.1.0-beta.74 → 0.1.0-beta.76

package/dist/lib/permissions/check.d.ts

@@ -0,0 +1,82 @@
+import type { Permission, TeamRole } from './types';
+/**
+ * Check if current user has a permission in the current team
+ *
+ * SERVER USAGE:
+ * ```typescript
+ * if (!await checkPermission(userId, teamId, 'customers.create')) {
+ *   return createApiError('Permission denied', 403)
+ * }
+ * ```
+ *
+ * @param userId - User ID to check
+ * @param teamId - Team ID where permission is being checked
+ * @param permission - Permission to check
+ * @returns true if user has the permission
+ */
+export declare function checkPermission(userId: string, teamId: string, permission: Permission): Promise<boolean>;
+/**
+ * Check multiple permissions (AND - all required)
+ *
+ * @param userId - User ID to check
+ * @param teamId - Team ID where permissions are being checked
+ * @param permissions - Array of permissions to check
+ * @returns true if user has ALL permissions
+ *
+ * @example
+ * ```typescript
+ * const canEditAndDelete = await checkPermissions(userId, teamId, [
+ *   'customers.update',
+ *   'customers.delete'
+ * ])
+ * ```
+ */
+export declare function checkPermissions(userId: string, teamId: string, permissions: Permission[]): Promise<boolean>;
+/**
+ * Check at least one permission (OR - any is sufficient)
+ *
+ * @param userId - User ID to check
+ * @param teamId - Team ID where permissions are being checked
+ * @param permissions - Array of permissions to check
+ * @returns true if user has AT LEAST ONE permission
+ *
+ * @example
+ * ```typescript
+ * const canModify = await checkAnyPermission(userId, teamId, [
+ *   'customers.update',
+ *   'customers.delete'
+ * ])
+ * ```
+ */
+export declare function checkAnyPermission(userId: string, teamId: string, permissions: Permission[]): Promise<boolean>;
+/**
+ * Get all permissions for a user in a team
+ *
+ * @param userId - User ID
+ * @param teamId - Team ID
+ * @returns Array of permission IDs the user has
+ *
+ * @example
+ * ```typescript
+ * const userPerms = await getUserPermissions(userId, teamId)
+ * console.log('User permissions:', userPerms)
+ * ```
+ */
+export declare function getUserPermissions(userId: string, teamId: string): Promise<Permission[]>;
+/**
+ * Check permission synchronously (when you already have the role)
+ *
+ * Useful in contexts where you've already fetched the role
+ *
+ * @param teamRole - Team role
+ * @param permission - Permission to check
+ * @returns true if the role has the permission
+ *
+ * @example
+ * ```typescript
+ * // When you already have the role from context
+ * const canCreate = hasPermissionSync(userRole, 'customers.create')
+ * ```
+ */
+export declare function hasPermissionSync(teamRole: TeamRole, permission: Permission): boolean;
+//# sourceMappingURL=check.d.ts.map

package/dist/lib/permissions/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAuBnD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,GACrB,OAAO,CAET"}

package/dist/lib/permissions/hooks.d.ts

@@ -0,0 +1,62 @@
+import type { Permission, TeamRole } from './types';
+/**
+ * Hook to check a single permission in the current team
+ *
+ * @param permission - Permission ID to check (e.g., "customers.create")
+ * @returns true if the current user has the permission in the current team
+ *
+ * @example
+ * ```tsx
+ * const canCreate = usePermission('customers.create')
+ *
+ * return canCreate ? <CreateButton /> : null
+ * ```
+ */
+export declare function usePermission(permission: Permission): boolean;
+/**
+ * Hook to check multiple permissions
+ *
+ * @param permissions - Object mapping keys to permission IDs
+ * @returns Object with same keys, values are boolean (has permission or not)
+ *
+ * @example
+ * ```tsx
+ * const { canCreate, canDelete } = usePermissions({
+ *   canCreate: 'customers.create',
+ *   canDelete: 'customers.delete',
+ * })
+ *
+ * return (
+ *   <>
+ *     {canCreate && <CreateButton />}
+ *     {canDelete && <DeleteButton />}
+ *   </>
+ * )
+ * ```
+ */
+export declare function usePermissions<T extends Record<string, Permission>>(permissions: T): Record<keyof T, boolean>;
+/**
+ * Hook to get all permissions of the current user in the current team
+ *
+ * @returns Array of permission IDs the user has
+ *
+ * @example
+ * ```tsx
+ * const permissions = useAllPermissions()
+ * console.log('User has', permissions.length, 'permissions')
+ * ```
+ */
+export declare function useAllPermissions(): Permission[];
+/**
+ * Hook to get the current user's team role
+ *
+ * @returns Team role (owner, admin, member, viewer) or null if no team
+ *
+ * @example
+ * ```tsx
+ * const role = useTeamRole()
+ * return <Badge>{role}</Badge>
+ * ```
+ */
+export declare function useTeamRole(): TeamRole | null;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/lib/permissions/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/hooks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAY7D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACjE,WAAW,EAAE,CAAC,GACb,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAwB1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAWhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,QAAQ,GAAG,IAAI,CAS7C"}

package/dist/lib/permissions/init.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Permission System Initialization
+ *
+ * DEPRECATED: Runtime initialization replaced by build-time generation.
+ * This file now re-exports from the PermissionService and pre-computed registry.
+ *
+ * The permissions-registry.ts is auto-generated by scripts/build-registry.mjs
+ * and includes all permissions pre-computed with O(1) lookups.
+ *
+ * Query functions are now in PermissionService.
+ *
+ * @see core/lib/services/permission.service.ts
+ * @see core/lib/registries/permissions-registry.ts
+ */
+export { PermissionService, hasPermission, getRolePermissions, getPermissionsByCategory, getCategories, getFullMatrix, isValidPermission, getPermissionConfig, permissionRegistry, } from '../services/permission.service';
+export { ALL_PERMISSIONS, PERMISSIONS_BY_CATEGORY, FULL_MATRIX, UI_SECTIONS, PERMISSIONS_METADATA } from '@nextsparkjs/registries/permissions-registry';
+/**
+ * Legacy initialization function - no longer needed
+ * Permissions are now computed at build time
+ * @deprecated Use imports from permissions-registry directly
+ */
+export declare function initializePermissionRegistry(): void;
+/**
+ * Legacy function - no longer needed
+ * Entity permissions are included in the build-time registry
+ * @deprecated Use imports from permissions-registry directly
+ */
+export declare function ensureEntityPermissionsLoaded(): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/lib/permissions/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,oBAAoB,EACrB,MAAM,8CAA8C,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/lib/permissions/merge.d.ts

@@ -0,0 +1,50 @@
+import type { CorePermissionsConfig, ThemePermissionsConfig, PermissionConfig, PermissionUISection, Permission, ResolvedPermission, EntityPermissionsConfig } from './types';
+/**
+ * Merge configuration from core with theme and entities
+ *
+ * @deprecated This function is no longer used. Permissions are now pre-computed
+ * at build time and stored in the permissions-registry. Use PermissionService
+ * for runtime permission checks instead.
+ *
+ * Order of precedence:
+ * 1. Core config (base)
+ * 2. Theme overrides (override specific properties)
+ * 3. Theme features (add new permissions)
+ * 4. Entity configs (add entity permissions)
+ */
+export declare function mergePermissionsConfig(coreConfig: CorePermissionsConfig, themeConfig: ThemePermissionsConfig | null, entityPermissions: PermissionConfig[]): {
+    permissions: ResolvedPermission[];
+    uiSections: PermissionUISection[];
+    disabledIds: Set<Permission>;
+};
+/**
+ * Extract permissions from EntityConfig
+ *
+ * @deprecated This function is no longer used. Entity permissions are now defined
+ * centrally in permissions.config.ts and processed at build time by the registry
+ * generator script. Do not use this function for new code.
+ *
+ * Converts entity permissions configuration into PermissionConfig objects
+ * that can be merged into the global permissions registry.
+ *
+ * @param entitySlug - The entity identifier (e.g., "customers", "tasks")
+ * @param entityLabel - Human-readable entity name for UI
+ * @param permissions - Entity permissions configuration
+ * @returns Array of PermissionConfig objects
+ *
+ * @example
+ * ```typescript
+ * const perms = extractEntityPermissions(
+ *   'customers',
+ *   'Customers',
+ *   {
+ *     actions: [
+ *       { action: 'create', label: 'Create customers', roles: ['owner', 'admin'] }
+ *     ]
+ *   }
+ * )
+ * // Returns: [{ id: 'customers.create', label: 'Create customers', ... }]
+ * ```
+ */
+export declare function extractEntityPermissions(entitySlug: string, entityLabel: string, permissions: EntityPermissionsConfig): PermissionConfig[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/lib/permissions/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,qBAAqB,EACjC,WAAW,EAAE,sBAAsB,GAAG,IAAI,EAC1C,iBAAiB,EAAE,gBAAgB,EAAE,GACpC;IACD,WAAW,EAAE,kBAAkB,EAAE,CAAA;IACjC,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;CAC7B,CA0EA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,uBAAuB,GACnC,gBAAgB,EAAE,CA8BpB"}

package/dist/lib/permissions/system.d.ts

@@ -0,0 +1,13 @@
+import type { CorePermissionsConfig } from './types';
+/**
+ * Core Permissions Configuration
+ *
+ * This file defines:
+ * - System permissions (teams, settings, etc.)
+ * - Default permissions per role
+ * - UI sections for the permissions matrix
+ *
+ * IMPORTANT: Themes can override these values in their app.config.ts
+ */
+export declare const CORE_PERMISSIONS_CONFIG: CorePermissionsConfig;
+//# sourceMappingURL=system.d.ts.map

package/dist/lib/permissions/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,qBA6GrC,CAAA"}

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

@@ -0,0 +1,228 @@
+/**
+ * Permission System Types
+ *
+ * Defines the type system for granular permissions.
+ * Based on WordPress capabilities + GitHub organization permissions.
+ */
+/**
+ * Standard entity actions available
+ */
+export type EntityAction = 'create' | 'read' | 'list' | 'update' | 'delete' | 'export' | 'import' | 'assign' | 'publish' | 'archive';
+/**
+ * Permission format: "[scope].[action]"
+ * Examples:
+ * - Entities: "customers.create", "tasks.assign"
+ * - System: "teams.invite", "settings.billing"
+ * - Features: "reports.export", "contracts.sign"
+ */
+export type Permission = `${string}.${string}`;
+/**
+ * Core team roles (base roles defined in core)
+ */
+export type CoreTeamRole = 'owner' | 'admin' | 'member' | 'viewer';
+/**
+ * Team roles available - includes core roles + any custom roles from theme config.
+ * Uses (string & {}) pattern to allow custom roles while preserving autocomplete for core roles.
+ */
+export type TeamRole = CoreTeamRole | (string & {});
+/**
+ * Individual permission configuration
+ */
+export interface PermissionConfig {
+    /** Unique permission ID (e.g., "customers.create") */
+    id: Permission;
+    /** Human-readable label for UI */
+    label: string;
+    /** Description for tooltips/docs */
+    description?: string;
+    /** Category for grouping in UI (e.g., "Customers", "Settings") */
+    category: string;
+    /** Roles that have this permission */
+    roles: TeamRole[];
+    /** If this is a dangerous action (show warning in UI) */
+    dangerous?: boolean;
+    /** Dependencies: other permissions required for this to work */
+    requires?: Permission[];
+}
+/**
+ * Partial override for permission (for theme config)
+ */
+export type PermissionOverride = Partial<Omit<PermissionConfig, 'id'>>;
+/**
+ * UI section for grouping permissions
+ */
+export interface PermissionUISection {
+    id: string;
+    label: string;
+    description?: string;
+    categories: string[];
+}
+/**
+ * Core permissions configuration
+ */
+export interface CorePermissionsConfig {
+    version: string;
+    systemPermissions: PermissionConfig[];
+    roleDefaults: Record<TeamRole, Permission[] | ['*']>;
+    uiSections: PermissionUISection[];
+}
+/**
+ * Custom roles configuration for themes
+ * Allows themes to add roles beyond the core (owner, admin, member, viewer)
+ */
+export interface RolesConfig {
+    /** Additional roles beyond core roles (e.g., ['editor', 'contributor']) */
+    additionalRoles?: readonly string[];
+    /** Hierarchy values for roles (higher = more permissions) */
+    hierarchy?: Record<string, number>;
+    /** Translation keys for role display names */
+    displayNames?: Record<string, string>;
+    /** Role descriptions for UI tooltips */
+    descriptions?: Record<string, string>;
+}
+/**
+ * Unified permission action format
+ * Used for teams, features - follows same pattern as entity permissions
+ */
+export interface PermissionAction {
+    /** Action identifier (e.g., 'team.edit', 'page-builder.access') */
+    action: string;
+    /** Human-readable label for the permission */
+    label: string;
+    /** Detailed description of what this permission allows */
+    description?: string;
+    /** Team roles that have this permission */
+    roles: TeamRole[];
+    /** Category for grouping in UI (optional, used by features) */
+    category?: string;
+    /** Whether this is a dangerous/destructive action */
+    dangerous?: boolean;
+}
+/**
+ * Entity permission action definition (for theme-level entity permissions)
+ * @deprecated Use PermissionAction instead - kept for backward compatibility
+ */
+export interface EntityPermissionAction {
+    /** Action identifier (e.g., 'create', 'read', 'publish', 'archive') */
+    action: EntityAction | string;
+    /** Human-readable label for the permission */
+    label: string;
+    /** Detailed description of what this permission allows */
+    description?: string;
+    /** Team roles that have this permission */
+    roles: TeamRole[];
+    /** Whether this is a dangerous/destructive action */
+    dangerous?: boolean;
+}
+/**
+ * Theme permissions configuration
+ * SINGLE SOURCE OF TRUTH for all permissions and roles
+ */
+export interface ThemePermissionsConfig {
+    /**
+     * Custom roles definition
+     * Defines additional roles beyond core (owner, admin, member, viewer)
+     */
+    roles?: RolesConfig;
+    /**
+     * Team-level permissions
+     * Actions like team.view, team.edit, team.members.invite
+     */
+    teams?: PermissionAction[];
+    /**
+     * Theme-specific feature permissions
+     * Uses unified action format (action instead of id)
+     */
+    features?: PermissionAction[];
+    /**
+     * Entity permissions - centralized definition of all entity permissions
+     * Key: entity slug (e.g., 'customers', 'tasks')
+     * Value: array of permission actions for that entity
+     */
+    entities?: Record<string, EntityPermissionAction[]>;
+    /** Override core permissions */
+    overrides?: Record<Permission, PermissionOverride>;
+    /** IDs of core permissions to disable */
+    disabled?: Permission[];
+    /** Additional UI sections */
+    uiSections?: PermissionUISection[];
+}
+/**
+ * Permissions configuration in EntityConfig
+ */
+export interface EntityPermissionsConfig {
+    actions: {
+        action: EntityAction | string;
+        label: string;
+        description?: string;
+        roles: TeamRole[];
+        dangerous?: boolean;
+    }[];
+    customActions?: {
+        action: string;
+        label: string;
+        description?: string;
+        roles: TeamRole[];
+        dangerous?: boolean;
+    }[];
+}
+/**
+ * Resolved permission at runtime
+ */
+export interface ResolvedPermission extends PermissionConfig {
+    source: 'core' | 'theme' | 'entity';
+    disabled: boolean;
+}
+/**
+ * Permission matrix by role
+ */
+export type PermissionMatrix = Record<TeamRole, Permission[]>;
+/**
+ * Reasons why an action might be denied
+ */
+export type ActionDeniedReason = 'not_member' | 'permission_denied' | 'feature_disabled' | 'quota_exceeded' | 'subscription_inactive';
+/**
+ * Result of checking if an action is allowed
+ */
+export type ActionResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: ActionDeniedReason;
+    message: string;
+    meta?: Record<string, unknown>;
+};
+/**
+ * Subscription information in membership context
+ */
+export interface MembershipSubscription {
+    id: string;
+    planSlug: string;
+    planName: string;
+    status: 'active' | 'trialing' | 'past_due' | 'canceled' | 'paused' | 'expired';
+    trialEndsAt: Date | null;
+    currentPeriodEnd: Date | null;
+}
+/**
+ * Quota state for a specific limit
+ */
+export interface QuotaState {
+    used: number;
+    limit: number;
+    unlimited: boolean;
+    remaining: number;
+}
+/**
+ * Team membership data structure
+ */
+export interface TeamMembershipData {
+    userId: string;
+    teamId: string;
+    role: string | null;
+    hierarchy: number;
+    permissions: Permission[];
+    subscription: MembershipSubscription | null;
+    features: string[];
+    quotas: Record<string, QuotaState>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/permissions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,CAAA;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAElE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAMnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,EAAE,EAAE,UAAU,CAAA;IAEd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IAEb,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAEhB,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAA;IAEjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;IACrC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IACpD,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAClC;AAMD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEnC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAErC,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IAEd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IAEb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,EAAE,CAAA;IAEjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;IAE7B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IAEb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,EAAE,CAAA;IAEjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;IAEnD,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAA;IAElD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;IAEvB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE;QACP,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;QAC7B,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,QAAQ,EAAE,CAAA;QACjB,SAAS,CAAC,EAAE,OAAO,CAAA;KACpB,EAAE,CAAA;IAEH,aAAa,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,QAAQ,EAAE,CAAA;QACjB,SAAS,CAAC,EAAE,OAAO,CAAA;KACpB,EAAE,CAAA;CACJ;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAA;AAM7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,GAChB,uBAAuB,CAAA;AAE3B;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IACE,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAEL;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC9E,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IACxB,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACnC"}

package/dist/lib/plugins/env-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Centralized Plugin Environment Loader
+ *
+ * Automatically loads .env files from all plugins in contents/plugins/
+ * No need to duplicate env loading code in each plugin
+ *
+ * Usage:
+ *   import { getPluginEnv } from './env-loader'
+ *   const env = getPluginEnv('ai')
+ *   const apiKey = env.ANTHROPIC_API_KEY
+ */
+/**
+ * Plugin environment configuration
+ */
+type PluginEnvConfig = Record<string, string | undefined>;
+/**
+ * Get environment configuration for a specific plugin
+ *
+ * @param pluginName - Name of the plugin (e.g., 'ai', 'amplitude', 'billing')
+ * @returns Plugin environment configuration
+ *
+ * @example
+ * ```typescript
+ * const env = getPluginEnv('ai')
+ * const apiKey = env.ANTHROPIC_API_KEY
+ * const useLocal = env.USE_LOCAL_AI === 'true'
+ * ```
+ */
+export declare function getPluginEnv(pluginName: string): PluginEnvConfig;
+/**
+ * Check if a plugin has environment configuration loaded
+ */
+export declare function hasPluginEnv(pluginName: string): boolean;
+/**
+ * Get list of all loaded plugin names
+ */
+export declare function getLoadedPlugins(): string[];
+/**
+ * Force reload all plugin environments
+ */
+export declare function reloadPluginEnvs(): void;
+/**
+ * Initialize plugin environments (auto-loads on first access)
+ */
+export declare function initializePluginEnvs(): void;
+export {};
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/lib/plugins/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/env-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAuJzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAEhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/lib/plugins/hook-system.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Hook System for Plugin Architecture
+ *
+ * Provides a WordPress-like hook system for plugins to interact with the core
+ */
+type HookCallback<T = Record<string, unknown>> = (data: T, ...args: unknown[]) => Promise<T> | T;
+type HookCallbackVoid<T = Record<string, unknown>> = (data: T, ...args: unknown[]) => Promise<void> | void;
+/**
+ * Hook system implementation
+ */
+export declare class HookSystem {
+    private filters;
+    private actions;
+    private hookStats;
+    /**
+     * Add a filter hook
+     * Filters allow plugins to modify data as it passes through the system
+     */
+    addFilter(hookName: string, callback: HookCallback, priority?: number): void;
+    /**
+     * Apply filter hooks to data
+     */
+    applyFilters<T>(hookName: string, data: T, ...args: unknown[]): Promise<T>;
+    /**
+     * Add an action hook
+     * Actions allow plugins to execute code at specific points
+     */
+    addAction(hookName: string, callback: HookCallbackVoid, priority?: number): void;
+    /**
+     * Execute action hooks
+     */
+    doAction<T>(hookName: string, data: T, ...args: unknown[]): Promise<void>;
+    /**
+     * Emit an event (alias for doAction for semantic clarity)
+     */
+    emit<T>(eventName: string, data: T, ...args: unknown[]): Promise<void>;
+    /**
+     * Remove a filter hook
+     */
+    removeFilter(hookName: string, callback: HookCallback): boolean;
+    /**
+     * Remove an action hook
+     */
+    removeAction(hookName: string, callback: HookCallbackVoid): boolean;
+    /**
+     * Check if a hook has any callbacks
+     */
+    hasHook(hookName: string): boolean;
+    /**
+     * Get all registered hooks
+     */
+    getAllHooks(): {
+        filters: string[];
+        actions: string[];
+    };
+    /**
+     * Record hook execution statistics
+     */
+    private recordHookStats;
+    /**
+     * Get hook execution statistics
+     */
+    getHookStats(): Record<string, {
+        calls: number;
+        totalTime: number;
+        avgTime: number;
+    }>;
+    /**
+     * Clear all hooks (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get hook count
+     */
+    getHookCount(): {
+        filters: number;
+        actions: number;
+    };
+}
+declare global {
+    var __HOOK_SYSTEM__: HookSystem | undefined;
+}
+/**
+ * Create or get the global hook system
+ * Uses globalThis to persist across module reloads in Next.js (Turbopack/Webpack)
+ */
+export declare function createHookSystem(): HookSystem;
+/**
+ * Get the global hook system
+ */
+export declare function getGlobalHooks(): HookSystem;
+export declare const addFilter: (hookName: string, callback: HookCallback, priority?: number) => void;
+export declare const applyFilters: <T>(hookName: string, data: T, ...args: unknown[]) => Promise<T>;
+export declare const addAction: (hookName: string, callback: HookCallbackVoid, priority?: number) => void;
+export declare const doAction: <T>(hookName: string, data: T, ...args: unknown[]) => Promise<void>;
+export declare const emit: <T>(eventName: string, data: T, ...args: unknown[]) => Promise<void>;
+export declare const removeFilter: (hookName: string, callback: HookCallback) => boolean;
+export declare const removeAction: (hookName: string, callback: HookCallbackVoid) => boolean;
+export declare const hasHook: (hookName: string) => boolean;
+export declare const getAllHooks: () => {
+    filters: string[];
+    actions: string[];
+};
+export declare const getHookStats: () => Record<string, {
+    calls: number;
+    totalTime: number;
+    avgTime: number;
+}>;
+export {};
+//# sourceMappingURL=hook-system.d.ts.map

package/dist/lib/plugins/hook-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-system.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/hook-system.ts"],"names":[],"mappings":"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"}