@baukit/data-contracts 0.1.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/memory.js ADDED
@@ -0,0 +1,283 @@
1
+ import { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, StorageError, normalizeStorageError, } from './contracts.js';
2
+ const CURSOR_PREFIX = 'bk1:';
3
+ function cloneUnknown(value) {
4
+ if (Array.isArray(value)) {
5
+ return value.map((item) => cloneUnknown(item));
6
+ }
7
+ if (value !== null && typeof value === 'object') {
8
+ return Object.fromEntries(Object.entries(value).map(([key, item]) => [
9
+ key,
10
+ cloneUnknown(item),
11
+ ]));
12
+ }
13
+ return value;
14
+ }
15
+ function clone(value) {
16
+ return cloneUnknown(value);
17
+ }
18
+ function compareIds(left, right) {
19
+ return left < right ? -1 : left > right ? 1 : 0;
20
+ }
21
+ function pageLimit(options) {
22
+ const limit = options?.limit ?? DEFAULT_PAGE_SIZE;
23
+ if (!Number.isInteger(limit) || limit < 1 || limit > MAX_PAGE_SIZE) {
24
+ throw new RangeError(`Page limit must be an integer from 1 to ${String(MAX_PAGE_SIZE)}.`);
25
+ }
26
+ return limit;
27
+ }
28
+ function encodeCursor(id) {
29
+ return `${CURSOR_PREFIX}${encodeURIComponent(id)}`;
30
+ }
31
+ function decodeCursor(cursor) {
32
+ if (!cursor.startsWith(CURSOR_PREFIX)) {
33
+ throw new TypeError('Invalid record cursor.');
34
+ }
35
+ try {
36
+ return decodeURIComponent(cursor.slice(CURSOR_PREFIX.length));
37
+ }
38
+ catch {
39
+ throw new TypeError('Invalid record cursor.');
40
+ }
41
+ }
42
+ function assertStoreOpen(lifecycle) {
43
+ if (lifecycle.status !== 'open') {
44
+ throw new StorageError('storage_closed', 'The storage adapter is closed.');
45
+ }
46
+ }
47
+ function emptyState() {
48
+ return {
49
+ keyValues: { values: new Map() },
50
+ records: { values: new Map() },
51
+ schemaMetadata: { value: undefined },
52
+ };
53
+ }
54
+ function copyState(state) {
55
+ return {
56
+ keyValues: {
57
+ values: new Map([...state.keyValues.values].map(([key, value]) => [key, clone(value)])),
58
+ },
59
+ records: {
60
+ values: new Map([...state.records.values].map(([key, value]) => [key, clone(value)])),
61
+ },
62
+ schemaMetadata: {
63
+ value: state.schemaMetadata.value === undefined ? undefined : clone(state.schemaMetadata.value),
64
+ },
65
+ };
66
+ }
67
+ /** Dependency-free reference key/value adapter. */
68
+ export class InMemoryKeyValueStore {
69
+ state;
70
+ assertAvailable;
71
+ constructor(state = { values: new Map() }, assertAvailable = () => undefined) {
72
+ this.state = state;
73
+ this.assertAvailable = assertAvailable;
74
+ }
75
+ get(key) {
76
+ return Promise.resolve().then(() => {
77
+ this.assertAvailable();
78
+ const value = this.state.values.get(key);
79
+ return value === undefined ? undefined : clone(value);
80
+ });
81
+ }
82
+ set(key, value) {
83
+ return Promise.resolve().then(() => {
84
+ this.assertAvailable();
85
+ this.state.values.set(key, clone(value));
86
+ });
87
+ }
88
+ delete(key) {
89
+ return Promise.resolve().then(() => {
90
+ this.assertAvailable();
91
+ this.state.values.delete(key);
92
+ });
93
+ }
94
+ clear() {
95
+ return Promise.resolve().then(() => {
96
+ this.assertAvailable();
97
+ this.state.values.clear();
98
+ });
99
+ }
100
+ }
101
+ /** Dependency-free reference record adapter using ID-based keyset cursors. */
102
+ export class InMemoryRecordStore {
103
+ state;
104
+ assertAvailable;
105
+ constructor(state = { values: new Map() }, assertAvailable = () => undefined) {
106
+ this.state = state;
107
+ this.assertAvailable = assertAvailable;
108
+ }
109
+ put(record) {
110
+ return Promise.resolve().then(() => {
111
+ this.assertAvailable();
112
+ if (record.id.length === 0) {
113
+ throw new TypeError('Record id must not be empty.');
114
+ }
115
+ this.state.values.set(record.id, clone(record));
116
+ });
117
+ }
118
+ get(id) {
119
+ return Promise.resolve().then(() => {
120
+ this.assertAvailable();
121
+ const record = this.state.values.get(id);
122
+ return record === undefined ? undefined : clone(record);
123
+ });
124
+ }
125
+ delete(id) {
126
+ return Promise.resolve().then(() => {
127
+ this.assertAvailable();
128
+ this.state.values.delete(id);
129
+ });
130
+ }
131
+ list(options) {
132
+ return Promise.resolve().then(() => {
133
+ this.assertAvailable();
134
+ const limit = pageLimit(options);
135
+ const afterId = options?.cursor === undefined || options.cursor === null
136
+ ? undefined
137
+ : decodeCursor(options.cursor);
138
+ const ordered = [...this.state.values.values()]
139
+ .filter((record) => afterId === undefined || compareIds(record.id, afterId) > 0)
140
+ .sort((left, right) => compareIds(left.id, right.id));
141
+ const pageItems = ordered.slice(0, limit);
142
+ const last = pageItems.at(-1);
143
+ return {
144
+ items: clone(pageItems),
145
+ nextCursor: ordered.length > limit && last !== undefined ? encodeCursor(last.id) : null,
146
+ };
147
+ });
148
+ }
149
+ }
150
+ /** Dependency-free reference schema metadata adapter. */
151
+ export class InMemorySchemaMetadataStore {
152
+ state;
153
+ assertAvailable;
154
+ constructor(state = { value: undefined }, assertAvailable = () => undefined) {
155
+ this.state = state;
156
+ this.assertAvailable = assertAvailable;
157
+ }
158
+ getSchemaMeta() {
159
+ return Promise.resolve().then(() => {
160
+ this.assertAvailable();
161
+ return this.state.value === undefined ? undefined : clone(this.state.value);
162
+ });
163
+ }
164
+ setSchemaMeta(metadata) {
165
+ return Promise.resolve().then(() => {
166
+ this.assertAvailable();
167
+ if (metadata.name.length === 0) {
168
+ throw new TypeError('Schema name must not be empty.');
169
+ }
170
+ if (!Number.isInteger(metadata.version) || metadata.version < 0) {
171
+ throw new TypeError('Schema version must be a non-negative integer.');
172
+ }
173
+ this.state.value = clone(metadata);
174
+ });
175
+ }
176
+ }
177
+ /** A transaction-scoped in-memory view. It must not be retained after the callback. */
178
+ export class InMemoryTransaction {
179
+ state;
180
+ keyValues;
181
+ records;
182
+ schemaMetadata;
183
+ active = true;
184
+ constructor(state, assertAvailable) {
185
+ this.state = state;
186
+ const assertTransactionActive = assertAvailable ??
187
+ (() => {
188
+ if (!this.active) {
189
+ throw new StorageError('storage_closed', 'The transaction context is no longer active.');
190
+ }
191
+ });
192
+ this.keyValues = new InMemoryKeyValueStore(state.keyValues, assertTransactionActive);
193
+ this.records = new InMemoryRecordStore(state.records, assertTransactionActive);
194
+ this.schemaMetadata = new InMemorySchemaMetadataStore(state.schemaMetadata, assertTransactionActive);
195
+ }
196
+ withTransaction(operation) {
197
+ return Promise.resolve().then(() => {
198
+ if (!this.active) {
199
+ throw new StorageError('storage_closed', 'The transaction context is no longer active.');
200
+ }
201
+ return operation(this);
202
+ });
203
+ }
204
+ finish() {
205
+ this.active = false;
206
+ }
207
+ }
208
+ /** Composite reference adapter with snapshot-backed atomic transactions. */
209
+ export class InMemoryStore extends InMemoryTransaction {
210
+ transactionTail = Promise.resolve();
211
+ lifecycle;
212
+ constructor(state = emptyState()) {
213
+ const lifecycle = { status: 'open' };
214
+ super(state, () => {
215
+ assertStoreOpen(lifecycle);
216
+ });
217
+ this.lifecycle = lifecycle;
218
+ }
219
+ async withTransaction(operation) {
220
+ assertStoreOpen(this.lifecycle);
221
+ const previous = this.transactionTail;
222
+ let release = () => undefined;
223
+ this.transactionTail = new Promise((resolve) => {
224
+ release = resolve;
225
+ });
226
+ await previous;
227
+ let transaction;
228
+ try {
229
+ assertStoreOpen(this.lifecycle);
230
+ const pending = copyState(this.state);
231
+ transaction = new InMemoryTransaction(pending);
232
+ const result = await operation(transaction);
233
+ this.state.keyValues.values = pending.keyValues.values;
234
+ this.state.records.values = pending.records.values;
235
+ this.state.schemaMetadata.value = pending.schemaMetadata.value;
236
+ return result;
237
+ }
238
+ catch (cause) {
239
+ throw normalizeStorageError(cause);
240
+ }
241
+ finally {
242
+ transaction?.finish();
243
+ release();
244
+ }
245
+ }
246
+ async close() {
247
+ if (this.lifecycle.status === 'closed') {
248
+ return;
249
+ }
250
+ this.lifecycle.status = 'closing';
251
+ await this.transactionTail;
252
+ this.lifecycle.status = 'closed';
253
+ }
254
+ async migrate(from, to) {
255
+ const current = await this.schemaMetadata.getSchemaMeta();
256
+ if (current?.name !== from.name || current.version !== from.version) {
257
+ throw new Error('Current schema metadata does not match the migration source.');
258
+ }
259
+ if (from.name !== to.name) {
260
+ throw new Error('A migration cannot change the schema name.');
261
+ }
262
+ if (to.version <= from.version) {
263
+ throw new Error('A migration target version must be greater than its source.');
264
+ }
265
+ await this.schemaMetadata.setSchemaMeta(to);
266
+ }
267
+ }
268
+ /** Named persistent backing for exercising close/reopen identity transitions in memory. */
269
+ export class InMemoryStorePool {
270
+ databases = new Map();
271
+ open(storeName) {
272
+ if (storeName.trim().length === 0) {
273
+ throw new TypeError('Store name must not be empty.');
274
+ }
275
+ let state = this.databases.get(storeName);
276
+ if (state === undefined) {
277
+ state = emptyState();
278
+ this.databases.set(storeName, state);
279
+ }
280
+ return new InMemoryStore(state);
281
+ }
282
+ }
283
+ //# sourceMappingURL=memory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { type JsonValue, type KeyValueStore, type RecordStore, type SchemaMetadataStore, type StorageTransaction, type StoredRecord, type Transaction, type TransactionalStorageStore } from './contracts.js';
2
+ export type ContractStoreFactory<TStore> = () => Promise<TStore> | TStore;
3
+ /** Canonical JSON-shaped record supplied to adapter contract suites. */
4
+ export interface ContractTestRecord extends StoredRecord {
5
+ readonly label: string;
6
+ readonly payload: JsonValue;
7
+ }
8
+ /** Registers the provider-neutral key/value contract in the current Vitest suite. */
9
+ export declare function describeKeyValueContract(makeStore: ContractStoreFactory<KeyValueStore>): void;
10
+ /** Registers CRUD, bounds, and stable keyset-pagination requirements. */
11
+ export declare function describeRecordStoreContract(makeStore: ContractStoreFactory<RecordStore<ContractTestRecord>>): void;
12
+ export interface TransactionContractStore<T extends StoredRecord> extends StorageTransaction<T>, Transaction<StorageTransaction<T>> {
13
+ }
14
+ /** Registers commit, result, and rollback-on-throw transaction requirements. */
15
+ export declare function describeTransactionContract(makeStore: ContractStoreFactory<TransactionContractStore<ContractTestRecord>>): void;
16
+ /**
17
+ * Registers lifecycle, reentrancy, compound atomicity, quota normalization,
18
+ * and serialization requirements for a complete composite adapter.
19
+ */
20
+ export declare function describeTransactionalStorageContract(makeStore: ContractStoreFactory<TransactionalStorageStore<ContractTestRecord>>): void;
21
+ /** Registers persistence and replacement behavior for schema metadata. */
22
+ export declare function describeSchemaMetadataContract(makeStore: ContractStoreFactory<SchemaMetadataStore>): void;
23
+ /** Adapter seam for identity-transition tests that must reopen named stores. */
24
+ export interface ScopedPersistenceContractAdapter {
25
+ open(storeName: string): Promise<TransactionalStorageStore<ContractTestRecord>>;
26
+ }
27
+ /**
28
+ * Registers the E -> F -> E ownership suite against an adapter capable of
29
+ * reopening independent named databases.
30
+ */
31
+ export declare function describeScopedPersistenceContract(makeAdapter: ContractStoreFactory<ScopedPersistenceContractAdapter>): void;
32
+ //# sourceMappingURL=vitest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAOxB,MAAM,MAAM,oBAAoB,CAAC,MAAM,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B;AASD,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAAG,IAAI,CAkC7F;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,GAC/D,IAAI,CA4DN;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,YAAY,CAC9D,SAAQ,kBAAkB,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAAG;AAEtE,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC,GAC5E,IAAI,CAuCN;AAQD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,GAC7E,IAAI,CAoIN;AAED,0EAA0E;AAC1E,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,GACnD,IAAI,CAWN;AAED,gFAAgF;AAChF,MAAM,WAAW,gCAAgC;IAC/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,CAAC;CACjF;AAUD;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,oBAAoB,CAAC,gCAAgC,CAAC,GAClE,IAAI,CAyNN"}