@photon-grove/evt 0.1.0 → 0.1.2
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/README.md +85 -9
- package/dist/aggregate.d.ts +26 -0
- package/dist/aggregate.d.ts.map +1 -1
- package/dist/aggregate.js.map +1 -1
- package/dist/dynamodb/client.d.ts +83 -0
- package/dist/dynamodb/client.d.ts.map +1 -0
- package/dist/dynamodb/client.js +6 -0
- package/dist/dynamodb/client.js.map +1 -0
- package/dist/dynamodb/index.d.ts +6 -1
- package/dist/dynamodb/index.d.ts.map +1 -1
- package/dist/dynamodb/index.js +8 -3
- package/dist/dynamodb/index.js.map +1 -1
- package/dist/dynamodb/item.d.ts +2 -0
- package/dist/dynamodb/item.d.ts.map +1 -1
- package/dist/dynamodb/item.js +5 -4
- package/dist/dynamodb/item.js.map +1 -1
- package/dist/dynamodb/marker.d.ts +11 -0
- package/dist/dynamodb/marker.d.ts.map +1 -0
- package/dist/dynamodb/marker.js +56 -0
- package/dist/dynamodb/marker.js.map +1 -0
- package/dist/dynamodb/repository.d.ts +61 -0
- package/dist/dynamodb/repository.d.ts.map +1 -0
- package/dist/dynamodb/repository.js +748 -0
- package/dist/dynamodb/repository.js.map +1 -0
- package/dist/dynamodb/requests.d.ts +68 -0
- package/dist/dynamodb/requests.d.ts.map +1 -0
- package/dist/dynamodb/requests.js +194 -0
- package/dist/dynamodb/requests.js.map +1 -0
- package/dist/dynamodb/views.d.ts +18 -0
- package/dist/dynamodb/views.d.ts.map +1 -0
- package/dist/dynamodb/views.js +56 -0
- package/dist/dynamodb/views.js.map +1 -0
- package/dist/errors.d.ts +109 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +118 -2
- package/dist/errors.js.map +1 -1
- package/dist/features.d.ts +55 -0
- package/dist/features.d.ts.map +1 -0
- package/dist/features.js +126 -0
- package/dist/features.js.map +1 -0
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/memory/index.d.ts +1 -1
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/memory/index.js +1 -1
- package/dist/memory/index.js.map +1 -1
- package/dist/memory/repository.d.ts +38 -2
- package/dist/memory/repository.d.ts.map +1 -1
- package/dist/memory/repository.js +95 -6
- package/dist/memory/repository.js.map +1 -1
- package/dist/postgres/client.d.ts +32 -0
- package/dist/postgres/client.d.ts.map +1 -0
- package/dist/postgres/client.js +4 -0
- package/dist/postgres/client.js.map +1 -0
- package/dist/postgres/index.d.ts +4 -0
- package/dist/postgres/index.d.ts.map +1 -0
- package/dist/postgres/index.js +6 -0
- package/dist/postgres/index.js.map +1 -0
- package/dist/postgres/repository.d.ts +55 -0
- package/dist/postgres/repository.d.ts.map +1 -0
- package/dist/postgres/repository.js +527 -0
- package/dist/postgres/repository.js.map +1 -0
- package/dist/postgres/schema.d.ts +81 -0
- package/dist/postgres/schema.d.ts.map +1 -0
- package/dist/postgres/schema.js +233 -0
- package/dist/postgres/schema.js.map +1 -0
- package/dist/repository.d.ts +56 -7
- package/dist/repository.d.ts.map +1 -1
- package/dist/repository.js +24 -9
- package/dist/repository.js.map +1 -1
- package/dist/store.d.ts +7 -5
- package/dist/store.d.ts.map +1 -1
- package/dist/store.js +34 -9
- package/dist/store.js.map +1 -1
- package/package.json +16 -3
- package/src/aggregate.ts +28 -0
- package/src/dynamodb/client.ts +102 -0
- package/src/dynamodb/index.ts +27 -2
- package/src/dynamodb/item.ts +6 -4
- package/src/dynamodb/marker.ts +64 -0
- package/src/dynamodb/repository.ts +1053 -0
- package/src/dynamodb/requests.ts +276 -0
- package/src/dynamodb/views.ts +67 -0
- package/src/errors.ts +176 -2
- package/src/features.ts +175 -0
- package/src/index.ts +28 -1
- package/src/memory/index.ts +9 -1
- package/src/memory/repository.ts +156 -6
- package/src/postgres/client.ts +37 -0
- package/src/postgres/index.ts +23 -0
- package/src/postgres/repository.ts +773 -0
- package/src/postgres/schema.ts +286 -0
- package/src/repository.ts +86 -13
- package/src/store.ts +61 -11
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
// The PostgreSQL layout of an event log, independent of any driver (storage format, "PostgreSQL"):
|
|
2
|
+
// the table names a store is configured with, the engine relations derived from them, and the
|
|
3
|
+
// idempotent DDL that Go's EnsureSchema and Rust's ensure_schema run.
|
|
4
|
+
import { EvtError } from '../errors.js';
|
|
5
|
+
/** The default events table. */
|
|
6
|
+
export const DEFAULT_EVENTS_TABLE = 'evt_events';
|
|
7
|
+
/** The default snapshots table. */
|
|
8
|
+
export const DEFAULT_SNAPSHOTS_TABLE = 'evt_snapshots';
|
|
9
|
+
/**
|
|
10
|
+
* The infix the engine relations derive from the events table name with, such as
|
|
11
|
+
* `evt_events__evt_features`. A configured table name may not contain it, in any case, so one
|
|
12
|
+
* log's tables can never equal another log's derived relation.
|
|
13
|
+
*/
|
|
14
|
+
export const RESERVED_INFIX = '__evt_';
|
|
15
|
+
/**
|
|
16
|
+
* The longest events table name, in bytes. Its longest derived relation,
|
|
17
|
+
* `{events}__evt_rebuild_generation_pkey`, then fills PostgreSQL's 63-byte identifier limit.
|
|
18
|
+
*/
|
|
19
|
+
export const MAX_EVENTS_TABLE_NAME_BYTES = 63 - '__evt_rebuild_generation_pkey'.length;
|
|
20
|
+
/** The longest snapshots table name, in bytes, which leaves room for its `_pkey` index. */
|
|
21
|
+
export const MAX_SNAPSHOTS_TABLE_NAME_BYTES = 63 - '_pkey'.length;
|
|
22
|
+
const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
23
|
+
// PostgreSQL's reserved keywords (pg_get_keywords() categories R and T), which can't be unquoted
|
|
24
|
+
// table names. The same list as Go's and Rust's.
|
|
25
|
+
const RESERVED_KEYWORDS = new Set(`all analyse analyze and any array as asc asymmetric authorization binary both case cast check
|
|
26
|
+
collate collation column concurrently constraint create cross current_catalog current_date
|
|
27
|
+
current_role current_schema current_time current_timestamp current_user default deferrable desc
|
|
28
|
+
distinct do else end except false fetch for foreign freeze from full grant group having ilike in
|
|
29
|
+
initially inner intersect into is isnull join lateral leading left like limit localtime
|
|
30
|
+
localtimestamp natural not notnull null offset on only or order outer overlaps placing primary
|
|
31
|
+
references returning right select session_user similar some symmetric system_user table
|
|
32
|
+
tablesample then to trailing true union unique user using variadic verbose when where window
|
|
33
|
+
with`.split(/\s+/));
|
|
34
|
+
/**
|
|
35
|
+
* Validates an event log's table names and folds them to lower case, as PostgreSQL folds unquoted
|
|
36
|
+
* identifiers. Each must be a plain identifier that isn't a reserved keyword, within its length
|
|
37
|
+
* limit, without the {@link RESERVED_INFIX}, and no two relations the schema creates may share a
|
|
38
|
+
* name. A name that breaks a rule fails with `invalidArgument`, as Go and Rust refuse it at
|
|
39
|
+
* construction.
|
|
40
|
+
*/
|
|
41
|
+
export function pgTables(events = DEFAULT_EVENTS_TABLE, snapshots = DEFAULT_SNAPSHOTS_TABLE) {
|
|
42
|
+
for (const [name, limit] of [
|
|
43
|
+
[events, MAX_EVENTS_TABLE_NAME_BYTES],
|
|
44
|
+
[snapshots, MAX_SNAPSHOTS_TABLE_NAME_BYTES],
|
|
45
|
+
]) {
|
|
46
|
+
if (!validIdentifier(name, limit)) {
|
|
47
|
+
throw invalidConfig(`invalid table name ${JSON.stringify(name)}`);
|
|
48
|
+
}
|
|
49
|
+
if (name.toLowerCase().includes(RESERVED_INFIX)) {
|
|
50
|
+
throw invalidConfig(`table name ${JSON.stringify(name)} must not contain the reserved infix ` +
|
|
51
|
+
JSON.stringify(RESERVED_INFIX));
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
const tables = { events: events.toLowerCase(), snapshots: snapshots.toLowerCase() };
|
|
55
|
+
const shared = sharedRelation(tables);
|
|
56
|
+
if (shared !== null) {
|
|
57
|
+
throw invalidConfig(`tables ${JSON.stringify(events)} and ${JSON.stringify(snapshots)} would both use the ` +
|
|
58
|
+
`name ${JSON.stringify(shared)}`);
|
|
59
|
+
}
|
|
60
|
+
return tables;
|
|
61
|
+
}
|
|
62
|
+
/** The command-outcomes table: `evt_events` yields `evt_events__evt_command_outcomes`. */
|
|
63
|
+
export function outcomesTable(tables) {
|
|
64
|
+
return derived(tables.events, 'command_outcomes');
|
|
65
|
+
}
|
|
66
|
+
/** The feature-marker table: `evt_events` yields `evt_events__evt_features`. */
|
|
67
|
+
export function featuresTable(tables) {
|
|
68
|
+
return derived(tables.events, 'features');
|
|
69
|
+
}
|
|
70
|
+
/** The rebuild-lock table: `evt_events` yields `evt_events__evt_rebuild_lock`. */
|
|
71
|
+
export function rebuildLockTable(tables) {
|
|
72
|
+
return derived(tables.events, 'rebuild_lock');
|
|
73
|
+
}
|
|
74
|
+
/** The rebuild-generation table: `evt_events` yields `evt_events__evt_rebuild_generation`. */
|
|
75
|
+
export function rebuildGenerationTable(tables) {
|
|
76
|
+
return derived(tables.events, 'rebuild_generation');
|
|
77
|
+
}
|
|
78
|
+
/** The stream-heads table: `evt_events` yields `evt_events__evt_stream_heads`. */
|
|
79
|
+
export function streamHeadsTable(tables) {
|
|
80
|
+
return derived(tables.events, 'stream_heads');
|
|
81
|
+
}
|
|
82
|
+
/** The entity-type index of the events table: `evt_events__evt_entity_type_idx`. */
|
|
83
|
+
export function entityTypeIndex(tables) {
|
|
84
|
+
return derived(tables.events, 'entity_type_idx');
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* The idempotent DDL of an event log, byte for byte the DDL Go's `EnsureSchema` and Rust's
|
|
88
|
+
* `ensure_schema` run: the events and snapshots tables, the entity-type index (dropping its
|
|
89
|
+
* pre-v0.9 name), and the command-outcome, feature-marker, rebuild-fence and stream-heads tables.
|
|
90
|
+
* Run it inside one transaction, after {@link SCHEMA_LOCK} with the events table name, as Go and
|
|
91
|
+
* Rust do.
|
|
92
|
+
*/
|
|
93
|
+
export function schemaDdl(tables) {
|
|
94
|
+
const { events, snapshots } = tables;
|
|
95
|
+
return `
|
|
96
|
+
CREATE TABLE IF NOT EXISTS ${events} (
|
|
97
|
+
entity_id text NOT NULL,
|
|
98
|
+
sequence bigint NOT NULL,
|
|
99
|
+
event_id text NOT NULL,
|
|
100
|
+
event_type text NOT NULL,
|
|
101
|
+
version bigint NOT NULL,
|
|
102
|
+
entity_type text NOT NULL,
|
|
103
|
+
payload bytea NOT NULL,
|
|
104
|
+
metadata jsonb NOT NULL DEFAULT '{}'::jsonb,
|
|
105
|
+
created_at timestamptz NOT NULL DEFAULT now(),
|
|
106
|
+
PRIMARY KEY (entity_id, sequence)
|
|
107
|
+
);
|
|
108
|
+
CREATE INDEX IF NOT EXISTS ${entityTypeIndex(tables)} ON ${events} (entity_type);
|
|
109
|
+
DO $$
|
|
110
|
+
BEGIN
|
|
111
|
+
IF EXISTS (
|
|
112
|
+
SELECT 1 FROM pg_index
|
|
113
|
+
WHERE indexrelid = to_regclass('${events}_entity_type_idx')
|
|
114
|
+
AND indrelid = '${events}'::regclass
|
|
115
|
+
) THEN
|
|
116
|
+
DROP INDEX ${events}_entity_type_idx;
|
|
117
|
+
END IF;
|
|
118
|
+
END $$;
|
|
119
|
+
|
|
120
|
+
CREATE TABLE IF NOT EXISTS ${snapshots} (
|
|
121
|
+
entity_id text PRIMARY KEY,
|
|
122
|
+
entity_type text NOT NULL,
|
|
123
|
+
sequence bigint NOT NULL,
|
|
124
|
+
event_sequence bigint NOT NULL,
|
|
125
|
+
payload bytea NOT NULL,
|
|
126
|
+
updated_at timestamptz NOT NULL DEFAULT now()
|
|
127
|
+
);
|
|
128
|
+
|
|
129
|
+
CREATE TABLE IF NOT EXISTS ${outcomesTable(tables)} (
|
|
130
|
+
command_id text PRIMARY KEY,
|
|
131
|
+
status text NOT NULL CHECK (status IN ('accepted', 'rejected')),
|
|
132
|
+
digest text NOT NULL,
|
|
133
|
+
response bytea,
|
|
134
|
+
events jsonb NOT NULL DEFAULT '[]'::jsonb,
|
|
135
|
+
rejection jsonb,
|
|
136
|
+
code text,
|
|
137
|
+
created_at timestamptz NOT NULL DEFAULT now(),
|
|
138
|
+
CHECK ((status = 'rejected' AND rejection IS NOT NULL AND code IS NOT NULL)
|
|
139
|
+
OR (status = 'accepted' AND rejection IS NULL AND code IS NULL))
|
|
140
|
+
);
|
|
141
|
+
|
|
142
|
+
CREATE TABLE IF NOT EXISTS ${featuresTable(tables)} (
|
|
143
|
+
id integer PRIMARY KEY,
|
|
144
|
+
version bigint NOT NULL,
|
|
145
|
+
features text NOT NULL,
|
|
146
|
+
history_dependent text NOT NULL DEFAULT '[]',
|
|
147
|
+
retention text NOT NULL DEFAULT '[]'
|
|
148
|
+
);
|
|
149
|
+
|
|
150
|
+
CREATE TABLE IF NOT EXISTS ${rebuildLockTable(tables)} (
|
|
151
|
+
id integer PRIMARY KEY,
|
|
152
|
+
owner text NOT NULL,
|
|
153
|
+
generation bigint NOT NULL,
|
|
154
|
+
lease_expires_at timestamptz NOT NULL
|
|
155
|
+
);
|
|
156
|
+
|
|
157
|
+
CREATE TABLE IF NOT EXISTS ${rebuildGenerationTable(tables)} (
|
|
158
|
+
id integer PRIMARY KEY,
|
|
159
|
+
value bigint NOT NULL,
|
|
160
|
+
force_released boolean NOT NULL DEFAULT false
|
|
161
|
+
);
|
|
162
|
+
|
|
163
|
+
CREATE TABLE IF NOT EXISTS ${streamHeadsTable(tables)} (
|
|
164
|
+
entity_id text PRIMARY KEY,
|
|
165
|
+
entity_type text NOT NULL,
|
|
166
|
+
head bigint NOT NULL CHECK (head >= 1)
|
|
167
|
+
);
|
|
168
|
+
`;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Serializes schema changes across processes, in every language: `IF NOT EXISTS` alone can still
|
|
172
|
+
* race in PostgreSQL's catalogs. `$1` is the events table name.
|
|
173
|
+
*/
|
|
174
|
+
export const SCHEMA_LOCK = 'SELECT pg_advisory_xact_lock(1702261762, hashtext($1))';
|
|
175
|
+
/**
|
|
176
|
+
* The per-entity transaction lock every commit and snapshot write takes, `$1` being the entity
|
|
177
|
+
* ID. Go and Rust run this exact statement, so writers in every language exclude each other.
|
|
178
|
+
*/
|
|
179
|
+
export const ENTITY_LOCK = 'SELECT pg_advisory_xact_lock(1702261760, hashtext($1))';
|
|
180
|
+
/**
|
|
181
|
+
* The shared engine-row lock a commit takes and holds to `COMMIT`, `$1` being a key from
|
|
182
|
+
* {@link featuresLockKey} or {@link rebuildLockKey}. Commits don't serialize against each other.
|
|
183
|
+
*/
|
|
184
|
+
export const ENGINE_LOCK_SHARED = 'SELECT pg_advisory_xact_lock_shared(1702261761, hashtext($1))';
|
|
185
|
+
/**
|
|
186
|
+
* The exclusive engine-row lock a declaration or a rebuild lifecycle step takes for its short
|
|
187
|
+
* transaction, so it never slips between a commit's check and its `COMMIT`.
|
|
188
|
+
*/
|
|
189
|
+
export const ENGINE_LOCK_EXCLUSIVE = 'SELECT pg_advisory_xact_lock(1702261761, hashtext($1))';
|
|
190
|
+
/** The feature marker's engine-row lock key: `{events}:features`. */
|
|
191
|
+
export function featuresLockKey(tables) {
|
|
192
|
+
return `${tables.events}:features`;
|
|
193
|
+
}
|
|
194
|
+
/** The rebuild fence's engine-row lock key: `{events}:rebuild`. */
|
|
195
|
+
export function rebuildLockKey(tables) {
|
|
196
|
+
return `${tables.events}:rebuild`;
|
|
197
|
+
}
|
|
198
|
+
function derived(events, suffix) {
|
|
199
|
+
return `${events}${RESERVED_INFIX}${suffix}`;
|
|
200
|
+
}
|
|
201
|
+
// A valid identifier is ASCII, so its length is its byte count and folding it changes only A-Z.
|
|
202
|
+
// The type check refuses a non-string passed from JavaScript, which the pattern would coerce.
|
|
203
|
+
function validIdentifier(name, limit) {
|
|
204
|
+
return (typeof name === 'string' &&
|
|
205
|
+
name.length <= limit &&
|
|
206
|
+
IDENTIFIER.test(name) &&
|
|
207
|
+
!RESERVED_KEYWORDS.has(name.toLowerCase()));
|
|
208
|
+
}
|
|
209
|
+
// A name two relations of the schema would share, or null, with the names already folded to lower
|
|
210
|
+
// case. CREATE TABLE IF NOT EXISTS would otherwise skip a table whose name an index already took.
|
|
211
|
+
function sharedRelation(tables) {
|
|
212
|
+
const { events, snapshots } = tables;
|
|
213
|
+
const derivedTables = [
|
|
214
|
+
outcomesTable(tables),
|
|
215
|
+
featuresTable(tables),
|
|
216
|
+
rebuildLockTable(tables),
|
|
217
|
+
rebuildGenerationTable(tables),
|
|
218
|
+
streamHeadsTable(tables),
|
|
219
|
+
];
|
|
220
|
+
const relations = [
|
|
221
|
+
events,
|
|
222
|
+
`${events}_pkey`,
|
|
223
|
+
entityTypeIndex(tables),
|
|
224
|
+
...derivedTables.flatMap((table) => [table, `${table}_pkey`]),
|
|
225
|
+
snapshots,
|
|
226
|
+
`${snapshots}_pkey`,
|
|
227
|
+
];
|
|
228
|
+
return relations.find((relation, index) => relations.indexOf(relation) !== index) ?? null;
|
|
229
|
+
}
|
|
230
|
+
function invalidConfig(message) {
|
|
231
|
+
return new EvtError('invalidArgument', `postgres: ${message}`);
|
|
232
|
+
}
|
|
233
|
+
//# sourceMappingURL=schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/postgres/schema.ts"],"names":[],"mappings":"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"}
|
package/dist/repository.d.ts
CHANGED
|
@@ -7,9 +7,23 @@ export interface NewSnapshot {
|
|
|
7
7
|
/** The aggregate state after the commit's events. */
|
|
8
8
|
payload: Uint8Array;
|
|
9
9
|
}
|
|
10
|
+
/**
|
|
11
|
+
* Operations a projector adds to a commit, for the backend it names to write in the commit's own
|
|
12
|
+
* transaction (Go's transaction groups). The DynamoDB repository writes `dynamodb` groups, whose
|
|
13
|
+
* operations are `TransactWriteItems` actions. The in-memory repository budgets every group and
|
|
14
|
+
* writes none, as Go's does, so code with projectors runs on it unchanged.
|
|
15
|
+
*/
|
|
16
|
+
export interface ProjectorGroup {
|
|
17
|
+
/** The backend whose transaction carries the operations, such as `dynamodb`. */
|
|
18
|
+
readonly backend: string;
|
|
19
|
+
/** The operations, in the order they're written. */
|
|
20
|
+
readonly operations: readonly unknown[];
|
|
21
|
+
/** Each operation's size in the commit budget, as DynamoDB counts it. */
|
|
22
|
+
readonly sizes: readonly number[];
|
|
23
|
+
}
|
|
10
24
|
/**
|
|
11
25
|
* Everything a repository writes atomically for one command. A commit with no events is a no-op,
|
|
12
|
-
* and its snapshot is ignored.
|
|
26
|
+
* and its snapshot is ignored, unless it carries projector operations: then it's refused.
|
|
13
27
|
*/
|
|
14
28
|
export interface Commit {
|
|
15
29
|
/** The stream the events are appended to. */
|
|
@@ -18,10 +32,16 @@ export interface Commit {
|
|
|
18
32
|
events: SerializedEvent[];
|
|
19
33
|
/** The snapshot to write, when the commit reaches a snapshot boundary. */
|
|
20
34
|
snapshot?: NewSnapshot | null | undefined;
|
|
35
|
+
/** The operations the aggregate's projectors add, written first, in order. */
|
|
36
|
+
projections?: readonly ProjectorGroup[] | null | undefined;
|
|
21
37
|
}
|
|
22
38
|
/** Options every repository call takes. */
|
|
23
39
|
export interface CallOptions {
|
|
24
|
-
/**
|
|
40
|
+
/**
|
|
41
|
+
* Aborts the call. An abort before the call starts rejects with the signal's reason and writes
|
|
42
|
+
* nothing. An abort while a live backend's write is in flight rejects too, but the write may
|
|
43
|
+
* have been applied: load the stream again before deciding it wasn't.
|
|
44
|
+
*/
|
|
25
45
|
signal?: AbortSignal | undefined;
|
|
26
46
|
}
|
|
27
47
|
/**
|
|
@@ -37,8 +57,20 @@ export interface CallOptions {
|
|
|
37
57
|
* {@link StreamHeadDriftError}, ranked above a gap and any other conflict;
|
|
38
58
|
* - refuse a commit's snapshot whose sequence isn't the stored snapshot's plus one (1 with none
|
|
39
59
|
* stored) with a {@link ConflictError};
|
|
40
|
-
* - write a commit's events, head and snapshot atomically, or nothing
|
|
60
|
+
* - write a commit's events, head and snapshot atomically, or nothing, with the projector
|
|
61
|
+
* operations it writes (a backend writes only its own groups), and refuse projector operations
|
|
62
|
+
* without events with a {@link ProjectorOnlyCommitError};
|
|
41
63
|
* - refuse an entity ID in a reserved namespace on every write path, before any request;
|
|
64
|
+
* - refuse every write (a commit, a snapshot write, compaction) to a store whose feature manifest
|
|
65
|
+
* declares a pair this package doesn't model, with an {@link UnsupportedFeatureError}, and to
|
|
66
|
+
* one that doesn't declare stream-heads: with a {@link StreamHeadsNotMigratedError} when it
|
|
67
|
+
* holds data, and otherwise either by declaring stream-heads on the first commit or snapshot
|
|
68
|
+
* write or with a {@link StoreNotInitializedError}, as the backend initializes;
|
|
69
|
+
* - refuse a commit, but not a snapshot write or compaction, while a projection rebuild holds the
|
|
70
|
+
* store, with a {@link RebuildInProgressError}, after the manifest's refusals and before every
|
|
71
|
+
* stream's;
|
|
72
|
+
* - refuse compaction of an entity whose type the manifest declares history-dependent, with a
|
|
73
|
+
* {@link HistoryDependentProjectionError};
|
|
42
74
|
* - return events in ascending sequence order, and `latest` in descending order.
|
|
43
75
|
*/
|
|
44
76
|
export interface Repository {
|
|
@@ -70,6 +102,21 @@ export interface Repository {
|
|
|
70
102
|
*/
|
|
71
103
|
compactBelow(entityId: string, through: bigint, options?: CallOptions): Promise<number>;
|
|
72
104
|
}
|
|
105
|
+
/**
|
|
106
|
+
* A repository whose store can be initialized explicitly: its feature manifest declares
|
|
107
|
+
* stream-heads before any writer writes. A strict backend, such as DynamoDB by default, refuses
|
|
108
|
+
* every write until then. One whose writers initialize a fresh store on their first write, such
|
|
109
|
+
* as the in-memory one, needs it only where code treats every backend alike.
|
|
110
|
+
*/
|
|
111
|
+
export interface StoreInitializer {
|
|
112
|
+
/**
|
|
113
|
+
* Declares stream-heads on a store that holds no data, and resolves `true` when this call
|
|
114
|
+
* declared it. A store that already declares it is left alone and resolves `false`. One that
|
|
115
|
+
* holds data without it is refused with a {@link StreamHeadsNotMigratedError}, and one that
|
|
116
|
+
* declares an unsupported feature with an {@link UnsupportedFeatureError}.
|
|
117
|
+
*/
|
|
118
|
+
initialize(options?: CallOptions): Promise<boolean>;
|
|
119
|
+
}
|
|
73
120
|
/** The most actions one commit may carry, DynamoDB's transaction limit. */
|
|
74
121
|
export declare const MAX_COMMIT_ACTIONS = 100;
|
|
75
122
|
/** The most bytes one commit may carry, summed over its actions: 95% of DynamoDB's 4 MB. */
|
|
@@ -84,14 +131,16 @@ export declare function checkNotReserved(entityId: string): void;
|
|
|
84
131
|
* Checks that a commit's events can be stored as written: each belongs to the commit's entity and
|
|
85
132
|
* has the ID `{entityId}:{sequence}`, they share one entity type, the first sequence is at least
|
|
86
133
|
* 1, and the sequences are contiguous. A snapshot must have the events' entity type and a
|
|
87
|
-
* sequence of at least 1
|
|
134
|
+
* sequence of at least 1, and each projector group a size per operation. A commit with no events
|
|
135
|
+
* is valid, and its snapshot isn't checked, but its projector operations are refused.
|
|
88
136
|
*/
|
|
89
137
|
export declare function validateCommit(commit: Commit): void;
|
|
90
138
|
/**
|
|
91
139
|
* The size of each action a commit's transaction carries, in order: the feature-marker and
|
|
92
|
-
* rebuild-lock checks, then the stream's head update, its event puts,
|
|
93
|
-
* it writes one. `ttl` gives the expiry an entity type's items carry, if
|
|
94
|
-
* backend budgets a commit by these sizes, so an oversized commit fails the
|
|
140
|
+
* rebuild-lock checks, the projector operations, then the stream's head update, its event puts,
|
|
141
|
+
* and its snapshot put when it writes one. `ttl` gives the expiry an entity type's items carry, if
|
|
142
|
+
* it's retained. Every backend budgets a commit by these sizes, so an oversized commit fails the
|
|
143
|
+
* same way on each.
|
|
95
144
|
*/
|
|
96
145
|
export declare function commitSizes(commit: Commit, ttl: (entityType: string) => number | undefined): number[];
|
|
97
146
|
/**
|
package/dist/repository.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}
|
package/dist/repository.js
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
// same way: validation, the reserved namespaces, and the transaction budget.
|
|
3
3
|
import { headActionSize, headUpdate } from './dynamodb/head.js';
|
|
4
4
|
import { eventItem, itemSize, snapshotItem } from './dynamodb/item.js';
|
|
5
|
-
import {
|
|
5
|
+
import { FEATURES_PK, REBUILD_LOCK_PK } from './dynamodb/marker.js';
|
|
6
|
+
import { CommitTooLargeError, EvtError, ProjectorOnlyCommitError, ReservedEntityIdError, } from './errors.js';
|
|
6
7
|
import { eventId } from './event.js';
|
|
7
8
|
import { MAX_COMMIT_ITEM_BYTES } from './snapshots.js';
|
|
8
9
|
/** The most actions one commit may carry, DynamoDB's transaction limit. */
|
|
@@ -14,9 +15,6 @@ export const RESERVED_PREFIXES = Object.freeze([
|
|
|
14
15
|
'SYSTEM#',
|
|
15
16
|
'command-outcome#',
|
|
16
17
|
]);
|
|
17
|
-
// The control rows every commit checks: the feature marker and the rebuild lock.
|
|
18
|
-
const FEATURES_ID = 'SYSTEM#FEATURES';
|
|
19
|
-
const REBUILD_LOCK_ID = 'SYSTEM#REBUILD';
|
|
20
18
|
/** Whether an entity ID is in a reserved namespace. */
|
|
21
19
|
export function isReserved(entityId) {
|
|
22
20
|
return RESERVED_PREFIXES.some((prefix) => entityId.startsWith(prefix));
|
|
@@ -31,11 +29,23 @@ export function checkNotReserved(entityId) {
|
|
|
31
29
|
* Checks that a commit's events can be stored as written: each belongs to the commit's entity and
|
|
32
30
|
* has the ID `{entityId}:{sequence}`, they share one entity type, the first sequence is at least
|
|
33
31
|
* 1, and the sequences are contiguous. A snapshot must have the events' entity type and a
|
|
34
|
-
* sequence of at least 1
|
|
32
|
+
* sequence of at least 1, and each projector group a size per operation. A commit with no events
|
|
33
|
+
* is valid, and its snapshot isn't checked, but its projector operations are refused.
|
|
35
34
|
*/
|
|
36
35
|
export function validateCommit(commit) {
|
|
36
|
+
let operations = 0;
|
|
37
|
+
for (const group of commit.projections ?? []) {
|
|
38
|
+
if (group.sizes.length !== group.operations.length) {
|
|
39
|
+
throw invalidCommit(`a ${group.backend} projector group has ${group.operations.length} operations but ` +
|
|
40
|
+
`${group.sizes.length} sizes`);
|
|
41
|
+
}
|
|
42
|
+
operations += group.operations.length;
|
|
43
|
+
}
|
|
37
44
|
const [first] = commit.events;
|
|
38
45
|
if (first === undefined) {
|
|
46
|
+
if (operations > 0) {
|
|
47
|
+
throw new ProjectorOnlyCommitError(operations);
|
|
48
|
+
}
|
|
39
49
|
return;
|
|
40
50
|
}
|
|
41
51
|
for (const event of commit.events) {
|
|
@@ -74,12 +84,17 @@ export function validateCommit(commit) {
|
|
|
74
84
|
}
|
|
75
85
|
/**
|
|
76
86
|
* The size of each action a commit's transaction carries, in order: the feature-marker and
|
|
77
|
-
* rebuild-lock checks, then the stream's head update, its event puts,
|
|
78
|
-
* it writes one. `ttl` gives the expiry an entity type's items carry, if
|
|
79
|
-
* backend budgets a commit by these sizes, so an oversized commit fails the
|
|
87
|
+
* rebuild-lock checks, the projector operations, then the stream's head update, its event puts,
|
|
88
|
+
* and its snapshot put when it writes one. `ttl` gives the expiry an entity type's items carry, if
|
|
89
|
+
* it's retained. Every backend budgets a commit by these sizes, so an oversized commit fails the
|
|
90
|
+
* same way on each.
|
|
80
91
|
*/
|
|
81
92
|
export function commitSizes(commit, ttl) {
|
|
82
|
-
|
|
93
|
+
// The control rows every commit checks: the feature marker and the rebuild lock.
|
|
94
|
+
const sizes = [controlCheckSize(FEATURES_PK), controlCheckSize(REBUILD_LOCK_PK)];
|
|
95
|
+
for (const group of commit.projections ?? []) {
|
|
96
|
+
sizes.push(...group.sizes);
|
|
97
|
+
}
|
|
83
98
|
const first = commit.events[0];
|
|
84
99
|
const last = commit.events.at(-1);
|
|
85
100
|
if (first === undefined || last === undefined) {
|
package/dist/repository.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6EAA6E;AAE7E,OAAO,EAAC,cAAc,EAAE,UAAU,EAAC,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAC,
|
|
1
|
+
{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}
|
package/dist/store.d.ts
CHANGED
|
@@ -85,8 +85,10 @@ export declare class Store {
|
|
|
85
85
|
load<S, C, D extends EventDefinitions>(aggregate: Aggregate<S, C, D>, entityId: string, options?: CallOptions): Promise<Loaded<S>>;
|
|
86
86
|
/**
|
|
87
87
|
* Loads the aggregate, runs the command, and commits its events, with a snapshot when the
|
|
88
|
-
* commit reaches the snapshot interval
|
|
89
|
-
* is left out, so the commit still succeeds and
|
|
88
|
+
* commit reaches the snapshot interval, and the aggregate's projector operations. A snapshot
|
|
89
|
+
* whose item is over the per-item commit budget is left out, so the commit still succeeds and
|
|
90
|
+
* later loads replay from the one before, but a projector's own items are budgeted as they are:
|
|
91
|
+
* a view row of a state that large fails the commit.
|
|
90
92
|
*
|
|
91
93
|
* A command ID already carried by an event folded in since the latest snapshot makes the
|
|
92
94
|
* command a `duplicate`, and the handler doesn't run. A conflict with another writer throws;
|
|
@@ -94,9 +96,9 @@ export declare class Store {
|
|
|
94
96
|
*/
|
|
95
97
|
execute<S, C, D extends EventDefinitions>(aggregate: Aggregate<S, C, D>, entityId: string, command: C, options?: ExecuteOptions): Promise<ExecuteResult<S>>;
|
|
96
98
|
/**
|
|
97
|
-
* Like {@link execute}, but loads and runs the command again after a retryable error (
|
|
98
|
-
*
|
|
99
|
-
* error is thrown. A rejection or a duplicate is a result, never retried.
|
|
99
|
+
* Like {@link execute}, but loads and runs the command again after a retryable error (see
|
|
100
|
+
* {@link isRetryable}), waiting {@link retryDelay} between attempts. When the attempts run out,
|
|
101
|
+
* the last error is thrown. A rejection or a duplicate is a result, never retried.
|
|
100
102
|
*/
|
|
101
103
|
executeWithRetry<S, C, D extends EventDefinitions>(aggregate: Aggregate<S, C, D>, entityId: string, command: C, options?: RetryOptions): Promise<ExecuteResult<S>>;
|
|
102
104
|
}
|
package/dist/store.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
|
package/dist/store.js
CHANGED
|
@@ -59,8 +59,10 @@ export class Store {
|
|
|
59
59
|
}
|
|
60
60
|
/**
|
|
61
61
|
* Loads the aggregate, runs the command, and commits its events, with a snapshot when the
|
|
62
|
-
* commit reaches the snapshot interval
|
|
63
|
-
* is left out, so the commit still succeeds and
|
|
62
|
+
* commit reaches the snapshot interval, and the aggregate's projector operations. A snapshot
|
|
63
|
+
* whose item is over the per-item commit budget is left out, so the commit still succeeds and
|
|
64
|
+
* later loads replay from the one before, but a projector's own items are budgeted as they are:
|
|
65
|
+
* a view row of a state that large fails the commit.
|
|
64
66
|
*
|
|
65
67
|
* A command ID already carried by an event folded in since the latest snapshot makes the
|
|
66
68
|
* command a `duplicate`, and the handler doesn't run. A conflict with another writer throws;
|
|
@@ -80,14 +82,14 @@ export class Store {
|
|
|
80
82
|
if (decision.events.length === 0) {
|
|
81
83
|
return { kind: 'committed', state: loaded, events: [] };
|
|
82
84
|
}
|
|
83
|
-
const { state, events, snapshot } = this.#stage(aggregate, loaded, decision.events, metadata);
|
|
84
|
-
await this.repository.commit({ entityId, events, snapshot }, options);
|
|
85
|
+
const { state, events, snapshot, projections } = this.#stage(aggregate, loaded, decision.events, metadata);
|
|
86
|
+
await this.repository.commit({ entityId, events, snapshot, projections }, options);
|
|
85
87
|
return { kind: 'committed', state, events };
|
|
86
88
|
}
|
|
87
89
|
/**
|
|
88
|
-
* Like {@link execute}, but loads and runs the command again after a retryable error (
|
|
89
|
-
*
|
|
90
|
-
* error is thrown. A rejection or a duplicate is a result, never retried.
|
|
90
|
+
* Like {@link execute}, but loads and runs the command again after a retryable error (see
|
|
91
|
+
* {@link isRetryable}), waiting {@link retryDelay} between attempts. When the attempts run out,
|
|
92
|
+
* the last error is thrown. A rejection or a duplicate is a result, never retried.
|
|
91
93
|
*/
|
|
92
94
|
async executeWithRetry(aggregate, entityId, command, options = {}) {
|
|
93
95
|
const policy = options.policy ?? DEFAULT_RETRY_POLICY;
|
|
@@ -148,8 +150,8 @@ export class Store {
|
|
|
148
150
|
}
|
|
149
151
|
return { entityId, state, sequence, snapshotSequence, seenCommandIds };
|
|
150
152
|
}
|
|
151
|
-
// Applies the decided events, and builds the stored events
|
|
152
|
-
//
|
|
153
|
+
// Applies the decided events, and builds the stored events, the snapshot the policy calls for,
|
|
154
|
+
// and the projectors' operations. The state is only used once the commit succeeds.
|
|
153
155
|
#stage(aggregate, loaded, decided, metadata) {
|
|
154
156
|
const entityId = loaded.entityId;
|
|
155
157
|
let sequence = loaded.sequence;
|
|
@@ -201,8 +203,31 @@ export class Store {
|
|
|
201
203
|
},
|
|
202
204
|
events,
|
|
203
205
|
snapshot,
|
|
206
|
+
projections: this.#project(aggregate, entityId, state, events, snapshot),
|
|
204
207
|
};
|
|
205
208
|
}
|
|
209
|
+
// The operations the aggregate's projectors add to the commit, in declaration order.
|
|
210
|
+
#project(aggregate, entityId, state, events, snapshot) {
|
|
211
|
+
const projectors = aggregate.projectors ?? [];
|
|
212
|
+
if (projectors.length === 0) {
|
|
213
|
+
return [];
|
|
214
|
+
}
|
|
215
|
+
// Each projector gets its own frozen copy of the events, their metadata and every byte array,
|
|
216
|
+
// so none can change what another one sees, or what the commit writes.
|
|
217
|
+
const encodedState = snapshot?.payload ?? aggregate.state.encode(state);
|
|
218
|
+
const detached = () => Object.freeze({
|
|
219
|
+
entityType: aggregate.type,
|
|
220
|
+
entityId,
|
|
221
|
+
state,
|
|
222
|
+
encodedState: encodedState.slice(),
|
|
223
|
+
events: Object.freeze(events.map((event) => Object.freeze({
|
|
224
|
+
...event,
|
|
225
|
+
payload: event.payload && event.payload.slice(),
|
|
226
|
+
metadata: Object.freeze(copyMetadata(event.metadata)),
|
|
227
|
+
}))),
|
|
228
|
+
});
|
|
229
|
+
return projectors.flatMap((projector) => projector.project(detached()) ?? []);
|
|
230
|
+
}
|
|
206
231
|
// The command's metadata with the store's region and the clock's timestamp where it has none,
|
|
207
232
|
// and the commit ID the engine stamps: the command ID, else the caller's, else a generated one.
|
|
208
233
|
// Field by field, so a field an untyped caller set to undefined is empty too, and every key is
|
package/dist/store.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6BAA6B;AAE7B,OAAO,
|
|
1
|
+
{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
|