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

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

@@ -0,0 +1,137 @@
+/**
+ * Contents System Types
+ *
+ * Shared types for the contents system
+ */
+import type { EntityConfig } from '../entities/types';
+import type { PluginConfig, PluginHooks } from '../../types/plugin';
+import type { ThemeConfig, ComponentOverride } from '../theme/types';
+export type { EntityConfig };
+export type { PluginConfig, PluginHooks };
+export type { ThemeConfig, ComponentOverride };
+/**
+ * Contents loading result
+ */
+export interface ContentsLoadingResult {
+    entities: EntityConfig[];
+    plugins: PluginConfig[];
+    themes: ThemeConfig[];
+}
+/**
+ * Content item base interface
+ */
+export interface ContentItem {
+    name: string;
+    displayName: string;
+    version: string;
+    description?: string;
+    enabled?: boolean;
+}
+/**
+ * Content discovery result
+ */
+export interface ContentDiscoveryResult<T extends ContentItem = ContentItem> {
+    items: T[];
+    errors: string[];
+    warnings: string[];
+    discoveredAt: number;
+    duration: number;
+}
+/**
+ * Content loader interface
+ */
+export interface ContentLoader<T extends ContentItem = ContentItem> {
+    discover(): Promise<T[]>;
+    load(name: string): Promise<T | null>;
+    validate(item: T): {
+        valid: boolean;
+        errors: string[];
+    };
+    getLoadedItems(): T[];
+    clearCache(): void;
+}
+/**
+ * Contents system configuration
+ */
+export interface ContentsConfig {
+    autoDiscovery: {
+        enabled: boolean;
+        interval: number;
+        includeDevMode: boolean;
+    };
+    caching: {
+        enabled: boolean;
+        ttl: number;
+        maxSize: number;
+    };
+    security: {
+        validateItems: boolean;
+        allowDynamicImports: boolean;
+        trustedSources: string[];
+    };
+    performance: {
+        preloadEnabled: boolean;
+        batchLoading: boolean;
+        lazyComponents: boolean;
+    };
+}
+/**
+ * Content validation result
+ */
+export interface ContentValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    item: string;
+    type: 'entity' | 'plugin' | 'theme';
+}
+/**
+ * Contents system statistics
+ */
+export interface ContentsStats {
+    entities: {
+        total: number;
+        loaded: number;
+        active: number;
+        errors: number;
+    };
+    plugins: {
+        total: number;
+        loaded: number;
+        active: number;
+        errors: number;
+    };
+    themes: {
+        total: number;
+        loaded: number;
+        active: number;
+    };
+    performance: {
+        totalLoadTime: number;
+        cacheHitRate: number;
+        memoryUsage: number;
+    };
+    cache: {
+        size: number;
+        hits: number;
+        misses: number;
+    };
+}
+/**
+ * Content event types
+ */
+export type ContentEvent = 'content-discovered' | 'content-loaded' | 'content-error' | 'content-activated' | 'content-deactivated' | 'cache-cleared' | 'system-ready';
+/**
+ * Content event data
+ */
+export interface ContentEventData {
+    type: ContentEvent;
+    timestamp: number;
+    data: Record<string, unknown>;
+    source: 'entity' | 'plugin' | 'theme' | 'system';
+}
+/**
+ * Content event handler
+ */
+export type ContentEventHandler = (event: ContentEventData) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/countries-timezones.d.ts

@@ -0,0 +1,9 @@
+export declare const countries: {
+    value: string;
+    label: string;
+}[];
+export declare const timezones: {
+    value: string;
+    label: string;
+}[];
+//# sourceMappingURL=countries-timezones.d.ts.map

package/dist/lib/countries-timezones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries-timezones.d.ts","sourceRoot":"","sources":["../../src/lib/countries-timezones.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;GAsPrB,CAAA;AAED,eAAO,MAAM,SAAS;;;GAkFrB,CAAA"}

package/dist/lib/db.d.ts

@@ -0,0 +1,141 @@
+import { Pool } from 'pg';
+/**
+ * Parse SSL mode from DATABASE_URL using proper URL parameter parsing
+ * Supports: disable, allow, prefer, require, verify-ca, verify-full
+ *
+ * Security behavior:
+ * - Production: Defaults to rejectUnauthorized: true (validates certificates)
+ * - Development: Defaults to no SSL (localhost doesn't need it)
+ * - Explicit sslmode in URL always takes precedence
+ */
+export declare function parseSSLConfig(databaseUrl: string): false | {
+    rejectUnauthorized: boolean;
+};
+declare const pool: Pool;
+/**
+ * Validate userId format to prevent SQL injection in SET LOCAL commands
+ *
+ * Security behavior:
+ * - Production: Requires valid UUID format (RFC 4122 compliant)
+ * - Development: Allows test IDs but validates against SQL injection
+ *
+ * Valid test ID patterns (development only):
+ * - Alphanumeric characters: a-z, A-Z, 0-9
+ * - Hyphens and underscores: -, _
+ * - Examples: "test-superadmin-001", "dev_user_123"
+ *
+ * Blocked in ALL environments:
+ * - SQL injection characters: ' " \ ;
+ * - Control characters: 0x00-0x1F
+ * - Values exceeding 255 characters
+ *
+ * @security SEC-003 - SQL injection prevention in SET LOCAL commands
+ * @internal Exported for testing only
+ */
+export declare function validateUserId(userId: string): void;
+/**
+ * Execute a query with RLS context
+ * Sets the current user ID for Row Level Security policies via app.user_id
+ *
+ * @param query - SQL query string
+ * @param params - Query parameters
+ * @param userId - User ID for RLS context (optional - if not provided, runs without RLS context)
+ * @returns Query result rows
+ */
+export declare function queryWithRLS<T = unknown>(query: string, params?: unknown[], userId?: string | null): Promise<T[]>;
+/**
+ * Execute a single query and return the first row
+ * Useful for queries that return a single result
+ */
+export declare function queryOneWithRLS<T = unknown>(query: string, params?: unknown[], userId?: string | null): Promise<T | null>;
+/**
+ * Execute a mutation (INSERT, UPDATE, DELETE) with RLS context
+ * Returns the affected rows
+ */
+export declare function mutateWithRLS<T = unknown>(query: string, params?: unknown[], userId?: string | null): Promise<{
+    rows: T[];
+    rowCount: number;
+}>;
+/**
+ * Get a transaction client for multiple operations
+ * Useful when you need to run multiple queries in the same RLS context
+ *
+ * @example
+ * const tx = await getTransactionClient(userId);
+ * try {
+ *   await tx.query('INSERT INTO ...');
+ *   await tx.query('UPDATE ...');
+ *   await tx.commit();
+ * } catch (error) {
+ *   await tx.rollback();
+ *   throw error;
+ * }
+ */
+export declare function getTransactionClient(userId?: string | null): Promise<{
+    query: <T = unknown>(query: string, params?: unknown[]) => Promise<T[]>;
+    queryOne: <T = unknown>(query: string, params?: unknown[]) => Promise<T>;
+    mutate: <T = unknown>(query: string, params?: unknown[]) => Promise<{
+        rows: T[];
+        rowCount: number;
+    }>;
+    commit: () => Promise<void>;
+    rollback: () => Promise<void>;
+}>;
+/**
+ * Execute a direct query without RLS context
+ * Use this for Better Auth tables (user, session, account, verification)
+ *
+ * @param text - SQL query string
+ * @param params - Query parameters
+ * @returns Query result
+ */
+export declare function query<T = unknown>(text: string, params?: unknown[]): Promise<{
+    rows: T[];
+    rowCount: number;
+}>;
+/**
+ * Execute a direct query and return only the rows
+ * Convenience function for SELECT queries
+ */
+export declare function queryRows<T = unknown>(text: string, params?: unknown[]): Promise<T[]>;
+/**
+ * Execute a direct query and return the first row
+ * Useful for queries that return a single result
+ */
+export declare function queryOne<T = unknown>(text: string, params?: unknown[]): Promise<T | null>;
+export { pool };
+/**
+ * Get the shared database pool
+ * Use this instead of creating new Pool instances
+ *
+ * @throws Error if the pool is shutting down or has been closed
+ */
+export declare function getPool(): Pool;
+/**
+ * Check if the pool is healthy and accepting connections
+ *
+ * Checks:
+ * - Pool is not shutting down
+ * - Pool has available capacity (not at max with all busy)
+ * - No excessive waiting queue
+ */
+export declare function isPoolHealthy(): boolean;
+/**
+ * Get pool statistics for monitoring
+ */
+export declare function getPoolStats(): {
+    total: number;
+    idle: number;
+    waiting: number;
+    activeConnections: number;
+    isShuttingDown: boolean;
+};
+/**
+ * Gracefully shutdown the database pool
+ * Waits for all active connections to complete before closing
+ *
+ * @param timeoutMs Maximum time to wait for connections to finish (default: 30s)
+ */
+export declare function gracefulShutdown(timeoutMs?: number): Promise<void>;
+export declare function checkDatabaseConnection(): Promise<boolean>;
+//# sourceMappingURL=db.d.ts.map

package/dist/lib/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,IAAI,CAAC;AAQ3C;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,CAiD3F;AAMD,QAAA,MAAM,IAAI,MAMR,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAwBnD;AA4BD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,OAAO,EAAO,EACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CA+Bd;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,OAAO,EAAO,EACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAGnB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,OAAO,EAAO,EACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;YAqBrD,CAAC,mBAAmB,MAAM,WAAU,OAAO,EAAE;eAE1C,CAAC,mBAAmB,MAAM,WAAU,OAAO,EAAE;aAE/C,CAAC,mBAAmB,MAAM,WAAU,OAAO,EAAE;cACK,CAAC,EAAE;;;;;GAUjE;AAGD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,CAAC,GAAG,OAAO,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAGnB;AAGD,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB;;;;;GAKG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAuBvC;AAED;;GAEG;AACH,wBAAgB,YAAY;;;;;;EAQ3B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD/E;AAmBD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAchE"}

package/dist/lib/docs/parser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Documentation Parser Utility
+ *
+ * Parses markdown files with gray-matter frontmatter and converts to HTML
+ * using remark. Provides utilities for extracting metadata from file names.
+ */
+export { extractOrderFromFilename, cleanFilename, slugToTitle } from './utils';
+/**
+ * Metadata extracted from frontmatter
+ */
+export interface DocMetadata {
+    title: string;
+    description?: string;
+    order?: number;
+    public?: boolean;
+}
+/**
+ * Parsed documentation page
+ */
+export interface DocPage {
+    slug: string;
+    title: string;
+    content: string;
+    metadata: DocMetadata;
+    path: string;
+    source: 'public' | 'superadmin';
+}
+/**
+ * Documentation section (folder)
+ */
+export interface DocSection {
+    title: string;
+    slug: string;
+    order: number;
+    pages: DocPage[];
+    children?: DocSection[];
+}
+/**
+ * Parse a markdown file with frontmatter and convert to HTML
+ *
+ * @param filePath - Absolute path to markdown file
+ * @returns Parsed metadata, raw content, and HTML
+ */
+export declare function parseMarkdownFile(filePath: string): Promise<{
+    metadata: DocMetadata;
+    content: string;
+    html: string;
+}>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/docs/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,QAAQ,EAAE,WAAW,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAgBD"}

package/dist/lib/docs/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Documentation Utility Functions
+ *
+ * Helper functions for docs processing that don't depend on markdown parsing
+ */
+/**
+ * Extract order number from filename with format: "01-filename.md"
+ *
+ * @param filename - File or folder name
+ * @returns Order number (999 if no prefix found)
+ */
+export declare function extractOrderFromFilename(filename: string): number;
+/**
+ * Clean filename by removing order prefix and extension
+ *
+ * @param filename - File or folder name
+ * @returns Clean slug
+ *
+ * @example
+ * cleanFilename('01-introduction.md') // 'introduction'
+ * cleanFilename('02-getting-started') // 'getting-started'
+ */
+export declare function cleanFilename(filename: string): string;
+/**
+ * Convert slug to human-readable title
+ *
+ * @param slug - Kebab-case slug
+ * @returns Title case string
+ *
+ * @example
+ * slugToTitle('getting-started') // 'Getting Started'
+ * slugToTitle('api-reference') // 'API Reference'
+ */
+export declare function slugToTitle(slug: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/docs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/lib/email/factory.d.ts

@@ -0,0 +1,18 @@
+import type { EmailProvider } from './types';
+export type EmailProviderType = 'resend' | 'console' | 'auto';
+export interface EmailFactoryOptions {
+    provider?: EmailProviderType;
+    resendApiKey?: string;
+    defaultFrom?: string;
+    consoleOptions?: {
+        enabled?: boolean;
+        logLevel?: 'full' | 'summary' | 'links-only';
+    };
+}
+export declare class EmailFactory {
+    private static instance;
+    static create(options?: EmailFactoryOptions): EmailProvider;
+    static getInstance(): EmailProvider;
+    static reset(): void;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/lib/email/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/lib/email/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;KAC9C,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IAErD,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAoD/D,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/lib/email/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './factory';
+export * from './templates';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/email/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/lib/email/providers/console.d.ts

@@ -0,0 +1,13 @@
+import type { EmailProvider, EmailOptions, EmailResponse } from '../types';
+export declare class ConsoleProvider implements EmailProvider {
+    private enabled;
+    private logLevel;
+    constructor(options?: {
+        enabled?: boolean;
+        logLevel?: 'full' | 'summary' | 'links-only';
+    });
+    send(options: EmailOptions): Promise<EmailResponse>;
+    verify(): Promise<boolean>;
+    private extractLinks;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/lib/email/providers/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/lib/email/providers/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3E,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAoC;gBAExC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAA;KAAE;IAKnF,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4GnD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC,OAAO,CAAC,YAAY;CAerB"}

package/dist/lib/email/providers/resend.d.ts

@@ -0,0 +1,9 @@
+import type { EmailProvider, EmailOptions, EmailResponse } from '../types';
+export declare class ResendProvider implements EmailProvider {
+    private client;
+    private defaultFrom;
+    constructor(apiKey: string, defaultFrom?: string);
+    send(options: EmailOptions): Promise<EmailResponse>;
+    verify(): Promise<boolean>;
+}
+//# sourceMappingURL=resend.d.ts.map

package/dist/lib/email/providers/resend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.d.ts","sourceRoot":"","sources":["../../../../src/lib/email/providers/resend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3E,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAS1C,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA6CnD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAgBjC"}

package/dist/lib/email/templates.d.ts

@@ -0,0 +1,28 @@
+import type { VerificationEmailData, PasswordResetEmailData, TeamInvitationEmailData } from './types';
+export declare const emailTemplates: {
+    verifyEmail: (data: VerificationEmailData) => {
+        subject: string;
+        html: string;
+    };
+    resetPassword: (data: PasswordResetEmailData) => {
+        subject: string;
+        html: string;
+    };
+    teamInvitation: (data: TeamInvitationEmailData) => {
+        subject: string;
+        html: string;
+    };
+};
+export declare const createVerificationEmail: (name: string | undefined, verifyUrl: string) => {
+    subject: string;
+    html: string;
+};
+export declare const createPasswordResetEmail: (name: string | undefined, resetUrl: string) => {
+    subject: string;
+    html: string;
+};
+export declare const createTeamInvitationEmail: (inviteeEmail: string, inviterName: string, teamName: string, role: string, acceptUrl: string, expiresIn?: string) => {
+    subject: string;
+    html: string;
+};
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/email/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/email/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAItG,eAAO,MAAM,cAAc;wBACL,qBAAqB;;;;0BA0EnB,sBAAsB;;;;2BAoFrB,uBAAuB;;;;CAmF/C,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,WAAW,MAAM;;;CAK/E,CAAC;AAEL,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,UAAU,MAAM;;;CAK/E,CAAC;AAEL,eAAO,MAAM,yBAAyB,GACpC,cAAc,MAAM,EACpB,aAAa,MAAM,EACnB,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,WAAW,MAAM,EACjB,YAAW,MAAiB;;;CAU1B,CAAC"}

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

@@ -0,0 +1,55 @@
+export interface EmailOptions {
+    from?: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    replyTo?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    attachments?: EmailAttachment[];
+    headers?: Record<string, string>;
+}
+export interface EmailAttachment {
+    filename: string;
+    content: Buffer | string;
+    contentType?: string;
+}
+export interface EmailResponse {
+    id: string;
+    success: boolean;
+    error?: string;
+}
+export interface EmailProvider {
+    send(options: EmailOptions): Promise<EmailResponse>;
+    verify?(): Promise<boolean>;
+}
+export interface EmailTemplateData {
+    [key: string]: string | number | boolean | undefined;
+}
+export interface VerificationEmailData extends EmailTemplateData {
+    userName: string;
+    verificationUrl: string;
+    appName: string;
+}
+export interface PasswordResetEmailData extends EmailTemplateData {
+    userName: string;
+    resetUrl: string;
+    appName: string;
+    expiresIn?: string;
+}
+export interface WelcomeEmailData extends EmailTemplateData {
+    userName: string;
+    appName: string;
+    loginUrl: string;
+}
+export interface TeamInvitationEmailData extends EmailTemplateData {
+    inviteeEmail: string;
+    inviterName: string;
+    teamName: string;
+    role: string;
+    acceptUrl: string;
+    expiresIn: string;
+    appName: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/email/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/lib/entities/api-generator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * ⚠️  DEPRECATED: Auto-API Generation System
+ *
+ * This system is deprecated due to anti-hardcoding policy violations.
+ * All mock functions and hardcoded logic have been removed.
+ *
+ * Use specific entity API endpoints instead:
+ * - /api/v1/{entityType} for list operations
+ * - /api/v1/{entityType}/{id} for single operations
+ *
+ * @deprecated Use registry-based specific endpoints instead
+ */
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import type { EntityConfig } from './types';
+export interface APIGeneratorOptions {
+    enableAuth?: boolean;
+    enableRateLimit?: boolean;
+    enableCORS?: boolean;
+    enableChildEntities?: boolean;
+    customValidation?: Record<string, z.ZodSchema>;
+    customMiddleware?: APIMiddleware[];
+}
+export interface APIMiddleware {
+    name: string;
+    execute: (req: NextRequest, context: APIContext) => Promise<NextRequest>;
+}
+export interface APIContext {
+    entityName: string;
+    entityConfig: EntityConfig;
+    user?: Record<string, unknown>;
+    action: 'create' | 'read' | 'update' | 'delete';
+    data?: Record<string, unknown>;
+}
+export interface GeneratedAPIResponse {
+    data?: unknown;
+    children?: Record<string, unknown[]>;
+    meta?: {
+        total?: number;
+        page?: number;
+        limit?: number;
+        hasMore?: boolean;
+    };
+    error?: string;
+    validationErrors?: Record<string, string>;
+}
+/**
+ * Generate CRUD API routes for an entity
+ */
+export declare function generateEntityAPI(entityName: string, options?: APIGeneratorOptions): {
+    GET: (request: NextRequest, context?: {
+        params?: {
+            id?: string;
+        };
+    }) => Promise<NextResponse<{
+        error: string;
+    }> | NextResponse<GeneratedAPIResponse>>;
+    POST: (request: NextRequest) => Promise<NextResponse<{
+        error: string;
+    }>>;
+    PATCH: (request: NextRequest, context?: {
+        params?: {
+            id?: string;
+        };
+    }) => Promise<NextResponse<GeneratedAPIResponse> | NextResponse<{
+        error: string;
+    }>>;
+    DELETE: (request: NextRequest, context?: {
+        params?: {
+            id?: string;
+        };
+    }) => Promise<NextResponse<{
+        error: string;
+    }> | NextResponse<{
+        success: boolean;
+    }>>;
+};
+//# sourceMappingURL=api-generator.d.ts.map

package/dist/lib/entities/api-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/api-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAsC,MAAM,SAAS,CAAA;AAM/E,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9C,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CACzE;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB;mBAiCV,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;;;oBAsGnD,WAAW;;;qBA4GX,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;;;sBAmHnD,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;;;;;EAlV3E"}