@almadar/server 1.4.5 → 2.0.1

package/LICENSE

@@ -1,72 +1,21 @@
-Business Source License 1.1
-
-Parameters
-
-Licensor:             Almadar FZE
-Licensed Work:        KFlow Builder / Almadar
-                      The Licensed Work is (c) 2025-2026 Almadar FZE.
-Additional Use Grant: You may make production use of the Licensed Work for
-                      non-commercial purposes and for internal evaluation.
-                      Production use for commercial purposes requires a
-                      commercial license from the Licensor.
-Change Date:          2030-02-01
-Change License:       Apache License, Version 2.0
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.
-
----
-
-License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
-"Business Source License" is a trademark of MariaDB Corporation Ab.
-
-ADDITIONAL TERMS:
-
-Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
-
-TRADEMARKS:
-
-"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
-Almadar FZE. You may not use these trademarks without prior written
-permission from Almadar FZE.
-
-For licensing inquiries: licensing@almadar.io
+MIT License
+
+Copyright (c) 2026 Almadar Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @almadar/server
+
+> Shared server infrastructure for Almadar applications
+
+Part of the [Almadar](https://github.com/almadar-io/almadar) platform.
+
+## Installation
+
+```bash
+npm install @almadar/server
+```
+
+## Usage
+
+```typescript
+import { /* ... */ } from '@almadar/server';
+```
+
+## API
+
+<!-- Document public exports here -->
+
+## License
+
+MIT

package/dist/deepagent/__tests__/memory.test.d.ts

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

package/dist/deepagent/__tests__/memory.test.d.ts.map

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

package/dist/deepagent/__tests__/session.test.d.ts

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

package/dist/deepagent/__tests__/session.test.d.ts.map

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

package/dist/deepagent/__tests__/skill-agent.test.d.ts

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

package/dist/deepagent/__tests__/skill-agent.test.d.ts.map

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

package/dist/deepagent/memory.d.ts

@@ -1,5 +1,3 @@
-import { MemoryManager } from '@almadar/agent';
-
 /**
  * Memory Manager Singleton
  *
@@ -7,14 +5,13 @@ import { MemoryManager } from '@almadar/agent';
  *
  * @packageDocumentation
  */
-
+import { MemoryManager } from '@almadar/agent';
 /**
  * Get or create the MemoryManager singleton
  */
-declare function getMemoryManager(): MemoryManager;
+export declare function getMemoryManager(): MemoryManager;
 /**
  * Reset the MemoryManager (useful for testing)
  */
-declare function resetMemoryManager(): void;
-
-export { getMemoryManager, resetMemoryManager };
+export declare function resetMemoryManager(): void;
+//# sourceMappingURL=memory.d.ts.map

package/dist/deepagent/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/deepagent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAehD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/deepagent/session.d.ts

@@ -1,5 +1,3 @@
-import { SessionManager } from '@almadar/agent';
-
 /**
  * Session Manager Singleton
  *
@@ -7,14 +5,13 @@ import { SessionManager } from '@almadar/agent';
  *
  * @packageDocumentation
  */
-
+import { SessionManager } from '@almadar/agent';
 /**
  * Get or create the SessionManager singleton
  */
-declare function getSessionManager(): SessionManager;
+export declare function getSessionManager(): SessionManager;
 /**
  * Reset the SessionManager (useful for testing)
  */
-declare function resetSessionManager(): void;
-
-export { getSessionManager, resetSessionManager };
+export declare function resetSessionManager(): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/deepagent/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/deepagent/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAchD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAclD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/deepagent/skill-agent.d.ts

@@ -1,7 +1,3 @@
-import { SkillAgentOptions, SkillAgentResult } from '@almadar/agent';
-export { getMemoryManager } from './memory.js';
-export { getSessionManager } from './session.js';
-
 /**
  * Skill Agent Factory
  *
@@ -9,7 +5,9 @@ export { getSessionManager } from './session.js';
  *
  * @packageDocumentation
  */
-
+import { type SkillAgentOptions, type SkillAgentResult } from '@almadar/agent';
+import { getMemoryManager } from './memory.js';
+import { getSessionManager } from './session.js';
 interface ServerSkillAgentOptions extends SkillAgentOptions {
     /** User ID from Firebase Auth */
     userId: string;
@@ -19,6 +17,6 @@ interface ServerSkillAgentOptions extends SkillAgentOptions {
 /**
  * Create a skill agent with full server-side GAP integration
  */
-declare function createServerSkillAgent(options: ServerSkillAgentOptions): Promise<SkillAgentResult>;
-
-export { createServerSkillAgent };
+export declare function createServerSkillAgent(options: ServerSkillAgentOptions): Promise<SkillAgentResult>;
+export { getMemoryManager, getSessionManager };
+//# sourceMappingURL=skill-agent.d.ts.map

package/dist/deepagent/skill-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-agent.d.ts","sourceRoot":"","sources":["../../src/deepagent/skill-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,UAAU,uBAAwB,SAAQ,iBAAiB;IACzD,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAsD3B;AAGD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,41 +1,35 @@
-export { E as EventBus, a as EventLogEntry, c as closeWebSocketServer, d as db, e as emitEntityEvent, b as env, g as getAuth, f as getConnectedClientCount, h as getFirestore, i as getWebSocketServer, j as initializeFirebase, l as logger, s as serverEventBus, k as setupEventBroadcast } from './index-B64ll_cY.js';
-import { Router } from 'express';
-export { AppError, ConflictError, ForbiddenError, NotFoundError, UnauthorizedError, ValidationError, asyncHandler, authenticateFirebase, errorHandler, notFoundHandler, validateBody, validateParams, validateQuery } from './middleware/index.js';
-export { D as DataService, E as EntitySchema, a as EntitySeedConfig, F as FieldSchema, M as MockDataService, P as PaginatedResult, b as PaginationOptions, d as dataService, m as mockDataService, s as seedMockData } from './index-D8fohXsO.js';
-export { ChangeSetStore, SchemaProtectionService, SchemaStore, SnapshotStore, ValidationStore, fromFirestoreFormat, toFirestoreFormat } from './stores/index.js';
-export { FirestoreWhereFilterOp, PaginationParams, ParsedFilter, applyFiltersToQuery, extractPaginationParams, parseQueryFilters } from './utils/index.js';
-export { getMemoryManager as getAgentMemoryManager, getMemoryManager, resetMemoryManager } from './deepagent/memory.js';
-export { getSessionManager as getAgentSessionManager, getSessionManager, resetSessionManager } from './deepagent/session.js';
-export { createServerSkillAgent } from './deepagent/skill-agent.js';
-export { multiUserMiddleware, verifyFirebaseAuth } from './middleware/multi-user.js';
-export { setupStateSyncWebSocket } from './websocket/state-sync.js';
-export { default as observabilityRouter } from './routes/observability.js';
-export { default as admin } from 'firebase-admin';
-import 'ws';
-import 'http';
-import 'zod';
-import '@almadar/core';
-import '@almadar/agent';
-import 'express-serve-static-core';
-
 /**
- * Debug Events Router
+ * @almadar/server - Shared server infrastructure for Almadar applications
  *
- * Provides diagnostic endpoints for inspecting the server EventBus.
- * Only active when NODE_ENV=development.
- *
- * Endpoints:
- *   GET    /event-log   - Recent emitted events with listener counts
- *   DELETE /event-log   - Clear the event log
- *   GET    /listeners   - Registered listener counts per event
+ * This package provides:
+ * - Database utilities (Firebase/Firestore)
+ * - Event bus for cross-trait communication
+ * - Express middleware (auth, error handling, validation)
+ * - Data services (mock and production)
+ * - Query filter utilities
  *
  * @packageDocumentation
  */
-
-/**
- * Creates an Express router with debug endpoints for the server EventBus.
- * Returns a no-op router in production (no routes registered).
- */
-declare function debugEventsRouter(): Router;
-
-export { debugEventsRouter };
+export { env } from './lib/env.js';
+export { logger } from './lib/logger.js';
+export { EventBus, serverEventBus, emitEntityEvent, type EventLogEntry } from './lib/eventBus.js';
+export { DistributedEventBus, InMemoryTransport, RedisTransport, type IEventBusTransport, type TransportMessage, type TransportReceiver, type RedisTransportOptions, } from './lib/eventBusTransport.js';
+export { EventPersistence, InMemoryEventStore, type PersistedEvent, type EventQuery, type EventPersistenceOptions, type IEventStore, } from './lib/eventPersistence.js';
+export { debugEventsRouter } from './lib/debugRouter.js';
+export { initializeFirebase, getFirestore, getAuth, admin, db } from './lib/db.js';
+export { setupEventBroadcast, getWebSocketServer, closeWebSocketServer, getConnectedClientCount, } from './lib/websocket.js';
+export { errorHandler, notFoundHandler, asyncHandler, AppError, NotFoundError, ValidationError, UnauthorizedError, ForbiddenError, ConflictError, } from './middleware/errorHandler.js';
+export { validateBody, validateQuery, validateParams } from './middleware/validation.js';
+export { authenticateFirebase } from './middleware/authenticateFirebase.js';
+export { mockDataService, MockDataService, type FieldSchema, type EntitySchema, } from './services/MockDataService.js';
+export { dataService, seedMockData, type DataService, type EntitySeedConfig, type PaginationOptions, type PaginatedResult, } from './services/DataService.js';
+export { toFirestoreFormat, fromFirestoreFormat, SchemaStore, SnapshotStore, ChangeSetStore, ValidationStore, SchemaProtectionService, } from './stores/index.js';
+export { parseQueryFilters, applyFiltersToQuery, extractPaginationParams, type ParsedFilter, type FirestoreWhereFilterOp, type PaginationParams, } from './utils/queryFilters.js';
+export { getMemoryManager, resetMemoryManager, } from './deepagent/memory.js';
+export { getSessionManager, resetSessionManager, } from './deepagent/session.js';
+export { createServerSkillAgent, getMemoryManager as getAgentMemoryManager, getSessionManager as getAgentSessionManager, } from './deepagent/skill-agent.js';
+export { multiUserMiddleware, verifyFirebaseAuth, } from './middleware/multi-user.js';
+export { setupStateSyncWebSocket } from './websocket/state-sync.js';
+export { ServiceDiscovery, InMemoryServiceRegistry, type ServiceRegistration, type ServiceRegistryOptions, type IServiceRegistry, } from './lib/serviceDiscovery.js';
+export { default as observabilityRouter } from './routes/observability.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAG5E,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,IAAI,qBAAqB,EACzC,iBAAiB,IAAI,sBAAsB,GAC5C,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}