@almadar/server 1.4.5 → 2.0.1

package/dist/stores/ValidationStore.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ValidationStore - Firestore CRUD for validation results
+ *
+ * Validation results stored at: users/{uid}/apps/{appId}/validation/current
+ */
+import type { ValidationResults } from '@almadar/core';
+export declare class ValidationStore {
+    private appsCollection;
+    constructor(appsCollection?: string);
+    private getDocPath;
+    private getAppDocPath;
+    /** Save validation results */
+    save(uid: string, appId: string, results: ValidationResults): Promise<void>;
+    /** Get validation results */
+    get(uid: string, appId: string): Promise<ValidationResults | null>;
+    /** Clear validation results */
+    clear(uid: string, appId: string): Promise<void>;
+}
+//# sourceMappingURL=ValidationStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationStore.d.ts","sourceRoot":"","sources":["../../src/stores/ValidationStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,eAAe,CAAC;AAMvE,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,SAAS;IAInC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAIrB,8BAA8B;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjF,6BAA6B;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAYxE,+BAA+B;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUvD"}

package/dist/stores/firestoreFormat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Firestore Serialization Utilities
+ *
+ * Handles the Firestore 20-level depth limit by serializing deeply nested
+ * OrbitalSchema fields (orbitals, traits, services) to JSON strings.
+ */
+import type { OrbitalSchema } from '@almadar/core';
+/**
+ * Convert OrbitalSchema to Firestore-safe format.
+ *
+ * Serializes orbitals, traits, and services to JSON strings to avoid
+ * Firestore's 20-level nesting limit.
+ */
+export declare function toFirestoreFormat(schema: OrbitalSchema): Record<string, unknown>;
+/**
+ * Convert Firestore document back to OrbitalSchema.
+ *
+ * Deserializes JSON strings back to arrays.
+ */
+export declare function fromFirestoreFormat(data: Record<string, unknown>): OrbitalSchema;
+//# sourceMappingURL=firestoreFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestoreFormat.d.ts","sourceRoot":"","sources":["../../src/stores/firestoreFormat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BhF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAsChF"}

package/dist/stores/index.d.ts

@@ -1,167 +1,14 @@
-import { OrbitalSchema, SnapshotDocument, SaveOptions, SaveResult, AppSummary, StatsView, ChangeSetDocument, ValidationResults, CategorizedRemovals, PageContentReduction } from '@almadar/core';
-
 /**
- * Firestore Serialization Utilities
+ * Stores barrel export
  *
- * Handles the Firestore 20-level depth limit by serializing deeply nested
- * OrbitalSchema fields (orbitals, traits, services) to JSON strings.
- */
-
-/**
- * Convert OrbitalSchema to Firestore-safe format.
- *
- * Serializes orbitals, traits, and services to JSON strings to avoid
- * Firestore's 20-level nesting limit.
- */
-declare function toFirestoreFormat(schema: OrbitalSchema): Record<string, unknown>;
-/**
- * Convert Firestore document back to OrbitalSchema.
- *
- * Deserializes JSON strings back to arrays.
- */
-declare function fromFirestoreFormat(data: Record<string, unknown>): OrbitalSchema;
-
-/**
- * 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}
- */
-
-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;
-}
-
-/**
- * SchemaStore - Firestore CRUD for OrbitalSchema documents
- *
- * Handles schema get/save/create/delete/list with caching
- * and Firestore serialization.
- */
-
-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;
-}
-
-/**
- * ChangeSetStore - Firestore CRUD for schema changesets
- *
- * Changesets track changes made to the schema over time,
- * stored in subcollection: users/{uid}/apps/{appId}/changesets/{changeSetId}
- */
-
-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>;
-}
-
-/**
- * ValidationStore - Firestore CRUD for validation results
- *
- * Validation results stored at: users/{uid}/apps/{appId}/validation/current
- */
-
-declare class ValidationStore {
-    private appsCollection;
-    constructor(appsCollection?: string);
-    private getDocPath;
-    private getAppDocPath;
-    /** Save validation results */
-    save(uid: string, appId: string, results: ValidationResults): Promise<void>;
-    /** Get validation results */
-    get(uid: string, appId: string): Promise<ValidationResults | null>;
-    /** Clear validation results */
-    clear(uid: string, appId: string): Promise<void>;
-}
-
-/**
- * SchemaProtectionService - Detects destructive schema changes
+ * Firestore-backed stores for OrbitalSchema, snapshots, changesets, and validation.
  *
- * Uses real diff functions from @almadar/core to detect and categorize
- * removals, page content reductions, and other destructive changes.
+ * @packageDocumentation
  */
-
-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;
-}
-
-export { ChangeSetStore, SchemaProtectionService, SchemaStore, SnapshotStore, ValidationStore, fromFirestoreFormat, toFirestoreFormat };
+export { toFirestoreFormat, fromFirestoreFormat } from './firestoreFormat.js';
+export { SchemaStore } from './SchemaStore.js';
+export { SnapshotStore } from './SnapshotStore.js';
+export { ChangeSetStore } from './ChangeSetStore.js';
+export { ValidationStore } from './ValidationStore.js';
+export { SchemaProtectionService } from './SchemaProtectionService.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/utils/index.d.ts

@@ -1,78 +1,9 @@
 /**
- * Query Filter Utilities
+ * Server 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' }
- * // ]
+ * Reusable utility functions for Express routes and handlers.
  *
  * @packageDocumentation
  */
-/**
- * Parsed filter ready for Firestore query
- */
-interface ParsedFilter {
-    field: string;
-    operator: FirestoreWhereFilterOp;
-    value: unknown;
-}
-/**
- * Firestore where filter operators
- */
-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);
- * }
- * ```
- */
-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();
- * ```
- */
-declare function applyFiltersToQuery<T>(collection: FirebaseFirestore.Query<T>, filters: ParsedFilter[]): FirebaseFirestore.Query<T>;
-/**
- * Extract pagination parameters from query
- */
-interface PaginationParams {
-    page: number;
-    pageSize: number;
-    sortBy?: string;
-    sortOrder: 'asc' | 'desc';
-}
-declare function extractPaginationParams(query: Record<string, unknown>, defaults?: Partial<PaginationParams>): PaginationParams;
-
-export { type FirestoreWhereFilterOp, type PaginationParams, type ParsedFilter, applyFiltersToQuery, extractPaginationParams, parseQueryFilters };
+export * from './queryFilters.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC"}

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

@@ -34,6 +34,6 @@ interface SocketServer {
 /**
  * Set up state sync WebSocket with Firebase Auth
  */
-declare function setupStateSyncWebSocket(io: SocketServer): void;
-
-export { setupStateSyncWebSocket };
+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": "1.4.5",
+  "version": "2.0.1",
   "description": "Shared server infrastructure for Almadar applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,23 +39,18 @@
     "access": "public"
   },
   "dependencies": {
+    "@almadar/agent": ">=2.0.1",
+    "@almadar/core": ">=2.0.0",
     "@faker-js/faker": "^9.3.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.0",
+    "firebase-admin": "^12.0.0",
     "helmet": "^8.0.0",
     "ws": "^8.18.0",
-    "zod": "^3.24.0",
-    "@almadar/agent": "1.6.4",
-    "@almadar/core": "1.0.18"
+    "zod": "^3.24.0"
   },
   "peerDependencies": {
-    "express": "^4.0.0",
-    "firebase-admin": "^12.0.0"
-  },
-  "peerDependenciesMeta": {
-    "firebase-admin": {
-      "optional": true
-    }
+    "express": "^4.0.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
@@ -71,7 +66,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/almadar-io/almadar.git",
-    "directory": "packages/almadar-server"
+    "directory": "docs/packages/server"
   },
   "license": "MIT",
   "keywords": [
@@ -80,8 +75,9 @@
     "express",
     "middleware"
   ],
+  "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",

package/dist/index-B64ll_cY.d.ts

@@ -1,149 +0,0 @@
-import admin from 'firebase-admin';
-import { WebSocketServer } from 'ws';
-import { Server } from 'http';
-
-declare const env: {
-    NODE_ENV: "development" | "production" | "test";
-    PORT: number;
-    CORS_ORIGIN: string | string[];
-    API_PREFIX: string;
-    USE_MOCK_DATA: boolean;
-    DATABASE_URL?: string | undefined;
-    FIREBASE_PROJECT_ID?: string | undefined;
-    FIREBASE_CLIENT_EMAIL?: string | undefined;
-    FIREBASE_PRIVATE_KEY?: string | undefined;
-    FIREBASE_SERVICE_ACCOUNT_PATH?: string | undefined;
-    FIRESTORE_EMULATOR_HOST?: string | undefined;
-    FIREBASE_AUTH_EMULATOR_HOST?: string | undefined;
-    MOCK_SEED?: number | undefined;
-};
-
-declare const logger: {
-    debug: (message: string, meta?: unknown) => void;
-    info: (message: string, meta?: unknown) => void;
-    warn: (message: string, meta?: unknown) => void;
-    error: (message: string, meta?: unknown) => void;
-};
-
-/**
- * Server EventBus - Singleton for server-side cross-trait communication
- *
- * This EventBus enables:
- * - Server-side trait event emission after CRUD operations
- * - Server-side trait listeners responding to events
- * - Cross-client event broadcast via WebSocket
- *
- * @packageDocumentation
- */
-type EventHandler = (payload: unknown, meta?: Record<string, unknown>) => void;
-interface EventLogEntry {
-    event: string;
-    payload: unknown;
-    timestamp: number;
-    listenerCount: number;
-    wildcardListenerCount: number;
-}
-/**
- * Simple EventBus implementation for server-side events
- */
-declare class EventBus {
-    private handlers;
-    private debug;
-    private eventLog;
-    constructor(options?: {
-        debug?: boolean;
-    });
-    on(event: string, handler: EventHandler): () => void;
-    off(event: string, handler: EventHandler): void;
-    emit(event: string, payload?: unknown, meta?: Record<string, unknown>): void;
-    getRecentEvents(limit?: number): EventLogEntry[];
-    clearEventLog(): void;
-    getListenerCounts(): Record<string, number>;
-    clear(): void;
-}
-/**
- * Singleton EventBus instance for server-side event communication.
- */
-declare const serverEventBus: EventBus;
-/**
- * Type-safe event emission helper
- */
-declare function emitEntityEvent(entityType: string, action: 'CREATED' | 'UPDATED' | 'DELETED', payload: Record<string, unknown>): void;
-
-/**
- * Database Accessors & Initialization
- *
- * This module provides:
- * - `initializeFirebase()` — convenience function to init Firebase from env vars
- * - `getFirestore()`, `getAuth()` — accessors for Firebase services
- * - `db` — lazy Firestore proxy (no eager initialization)
- *
- * The consuming application MUST call `initializeFirebase()` or
- * `admin.initializeApp()` before using any Firebase-dependent features.
- */
-
-/**
- * Initialize Firebase Admin SDK from environment variables.
- *
- * Reads: FIREBASE_PROJECT_ID, FIREBASE_CLIENT_EMAIL, FIREBASE_PRIVATE_KEY,
- *        FIREBASE_SERVICE_ACCOUNT_PATH, FIRESTORE_EMULATOR_HOST
- *
- * Safe to call multiple times — returns existing app if already initialized.
- */
-declare function initializeFirebase(): admin.app.App;
-/**
- * Get Firestore instance from the pre-initialized Firebase app.
- */
-declare function getFirestore(): admin.firestore.Firestore;
-/**
- * Get Firebase Auth instance from the pre-initialized Firebase app.
- */
-declare function getAuth(): admin.auth.Auth;
-
-/**
- * Lazy Firestore proxy — resolves on first property access, not at import time.
- * This prevents the "Firebase not initialized" error during module loading.
- */
-declare const db: admin.firestore.Firestore;
-
-/**
- * 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
- */
-
-/**
- * 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);
- * ```
- */
-declare function setupEventBroadcast(server: Server, path?: string): WebSocketServer;
-/**
- * Get the WebSocket server instance (for testing or advanced usage)
- */
-declare function getWebSocketServer(): WebSocketServer | null;
-/**
- * Close the WebSocket server
- */
-declare function closeWebSocketServer(): Promise<void>;
-/**
- * Get connected client count
- */
-declare function getConnectedClientCount(): number;
-
-export { EventBus as E, type EventLogEntry as a, env as b, closeWebSocketServer as c, db as d, emitEntityEvent as e, getConnectedClientCount as f, getAuth as g, getFirestore as h, getWebSocketServer as i, initializeFirebase as j, setupEventBroadcast as k, logger as l, serverEventBus as s };

package/dist/routes/observability.d.ts

@@ -1,12 +0,0 @@
-import * as express_serve_static_core from 'express-serve-static-core';
-
-/**
- * Observability Routes
- *
- * Provides endpoints for metrics, health checks, and telemetry.
- *
- * @packageDocumentation
- */
-declare const router: express_serve_static_core.Router;
-
-export { router as default };