@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.77

package/dist/lib/services/team-member.service.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Team Member Service
+ *
+ * Provides team membership management including adding/removing members,
+ * role management, and permission checks.
+ *
+ * @module TeamMemberService
+ */
+import type { TeamMember, TeamRole } from '../teams/types';
+export interface TeamMemberWithUser extends TeamMember {
+    userName: string | null;
+    userEmail: string;
+    userImage: string | null;
+}
+export interface AddMemberOptions {
+    invitedBy?: string;
+}
+export declare class TeamMemberService {
+    /**
+     * Get team member by team and user ID
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID
+     * @returns Team member or null if not found
+     *
+     * @example
+     * const member = await TeamMemberService.getByTeamAndUser('team-123', 'user-456')
+     */
+    static getByTeamAndUser(teamId: string, userId: string): Promise<TeamMember | null>;
+    /**
+     * List all team members with user details
+     *
+     * @param teamId - Team ID
+     * @param requestingUserId - User ID making the request (for RLS)
+     * @returns Array of team members with user information
+     *
+     * @example
+     * const members = await TeamMemberService.listByTeam('team-123', 'user-456')
+     */
+    static listByTeam(teamId: string, requestingUserId: string): Promise<TeamMemberWithUser[]>;
+    /**
+     * Get user's role in a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID
+     * @returns The user's role or null if not a member
+     *
+     * @example
+     * const role = await TeamMemberService.getRole('team-123', 'user-456')
+     */
+    static getRole(teamId: string, userId: string): Promise<TeamRole | null>;
+    /**
+     * Add a user to a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID to add
+     * @param role - Role to assign
+     * @param options - Additional options (invitedBy)
+     * @returns Created team member
+     *
+     * @example
+     * const member = await TeamMemberService.add('team-123', 'user-456', 'member', {
+     *   invitedBy: 'owner-user-id'
+     * })
+     */
+    static add(teamId: string, userId: string, role: TeamRole, options?: AddMemberOptions): Promise<TeamMember>;
+    /**
+     * Add user to the global team (for single-tenant invite flow)
+     *
+     * @param userId - User ID to add
+     * @param role - Role to assign (default: 'member')
+     * @param invitedBy - User ID who invited them
+     *
+     * @example
+     * await TeamMemberService.addToGlobal('user-123', 'member', 'owner-id')
+     */
+    static addToGlobal(userId: string, role?: TeamRole, invitedBy?: string): Promise<void>;
+    /**
+     * Transfer team ownership to another member
+     *
+     * @param teamId - Team ID
+     * @param newOwnerId - User ID of the new owner (must be existing member)
+     * @param currentOwnerId - Current owner's user ID (for verification)
+     * @returns Updated team members (both old and new owner)
+     *
+     * @example
+     * await TeamMemberService.transferOwnership('team-123', 'new-owner-id', 'current-owner-id')
+     */
+    static transferOwnership(teamId: string, newOwnerId: string, currentOwnerId: string): Promise<{
+        previousOwner: TeamMember;
+        newOwner: TeamMember;
+    }>;
+    /**
+     * Remove a user from a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID to remove
+     *
+     * @example
+     * await TeamMemberService.remove('team-123', 'user-456')
+     */
+    static remove(teamId: string, userId: string): Promise<void>;
+    /**
+     * Update user's role in a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID
+     * @param role - New role
+     * @returns Updated team member
+     *
+     * @example
+     * const member = await TeamMemberService.updateRole('team-123', 'user-456', 'admin')
+     */
+    static updateRole(teamId: string, userId: string, role: TeamRole): Promise<TeamMember>;
+    /**
+     * Check if user is a member of a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID
+     * @returns True if user is a member
+     *
+     * @example
+     * const isMember = await TeamMemberService.isMember('team-123', 'user-456')
+     */
+    static isMember(teamId: string, userId: string): Promise<boolean>;
+    /**
+     * Check if user has required permission in team
+     *
+     * @param userId - User ID
+     * @param teamId - Team ID
+     * @param requiredRoles - Array of roles that are allowed
+     * @returns True if user has permission
+     *
+     * @example
+     * const hasPermission = await TeamMemberService.hasPermission(
+     *   'user-123',
+     *   'team-456',
+     *   ['owner', 'admin']
+     * )
+     */
+    static hasPermission(userId: string, teamId: string, requiredRoles?: TeamRole[]): Promise<boolean>;
+    /**
+     * Get count of team members
+     *
+     * @param teamId - Team ID
+     * @returns Number of members
+     *
+     * @example
+     * const count = await TeamMemberService.count('team-123')
+     */
+    static count(teamId: string): Promise<number>;
+    /**
+     * Get count of members by role
+     *
+     * @param teamId - Team ID
+     * @returns Object with role counts
+     *
+     * @example
+     * const counts = await TeamMemberService.countByRole('team-123')
+     * // { owner: 1, admin: 2, member: 5, viewer: 3 }
+     */
+    static countByRole(teamId: string): Promise<Record<string, number>>;
+    /**
+     * List all team memberships for a user
+     * Useful for team switcher or user profile
+     *
+     * @param userId - User ID
+     * @returns Array of memberships with team details
+     *
+     * @example
+     * const memberships = await TeamMemberService.listByUser('user-123')
+     */
+    static listByUser(userId: string): Promise<Array<TeamMember & {
+        teamName: string;
+        teamSlug: string;
+    }>>;
+    /**
+     * List team members filtered by role
+     *
+     * @param teamId - Team ID
+     * @param role - Role to filter by
+     * @param requestingUserId - User ID making the request (for RLS)
+     * @returns Array of members with that role
+     *
+     * @example
+     * const admins = await TeamMemberService.listByRole('team-123', 'admin', 'user-456')
+     */
+    static listByRole(teamId: string, role: TeamRole, requestingUserId: string): Promise<TeamMemberWithUser[]>;
+    /**
+     * Search team members by name or email
+     *
+     * @param teamId - Team ID
+     * @param query - Search query (name or email)
+     * @param requestingUserId - User ID making the request (for RLS)
+     * @returns Array of matching members
+     *
+     * @example
+     * const results = await TeamMemberService.search('team-123', 'john', 'user-456')
+     */
+    static search(teamId: string, query: string, requestingUserId: string): Promise<TeamMemberWithUser[]>;
+    /**
+     * Get recently joined members
+     *
+     * @param teamId - Team ID
+     * @param limit - Maximum number of members to return (default: 10)
+     * @param requestingUserId - User ID making the request (for RLS)
+     * @returns Array of recently joined members
+     *
+     * @example
+     * const recent = await TeamMemberService.getRecentlyJoined('team-123', 5, 'user-456')
+     */
+    static getRecentlyJoined(teamId: string, limit: number, requestingUserId: string): Promise<TeamMemberWithUser[]>;
+    /**
+     * Get members who were invited by a specific user
+     *
+     * @param teamId - Team ID
+     * @param invitedByUserId - User ID who sent the invitations
+     * @param requestingUserId - User ID making the request (for RLS)
+     * @returns Array of members invited by the user
+     *
+     * @example
+     * const invited = await TeamMemberService.listInvitedBy('team-123', 'user-456', 'user-789')
+     */
+    static listInvitedBy(teamId: string, invitedByUserId: string, requestingUserId: string): Promise<TeamMemberWithUser[]>;
+}
+//# sourceMappingURL=team-member.service.d.ts.map

package/dist/lib/services/team-member.service.d.ts.map

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

package/dist/lib/services/team.service.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Team Service
+ *
+ * Provides team management functions including creation, updates,
+ * and single-tenant (global team) operations.
+ *
+ * @module TeamService
+ */
+import type { Team, TeamRole } from '../teams/types';
+export interface TeamWithMemberCount extends Team {
+    memberCount: number;
+}
+export interface TeamWithDetails extends Team {
+    userRole: TeamRole;
+    joinedAt: string;
+    memberCount: number;
+}
+export interface UpdateTeamPayload {
+    name?: string;
+    slug?: string;
+    description?: string;
+    avatarUrl?: string;
+    settings?: Record<string, unknown>;
+}
+export declare class TeamService {
+    /**
+     * Get team by ID
+     *
+     * @param teamId - Team ID
+     * @param userId - Optional user ID for RLS
+     * @returns Team or null if not found
+     *
+     * @example
+     * const team = await TeamService.getById('team-123')
+     */
+    static getById(teamId: string, userId?: string): Promise<Team | null>;
+    /**
+     * Get team by slug
+     *
+     * @param slug - Team slug
+     * @returns Team or null if not found
+     *
+     * @example
+     * const team = await TeamService.getBySlug('my-team')
+     */
+    static getBySlug(slug: string): Promise<Team | null>;
+    /**
+     * Get the global team (for single-tenant mode)
+     * Returns the first team found (should be the only one)
+     *
+     * @returns The global team or null if none exists
+     *
+     * @example
+     * const globalTeam = await TeamService.getGlobal()
+     */
+    static getGlobal(): Promise<Team | null>;
+    /**
+     * Check if global team exists (for single-tenant mode)
+     * Used to determine if public signup should be blocked
+     *
+     * @returns True if a team exists, false otherwise
+     *
+     * @example
+     * const hasTeam = await TeamService.hasGlobal()
+     */
+    static hasGlobal(): Promise<boolean>;
+    /**
+     * Get all teams for a user with detailed information
+     *
+     * @param userId - The user ID
+     * @returns Array of teams with membership details
+     *
+     * @example
+     * const teams = await TeamService.getUserTeams('user-123')
+     */
+    static getUserTeams(userId: string): Promise<TeamWithDetails[]>;
+    /**
+     * Get team by ID with member count
+     *
+     * @param teamId - The team ID
+     * @param userId - The user ID (for RLS)
+     * @returns Team with member count or null
+     *
+     * @example
+     * const team = await TeamService.getWithMemberCount('team-123', 'user-456')
+     */
+    static getWithMemberCount(teamId: string, userId: string): Promise<TeamWithMemberCount | null>;
+    /**
+     * Get team owner with user details
+     *
+     * @param teamId - Team ID
+     * @returns Owner user information or null
+     *
+     * @example
+     * const owner = await TeamService.getOwner('team-123')
+     */
+    static getOwner(teamId: string): Promise<{
+        id: string;
+        name: string | null;
+        email: string;
+        image: string | null;
+    } | null>;
+    /**
+     * Get teams owned by a user
+     *
+     * @param userId - User ID
+     * @returns Array of teams owned by the user
+     *
+     * @example
+     * const ownedTeams = await TeamService.getByOwnerId('user-123')
+     */
+    static getByOwnerId(userId: string): Promise<Team[]>;
+    /**
+     * Create a new team
+     * Also creates team membership for owner and default subscription
+     *
+     * @param userId - The ID of the user creating the team
+     * @param name - Optional team name (defaults to user's name + Team)
+     * @returns The created Team
+     *
+     * @example
+     * const team = await TeamService.create('user-123', 'My Company')
+     */
+    static create(userId: string, name?: string): Promise<Team>;
+    /**
+     * Update team
+     *
+     * @param teamId - Team ID
+     * @param data - Update payload
+     * @param userId - User ID (for permission check and RLS)
+     * @returns Updated team
+     *
+     * @example
+     * const team = await TeamService.update('team-123', { name: 'New Name' }, 'user-456')
+     */
+    static update(teamId: string, data: UpdateTeamPayload, userId: string): Promise<Team>;
+    /**
+     * Delete team
+     * Only the owner can delete a team
+     *
+     * @param teamId - Team ID
+     * @param userId - User ID (must be owner)
+     *
+     * @example
+     * await TeamService.delete('team-123', 'user-456')
+     */
+    static delete(teamId: string, userId: string): Promise<void>;
+    /**
+     * Check if slug is available (not used by another team)
+     *
+     * @param slug - The slug to check
+     * @param excludeTeamId - Optional team ID to exclude from check (for updates)
+     * @returns True if slug is available, false otherwise
+     *
+     * @example
+     * const available = await TeamService.isSlugAvailable('my-team')
+     */
+    static isSlugAvailable(slug: string, excludeTeamId?: string): Promise<boolean>;
+    /**
+     * Generate a unique slug for a team
+     *
+     * @param baseName - The base name to generate slug from
+     * @returns A unique slug
+     *
+     * @example
+     * const slug = await TeamService.generateSlug('My Company')
+     * // 'my-company' or 'my-company-1' if taken
+     */
+    static generateSlug(baseName: string): Promise<string>;
+    /**
+     * Switch active team (for session management)
+     * Verifies user is a member of the team
+     *
+     * @param userId - The user ID
+     * @param teamId - The team ID to switch to
+     * @returns True if successful
+     *
+     * @example
+     * await TeamService.switchActive('user-123', 'team-456')
+     */
+    static switchActive(userId: string, teamId: string): Promise<boolean>;
+    /**
+     * Check if team exists
+     *
+     * @param teamId - Team ID
+     * @returns True if team exists
+     *
+     * @example
+     * const exists = await TeamService.exists('team-123')
+     */
+    static exists(teamId: string): Promise<boolean>;
+}
+//# sourceMappingURL=team.service.d.ts.map

package/dist/lib/services/team.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/team.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAMpD,MAAM,WAAW,mBAAoB,SAAQ,IAAI;IAC/C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI;IAC3C,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAMD,qBAAa,WAAW;IAKtB;;;;;;;;;OASG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAY3E;;;;;;;;OAQG;WACU,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAW1D;;;;;;;;OAQG;WACU,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS9C;;;;;;;;OAQG;WACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1C;;;;;;;;OAQG;WACU,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA2CrE;;;;;;;;;OASG;WACU,kBAAkB,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IA2BtC;;;;;;;;OAQG;WACU,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACrB,GAAG,IAAI,CAAC;IAmBT;;;;;;;;OAQG;WACU,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAgB1D;;;;;;;;;;OAUG;WACU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEjE;;;;;;;;;;OAUG;WACU,MAAM,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA+DhB;;;;;;;;;OASG;WACU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClE;;;;;;;;;OASG;WACU,eAAe,CAC1B,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAoBnB;;;;;;;;;OASG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmC5D;;;;;;;;;;OAUG;WACU,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB3E;;;;;;;;OAQG;WACU,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAYtD"}

package/dist/lib/services/template.service.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Template Service
+ *
+ * Provides template query and resolution operations.
+ * Uses pre-computed data from template-registry for O(1) operations.
+ *
+ * @module TemplateService
+ */
+import { TEMPLATE_METADATA, TemplateRegistryEntry, TemplateOverride } from '@nextsparkjs/registries/template-registry';
+/**
+ * Template Service - Provides runtime template queries
+ *
+ * This service layer abstracts template registry access, making the registry
+ * a pure data structure (Data-Only pattern). All query logic lives here.
+ *
+ * Performance: All operations are O(1) or O(n) with zero I/O.
+ */
+export declare class TemplateService {
+    /**
+     * Check if an app path has a template override
+     *
+     * @param appPath - App path to check (e.g., 'app/(public)/page.tsx')
+     * @returns True if template override exists
+     *
+     * @example
+     * ```typescript
+     * if (TemplateService.hasOverride('app/(public)/page.tsx')) {
+     *   // Template exists, use override
+     * }
+     * ```
+     */
+    static hasOverride(appPath: string): boolean;
+    /**
+     * Get template component for app path
+     * Returns the highest priority template component
+     *
+     * @param appPath - App path to get component for
+     * @returns Template component or null if not found
+     *
+     * @example
+     * ```typescript
+     * const Component = TemplateService.getComponent('app/(public)/page.tsx')
+     * if (Component) {
+     *   return <Component {...props} />
+     * }
+     * ```
+     */
+    static getComponent(appPath: string): any | null;
+    /**
+     * Get full template entry for app path
+     *
+     * @param appPath - App path to get entry for
+     * @returns Template registry entry or null if not found
+     *
+     * @example
+     * ```typescript
+     * const entry = TemplateService.getEntry('app/(public)/page.tsx')
+     * if (entry) {
+     *   console.log(entry.template.themeName) // 'default'
+     * }
+     * ```
+     */
+    static getEntry(appPath: string): TemplateRegistryEntry | null;
+    /**
+     * Get all app paths that have template overrides
+     *
+     * @returns Array of app paths with overrides
+     *
+     * @example
+     * ```typescript
+     * const paths = TemplateService.getOverriddenPaths()
+     * // ['app/(public)/page.tsx', 'app/(public)/layout.tsx', ...]
+     * ```
+     */
+    static getOverriddenPaths(): string[];
+    /**
+     * Get templates by template type
+     *
+     * @param templateType - Template type (e.g., 'page', 'layout', 'error')
+     * @returns Array of template entries matching the type
+     *
+     * @example
+     * ```typescript
+     * const pages = TemplateService.getByType('page')
+     * const layouts = TemplateService.getByType('layout')
+     * ```
+     */
+    static getByType(templateType: string): TemplateRegistryEntry[];
+    /**
+     * Get templates by theme name
+     *
+     * @param themeName - Theme name (e.g., 'default')
+     * @returns Array of template entries for the theme
+     *
+     * @example
+     * ```typescript
+     * const defaultTemplates = TemplateService.getByTheme('default')
+     * ```
+     */
+    static getByTheme(themeName: string): TemplateRegistryEntry[];
+    /**
+     * Resolve template for a given app path
+     * Returns theme template if available, null if should use original app file
+     *
+     * @param appPath - App path to resolve
+     * @returns Resolution result with hasOverride flag and template details
+     *
+     * @example
+     * ```typescript
+     * const result = TemplateService.resolve('app/(public)/page.tsx')
+     * if (result.hasOverride) {
+     *   return result.component
+     * }
+     * // Use original app file
+     * ```
+     */
+    static resolve(appPath: string): {
+        hasOverride: boolean;
+        component?: any;
+        template?: TemplateOverride;
+        originalPath: string;
+    };
+    /**
+     * Get all template entries
+     *
+     * @returns Array of all template entries
+     */
+    static getAll(): TemplateRegistryEntry[];
+    /**
+     * Get template count
+     *
+     * @returns Total number of templates
+     */
+    static getCount(): number;
+    /**
+     * Get available template types
+     *
+     * @returns Array of template types (e.g., ['page', 'layout'])
+     */
+    static getTypes(): string[];
+    /**
+     * Get registry metadata
+     *
+     * @returns Template registry metadata
+     */
+    static getMetadata(): typeof TEMPLATE_METADATA;
+}
+//# sourceMappingURL=template.service.d.ts.map

package/dist/lib/services/template.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/template.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAEjB,MAAM,2CAA2C,CAAA;AAElD;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAKhD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAI9D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAK/D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAuB7D;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAC/B,WAAW,EAAE,OAAO,CAAA;QACpB,SAAS,CAAC,EAAE,GAAG,CAAA;QACf,QAAQ,CAAC,EAAE,gBAAgB,CAAA;QAC3B,YAAY,EAAE,MAAM,CAAA;KACrB;IAkBD;;;;OAIG;IACH,MAAM,CAAC,MAAM,IAAI,qBAAqB,EAAE;IAIxC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM;IAIzB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO,iBAAiB;CAG/C"}

package/dist/lib/services/theme.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Theme Service
+ *
+ * Service layer for theme registry operations.
+ * Provides static methods for querying theme data.
+ */
+import { THEME_METADATA, type ThemeRegistryEntry, type ThemeEntity, type ThemeRouteFile, type ThemeName } from '@nextsparkjs/registries/theme-registry';
+import type { ThemeConfig } from '../../types/theme';
+import type { DevConfig } from '../config/types';
+export type { ThemeRegistryEntry, ThemeEntity, ThemeRouteFile, ThemeName };
+/**
+ * ThemeService - Static service for theme operations
+ */
+export declare class ThemeService {
+    /**
+     * Get all registered themes
+     * @returns Array of ThemeConfig
+     * @complexity O(n) where n = number of themes
+     */
+    static getAll(): ThemeConfig[];
+    /**
+     * Get theme by name
+     * @complexity O(1)
+     */
+    static getByName(name: string): ThemeConfig | undefined;
+    /**
+     * Get full registry entry by name
+     * @complexity O(1)
+     */
+    static getEntry(name: string): ThemeRegistryEntry | undefined;
+    /**
+     * Get dashboard config for a theme
+     * @complexity O(1)
+     */
+    static getDashboardConfig(name: string): any | undefined;
+    /**
+     * Get app config for a theme
+     * @complexity O(1)
+     */
+    static getAppConfig(name: string): any | undefined;
+    /**
+     * Get dev config for a theme
+     * Contains development-only settings like DevKeyring
+     * @complexity O(1)
+     */
+    static getDevConfig(name: string): DevConfig | null;
+    /**
+     * Get themes with entities
+     * @complexity O(n)
+     */
+    static getWithEntities(): ThemeRegistryEntry[];
+    /**
+     * Get themes with API routes
+     * @complexity O(n)
+     */
+    static getWithRoutes(): ThemeRegistryEntry[];
+    /**
+     * Get themes using a specific plugin
+     * @complexity O(n)
+     */
+    static getUsingPlugin(pluginName: string): ThemeRegistryEntry[];
+    /**
+     * Get plugin usage across all themes
+     * @complexity O(n)
+     */
+    static getPluginUsage(pluginName: string): {
+        theme: string;
+        entities: number;
+        routes: number;
+    }[];
+    /**
+     * Check if theme exists
+     * @complexity O(1)
+     */
+    static exists(name: string): boolean;
+    /**
+     * Get theme names
+     * @complexity O(1) - uses pre-computed metadata
+     */
+    static getNames(): string[];
+    /**
+     * Get total theme count
+     * @complexity O(1) - uses pre-computed metadata
+     */
+    static getCount(): number;
+    /**
+     * Get metadata
+     * @complexity O(1)
+     */
+    static getMetadata(): typeof THEME_METADATA;
+}
+export declare const getRegisteredThemes: typeof ThemeService.getAll;
+export declare const getTheme: typeof ThemeService.getByName;
+export declare const getThemeDashboardConfig: typeof ThemeService.getDashboardConfig;
+export declare const getThemeAppConfig: typeof ThemeService.getAppConfig;
+export declare const getThemeDevConfig: typeof ThemeService.getDevConfig;
+export declare const getThemesWithEntities: typeof ThemeService.getWithEntities;
+export declare const getThemesWithRoutes: typeof ThemeService.getWithRoutes;
+export declare const getThemesUsingPlugin: typeof ThemeService.getUsingPlugin;
+export declare const getPluginUsage: typeof ThemeService.getPluginUsage;
+//# sourceMappingURL=theme.service.d.ts.map

package/dist/lib/services/theme.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/theme.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,CAAA;AAE1E;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;IACH,MAAM,CAAC,MAAM,IAAI,WAAW,EAAE;IAI9B;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIvD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI7D;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAIxD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAIlD;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAInD;;;OAGG;IACH,MAAM,CAAC,eAAe,IAAI,kBAAkB,EAAE;IAM9C;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,kBAAkB,EAAE;IAM5C;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAM/D;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;IAUhG;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;IAI3B;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO,cAAc;CAG5C;AAGD,eAAO,MAAM,mBAAmB,4BAAsB,CAAA;AACtD,eAAO,MAAM,QAAQ,+BAAyB,CAAA;AAC9C,eAAO,MAAM,uBAAuB,wCAAkC,CAAA;AACtE,eAAO,MAAM,iBAAiB,kCAA4B,CAAA;AAC1D,eAAO,MAAM,iBAAiB,kCAA4B,CAAA;AAC1D,eAAO,MAAM,qBAAqB,qCAA+B,CAAA;AACjE,eAAO,MAAM,mBAAmB,mCAA6B,CAAA;AAC7D,eAAO,MAAM,oBAAoB,oCAA8B,CAAA;AAC/D,eAAO,MAAM,cAAc,oCAA8B,CAAA"}