@loom-framework/core 0.1.0-alpha.17 → 0.1.0-alpha.171

package/dist/backend/events/event-emitting-adapter.js

@@ -0,0 +1,70 @@
+/**
+ * EventEmittingAdapter - Decorator that wraps DataAdapter to auto-emit events
+ *
+ * - write() → emits data:create:<model> with { model, id, data }
+ * - update() → emits data:update:<model> with { model, id, data, previousData, changedFields }
+ * - delete() → emits data:delete:<model> with { model, id, previousData }
+ * - hasSubscribers() optimization: skips previousData read when no subscribers
+ * - Events only emitted after inner operation succeeds
+ * - getUserId callback for injecting userId (auth-aware)
+ */
+import { EventPatterns } from '../../types/event.js';
+export class EventEmittingAdapter {
+    inner;
+    eventBus;
+    source;
+    getUserId;
+    name;
+    constructor(inner, eventBus, source, getUserId) {
+        this.inner = inner;
+        this.eventBus = eventBus;
+        this.source = source;
+        this.getUserId = getUserId;
+        this.name = `event-emitting:${inner.name}`;
+    }
+    async write(model, data) {
+        const record = await this.inner.write(model, data);
+        void this.eventBus.emit(EventPatterns.DATA_CREATE(model), { model, id: record.id, data: record }, { userId: this.getUserId?.(), source: this.source });
+        return record;
+    }
+    async update(model, id, data) {
+        const pattern = EventPatterns.DATA_UPDATE(model);
+        const previous = this.eventBus.hasSubscribers(pattern)
+            ? await this.inner.read(model, { id }).catch(() => null)
+            : null;
+        const record = await this.inner.update(model, id, data);
+        const changedFields = previous
+            ? Object.keys(data).filter(k => data[k] !== previous?.[k])
+            : undefined;
+        void this.eventBus.emit(pattern, { model, id, data: record, previousData: previous ?? undefined, changedFields }, { userId: this.getUserId?.(), source: this.source });
+        return record;
+    }
+    async delete(model, id) {
+        const pattern = EventPatterns.DATA_DELETE(model);
+        const previous = this.eventBus.hasSubscribers(pattern)
+            ? await this.inner.read(model, { id }).catch(() => null)
+            : null;
+        await this.inner.delete(model, id);
+        void this.eventBus.emit(pattern, { model, id, previousData: previous ?? undefined }, { userId: this.getUserId?.(), source: this.source });
+    }
+    // ── Pure delegation (no events for read operations) ──
+    async read(model, options) {
+        return this.inner.read(model, options);
+    }
+    async count(model, options) {
+        return this.inner.count(model, options);
+    }
+    async getSchema(model) {
+        return this.inner.getSchema(model);
+    }
+    async listModels() {
+        return this.inner.listModels();
+    }
+    async initialize() {
+        return this.inner.initialize();
+    }
+    async healthCheck() {
+        return this.inner.healthCheck();
+    }
+}
+//# sourceMappingURL=event-emitting-adapter.js.map

package/dist/backend/events/event-emitting-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitting-adapter.js","sourceRoot":"","sources":["../../../src/backend/events/event-emitting-adapter.ts"],"names":[],"mappings":"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"}

package/dist/backend/events/event-registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * EventRegistry - Tracks registered event patterns (P0 internal use only)
+ *
+ * Provides introspection for GET /api/v1/events/patterns (P1 API).
+ * Currently used internally by capability-generator for events.md generation.
+ */
+export declare class EventRegistry {
+    private patterns;
+    register(pattern: string, category: string, description: string, payloadShape: string): void;
+    isRegistered(pattern: string): boolean;
+    getPatterns(): Array<{
+        pattern: string;
+        category: string;
+        description: string;
+        payloadShape: string;
+    }>;
+    getByCategory(category: string): Array<{
+        pattern: string;
+        category: string;
+        description: string;
+        payloadShape: string;
+    }>;
+}
+//# sourceMappingURL=event-registry.d.ts.map

package/dist/backend/events/event-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/events/event-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA2F;IAE3G,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI5F,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItC,WAAW,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAItG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAGzH"}

package/dist/backend/events/event-registry.js

@@ -0,0 +1,22 @@
+/**
+ * EventRegistry - Tracks registered event patterns (P0 internal use only)
+ *
+ * Provides introspection for GET /api/v1/events/patterns (P1 API).
+ * Currently used internally by capability-generator for events.md generation.
+ */
+export class EventRegistry {
+    patterns = new Map();
+    register(pattern, category, description, payloadShape) {
+        this.patterns.set(pattern, { category, description, payloadShape });
+    }
+    isRegistered(pattern) {
+        return this.patterns.has(pattern);
+    }
+    getPatterns() {
+        return Array.from(this.patterns.entries()).map(([pattern, info]) => ({ pattern, ...info }));
+    }
+    getByCategory(category) {
+        return this.getPatterns().filter(p => p.category === category);
+    }
+}
+//# sourceMappingURL=event-registry.js.map

package/dist/backend/events/event-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.js","sourceRoot":"","sources":["../../../src/backend/events/event-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAiF,IAAI,GAAG,EAAE,CAAC;IAE3G,QAAQ,CAAC,OAAe,EAAE,QAAgB,EAAE,WAAmB,EAAE,YAAoB;QACnF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/backend/events/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Events Module - Barrel Export
+ */
+export { EventBus } from './event-bus.js';
+export { EventEmittingAdapter } from './event-emitting-adapter.js';
+export { EventRegistry } from './event-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/backend/events/index.js

@@ -0,0 +1,7 @@
+/**
+ * Events Module - Barrel Export
+ */
+export { EventBus } from './event-bus.js';
+export { EventEmittingAdapter } from './event-emitting-adapter.js';
+export { EventRegistry } from './event-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/backend/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @loom-framework/backend - Main Server
+ *
+ * Assembles Fastify server with:
+ * - HTTP SSE chat route (Ant Design X compatible)
+ * - REST routes for DataAdapter CRUD + health check + sessions
+ * - Static file serving for production mode
+ * - Configuration from loom.config.ts
+ */
+import Fastify from 'fastify';
+import type { LoomConfig, ServerConfig } from '../types/config.js';
+import type { AIEngine } from '../types/ai.js';
+import type { DataAdapter } from '../types/adapter.js';
+import { UserStore } from './auth/user-store.js';
+import { TokenStore } from './auth/token-store.js';
+import { EventBus } from './events/event-bus.js';
+import { EventRegistry } from './events/event-registry.js';
+import { ProcessEngine } from './process/engine.js';
+import { NotificationStorage } from './notifications/notification-storage.js';
+export interface LoomServerOptions {
+    /** Project root directory containing loom.config.ts */
+    projectRoot: string;
+    /** Override server config (merges over config file) */
+    serverConfig?: Partial<ServerConfig>;
+    /** Custom AI engine (defaults to ClaudeCodeEngine from config) */
+    engine?: AIEngine;
+    /** Custom DataAdapter (defaults to FileSystemAdapter from config) */
+    adapter?: DataAdapter;
+    /** Logger level */
+    logLevel?: string;
+}
+export declare class LoomServer {
+    private config;
+    private engine;
+    private adapter;
+    private sessionManager;
+    private interactionLogger;
+    private fastify;
+    private userStore?;
+    private tokenStore?;
+    private eventBus?;
+    private eventRegistry?;
+    private processEngine?;
+    private notificationStorage?;
+    private projectRoot;
+    private options;
+    constructor(options: LoomServerOptions);
+    /**
+     * Initialize server: load config, create engine/adapter, register routes
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start listening
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /** Expose Fastify instance for testing */
+    getFastify(): ReturnType<typeof Fastify>;
+    /** Expose config for testing */
+    getConfig(): LoomConfig;
+    /** Expose adapter for testing */
+    getAdapter(): DataAdapter;
+    /** Expose user store for testing */
+    getUserStore(): UserStore | undefined;
+    /** Expose token store for testing */
+    getTokenStore(): TokenStore | undefined;
+    /** Expose event bus for testing */
+    getEventBus(): EventBus | undefined;
+    /** Expose event registry for testing */
+    getEventRegistry(): EventRegistry | undefined;
+    /** Expose process engine for testing */
+    getProcessEngine(): ProcessEngine | undefined;
+    /** Expose notification storage for testing */
+    getNotificationStorage(): NotificationStorage | undefined;
+    /**
+     * Load .env file into process.env (simple key=value parser, no dependencies).
+     * Skips comments and empty lines. Does not override existing env vars.
+     */
+    private loadEnvFile;
+}
+/**
+ * Create and start a LoomServer from a project root
+ */
+export declare function startServer(projectRoot: string): Promise<LoomServer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAUvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAK9E,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8SjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,0CAA0C;IAC1C,UAAU,IAAI,UAAU,CAAC,OAAO,OAAO,CAAC;IAIxC,gCAAgC;IAChC,SAAS,IAAI,UAAU;IAIvB,iCAAiC;IACjC,UAAU,IAAI,WAAW;IAIzB,oCAAoC;IACpC,YAAY,IAAI,SAAS,GAAG,SAAS;IAIrC,qCAAqC;IACrC,aAAa,IAAI,UAAU,GAAG,SAAS;IAIvC,mCAAmC;IACnC,WAAW,IAAI,QAAQ,GAAG,SAAS;IAInC,wCAAwC;IACxC,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAI7C,wCAAwC;IACxC,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAI7C,8CAA8C;IAC9C,sBAAsB,IAAI,mBAAmB,GAAG,SAAS;IAIzD;;;OAGG;YACW,WAAW;CAqB1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK1E"}