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

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

@@ -0,0 +1,236 @@
+/**
+ * Invoice Service
+ *
+ * Provides invoice management functions for billing operations.
+ * Invoices are synced from Stripe and stored locally for fast access.
+ *
+ * @module InvoiceService
+ */
+import type { Invoice, InvoiceStatus } from '../billing/types';
+export interface ListInvoicesOptions {
+    /** Maximum number of invoices to return (default: 10) */
+    limit?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+    /** Filter by status */
+    status?: InvoiceStatus;
+}
+export interface ListInvoicesResult {
+    invoices: Invoice[];
+    total: number;
+}
+export interface CreateInvoicePayload {
+    teamId: string;
+    invoiceNumber: string;
+    date: Date;
+    /** Amount in dollars (not cents) */
+    amount: number;
+    currency: string;
+    status: InvoiceStatus;
+    pdfUrl?: string | null;
+    description?: string | null;
+}
+export interface PaymentDetails {
+    paidAt?: Date;
+    paymentMethod?: string;
+    transactionId?: string;
+}
+export declare class InvoiceService {
+    /**
+     * Get invoice by ID
+     *
+     * @param id - Invoice ID
+     * @returns Invoice or null if not found
+     *
+     * @example
+     * const invoice = await InvoiceService.getById('inv-123')
+     */
+    static getById(id: string): Promise<Invoice | null>;
+    /**
+     * Get invoice by invoice number
+     *
+     * @param invoiceNumber - Invoice number (e.g., 'INV-2024-001')
+     * @param teamId - Optional team ID for additional filtering
+     * @returns Invoice or null if not found
+     *
+     * @example
+     * const invoice = await InvoiceService.getByNumber('INV-2024-001', 'team-123')
+     */
+    static getByNumber(invoiceNumber: string, teamId?: string): Promise<Invoice | null>;
+    /**
+     * List invoices for a team with pagination
+     *
+     * @param teamId - Team ID
+     * @param options - List options (limit, offset, status filter)
+     * @returns Invoices array and total count
+     *
+     * @example
+     * const { invoices, total } = await InvoiceService.listByTeam('team-123', {
+     *   limit: 10,
+     *   offset: 0,
+     *   status: 'paid'
+     * })
+     */
+    static listByTeam(teamId: string, options?: ListInvoicesOptions): Promise<ListInvoicesResult>;
+    /**
+     * List invoices for a subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @returns Array of invoices
+     *
+     * @example
+     * const invoices = await InvoiceService.listBySubscription('sub-123')
+     */
+    static listBySubscription(subscriptionId: string): Promise<Invoice[]>;
+    /**
+     * List overdue invoices (pending and past due date)
+     *
+     * @param options - Pagination options
+     * @returns Array of overdue invoices
+     *
+     * @example
+     * const overdueInvoices = await InvoiceService.listOverdue()
+     */
+    static listOverdue(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Invoice[]>;
+    /**
+     * List invoices by date range
+     *
+     * @param startDate - Start date
+     * @param endDate - End date
+     * @param teamId - Optional team ID to filter
+     * @returns Array of invoices within the date range
+     *
+     * @example
+     * const q1Invoices = await InvoiceService.listByDateRange(
+     *   new Date('2024-01-01'),
+     *   new Date('2024-03-31')
+     * )
+     */
+    static listByDateRange(startDate: Date, endDate: Date, teamId?: string): Promise<Invoice[]>;
+    /**
+     * Get the most recent invoice for a team
+     *
+     * @param teamId - Team ID
+     * @returns Most recent invoice or null
+     *
+     * @example
+     * const lastInvoice = await InvoiceService.getLastForTeam('team-123')
+     */
+    static getLastForTeam(teamId: string): Promise<Invoice | null>;
+    /**
+     * Get revenue summary for a period
+     *
+     * @param year - Year to filter
+     * @param month - Optional month to filter (1-12)
+     * @returns Revenue summary with totals by status
+     *
+     * @example
+     * const revenue = await InvoiceService.getRevenueSummary(2024)
+     * const janRevenue = await InvoiceService.getRevenueSummary(2024, 1)
+     */
+    static getRevenueSummary(year: number, month?: number): Promise<{
+        paid: number;
+        pending: number;
+        failed: number;
+        total: number;
+    }>;
+    /**
+     * Create a new invoice
+     *
+     * @param data - Invoice data
+     * @returns Created invoice
+     *
+     * @example
+     * const invoice = await InvoiceService.create({
+     *   teamId: 'team-123',
+     *   invoiceNumber: 'INV-2024-001',
+     *   date: new Date(),
+     *   amount: 29.00,
+     *   currency: 'USD',
+     *   status: 'pending',
+     * })
+     */
+    static create(data: CreateInvoicePayload): Promise<Invoice>;
+    /**
+     * Update invoice status
+     *
+     * @param id - Invoice ID
+     * @param status - New status
+     * @returns Updated invoice
+     *
+     * @example
+     * const invoice = await InvoiceService.updateStatus('inv-123', 'paid')
+     */
+    static updateStatus(id: string, status: InvoiceStatus): Promise<Invoice>;
+    /**
+     * Mark invoice as paid
+     *
+     * @param id - Invoice ID
+     * @param _paymentDetails - Optional payment details (reserved for future use)
+     * @returns Updated invoice
+     *
+     * @example
+     * const invoice = await InvoiceService.markAsPaid('inv-123')
+     */
+    static markAsPaid(id: string, _paymentDetails?: PaymentDetails): Promise<Invoice>;
+    /**
+     * Update invoice PDF URL
+     *
+     * @param id - Invoice ID
+     * @param pdfUrl - PDF URL from Stripe
+     * @returns Updated invoice
+     *
+     * @example
+     * await InvoiceService.updatePdfUrl('inv-123', 'https://stripe.com/...')
+     */
+    static updatePdfUrl(id: string, pdfUrl: string): Promise<Invoice>;
+    /**
+     * Generate a unique invoice number for a team
+     *
+     * Format: INV-YYYY-NNNN (e.g., INV-2024-0001)
+     *
+     * @param teamId - Team ID
+     * @returns Generated invoice number
+     *
+     * @example
+     * const number = await InvoiceService.generateNumber('team-123')
+     * // 'INV-2024-0001'
+     */
+    static generateNumber(teamId: string): Promise<string>;
+    /**
+     * Get PDF URL for an invoice
+     *
+     * @param id - Invoice ID
+     * @returns PDF URL or null if not available
+     *
+     * @example
+     * const url = await InvoiceService.getPdfUrl('inv-123')
+     */
+    static getPdfUrl(id: string): Promise<string | null>;
+    /**
+     * Check if an invoice exists
+     *
+     * @param invoiceNumber - Invoice number
+     * @param teamId - Team ID
+     * @returns True if invoice exists
+     *
+     * @example
+     * const exists = await InvoiceService.exists('INV-2024-0001', 'team-123')
+     */
+    static exists(invoiceNumber: string, teamId: string): Promise<boolean>;
+    /**
+     * Get total amount for a team's invoices (paid only)
+     *
+     * @param teamId - Team ID
+     * @param year - Optional year filter
+     * @returns Total amount in dollars
+     *
+     * @example
+     * const total = await InvoiceService.getTotalPaid('team-123', 2024)
+     */
+    static getTotalPaid(teamId: string, year?: number): Promise<number>;
+}
+//# sourceMappingURL=invoice.service.d.ts.map

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

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

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

@@ -0,0 +1,171 @@
+/**
+ * Membership Service
+ *
+ * Provides unified team membership context combining:
+ * - Role & hierarchy
+ * - Permissions (RBAC)
+ * - Subscription features
+ * - Quota state
+ *
+ * @module MembershipService
+ */
+import type { Permission, ActionResult, MembershipSubscription, QuotaState, TeamMembershipData } from '../permissions/types';
+/**
+ * Represents complete team membership context for a user
+ *
+ * Combines role, permissions, subscription, features, and quotas
+ * into a single object with helper methods.
+ */
+export declare class TeamMembership implements TeamMembershipData {
+    readonly userId: string;
+    readonly teamId: string;
+    readonly role: string | null;
+    readonly hierarchy: number;
+    readonly permissions: Permission[];
+    readonly subscription: MembershipSubscription | null;
+    readonly features: string[];
+    readonly quotas: Record<string, QuotaState>;
+    constructor(data: TeamMembershipData);
+    /**
+     * Check if user has minimum hierarchy level
+     *
+     * @param level - Minimum hierarchy level required
+     * @returns True if user meets or exceeds level
+     *
+     * @example
+     * if (membership.hasMinHierarchy(50)) {
+     *   // User has hierarchy >= 50 (admin or higher)
+     * }
+     */
+    hasMinHierarchy(level: number): boolean;
+    /**
+     * Check if user has specific role
+     *
+     * @param role - Role to check
+     * @returns True if user has the role
+     *
+     * @example
+     * if (membership.hasRole('admin')) {
+     *   // User is admin
+     * }
+     */
+    hasRole(role: string): boolean;
+    /**
+     * Check if user has any of the specified roles
+     *
+     * @param roles - Array of roles to check
+     * @returns True if user has at least one role
+     *
+     * @example
+     * if (membership.hasAnyRole(['owner', 'admin'])) {
+     *   // User is owner or admin
+     * }
+     */
+    hasAnyRole(roles: string[]): boolean;
+    /**
+     * Check if user has specific permission
+     *
+     * @param permission - Permission to check
+     * @returns True if user has the permission
+     *
+     * @example
+     * if (membership.hasPermission('customers.delete')) {
+     *   // User can delete customers
+     * }
+     */
+    hasPermission(permission: Permission): boolean;
+    /**
+     * Check if user has specific feature
+     *
+     * @param feature - Feature slug to check
+     * @returns True if plan includes feature
+     *
+     * @example
+     * if (membership.hasFeature('advanced_analytics')) {
+     *   // Plan includes advanced analytics
+     * }
+     */
+    hasFeature(feature: string): boolean;
+    /**
+     * Check quota for a specific limit
+     *
+     * @param limitSlug - Limit slug to check
+     * @param increment - Optional increment to check against
+     * @returns Object with allowed status and remaining quota
+     *
+     * @example
+     * const quota = membership.checkQuota('projects', 1)
+     * if (!quota.allowed) {
+     *   console.log('Quota exceeded')
+     * }
+     */
+    checkQuota(limitSlug: string, increment?: number): {
+        allowed: boolean;
+        remaining: number;
+    };
+    /**
+     * Check if action is allowed (comprehensive check)
+     *
+     * Verifies:
+     * 1. User is a member
+     * 2. User has required permission (RBAC)
+     * 3. Plan includes required feature
+     * 4. Quota is available
+     * 5. Subscription is active
+     *
+     * @param action - Action slug to check
+     * @param options - Options for quota increment
+     * @returns ActionResult with allowed status and details
+     *
+     * @example
+     * const result = membership.canPerformAction('projects.create')
+     * if (!result.allowed) {
+     *   console.log(result.message, result.reason)
+     * }
+     */
+    canPerformAction(action: string, options?: {
+        incrementQuota?: number;
+    }): ActionResult;
+}
+export declare class MembershipService {
+    /**
+     * Get complete team membership context for a user
+     *
+     * Combines data from:
+     * - TeamMemberService (role, joinedAt)
+     * - SubscriptionService (plan, features, quotas)
+     * - PermissionService (permissions array)
+     * - APP_CONFIG_MERGED (hierarchy from role config)
+     *
+     * @param userId - User ID
+     * @param teamId - Team ID
+     * @returns TeamMembership object
+     *
+     * @example
+     * const membership = await MembershipService.get('user-123', 'team-456')
+     * if (membership.hasMinHierarchy(50)) {
+     *   // User is admin or higher
+     * }
+     */
+    static get(userId: string, teamId: string): Promise<TeamMembership>;
+    /**
+     * Get hierarchy level for a role from config
+     *
+     * @param role - Team role
+     * @returns Hierarchy number (higher = more privileged)
+     *
+     * @private
+     */
+    private static getHierarchyForRole;
+    /**
+     * Get quota states for all limits in a plan
+     *
+     * @param subscriptionId - Subscription ID
+     * @param planSlug - Plan slug
+     * @returns Object with quota states by limit slug
+     *
+     * @private
+     */
+    private static getQuotaStates;
+}
+//# sourceMappingURL=membership.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"membership.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/membership.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EAEZ,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EACnB,MAAM,sBAAsB,CAAA;AAM7B;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;gBAE/B,IAAI,EAAE,kBAAkB;IAWpC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;IAKpC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAI9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;;;;;;;;OAYG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAU,GACpB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAmB1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACpC,YAAY;CAmDhB;AAMD,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;WACU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkEzE;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAiBlC;;;;;;;;OAQG;mBACkB,cAAc;CAyCpC"}

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

@@ -0,0 +1,58 @@
+import { EntityType, CreateMetaPayload } from '../../types/meta.types';
+export declare class MetaService {
+    /**
+     * Obtener configuración de entidad
+     */
+    private static getEntityConfig;
+    /**
+     * Obtener todos los meta datos de una entidad
+     */
+    static getEntityMetas(entityType: EntityType, entityId: string, userId: string, includePrivate?: boolean): Promise<Record<string, unknown>>;
+    /**
+     * Obtener meta datos para múltiples entidades en bulk (soluciona N+1 queries)
+     */
+    static getBulkEntityMetas(entityType: EntityType, entityIds: string[], userId: string, includePrivate?: boolean): Promise<Record<string, Record<string, unknown>>>;
+    /**
+     * Obtener meta datos específicos de una entidad
+     */
+    static getSpecificEntityMetas(entityType: EntityType, entityId: string, metaKeys: string[], userId: string): Promise<Record<string, unknown>>;
+    /**
+     * Obtener meta datos específicos para múltiples entidades en bulk
+     */
+    static getBulkSpecificEntityMetas(entityType: EntityType, entityIds: string[], metaKeys: string[], userId: string): Promise<Record<string, Record<string, unknown>>>;
+    /**
+     * Obtener un meta dato específico
+     */
+    static getEntityMeta(entityType: EntityType, entityId: string, metaKey: string, userId: string): Promise<unknown>;
+    /**
+     * Establecer un meta dato
+     *
+     * NOTE: Metas tables do NOT have teamId column - security is inherited from parent entity via RLS.
+     * This follows the CRM theme pattern where metadata access is controlled through the parent entity.
+     */
+    static setEntityMeta(entityType: EntityType, entityId: string, metaKey: string, metaValue: unknown, userId: string, options?: Partial<CreateMetaPayload>): Promise<void>;
+    /**
+     * Establecer múltiples meta datos en batch (optimizado con transacciones)
+     */
+    static setBulkEntityMetas(entityType: EntityType, entityId: string, metas: Record<string, unknown>, userId: string, options?: Partial<CreateMetaPayload>): Promise<void>;
+    /**
+     * Eliminar un meta dato
+     */
+    static deleteEntityMeta(entityType: EntityType, entityId: string, metaKey: string, userId: string): Promise<void>;
+    /**
+     * Eliminar todos los meta datos de una entidad
+     */
+    static deleteAllEntityMetas(entityType: EntityType, entityId: string, userId: string): Promise<void>;
+    /**
+     * Buscar entidades por meta datos (optimizado con límites)
+     */
+    static searchByMeta(entityType: EntityType, metaKey: string, metaValue: unknown, userId: string, limit?: number, offset?: number): Promise<{
+        entities: string[];
+        total: number;
+    }>;
+    /**
+     * Contar meta datos por entidad
+     */
+    static countEntityMetas(entityType: EntityType, entityId: string, userId: string): Promise<number>;
+}
+//# sourceMappingURL=meta.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/meta.service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,UAAU,EAEV,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAQ9B;;OAEG;WACU,cAAc,CACzB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAwBnC;;OAEG;WACU,kBAAkB,CAC7B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAuCnD;;OAEG;WACU,sBAAsB,CACjC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA0BnC;;OAEG;WACU,0BAA0B,CACrC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAqCnD;;OAEG;WACU,aAAa,CACxB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAanB;;;;;OAKG;WACU,aAAa,CACxB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,OAAO,CAAC,IAAI,CAAC;IAmDhB;;OAEG;WACU,kBAAkB,CAC7B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,OAAO,CAAC,IAAI,CAAC;IAwBhB;;OAEG;WACU,gBAAgB,CAC3B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;WACU,oBAAoB,CAC/B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;WACU,YAAY,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAY,EACnB,MAAM,GAAE,MAAU,GACjB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiCjD;;OAEG;WACU,gBAAgB,CAC3B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;CAWnB"}

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

@@ -0,0 +1,66 @@
+/**
+ * Middleware Service
+ *
+ * Service layer for middleware registry operations.
+ * Provides static methods for querying and executing theme middleware.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+import type { SessionUser } from '../auth';
+import { MIDDLEWARE_METADATA, type MiddlewareRegistryEntry, type ThemeName } from '@nextsparkjs/registries/middleware-registry';
+export type { MiddlewareRegistryEntry, ThemeName };
+/**
+ * MiddlewareService - Static service for middleware operations
+ */
+export declare class MiddlewareService {
+    /**
+     * Get middleware for specific theme
+     * @complexity O(1)
+     */
+    static getByTheme(themeName: string): MiddlewareRegistryEntry | undefined;
+    /**
+     * Get all registered middlewares
+     * @complexity O(n) where n = number of themes with middleware
+     */
+    static getAll(): MiddlewareRegistryEntry[];
+    /**
+     * Check if theme has middleware
+     * @complexity O(1)
+     */
+    static hasMiddleware(themeName: string): boolean;
+    /**
+     * Get registry metadata
+     * @complexity O(1)
+     */
+    static getMetadata(): typeof MIDDLEWARE_METADATA;
+    /**
+     * Execute theme middleware with error handling
+     * @complexity O(1) + async execution time
+     */
+    static execute(themeName: string, request: NextRequest, coreSession?: SessionUser | null): Promise<NextResponse | null>;
+    /**
+     * Redirect to login with callback URL
+     * Use for unauthenticated users trying to access protected routes
+     * @complexity O(1)
+     */
+    static redirectWithoutSession(request: NextRequest, targetPath?: string): NextResponse;
+    /**
+     * Redirect authenticated user to target path
+     * Use for authenticated users trying to access login/signup pages
+     * @complexity O(1)
+     */
+    static redirectWithSession(request: NextRequest, targetPath?: string): NextResponse;
+    /**
+     * Add user headers to request for downstream processing
+     * Adds x-user-id, x-user-email, and x-pathname headers
+     * @complexity O(1)
+     */
+    static addUserHeaders(request: NextRequest, sessionUser: SessionUser | null): NextResponse;
+}
+export declare const getActiveThemeMiddleware: typeof MiddlewareService.getByTheme;
+export declare const getAllMiddlewares: typeof MiddlewareService.getAll;
+export declare const hasThemeMiddleware: typeof MiddlewareService.hasMiddleware;
+export declare const executeThemeMiddleware: typeof MiddlewareService.execute;
+export declare const redirectWithoutSessionMiddleware: typeof MiddlewareService.redirectWithoutSession;
+export declare const redirectWithSessionMiddleware: typeof MiddlewareService.redirectWithSession;
+export declare const addUserHeadersMiddleware: typeof MiddlewareService.addUserHeaders;
+//# sourceMappingURL=middleware.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/middleware.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAEL,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACf,MAAM,6CAA6C,CAAA;AAGpD,YAAY,EAAE,uBAAuB,EAAE,SAAS,EAAE,CAAA;AAElD;;GAEG;AACH,qBAAa,iBAAiB;IAG5B;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIzE;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,uBAAuB,EAAE;IAI1C;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO,mBAAmB;IAMhD;;;OAGG;WACU,OAAO,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC/B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiB/B;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAC3B,OAAO,EAAE,WAAW,EACpB,UAAU,GAAE,MAAiB,GAC5B,YAAY;IAOf;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CACxB,OAAO,EAAE,WAAW,EACpB,UAAU,GAAE,MAAqB,GAChC,YAAY;IAIf;;;;OAIG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,WAAW,GAAG,IAAI,GAC9B,YAAY;CAmBhB;AAID,eAAO,MAAM,wBAAwB,qCAA+B,CAAA;AACpE,eAAO,MAAM,iBAAiB,iCAA2B,CAAA;AACzD,eAAO,MAAM,kBAAkB,wCAAkC,CAAA;AACjE,eAAO,MAAM,sBAAsB,kCAA4B,CAAA;AAC/D,eAAO,MAAM,gCAAgC,iDAA2C,CAAA;AACxF,eAAO,MAAM,6BAA6B,8CAAwC,CAAA;AAClF,eAAO,MAAM,wBAAwB,yCAAmC,CAAA"}