@almadar/server 2.0.0 → 2.0.2

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

@@ -0,0 +1,17 @@
+/**
+ * Memory Manager Singleton
+ *
+ * Provides Firestore-backed memory management for DeepAgent.
+ *
+ * @packageDocumentation
+ */
+import { MemoryManager } from '@almadar/agent';
+/**
+ * Get or create the MemoryManager singleton
+ */
+export declare function getMemoryManager(): MemoryManager;
+/**
+ * Reset the MemoryManager (useful for testing)
+ */
+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

@@ -0,0 +1,17 @@
+/**
+ * Session Manager Singleton
+ *
+ * Provides Firestore-backed session management with full GAP features.
+ *
+ * @packageDocumentation
+ */
+import { SessionManager } from '@almadar/agent';
+/**
+ * Get or create the SessionManager singleton
+ */
+export declare function getSessionManager(): SessionManager;
+/**
+ * Reset the SessionManager (useful for testing)
+ */
+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

@@ -0,0 +1,22 @@
+/**
+ * Skill Agent Factory
+ *
+ * Creates DeepAgent instances with full GAP feature integration.
+ *
+ * @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;
+    /** App/Project ID for context */
+    appId?: string;
+}
+/**
+ * Create a skill agent with full server-side GAP integration
+ */
+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

@@ -0,0 +1,35 @@
+/**
+ * @almadar/server - Shared server infrastructure for Almadar applications
+ *
+ * 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
+ */
+export { env } from './lib/env.js';
+export { logger } from './lib/logger.js';
+export { EventBus, getServerEventBus, resetServerEventBus, 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, getMockDataService, resetMockDataService, type FieldSchema, type EntitySchema, } from './services/MockDataService.js';
+export { getDataService, resetDataService, 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,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1H,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,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,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"}

package/dist/index.js

@@ -169,12 +169,22 @@ var EventBus = class {
     this.eventLog.length = 0;
   }
 };
-var serverEventBus = new EventBus({
-  debug: process.env.NODE_ENV === "development"
-});
+var _serverEventBus = null;
+function getServerEventBus() {
+  if (!_serverEventBus) {
+    _serverEventBus = new EventBus({
+      debug: process.env.NODE_ENV === "development"
+    });
+  }
+  return _serverEventBus;
+}
+function resetServerEventBus() {
+  _serverEventBus?.clear();
+  _serverEventBus = null;
+}
 function emitEntityEvent(entityType, action, payload) {
   const eventType = `${entityType.toUpperCase()}_${action}`;
-  serverEventBus.emit(eventType, payload, { orbital: entityType });
+  getServerEventBus().emit(eventType, payload, { orbital: entityType });
 }
 
 // src/lib/eventBusTransport.ts
@@ -449,15 +459,15 @@ function debugEventsRouter() {
   }
   router2.get("/event-log", (_req, res) => {
     const limit = parseInt(String(_req.query.limit) || "50", 10);
-    const events = serverEventBus.getRecentEvents(limit);
+    const events = getServerEventBus().getRecentEvents(limit);
     res.json({ count: events.length, events });
   });
   router2.delete("/event-log", (_req, res) => {
-    serverEventBus.clearEventLog();
+    getServerEventBus().clearEventLog();
     res.json({ cleared: true });
   });
   router2.get("/listeners", (_req, res) => {
-    const counts = serverEventBus.getListenerCounts();
+    const counts = getServerEventBus().getListenerCounts();
     const total = Object.values(counts).reduce((sum, n) => sum + n, 0);
     res.json({ total, events: counts });
   });
@@ -550,7 +560,7 @@ function setupEventBroadcast(server, path = "/ws/events") {
         const message = JSON.parse(data.toString());
         logger.debug(`[WebSocket] Received from ${clientId}:`, message);
         if (message.type && message.payload) {
-          serverEventBus.emit(message.type, message.payload, {
+          getServerEventBus().emit(message.type, message.payload, {
             orbital: "client",
             entity: clientId
           });
@@ -566,7 +576,7 @@ function setupEventBroadcast(server, path = "/ws/events") {
       logger.error(`[WebSocket] Client error:`, error);
     });
   });
-  serverEventBus.on("*", (event) => {
+  getServerEventBus().on("*", (event) => {
     if (!wss) return;
     const typedEvent = event;
     const message = JSON.stringify({
@@ -1037,7 +1047,17 @@ var MockDataService = class {
     return store.size;
   }
 };
-var mockDataService = new MockDataService();
+var _mockDataService = null;
+function getMockDataService() {
+  if (!_mockDataService) {
+    _mockDataService = new MockDataService();
+  }
+  return _mockDataService;
+}
+function resetMockDataService() {
+  _mockDataService?.clearAll();
+  _mockDataService = null;
+}
 
 // src/utils/queryFilters.ts
 var OPERATOR_MAP = {
@@ -1174,7 +1194,7 @@ function applyFilterCondition(value, operator, filterValue) {
 }
 var MockDataServiceAdapter = class {
   async list(collection) {
-    return mockDataService.list(collection);
+    return getMockDataService().list(collection);
   }
   async listPaginated(collection, options = {}) {
     const {
@@ -1186,7 +1206,7 @@ var MockDataServiceAdapter = class {
       sortOrder = "asc",
       filters
     } = options;
-    let items = mockDataService.list(collection);
+    let items = getMockDataService().list(collection);
     if (filters && filters.length > 0) {
       items = items.filter((item) => {
         const record = item;
@@ -1226,16 +1246,16 @@ var MockDataServiceAdapter = class {
     return { data, total, page, pageSize, totalPages };
   }
   async getById(collection, id) {
-    return mockDataService.getById(collection, id);
+    return getMockDataService().getById(collection, id);
   }
   async create(collection, data) {
-    return mockDataService.create(collection, data);
+    return getMockDataService().create(collection, data);
   }
   async update(collection, id, data) {
-    return mockDataService.update(collection, id, data);
+    return getMockDataService().update(collection, id, data);
   }
   async delete(collection, id) {
-    return mockDataService.delete(collection, id);
+    return getMockDataService().delete(collection, id);
   }
 };
 var FirebaseDataService = class {
@@ -1354,7 +1374,16 @@ function createDataService() {
   logger.info("[DataService] Using FirebaseDataService");
   return new FirebaseDataService();
 }
-var dataService = createDataService();
+var _dataService = null;
+function getDataService() {
+  if (!_dataService) {
+    _dataService = createDataService();
+  }
+  return _dataService;
+}
+function resetDataService() {
+  _dataService = null;
+}
 function seedMockData(entities) {
   if (!env.USE_MOCK_DATA) {
     logger.info("[DataService] Mock mode disabled, skipping seed");
@@ -1362,7 +1391,7 @@ function seedMockData(entities) {
   }
   logger.info("[DataService] Seeding mock data...");
   for (const entity of entities) {
-    mockDataService.seed(entity.name, entity.fields, entity.seedCount);
+    getMockDataService().seed(entity.name, entity.fields, entity.seedCount);
   }
   logger.info("[DataService] Mock data seeding complete");
 }
@@ -2265,6 +2294,6 @@ router.get("/active-sessions", async (req, res) => {
 });
 var observability_default = router;
 
-export { AppError, ChangeSetStore, ConflictError, DistributedEventBus, EventBus, EventPersistence, ForbiddenError, InMemoryEventStore, InMemoryServiceRegistry, InMemoryTransport, MockDataService, NotFoundError, RedisTransport, SchemaProtectionService, SchemaStore, ServiceDiscovery, SnapshotStore, UnauthorizedError, ValidationError, ValidationStore, applyFiltersToQuery, asyncHandler, authenticateFirebase, closeWebSocketServer, createServerSkillAgent, dataService, db, debugEventsRouter, emitEntityEvent, env, errorHandler, extractPaginationParams, fromFirestoreFormat, getMemoryManager as getAgentMemoryManager, getSessionManager as getAgentSessionManager, getAuth, getConnectedClientCount, getFirestore, getMemoryManager, getSessionManager, getWebSocketServer, initializeFirebase, logger, mockDataService, multiUserMiddleware, notFoundHandler, observability_default as observabilityRouter, parseQueryFilters, resetMemoryManager, resetSessionManager, seedMockData, serverEventBus, setupEventBroadcast, setupStateSyncWebSocket, toFirestoreFormat, validateBody, validateParams, validateQuery, verifyFirebaseAuth };
+export { AppError, ChangeSetStore, ConflictError, DistributedEventBus, EventBus, EventPersistence, ForbiddenError, InMemoryEventStore, InMemoryServiceRegistry, InMemoryTransport, MockDataService, NotFoundError, RedisTransport, SchemaProtectionService, SchemaStore, ServiceDiscovery, SnapshotStore, UnauthorizedError, ValidationError, ValidationStore, applyFiltersToQuery, asyncHandler, authenticateFirebase, closeWebSocketServer, createServerSkillAgent, db, debugEventsRouter, emitEntityEvent, env, errorHandler, extractPaginationParams, fromFirestoreFormat, getMemoryManager as getAgentMemoryManager, getSessionManager as getAgentSessionManager, getAuth, getConnectedClientCount, getDataService, getFirestore, getMemoryManager, getMockDataService, getServerEventBus, getSessionManager, getWebSocketServer, initializeFirebase, logger, multiUserMiddleware, notFoundHandler, observability_default as observabilityRouter, parseQueryFilters, resetDataService, resetMemoryManager, resetMockDataService, resetServerEventBus, resetSessionManager, seedMockData, setupEventBroadcast, setupStateSyncWebSocket, toFirestoreFormat, validateBody, validateParams, validateQuery, verifyFirebaseAuth };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map