@semiont/event-sourcing 0.3.7 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +74 -19
- package/dist/index.js +96 -28
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -47,7 +47,6 @@ declare class FilesystemViewStorage implements ViewStorage {
|
|
|
47
47
|
*/
|
|
48
48
|
|
|
49
49
|
interface EventStorageConfig {
|
|
50
|
-
dataDir: string;
|
|
51
50
|
maxEventsPerFile?: number;
|
|
52
51
|
enableSharding?: boolean;
|
|
53
52
|
numShards?: number;
|
|
@@ -59,11 +58,12 @@ interface EventStorageConfig {
|
|
|
59
58
|
*/
|
|
60
59
|
declare class EventStorage {
|
|
61
60
|
private config;
|
|
61
|
+
private project;
|
|
62
62
|
private logger?;
|
|
63
63
|
private resourceSequences;
|
|
64
64
|
private resourceLastHash;
|
|
65
65
|
private currentFiles;
|
|
66
|
-
constructor(
|
|
66
|
+
constructor(project: SemiontProject, config?: EventStorageConfig, logger?: Logger);
|
|
67
67
|
/**
|
|
68
68
|
* Calculate shard path for a resource ID
|
|
69
69
|
* Uses jump consistent hash for uniform distribution
|
|
@@ -156,7 +156,7 @@ declare class EventStorage {
|
|
|
156
156
|
*/
|
|
157
157
|
|
|
158
158
|
interface EventLogConfig {
|
|
159
|
-
|
|
159
|
+
project: SemiontProject;
|
|
160
160
|
enableSharding?: boolean;
|
|
161
161
|
maxEventsPerFile?: number;
|
|
162
162
|
}
|
|
@@ -355,6 +355,13 @@ declare class ViewMaterializer {
|
|
|
355
355
|
* Falls back to full rebuild if view doesn't exist
|
|
356
356
|
*/
|
|
357
357
|
materializeIncremental(resourceId: ResourceId, event: ResourceEvent, getAllEvents: () => Promise<StoredEvent[]>): Promise<void>;
|
|
358
|
+
/**
|
|
359
|
+
* Update the storage-uri index in response to an event.
|
|
360
|
+
*
|
|
361
|
+
* Only resource.created (with storageUri), resource.moved, need index changes.
|
|
362
|
+
* resource.archived / resource.unarchived do NOT modify the index.
|
|
363
|
+
*/
|
|
364
|
+
private materializeStorageUriIndex;
|
|
358
365
|
/**
|
|
359
366
|
* Materialize view from event list (full rebuild)
|
|
360
367
|
*/
|
|
@@ -443,7 +450,7 @@ declare class EventStore {
|
|
|
443
450
|
readonly views: ViewManager;
|
|
444
451
|
readonly viewStorage: ViewStorage;
|
|
445
452
|
readonly coreEventBus?: EventBus$1;
|
|
446
|
-
constructor(
|
|
453
|
+
constructor(project: SemiontProject, stateDir: string, viewStorage: ViewStorage, coreEventBus?: EventBus$1, logger?: Logger);
|
|
447
454
|
/**
|
|
448
455
|
* Append an event to the store
|
|
449
456
|
* Coordinates: persistence → view → notification
|
|
@@ -461,24 +468,12 @@ declare class EventStore {
|
|
|
461
468
|
/**
|
|
462
469
|
* Create and initialize an EventStore instance
|
|
463
470
|
*
|
|
464
|
-
* @param
|
|
471
|
+
* @param project - SemiontProject instance
|
|
465
472
|
* @param eventBus - Optional @semiont/core EventBus for publishing domain events
|
|
466
473
|
* @param logger - Optional logger for structured logging
|
|
467
474
|
* @returns Configured EventStore instance ready for use
|
|
468
|
-
*
|
|
469
|
-
* @example
|
|
470
|
-
* ```typescript
|
|
471
|
-
* const eventStore = createEventStore('/absolute/path/to/data');
|
|
472
|
-
* await eventStore.appendEvent({
|
|
473
|
-
* type: 'resource.created',
|
|
474
|
-
* resourceId: 'doc-123',
|
|
475
|
-
* userId: 'user-456',
|
|
476
|
-
* version: 1,
|
|
477
|
-
* payload: { name: 'My Document' }
|
|
478
|
-
* });
|
|
479
|
-
* ```
|
|
480
475
|
*/
|
|
481
|
-
declare function createEventStore(project: SemiontProject,
|
|
476
|
+
declare function createEventStore(project: SemiontProject, eventBus?: EventBus$1, logger?: Logger): EventStore;
|
|
482
477
|
|
|
483
478
|
/**
|
|
484
479
|
* Sharding Utilities
|
|
@@ -529,6 +524,66 @@ declare function getShardPath(key: string, numBuckets?: number): [string, string
|
|
|
529
524
|
*/
|
|
530
525
|
declare function sha256(data: string | object): string;
|
|
531
526
|
|
|
527
|
+
/**
|
|
528
|
+
* Storage URI Index
|
|
529
|
+
*
|
|
530
|
+
* Projection that maps file:// URIs → resourceIds.
|
|
531
|
+
* Sharded at:
|
|
532
|
+
* {projectionsDir}/storage-uri/{ab}/{cd}/{uri-hash}.json
|
|
533
|
+
*
|
|
534
|
+
* where {ab}/{cd} comes from jumpConsistentHash(uri) and
|
|
535
|
+
* {uri-hash} is the SHA-256 of the URI string.
|
|
536
|
+
*
|
|
537
|
+
* Each file contains: { uri: string; resourceId: string }
|
|
538
|
+
*
|
|
539
|
+
* This index is maintained by ViewMaterializer (the single owner).
|
|
540
|
+
* It is never modified by Stower or other actors.
|
|
541
|
+
*
|
|
542
|
+
* Archive/unarchive do NOT remove entries from this index.
|
|
543
|
+
* Archived resources are marked in the ResourceView (archived: true)
|
|
544
|
+
* but remain findable by URI.
|
|
545
|
+
*/
|
|
546
|
+
interface StorageUriEntry {
|
|
547
|
+
uri: string;
|
|
548
|
+
resourceId: string;
|
|
549
|
+
}
|
|
550
|
+
/**
|
|
551
|
+
* Thrown when a URI is not found in the storage-uri index.
|
|
552
|
+
*/
|
|
553
|
+
declare class ResourceNotFoundError extends Error {
|
|
554
|
+
readonly uri: string;
|
|
555
|
+
constructor(uri: string);
|
|
556
|
+
}
|
|
557
|
+
/**
|
|
558
|
+
* Resolve a file:// URI to a resourceId using the storage-uri index.
|
|
559
|
+
*
|
|
560
|
+
* @param projectionsDir - Path to the projections directory
|
|
561
|
+
* @param uri - file:// URI (e.g. "file://docs/overview.md")
|
|
562
|
+
* @returns resourceId
|
|
563
|
+
* @throws ResourceNotFoundError if URI is not in the index
|
|
564
|
+
*/
|
|
565
|
+
declare function resolveStorageUri(projectionsDir: string, uri: string): Promise<string>;
|
|
566
|
+
/**
|
|
567
|
+
* Write a URI → resourceId mapping to the index.
|
|
568
|
+
*
|
|
569
|
+
* Called by ViewMaterializer when handling resource.created, resource.moved.
|
|
570
|
+
*
|
|
571
|
+
* @param projectionsDir - Path to the projections directory
|
|
572
|
+
* @param uri - file:// URI
|
|
573
|
+
* @param resourceId - resourceId to map to
|
|
574
|
+
*/
|
|
575
|
+
declare function writeStorageUriEntry(projectionsDir: string, uri: string, resourceId: string): Promise<void>;
|
|
576
|
+
/**
|
|
577
|
+
* Remove a URI entry from the index.
|
|
578
|
+
*
|
|
579
|
+
* Called by ViewMaterializer when handling resource.moved (old URI only).
|
|
580
|
+
* NOT called on resource.archived — archived resources retain their index entry.
|
|
581
|
+
*
|
|
582
|
+
* @param projectionsDir - Path to the projections directory
|
|
583
|
+
* @param uri - file:// URI to remove
|
|
584
|
+
*/
|
|
585
|
+
declare function removeStorageUriEntry(projectionsDir: string, uri: string): Promise<void>;
|
|
586
|
+
|
|
532
587
|
/**
|
|
533
588
|
* Event Query - Read Operations
|
|
534
589
|
*
|
|
@@ -623,4 +678,4 @@ declare class EventValidator {
|
|
|
623
678
|
*/
|
|
624
679
|
declare function generateAnnotationId(): string;
|
|
625
680
|
|
|
626
|
-
export { EventBus, type EventCallback, EventLog, type EventLogConfig, EventQuery, EventStorage, type EventStorageConfig, EventStore, type EventSubscription, EventSubscriptions, EventValidator, FilesystemViewStorage, type ResourceView, ViewManager, type ViewManagerConfig, ViewMaterializer, type ViewStorage, createEventStore, generateAnnotationId, getEventSubscriptions, getShardPath, jumpConsistentHash, sha256 };
|
|
681
|
+
export { EventBus, type EventCallback, EventLog, type EventLogConfig, EventQuery, EventStorage, type EventStorageConfig, EventStore, type EventSubscription, EventSubscriptions, EventValidator, FilesystemViewStorage, ResourceNotFoundError, type ResourceView, type StorageUriEntry, ViewManager, type ViewManagerConfig, ViewMaterializer, type ViewStorage, createEventStore, generateAnnotationId, getEventSubscriptions, getShardPath, jumpConsistentHash, removeStorageUriEntry, resolveStorageUri, sha256, writeStorageUriEntry };
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { promises, createReadStream } from 'fs';
|
|
2
|
+
import { execFileSync } from 'child_process';
|
|
2
3
|
import * as path from 'path';
|
|
4
|
+
import path__default from 'path';
|
|
3
5
|
import * as readline from 'readline';
|
|
4
6
|
import { v4 } from 'uuid';
|
|
5
7
|
import { resourceId, isSystemEvent, isResourceEvent, didToAgent, findBodyItem } from '@semiont/core';
|
|
@@ -40,6 +42,7 @@ function sha256(data) {
|
|
|
40
42
|
// src/storage/event-storage.ts
|
|
41
43
|
var EventStorage = class {
|
|
42
44
|
config;
|
|
45
|
+
project;
|
|
43
46
|
logger;
|
|
44
47
|
// Per-resource sequence tracking: resourceId -> sequence number
|
|
45
48
|
resourceSequences = /* @__PURE__ */ new Map();
|
|
@@ -47,14 +50,14 @@ var EventStorage = class {
|
|
|
47
50
|
resourceLastHash = /* @__PURE__ */ new Map();
|
|
48
51
|
// Per-resource current file cache: avoids fs.readdir() + countEventsInFile() on every append
|
|
49
52
|
currentFiles = /* @__PURE__ */ new Map();
|
|
50
|
-
constructor(config, logger) {
|
|
53
|
+
constructor(project, config, logger) {
|
|
54
|
+
this.project = project;
|
|
51
55
|
this.logger = logger;
|
|
52
56
|
this.config = {
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
enableCompression: config.enableCompression ?? true
|
|
57
|
+
maxEventsPerFile: config?.maxEventsPerFile || 1e4,
|
|
58
|
+
enableSharding: config?.enableSharding ?? true,
|
|
59
|
+
numShards: config?.numShards || 65536,
|
|
60
|
+
enableCompression: config?.enableCompression ?? true
|
|
58
61
|
};
|
|
59
62
|
}
|
|
60
63
|
/**
|
|
@@ -76,7 +79,7 @@ var EventStorage = class {
|
|
|
76
79
|
*/
|
|
77
80
|
getResourcePath(resourceId) {
|
|
78
81
|
const shardPath = this.getShardPath(resourceId);
|
|
79
|
-
return path.join(this.
|
|
82
|
+
return path.join(this.project.eventsDir, shardPath, resourceId);
|
|
80
83
|
}
|
|
81
84
|
/**
|
|
82
85
|
* Initialize directory structure for a resource's event stream
|
|
@@ -95,6 +98,9 @@ var EventStorage = class {
|
|
|
95
98
|
const filename = this.createEventFilename(1);
|
|
96
99
|
const filePath = path.join(docPath, filename);
|
|
97
100
|
await promises.writeFile(filePath, "", "utf-8");
|
|
101
|
+
if (this.project.gitSync) {
|
|
102
|
+
execFileSync("git", ["add", docPath], { cwd: this.project.root });
|
|
103
|
+
}
|
|
98
104
|
this.resourceSequences.set(resourceId, 0);
|
|
99
105
|
this.logger?.info("[EventStorage] Initialized event stream", { resourceId, path: docPath });
|
|
100
106
|
} else {
|
|
@@ -177,6 +183,9 @@ var EventStorage = class {
|
|
|
177
183
|
const eventLine = JSON.stringify(event) + "\n";
|
|
178
184
|
await promises.appendFile(targetPath, eventLine, "utf-8");
|
|
179
185
|
current.eventCount++;
|
|
186
|
+
if (this.project.gitSync) {
|
|
187
|
+
execFileSync("git", ["add", targetPath], { cwd: this.project.root });
|
|
188
|
+
}
|
|
180
189
|
}
|
|
181
190
|
/**
|
|
182
191
|
* Count events in a specific file
|
|
@@ -285,7 +294,7 @@ var EventStorage = class {
|
|
|
285
294
|
* Get all resource IDs by scanning shard directories
|
|
286
295
|
*/
|
|
287
296
|
async getAllResourceIds() {
|
|
288
|
-
const eventsDir =
|
|
297
|
+
const eventsDir = this.project.eventsDir;
|
|
289
298
|
const resourceIds = [];
|
|
290
299
|
try {
|
|
291
300
|
await promises.access(eventsDir);
|
|
@@ -351,10 +360,9 @@ var EventLog = class {
|
|
|
351
360
|
// Expose storage for EventQuery (read operations)
|
|
352
361
|
storage;
|
|
353
362
|
constructor(config, logger) {
|
|
354
|
-
this.storage = new EventStorage({
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
maxEventsPerFile: config.maxEventsPerFile ?? 1e4
|
|
363
|
+
this.storage = new EventStorage(config.project, {
|
|
364
|
+
enableSharding: config.enableSharding,
|
|
365
|
+
maxEventsPerFile: config.maxEventsPerFile
|
|
358
366
|
}, logger?.child({ component: "EventStorage" }));
|
|
359
367
|
}
|
|
360
368
|
/**
|
|
@@ -607,6 +615,49 @@ var EventBus = class {
|
|
|
607
615
|
return this.subscriptions.getGlobalSubscriptionCount();
|
|
608
616
|
}
|
|
609
617
|
};
|
|
618
|
+
var ResourceNotFoundError = class extends Error {
|
|
619
|
+
constructor(uri) {
|
|
620
|
+
super(`No resource found for URI: ${uri}`);
|
|
621
|
+
this.uri = uri;
|
|
622
|
+
this.name = "ResourceNotFoundError";
|
|
623
|
+
}
|
|
624
|
+
};
|
|
625
|
+
async function resolveStorageUri(projectionsDir, uri) {
|
|
626
|
+
const entryPath = uriIndexPath(projectionsDir, uri);
|
|
627
|
+
try {
|
|
628
|
+
const raw = await promises.readFile(entryPath, "utf-8");
|
|
629
|
+
const entry = JSON.parse(raw);
|
|
630
|
+
return entry.resourceId;
|
|
631
|
+
} catch (error) {
|
|
632
|
+
if (error.code === "ENOENT") {
|
|
633
|
+
throw new ResourceNotFoundError(uri);
|
|
634
|
+
}
|
|
635
|
+
throw error;
|
|
636
|
+
}
|
|
637
|
+
}
|
|
638
|
+
async function writeStorageUriEntry(projectionsDir, uri, resourceId) {
|
|
639
|
+
const entryPath = uriIndexPath(projectionsDir, uri);
|
|
640
|
+
await promises.mkdir(path__default.dirname(entryPath), { recursive: true });
|
|
641
|
+
const entry = { uri, resourceId };
|
|
642
|
+
await promises.writeFile(entryPath, JSON.stringify(entry, null, 2));
|
|
643
|
+
}
|
|
644
|
+
async function removeStorageUriEntry(projectionsDir, uri) {
|
|
645
|
+
const entryPath = uriIndexPath(projectionsDir, uri);
|
|
646
|
+
try {
|
|
647
|
+
await promises.unlink(entryPath);
|
|
648
|
+
} catch (error) {
|
|
649
|
+
if (error.code !== "ENOENT") {
|
|
650
|
+
throw error;
|
|
651
|
+
}
|
|
652
|
+
}
|
|
653
|
+
}
|
|
654
|
+
function uriIndexPath(projectionsDir, uri) {
|
|
655
|
+
const uriHash = sha256(uri);
|
|
656
|
+
const [ab, cd] = getShardPath(uri);
|
|
657
|
+
return path__default.join(projectionsDir, "storage-uri", ab, cd, `${uriHash}.json`);
|
|
658
|
+
}
|
|
659
|
+
|
|
660
|
+
// src/views/view-materializer.ts
|
|
610
661
|
var ViewMaterializer = class {
|
|
611
662
|
constructor(viewStorage, config, logger) {
|
|
612
663
|
this.viewStorage = viewStorage;
|
|
@@ -648,6 +699,22 @@ var ViewMaterializer = class {
|
|
|
648
699
|
}
|
|
649
700
|
await this.viewStorage.save(resourceId, view);
|
|
650
701
|
this.logger?.info("[ViewMaterializer] View saved", { resourceId, version: view.annotations.version, annotationCount: view.annotations.annotations.length });
|
|
702
|
+
await this.materializeStorageUriIndex(resourceId, event);
|
|
703
|
+
}
|
|
704
|
+
/**
|
|
705
|
+
* Update the storage-uri index in response to an event.
|
|
706
|
+
*
|
|
707
|
+
* Only resource.created (with storageUri), resource.moved, need index changes.
|
|
708
|
+
* resource.archived / resource.unarchived do NOT modify the index.
|
|
709
|
+
*/
|
|
710
|
+
async materializeStorageUriIndex(resourceId, event) {
|
|
711
|
+
const projectionsDir = path.join(this.config.basePath, "projections");
|
|
712
|
+
if (event.type === "resource.created" && event.payload.storageUri) {
|
|
713
|
+
await writeStorageUriEntry(projectionsDir, event.payload.storageUri, resourceId);
|
|
714
|
+
} else if (event.type === "resource.moved") {
|
|
715
|
+
await removeStorageUriEntry(projectionsDir, event.payload.fromUri);
|
|
716
|
+
await writeStorageUriEntry(projectionsDir, event.payload.toUri, resourceId);
|
|
717
|
+
}
|
|
651
718
|
}
|
|
652
719
|
/**
|
|
653
720
|
* Materialize view from event list (full rebuild)
|
|
@@ -700,6 +767,10 @@ var ViewMaterializer = class {
|
|
|
700
767
|
resource.representations = reps;
|
|
701
768
|
resource.isDraft = event.payload.isDraft;
|
|
702
769
|
resource.wasDerivedFrom = event.payload.generatedFrom;
|
|
770
|
+
if (event.payload.storageUri) {
|
|
771
|
+
resource.storageUri = event.payload.storageUri;
|
|
772
|
+
}
|
|
773
|
+
resource.currentChecksum = event.payload.contentChecksum;
|
|
703
774
|
break;
|
|
704
775
|
case "resource.cloned":
|
|
705
776
|
resource.name = event.payload.name;
|
|
@@ -719,6 +790,14 @@ var ViewMaterializer = class {
|
|
|
719
790
|
});
|
|
720
791
|
resource.representations = reps2;
|
|
721
792
|
break;
|
|
793
|
+
case "resource.updated":
|
|
794
|
+
resource.currentChecksum = event.payload.contentChecksum;
|
|
795
|
+
resource.dateModified = event.timestamp;
|
|
796
|
+
break;
|
|
797
|
+
case "resource.moved":
|
|
798
|
+
resource.storageUri = event.payload.toUri;
|
|
799
|
+
resource.dateModified = event.timestamp;
|
|
800
|
+
break;
|
|
722
801
|
case "resource.archived":
|
|
723
802
|
resource.archived = true;
|
|
724
803
|
break;
|
|
@@ -878,15 +957,10 @@ var EventStore = class {
|
|
|
878
957
|
views;
|
|
879
958
|
viewStorage;
|
|
880
959
|
coreEventBus;
|
|
881
|
-
constructor(
|
|
960
|
+
constructor(project, stateDir, viewStorage, coreEventBus, logger) {
|
|
882
961
|
this.viewStorage = viewStorage;
|
|
883
962
|
this.coreEventBus = coreEventBus;
|
|
884
|
-
|
|
885
|
-
dataDir: config.dataDir,
|
|
886
|
-
enableSharding: config.enableSharding,
|
|
887
|
-
maxEventsPerFile: config.maxEventsPerFile
|
|
888
|
-
};
|
|
889
|
-
this.log = new EventLog(logConfig, logger?.child({ component: "EventLog" }));
|
|
963
|
+
this.log = new EventLog({ project }, logger?.child({ component: "EventLog" }));
|
|
890
964
|
this.bus = new EventBus(logger?.child({ component: "EventBus" }));
|
|
891
965
|
const viewConfig = {
|
|
892
966
|
basePath: stateDir
|
|
@@ -1013,16 +1087,10 @@ var FilesystemViewStorage = class {
|
|
|
1013
1087
|
};
|
|
1014
1088
|
|
|
1015
1089
|
// src/event-store-factory.ts
|
|
1016
|
-
function createEventStore(project,
|
|
1090
|
+
function createEventStore(project, eventBus, logger) {
|
|
1017
1091
|
const viewStorage = new FilesystemViewStorage(project, logger?.child({ component: "view-storage" }));
|
|
1018
1092
|
return new EventStore(
|
|
1019
|
-
|
|
1020
|
-
...config,
|
|
1021
|
-
dataDir: project.eventsDir,
|
|
1022
|
-
enableSharding: true,
|
|
1023
|
-
numShards: 65536
|
|
1024
|
-
// 4 hex digits (0000-ffff)
|
|
1025
|
-
},
|
|
1093
|
+
project,
|
|
1026
1094
|
project.stateDir,
|
|
1027
1095
|
viewStorage,
|
|
1028
1096
|
eventBus,
|
|
@@ -1160,6 +1228,6 @@ function generateAnnotationId() {
|
|
|
1160
1228
|
return nanoid(21);
|
|
1161
1229
|
}
|
|
1162
1230
|
|
|
1163
|
-
export { EventBus, EventLog, EventQuery, EventStorage, EventStore, EventSubscriptions, EventValidator, FilesystemViewStorage, ViewManager, ViewMaterializer, createEventStore, generateAnnotationId, getEventSubscriptions, getShardPath, jumpConsistentHash, sha256 };
|
|
1231
|
+
export { EventBus, EventLog, EventQuery, EventStorage, EventStore, EventSubscriptions, EventValidator, FilesystemViewStorage, ResourceNotFoundError, ViewManager, ViewMaterializer, createEventStore, generateAnnotationId, getEventSubscriptions, getShardPath, jumpConsistentHash, removeStorageUriEntry, resolveStorageUri, sha256, writeStorageUriEntry };
|
|
1164
1232
|
//# sourceMappingURL=index.js.map
|
|
1165
1233
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/storage/shard-utils.ts","../src/storage/event-storage.ts","../src/event-log.ts","../src/subscriptions/event-subscriptions.ts","../src/event-bus.ts","../src/views/view-materializer.ts","../src/view-manager.ts","../src/event-store.ts","../src/storage/view-storage.ts","../src/event-store-factory.ts","../src/query/event-query.ts","../src/validation/event-validator.ts","../src/identifier-utils.ts"],"names":["fs","uuidv4","resourceId","makeResourceId","path2","path3"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Sharding Utilities\n *\n * Shared utilities for consistent sharding across all storage layers\n * Uses Google's Jump Consistent Hash algorithm for even distribution\n */\n\nimport { createHash } from 'crypto';\n\n/**\n * TEMPORARY: Simple modulo-based hash sharding\n *\n * ⚠️ TODO: Replace with proper Jump Consistent Hash implementation\n *\n * This is a TEMPORARY implementation using simple modulo. It works and provides\n * good distribution, but does NOT provide the minimal reshuffling property of\n * Jump Consistent Hash when changing bucket counts.\n *\n * The proper implementation should use Google's Jump Consistent Hash algorithm:\n * Reference: \"A Fast, Minimal Memory, Consistent Hash Algorithm\" by Lamping & Veach (2014)\n * https://arxiv.org/abs/1406.2294\n *\n * Working implementations exist in npm packages like:\n * - jumphash (https://www.npmjs.com/package/jumphash)\n * - jump-gouache (https://github.com/bhoudu/jump-gouache)\n *\n * The algorithm requires proper 64-bit integer handling with BigInt to avoid\n * precision loss in JavaScript. The previous attempt failed due to incorrect\n * BigInt arithmetic in the while loop condition.\n *\n * Until replaced, this modulo approach will cause ALL data to be reshuffled\n * if bucket count changes, rather than the optimal O(n/k) reshuffling that\n * Jump Consistent Hash provides.\n *\n * @param key - The key to hash (typically a resource ID)\n * @param numBuckets - Number of shards/buckets (default: 65536 for 4-hex sharding)\n * @returns Shard number (0 to numBuckets-1)\n */\nexport function jumpConsistentHash(key: string, numBuckets: number = 65536): number {\n const hash = hashToUint32(key);\n return hash % numBuckets;\n}\n\n/**\n * Hash string to 32-bit unsigned integer\n */\nfunction hashToUint32(str: string): number {\n let hash = 0;\n for (let i = 0; i < str.length; i++) {\n hash = ((hash << 5) - hash) + str.charCodeAt(i);\n hash = hash & 0xFFFFFFFF;\n }\n return Math.abs(hash);\n}\n\n/**\n * Convert shard number to 4-hex directory path (ab/cd)\n *\n * @param shardId - Shard number (0-65535)\n * @returns Path segments like ['ab', 'cd']\n */\nexport function shardIdToPath(shardId: number): [string, string] {\n if (shardId < 0 || shardId >= 65536) {\n throw new Error(`Invalid shard ID: ${shardId}. Must be 0-65535 for 4-hex sharding.`);\n }\n\n const shardHex = shardId.toString(16).padStart(4, '0');\n const ab = shardHex.substring(0, 2);\n const cd = shardHex.substring(2, 4);\n\n return [ab, cd];\n}\n\n/**\n * Get 4-hex shard path for a key\n *\n * @param key - The key to hash (typically a resource ID)\n * @param numBuckets - Number of shards (default: 65536)\n * @returns Path segments like ['ab', 'cd']\n */\nexport function getShardPath(key: string, numBuckets: number = 65536): [string, string] {\n const shardId = jumpConsistentHash(key, numBuckets);\n return shardIdToPath(shardId);\n}\n\n/**\n * Calculate SHA-256 hash of data\n */\nexport function sha256(data: string | object): string {\n const content = typeof data === 'string' ? data : JSON.stringify(data);\n return createHash('sha256').update(content).digest('hex');\n}","/**\n * Event Storage - Physical Storage Layer\n *\n * Handles file I/O operations for event storage:\n * - JSONL file writing/reading\n * - 4-hex sharding (65,536 shards)\n * - File rotation\n * - Event stream initialization\n *\n * @see docs/EVENT-STORE.md#eventstorage for architecture details\n */\n\nimport { promises as fs } from 'fs';\nimport * as path from 'path';\nimport { createReadStream } from 'fs';\nimport * as readline from 'readline';\nimport { v4 as uuidv4 } from 'uuid';\nimport type { StoredEvent, ResourceEvent, EventMetadata, ResourceId, Logger } from '@semiont/core';\nimport { resourceId as makeResourceId } from '@semiont/core';\nimport { jumpConsistentHash, sha256 } from './shard-utils';\n\nexport interface EventStorageConfig {\n dataDir: string; // Events directory (e.g., <projectRoot>/.semiont/events)\n maxEventsPerFile?: number; // File rotation threshold (default: 10000)\n enableSharding?: boolean; // Enable 4-hex sharding (default: true)\n numShards?: number; // Number of shards (default: 65536)\n enableCompression?: boolean; // Gzip rotated files (default: true)\n}\n\n/**\n * EventStorage handles physical storage of events\n * Owns: file I/O, sharding, AND sequence/hash tracking\n */\nexport class EventStorage {\n private config: Required<EventStorageConfig>;\n private logger?: Logger;\n\n // Per-resource sequence tracking: resourceId -> sequence number\n private resourceSequences: Map<string, number> = new Map();\n // Per-resource last event hash: resourceId -> hash\n private resourceLastHash: Map<string, string> = new Map();\n // Per-resource current file cache: avoids fs.readdir() + countEventsInFile() on every append\n private currentFiles: Map<string, { path: string; eventCount: number }> = new Map();\n\n constructor(config: EventStorageConfig, logger?: Logger) {\n this.logger = logger;\n this.config = {\n dataDir: config.dataDir,\n maxEventsPerFile: config.maxEventsPerFile || 10000,\n enableSharding: config.enableSharding ?? true,\n numShards: config.numShards || 65536,\n enableCompression: config.enableCompression ?? true,\n };\n }\n\n /**\n * Calculate shard path for a resource ID\n * Uses jump consistent hash for uniform distribution\n * Special case: __system__ events bypass sharding\n */\n getShardPath(resourceId: ResourceId): string {\n // System events don't get sharded\n if (resourceId === '__system__' || !this.config.enableSharding) {\n return '';\n }\n\n // Jump consistent hash for uniform shard distribution\n const shardIndex = jumpConsistentHash(resourceId, this.config.numShards);\n\n // Convert to 4-hex format (e.g., 0000, 0001, ..., ffff)\n const hex = shardIndex.toString(16).padStart(4, '0');\n const [ab, cd] = [hex.substring(0, 2), hex.substring(2, 4)];\n\n return path.join(ab, cd);\n }\n\n /**\n * Get full path to resource's event directory\n */\n getResourcePath(resourceId: ResourceId): string {\n const shardPath = this.getShardPath(resourceId);\n return path.join(this.config.dataDir, 'events', shardPath, resourceId);\n }\n\n /**\n * Initialize directory structure for a resource's event stream\n * Also loads sequence number and last hash if stream exists\n */\n async initializeResourceStream(resourceId: ResourceId): Promise<void> {\n const docPath = this.getResourcePath(resourceId);\n\n // Check if already initialized\n let exists = false;\n try {\n await fs.access(docPath);\n exists = true;\n } catch {\n // Doesn't exist, create it\n }\n\n if (!exists) {\n // Create directory structure\n await fs.mkdir(docPath, { recursive: true });\n\n // Create initial empty events file\n const filename = this.createEventFilename(1);\n const filePath = path.join(docPath, filename);\n await fs.writeFile(filePath, '', 'utf-8');\n\n // Initialize sequence number\n this.resourceSequences.set(resourceId, 0);\n\n this.logger?.info('[EventStorage] Initialized event stream', { resourceId, path: docPath });\n } else {\n // Load existing sequence number and last hash\n const files = await this.getEventFiles(resourceId);\n if (files.length > 0) {\n const lastFile = files[files.length - 1];\n if (lastFile) {\n const lastEvent = await this.getLastEvent(resourceId, lastFile);\n if (lastEvent) {\n this.resourceSequences.set(resourceId, lastEvent.metadata.sequenceNumber);\n if (lastEvent.metadata.checksum) {\n this.resourceLastHash.set(resourceId, lastEvent.metadata.checksum);\n }\n }\n }\n } else {\n this.resourceSequences.set(resourceId, 0);\n }\n }\n }\n\n /**\n * Append an event - handles EVERYTHING for event creation\n * Creates ID, timestamp, metadata, checksum, sequence tracking, and writes to disk\n */\n async appendEvent(event: Omit<ResourceEvent, 'id' | 'timestamp'>, resourceId: ResourceId): Promise<StoredEvent> {\n // Ensure resource stream is initialized\n if (this.getSequenceNumber(resourceId) === 0) {\n await this.initializeResourceStream(resourceId);\n }\n\n // Create complete event with ID and timestamp\n const completeEvent: ResourceEvent = {\n ...event,\n id: uuidv4(),\n timestamp: new Date().toISOString(),\n } as ResourceEvent;\n\n // Calculate metadata\n const sequenceNumber = this.getNextSequenceNumber(resourceId);\n const prevEventHash = this.getLastEventHash(resourceId);\n\n const metadata: EventMetadata = {\n sequenceNumber,\n streamPosition: 0, // Will be set during write\n timestamp: new Date().toISOString(),\n prevEventHash: prevEventHash || undefined,\n checksum: sha256(completeEvent),\n };\n\n const storedEvent: StoredEvent = {\n event: completeEvent,\n metadata,\n };\n\n // Write to disk\n await this.writeEvent(storedEvent, resourceId);\n\n // Update last hash\n this.setLastEventHash(resourceId, metadata.checksum!);\n\n return storedEvent;\n }\n\n /**\n * Write an event to storage (append to JSONL)\n * Internal method - use appendEvent() instead\n *\n * Uses currentFiles cache to avoid fs.readdir() + countEventsInFile() on every append.\n * Cache is populated on first append (cold start) and updated on rotation.\n */\n private async writeEvent(event: StoredEvent, resourceId: ResourceId): Promise<void> {\n const docPath = this.getResourcePath(resourceId);\n let current = this.currentFiles.get(resourceId);\n\n if (!current) {\n // Cold start: read from disk once\n const files = await this.getEventFiles(resourceId);\n const lastFile = files[files.length - 1];\n if (lastFile) {\n const count = await this.countEventsInFile(resourceId, lastFile);\n current = { path: lastFile, eventCount: count };\n } else {\n const newFile = await this.createNewEventFile(resourceId);\n current = { path: newFile, eventCount: 0 };\n }\n this.currentFiles.set(resourceId, current);\n }\n\n if (current.eventCount >= this.config.maxEventsPerFile) {\n const newFile = await this.createNewEventFile(resourceId);\n current = { path: newFile, eventCount: 0 };\n this.currentFiles.set(resourceId, current);\n }\n\n // Append event to file (JSONL format)\n const targetPath = path.join(docPath, current.path);\n const eventLine = JSON.stringify(event) + '\\n';\n await fs.appendFile(targetPath, eventLine, 'utf-8');\n current.eventCount++;\n }\n\n /**\n * Count events in a specific file\n */\n async countEventsInFile(resourceId: ResourceId, filename: string): Promise<number> {\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n try {\n const content = await fs.readFile(filePath, 'utf-8');\n const lines = content.trim().split('\\n').filter(line => line.trim() !== '');\n return lines.length;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return 0;\n }\n throw error;\n }\n }\n\n /**\n * Read all events from a specific file\n */\n async readEventsFromFile(resourceId: ResourceId, filename: string): Promise<StoredEvent[]> {\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n const events: StoredEvent[] = [];\n\n try {\n const fileStream = createReadStream(filePath, { encoding: 'utf-8' });\n const rl = readline.createInterface({\n input: fileStream,\n crlfDelay: Infinity,\n });\n\n for await (const line of rl) {\n const trimmed = line.trim();\n if (trimmed === '') continue;\n\n try {\n const event = JSON.parse(trimmed) as StoredEvent;\n events.push(event);\n } catch (parseError) {\n this.logger?.error('[EventStorage] Failed to parse event', { filePath, error: parseError });\n // Skip malformed lines\n }\n }\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return []; // File doesn't exist\n }\n throw error;\n }\n\n return events;\n }\n\n /**\n * Get list of event files for a resource (sorted by sequence)\n */\n async getEventFiles(resourceId: ResourceId): Promise<string[]> {\n const docPath = this.getResourcePath(makeResourceId(resourceId));\n\n try {\n const files = await fs.readdir(docPath);\n\n // Filter to .jsonl files and sort by sequence number\n const eventFiles = files\n .filter(f => f.startsWith('events-') && f.endsWith('.jsonl'))\n .sort((a, b) => {\n const seqA = parseInt(a.match(/events-(\\d+)\\.jsonl/)?.[1] || '0');\n const seqB = parseInt(b.match(/events-(\\d+)\\.jsonl/)?.[1] || '0');\n return seqA - seqB;\n });\n\n return eventFiles;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return []; // Directory doesn't exist\n }\n throw error;\n }\n }\n\n /**\n * Create a new event file for rotation\n */\n async createNewEventFile(resourceId: ResourceId): Promise<string> {\n const files = await this.getEventFiles(resourceId);\n\n // Determine next sequence number\n const lastFile = files[files.length - 1];\n const lastSeq = lastFile ? parseInt(lastFile.match(/events-(\\d+)\\.jsonl/)?.[1] || '1') : 1;\n const newSeq = lastSeq + 1;\n\n // Create new file\n const filename = this.createEventFilename(newSeq);\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n await fs.writeFile(filePath, '', 'utf-8');\n\n this.logger?.info('[EventStorage] Created new event file', { filename, resourceId });\n\n return filename;\n }\n\n /**\n * Get the last event from a specific file\n */\n async getLastEvent(resourceId: ResourceId, filename: string): Promise<StoredEvent | null> {\n const events = await this.readEventsFromFile(resourceId, filename);\n const lastEvent = events.length > 0 ? events[events.length - 1] : undefined;\n return lastEvent ?? null;\n }\n\n /**\n * Get all events for a resource across all files\n */\n async getAllEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n const files = await this.getEventFiles(resourceId);\n const allEvents: StoredEvent[] = [];\n\n for (const file of files) {\n const events = await this.readEventsFromFile(resourceId, file);\n allEvents.push(...events);\n }\n\n return allEvents;\n }\n\n /**\n * Get all resource IDs by scanning shard directories\n */\n async getAllResourceIds(): Promise<ResourceId[]> {\n const eventsDir = path.join(this.config.dataDir, 'events');\n const resourceIds: ResourceId[] = [];\n\n try {\n await fs.access(eventsDir);\n } catch {\n return []; // No events directory yet\n }\n\n // Recursively scan shard directories\n const scanDir = async (dir: string) => {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n\n if (entry.isDirectory()) {\n // Check if this looks like a resource ID (not a shard directory)\n // Shard directories are 2-char hex (00-ff), resource IDs are longer\n if (entry.name.length > 2) {\n resourceIds.push(makeResourceId(entry.name));\n } else {\n // Recurse into shard directory\n await scanDir(fullPath);\n }\n }\n }\n };\n\n await scanDir(eventsDir);\n return resourceIds;\n }\n\n /**\n * Create filename for event file\n */\n private createEventFilename(sequenceNumber: number): string {\n return `events-${sequenceNumber.toString().padStart(6, '0')}.jsonl`;\n }\n\n // ============================================================\n // Sequence/Hash Tracking\n // ============================================================\n\n /**\n * Get current sequence number for a resource\n */\n getSequenceNumber(resourceId: ResourceId): number {\n return this.resourceSequences.get(resourceId) || 0;\n }\n\n /**\n * Increment and return next sequence number for a resource\n */\n getNextSequenceNumber(resourceId: ResourceId): number {\n const current = this.getSequenceNumber(resourceId);\n const next = current + 1;\n this.resourceSequences.set(resourceId, next);\n return next;\n }\n\n /**\n * Get last event hash for a resource\n */\n getLastEventHash(resourceId: ResourceId): string | null {\n return this.resourceLastHash.get(resourceId) || null;\n }\n\n /**\n * Set last event hash for a resource\n */\n setLastEventHash(resourceId: ResourceId, hash: string): void {\n this.resourceLastHash.set(resourceId, hash);\n }\n}\n","/**\n * EventLog - Event Persistence Layer\n *\n * Single Responsibility: Event persistence only\n * - Appends events to storage (JSONL files)\n * - Retrieves events by resource\n * - Queries events with filters\n *\n * Does NOT handle:\n * - Pub/sub notifications (see EventBus)\n * - View updates (see ViewManager)\n */\n\nimport { type ResourceId, type StoredEvent, type ResourceEvent, type EventQuery, type Logger } from '@semiont/core';\nimport { EventStorage } from './storage/event-storage';\n\nexport interface EventLogConfig {\n dataDir: string;\n enableSharding?: boolean;\n maxEventsPerFile?: number;\n}\n\nexport class EventLog {\n // Expose storage for EventQuery (read operations)\n readonly storage: EventStorage;\n\n constructor(config: EventLogConfig, logger?: Logger) {\n this.storage = new EventStorage({\n dataDir: config.dataDir,\n enableSharding: config.enableSharding ?? true,\n maxEventsPerFile: config.maxEventsPerFile ?? 10000,\n }, logger?.child({ component: 'EventStorage' }));\n }\n\n /**\n * Append event to log\n * @param event - Resource event (from @semiont/core)\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @returns Stored event with metadata (sequence number, timestamp, checksum)\n */\n async append(event: Omit<ResourceEvent, 'id' | 'timestamp'>, resourceId: ResourceId): Promise<StoredEvent> {\n return this.storage.appendEvent(event, resourceId);\n }\n\n /**\n * Get all events for a resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n */\n async getEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n return this.storage.getAllEvents(resourceId);\n }\n\n /**\n * Get all resource IDs\n * @returns Array of branded ResourceId types\n */\n async getAllResourceIds(): Promise<ResourceId[]> {\n return this.storage.getAllResourceIds();\n }\n\n /**\n * Query events with filter\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param filter - Optional event filter\n */\n async queryEvents(resourceId: ResourceId, filter?: EventQuery): Promise<StoredEvent[]> {\n const events = await this.storage.getAllEvents(resourceId);\n if (!filter) return events;\n\n return events.filter(e => {\n if (filter.eventTypes && !filter.eventTypes.includes(e.event.type as any)) return false;\n if (filter.fromSequence && e.metadata.sequenceNumber < filter.fromSequence) return false;\n if (filter.fromTimestamp && e.event.timestamp < filter.fromTimestamp) return false;\n if (filter.toTimestamp && e.event.timestamp > filter.toTimestamp) return false;\n if (filter.userId && e.event.userId !== filter.userId) return false;\n return true;\n });\n }\n}\n","/**\n * Event Subscriptions - Real-time Event Pub/Sub\n *\n * Manages subscriptions for both resource-scoped and system-level events:\n * - Resource subscriptions: notifications for a specific resource's events\n * - Global subscriptions: notifications for all system-level events\n * - Fire-and-forget notification pattern (non-blocking)\n * - Automatic cleanup of empty subscription sets\n *\n * SINGLETON PATTERN: All EventStore instances share the same EventSubscriptions\n * to ensure SSE connections receive events from any EventStore instance.\n *\n * @see docs/EVENT-STORE.md#eventsubscriptions for architecture details\n */\n\nimport type { StoredEvent, ResourceId, Logger } from '@semiont/core';\n\nexport type EventCallback = (event: StoredEvent) => void | Promise<void>;\n\nexport interface EventSubscription {\n resourceId: ResourceId;\n callback: EventCallback;\n unsubscribe: () => void;\n}\n\n/**\n * EventSubscriptions manages real-time event pub/sub\n * Supports both resource-scoped and global subscriptions\n */\nexport class EventSubscriptions {\n // Per-resource subscriptions: ResourceId -> Set of callbacks\n private subscriptions: Map<ResourceId, Set<EventCallback>> = new Map();\n // Global subscriptions for system-level events (no resourceId)\n private globalSubscriptions: Set<EventCallback> = new Set();\n private logger?: Logger;\n\n constructor(logger?: Logger) {\n this.logger = logger;\n }\n\n /**\n * Subscribe to events for a specific resource\n * Returns an EventSubscription with unsubscribe function\n */\n subscribe(resourceId: ResourceId, callback: EventCallback): EventSubscription {\n if (!this.subscriptions.has(resourceId)) {\n this.subscriptions.set(resourceId, new Set());\n }\n\n const callbacks = this.subscriptions.get(resourceId)!;\n callbacks.add(callback);\n\n this.logger?.info('[EventSubscriptions] Subscription added for resource', { resourceId, totalSubscribers: callbacks.size });\n\n return {\n resourceId,\n callback,\n unsubscribe: () => {\n callbacks.delete(callback);\n this.logger?.info('[EventSubscriptions] Subscription removed for resource', { resourceId, remainingSubscribers: callbacks.size });\n if (callbacks.size === 0) {\n this.subscriptions.delete(resourceId);\n this.logger?.info('[EventSubscriptions] No more subscribers for resource, removed from subscriptions map', { resourceId });\n }\n }\n };\n }\n\n /**\n * Subscribe to all system-level events (no resourceId)\n * Returns an EventSubscription with unsubscribe function\n *\n * Use this for consumers that need to react to global events like:\n * - entitytype.added (global entity type collection changes)\n * - Future system-level events (user.created, workspace.created, etc.)\n */\n subscribeGlobal(callback: EventCallback): EventSubscription {\n this.globalSubscriptions.add(callback);\n\n this.logger?.info('[EventSubscriptions] Global subscription added', { totalSubscribers: this.globalSubscriptions.size });\n\n return {\n resourceId: '__global__' as ResourceId, // Special marker for global subscriptions\n callback,\n unsubscribe: () => {\n this.globalSubscriptions.delete(callback);\n this.logger?.info('[EventSubscriptions] Global subscription removed', { remainingSubscribers: this.globalSubscriptions.size });\n }\n };\n }\n\n /**\n * Notify all subscribers for a resource when a new event is appended\n * @param resourceId - Bare resource ID\n */\n async notifySubscribers(resourceId: ResourceId, event: StoredEvent): Promise<void> {\n const callbacks = this.subscriptions.get(resourceId);\n if (!callbacks || callbacks.size === 0) {\n this.logger?.info('[EventSubscriptions] Event - no subscribers to notify', { eventType: event.event.type, resourceId });\n return;\n }\n\n this.logger?.info('[EventSubscriptions] Notifying subscribers of event', { subscriberCount: callbacks.size, eventType: event.event.type, resourceId });\n\n // Call all callbacks without waiting - fire and forget\n // Each callback handles its own errors and cleanup\n // This prevents slow/hanging callbacks from blocking event emission\n Array.from(callbacks).forEach((callback, index) => {\n Promise.resolve(callback(event))\n .then(() => {\n this.logger?.info('[EventSubscriptions] Subscriber successfully notified', { subscriberIndex: index + 1, eventType: event.event.type });\n })\n .catch((error: unknown) => {\n this.logger?.error('[EventSubscriptions] Error in subscriber', { subscriberIndex: index + 1, resourceId, eventType: event.event.type, error });\n });\n });\n }\n\n /**\n * Notify all global subscribers when a system-level event is appended\n */\n async notifyGlobalSubscribers(event: StoredEvent): Promise<void> {\n if (this.globalSubscriptions.size === 0) {\n this.logger?.info('[EventSubscriptions] System event - no global subscribers to notify', { eventType: event.event.type });\n return;\n }\n\n this.logger?.info('[EventSubscriptions] Notifying global subscribers of system event', { subscriberCount: this.globalSubscriptions.size, eventType: event.event.type });\n\n // Call all global callbacks without waiting - fire and forget\n // Each callback handles its own errors and cleanup\n // This prevents slow/hanging callbacks from blocking event emission\n Array.from(this.globalSubscriptions).forEach((callback, index) => {\n Promise.resolve(callback(event))\n .then(() => {\n this.logger?.info('[EventSubscriptions] Global subscriber successfully notified', { subscriberIndex: index + 1, eventType: event.event.type });\n })\n .catch((error: unknown) => {\n this.logger?.error('[EventSubscriptions] Error in global subscriber', { subscriberIndex: index + 1, eventType: event.event.type, error });\n });\n });\n }\n\n /**\n * Get subscription count for a resource (useful for debugging)\n */\n getSubscriptionCount(resourceId: ResourceId): number {\n return this.subscriptions.get(resourceId)?.size || 0;\n }\n\n /**\n * Get total number of active subscriptions across all resources\n */\n getTotalSubscriptions(): number {\n let total = 0;\n for (const callbacks of this.subscriptions.values()) {\n total += callbacks.size;\n }\n return total;\n }\n\n /**\n * Get total number of global subscriptions\n */\n getGlobalSubscriptionCount(): number {\n return this.globalSubscriptions.size;\n }\n}\n\n// Singleton instance - shared across all EventStore instances\n// This ensures SSE connections receive events from any EventStore instance\nlet globalEventSubscriptions: EventSubscriptions | null = null;\n\nexport function getEventSubscriptions(logger?: Logger): EventSubscriptions {\n if (!globalEventSubscriptions) {\n globalEventSubscriptions = new EventSubscriptions(logger);\n logger?.info('[EventSubscriptions] Created global singleton instance');\n }\n return globalEventSubscriptions;\n}\n","/**\n * EventBus - Event Pub/Sub Layer\n *\n * Single Responsibility: Event pub/sub only\n * - Publishes events to subscribers\n * - Manages subscriptions (resource-scoped and global)\n *\n * Does NOT handle:\n * - Event persistence (see EventLog)\n * - View updates (see ViewManager)\n */\n\nimport { type StoredEvent, type ResourceId, resourceId as makeResourceId, isResourceEvent, isSystemEvent, type Logger } from '@semiont/core';\nimport { getEventSubscriptions, type EventSubscriptions, type EventCallback, type EventSubscription } from './subscriptions/event-subscriptions';\n\n/**\n * EventBus wraps EventSubscriptions with a clean API\n * Uses bare ResourceId for subscriptions\n */\nexport class EventBus {\n // Expose subscriptions for direct access\n readonly subscriptions: EventSubscriptions;\n private logger?: Logger;\n\n constructor(logger?: Logger) {\n this.logger = logger;\n // Use global singleton EventSubscriptions to ensure all EventBus instances\n // share the same subscription registry (critical for SSE real-time events)\n this.subscriptions = getEventSubscriptions(logger?.child({ component: 'EventSubscriptions' }));\n }\n\n /**\n * Publish event to subscribers\n * - Resource events: notifies BOTH resource-scoped AND global subscribers\n * - System events: notifies global subscribers only\n * @param event - Stored event (from @semiont/core)\n */\n async publish(event: StoredEvent): Promise<void> {\n if (isSystemEvent(event.event)) {\n // System-level event - notify global subscribers\n await this.subscriptions.notifyGlobalSubscribers(event);\n } else if (isResourceEvent(event.event)) {\n // Resource event - notify BOTH resource-scoped AND global subscribers\n // This enables projections (graph, search, etc.) to use global subscription\n const rid = makeResourceId(event.event.resourceId as string);\n await this.subscriptions.notifySubscribers(rid, event);\n await this.subscriptions.notifyGlobalSubscribers(event);\n } else {\n // Shouldn't happen - events should be either resource or system\n this.logger?.warn('[EventBus] Event is neither resource nor system event', { eventType: (event.event as any).type });\n }\n }\n\n /**\n * Subscribe to events for a specific resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param callback - Event callback function\n * @returns EventSubscription with unsubscribe function\n */\n subscribe(resourceId: ResourceId, callback: EventCallback): EventSubscription {\n return this.subscriptions.subscribe(resourceId, callback);\n }\n\n /**\n * Subscribe to all system-level events\n * @param callback - Event callback function\n * @returns EventSubscription with unsubscribe function\n */\n subscribeGlobal(callback: EventCallback): EventSubscription {\n return this.subscriptions.subscribeGlobal(callback);\n }\n\n /**\n * Unsubscribe from resource events\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param callback - Event callback function to remove\n */\n unsubscribe(resourceId: ResourceId, callback: EventCallback): void {\n const callbacks = (this.subscriptions as any).subscriptions.get(resourceId);\n if (callbacks) {\n callbacks.delete(callback);\n if (callbacks.size === 0) {\n (this.subscriptions as any).subscriptions.delete(resourceId);\n }\n }\n }\n\n /**\n * Unsubscribe from global events\n * @param callback - Event callback function to remove\n */\n unsubscribeGlobal(callback: EventCallback): void {\n (this.subscriptions as any).globalSubscriptions.delete(callback);\n }\n\n /**\n * Get subscriber count for a resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @returns Number of active subscribers\n */\n getSubscriberCount(resourceId: ResourceId): number {\n return this.subscriptions.getSubscriptionCount(resourceId);\n }\n\n /**\n * Get total number of active subscriptions across all resources\n */\n getTotalSubscriptions(): number {\n return this.subscriptions.getTotalSubscriptions();\n }\n\n /**\n * Get total number of global subscriptions\n */\n getGlobalSubscriptionCount(): number {\n return this.subscriptions.getGlobalSubscriptionCount();\n }\n}\n","/**\n * View Materializer - Materialized View Management\n *\n * Materializes resource views from events:\n * - Full view materialization from scratch\n * - Incremental view updates\n * - System-level views (entity types)\n *\n * @see docs/EVENT-STORE.md#viewmaterializer for architecture details\n */\n\nimport { promises as fs } from 'fs';\nimport * as path from 'path';\nimport { didToAgent } from '@semiont/core';\nimport type { components } from '@semiont/core';\n\ntype Representation = components['schemas']['Representation'];\ntype Annotation = components['schemas']['Annotation'];\ntype ResourceDescriptor = components['schemas']['ResourceDescriptor'];\n\nimport type {\n ResourceEvent,\n StoredEvent,\n ResourceAnnotations,\n ResourceId,\n Logger,\n} from '@semiont/core';\nimport { findBodyItem } from '@semiont/core';\nimport type { ViewStorage, ResourceView } from '../storage/view-storage';\n\nexport interface ViewMaterializerConfig {\n basePath: string;\n}\n\n/**\n * ViewMaterializer builds and maintains materialized views from events\n */\nexport class ViewMaterializer {\n private logger?: Logger;\n\n constructor(\n private viewStorage: ViewStorage,\n private config: ViewMaterializerConfig,\n logger?: Logger\n ) {\n this.logger = logger;\n }\n\n /**\n * Materialize resource view from events\n * Loads existing view if cached, otherwise rebuilds from events\n */\n async materialize(events: StoredEvent[], resourceId: ResourceId): Promise<ResourceView | null> {\n // Try to load existing view\n const existing = await this.viewStorage.get(resourceId);\n if (existing) {\n return existing;\n }\n\n // No view exists - rebuild from events\n if (events.length === 0) return null;\n\n const view = this.materializeFromEvents(events, resourceId);\n\n // Save rebuilt view\n await this.viewStorage.save(resourceId, view);\n\n return view;\n }\n\n /**\n * Materialize view incrementally with a single event\n * Falls back to full rebuild if view doesn't exist\n */\n async materializeIncremental(\n resourceId: ResourceId,\n event: ResourceEvent,\n getAllEvents: () => Promise<StoredEvent[]>\n ): Promise<void> {\n this.logger?.info('[ViewMaterializer] Updating view for resource with event', { resourceId, eventType: event.type });\n\n // Try to load existing view\n let view = await this.viewStorage.get(resourceId);\n\n if (!view) {\n // No view exists - do full rebuild from all events\n this.logger?.info('[ViewMaterializer] No view found, rebuilding from scratch', { resourceId });\n const events = await getAllEvents();\n view = this.materializeFromEvents(events, resourceId);\n } else {\n // Apply single event incrementally to existing view\n this.logger?.info('[ViewMaterializer] Applying event incrementally to existing view', { resourceId, version: view.annotations.version });\n this.applyEventToResource(view.resource, event);\n this.applyEventToAnnotations(view.annotations, event);\n view.annotations.version++;\n view.annotations.updatedAt = event.timestamp;\n }\n\n // Save updated view\n await this.viewStorage.save(resourceId, view);\n this.logger?.info('[ViewMaterializer] View saved', { resourceId, version: view.annotations.version, annotationCount: view.annotations.annotations.length });\n }\n\n /**\n * Materialize view from event list (full rebuild)\n */\n private materializeFromEvents(events: StoredEvent[], resourceId: ResourceId): ResourceView {\n // Start with empty ResourceDescriptor state\n // @id uses bare resource ID; full URI is constructed at the API boundary\n const resource: ResourceDescriptor = {\n '@context': 'https://schema.org/',\n '@id': resourceId as string,\n name: '',\n representations: [],\n archived: false,\n entityTypes: [],\n creationMethod: 'api',\n };\n\n // Start with empty annotations\n const annotations: ResourceAnnotations = {\n resourceId,\n annotations: [],\n version: 0,\n updatedAt: '',\n };\n\n // Apply events in sequenceNumber order\n events.sort((a, b) => a.metadata.sequenceNumber - b.metadata.sequenceNumber);\n\n for (const storedEvent of events) {\n this.applyEventToResource(resource, storedEvent.event);\n this.applyEventToAnnotations(annotations, storedEvent.event);\n annotations.version++;\n annotations.updatedAt = storedEvent.event.timestamp;\n }\n\n return { resource, annotations };\n }\n\n /**\n * Apply an event to ResourceDescriptor state (metadata only)\n */\n private applyEventToResource(resource: ResourceDescriptor, event: ResourceEvent): void {\n switch (event.type) {\n case 'resource.created':\n resource.name = event.payload.name;\n resource.entityTypes = event.payload.entityTypes || [];\n resource.dateCreated = event.timestamp;\n resource.creationMethod = event.payload.creationMethod || 'api';\n resource.wasAttributedTo = didToAgent(event.userId);\n\n // Create representation from format and checksum\n if (!resource.representations) resource.representations = [];\n const reps = Array.isArray(resource.representations) ? resource.representations : [resource.representations];\n reps.push({\n mediaType: event.payload.format,\n checksum: event.payload.contentChecksum,\n byteSize: event.payload.contentByteSize,\n rel: 'original',\n language: event.payload.language,\n } as Representation);\n resource.representations = reps;\n\n // First-class fields\n resource.isDraft = event.payload.isDraft;\n resource.wasDerivedFrom = event.payload.generatedFrom;\n break;\n\n case 'resource.cloned':\n resource.name = event.payload.name;\n resource.entityTypes = event.payload.entityTypes || [];\n resource.dateCreated = event.timestamp;\n resource.creationMethod = 'clone';\n resource.sourceResourceId = event.payload.parentResourceId;\n resource.wasAttributedTo = didToAgent(event.userId);\n\n // Create representation from format and checksum\n if (!resource.representations) resource.representations = [];\n const reps2 = Array.isArray(resource.representations) ? resource.representations : [resource.representations];\n reps2.push({\n mediaType: event.payload.format,\n checksum: event.payload.contentChecksum,\n byteSize: event.payload.contentByteSize,\n rel: 'original',\n language: event.payload.language,\n } as Representation);\n resource.representations = reps2;\n break;\n\n case 'resource.archived':\n resource.archived = true;\n break;\n\n case 'resource.unarchived':\n resource.archived = false;\n break;\n\n case 'representation.added': {\n const { representation } = event.payload;\n\n // Add to representations array (avoid duplicates by checksum)\n if (!resource.representations) {\n resource.representations = [];\n }\n\n const repsArray = Array.isArray(resource.representations)\n ? resource.representations\n : [resource.representations];\n\n // Check if representation already exists\n const exists = repsArray.some(r => r.checksum === representation.checksum);\n if (!exists) {\n resource.representations = [...repsArray, representation];\n }\n break;\n }\n\n case 'representation.removed': {\n const { checksum } = event.payload;\n\n if (resource.representations) {\n const repsArray = Array.isArray(resource.representations)\n ? resource.representations\n : [resource.representations];\n\n resource.representations = repsArray.filter(r => r.checksum !== checksum);\n }\n break;\n }\n\n case 'entitytag.added':\n if (!resource.entityTypes) resource.entityTypes = [];\n if (!resource.entityTypes.includes(event.payload.entityType)) {\n resource.entityTypes.push(event.payload.entityType);\n }\n break;\n\n case 'entitytag.removed':\n if (resource.entityTypes) {\n resource.entityTypes = resource.entityTypes.filter(\n (t: string) => t !== event.payload.entityType\n );\n }\n break;\n\n // Annotation events don't affect resource metadata\n case 'annotation.added':\n case 'annotation.removed':\n case 'annotation.body.updated':\n break;\n\n // Job events don't affect resource metadata\n case 'job.started':\n case 'job.progress':\n case 'job.completed':\n case 'job.failed':\n break;\n\n // System events don't affect resource metadata\n case 'entitytype.added':\n break;\n }\n }\n\n /**\n * Apply an event to ResourceAnnotations (annotation collections only)\n */\n private applyEventToAnnotations(annotations: ResourceAnnotations, event: ResourceEvent): void {\n switch (event.type) {\n case 'annotation.added':\n annotations.annotations.push(event.payload.annotation);\n break;\n\n case 'annotation.removed':\n annotations.annotations = annotations.annotations.filter(\n (a: Annotation) => a.id !== event.payload.annotationId\n );\n break;\n\n case 'annotation.body.updated':\n const annotation = annotations.annotations.find((a: Annotation) =>\n a.id === event.payload.annotationId\n );\n if (annotation) {\n // Ensure body is an array\n if (!Array.isArray(annotation.body)) {\n annotation.body = annotation.body ? [annotation.body] : [];\n }\n\n // Apply each operation\n for (const op of event.payload.operations) {\n if (op.op === 'add') {\n // Add item (idempotent - don't add if already exists)\n const exists = findBodyItem(annotation.body, op.item) !== -1;\n if (!exists) {\n annotation.body.push(op.item);\n }\n } else if (op.op === 'remove') {\n // Remove item\n const index = findBodyItem(annotation.body, op.item);\n if (index !== -1) {\n annotation.body.splice(index, 1);\n }\n } else if (op.op === 'replace') {\n // Replace item\n const index = findBodyItem(annotation.body, op.oldItem);\n if (index !== -1) {\n annotation.body[index] = op.newItem;\n }\n }\n }\n\n // Update modified timestamp\n annotation.modified = new Date(event.timestamp).toISOString();\n }\n break;\n\n // Resource metadata events don't affect annotations\n case 'resource.created':\n case 'resource.cloned':\n case 'resource.archived':\n case 'resource.unarchived':\n case 'representation.added':\n case 'representation.removed':\n case 'entitytag.added':\n case 'entitytag.removed':\n break;\n\n // Job events don't affect annotations\n case 'job.started':\n case 'job.progress':\n case 'job.completed':\n case 'job.failed':\n break;\n\n // System events don't affect annotations\n case 'entitytype.added':\n break;\n }\n }\n\n /**\n * Materialize entity types view - System-level view\n */\n async materializeEntityTypes(entityType: string): Promise<void> {\n const entityTypesPath = path.join(\n this.config.basePath,\n 'projections',\n '__system__',\n 'entitytypes.json'\n );\n\n\n // Read current view\n let view = { entityTypes: [] as string[] };\n try {\n const content = await fs.readFile(entityTypesPath, 'utf-8');\n view = JSON.parse(content);\n } catch (error: any) {\n if (error.code !== 'ENOENT') throw error;\n // File doesn't exist - will create it\n }\n\n // Add entity type (idempotent - Set ensures uniqueness)\n const entityTypeSet = new Set(view.entityTypes);\n entityTypeSet.add(entityType);\n view.entityTypes = Array.from(entityTypeSet).sort();\n\n // Write view\n await fs.mkdir(path.dirname(entityTypesPath), { recursive: true });\n await fs.writeFile(entityTypesPath, JSON.stringify(view, null, 2));\n }\n}\n","/**\n * ViewManager - Materialized View Management Layer\n *\n * Single Responsibility: View updates only\n * - Updates resource views from events\n * - Updates system views (entity types)\n * - Rebuilds views when needed\n *\n * Does NOT handle:\n * - Event persistence (see EventLog)\n * - Pub/sub notifications (see EventBus)\n */\n\nimport { type ResourceId, type ResourceEvent, type StoredEvent, type Logger } from '@semiont/core';\nimport { ViewMaterializer, type ViewMaterializerConfig } from './views/view-materializer';\nimport type { ViewStorage, ResourceView } from './storage/view-storage';\n\nexport interface ViewManagerConfig {\n basePath: string;\n}\n\n/**\n * ViewManager wraps ViewMaterializer with a clean API\n * Handles both resource and system-level views\n */\nexport class ViewManager {\n // Expose materializer for direct access to view methods\n readonly materializer: ViewMaterializer;\n\n constructor(\n viewStorage: ViewStorage,\n config: ViewManagerConfig,\n logger?: Logger\n ) {\n const materializerConfig: ViewMaterializerConfig = {\n basePath: config.basePath,\n };\n this.materializer = new ViewMaterializer(viewStorage, materializerConfig, logger?.child({ component: 'ViewMaterializer' }));\n }\n\n /**\n * Update resource view with a new event\n * Falls back to full rebuild if view doesn't exist\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param event - Resource event (from @semiont/core)\n * @param getAllEvents - Function to retrieve all events for rebuild if needed\n */\n async materializeResource(\n resourceId: ResourceId,\n event: ResourceEvent,\n getAllEvents: () => Promise<StoredEvent[]>\n ): Promise<void> {\n await this.materializer.materializeIncremental(resourceId, event, getAllEvents);\n }\n\n /**\n * Update system-level view (currently only entity types)\n * @param eventType - Type of system event\n * @param payload - Event payload\n */\n async materializeSystem(eventType: string, payload: any): Promise<void> {\n if (eventType === 'entitytype.added') {\n await this.materializer.materializeEntityTypes(payload.entityType);\n }\n // Future system views can be added here\n // e.g., user.created, workspace.created, etc.\n }\n\n /**\n * Get resource view (builds from events if needed)\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param events - Stored events for the resource (from @semiont/core)\n * @returns Resource view or null if no events\n */\n async getOrMaterialize(\n resourceId: ResourceId,\n events: StoredEvent[]\n ): Promise<ResourceView | null> {\n return this.materializer.materialize(events, resourceId);\n }\n}\n","/**\n * EventStore - Orchestration Layer\n *\n * Coordinates event sourcing operations across 3 focused components:\n * - EventLog: Event persistence (append, retrieve, query)\n * - EventBus: Pub/sub notifications (publish, subscribe)\n * - ViewManager: View updates (resource and system)\n *\n * Thin coordination layer - delegates all work to specialized components.\n *\n * @see docs/EVENT-STORE.md for complete architecture documentation\n */\n\nimport type {\n ResourceEvent,\n StoredEvent,\n ResourceId,\n Logger,\n} from '@semiont/core';\nimport { EventBus as CoreEventBus } from '@semiont/core';\nimport type { ViewStorage } from './storage/view-storage';\n// Import focused components\nimport { EventLog, type EventLogConfig } from './event-log';\nimport { EventBus } from './event-bus';\nimport { ViewManager, type ViewManagerConfig } from './view-manager';\nimport type { EventStorageConfig } from './storage/event-storage';\n\n/**\n * EventStore orchestrates event sourcing operations\n * Delegates to specialized components for focused functionality\n * NO state - just coordination between components\n */\nexport class EventStore {\n // Focused components - each with single responsibility\n readonly log: EventLog;\n readonly bus: EventBus;\n readonly views: ViewManager;\n readonly viewStorage: ViewStorage;\n readonly coreEventBus?: CoreEventBus;\n\n constructor(\n config: EventStorageConfig,\n stateDir: string,\n viewStorage: ViewStorage,\n coreEventBus?: CoreEventBus,\n logger?: Logger\n ) {\n // Store viewStorage for direct access\n this.viewStorage = viewStorage;\n this.coreEventBus = coreEventBus;\n\n // Initialize focused components\n const logConfig: EventLogConfig = {\n dataDir: config.dataDir,\n enableSharding: config.enableSharding,\n maxEventsPerFile: config.maxEventsPerFile,\n };\n this.log = new EventLog(logConfig, logger?.child({ component: 'EventLog' }));\n\n this.bus = new EventBus(logger?.child({ component: 'EventBus' }));\n\n const viewConfig: ViewManagerConfig = {\n basePath: stateDir,\n };\n this.views = new ViewManager(viewStorage, viewConfig, logger?.child({ component: 'ViewManager' }));\n }\n\n /**\n * Append an event to the store\n * Coordinates: persistence → view → notification\n */\n async appendEvent(event: Omit<ResourceEvent, 'id' | 'timestamp'>): Promise<StoredEvent> {\n // System-level events (entitytype.added) have no resourceId - use __system__\n const resourceId: ResourceId | '__system__' = event.resourceId || '__system__';\n\n // 1. Persist event to log\n const storedEvent = await this.log.append(event, resourceId as any);\n\n // 2. Update views\n if (resourceId === '__system__') {\n // System-level view (entity types, etc.)\n await this.views.materializeSystem(\n storedEvent.event.type,\n storedEvent.event.payload\n );\n } else {\n // Resource view\n await this.views.materializeResource(\n resourceId as ResourceId,\n storedEvent.event,\n () => this.log.getEvents(resourceId as ResourceId)\n );\n }\n\n // 3. Notify subscribers (legacy event bus)\n await this.bus.publish(storedEvent);\n\n // 4. Publish to @semiont/core EventBus if provided (domain events)\n if (this.coreEventBus && resourceId !== '__system__') {\n // Use resource-scoped bus for isolation\n const scopedBus = this.coreEventBus.scope(resourceId as string);\n\n // Publish to specific event type channel (convert dot notation to colon notation)\n // e.g., type: 'job.completed' → channel 'job:completed'\n const eventChannel = storedEvent.event.type.replace(/\\./g, ':') as any;\n scopedBus.get(eventChannel).next(storedEvent.event);\n\n // Also publish to generic 'make-meaning:event' channel for broad subscribers\n scopedBus.get('make-meaning:event').next(storedEvent.event);\n }\n\n return storedEvent;\n }\n}\n","/**\n * View Storage - Materialized Views\n *\n * Stores materialized views of resource state and annotations\n * Built from event streams, can be rebuilt at any time\n *\n * Stores both ResourceDescriptor metadata and ResourceAnnotations, but keeps them logically separate\n */\n\nimport { promises as fs } from 'fs';\nimport * as path from 'path';\nimport { getShardPath } from './shard-utils';\nimport type { SemiontProject } from '@semiont/core/node';\nimport type { components, ResourceAnnotations, ResourceId, Logger } from '@semiont/core';\n\ntype ResourceDescriptor = components['schemas']['ResourceDescriptor'];\n\n// Complete state for a resource in materialized view (metadata + annotations)\nexport interface ResourceView {\n resource: ResourceDescriptor;\n annotations: ResourceAnnotations;\n}\n\nexport interface ViewStorage {\n save(resourceId: ResourceId, view: ResourceView): Promise<void>;\n get(resourceId: ResourceId): Promise<ResourceView | null>;\n delete(resourceId: ResourceId): Promise<void>;\n exists(resourceId: ResourceId): Promise<boolean>;\n getAll(): Promise<ResourceView[]>;\n}\n\nexport class FilesystemViewStorage implements ViewStorage {\n private basePath: string;\n private logger?: Logger;\n\n constructor(project: SemiontProject, logger?: Logger) {\n this.logger = logger;\n this.basePath = project.stateDir;\n }\n\n private getProjectionPath(resourceId: ResourceId): string {\n // Use 4-hex Jump Consistent Hash sharding (65,536 shards)\n const [ab, cd] = getShardPath(resourceId);\n return path.join(this.basePath, 'resources', ab, cd, `${resourceId}.json`);\n }\n\n async save(resourceId: ResourceId, projection: ResourceView): Promise<void> {\n const projPath = this.getProjectionPath(resourceId);\n const projDir = path.dirname(projPath);\n\n // Ensure shard directory exists\n await fs.mkdir(projDir, { recursive: true });\n\n // Write projection to file\n await fs.writeFile(projPath, JSON.stringify(projection, null, 2), 'utf-8');\n }\n\n async get(resourceId: ResourceId): Promise<ResourceView | null> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n const content = await fs.readFile(projPath, 'utf-8');\n return JSON.parse(content) as ResourceView;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return null;\n }\n // Auto-delete corrupted view files (views are derived data, can be rebuilt from events)\n // This only handles JSON parsing errors, not broken event chains\n if (error instanceof SyntaxError) {\n this.logger?.error('[ViewStorage] Corrupted view file detected', { resourceId, error: error.message });\n this.logger?.error('[ViewStorage] Deleting corrupted view file', { path: projPath });\n try {\n await fs.unlink(projPath);\n } catch (unlinkError) {\n this.logger?.error('[ViewStorage] Failed to delete corrupted file', { error: unlinkError });\n }\n return null;\n }\n throw error;\n }\n }\n\n async delete(resourceId: ResourceId): Promise<void> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n await fs.unlink(projPath);\n } catch (error: any) {\n if (error.code !== 'ENOENT') {\n throw error;\n }\n // Ignore if file doesn't exist\n }\n }\n\n async exists(resourceId: ResourceId): Promise<boolean> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n await fs.access(projPath);\n return true;\n } catch {\n return false;\n }\n }\n\n async getAll(): Promise<ResourceView[]> {\n const views: ResourceView[] = [];\n const annotationsPath = path.join(this.basePath, 'resources');\n\n try {\n // Recursively walk through all shard directories\n const walkDir = async (dir: string): Promise<void> => {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n\n if (entry.isDirectory()) {\n await walkDir(fullPath);\n } else if (entry.isFile() && entry.name.endsWith('.json')) {\n try {\n const content = await fs.readFile(fullPath, 'utf-8');\n const view = JSON.parse(content) as ResourceView;\n views.push(view);\n } catch (error) {\n this.logger?.error('[ViewStorage] Failed to read view', { path: fullPath, error });\n // Skip invalid view files\n }\n }\n }\n };\n\n await walkDir(annotationsPath);\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n // Views directory doesn't exist yet\n return [];\n }\n throw error;\n }\n\n return views;\n }\n}","/**\n * Event Store Factory\n *\n * Factory function for creating EventStore instances with standard configuration.\n * This is the canonical way to instantiate an EventStore.\n */\n\nimport type { SemiontProject } from '@semiont/core/node';\nimport type { EventBus as CoreEventBus, Logger } from '@semiont/core';\nimport { EventStore } from './event-store';\nimport { FilesystemViewStorage } from './storage/view-storage';\nimport type { EventStorageConfig } from './storage/event-storage';\n\n/**\n * Create and initialize an EventStore instance\n *\n * @param config - Optional additional storage configuration\n * @param eventBus - Optional @semiont/core EventBus for publishing domain events\n * @param logger - Optional logger for structured logging\n * @returns Configured EventStore instance ready for use\n *\n * @example\n * ```typescript\n * const eventStore = createEventStore('/absolute/path/to/data');\n * await eventStore.appendEvent({\n * type: 'resource.created',\n * resourceId: 'doc-123',\n * userId: 'user-456',\n * version: 1,\n * payload: { name: 'My Document' }\n * });\n * ```\n */\nexport function createEventStore(\n project: SemiontProject,\n config?: Partial<EventStorageConfig>,\n eventBus?: CoreEventBus,\n logger?: Logger\n): EventStore {\n const viewStorage = new FilesystemViewStorage(project, logger?.child({ component: 'view-storage' }));\n\n return new EventStore(\n {\n ...config,\n dataDir: project.eventsDir,\n enableSharding: true,\n numShards: 65536, // 4 hex digits (0000-ffff)\n },\n project.stateDir,\n viewStorage,\n eventBus,\n logger\n );\n}\n","/**\n * Event Query - Read Operations\n *\n * Handles querying and reading events from storage:\n * - Query events with filters (type, user, timestamp, sequence)\n * - Get all events for a resource\n * - Get last event from a file\n * - Efficient streaming reads from JSONL files\n *\n * @see docs/EVENT-STORE.md#eventquery for architecture details\n */\n\nimport type { StoredEvent, EventQuery as EventQueryType, ResourceId } from '@semiont/core';\nimport type { EventStorage } from '../storage/event-storage';\n\n/**\n * EventQuery handles all read operations for events\n * Uses EventStorage for file access, adds query filtering\n */\nexport class EventQuery {\n constructor(private eventStorage: EventStorage) {}\n\n /**\n * Query events with filters\n * Supports filtering by: userId, eventTypes, timestamps, sequence number, limit\n */\n async queryEvents(query: EventQueryType): Promise<StoredEvent[]> {\n if (!query.resourceId) {\n throw new Error('resourceId is required for event queries');\n }\n\n // Get all events from storage\n const allEvents = await this.eventStorage.getAllEvents(query.resourceId);\n\n // Apply filters\n let results = allEvents;\n\n if (query.userId) {\n results = results.filter(e => e.event.userId === query.userId);\n }\n\n if (query.eventTypes && query.eventTypes.length > 0) {\n results = results.filter(e => query.eventTypes!.includes(e.event.type));\n }\n\n if (query.fromTimestamp) {\n results = results.filter(e => e.event.timestamp >= query.fromTimestamp!);\n }\n\n if (query.toTimestamp) {\n results = results.filter(e => e.event.timestamp <= query.toTimestamp!);\n }\n\n if (query.fromSequence) {\n results = results.filter(e => e.metadata.sequenceNumber >= query.fromSequence!);\n }\n\n // Apply limit\n if (query.limit && query.limit > 0) {\n results = results.slice(0, query.limit);\n }\n\n return results;\n }\n\n /**\n * Get all events for a specific resource (no filters)\n */\n async getResourceEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n return this.eventStorage.getAllEvents(resourceId);\n }\n\n /**\n * Get the last event from a specific file\n * Useful for initializing sequence numbers and last hashes\n */\n async getLastEvent(resourceId: ResourceId, filename: string): Promise<StoredEvent | null> {\n return this.eventStorage.getLastEvent(resourceId, filename);\n }\n\n /**\n * Get the latest event for a resource across all files\n */\n async getLatestEvent(resourceId: ResourceId): Promise<StoredEvent | null> {\n const files = await this.eventStorage.getEventFiles(resourceId);\n if (files.length === 0) return null;\n\n // Check files in reverse order (newest first)\n for (let i = files.length - 1; i >= 0; i--) {\n const file = files[i];\n if (!file) continue;\n const lastEvent = await this.eventStorage.getLastEvent(resourceId, file);\n if (lastEvent) return lastEvent;\n }\n\n return null;\n }\n\n /**\n * Get event count for a resource\n */\n async getEventCount(resourceId: ResourceId): Promise<number> {\n const events = await this.getResourceEvents(resourceId);\n return events.length;\n }\n\n /**\n * Check if a resource has any events\n */\n async hasEvents(resourceId: ResourceId): Promise<boolean> {\n const files = await this.eventStorage.getEventFiles(resourceId);\n return files.length > 0;\n }\n}\n","/**\n * Event Validator - Event Chain Integrity\n *\n * Validates event chain integrity using cryptographic hashing:\n * - prevEventHash links to previous event's checksum\n * - Each event's checksum is verified against its payload\n * - Detects broken chains and tampered events\n *\n * @see docs/EVENT-STORE.md#eventvalidator for architecture details\n */\n\nimport type { StoredEvent } from '@semiont/core';\nimport { sha256 } from '../storage/shard-utils';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: string[];\n}\n\n/**\n * EventValidator verifies event chain integrity\n * Uses cryptographic checksums to detect broken chains or tampering\n */\nexport class EventValidator {\n /**\n * Validate event chain integrity for a resource's events\n * Checks that each event properly links to the previous event\n */\n validateEventChain(events: StoredEvent[]): ValidationResult {\n const errors: string[] = [];\n\n for (let i = 1; i < events.length; i++) {\n const prev = events[i - 1];\n const curr = events[i];\n\n if (!prev || !curr) continue;\n\n // Check prevEventHash points to previous event\n if (curr.metadata.prevEventHash !== prev.metadata.checksum) {\n errors.push(\n `Event chain broken at sequence ${curr.metadata.sequenceNumber}: ` +\n `prevEventHash=${curr.metadata.prevEventHash} but previous checksum=${prev.metadata.checksum}`\n );\n }\n\n // Verify checksum of current event\n const calculated = sha256(curr.event);\n if (calculated !== curr.metadata.checksum) {\n errors.push(\n `Checksum mismatch at sequence ${curr.metadata.sequenceNumber}: ` +\n `calculated=${calculated} but stored=${curr.metadata.checksum}`\n );\n }\n }\n\n return {\n valid: errors.length === 0,\n errors,\n };\n }\n\n /**\n * Validate a single event's checksum\n * Useful for validating events before writing them\n */\n validateEventChecksum(event: StoredEvent): boolean {\n const calculated = sha256(event.event);\n return calculated === event.metadata.checksum;\n }\n\n /**\n * Validate that an event properly links to a previous event\n * Returns true if the link is valid or if this is the first event\n */\n validateEventLink(currentEvent: StoredEvent, previousEvent: StoredEvent | null): boolean {\n // First event in chain should have no prevEventHash\n if (!previousEvent) {\n return !currentEvent.metadata.prevEventHash;\n }\n\n // Subsequent events should link to previous event's checksum\n return currentEvent.metadata.prevEventHash === previousEvent.metadata.checksum;\n }\n}\n","/**\n * Identifier utilities for event sourcing\n */\n\nimport { nanoid } from 'nanoid';\n\n/**\n * Generate a unique annotation ID (bare nanoid)\n *\n * @returns A bare annotation ID (e.g., \"V1StGXR8_Z5jdHi6B-myT\")\n */\nexport function generateAnnotationId(): string {\n return nanoid(21);\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/storage/shard-utils.ts","../src/storage/event-storage.ts","../src/event-log.ts","../src/subscriptions/event-subscriptions.ts","../src/event-bus.ts","../src/storage/storage-uri-index.ts","../src/views/view-materializer.ts","../src/view-manager.ts","../src/event-store.ts","../src/storage/view-storage.ts","../src/event-store-factory.ts","../src/query/event-query.ts","../src/validation/event-validator.ts","../src/identifier-utils.ts"],"names":["fs","uuidv4","resourceId","makeResourceId","path","path3","path4"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Sharding Utilities\n *\n * Shared utilities for consistent sharding across all storage layers\n * Uses Google's Jump Consistent Hash algorithm for even distribution\n */\n\nimport { createHash } from 'crypto';\n\n/**\n * TEMPORARY: Simple modulo-based hash sharding\n *\n * ⚠️ TODO: Replace with proper Jump Consistent Hash implementation\n *\n * This is a TEMPORARY implementation using simple modulo. It works and provides\n * good distribution, but does NOT provide the minimal reshuffling property of\n * Jump Consistent Hash when changing bucket counts.\n *\n * The proper implementation should use Google's Jump Consistent Hash algorithm:\n * Reference: \"A Fast, Minimal Memory, Consistent Hash Algorithm\" by Lamping & Veach (2014)\n * https://arxiv.org/abs/1406.2294\n *\n * Working implementations exist in npm packages like:\n * - jumphash (https://www.npmjs.com/package/jumphash)\n * - jump-gouache (https://github.com/bhoudu/jump-gouache)\n *\n * The algorithm requires proper 64-bit integer handling with BigInt to avoid\n * precision loss in JavaScript. The previous attempt failed due to incorrect\n * BigInt arithmetic in the while loop condition.\n *\n * Until replaced, this modulo approach will cause ALL data to be reshuffled\n * if bucket count changes, rather than the optimal O(n/k) reshuffling that\n * Jump Consistent Hash provides.\n *\n * @param key - The key to hash (typically a resource ID)\n * @param numBuckets - Number of shards/buckets (default: 65536 for 4-hex sharding)\n * @returns Shard number (0 to numBuckets-1)\n */\nexport function jumpConsistentHash(key: string, numBuckets: number = 65536): number {\n const hash = hashToUint32(key);\n return hash % numBuckets;\n}\n\n/**\n * Hash string to 32-bit unsigned integer\n */\nfunction hashToUint32(str: string): number {\n let hash = 0;\n for (let i = 0; i < str.length; i++) {\n hash = ((hash << 5) - hash) + str.charCodeAt(i);\n hash = hash & 0xFFFFFFFF;\n }\n return Math.abs(hash);\n}\n\n/**\n * Convert shard number to 4-hex directory path (ab/cd)\n *\n * @param shardId - Shard number (0-65535)\n * @returns Path segments like ['ab', 'cd']\n */\nexport function shardIdToPath(shardId: number): [string, string] {\n if (shardId < 0 || shardId >= 65536) {\n throw new Error(`Invalid shard ID: ${shardId}. Must be 0-65535 for 4-hex sharding.`);\n }\n\n const shardHex = shardId.toString(16).padStart(4, '0');\n const ab = shardHex.substring(0, 2);\n const cd = shardHex.substring(2, 4);\n\n return [ab, cd];\n}\n\n/**\n * Get 4-hex shard path for a key\n *\n * @param key - The key to hash (typically a resource ID)\n * @param numBuckets - Number of shards (default: 65536)\n * @returns Path segments like ['ab', 'cd']\n */\nexport function getShardPath(key: string, numBuckets: number = 65536): [string, string] {\n const shardId = jumpConsistentHash(key, numBuckets);\n return shardIdToPath(shardId);\n}\n\n/**\n * Calculate SHA-256 hash of data\n */\nexport function sha256(data: string | object): string {\n const content = typeof data === 'string' ? data : JSON.stringify(data);\n return createHash('sha256').update(content).digest('hex');\n}","/**\n * Event Storage - Physical Storage Layer\n *\n * Handles file I/O operations for event storage:\n * - JSONL file writing/reading\n * - 4-hex sharding (65,536 shards)\n * - File rotation\n * - Event stream initialization\n *\n * @see docs/EVENT-STORE.md#eventstorage for architecture details\n */\n\nimport { promises as fs } from 'fs';\nimport { execFileSync } from 'child_process';\nimport * as path from 'path';\nimport { createReadStream } from 'fs';\nimport * as readline from 'readline';\nimport { v4 as uuidv4 } from 'uuid';\nimport type { StoredEvent, ResourceEvent, EventMetadata, ResourceId, Logger } from '@semiont/core';\nimport { resourceId as makeResourceId } from '@semiont/core';\nimport type { SemiontProject } from '@semiont/core/node';\nimport { jumpConsistentHash, sha256 } from './shard-utils';\n\nexport interface EventStorageConfig {\n maxEventsPerFile?: number; // File rotation threshold (default: 10000)\n enableSharding?: boolean; // Enable 4-hex sharding (default: true)\n numShards?: number; // Number of shards (default: 65536)\n enableCompression?: boolean; // Gzip rotated files (default: true)\n}\n\n/**\n * EventStorage handles physical storage of events\n * Owns: file I/O, sharding, AND sequence/hash tracking\n */\nexport class EventStorage {\n private config: Required<EventStorageConfig>;\n private project: SemiontProject;\n private logger?: Logger;\n\n // Per-resource sequence tracking: resourceId -> sequence number\n private resourceSequences: Map<string, number> = new Map();\n // Per-resource last event hash: resourceId -> hash\n private resourceLastHash: Map<string, string> = new Map();\n // Per-resource current file cache: avoids fs.readdir() + countEventsInFile() on every append\n private currentFiles: Map<string, { path: string; eventCount: number }> = new Map();\n\n constructor(project: SemiontProject, config?: EventStorageConfig, logger?: Logger) {\n this.project = project;\n this.logger = logger;\n this.config = {\n maxEventsPerFile: config?.maxEventsPerFile || 10000,\n enableSharding: config?.enableSharding ?? true,\n numShards: config?.numShards || 65536,\n enableCompression: config?.enableCompression ?? true,\n };\n }\n\n /**\n * Calculate shard path for a resource ID\n * Uses jump consistent hash for uniform distribution\n * Special case: __system__ events bypass sharding\n */\n getShardPath(resourceId: ResourceId): string {\n // System events don't get sharded\n if (resourceId === '__system__' || !this.config.enableSharding) {\n return '';\n }\n\n // Jump consistent hash for uniform shard distribution\n const shardIndex = jumpConsistentHash(resourceId, this.config.numShards);\n\n // Convert to 4-hex format (e.g., 0000, 0001, ..., ffff)\n const hex = shardIndex.toString(16).padStart(4, '0');\n const [ab, cd] = [hex.substring(0, 2), hex.substring(2, 4)];\n\n return path.join(ab, cd);\n }\n\n /**\n * Get full path to resource's event directory\n */\n getResourcePath(resourceId: ResourceId): string {\n const shardPath = this.getShardPath(resourceId);\n return path.join(this.project.eventsDir, shardPath, resourceId);\n }\n\n /**\n * Initialize directory structure for a resource's event stream\n * Also loads sequence number and last hash if stream exists\n */\n async initializeResourceStream(resourceId: ResourceId): Promise<void> {\n const docPath = this.getResourcePath(resourceId);\n\n // Check if already initialized\n let exists = false;\n try {\n await fs.access(docPath);\n exists = true;\n } catch {\n // Doesn't exist, create it\n }\n\n if (!exists) {\n // Create directory structure\n await fs.mkdir(docPath, { recursive: true });\n\n // Create initial empty events file\n const filename = this.createEventFilename(1);\n const filePath = path.join(docPath, filename);\n await fs.writeFile(filePath, '', 'utf-8');\n\n // Stage the new event stream directory in git\n if (this.project.gitSync) {\n execFileSync('git', ['add', docPath], { cwd: this.project.root });\n }\n\n // Initialize sequence number\n this.resourceSequences.set(resourceId, 0);\n\n this.logger?.info('[EventStorage] Initialized event stream', { resourceId, path: docPath });\n } else {\n // Load existing sequence number and last hash\n const files = await this.getEventFiles(resourceId);\n if (files.length > 0) {\n const lastFile = files[files.length - 1];\n if (lastFile) {\n const lastEvent = await this.getLastEvent(resourceId, lastFile);\n if (lastEvent) {\n this.resourceSequences.set(resourceId, lastEvent.metadata.sequenceNumber);\n if (lastEvent.metadata.checksum) {\n this.resourceLastHash.set(resourceId, lastEvent.metadata.checksum);\n }\n }\n }\n } else {\n this.resourceSequences.set(resourceId, 0);\n }\n }\n }\n\n /**\n * Append an event - handles EVERYTHING for event creation\n * Creates ID, timestamp, metadata, checksum, sequence tracking, and writes to disk\n */\n async appendEvent(event: Omit<ResourceEvent, 'id' | 'timestamp'>, resourceId: ResourceId): Promise<StoredEvent> {\n // Ensure resource stream is initialized\n if (this.getSequenceNumber(resourceId) === 0) {\n await this.initializeResourceStream(resourceId);\n }\n\n // Create complete event with ID and timestamp\n const completeEvent: ResourceEvent = {\n ...event,\n id: uuidv4(),\n timestamp: new Date().toISOString(),\n } as ResourceEvent;\n\n // Calculate metadata\n const sequenceNumber = this.getNextSequenceNumber(resourceId);\n const prevEventHash = this.getLastEventHash(resourceId);\n\n const metadata: EventMetadata = {\n sequenceNumber,\n streamPosition: 0, // Will be set during write\n timestamp: new Date().toISOString(),\n prevEventHash: prevEventHash || undefined,\n checksum: sha256(completeEvent),\n };\n\n const storedEvent: StoredEvent = {\n event: completeEvent,\n metadata,\n };\n\n // Write to disk\n await this.writeEvent(storedEvent, resourceId);\n\n // Update last hash\n this.setLastEventHash(resourceId, metadata.checksum!);\n\n return storedEvent;\n }\n\n /**\n * Write an event to storage (append to JSONL)\n * Internal method - use appendEvent() instead\n *\n * Uses currentFiles cache to avoid fs.readdir() + countEventsInFile() on every append.\n * Cache is populated on first append (cold start) and updated on rotation.\n */\n private async writeEvent(event: StoredEvent, resourceId: ResourceId): Promise<void> {\n const docPath = this.getResourcePath(resourceId);\n let current = this.currentFiles.get(resourceId);\n\n if (!current) {\n // Cold start: read from disk once\n const files = await this.getEventFiles(resourceId);\n const lastFile = files[files.length - 1];\n if (lastFile) {\n const count = await this.countEventsInFile(resourceId, lastFile);\n current = { path: lastFile, eventCount: count };\n } else {\n const newFile = await this.createNewEventFile(resourceId);\n current = { path: newFile, eventCount: 0 };\n }\n this.currentFiles.set(resourceId, current);\n }\n\n if (current.eventCount >= this.config.maxEventsPerFile) {\n const newFile = await this.createNewEventFile(resourceId);\n current = { path: newFile, eventCount: 0 };\n this.currentFiles.set(resourceId, current);\n }\n\n // Append event to file (JSONL format)\n const targetPath = path.join(docPath, current.path);\n const eventLine = JSON.stringify(event) + '\\n';\n await fs.appendFile(targetPath, eventLine, 'utf-8');\n current.eventCount++;\n\n // Stage the event log file in git index if configured\n if (this.project.gitSync) {\n execFileSync('git', ['add', targetPath], { cwd: this.project.root });\n }\n }\n\n /**\n * Count events in a specific file\n */\n async countEventsInFile(resourceId: ResourceId, filename: string): Promise<number> {\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n try {\n const content = await fs.readFile(filePath, 'utf-8');\n const lines = content.trim().split('\\n').filter(line => line.trim() !== '');\n return lines.length;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return 0;\n }\n throw error;\n }\n }\n\n /**\n * Read all events from a specific file\n */\n async readEventsFromFile(resourceId: ResourceId, filename: string): Promise<StoredEvent[]> {\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n const events: StoredEvent[] = [];\n\n try {\n const fileStream = createReadStream(filePath, { encoding: 'utf-8' });\n const rl = readline.createInterface({\n input: fileStream,\n crlfDelay: Infinity,\n });\n\n for await (const line of rl) {\n const trimmed = line.trim();\n if (trimmed === '') continue;\n\n try {\n const event = JSON.parse(trimmed) as StoredEvent;\n events.push(event);\n } catch (parseError) {\n this.logger?.error('[EventStorage] Failed to parse event', { filePath, error: parseError });\n // Skip malformed lines\n }\n }\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return []; // File doesn't exist\n }\n throw error;\n }\n\n return events;\n }\n\n /**\n * Get list of event files for a resource (sorted by sequence)\n */\n async getEventFiles(resourceId: ResourceId): Promise<string[]> {\n const docPath = this.getResourcePath(makeResourceId(resourceId));\n\n try {\n const files = await fs.readdir(docPath);\n\n // Filter to .jsonl files and sort by sequence number\n const eventFiles = files\n .filter(f => f.startsWith('events-') && f.endsWith('.jsonl'))\n .sort((a, b) => {\n const seqA = parseInt(a.match(/events-(\\d+)\\.jsonl/)?.[1] || '0');\n const seqB = parseInt(b.match(/events-(\\d+)\\.jsonl/)?.[1] || '0');\n return seqA - seqB;\n });\n\n return eventFiles;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return []; // Directory doesn't exist\n }\n throw error;\n }\n }\n\n /**\n * Create a new event file for rotation\n */\n async createNewEventFile(resourceId: ResourceId): Promise<string> {\n const files = await this.getEventFiles(resourceId);\n\n // Determine next sequence number\n const lastFile = files[files.length - 1];\n const lastSeq = lastFile ? parseInt(lastFile.match(/events-(\\d+)\\.jsonl/)?.[1] || '1') : 1;\n const newSeq = lastSeq + 1;\n\n // Create new file\n const filename = this.createEventFilename(newSeq);\n const docPath = this.getResourcePath(resourceId);\n const filePath = path.join(docPath, filename);\n\n await fs.writeFile(filePath, '', 'utf-8');\n\n this.logger?.info('[EventStorage] Created new event file', { filename, resourceId });\n\n return filename;\n }\n\n /**\n * Get the last event from a specific file\n */\n async getLastEvent(resourceId: ResourceId, filename: string): Promise<StoredEvent | null> {\n const events = await this.readEventsFromFile(resourceId, filename);\n const lastEvent = events.length > 0 ? events[events.length - 1] : undefined;\n return lastEvent ?? null;\n }\n\n /**\n * Get all events for a resource across all files\n */\n async getAllEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n const files = await this.getEventFiles(resourceId);\n const allEvents: StoredEvent[] = [];\n\n for (const file of files) {\n const events = await this.readEventsFromFile(resourceId, file);\n allEvents.push(...events);\n }\n\n return allEvents;\n }\n\n /**\n * Get all resource IDs by scanning shard directories\n */\n async getAllResourceIds(): Promise<ResourceId[]> {\n const eventsDir = this.project.eventsDir;\n const resourceIds: ResourceId[] = [];\n\n try {\n await fs.access(eventsDir);\n } catch {\n return []; // No events directory yet\n }\n\n // Recursively scan shard directories\n const scanDir = async (dir: string) => {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n\n if (entry.isDirectory()) {\n // Check if this looks like a resource ID (not a shard directory)\n // Shard directories are 2-char hex (00-ff), resource IDs are longer\n if (entry.name.length > 2) {\n resourceIds.push(makeResourceId(entry.name));\n } else {\n // Recurse into shard directory\n await scanDir(fullPath);\n }\n }\n }\n };\n\n await scanDir(eventsDir);\n return resourceIds;\n }\n\n /**\n * Create filename for event file\n */\n private createEventFilename(sequenceNumber: number): string {\n return `events-${sequenceNumber.toString().padStart(6, '0')}.jsonl`;\n }\n\n // ============================================================\n // Sequence/Hash Tracking\n // ============================================================\n\n /**\n * Get current sequence number for a resource\n */\n getSequenceNumber(resourceId: ResourceId): number {\n return this.resourceSequences.get(resourceId) || 0;\n }\n\n /**\n * Increment and return next sequence number for a resource\n */\n getNextSequenceNumber(resourceId: ResourceId): number {\n const current = this.getSequenceNumber(resourceId);\n const next = current + 1;\n this.resourceSequences.set(resourceId, next);\n return next;\n }\n\n /**\n * Get last event hash for a resource\n */\n getLastEventHash(resourceId: ResourceId): string | null {\n return this.resourceLastHash.get(resourceId) || null;\n }\n\n /**\n * Set last event hash for a resource\n */\n setLastEventHash(resourceId: ResourceId, hash: string): void {\n this.resourceLastHash.set(resourceId, hash);\n }\n}\n","/**\n * EventLog - Event Persistence Layer\n *\n * Single Responsibility: Event persistence only\n * - Appends events to storage (JSONL files)\n * - Retrieves events by resource\n * - Queries events with filters\n *\n * Does NOT handle:\n * - Pub/sub notifications (see EventBus)\n * - View updates (see ViewManager)\n */\n\nimport { type ResourceId, type StoredEvent, type ResourceEvent, type EventQuery, type Logger } from '@semiont/core';\nimport type { SemiontProject } from '@semiont/core/node';\nimport { EventStorage } from './storage/event-storage';\n\nexport interface EventLogConfig {\n project: SemiontProject;\n enableSharding?: boolean;\n maxEventsPerFile?: number;\n}\n\nexport class EventLog {\n // Expose storage for EventQuery (read operations)\n readonly storage: EventStorage;\n\n constructor(config: EventLogConfig, logger?: Logger) {\n this.storage = new EventStorage(config.project, {\n enableSharding: config.enableSharding,\n maxEventsPerFile: config.maxEventsPerFile,\n }, logger?.child({ component: 'EventStorage' }));\n }\n\n /**\n * Append event to log\n * @param event - Resource event (from @semiont/core)\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @returns Stored event with metadata (sequence number, timestamp, checksum)\n */\n async append(event: Omit<ResourceEvent, 'id' | 'timestamp'>, resourceId: ResourceId): Promise<StoredEvent> {\n return this.storage.appendEvent(event, resourceId);\n }\n\n /**\n * Get all events for a resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n */\n async getEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n return this.storage.getAllEvents(resourceId);\n }\n\n /**\n * Get all resource IDs\n * @returns Array of branded ResourceId types\n */\n async getAllResourceIds(): Promise<ResourceId[]> {\n return this.storage.getAllResourceIds();\n }\n\n /**\n * Query events with filter\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param filter - Optional event filter\n */\n async queryEvents(resourceId: ResourceId, filter?: EventQuery): Promise<StoredEvent[]> {\n const events = await this.storage.getAllEvents(resourceId);\n if (!filter) return events;\n\n return events.filter(e => {\n if (filter.eventTypes && !filter.eventTypes.includes(e.event.type as any)) return false;\n if (filter.fromSequence && e.metadata.sequenceNumber < filter.fromSequence) return false;\n if (filter.fromTimestamp && e.event.timestamp < filter.fromTimestamp) return false;\n if (filter.toTimestamp && e.event.timestamp > filter.toTimestamp) return false;\n if (filter.userId && e.event.userId !== filter.userId) return false;\n return true;\n });\n }\n}\n","/**\n * Event Subscriptions - Real-time Event Pub/Sub\n *\n * Manages subscriptions for both resource-scoped and system-level events:\n * - Resource subscriptions: notifications for a specific resource's events\n * - Global subscriptions: notifications for all system-level events\n * - Fire-and-forget notification pattern (non-blocking)\n * - Automatic cleanup of empty subscription sets\n *\n * SINGLETON PATTERN: All EventStore instances share the same EventSubscriptions\n * to ensure SSE connections receive events from any EventStore instance.\n *\n * @see docs/EVENT-STORE.md#eventsubscriptions for architecture details\n */\n\nimport type { StoredEvent, ResourceId, Logger } from '@semiont/core';\n\nexport type EventCallback = (event: StoredEvent) => void | Promise<void>;\n\nexport interface EventSubscription {\n resourceId: ResourceId;\n callback: EventCallback;\n unsubscribe: () => void;\n}\n\n/**\n * EventSubscriptions manages real-time event pub/sub\n * Supports both resource-scoped and global subscriptions\n */\nexport class EventSubscriptions {\n // Per-resource subscriptions: ResourceId -> Set of callbacks\n private subscriptions: Map<ResourceId, Set<EventCallback>> = new Map();\n // Global subscriptions for system-level events (no resourceId)\n private globalSubscriptions: Set<EventCallback> = new Set();\n private logger?: Logger;\n\n constructor(logger?: Logger) {\n this.logger = logger;\n }\n\n /**\n * Subscribe to events for a specific resource\n * Returns an EventSubscription with unsubscribe function\n */\n subscribe(resourceId: ResourceId, callback: EventCallback): EventSubscription {\n if (!this.subscriptions.has(resourceId)) {\n this.subscriptions.set(resourceId, new Set());\n }\n\n const callbacks = this.subscriptions.get(resourceId)!;\n callbacks.add(callback);\n\n this.logger?.info('[EventSubscriptions] Subscription added for resource', { resourceId, totalSubscribers: callbacks.size });\n\n return {\n resourceId,\n callback,\n unsubscribe: () => {\n callbacks.delete(callback);\n this.logger?.info('[EventSubscriptions] Subscription removed for resource', { resourceId, remainingSubscribers: callbacks.size });\n if (callbacks.size === 0) {\n this.subscriptions.delete(resourceId);\n this.logger?.info('[EventSubscriptions] No more subscribers for resource, removed from subscriptions map', { resourceId });\n }\n }\n };\n }\n\n /**\n * Subscribe to all system-level events (no resourceId)\n * Returns an EventSubscription with unsubscribe function\n *\n * Use this for consumers that need to react to global events like:\n * - entitytype.added (global entity type collection changes)\n * - Future system-level events (user.created, workspace.created, etc.)\n */\n subscribeGlobal(callback: EventCallback): EventSubscription {\n this.globalSubscriptions.add(callback);\n\n this.logger?.info('[EventSubscriptions] Global subscription added', { totalSubscribers: this.globalSubscriptions.size });\n\n return {\n resourceId: '__global__' as ResourceId, // Special marker for global subscriptions\n callback,\n unsubscribe: () => {\n this.globalSubscriptions.delete(callback);\n this.logger?.info('[EventSubscriptions] Global subscription removed', { remainingSubscribers: this.globalSubscriptions.size });\n }\n };\n }\n\n /**\n * Notify all subscribers for a resource when a new event is appended\n * @param resourceId - Bare resource ID\n */\n async notifySubscribers(resourceId: ResourceId, event: StoredEvent): Promise<void> {\n const callbacks = this.subscriptions.get(resourceId);\n if (!callbacks || callbacks.size === 0) {\n this.logger?.info('[EventSubscriptions] Event - no subscribers to notify', { eventType: event.event.type, resourceId });\n return;\n }\n\n this.logger?.info('[EventSubscriptions] Notifying subscribers of event', { subscriberCount: callbacks.size, eventType: event.event.type, resourceId });\n\n // Call all callbacks without waiting - fire and forget\n // Each callback handles its own errors and cleanup\n // This prevents slow/hanging callbacks from blocking event emission\n Array.from(callbacks).forEach((callback, index) => {\n Promise.resolve(callback(event))\n .then(() => {\n this.logger?.info('[EventSubscriptions] Subscriber successfully notified', { subscriberIndex: index + 1, eventType: event.event.type });\n })\n .catch((error: unknown) => {\n this.logger?.error('[EventSubscriptions] Error in subscriber', { subscriberIndex: index + 1, resourceId, eventType: event.event.type, error });\n });\n });\n }\n\n /**\n * Notify all global subscribers when a system-level event is appended\n */\n async notifyGlobalSubscribers(event: StoredEvent): Promise<void> {\n if (this.globalSubscriptions.size === 0) {\n this.logger?.info('[EventSubscriptions] System event - no global subscribers to notify', { eventType: event.event.type });\n return;\n }\n\n this.logger?.info('[EventSubscriptions] Notifying global subscribers of system event', { subscriberCount: this.globalSubscriptions.size, eventType: event.event.type });\n\n // Call all global callbacks without waiting - fire and forget\n // Each callback handles its own errors and cleanup\n // This prevents slow/hanging callbacks from blocking event emission\n Array.from(this.globalSubscriptions).forEach((callback, index) => {\n Promise.resolve(callback(event))\n .then(() => {\n this.logger?.info('[EventSubscriptions] Global subscriber successfully notified', { subscriberIndex: index + 1, eventType: event.event.type });\n })\n .catch((error: unknown) => {\n this.logger?.error('[EventSubscriptions] Error in global subscriber', { subscriberIndex: index + 1, eventType: event.event.type, error });\n });\n });\n }\n\n /**\n * Get subscription count for a resource (useful for debugging)\n */\n getSubscriptionCount(resourceId: ResourceId): number {\n return this.subscriptions.get(resourceId)?.size || 0;\n }\n\n /**\n * Get total number of active subscriptions across all resources\n */\n getTotalSubscriptions(): number {\n let total = 0;\n for (const callbacks of this.subscriptions.values()) {\n total += callbacks.size;\n }\n return total;\n }\n\n /**\n * Get total number of global subscriptions\n */\n getGlobalSubscriptionCount(): number {\n return this.globalSubscriptions.size;\n }\n}\n\n// Singleton instance - shared across all EventStore instances\n// This ensures SSE connections receive events from any EventStore instance\nlet globalEventSubscriptions: EventSubscriptions | null = null;\n\nexport function getEventSubscriptions(logger?: Logger): EventSubscriptions {\n if (!globalEventSubscriptions) {\n globalEventSubscriptions = new EventSubscriptions(logger);\n logger?.info('[EventSubscriptions] Created global singleton instance');\n }\n return globalEventSubscriptions;\n}\n","/**\n * EventBus - Event Pub/Sub Layer\n *\n * Single Responsibility: Event pub/sub only\n * - Publishes events to subscribers\n * - Manages subscriptions (resource-scoped and global)\n *\n * Does NOT handle:\n * - Event persistence (see EventLog)\n * - View updates (see ViewManager)\n */\n\nimport { type StoredEvent, type ResourceId, resourceId as makeResourceId, isResourceEvent, isSystemEvent, type Logger } from '@semiont/core';\nimport { getEventSubscriptions, type EventSubscriptions, type EventCallback, type EventSubscription } from './subscriptions/event-subscriptions';\n\n/**\n * EventBus wraps EventSubscriptions with a clean API\n * Uses bare ResourceId for subscriptions\n */\nexport class EventBus {\n // Expose subscriptions for direct access\n readonly subscriptions: EventSubscriptions;\n private logger?: Logger;\n\n constructor(logger?: Logger) {\n this.logger = logger;\n // Use global singleton EventSubscriptions to ensure all EventBus instances\n // share the same subscription registry (critical for SSE real-time events)\n this.subscriptions = getEventSubscriptions(logger?.child({ component: 'EventSubscriptions' }));\n }\n\n /**\n * Publish event to subscribers\n * - Resource events: notifies BOTH resource-scoped AND global subscribers\n * - System events: notifies global subscribers only\n * @param event - Stored event (from @semiont/core)\n */\n async publish(event: StoredEvent): Promise<void> {\n if (isSystemEvent(event.event)) {\n // System-level event - notify global subscribers\n await this.subscriptions.notifyGlobalSubscribers(event);\n } else if (isResourceEvent(event.event)) {\n // Resource event - notify BOTH resource-scoped AND global subscribers\n // This enables projections (graph, search, etc.) to use global subscription\n const rid = makeResourceId(event.event.resourceId as string);\n await this.subscriptions.notifySubscribers(rid, event);\n await this.subscriptions.notifyGlobalSubscribers(event);\n } else {\n // Shouldn't happen - events should be either resource or system\n this.logger?.warn('[EventBus] Event is neither resource nor system event', { eventType: (event.event as any).type });\n }\n }\n\n /**\n * Subscribe to events for a specific resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param callback - Event callback function\n * @returns EventSubscription with unsubscribe function\n */\n subscribe(resourceId: ResourceId, callback: EventCallback): EventSubscription {\n return this.subscriptions.subscribe(resourceId, callback);\n }\n\n /**\n * Subscribe to all system-level events\n * @param callback - Event callback function\n * @returns EventSubscription with unsubscribe function\n */\n subscribeGlobal(callback: EventCallback): EventSubscription {\n return this.subscriptions.subscribeGlobal(callback);\n }\n\n /**\n * Unsubscribe from resource events\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param callback - Event callback function to remove\n */\n unsubscribe(resourceId: ResourceId, callback: EventCallback): void {\n const callbacks = (this.subscriptions as any).subscriptions.get(resourceId);\n if (callbacks) {\n callbacks.delete(callback);\n if (callbacks.size === 0) {\n (this.subscriptions as any).subscriptions.delete(resourceId);\n }\n }\n }\n\n /**\n * Unsubscribe from global events\n * @param callback - Event callback function to remove\n */\n unsubscribeGlobal(callback: EventCallback): void {\n (this.subscriptions as any).globalSubscriptions.delete(callback);\n }\n\n /**\n * Get subscriber count for a resource\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @returns Number of active subscribers\n */\n getSubscriberCount(resourceId: ResourceId): number {\n return this.subscriptions.getSubscriptionCount(resourceId);\n }\n\n /**\n * Get total number of active subscriptions across all resources\n */\n getTotalSubscriptions(): number {\n return this.subscriptions.getTotalSubscriptions();\n }\n\n /**\n * Get total number of global subscriptions\n */\n getGlobalSubscriptionCount(): number {\n return this.subscriptions.getGlobalSubscriptionCount();\n }\n}\n","/**\n * Storage URI Index\n *\n * Projection that maps file:// URIs → resourceIds.\n * Sharded at:\n * {projectionsDir}/storage-uri/{ab}/{cd}/{uri-hash}.json\n *\n * where {ab}/{cd} comes from jumpConsistentHash(uri) and\n * {uri-hash} is the SHA-256 of the URI string.\n *\n * Each file contains: { uri: string; resourceId: string }\n *\n * This index is maintained by ViewMaterializer (the single owner).\n * It is never modified by Stower or other actors.\n *\n * Archive/unarchive do NOT remove entries from this index.\n * Archived resources are marked in the ResourceView (archived: true)\n * but remain findable by URI.\n */\n\nimport { promises as fs } from 'fs';\nimport path from 'path';\nimport { getShardPath, sha256 } from './shard-utils';\n\nexport interface StorageUriEntry {\n uri: string;\n resourceId: string;\n}\n\n/**\n * Thrown when a URI is not found in the storage-uri index.\n */\nexport class ResourceNotFoundError extends Error {\n constructor(readonly uri: string) {\n super(`No resource found for URI: ${uri}`);\n this.name = 'ResourceNotFoundError';\n }\n}\n\n/**\n * Resolve a file:// URI to a resourceId using the storage-uri index.\n *\n * @param projectionsDir - Path to the projections directory\n * @param uri - file:// URI (e.g. \"file://docs/overview.md\")\n * @returns resourceId\n * @throws ResourceNotFoundError if URI is not in the index\n */\nexport async function resolveStorageUri(\n projectionsDir: string,\n uri: string,\n): Promise<string> {\n const entryPath = uriIndexPath(projectionsDir, uri);\n try {\n const raw = await fs.readFile(entryPath, 'utf-8');\n const entry: StorageUriEntry = JSON.parse(raw);\n return entry.resourceId;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n throw new ResourceNotFoundError(uri);\n }\n throw error;\n }\n}\n\n/**\n * Write a URI → resourceId mapping to the index.\n *\n * Called by ViewMaterializer when handling resource.created, resource.moved.\n *\n * @param projectionsDir - Path to the projections directory\n * @param uri - file:// URI\n * @param resourceId - resourceId to map to\n */\nexport async function writeStorageUriEntry(\n projectionsDir: string,\n uri: string,\n resourceId: string,\n): Promise<void> {\n const entryPath = uriIndexPath(projectionsDir, uri);\n await fs.mkdir(path.dirname(entryPath), { recursive: true });\n const entry: StorageUriEntry = { uri, resourceId };\n await fs.writeFile(entryPath, JSON.stringify(entry, null, 2));\n}\n\n/**\n * Remove a URI entry from the index.\n *\n * Called by ViewMaterializer when handling resource.moved (old URI only).\n * NOT called on resource.archived — archived resources retain their index entry.\n *\n * @param projectionsDir - Path to the projections directory\n * @param uri - file:// URI to remove\n */\nexport async function removeStorageUriEntry(\n projectionsDir: string,\n uri: string,\n): Promise<void> {\n const entryPath = uriIndexPath(projectionsDir, uri);\n try {\n await fs.unlink(entryPath);\n } catch (error: any) {\n if (error.code !== 'ENOENT') {\n throw error;\n }\n }\n}\n\n/**\n * Compute the filesystem path for a URI index entry.\n */\nfunction uriIndexPath(projectionsDir: string, uri: string): string {\n const uriHash = sha256(uri);\n const [ab, cd] = getShardPath(uri);\n return path.join(projectionsDir, 'storage-uri', ab, cd, `${uriHash}.json`);\n}\n","/**\n * View Materializer - Materialized View Management\n *\n * Materializes resource views from events:\n * - Full view materialization from scratch\n * - Incremental view updates\n * - System-level views (entity types)\n *\n * @see docs/EVENT-STORE.md#viewmaterializer for architecture details\n */\n\nimport { promises as fs } from 'fs';\nimport * as path from 'path';\nimport { didToAgent } from '@semiont/core';\nimport type { components } from '@semiont/core';\n\ntype Representation = components['schemas']['Representation'];\ntype Annotation = components['schemas']['Annotation'];\ntype ResourceDescriptor = components['schemas']['ResourceDescriptor'];\n\nimport type {\n ResourceEvent,\n StoredEvent,\n ResourceAnnotations,\n ResourceId,\n Logger,\n} from '@semiont/core';\nimport { findBodyItem } from '@semiont/core';\nimport type { ViewStorage, ResourceView } from '../storage/view-storage';\nimport { writeStorageUriEntry, removeStorageUriEntry } from '../storage/storage-uri-index';\n\nexport interface ViewMaterializerConfig {\n basePath: string;\n}\n\n/**\n * ViewMaterializer builds and maintains materialized views from events\n */\nexport class ViewMaterializer {\n private logger?: Logger;\n\n constructor(\n private viewStorage: ViewStorage,\n private config: ViewMaterializerConfig,\n logger?: Logger\n ) {\n this.logger = logger;\n }\n\n /**\n * Materialize resource view from events\n * Loads existing view if cached, otherwise rebuilds from events\n */\n async materialize(events: StoredEvent[], resourceId: ResourceId): Promise<ResourceView | null> {\n // Try to load existing view\n const existing = await this.viewStorage.get(resourceId);\n if (existing) {\n return existing;\n }\n\n // No view exists - rebuild from events\n if (events.length === 0) return null;\n\n const view = this.materializeFromEvents(events, resourceId);\n\n // Save rebuilt view\n await this.viewStorage.save(resourceId, view);\n\n return view;\n }\n\n /**\n * Materialize view incrementally with a single event\n * Falls back to full rebuild if view doesn't exist\n */\n async materializeIncremental(\n resourceId: ResourceId,\n event: ResourceEvent,\n getAllEvents: () => Promise<StoredEvent[]>\n ): Promise<void> {\n this.logger?.info('[ViewMaterializer] Updating view for resource with event', { resourceId, eventType: event.type });\n\n // Try to load existing view\n let view = await this.viewStorage.get(resourceId);\n\n if (!view) {\n // No view exists - do full rebuild from all events\n this.logger?.info('[ViewMaterializer] No view found, rebuilding from scratch', { resourceId });\n const events = await getAllEvents();\n view = this.materializeFromEvents(events, resourceId);\n } else {\n // Apply single event incrementally to existing view\n this.logger?.info('[ViewMaterializer] Applying event incrementally to existing view', { resourceId, version: view.annotations.version });\n this.applyEventToResource(view.resource, event);\n this.applyEventToAnnotations(view.annotations, event);\n view.annotations.version++;\n view.annotations.updatedAt = event.timestamp;\n }\n\n // Save updated view\n await this.viewStorage.save(resourceId, view);\n this.logger?.info('[ViewMaterializer] View saved', { resourceId, version: view.annotations.version, annotationCount: view.annotations.annotations.length });\n\n // Update storage-uri index for URI-bearing events\n await this.materializeStorageUriIndex(resourceId, event);\n }\n\n /**\n * Update the storage-uri index in response to an event.\n *\n * Only resource.created (with storageUri), resource.moved, need index changes.\n * resource.archived / resource.unarchived do NOT modify the index.\n */\n private async materializeStorageUriIndex(resourceId: ResourceId, event: ResourceEvent): Promise<void> {\n const projectionsDir = path.join(this.config.basePath, 'projections');\n\n if (event.type === 'resource.created' && event.payload.storageUri) {\n await writeStorageUriEntry(projectionsDir, event.payload.storageUri, resourceId as string);\n } else if (event.type === 'resource.moved') {\n // Remove old URI, add new URI\n await removeStorageUriEntry(projectionsDir, event.payload.fromUri);\n await writeStorageUriEntry(projectionsDir, event.payload.toUri, resourceId as string);\n }\n }\n\n /**\n * Materialize view from event list (full rebuild)\n */\n private materializeFromEvents(events: StoredEvent[], resourceId: ResourceId): ResourceView {\n // Start with empty ResourceDescriptor state\n // @id uses bare resource ID; full URI is constructed at the API boundary\n const resource: ResourceDescriptor = {\n '@context': 'https://schema.org/',\n '@id': resourceId as string,\n name: '',\n representations: [],\n archived: false,\n entityTypes: [],\n creationMethod: 'api',\n };\n\n // Start with empty annotations\n const annotations: ResourceAnnotations = {\n resourceId,\n annotations: [],\n version: 0,\n updatedAt: '',\n };\n\n // Apply events in sequenceNumber order\n events.sort((a, b) => a.metadata.sequenceNumber - b.metadata.sequenceNumber);\n\n for (const storedEvent of events) {\n this.applyEventToResource(resource, storedEvent.event);\n this.applyEventToAnnotations(annotations, storedEvent.event);\n annotations.version++;\n annotations.updatedAt = storedEvent.event.timestamp;\n }\n\n return { resource, annotations };\n }\n\n /**\n * Apply an event to ResourceDescriptor state (metadata only)\n */\n private applyEventToResource(resource: ResourceDescriptor, event: ResourceEvent): void {\n switch (event.type) {\n case 'resource.created':\n resource.name = event.payload.name;\n resource.entityTypes = event.payload.entityTypes || [];\n resource.dateCreated = event.timestamp;\n resource.creationMethod = event.payload.creationMethod || 'api';\n resource.wasAttributedTo = didToAgent(event.userId);\n\n // Create representation from format and checksum\n if (!resource.representations) resource.representations = [];\n const reps = Array.isArray(resource.representations) ? resource.representations : [resource.representations];\n reps.push({\n mediaType: event.payload.format,\n checksum: event.payload.contentChecksum,\n byteSize: event.payload.contentByteSize,\n rel: 'original',\n language: event.payload.language,\n } as Representation);\n resource.representations = reps;\n\n // First-class fields\n resource.isDraft = event.payload.isDraft;\n resource.wasDerivedFrom = event.payload.generatedFrom;\n\n // Working-tree URI and current checksum\n if (event.payload.storageUri) {\n resource.storageUri = event.payload.storageUri;\n }\n resource.currentChecksum = event.payload.contentChecksum;\n break;\n\n case 'resource.cloned':\n resource.name = event.payload.name;\n resource.entityTypes = event.payload.entityTypes || [];\n resource.dateCreated = event.timestamp;\n resource.creationMethod = 'clone';\n resource.sourceResourceId = event.payload.parentResourceId;\n resource.wasAttributedTo = didToAgent(event.userId);\n\n // Create representation from format and checksum\n if (!resource.representations) resource.representations = [];\n const reps2 = Array.isArray(resource.representations) ? resource.representations : [resource.representations];\n reps2.push({\n mediaType: event.payload.format,\n checksum: event.payload.contentChecksum,\n byteSize: event.payload.contentByteSize,\n rel: 'original',\n language: event.payload.language,\n } as Representation);\n resource.representations = reps2;\n break;\n\n case 'resource.updated':\n resource.currentChecksum = event.payload.contentChecksum;\n resource.dateModified = event.timestamp;\n break;\n\n case 'resource.moved':\n resource.storageUri = event.payload.toUri;\n resource.dateModified = event.timestamp;\n break;\n\n case 'resource.archived':\n resource.archived = true;\n break;\n\n case 'resource.unarchived':\n resource.archived = false;\n break;\n\n case 'representation.added': {\n const { representation } = event.payload;\n\n // Add to representations array (avoid duplicates by checksum)\n if (!resource.representations) {\n resource.representations = [];\n }\n\n const repsArray = Array.isArray(resource.representations)\n ? resource.representations\n : [resource.representations];\n\n // Check if representation already exists\n const exists = repsArray.some(r => r.checksum === representation.checksum);\n if (!exists) {\n resource.representations = [...repsArray, representation];\n }\n break;\n }\n\n case 'representation.removed': {\n const { checksum } = event.payload;\n\n if (resource.representations) {\n const repsArray = Array.isArray(resource.representations)\n ? resource.representations\n : [resource.representations];\n\n resource.representations = repsArray.filter(r => r.checksum !== checksum);\n }\n break;\n }\n\n case 'entitytag.added':\n if (!resource.entityTypes) resource.entityTypes = [];\n if (!resource.entityTypes.includes(event.payload.entityType)) {\n resource.entityTypes.push(event.payload.entityType);\n }\n break;\n\n case 'entitytag.removed':\n if (resource.entityTypes) {\n resource.entityTypes = resource.entityTypes.filter(\n (t: string) => t !== event.payload.entityType\n );\n }\n break;\n\n // Annotation events don't affect resource metadata\n case 'annotation.added':\n case 'annotation.removed':\n case 'annotation.body.updated':\n break;\n\n // Job events don't affect resource metadata\n case 'job.started':\n case 'job.progress':\n case 'job.completed':\n case 'job.failed':\n break;\n\n // System events don't affect resource metadata\n case 'entitytype.added':\n break;\n }\n }\n\n /**\n * Apply an event to ResourceAnnotations (annotation collections only)\n */\n private applyEventToAnnotations(annotations: ResourceAnnotations, event: ResourceEvent): void {\n switch (event.type) {\n case 'annotation.added':\n annotations.annotations.push(event.payload.annotation);\n break;\n\n case 'annotation.removed':\n annotations.annotations = annotations.annotations.filter(\n (a: Annotation) => a.id !== event.payload.annotationId\n );\n break;\n\n case 'annotation.body.updated':\n const annotation = annotations.annotations.find((a: Annotation) =>\n a.id === event.payload.annotationId\n );\n if (annotation) {\n // Ensure body is an array\n if (!Array.isArray(annotation.body)) {\n annotation.body = annotation.body ? [annotation.body] : [];\n }\n\n // Apply each operation\n for (const op of event.payload.operations) {\n if (op.op === 'add') {\n // Add item (idempotent - don't add if already exists)\n const exists = findBodyItem(annotation.body, op.item) !== -1;\n if (!exists) {\n annotation.body.push(op.item);\n }\n } else if (op.op === 'remove') {\n // Remove item\n const index = findBodyItem(annotation.body, op.item);\n if (index !== -1) {\n annotation.body.splice(index, 1);\n }\n } else if (op.op === 'replace') {\n // Replace item\n const index = findBodyItem(annotation.body, op.oldItem);\n if (index !== -1) {\n annotation.body[index] = op.newItem;\n }\n }\n }\n\n // Update modified timestamp\n annotation.modified = new Date(event.timestamp).toISOString();\n }\n break;\n\n // Resource metadata events don't affect annotations\n case 'resource.created':\n case 'resource.cloned':\n case 'resource.updated':\n case 'resource.moved':\n case 'resource.archived':\n case 'resource.unarchived':\n case 'representation.added':\n case 'representation.removed':\n case 'entitytag.added':\n case 'entitytag.removed':\n break;\n\n // Job events don't affect annotations\n case 'job.started':\n case 'job.progress':\n case 'job.completed':\n case 'job.failed':\n break;\n\n // System events don't affect annotations\n case 'entitytype.added':\n break;\n }\n }\n\n /**\n * Materialize entity types view - System-level view\n */\n async materializeEntityTypes(entityType: string): Promise<void> {\n const entityTypesPath = path.join(\n this.config.basePath,\n 'projections',\n '__system__',\n 'entitytypes.json'\n );\n\n\n // Read current view\n let view = { entityTypes: [] as string[] };\n try {\n const content = await fs.readFile(entityTypesPath, 'utf-8');\n view = JSON.parse(content);\n } catch (error: any) {\n if (error.code !== 'ENOENT') throw error;\n // File doesn't exist - will create it\n }\n\n // Add entity type (idempotent - Set ensures uniqueness)\n const entityTypeSet = new Set(view.entityTypes);\n entityTypeSet.add(entityType);\n view.entityTypes = Array.from(entityTypeSet).sort();\n\n // Write view\n await fs.mkdir(path.dirname(entityTypesPath), { recursive: true });\n await fs.writeFile(entityTypesPath, JSON.stringify(view, null, 2));\n }\n}\n","/**\n * ViewManager - Materialized View Management Layer\n *\n * Single Responsibility: View updates only\n * - Updates resource views from events\n * - Updates system views (entity types)\n * - Rebuilds views when needed\n *\n * Does NOT handle:\n * - Event persistence (see EventLog)\n * - Pub/sub notifications (see EventBus)\n */\n\nimport { type ResourceId, type ResourceEvent, type StoredEvent, type Logger } from '@semiont/core';\nimport { ViewMaterializer, type ViewMaterializerConfig } from './views/view-materializer';\nimport type { ViewStorage, ResourceView } from './storage/view-storage';\n\nexport interface ViewManagerConfig {\n basePath: string;\n}\n\n/**\n * ViewManager wraps ViewMaterializer with a clean API\n * Handles both resource and system-level views\n */\nexport class ViewManager {\n // Expose materializer for direct access to view methods\n readonly materializer: ViewMaterializer;\n\n constructor(\n viewStorage: ViewStorage,\n config: ViewManagerConfig,\n logger?: Logger\n ) {\n const materializerConfig: ViewMaterializerConfig = {\n basePath: config.basePath,\n };\n this.materializer = new ViewMaterializer(viewStorage, materializerConfig, logger?.child({ component: 'ViewMaterializer' }));\n }\n\n /**\n * Update resource view with a new event\n * Falls back to full rebuild if view doesn't exist\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param event - Resource event (from @semiont/core)\n * @param getAllEvents - Function to retrieve all events for rebuild if needed\n */\n async materializeResource(\n resourceId: ResourceId,\n event: ResourceEvent,\n getAllEvents: () => Promise<StoredEvent[]>\n ): Promise<void> {\n await this.materializer.materializeIncremental(resourceId, event, getAllEvents);\n }\n\n /**\n * Update system-level view (currently only entity types)\n * @param eventType - Type of system event\n * @param payload - Event payload\n */\n async materializeSystem(eventType: string, payload: any): Promise<void> {\n if (eventType === 'entitytype.added') {\n await this.materializer.materializeEntityTypes(payload.entityType);\n }\n // Future system views can be added here\n // e.g., user.created, workspace.created, etc.\n }\n\n /**\n * Get resource view (builds from events if needed)\n * @param resourceId - Branded ResourceId (from @semiont/core)\n * @param events - Stored events for the resource (from @semiont/core)\n * @returns Resource view or null if no events\n */\n async getOrMaterialize(\n resourceId: ResourceId,\n events: StoredEvent[]\n ): Promise<ResourceView | null> {\n return this.materializer.materialize(events, resourceId);\n }\n}\n","/**\n * EventStore - Orchestration Layer\n *\n * Coordinates event sourcing operations across 3 focused components:\n * - EventLog: Event persistence (append, retrieve, query)\n * - EventBus: Pub/sub notifications (publish, subscribe)\n * - ViewManager: View updates (resource and system)\n *\n * Thin coordination layer - delegates all work to specialized components.\n *\n * @see docs/EVENT-STORE.md for complete architecture documentation\n */\n\nimport type {\n ResourceEvent,\n StoredEvent,\n ResourceId,\n Logger,\n} from '@semiont/core';\nimport { EventBus as CoreEventBus } from '@semiont/core';\nimport type { SemiontProject } from '@semiont/core/node';\nimport type { ViewStorage } from './storage/view-storage';\n// Import focused components\nimport { EventLog } from './event-log';\nimport { EventBus } from './event-bus';\nimport { ViewManager, type ViewManagerConfig } from './view-manager';\n\n/**\n * EventStore orchestrates event sourcing operations\n * Delegates to specialized components for focused functionality\n * NO state - just coordination between components\n */\nexport class EventStore {\n // Focused components - each with single responsibility\n readonly log: EventLog;\n readonly bus: EventBus;\n readonly views: ViewManager;\n readonly viewStorage: ViewStorage;\n readonly coreEventBus?: CoreEventBus;\n\n constructor(\n project: SemiontProject,\n stateDir: string,\n viewStorage: ViewStorage,\n coreEventBus?: CoreEventBus,\n logger?: Logger\n ) {\n // Store viewStorage for direct access\n this.viewStorage = viewStorage;\n this.coreEventBus = coreEventBus;\n\n // Initialize focused components\n this.log = new EventLog({ project }, logger?.child({ component: 'EventLog' }));\n\n this.bus = new EventBus(logger?.child({ component: 'EventBus' }));\n\n const viewConfig: ViewManagerConfig = {\n basePath: stateDir,\n };\n this.views = new ViewManager(viewStorage, viewConfig, logger?.child({ component: 'ViewManager' }));\n }\n\n /**\n * Append an event to the store\n * Coordinates: persistence → view → notification\n */\n async appendEvent(event: Omit<ResourceEvent, 'id' | 'timestamp'>): Promise<StoredEvent> {\n // System-level events (entitytype.added) have no resourceId - use __system__\n const resourceId: ResourceId | '__system__' = event.resourceId || '__system__';\n\n // 1. Persist event to log\n const storedEvent = await this.log.append(event, resourceId as any);\n\n // 2. Update views\n if (resourceId === '__system__') {\n // System-level view (entity types, etc.)\n await this.views.materializeSystem(\n storedEvent.event.type,\n storedEvent.event.payload\n );\n } else {\n // Resource view\n await this.views.materializeResource(\n resourceId as ResourceId,\n storedEvent.event,\n () => this.log.getEvents(resourceId as ResourceId)\n );\n }\n\n // 3. Notify subscribers (legacy event bus)\n await this.bus.publish(storedEvent);\n\n // 4. Publish to @semiont/core EventBus if provided (domain events)\n if (this.coreEventBus && resourceId !== '__system__') {\n // Use resource-scoped bus for isolation\n const scopedBus = this.coreEventBus.scope(resourceId as string);\n\n // Publish to specific event type channel (convert dot notation to colon notation)\n // e.g., type: 'job.completed' → channel 'job:completed'\n const eventChannel = storedEvent.event.type.replace(/\\./g, ':') as any;\n scopedBus.get(eventChannel).next(storedEvent.event);\n\n // Also publish to generic 'make-meaning:event' channel for broad subscribers\n scopedBus.get('make-meaning:event').next(storedEvent.event);\n }\n\n return storedEvent;\n }\n}\n","/**\n * View Storage - Materialized Views\n *\n * Stores materialized views of resource state and annotations\n * Built from event streams, can be rebuilt at any time\n *\n * Stores both ResourceDescriptor metadata and ResourceAnnotations, but keeps them logically separate\n */\n\nimport { promises as fs } from 'fs';\nimport * as path from 'path';\nimport { getShardPath } from './shard-utils';\nimport type { SemiontProject } from '@semiont/core/node';\nimport type { components, ResourceAnnotations, ResourceId, Logger } from '@semiont/core';\n\ntype ResourceDescriptor = components['schemas']['ResourceDescriptor'];\n\n// Complete state for a resource in materialized view (metadata + annotations)\nexport interface ResourceView {\n resource: ResourceDescriptor;\n annotations: ResourceAnnotations;\n}\n\nexport interface ViewStorage {\n save(resourceId: ResourceId, view: ResourceView): Promise<void>;\n get(resourceId: ResourceId): Promise<ResourceView | null>;\n delete(resourceId: ResourceId): Promise<void>;\n exists(resourceId: ResourceId): Promise<boolean>;\n getAll(): Promise<ResourceView[]>;\n}\n\nexport class FilesystemViewStorage implements ViewStorage {\n private basePath: string;\n private logger?: Logger;\n\n constructor(project: SemiontProject, logger?: Logger) {\n this.logger = logger;\n this.basePath = project.stateDir;\n }\n\n private getProjectionPath(resourceId: ResourceId): string {\n // Use 4-hex Jump Consistent Hash sharding (65,536 shards)\n const [ab, cd] = getShardPath(resourceId);\n return path.join(this.basePath, 'resources', ab, cd, `${resourceId}.json`);\n }\n\n async save(resourceId: ResourceId, projection: ResourceView): Promise<void> {\n const projPath = this.getProjectionPath(resourceId);\n const projDir = path.dirname(projPath);\n\n // Ensure shard directory exists\n await fs.mkdir(projDir, { recursive: true });\n\n // Write projection to file\n await fs.writeFile(projPath, JSON.stringify(projection, null, 2), 'utf-8');\n }\n\n async get(resourceId: ResourceId): Promise<ResourceView | null> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n const content = await fs.readFile(projPath, 'utf-8');\n return JSON.parse(content) as ResourceView;\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n return null;\n }\n // Auto-delete corrupted view files (views are derived data, can be rebuilt from events)\n // This only handles JSON parsing errors, not broken event chains\n if (error instanceof SyntaxError) {\n this.logger?.error('[ViewStorage] Corrupted view file detected', { resourceId, error: error.message });\n this.logger?.error('[ViewStorage] Deleting corrupted view file', { path: projPath });\n try {\n await fs.unlink(projPath);\n } catch (unlinkError) {\n this.logger?.error('[ViewStorage] Failed to delete corrupted file', { error: unlinkError });\n }\n return null;\n }\n throw error;\n }\n }\n\n async delete(resourceId: ResourceId): Promise<void> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n await fs.unlink(projPath);\n } catch (error: any) {\n if (error.code !== 'ENOENT') {\n throw error;\n }\n // Ignore if file doesn't exist\n }\n }\n\n async exists(resourceId: ResourceId): Promise<boolean> {\n const projPath = this.getProjectionPath(resourceId);\n\n try {\n await fs.access(projPath);\n return true;\n } catch {\n return false;\n }\n }\n\n async getAll(): Promise<ResourceView[]> {\n const views: ResourceView[] = [];\n const annotationsPath = path.join(this.basePath, 'resources');\n\n try {\n // Recursively walk through all shard directories\n const walkDir = async (dir: string): Promise<void> => {\n const entries = await fs.readdir(dir, { withFileTypes: true });\n\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n\n if (entry.isDirectory()) {\n await walkDir(fullPath);\n } else if (entry.isFile() && entry.name.endsWith('.json')) {\n try {\n const content = await fs.readFile(fullPath, 'utf-8');\n const view = JSON.parse(content) as ResourceView;\n views.push(view);\n } catch (error) {\n this.logger?.error('[ViewStorage] Failed to read view', { path: fullPath, error });\n // Skip invalid view files\n }\n }\n }\n };\n\n await walkDir(annotationsPath);\n } catch (error: any) {\n if (error.code === 'ENOENT') {\n // Views directory doesn't exist yet\n return [];\n }\n throw error;\n }\n\n return views;\n }\n}","/**\n * Event Store Factory\n *\n * Factory function for creating EventStore instances with standard configuration.\n * This is the canonical way to instantiate an EventStore.\n */\n\nimport type { SemiontProject } from '@semiont/core/node';\nimport type { EventBus as CoreEventBus, Logger } from '@semiont/core';\nimport { EventStore } from './event-store';\nimport { FilesystemViewStorage } from './storage/view-storage';\n\n/**\n * Create and initialize an EventStore instance\n *\n * @param project - SemiontProject instance\n * @param eventBus - Optional @semiont/core EventBus for publishing domain events\n * @param logger - Optional logger for structured logging\n * @returns Configured EventStore instance ready for use\n */\nexport function createEventStore(\n project: SemiontProject,\n eventBus?: CoreEventBus,\n logger?: Logger\n): EventStore {\n const viewStorage = new FilesystemViewStorage(project, logger?.child({ component: 'view-storage' }));\n\n return new EventStore(\n project,\n project.stateDir,\n viewStorage,\n eventBus,\n logger\n );\n}\n","/**\n * Event Query - Read Operations\n *\n * Handles querying and reading events from storage:\n * - Query events with filters (type, user, timestamp, sequence)\n * - Get all events for a resource\n * - Get last event from a file\n * - Efficient streaming reads from JSONL files\n *\n * @see docs/EVENT-STORE.md#eventquery for architecture details\n */\n\nimport type { StoredEvent, EventQuery as EventQueryType, ResourceId } from '@semiont/core';\nimport type { EventStorage } from '../storage/event-storage';\n\n/**\n * EventQuery handles all read operations for events\n * Uses EventStorage for file access, adds query filtering\n */\nexport class EventQuery {\n constructor(private eventStorage: EventStorage) {}\n\n /**\n * Query events with filters\n * Supports filtering by: userId, eventTypes, timestamps, sequence number, limit\n */\n async queryEvents(query: EventQueryType): Promise<StoredEvent[]> {\n if (!query.resourceId) {\n throw new Error('resourceId is required for event queries');\n }\n\n // Get all events from storage\n const allEvents = await this.eventStorage.getAllEvents(query.resourceId);\n\n // Apply filters\n let results = allEvents;\n\n if (query.userId) {\n results = results.filter(e => e.event.userId === query.userId);\n }\n\n if (query.eventTypes && query.eventTypes.length > 0) {\n results = results.filter(e => query.eventTypes!.includes(e.event.type));\n }\n\n if (query.fromTimestamp) {\n results = results.filter(e => e.event.timestamp >= query.fromTimestamp!);\n }\n\n if (query.toTimestamp) {\n results = results.filter(e => e.event.timestamp <= query.toTimestamp!);\n }\n\n if (query.fromSequence) {\n results = results.filter(e => e.metadata.sequenceNumber >= query.fromSequence!);\n }\n\n // Apply limit\n if (query.limit && query.limit > 0) {\n results = results.slice(0, query.limit);\n }\n\n return results;\n }\n\n /**\n * Get all events for a specific resource (no filters)\n */\n async getResourceEvents(resourceId: ResourceId): Promise<StoredEvent[]> {\n return this.eventStorage.getAllEvents(resourceId);\n }\n\n /**\n * Get the last event from a specific file\n * Useful for initializing sequence numbers and last hashes\n */\n async getLastEvent(resourceId: ResourceId, filename: string): Promise<StoredEvent | null> {\n return this.eventStorage.getLastEvent(resourceId, filename);\n }\n\n /**\n * Get the latest event for a resource across all files\n */\n async getLatestEvent(resourceId: ResourceId): Promise<StoredEvent | null> {\n const files = await this.eventStorage.getEventFiles(resourceId);\n if (files.length === 0) return null;\n\n // Check files in reverse order (newest first)\n for (let i = files.length - 1; i >= 0; i--) {\n const file = files[i];\n if (!file) continue;\n const lastEvent = await this.eventStorage.getLastEvent(resourceId, file);\n if (lastEvent) return lastEvent;\n }\n\n return null;\n }\n\n /**\n * Get event count for a resource\n */\n async getEventCount(resourceId: ResourceId): Promise<number> {\n const events = await this.getResourceEvents(resourceId);\n return events.length;\n }\n\n /**\n * Check if a resource has any events\n */\n async hasEvents(resourceId: ResourceId): Promise<boolean> {\n const files = await this.eventStorage.getEventFiles(resourceId);\n return files.length > 0;\n }\n}\n","/**\n * Event Validator - Event Chain Integrity\n *\n * Validates event chain integrity using cryptographic hashing:\n * - prevEventHash links to previous event's checksum\n * - Each event's checksum is verified against its payload\n * - Detects broken chains and tampered events\n *\n * @see docs/EVENT-STORE.md#eventvalidator for architecture details\n */\n\nimport type { StoredEvent } from '@semiont/core';\nimport { sha256 } from '../storage/shard-utils';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: string[];\n}\n\n/**\n * EventValidator verifies event chain integrity\n * Uses cryptographic checksums to detect broken chains or tampering\n */\nexport class EventValidator {\n /**\n * Validate event chain integrity for a resource's events\n * Checks that each event properly links to the previous event\n */\n validateEventChain(events: StoredEvent[]): ValidationResult {\n const errors: string[] = [];\n\n for (let i = 1; i < events.length; i++) {\n const prev = events[i - 1];\n const curr = events[i];\n\n if (!prev || !curr) continue;\n\n // Check prevEventHash points to previous event\n if (curr.metadata.prevEventHash !== prev.metadata.checksum) {\n errors.push(\n `Event chain broken at sequence ${curr.metadata.sequenceNumber}: ` +\n `prevEventHash=${curr.metadata.prevEventHash} but previous checksum=${prev.metadata.checksum}`\n );\n }\n\n // Verify checksum of current event\n const calculated = sha256(curr.event);\n if (calculated !== curr.metadata.checksum) {\n errors.push(\n `Checksum mismatch at sequence ${curr.metadata.sequenceNumber}: ` +\n `calculated=${calculated} but stored=${curr.metadata.checksum}`\n );\n }\n }\n\n return {\n valid: errors.length === 0,\n errors,\n };\n }\n\n /**\n * Validate a single event's checksum\n * Useful for validating events before writing them\n */\n validateEventChecksum(event: StoredEvent): boolean {\n const calculated = sha256(event.event);\n return calculated === event.metadata.checksum;\n }\n\n /**\n * Validate that an event properly links to a previous event\n * Returns true if the link is valid or if this is the first event\n */\n validateEventLink(currentEvent: StoredEvent, previousEvent: StoredEvent | null): boolean {\n // First event in chain should have no prevEventHash\n if (!previousEvent) {\n return !currentEvent.metadata.prevEventHash;\n }\n\n // Subsequent events should link to previous event's checksum\n return currentEvent.metadata.prevEventHash === previousEvent.metadata.checksum;\n }\n}\n","/**\n * Identifier utilities for event sourcing\n */\n\nimport { nanoid } from 'nanoid';\n\n/**\n * Generate a unique annotation ID (bare nanoid)\n *\n * @returns A bare annotation ID (e.g., \"V1StGXR8_Z5jdHi6B-myT\")\n */\nexport function generateAnnotationId(): string {\n return nanoid(21);\n}\n"]}
|