@baukit/data-contracts 0.4.0 → 0.5.1

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.
@@ -0,0 +1,335 @@
1
+ import { normalizeStorageError } from './contracts.js';
2
+ /** A storage failure. The message names only the operation, never keys or draft content. */
3
+ export class DraftPersistenceError extends Error {
4
+ operation;
5
+ name = 'DraftPersistenceError';
6
+ code = 'draft_persistence_failed';
7
+ constructor(operation, options) {
8
+ super(`Draft ${operation} failed.`, options);
9
+ this.operation = operation;
10
+ }
11
+ }
12
+ function isEnvelope(stored) {
13
+ if (typeof stored !== 'object' || stored === null || Array.isArray(stored)) {
14
+ return false;
15
+ }
16
+ const version = stored['version'];
17
+ return (typeof version === 'number' && Number.isSafeInteger(version) && version > 0 && 'value' in stored);
18
+ }
19
+ function decodeStored(stored, codec) {
20
+ if (stored === undefined) {
21
+ return { recovery: 'none' };
22
+ }
23
+ if (!isEnvelope(stored)) {
24
+ return { recovery: 'corrupt' };
25
+ }
26
+ if (stored.version > codec.version) {
27
+ return { recovery: 'unsupported-version' };
28
+ }
29
+ let result;
30
+ try {
31
+ result = codec.decode(stored.value, stored.version);
32
+ }
33
+ catch {
34
+ return { recovery: 'corrupt' };
35
+ }
36
+ if (result.kind !== 'decoded') {
37
+ return { recovery: result.kind };
38
+ }
39
+ return {
40
+ recovery: 'restored',
41
+ value: result.value,
42
+ upgraded: stored.version < codec.version,
43
+ };
44
+ }
45
+ function isBlocked(recovery) {
46
+ return recovery === 'corrupt' || recovery === 'unsupported-version';
47
+ }
48
+ function persistenceError(operation, cause) {
49
+ return new DraftPersistenceError(operation, { cause: normalizeStorageError(cause) });
50
+ }
51
+ function asError(error) {
52
+ return error instanceof Error ? error : new Error(String(error));
53
+ }
54
+ const CLOSED = { open: false };
55
+ class DefaultDurableDraft {
56
+ #store;
57
+ #key;
58
+ #codec;
59
+ #isScopeActive;
60
+ #listeners = new Set();
61
+ #session = null;
62
+ #persistedRevision = 0;
63
+ /** True while the current key holds a draft this session read or wrote. */
64
+ #stored = false;
65
+ #tail = Promise.resolve();
66
+ #snapshot = CLOSED;
67
+ constructor(options) {
68
+ const { version } = options.codec;
69
+ if (!Number.isSafeInteger(version) || version < 1) {
70
+ throw new RangeError('Draft codec version must be a positive integer.');
71
+ }
72
+ this.#store = options.store;
73
+ this.#key = options.key;
74
+ this.#codec = options.codec;
75
+ this.#isScopeActive = options.isScopeActive ?? (() => true);
76
+ }
77
+ getSnapshot() {
78
+ return this.#snapshot;
79
+ }
80
+ subscribe(listener) {
81
+ this.#listeners.add(listener);
82
+ return () => {
83
+ this.#listeners.delete(listener);
84
+ };
85
+ }
86
+ open(scope, initial) {
87
+ let key;
88
+ try {
89
+ key = this.#key(scope);
90
+ }
91
+ catch (error) {
92
+ return Promise.reject(asError(error));
93
+ }
94
+ const session = { scope, key, initial };
95
+ this.#session = session;
96
+ this.#persistedRevision = 0;
97
+ this.#stored = false;
98
+ this.#publish({
99
+ open: true,
100
+ scope,
101
+ value: initial,
102
+ localRevision: 0,
103
+ dirty: false,
104
+ recovery: 'none',
105
+ persistence: 'loading',
106
+ error: null,
107
+ submission: 'none',
108
+ });
109
+ return this.#enqueue(() => this.#load(session));
110
+ }
111
+ update(value) {
112
+ const current = this.#current();
113
+ if (current === null) {
114
+ return;
115
+ }
116
+ this.#publishOpen({
117
+ value,
118
+ localRevision: current.localRevision + 1,
119
+ submission: 'none',
120
+ });
121
+ }
122
+ save() {
123
+ const session = this.#session;
124
+ if (session === null) {
125
+ return Promise.resolve('stale');
126
+ }
127
+ return this.#enqueue(() => this.#write(session));
128
+ }
129
+ clear(request) {
130
+ const session = this.#session;
131
+ if (session === null) {
132
+ return Promise.resolve('stale');
133
+ }
134
+ return this.#enqueue(() => this.#delete(session, request));
135
+ }
136
+ move(scope) {
137
+ const session = this.#session;
138
+ if (session === null) {
139
+ return Promise.resolve('stale');
140
+ }
141
+ let key;
142
+ try {
143
+ key = this.#key(scope);
144
+ }
145
+ catch (error) {
146
+ return Promise.reject(asError(error));
147
+ }
148
+ return this.#enqueue(() => this.#relocate(session, scope, key));
149
+ }
150
+ async close() {
151
+ this.#session = null;
152
+ this.#publish(CLOSED);
153
+ await this.#tail;
154
+ }
155
+ async #load(session) {
156
+ if (session !== this.#session) {
157
+ return;
158
+ }
159
+ let stored;
160
+ try {
161
+ stored = await this.#store.get(session.key);
162
+ }
163
+ catch (cause) {
164
+ this.#publishFor(session, {
165
+ recovery: 'unavailable',
166
+ persistence: 'failed',
167
+ error: persistenceError('read', cause),
168
+ });
169
+ return;
170
+ }
171
+ const current = this.#currentFor(session);
172
+ if (current === null) {
173
+ return;
174
+ }
175
+ this.#stored = stored !== undefined;
176
+ const loaded = decodeStored(stored, this.#codec);
177
+ if (loaded.recovery === 'restored' && current.localRevision === 0) {
178
+ this.#persistedRevision = loaded.upgraded ? null : 0;
179
+ this.#publishOpen({ value: loaded.value, recovery: 'restored', persistence: 'idle' });
180
+ return;
181
+ }
182
+ this.#publishOpen({
183
+ recovery: loaded.recovery === 'restored' ? 'none' : loaded.recovery,
184
+ persistence: 'idle',
185
+ });
186
+ }
187
+ async #write(session) {
188
+ const current = this.#activeFor(session);
189
+ if (current === null) {
190
+ return 'stale';
191
+ }
192
+ if (!current.dirty) {
193
+ return 'clean';
194
+ }
195
+ if (isBlocked(current.recovery)) {
196
+ return 'blocked';
197
+ }
198
+ const { localRevision } = current;
199
+ await this.#writeValue(session, session.key, current.value);
200
+ if (this.#currentFor(session) !== null) {
201
+ this.#persistedRevision = localRevision;
202
+ this.#stored = true;
203
+ this.#publishOpen({ persistence: 'idle', error: null });
204
+ }
205
+ return 'saved';
206
+ }
207
+ async #delete(session, request) {
208
+ const current = this.#activeFor(session);
209
+ if (current === null) {
210
+ return 'stale';
211
+ }
212
+ const submitted = request.reason === 'submitted';
213
+ if (submitted && request.localRevision !== current.localRevision) {
214
+ this.#publishOpen({ submission: 'confirmed' });
215
+ return 'newer-edits-kept';
216
+ }
217
+ const { localRevision } = current;
218
+ const submission = submitted ? 'confirmed' : current.submission;
219
+ await this.#deleteKey(session, session.key, { submission });
220
+ if (this.#currentFor(session) !== null) {
221
+ this.#applyCleared(session, localRevision, submitted);
222
+ }
223
+ return 'cleared';
224
+ }
225
+ async #relocate(session, scope, key) {
226
+ const current = this.#activeFor(session);
227
+ if (current === null || !this.#isScopeActive(scope)) {
228
+ return 'stale';
229
+ }
230
+ if (isBlocked(current.recovery)) {
231
+ return 'blocked';
232
+ }
233
+ if (key === session.key) {
234
+ session.scope = scope;
235
+ this.#publishOpen({ scope });
236
+ return 'moved';
237
+ }
238
+ const carried = current.dirty || this.#stored;
239
+ const { localRevision } = current;
240
+ if (carried) {
241
+ await this.#writeValue(session, key, current.value);
242
+ }
243
+ await this.#deleteKey(session, session.key, {});
244
+ session.scope = scope;
245
+ session.key = key;
246
+ if (this.#currentFor(session) !== null) {
247
+ if (carried) {
248
+ this.#persistedRevision = localRevision;
249
+ }
250
+ this.#stored = carried;
251
+ this.#publishOpen({ scope, persistence: 'idle', error: null });
252
+ }
253
+ return 'moved';
254
+ }
255
+ async #writeValue(session, key, value) {
256
+ this.#publishOpen({ persistence: 'saving', error: null });
257
+ try {
258
+ const envelope = { version: this.#codec.version, value: this.#codec.encode(value) };
259
+ await this.#store.set(key, envelope);
260
+ }
261
+ catch (cause) {
262
+ const error = persistenceError('write', cause);
263
+ this.#publishFor(session, { persistence: 'failed', error });
264
+ throw error;
265
+ }
266
+ }
267
+ async #deleteKey(session, key, changes) {
268
+ this.#publishFor(session, { ...changes, persistence: 'clearing', error: null });
269
+ try {
270
+ await this.#store.delete(key);
271
+ }
272
+ catch (cause) {
273
+ const error = persistenceError('delete', cause);
274
+ this.#publishFor(session, { persistence: 'failed', error });
275
+ throw error;
276
+ }
277
+ }
278
+ #applyCleared(session, localRevision, submitted) {
279
+ this.#stored = false;
280
+ const base = { recovery: 'none', persistence: 'idle', error: null };
281
+ if (submitted) {
282
+ this.#persistedRevision = localRevision;
283
+ this.#publishOpen(base);
284
+ return;
285
+ }
286
+ const current = this.#current();
287
+ const nextRevision = (current?.localRevision ?? localRevision) + 1;
288
+ this.#persistedRevision = nextRevision;
289
+ this.#publishOpen({
290
+ ...base,
291
+ value: session.initial,
292
+ localRevision: nextRevision,
293
+ submission: 'none',
294
+ });
295
+ }
296
+ #enqueue(operation) {
297
+ const run = this.#tail.then(operation);
298
+ this.#tail = run.catch(() => undefined);
299
+ return run;
300
+ }
301
+ #current() {
302
+ return this.#snapshot.open ? this.#snapshot : null;
303
+ }
304
+ #currentFor(session) {
305
+ return session === this.#session ? this.#current() : null;
306
+ }
307
+ #activeFor(session) {
308
+ const current = this.#currentFor(session);
309
+ return current !== null && this.#isScopeActive(session.scope) ? current : null;
310
+ }
311
+ #publishFor(session, changes) {
312
+ if (this.#currentFor(session) !== null) {
313
+ this.#publishOpen(changes);
314
+ }
315
+ }
316
+ #publishOpen(changes) {
317
+ const current = this.#current();
318
+ if (current === null) {
319
+ return;
320
+ }
321
+ const next = { ...current, ...changes };
322
+ this.#publish({ ...next, dirty: next.localRevision !== this.#persistedRevision });
323
+ }
324
+ #publish(snapshot) {
325
+ this.#snapshot = snapshot;
326
+ for (const listener of this.#listeners) {
327
+ listener();
328
+ }
329
+ }
330
+ }
331
+ /** Creates a framework-free durable draft over a `KeyValueStore`. */
332
+ export function createDurableDraft(options) {
333
+ return new DefaultDurableDraft(options);
334
+ }
335
+ //# sourceMappingURL=durable-draft.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durable-draft.js","sourceRoot":"","sources":["../src/durable-draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAsB3F,4FAA4F;AAC5F,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAK5B;IAJO,IAAI,GAAG,uBAAuB,CAAC;IACxC,IAAI,GAAG,0BAA0B,CAAC;IAElD,YACkB,SAAoC,EACpD,OAAsB;QAEtB,KAAK,CAAC,SAAS,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;QAH7B,cAAS,GAAT,SAAS,CAA2B;IAItD,CAAC;CACF;AAkGD,SAAS,UAAU,CAAC,MAAiB;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,IAAI,MAAM,CACjG,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,MAA6B,EAC7B,KAAyB;IAEzB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,MAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,QAAuB;IACxC,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,qBAAqB,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAoC,EACpC,KAAc;IAEd,OAAO,IAAI,qBAAqB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,MAAM,GAA+B,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAE3D,MAAM,mBAAmB;IACd,MAAM,CAAgB;IACtB,IAAI,CAA4B;IAChC,MAAM,CAAqB;IAC3B,cAAc,CAA6B;IAC3C,UAAU,GAAG,IAAI,GAAG,EAAc,CAAC;IAC5C,QAAQ,GAAmC,IAAI,CAAC;IAChD,kBAAkB,GAAkB,CAAC,CAAC;IACtC,2EAA2E;IAC3E,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,SAAS,GAAyC,MAAM,CAAC;IAEzD,YAAY,OAA4C;QACtD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,OAAe;QACjC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,OAAO,GAA4B,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,IAAI;YACV,KAAK;YACL,KAAK,EAAE,OAAO;YACd,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC;YAChB,KAAK;YACL,aAAa,EAAE,OAAO,CAAC,aAAa,GAAG,CAAC;YACxC,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAA0B;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,MAAM,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAgC;QAC1C,IAAI,OAAO,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,MAA6B,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;gBACxB,QAAQ,EAAE,aAAa;gBACvB,WAAW,EAAE,QAAQ;gBACrB,KAAK,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC;aACvC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YAClE,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YACtF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ;YACnE,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAgC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAClC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,kBAAkB,GAAG,aAAa,CAAC;YACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAAgC,EAChC,OAA0B;QAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC;QACjD,IAAI,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC;YACjE,IAAI,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/C,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAClC,MAAM,UAAU,GAAoB,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACjF,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAgC,EAChC,KAAa,EACb,GAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;QAC9C,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QAClB,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,kBAAkB,GAAG,aAAa,CAAC;YAC1C,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgC,EAAE,GAAW,EAAE,KAAa;QAC5E,IAAI,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAgC,EAChC,GAAW,EACX,OAA0D;QAE1D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,aAAa,CAAC,OAAgC,EAAE,aAAqB,EAAE,SAAkB;QACvF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAW,CAAC;QAC7E,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,kBAAkB,GAAG,aAAa,CAAC;YACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,aAAa,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACnE,IAAI,CAAC,kBAAkB,GAAG,YAAY,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC;YAChB,GAAG,IAAI;YACP,KAAK,EAAE,OAAO,CAAC,OAAO;YACtB,aAAa,EAAE,YAAY;YAC3B,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAU,SAAiC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,WAAW,CAAC,OAAgC;QAC1C,OAAO,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,UAAU,CAAC,OAAgC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,CAAC;IAED,WAAW,CACT,OAAgC,EAChC,OAA0D;QAE1D,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,YAAY,CAAC,OAA0D;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAChC,OAA4C;IAE5C,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,28 @@
1
+ export interface CsvNumericCell {
2
+ readonly numeric: string;
3
+ }
4
+ export type CsvCell = string | number | CsvNumericCell | null;
5
+ export interface EncodeCsvOptions {
6
+ readonly neutralizeFormulas?: boolean;
7
+ readonly byteOrderMark?: boolean;
8
+ /** Quotes every text and numeric cell. Null cells stay unquoted, so a reader can tell them from empty text. */
9
+ readonly quoteAllCells?: boolean;
10
+ /**
11
+ * Written unquoted for a null cell; a text cell with the same content is quoted. Must be non-empty
12
+ * and free of double quotes, commas, CR, and LF.
13
+ */
14
+ readonly nullMarker?: string;
15
+ }
16
+ export type CsvEncodeErrorCode = 'invalid_numeric_cell' | 'invalid_unicode' | 'unsupported_cell';
17
+ export declare class CsvEncodeError extends Error {
18
+ readonly name = "CsvEncodeError";
19
+ readonly code: CsvEncodeErrorCode;
20
+ readonly rowIndex: number;
21
+ readonly columnIndex: number;
22
+ constructor(code: CsvEncodeErrorCode, rowIndex: number, columnIndex: number);
23
+ }
24
+ export declare const SHARE_OUTCOMES: readonly ["shared", "saved", "cancelled", "unavailable", "failed"];
25
+ export type ShareOutcome = (typeof SHARE_OUTCOMES)[number];
26
+ export declare function csvNumeric(value: string): CsvNumericCell;
27
+ export declare function encodeCsv(rows: Iterable<readonly CsvCell[]>, options?: EncodeCsvOptions): string;
28
+ //# sourceMappingURL=export.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,+GAA+G;IAC/G,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEjG,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAyB,IAAI,oBAAoB;IACjD,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IACzC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAMnF;AAED,eAAO,MAAM,cAAc,oEAAqE,CAAC;AAEjG,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AA2B3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAExD;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,CAAC,SAAS,OAAO,EAAE,CAAC,EAClC,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CASR"}
package/dist/export.js ADDED
@@ -0,0 +1,121 @@
1
+ export class CsvEncodeError extends Error {
2
+ name = 'CsvEncodeError';
3
+ code;
4
+ rowIndex;
5
+ columnIndex;
6
+ constructor(code, rowIndex, columnIndex) {
7
+ super(`CSV cell rejected: ${code} at row ${String(rowIndex)}, column ${String(columnIndex)}`);
8
+ this.code = code;
9
+ this.rowIndex = rowIndex;
10
+ this.columnIndex = columnIndex;
11
+ }
12
+ }
13
+ export const SHARE_OUTCOMES = ['shared', 'saved', 'cancelled', 'unavailable', 'failed'];
14
+ const BYTE_ORDER_MARK_CODE_POINT = 0xfeff;
15
+ const BYTE_ORDER_MARK = String.fromCodePoint(BYTE_ORDER_MARK_CODE_POINT);
16
+ const RECORD_SEPARATOR = '\r\n';
17
+ const FORMULA_ESCAPE = "'";
18
+ const NUMERIC_PATTERN = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/;
19
+ const QUOTE_REQUIRED_PATTERN = /[",\r\n]/;
20
+ const HIGH_SURROGATE_MIN = 0xd800;
21
+ const HIGH_SURROGATE_MAX = 0xdbff;
22
+ const LOW_SURROGATE_MIN = 0xdc00;
23
+ const LOW_SURROGATE_MAX = 0xdfff;
24
+ const LEADING_WHITESPACE_PATTERN = /^[ \t\r\n]*/;
25
+ const FORMULA_TRIGGERS = new Set(['=', '+', '-', '@']);
26
+ const CONTROL_TRIGGERS = new Set(['\t', '\r']);
27
+ export function csvNumeric(value) {
28
+ return { numeric: value };
29
+ }
30
+ export function encodeCsv(rows, options = {}) {
31
+ const policy = writePolicy(options);
32
+ let output = options.byteOrderMark === true ? BYTE_ORDER_MARK : '';
33
+ let rowIndex = 0;
34
+ for (const row of rows) {
35
+ output += encodeRecord(row, rowIndex, policy) + RECORD_SEPARATOR;
36
+ rowIndex += 1;
37
+ }
38
+ return output;
39
+ }
40
+ function writePolicy(options) {
41
+ const { nullMarker } = options;
42
+ if (nullMarker !== undefined && (nullMarker === '' || QUOTE_REQUIRED_PATTERN.test(nullMarker))) {
43
+ throw new RangeError('CSV null marker must be non-empty and free of double quotes, commas, CR, and LF.');
44
+ }
45
+ return {
46
+ neutralizeFormulas: options.neutralizeFormulas ?? true,
47
+ quoteAllCells: options.quoteAllCells ?? false,
48
+ nullMarker,
49
+ };
50
+ }
51
+ function encodeRecord(row, rowIndex, policy) {
52
+ const record = row
53
+ .map((cell, columnIndex) => writeCell(classifyCell(cell, rowIndex, columnIndex), policy))
54
+ .join(',');
55
+ return row.length === 1 && record === '' ? '""' : record;
56
+ }
57
+ function classifyCell(cell, rowIndex, columnIndex) {
58
+ if (cell === null)
59
+ return { kind: 'null' };
60
+ if (typeof cell === 'string') {
61
+ if (hasUnpairedSurrogate(cell)) {
62
+ throw new CsvEncodeError('invalid_unicode', rowIndex, columnIndex);
63
+ }
64
+ return { kind: 'text', value: cell };
65
+ }
66
+ const numeric = numericText(cell);
67
+ if (numeric === undefined)
68
+ throw new CsvEncodeError('unsupported_cell', rowIndex, columnIndex);
69
+ if (!NUMERIC_PATTERN.test(numeric)) {
70
+ throw new CsvEncodeError('invalid_numeric_cell', rowIndex, columnIndex);
71
+ }
72
+ return { kind: 'numeric', value: numeric };
73
+ }
74
+ function hasUnpairedSurrogate(value) {
75
+ for (let index = 0; index < value.length; index += 1) {
76
+ const unit = value.charCodeAt(index);
77
+ if (isInRange(unit, LOW_SURROGATE_MIN, LOW_SURROGATE_MAX))
78
+ return true;
79
+ if (!isInRange(unit, HIGH_SURROGATE_MIN, HIGH_SURROGATE_MAX))
80
+ continue;
81
+ if (!isInRange(value.charCodeAt(index + 1), LOW_SURROGATE_MIN, LOW_SURROGATE_MAX))
82
+ return true;
83
+ index += 1;
84
+ }
85
+ return false;
86
+ }
87
+ function isInRange(value, min, max) {
88
+ return value >= min && value <= max;
89
+ }
90
+ function numericText(cell) {
91
+ if (typeof cell === 'number')
92
+ return String(cell);
93
+ if (typeof cell !== 'object' || cell === null || !('numeric' in cell))
94
+ return undefined;
95
+ const { numeric } = cell;
96
+ return typeof numeric === 'string' ? numeric : undefined;
97
+ }
98
+ function writeCell(cell, policy) {
99
+ if (cell.kind === 'null')
100
+ return policy.nullMarker ?? '';
101
+ if (cell.kind === 'numeric')
102
+ return policy.quoteAllCells ? quote(cell.value) : cell.value;
103
+ const text = policy.neutralizeFormulas && startsLikeFormula(cell.value)
104
+ ? FORMULA_ESCAPE + cell.value
105
+ : cell.value;
106
+ return mustQuote(text, policy) ? quote(text) : text;
107
+ }
108
+ function mustQuote(text, policy) {
109
+ return policy.quoteAllCells || text === policy.nullMarker || QUOTE_REQUIRED_PATTERN.test(text);
110
+ }
111
+ function quote(text) {
112
+ return `"${text.replaceAll('"', '""')}"`;
113
+ }
114
+ function startsLikeFormula(value) {
115
+ const first = value.charAt(0);
116
+ if (CONTROL_TRIGGERS.has(first))
117
+ return true;
118
+ const afterWhitespace = value.replace(LEADING_WHITESPACE_PATTERN, '');
119
+ return FORMULA_TRIGGERS.has(afterWhitespace.charAt(0));
120
+ }
121
+ //# sourceMappingURL=export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,6 +1,8 @@
1
1
  export * from './contracts.js';
2
2
  export * from './erasure.js';
3
+ export * from './export.js';
3
4
  export * from './identity.js';
4
5
  export * from './import-envelope.js';
5
6
  export * from './memory.js';
7
+ export * from './web-storage.js';
6
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
package/dist/index.js CHANGED
@@ -1,6 +1,8 @@
1
1
  export * from './contracts.js';
2
2
  export * from './erasure.js';
3
+ export * from './export.js';
3
4
  export * from './identity.js';
4
5
  export * from './import-envelope.js';
5
6
  export * from './memory.js';
7
+ export * from './web-storage.js';
6
8
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
package/dist/limits.d.ts CHANGED
@@ -21,4 +21,27 @@ export declare function checkTrimmedUnicodeScalars(value: string, allowed: numbe
21
21
  export declare function checkCompactJsonUtf8Bytes(value: unknown, allowed: number): LimitMeasurement;
22
22
  export declare function checkBytes(value: Uint8Array, allowed: number): LimitMeasurement;
23
23
  export declare function checkCollection(value: readonly unknown[], allowed: number): LimitMeasurement;
24
+ export interface LimitsPolicySchema {
25
+ readonly version: number;
26
+ readonly sections: Readonly<Record<string, readonly string[]>>;
27
+ readonly allowZero?: readonly string[];
28
+ }
29
+ export type LimitsPolicy<Schema extends LimitsPolicySchema> = {
30
+ readonly $comment: string;
31
+ readonly version: number;
32
+ } & {
33
+ readonly [Section in keyof Schema['sections']]: Readonly<Record<Schema['sections'][Section][number], number>>;
34
+ };
35
+ export declare class LimitsPolicyError extends Error {
36
+ constructor(message: string);
37
+ }
38
+ export declare class LimitError<Reason extends string = string> extends Error implements LimitMeasurement {
39
+ readonly reason: Reason;
40
+ readonly field: string;
41
+ readonly measured: number;
42
+ readonly allowed: number;
43
+ constructor(reason: Reason, field: string, measurement: LimitMeasurement);
44
+ }
45
+ export declare function parseLimitsPolicy<const Schema extends LimitsPolicySchema>(value: unknown, schema: Schema): LimitsPolicy<Schema>;
46
+ export declare function enforceLimit(field: string, reason: string, check: () => LimitMeasurement): LimitMeasurement;
24
47
  //# sourceMappingURL=limits.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,kBAAmB,SAAQ,KAAM,YAAW,gBAAgB;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM9C;AAED,MAAM,MAAM,4BAA4B,GACtC,iBAAiB,GAAG,wBAAwB,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;AAElG,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;gBAEhC,IAAI,EAAE,4BAA4B;CAK/C;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB/D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAElE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAKpF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAE3F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAE3F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAE/E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAE5F"}
1
+ {"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"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"}