@almadar/server 2.0.0 → 2.0.2

package/dist/utils/queryFilters.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Query Filter Utilities
+ *
+ * Parses URL query parameters into Firestore-compatible filter objects.
+ * Supports operator encoding in parameter names: field__operator=value
+ *
+ * @example
+ * // URL: /api/tasks?status=active&date__gte=2025-01-01&tags__contains=urgent
+ * const filters = parseQueryFilters(req.query);
+ * // Returns:
+ * // [
+ * //   { field: 'status', operator: '==', value: 'active' },
+ * //   { field: 'date', operator: '>=', value: '2025-01-01' },
+ * //   { field: 'tags', operator: 'array-contains', value: 'urgent' }
+ * // ]
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parsed filter ready for Firestore query
+ */
+export interface ParsedFilter {
+    field: string;
+    operator: FirestoreWhereFilterOp;
+    value: unknown;
+}
+/**
+ * Firestore where filter operators
+ */
+export type FirestoreWhereFilterOp = '==' | '!=' | '>' | '>=' | '<' | '<=' | 'array-contains' | 'array-contains-any' | 'in' | 'not-in';
+/**
+ * Parse query parameters into Firestore-compatible filters.
+ *
+ * Supports operator encoding: field__operator=value
+ *
+ * @param query - Express req.query object
+ * @returns Array of parsed filters ready for Firestore .where() calls
+ *
+ * @example
+ * ```typescript
+ * // In Express route handler:
+ * const filters = parseQueryFilters(req.query);
+ *
+ * let query = db.collection('tasks');
+ * for (const filter of filters) {
+ *   query = query.where(filter.field, filter.operator, filter.value);
+ * }
+ * ```
+ */
+export declare function parseQueryFilters(query: Record<string, unknown>): ParsedFilter[];
+/**
+ * Build a Firestore query with filters applied.
+ *
+ * @param collection - Base Firestore collection reference or query
+ * @param filters - Parsed filters from parseQueryFilters
+ * @returns Query with all filters applied
+ *
+ * @example
+ * ```typescript
+ * const filters = parseQueryFilters(req.query);
+ * const baseQuery = db.collection('tasks');
+ * const filteredQuery = applyFiltersToQuery(baseQuery, filters);
+ * const snapshot = await filteredQuery.get();
+ * ```
+ */
+export declare function applyFiltersToQuery<T>(collection: FirebaseFirestore.Query<T>, filters: ParsedFilter[]): FirebaseFirestore.Query<T>;
+/**
+ * Extract pagination parameters from query
+ */
+export interface PaginationParams {
+    page: number;
+    pageSize: number;
+    sortBy?: string;
+    sortOrder: 'asc' | 'desc';
+}
+export declare function extractPaginationParams(query: Record<string, unknown>, defaults?: Partial<PaginationParams>): PaginationParams;
+//# sourceMappingURL=queryFilters.d.ts.map

package/dist/utils/queryFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryFilters.d.ts","sourceRoot":"","sources":["../../src/utils/queryFilters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,sBAAsB,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,gBAAgB,GAChB,oBAAoB,GACpB,IAAI,GACJ,QAAQ,CAAC;AAsCb;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,YAAY,EAAE,CA0ChB;AAoCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,EACtC,OAAO,EAAE,YAAY,EAAE,GACtB,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAY5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACvC,gBAAgB,CAOlB"}

package/dist/websocket/__tests__/state-sync.test.d.ts

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

package/dist/websocket/__tests__/state-sync.test.d.ts.map

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

package/dist/websocket/state-sync.d.ts

@@ -0,0 +1,39 @@
+/**
+ * State Sync WebSocket Handler
+ *
+ * Provides real-time state synchronization using Socket.IO.
+ *
+ * @packageDocumentation
+ */
+interface Socket {
+    data: {
+        user: {
+            uid: string;
+            roles: string[];
+            orgId?: string;
+        };
+    };
+    handshake: {
+        auth: {
+            token: string;
+            clientId: string;
+        };
+    };
+    join: (room: string) => void;
+    leave: (room: string) => void;
+    on: (event: string, handler: (...args: unknown[]) => void) => void;
+    emit: (event: string, ...args: unknown[]) => void;
+    to: (room: string) => {
+        emit: (event: string, ...args: unknown[]) => void;
+    };
+}
+interface SocketServer {
+    use: (middleware: (socket: Socket, next: (err?: Error) => void) => void) => void;
+    on: (event: string, handler: (socket: Socket) => void) => void;
+}
+/**
+ * Set up state sync WebSocket with Firebase Auth
+ */
+export declare function setupStateSyncWebSocket(io: SocketServer): void;
+export {};
+//# sourceMappingURL=state-sync.d.ts.map

package/dist/websocket/state-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-sync.d.ts","sourceRoot":"","sources":["../../src/websocket/state-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,MAAM;IACd,IAAI,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACjE,SAAS,EAAE;QAAE,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACzD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACnE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAC7E;AAED,UAAU,YAAY;IACpB,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC;IACjF,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAmE9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/server",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Shared server infrastructure for Almadar applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,8 +39,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/agent": ">=2.0.0",
-    "@almadar/core": ">=2.0.0",
+    "@almadar/agent": ">=2.0.1",
+    "@almadar/core": ">=2.1.0",
     "@faker-js/faker": "^9.3.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.0",
@@ -77,7 +77,7 @@
   ],
   "homepage": "https://github.com/almadar-io/almadar#readme",
   "scripts": {
-    "build": "NODE_OPTIONS='--max-old-space-size=4096' tsup",
+    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --rootDir src --skipLibCheck || true",
     "build:watch": "tsup --watch",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",