dotdo 0.0.1 → 0.1.0

package/dist/objects/services/StoreManager.js

@@ -0,0 +1,227 @@
+/**
+ * StoreManager - Store lifecycle and lazy loading service
+ *
+ * Extracted from DOBase to provide:
+ * - Lazy initialization of stores (things, rels, actions, events, search, objects, dlq)
+ * - Type cache management for noun FK resolution
+ * - Store context creation
+ *
+ * This service encapsulates the store lifecycle pattern:
+ * - Stores are only created when first accessed
+ * - Each store receives a shared context (db, ns, branch, env, typeCache)
+ * - The DLQ store requires a handler map for replay functionality
+ *
+ * @example
+ * ```typescript
+ * const storeManager = new StoreManager(db, ns, currentBranch, env)
+ *
+ * // Stores are lazy-loaded on first access
+ * const things = storeManager.things
+ * const rels = storeManager.rels
+ * ```
+ */
+import { ThingsStore, RelationshipsStore, ActionsStore, EventsStore, SearchStore, ObjectsStore, DLQStore, } from '../../db/stores';
+/**
+ * StoreManager - Manages store lifecycle and lazy loading
+ *
+ * Provides lazy-initialized store accessors and manages the shared
+ * context (db, ns, branch, env, typeCache) across all stores.
+ */
+export class StoreManager {
+    _db;
+    _ns;
+    _env;
+    _typeCache;
+    _currentBranch;
+    // Lazy-loaded store instances
+    _things;
+    _rels;
+    _actions;
+    _events;
+    _search;
+    _objects;
+    _dlq;
+    // DLQ handler map (set via setDlqHandlers)
+    _dlqHandlers;
+    constructor(config) {
+        this._db = config.db;
+        this._ns = config.ns;
+        this._currentBranch = config.currentBranch;
+        this._env = config.env;
+        this._typeCache = config.typeCache ?? new Map();
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // CONTEXT & CONFIGURATION
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get the current namespace
+     */
+    get ns() {
+        return this._ns;
+    }
+    /**
+     * Get the current branch
+     */
+    get currentBranch() {
+        return this._currentBranch;
+    }
+    /**
+     * Set the current branch (for branch switching)
+     */
+    set currentBranch(branch) {
+        this._currentBranch = branch;
+        // Reset stores to pick up new branch - they'll be recreated on next access
+        this.resetStores();
+    }
+    /**
+     * Get the type cache (for noun FK resolution)
+     */
+    get typeCache() {
+        return this._typeCache;
+    }
+    /**
+     * Get the database instance
+     */
+    get db() {
+        return this._db;
+    }
+    /**
+     * Get the store context for initializing stores
+     */
+    getStoreContext() {
+        return {
+            db: this._db,
+            ns: this._ns,
+            currentBranch: this._currentBranch,
+            env: this._env,
+            typeCache: this._typeCache,
+        };
+    }
+    /**
+     * Set DLQ handlers for replay functionality
+     * Must be called before accessing the dlq store if replay is needed
+     */
+    setDlqHandlers(handlers) {
+        this._dlqHandlers = handlers;
+        // Reset DLQ store to pick up new handlers
+        this._dlq = undefined;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // STORE ACCESSORS (lazy-loaded)
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * ThingsStore - CRUD operations for Things
+     */
+    get things() {
+        if (!this._things) {
+            this._things = new ThingsStore(this.getStoreContext());
+        }
+        return this._things;
+    }
+    /**
+     * RelationshipsStore - Relationship management
+     */
+    get rels() {
+        if (!this._rels) {
+            this._rels = new RelationshipsStore(this.getStoreContext());
+        }
+        return this._rels;
+    }
+    /**
+     * ActionsStore - Action logging and lifecycle
+     */
+    get actions() {
+        if (!this._actions) {
+            this._actions = new ActionsStore(this.getStoreContext());
+        }
+        return this._actions;
+    }
+    /**
+     * EventsStore - Event emission and streaming
+     */
+    get events() {
+        if (!this._events) {
+            this._events = new EventsStore(this.getStoreContext());
+        }
+        return this._events;
+    }
+    /**
+     * SearchStore - Full-text and semantic search
+     */
+    get search() {
+        if (!this._search) {
+            this._search = new SearchStore(this.getStoreContext());
+        }
+        return this._search;
+    }
+    /**
+     * ObjectsStore - DO registry and resolution
+     */
+    get objects() {
+        if (!this._objects) {
+            this._objects = new ObjectsStore(this.getStoreContext());
+        }
+        return this._objects;
+    }
+    /**
+     * DLQStore - Dead Letter Queue for failed events
+     */
+    get dlq() {
+        if (!this._dlq) {
+            this._dlq = new DLQStore(this.getStoreContext(), this._dlqHandlers);
+        }
+        return this._dlq;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // LIFECYCLE MANAGEMENT
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Reset all store instances
+     * Stores will be re-created on next access with fresh context
+     */
+    resetStores() {
+        this._things = undefined;
+        this._rels = undefined;
+        this._actions = undefined;
+        this._events = undefined;
+        this._search = undefined;
+        this._objects = undefined;
+        this._dlq = undefined;
+    }
+    /**
+     * Check if a specific store has been initialized
+     */
+    isStoreInitialized(store) {
+        switch (store) {
+            case 'things': return this._things !== undefined;
+            case 'rels': return this._rels !== undefined;
+            case 'actions': return this._actions !== undefined;
+            case 'events': return this._events !== undefined;
+            case 'search': return this._search !== undefined;
+            case 'objects': return this._objects !== undefined;
+            case 'dlq': return this._dlq !== undefined;
+        }
+    }
+    /**
+     * Get list of initialized stores
+     */
+    getInitializedStores() {
+        const stores = [];
+        if (this._things)
+            stores.push('things');
+        if (this._rels)
+            stores.push('rels');
+        if (this._actions)
+            stores.push('actions');
+        if (this._events)
+            stores.push('events');
+        if (this._search)
+            stores.push('search');
+        if (this._objects)
+            stores.push('objects');
+        if (this._dlq)
+            stores.push('dlq');
+        return stores;
+    }
+}
+//# sourceMappingURL=StoreManager.js.map

package/dist/objects/services/StoreManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreManager.js","sourceRoot":"","sources":["../../../objects/services/StoreManager.ts"],"names":[],"mappings":"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"}

package/dist/objects/services/index.js

@@ -0,0 +1,13 @@
+/**
+ * Services - Composable services extracted from DOBase
+ *
+ * These services encapsulate specific concerns:
+ * - StoreManager: Store lifecycle and lazy loading
+ *
+ * Future services (planned):
+ * - EventBus: Event emission and dispatch
+ * - ActionLogger: Action tracking and logging
+ * - CrossDOClient: Inter-DO communication with circuit breaker
+ */
+export { StoreManager } from './StoreManager';
+//# sourceMappingURL=index.js.map

package/dist/objects/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../objects/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAA8D,MAAM,gBAAgB,CAAA"}