@almadar/server 1.4.5 → 2.0.1

package/dist/lib/websocket.d.ts

@@ -0,0 +1,41 @@
+/**
+ * WebSocket Event Broadcast - Cross-client event synchronization
+ *
+ * Broadcasts server-side events to all connected clients via WebSocket.
+ * This enables real-time updates across multiple browser clients.
+ *
+ * @packageDocumentation
+ */
+import { WebSocketServer } from 'ws';
+import type { Server } from 'http';
+/**
+ * Setup WebSocket server for event broadcasting.
+ *
+ * Listens to all server events via wildcard and broadcasts to connected clients.
+ *
+ * @param server - HTTP server to attach WebSocket to
+ * @param path - WebSocket endpoint path (default: '/ws/events')
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from 'http';
+ * import { setupEventBroadcast } from '@/lib/websocket';
+ *
+ * const server = createServer(app);
+ * setupEventBroadcast(server);
+ * ```
+ */
+export declare function setupEventBroadcast(server: Server, path?: string): WebSocketServer;
+/**
+ * Get the WebSocket server instance (for testing or advanced usage)
+ */
+export declare function getWebSocketServer(): WebSocketServer | null;
+/**
+ * Close the WebSocket server
+ */
+export declare function closeWebSocketServer(): Promise<void>;
+/**
+ * Get connected client count
+ */
+export declare function getConnectedClientCount(): number;
+//# sourceMappingURL=websocket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/lib/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAA2B,MAAM,IAAI,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;AAmBpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqB,GAAG,eAAe,CA8EhG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBpD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD"}

package/dist/middleware/__tests__/multi-user.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Unit tests for multi-user middleware
+ * @module @almadar/server/middleware/multi-user.test
+ */
+export {};
+//# sourceMappingURL=multi-user.test.d.ts.map

package/dist/middleware/__tests__/multi-user.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-user.test.d.ts","sourceRoot":"","sources":["../../../src/middleware/__tests__/multi-user.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/middleware/authenticateFirebase.d.ts

@@ -0,0 +1,4 @@
+import { NextFunction, Request, Response } from 'express';
+export declare function authenticateFirebase(req: Request, res: Response, next: NextFunction): Promise<void | Response<any, Record<string, any>>>;
+export default authenticateFirebase;
+//# sourceMappingURL=authenticateFirebase.d.ts.map

package/dist/middleware/authenticateFirebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticateFirebase.d.ts","sourceRoot":"","sources":["../../src/middleware/authenticateFirebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAwB1D,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,sDA0BzF;AAED,eAAe,oBAAoB,CAAC"}

package/dist/middleware/errorHandler.d.ts

@@ -0,0 +1,53 @@
+import { Request, Response, NextFunction } from 'express';
+/**
+ * Base application error class
+ */
+export declare class AppError extends Error {
+    statusCode: number;
+    message: string;
+    code?: string | undefined;
+    constructor(statusCode: number, message: string, code?: string | undefined);
+}
+/**
+ * 404 Not Found error
+ */
+export declare class NotFoundError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 400 Bad Request / Validation error
+ */
+export declare class ValidationError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 401 Unauthorized error
+ */
+export declare class UnauthorizedError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 403 Forbidden error
+ */
+export declare class ForbiddenError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 409 Conflict error
+ */
+export declare class ConflictError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * Global error handler middleware
+ */
+export declare const errorHandler: (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
+/**
+ * Async handler wrapper to catch errors in async route handlers
+ */
+export declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>) => (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * 404 handler for unmatched routes
+ */
+export declare const notFoundHandler: (req: Request, res: Response) => void;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/middleware/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/middleware/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,MAAM;IACf,IAAI,CAAC,EAAE,MAAM;gBAFb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,GAAE,MAA6B;CAGnD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,GAAE,MAA4B;CAGlD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,GAAE,MAAuB;CAG7C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAAoB;CAG1C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,GAAE,MAA4B;CAGlD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,KAAK,EACV,MAAM,OAAO,EACb,KAAK,QAAQ,EACb,OAAO,YAAY,KAClB,IA2CF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACtB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,MACzE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,SAE/C,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,IAM7D,CAAC"}

package/dist/middleware/index.d.ts

@@ -1,71 +1,4 @@
-import { Request, Response, NextFunction } from 'express';
-import { AnyZodObject } from 'zod';
-
-/**
- * Base application error class
- */
-declare class AppError extends Error {
-    statusCode: number;
-    message: string;
-    code?: string | undefined;
-    constructor(statusCode: number, message: string, code?: string | undefined);
-}
-/**
- * 404 Not Found error
- */
-declare class NotFoundError extends AppError {
-    constructor(message?: string);
-}
-/**
- * 400 Bad Request / Validation error
- */
-declare class ValidationError extends AppError {
-    constructor(message?: string);
-}
-/**
- * 401 Unauthorized error
- */
-declare class UnauthorizedError extends AppError {
-    constructor(message?: string);
-}
-/**
- * 403 Forbidden error
- */
-declare class ForbiddenError extends AppError {
-    constructor(message?: string);
-}
-/**
- * 409 Conflict error
- */
-declare class ConflictError extends AppError {
-    constructor(message?: string);
-}
-/**
- * Global error handler middleware
- */
-declare const errorHandler: (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
-/**
- * Async handler wrapper to catch errors in async route handlers
- */
-declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>) => (req: Request, res: Response, next: NextFunction) => void;
-/**
- * 404 handler for unmatched routes
- */
-declare const notFoundHandler: (req: Request, res: Response) => void;
-
-/**
- * Middleware to validate request body against a Zod schema
- */
-declare const validateBody: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
-/**
- * Middleware to validate request query parameters against a Zod schema
- */
-declare const validateQuery: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
-/**
- * Middleware to validate request params against a Zod schema
- */
-declare const validateParams: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
-
-declare function authenticateFirebase(req: Request, res: Response, next: NextFunction): Promise<void | Response<any, Record<string, any>>>;
-
-export { AppError, ConflictError, ForbiddenError, NotFoundError, UnauthorizedError, ValidationError, asyncHandler, authenticateFirebase, errorHandler, notFoundHandler, validateBody, validateParams, validateQuery };
+export { errorHandler, notFoundHandler, asyncHandler, AppError, NotFoundError, ValidationError, UnauthorizedError, ForbiddenError, ConflictError, } from './errorHandler';
+export { validateBody, validateQuery, validateParams } from './validation';
+export { authenticateFirebase } from './authenticateFirebase.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/middleware/multi-user.d.ts

@@ -1,5 +1,3 @@
-import { Request, Response, NextFunction } from 'express';
-
 /**
  * Multi-User Middleware
  *
@@ -7,7 +5,7 @@ import { Request, Response, NextFunction } from 'express';
  *
  * @packageDocumentation
  */
-
+import type { Request, Response, NextFunction } from 'express';
 declare global {
     namespace Express {
         interface Request {
@@ -28,10 +26,9 @@ declare global {
 /**
  * Middleware to set up user context from Firebase Auth
  */
-declare function multiUserMiddleware(req: Request, res: Response, next: NextFunction): Promise<void>;
+export declare function multiUserMiddleware(req: Request, res: Response, next: NextFunction): Promise<void>;
 /**
  * Verify Firebase Auth token from Authorization header
  */
-declare function verifyFirebaseAuth(req: Request, res: Response, next: NextFunction): Promise<void>;
-
-export { multiUserMiddleware, verifyFirebaseAuth };
+export declare function verifyFirebaseAuth(req: Request, res: Response, next: NextFunction): Promise<void>;
+//# sourceMappingURL=multi-user.d.ts.map

package/dist/middleware/multi-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-user.d.ts","sourceRoot":"","sources":["../../src/middleware/multi-user.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO,CAAC;QAChB,UAAU,OAAO;YACf,IAAI,CAAC,EAAE;gBACL,GAAG,EAAE,MAAM,CAAC;gBACZ,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;YACF,WAAW,CAAC,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC;gBACf,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;aAClB,CAAC;SACH;KACF;CACF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/middleware/validation.d.ts

@@ -0,0 +1,15 @@
+import { Request, Response, NextFunction } from 'express';
+import { AnyZodObject } from 'zod';
+/**
+ * Middleware to validate request body against a Zod schema
+ */
+export declare const validateBody: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Middleware to validate request query parameters against a Zod schema
+ */
+export declare const validateQuery: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Middleware to validate request params against a Zod schema
+ */
+export declare const validateParams: (schema: AnyZodObject) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/middleware/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/middleware/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAY,MAAM,KAAK,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,YAAY,GACtB,QAAQ,YAAY,MAAY,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,OAAO,CAAC,IAAI,CAmB9F,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,aAAa,GACvB,QAAQ,YAAY,MAAY,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,OAAO,CAAC,IAAI,CAmB9F,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,GACxB,QAAQ,YAAY,MAAY,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,OAAO,CAAC,IAAI,CAmB9F,CAAC"}

package/dist/routes/__tests__/observability.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Unit tests for observability routes
+ * @module @almadar/server/routes/observability.test
+ */
+export {};
+//# sourceMappingURL=observability.test.d.ts.map

package/dist/routes/__tests__/observability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.test.d.ts","sourceRoot":"","sources":["../../../src/routes/__tests__/observability.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/DataService.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DataService - Unified data access abstraction
+ *
+ * Provides a common interface for data operations that can be backed by
+ * either MockDataService (for development) or Firebase (for production).
+ *
+ * @packageDocumentation
+ */
+import { type FieldSchema } from './MockDataService.js';
+import { type ParsedFilter } from '../utils/queryFilters.js';
+interface BaseEntity {
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Pagination options for list queries
+ */
+export interface PaginationOptions {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Search term to filter results */
+    search?: string;
+    /** Fields to search in (defaults to all string fields) */
+    searchFields?: string[];
+    /** Sort field */
+    sortBy?: string;
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+    /** Filters parsed from query params */
+    filters?: ParsedFilter[];
+}
+/**
+ * Paginated response structure
+ */
+export interface PaginatedResult<T> {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+export interface DataService {
+    list<T>(collection: string): Promise<T[]>;
+    listPaginated<T>(collection: string, options?: PaginationOptions): Promise<PaginatedResult<T>>;
+    getById<T>(collection: string, id: string): Promise<T | null>;
+    create<T extends BaseEntity>(collection: string, data: Partial<T>): Promise<T>;
+    update<T extends BaseEntity>(collection: string, id: string, data: Partial<T>): Promise<T | null>;
+    delete(collection: string, id: string): Promise<boolean>;
+}
+/**
+ * Singleton data service instance.
+ * Use this in handlers for all data operations.
+ */
+export declare const dataService: DataService;
+export interface EntitySeedConfig {
+    name: string;
+    fields: FieldSchema[];
+    seedCount: number;
+}
+/**
+ * Seed mock data for multiple entities.
+ * Only works when USE_MOCK_DATA is enabled.
+ */
+export declare function seedMockData(entities: EntitySeedConfig[]): void;
+export {};
+//# sourceMappingURL=DataService.d.ts.map

package/dist/services/DataService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataService.d.ts","sourceRoot":"","sources":["../../src/services/DataService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAMlC,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1C,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AA6SD;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAsB,CAAC;AAM/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAa/D"}

package/dist/{index-D8fohXsO.d.ts → services/MockDataService.d.ts}

@@ -1,5 +1,3 @@
-import { ParsedFilter } from './utils/index.js';
-
 /**
  * MockDataService - In-memory data store with faker-based mock generation
  *
@@ -8,7 +6,7 @@ import { ParsedFilter } from './utils/index.js';
  *
  * @packageDocumentation
  */
-interface FieldSchema {
+export interface FieldSchema {
     name: string;
     type: 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'relation' | 'array';
     required?: boolean;
@@ -18,11 +16,11 @@ interface FieldSchema {
     fakerMethod?: string;
     relatedEntity?: string;
 }
-interface EntitySchema {
+export interface EntitySchema {
     fields: FieldSchema[];
     seedCount?: number;
 }
-interface BaseEntity$1 {
+interface BaseEntity {
     id: string;
     createdAt: Date;
     updatedAt: Date;
@@ -30,7 +28,7 @@ interface BaseEntity$1 {
 /**
  * In-memory mock data store with CRUD operations and faker-based seeding.
  */
-declare class MockDataService {
+export declare class MockDataService {
     private stores;
     private schemas;
     private idCounters;
@@ -84,11 +82,11 @@ declare class MockDataService {
     /**
      * Create a new item.
      */
-    create<T extends BaseEntity$1>(entityName: string, data: Partial<T>): T;
+    create<T extends BaseEntity>(entityName: string, data: Partial<T>): T;
     /**
      * Update an existing item.
      */
-    update<T extends BaseEntity$1>(entityName: string, id: string, data: Partial<T>): T | null;
+    update<T extends BaseEntity>(entityName: string, id: string, data: Partial<T>): T | null;
     /**
      * Delete an item.
      */
@@ -106,73 +104,6 @@ declare class MockDataService {
      */
     count(entityName: string): number;
 }
-declare const mockDataService: MockDataService;
-
-/**
- * DataService - Unified data access abstraction
- *
- * Provides a common interface for data operations that can be backed by
- * either MockDataService (for development) or Firebase (for production).
- *
- * @packageDocumentation
- */
-
-interface BaseEntity {
-    id: string;
-    createdAt: Date;
-    updatedAt: Date;
-}
-/**
- * Pagination options for list queries
- */
-interface PaginationOptions {
-    /** Page number (1-indexed) */
-    page?: number;
-    /** Number of items per page */
-    pageSize?: number;
-    /** Search term to filter results */
-    search?: string;
-    /** Fields to search in (defaults to all string fields) */
-    searchFields?: string[];
-    /** Sort field */
-    sortBy?: string;
-    /** Sort direction */
-    sortOrder?: 'asc' | 'desc';
-    /** Filters parsed from query params */
-    filters?: ParsedFilter[];
-}
-/**
- * Paginated response structure
- */
-interface PaginatedResult<T> {
-    data: T[];
-    total: number;
-    page: number;
-    pageSize: number;
-    totalPages: number;
-}
-interface DataService {
-    list<T>(collection: string): Promise<T[]>;
-    listPaginated<T>(collection: string, options?: PaginationOptions): Promise<PaginatedResult<T>>;
-    getById<T>(collection: string, id: string): Promise<T | null>;
-    create<T extends BaseEntity>(collection: string, data: Partial<T>): Promise<T>;
-    update<T extends BaseEntity>(collection: string, id: string, data: Partial<T>): Promise<T | null>;
-    delete(collection: string, id: string): Promise<boolean>;
-}
-/**
- * Singleton data service instance.
- * Use this in handlers for all data operations.
- */
-declare const dataService: DataService;
-interface EntitySeedConfig {
-    name: string;
-    fields: FieldSchema[];
-    seedCount: number;
-}
-/**
- * Seed mock data for multiple entities.
- * Only works when USE_MOCK_DATA is enabled.
- */
-declare function seedMockData(entities: EntitySeedConfig[]): void;
-
-export { type DataService as D, type EntitySchema as E, type FieldSchema as F, MockDataService as M, type PaginatedResult as P, type EntitySeedConfig as a, type PaginationOptions as b, dataService as d, mockDataService as m, seedMockData as s };
+export declare const mockDataService: MockDataService;
+export {};
+//# sourceMappingURL=MockDataService.d.ts.map

package/dist/services/MockDataService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockDataService.d.ts","sourceRoot":"","sources":["../../src/services/MockDataService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,UAAU,CAAkC;;IAcpD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,IAAI;IAYzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgD1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE;IAKhC;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAMpD;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAgBrE;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;IAmBxF;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAa/C;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAIlC;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/services/index.d.ts

@@ -1,2 +1,8 @@
-export { D as DataService, E as EntitySchema, a as EntitySeedConfig, F as FieldSchema, d as dataService, m as mockDataService, s as seedMockData } from '../index-D8fohXsO.js';
-import '../utils/index.js';
+/**
+ * Services barrel export
+ *
+ * @packageDocumentation
+ */
+export { mockDataService, type FieldSchema, type EntitySchema } from './MockDataService.js';
+export { dataService, seedMockData, type DataService, type EntitySeedConfig } from './DataService.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/stores/ChangeSetStore.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ChangeSetStore - Firestore CRUD for schema changesets
+ *
+ * Changesets track changes made to the schema over time,
+ * stored in subcollection: users/{uid}/apps/{appId}/changesets/{changeSetId}
+ */
+import type { ChangeSetDocument } from '@almadar/core';
+export declare class ChangeSetStore {
+    private appsCollection;
+    constructor(appsCollection?: string);
+    private getCollectionPath;
+    private getAppDocPath;
+    /** Append a changeset to history */
+    append(uid: string, appId: string, changeSet: ChangeSetDocument): Promise<void>;
+    /** Get change history for an app (ordered by version desc) */
+    getHistory(uid: string, appId: string): Promise<ChangeSetDocument[]>;
+    /** Get a specific changeset by ID */
+    get(uid: string, appId: string, changeSetId: string): Promise<ChangeSetDocument | null>;
+    /** Update a changeset's status */
+    updateStatus(uid: string, appId: string, changeSetId: string, status: 'applied' | 'reverted' | 'pending'): Promise<void>;
+    /** Delete a changeset */
+    delete(uid: string, appId: string, changeSetId: string): Promise<boolean>;
+}
+//# sourceMappingURL=ChangeSetStore.d.ts.map

package/dist/stores/ChangeSetStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeSetStore.d.ts","sourceRoot":"","sources":["../../src/stores/ChangeSetStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,eAAe,CAAC;AAKpE,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,SAAS;IAInC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAIrB,oCAAoC;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrF,8DAA8D;IACxD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAe1E,qCAAqC;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAO7F,kCAAkC;IAC5B,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC;IAQhB,yBAAyB;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAyBhF"}

package/dist/stores/SchemaProtectionService.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SchemaProtectionService - Detects destructive schema changes
+ *
+ * Uses real diff functions from @almadar/core to detect and categorize
+ * removals, page content reductions, and other destructive changes.
+ */
+import type { OrbitalSchema, CategorizedRemovals, PageContentReduction } from '@almadar/core';
+export declare class SchemaProtectionService {
+    /**
+     * Compare two schemas and detect destructive changes.
+     *
+     * Returns categorized removals including page content reductions.
+     */
+    compareSchemas(before: OrbitalSchema, after: OrbitalSchema): {
+        isDestructive: boolean;
+        removals: CategorizedRemovals;
+    };
+    /** Check if critical removals require confirmation */
+    requiresConfirmation(removals: CategorizedRemovals): boolean;
+    /** Check for significant page content reductions */
+    hasSignificantContentReduction(reductions: PageContentReduction[]): boolean;
+}
+//# sourceMappingURL=SchemaProtectionService.d.ts.map

package/dist/stores/SchemaProtectionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProtectionService.d.ts","sourceRoot":"","sources":["../../src/stores/SchemaProtectionService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAU9F,qBAAa,uBAAuB;IAClC;;;;OAIG;IACH,cAAc,CACZ,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,GACnB;QACD,aAAa,EAAE,OAAO,CAAC;QACvB,QAAQ,EAAE,mBAAmB,CAAC;KAC/B;IAiBD,sDAAsD;IACtD,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAI5D,oDAAoD;IACpD,8BAA8B,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,OAAO;CAG5E"}

package/dist/stores/SchemaStore.d.ts

@@ -0,0 +1,52 @@
+/**
+ * SchemaStore - Firestore CRUD for OrbitalSchema documents
+ *
+ * Handles schema get/save/create/delete/list with caching
+ * and Firestore serialization.
+ */
+import type { OrbitalSchema, StatsView, AppSummary, SaveOptions, SaveResult } from '@almadar/core';
+import type { SnapshotStore } from './SnapshotStore.js';
+export declare class SchemaStore {
+    private appsCollection;
+    private schemaCache;
+    private listCache;
+    private protectionService;
+    private snapshotStore;
+    constructor(appsCollection?: string);
+    /** Set snapshot store for auto-snapshot on destructive saves */
+    setSnapshotStore(store: SnapshotStore): void;
+    /** Get a schema by app ID */
+    get(uid: string, appId: string): Promise<OrbitalSchema | null>;
+    /**
+     * Save a schema (create or full replace).
+     *
+     * Features:
+     * - Detects destructive changes (removals)
+     * - Requires confirmation for critical removals
+     * - Auto-creates snapshots before destructive changes (if SnapshotStore attached)
+     */
+    save(uid: string, appId: string, schema: OrbitalSchema, options?: SaveOptions): Promise<SaveResult>;
+    /** Create a new app with initial schema */
+    create(uid: string, metadata: {
+        name: string;
+        description?: string;
+    }): Promise<{
+        appId: string;
+        schema: OrbitalSchema;
+    }>;
+    /** Delete an app */
+    delete(uid: string, appId: string): Promise<boolean>;
+    /** List all apps for a user */
+    list(uid: string): Promise<AppSummary[]>;
+    /** Compute stats from OrbitalSchema */
+    computeStats(schema: OrbitalSchema): StatsView;
+    /** Invalidate caches for a specific app */
+    invalidateCache(uid: string, appId: string): void;
+    /** Clear all caches */
+    clearCaches(): void;
+    /** Get the collection path for an app */
+    getAppDocPath(uid: string, appId: string): string;
+    /** Expose apps collection name for subcollection stores */
+    getAppsCollection(): string;
+}
+//# sourceMappingURL=SchemaStore.d.ts.map

package/dist/stores/SchemaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaStore.d.ts","sourceRoot":"","sources":["../../src/stores/SchemaStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAInG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAmE;IACtF,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,aAAa,CAA8B;gBAEvC,cAAc,SAAS;IAInC,gEAAgE;IAChE,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAI5C,6BAA6B;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA0BpE;;;;;;;OAOG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IA0EtB,2CAA2C;IACrC,MAAM,CACV,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC;IAuBpD,oBAAoB;IACd,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB1D,+BAA+B;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuC9C,uCAAuC;IACvC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS;IAqB9C,2CAA2C;IAC3C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjD,uBAAuB;IACvB,WAAW,IAAI,IAAI;IAKnB,yCAAyC;IACzC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAIjD,2DAA2D;IAC3D,iBAAiB,IAAI,MAAM;CAG5B"}

package/dist/stores/SnapshotStore.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SnapshotStore - Firestore CRUD for schema snapshots
+ *
+ * Snapshots are full copies of the schema at a point in time,
+ * stored in subcollection: users/{uid}/apps/{appId}/snapshots/{snapshotId}
+ */
+import type { OrbitalSchema, SnapshotDocument } from '@almadar/core';
+export declare class SnapshotStore {
+    private appsCollection;
+    constructor(appsCollection?: string);
+    private getCollectionPath;
+    private getAppDocPath;
+    /** Create a snapshot of the current schema */
+    create(uid: string, appId: string, schema: OrbitalSchema, reason: string): Promise<string>;
+    /** Get all snapshots for an app (ordered by timestamp desc) */
+    getAll(uid: string, appId: string): Promise<SnapshotDocument[]>;
+    /** Get a specific snapshot by ID */
+    get(uid: string, appId: string, snapshotId: string): Promise<SnapshotDocument | null>;
+    /** Delete a snapshot */
+    delete(uid: string, appId: string, snapshotId: string): Promise<boolean>;
+    /** Get schema snapshot at a specific version */
+    getByVersion(uid: string, appId: string, version: number): Promise<OrbitalSchema | null>;
+    /** Get the schema from a snapshot (deserialized) */
+    getSchemaFromSnapshot(snapshot: SnapshotDocument): OrbitalSchema;
+}
+//# sourceMappingURL=SnapshotStore.d.ts.map

package/dist/stores/SnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotStore.d.ts","sourceRoot":"","sources":["../../src/stores/SnapshotStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAe,MAAM,eAAe,CAAC;AAMlF,qBAAa,aAAa;IACxB,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,SAAS;IAInC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAIrB,8CAA8C;IACxC,MAAM,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IA6BlB,+DAA+D;IACzD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAUrE,oCAAoC;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAO3F,wBAAwB;IAClB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B9E,gDAAgD;IAC1C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAa9F,oDAAoD;IACpD,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa;CAGjE"}