@uncefact/untp-utils 0.1.0 → 0.3.0

package/build/bundle/refresh-main.test.js

@@ -0,0 +1,98 @@
+// Drives the refresh script's main() against a temporary copy of the bundle
+// with fetch stubbed, so the refusal, repair and dry-run paths are proven
+// without the network. The script is loaded by runtime URL (tsc's rootDir is
+// `src`); UNTP_ARTEFACTS_ROOT points it at the temporary tree.
+import { jest } from '@jest/globals';
+import { cp, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const scriptUrl = new URL('../../scripts/refresh-artefacts.mjs', import.meta.url).href;
+const packageRoot = new URL('../../', import.meta.url).pathname;
+describe('refresh-artefacts main', () => {
+    let root;
+    let script;
+    let exit;
+    let stubbed;
+    let fetchImpl;
+    const run = (argv) => script.main(argv, { fetchImpl });
+    beforeAll(async () => {
+        // The script resolves its root when it loads, so the temporary root is
+        // fixed before the import and refilled from the real bundle per test.
+        root = await mkdtemp(join(tmpdir(), 'untp-artefacts-'));
+        process.env.UNTP_ARTEFACTS_ROOT = root;
+        script = (await import(scriptUrl));
+    });
+    afterAll(async () => {
+        delete process.env.UNTP_ARTEFACTS_ROOT;
+        await rm(root, { recursive: true, force: true });
+    });
+    beforeEach(async () => {
+        await rm(join(root, 'artefacts'), { recursive: true, force: true });
+        await rm(join(root, 'src'), { recursive: true, force: true });
+        await cp(join(packageRoot, 'artefacts'), join(root, 'artefacts'), { recursive: true });
+        await cp(join(packageRoot, 'src', 'bundle'), join(root, 'src', 'bundle'), { recursive: true });
+        // Serve every source from the bundled copy on disk, so "published" equals "bundled".
+        stubbed = new Map();
+        for (const { file, source } of script.ARTEFACTS) {
+            stubbed.set(source, await readFile(join(packageRoot, 'artefacts', file), 'utf8'));
+        }
+        fetchImpl = (async (url) => {
+            const body = stubbed.get(String(url));
+            return body === undefined
+                ? new Response('missing', { status: 404 })
+                : new Response(body, { status: 200, headers: { 'content-type': 'application/json' } });
+        });
+        exit = jest.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`exit ${code}`);
+        }));
+        jest.spyOn(console, 'log').mockImplementation(() => { });
+        jest.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    const corruptFile = 'context/untp/0.6.0/dia.json';
+    it('--check passes on a matching tree and writes nothing', async () => {
+        const before = await readFile(join(root, 'artefacts', 'manifest.json'), 'utf8');
+        await run(['--check']);
+        expect(exit).not.toHaveBeenCalled();
+        expect(await readFile(join(root, 'artefacts', 'manifest.json'), 'utf8')).toBe(before);
+    });
+    it('--check refuses a corrupt bundled copy, naming it, and writes nothing', async () => {
+        await writeFile(join(root, 'artefacts', corruptFile), '{not json');
+        await expect(run(['--check'])).rejects.toThrow('exit 1');
+        expect(await readFile(join(root, 'artefacts', corruptFile), 'utf8')).toBe('{not json');
+    });
+    it('a plain refresh also refuses a corrupt copy rather than hashing it', async () => {
+        await writeFile(join(root, 'artefacts', corruptFile), '{not json');
+        await expect(run([])).rejects.toThrow('exit 1');
+        expect(await readFile(join(root, 'artefacts', corruptFile), 'utf8')).toBe('{not json');
+    });
+    it('--force repairs a corrupt copy from the published source', async () => {
+        await writeFile(join(root, 'artefacts', corruptFile), '{not json');
+        await run(['--force']);
+        expect(exit).not.toHaveBeenCalled();
+        expect(JSON.parse(await readFile(join(root, 'artefacts', corruptFile), 'utf8'))).toHaveProperty('@context');
+    });
+    it('refuses a published copy that differs unless forced', async () => {
+        const entry = script.ARTEFACTS.find((a) => a.file === corruptFile);
+        stubbed.set(entry.source, JSON.stringify({ '@context': { changed: true } }));
+        await expect(run(['--check'])).rejects.toThrow('exit 1');
+        await expect(run([])).rejects.toThrow('exit 1');
+        await run(['--force']);
+        expect(JSON.parse(await readFile(join(root, 'artefacts', corruptFile), 'utf8'))).toEqual({
+            '@context': { changed: true },
+        });
+    });
+    it('writes nothing when a later fetch fails', async () => {
+        const entry = script.ARTEFACTS[script.ARTEFACTS.length - 1];
+        stubbed.delete(entry.source);
+        await writeFile(join(root, 'artefacts', corruptFile), '{not json');
+        await expect(run(['--force'])).rejects.toThrow(/answered 404/);
+        expect(await readFile(join(root, 'artefacts', corruptFile), 'utf8')).toBe('{not json');
+    });
+    it('rejects --check together with --force', async () => {
+        await expect(run(['--check', '--force'])).rejects.toThrow('exit 1');
+    });
+});
+//# sourceMappingURL=refresh-main.test.js.map

package/build/bundle/refresh-main.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-main.test.js","sourceRoot":"","sources":["../../src/bundle/refresh-main.test.ts"],"names":[],"mappings":"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"}

package/build/cache/in-memory-ttl-cache.d.ts

@@ -0,0 +1,2 @@
+import type { TtlCache, TtlCacheOptions } from './ttl-cache.js';
+export declare function createInMemoryTtlCache<T>(options: TtlCacheOptions): TtlCache<T>;

package/build/cache/in-memory-ttl-cache.js

@@ -0,0 +1,76 @@
+export function createInMemoryTtlCache(options) {
+    const { ttlMs, maxEntries } = options;
+    if (!Number.isFinite(ttlMs) || ttlMs < 0) {
+        throw new RangeError(`ttlMs must be a non-negative finite number, got ${ttlMs}.`);
+    }
+    if (maxEntries !== undefined && (!Number.isInteger(maxEntries) || maxEntries < 1)) {
+        throw new RangeError(`maxEntries must be a positive integer when supplied, got ${maxEntries}.`);
+    }
+    const cache = new Map();
+    const inflight = new Map();
+    const isFresh = (storedAt) => Date.now() - storedAt < ttlMs;
+    // Retention bound: expired entries go first (they are dead weight whatever
+    // the cap), then the least recently used live entry. Recency comes from
+    // Map insertion order: hits re-insert their key (see get), so iteration
+    // order is oldest-touched first.
+    const evictForCapacity = () => {
+        if (maxEntries === undefined || cache.size < maxEntries)
+            return;
+        for (const [key, entry] of cache) {
+            if (!isFresh(entry.storedAt))
+                cache.delete(key);
+        }
+        while (cache.size >= maxEntries) {
+            const oldest = cache.keys().next().value;
+            cache.delete(oldest);
+        }
+    };
+    return {
+        async get(key, fetcher) {
+            if (ttlMs > 0) {
+                const cached = cache.get(key);
+                if (cached) {
+                    if (isFresh(cached.storedAt)) {
+                        // Re-insert so Map iteration order tracks recency for eviction.
+                        cache.delete(key);
+                        cache.set(key, cached);
+                        return cached.value;
+                    }
+                    // Expired entries are removed when met rather than lingering until
+                    // the same key happens to be rewritten.
+                    cache.delete(key);
+                }
+            }
+            const existing = inflight.get(key);
+            if (existing)
+                return existing;
+            let promise;
+            promise = (async () => {
+                try {
+                    const value = await fetcher();
+                    if (ttlMs > 0 && inflight.get(key) === promise) {
+                        evictForCapacity();
+                        cache.set(key, { value, storedAt: Date.now() });
+                    }
+                    return value;
+                }
+                finally {
+                    if (inflight.get(key) === promise) {
+                        inflight.delete(key);
+                    }
+                }
+            })();
+            inflight.set(key, promise);
+            return promise;
+        },
+        async invalidate(key) {
+            cache.delete(key);
+            inflight.delete(key);
+        },
+        async clear() {
+            cache.clear();
+            inflight.clear();
+        },
+    };
+}
+//# sourceMappingURL=in-memory-ttl-cache.js.map

package/build/cache/in-memory-ttl-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-ttl-cache.js","sourceRoot":"","sources":["../../src/cache/in-memory-ttl-cache.ts"],"names":[],"mappings":"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"}

package/build/cache/in-memory-ttl-cache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/cache/in-memory-ttl-cache.test.js

@@ -0,0 +1,236 @@
+import { jest } from '@jest/globals';
+import { createInMemoryTtlCache } from './in-memory-ttl-cache.js';
+describe('createInMemoryTtlCache', () => {
+    describe('hit / miss', () => {
+        it('returns the fetcher result on a miss', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            await expect(cache.get('a', async () => 'fetched')).resolves.toBe('fetched');
+        });
+        it('returns the cached value on a subsequent hit within the TTL', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            const fetcher = jest.fn(async () => 'fetched');
+            await cache.get('a', fetcher);
+            await cache.get('a', fetcher);
+            expect(fetcher).toHaveBeenCalledTimes(1);
+        });
+        it('refetches after the TTL expires', async () => {
+            const realNow = Date.now;
+            let now = 1000;
+            jest.spyOn(Date, 'now').mockImplementation(() => now);
+            try {
+                const cache = createInMemoryTtlCache({ ttlMs: 100 });
+                const fetcher = jest.fn(async () => 'v');
+                await cache.get('a', fetcher);
+                now += 101;
+                await cache.get('a', fetcher);
+                expect(fetcher).toHaveBeenCalledTimes(2);
+            }
+            finally {
+                Date.now = realNow;
+            }
+        });
+        it('treats the TTL boundary strictly: ttlMs - 1 ms is a hit, ttlMs ms is a miss', async () => {
+            const realNow = Date.now;
+            let now = 1000;
+            jest.spyOn(Date, 'now').mockImplementation(() => now);
+            try {
+                const cache = createInMemoryTtlCache({ ttlMs: 100 });
+                const fetcher = jest.fn(async () => 'v');
+                await cache.get('a', fetcher);
+                now += 99;
+                await cache.get('a', fetcher);
+                expect(fetcher).toHaveBeenCalledTimes(1);
+                now += 1;
+                await cache.get('a', fetcher);
+                expect(fetcher).toHaveBeenCalledTimes(2);
+            }
+            finally {
+                Date.now = realNow;
+            }
+        });
+        it('treats ttlMs: 0 as a no-cache policy (always misses)', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 0 });
+            const fetcher = jest.fn(async () => 'v');
+            await cache.get('a', fetcher);
+            await cache.get('a', fetcher);
+            expect(fetcher).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('invalidate during inflight', () => {
+        it('does not repopulate the cache when invalidate runs while a fetch is inflight', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 60_000 });
+            let resolveFetcher;
+            const fetcher = jest.fn(() => new Promise((r) => {
+                resolveFetcher = r;
+            }));
+            const inflightLoad = cache.get('k', fetcher);
+            await cache.invalidate('k');
+            resolveFetcher('value-that-should-not-be-cached');
+            await inflightLoad;
+            const second = await cache.get('k', jest.fn(async () => 'fresh-value'));
+            expect(second).toBe('fresh-value');
+        });
+    });
+    describe('options', () => {
+        it('rejects negative ttlMs', () => {
+            expect(() => createInMemoryTtlCache({ ttlMs: -1 })).toThrow(RangeError);
+        });
+        it('rejects non-finite ttlMs', () => {
+            expect(() => createInMemoryTtlCache({ ttlMs: NaN })).toThrow(RangeError);
+            expect(() => createInMemoryTtlCache({ ttlMs: Infinity })).toThrow(RangeError);
+        });
+    });
+    describe('retention bound (maxEntries)', () => {
+        it('rejects a non-positive or non-integer maxEntries', () => {
+            expect(() => createInMemoryTtlCache({ ttlMs: 1000, maxEntries: 0 })).toThrow(RangeError);
+            expect(() => createInMemoryTtlCache({ ttlMs: 1000, maxEntries: 1.5 })).toThrow(RangeError);
+            expect(() => createInMemoryTtlCache({ ttlMs: 1000, maxEntries: -1 })).toThrow(RangeError);
+        });
+        it('evicts the least recently used entry when the cap is reached', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 60_000, maxEntries: 2 });
+            const fetches = [];
+            const fetcher = (v) => async () => {
+                fetches.push(v);
+                return v;
+            };
+            await cache.get('a', fetcher('a'));
+            await cache.get('b', fetcher('b'));
+            await cache.get('a', fetcher('a-refetch')); // touch a, so b is now least recent
+            await cache.get('c', fetcher('c')); // cap reached: evicts b
+            expect(await cache.get('a', fetcher('a-refetch'))).toBe('a'); // still cached
+            expect(await cache.get('b', fetcher('b-refetch'))).toBe('b-refetch'); // evicted, refetched
+            expect(fetches).toEqual(['a', 'b', 'c', 'b-refetch']);
+        });
+        it('evicts expired entries before evicting live ones', async () => {
+            const realNow = Date.now;
+            let now = 1_000_000;
+            Date.now = () => now;
+            try {
+                const cache = createInMemoryTtlCache({ ttlMs: 1000, maxEntries: 2 });
+                await cache.get('old', async () => 'old');
+                now += 2000; // 'old' expires
+                await cache.get('live', async () => 'live');
+                await cache.get('new', async () => 'new'); // cap: removes expired 'old', keeps 'live'
+                const fetches = [];
+                expect(await cache.get('live', async () => {
+                    fetches.push('live-refetch');
+                    return 'live-refetch';
+                })).toBe('live');
+                expect(fetches).toEqual([]);
+            }
+            finally {
+                Date.now = realNow;
+            }
+        });
+        it('removes an expired entry when it is met, even with no cap configured', async () => {
+            const realNow = Date.now;
+            let now = 1_000_000;
+            Date.now = () => now;
+            try {
+                const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+                await cache.get('k', async () => 'v1');
+                now += 2000;
+                // Expired: refetches, and the stale entry is deleted rather than
+                // lingering until this key happens to be rewritten.
+                await expect(cache.get('k', async () => 'v2')).resolves.toBe('v2');
+                expect(await cache.get('k', async () => 'v3')).toBe('v2');
+            }
+            finally {
+                Date.now = realNow;
+            }
+        });
+    });
+    describe('deduplication', () => {
+        it('deduplicates concurrent fetches for the same key', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            let resolveFetcher;
+            const fetcher = jest.fn(() => new Promise((r) => {
+                resolveFetcher = r;
+            }));
+            const a = cache.get('k', fetcher);
+            const b = cache.get('k', fetcher);
+            resolveFetcher('done');
+            await expect(a).resolves.toBe('done');
+            await expect(b).resolves.toBe('done');
+            expect(fetcher).toHaveBeenCalledTimes(1);
+        });
+        it('runs fetcher independently for distinct keys', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            const fetcher = jest.fn(async () => 'v');
+            await cache.get('a', fetcher);
+            await cache.get('b', fetcher);
+            expect(fetcher).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('errors', () => {
+        it('propagates fetcher rejections without caching the failure', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            let attempt = 0;
+            const fetcher = jest.fn(async () => {
+                attempt += 1;
+                if (attempt === 1)
+                    throw new Error('boom');
+                return 'ok';
+            });
+            await expect(cache.get('a', fetcher)).rejects.toThrow('boom');
+            await expect(cache.get('a', fetcher)).resolves.toBe('ok');
+            expect(fetcher).toHaveBeenCalledTimes(2);
+        });
+        it('fans the same rejection out to every concurrent caller and retries on the next call', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            let rejectFetcher;
+            const fetcher = jest.fn(() => new Promise((_resolve, reject) => {
+                rejectFetcher = reject;
+            }));
+            const a = cache.get('k', fetcher);
+            const b = cache.get('k', fetcher);
+            const sharedError = new Error('shared boom');
+            rejectFetcher(sharedError);
+            const aErr = await a.catch((e) => e);
+            const bErr = await b.catch((e) => e);
+            expect(aErr).toBe(sharedError);
+            expect(bErr).toBe(sharedError);
+            expect(fetcher).toHaveBeenCalledTimes(1);
+            const c = await cache.get('k', jest.fn(async () => 'ok'));
+            expect(c).toBe('ok');
+        });
+        it('clears inflight on rejection so subsequent callers retry', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            let resolveFetcher;
+            let rejectFetcher;
+            const fetcher = jest.fn(() => new Promise((r, rej) => {
+                resolveFetcher = r;
+                rejectFetcher = rej;
+            }));
+            const first = cache.get('k', fetcher);
+            rejectFetcher(new Error('first fail'));
+            await expect(first).rejects.toThrow('first fail');
+            const second = cache.get('k', fetcher);
+            resolveFetcher('second ok');
+            await expect(second).resolves.toBe('second ok');
+            expect(fetcher).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('invalidate / clear', () => {
+        it('invalidate removes a single key without touching others', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            const fetcher = jest.fn(async () => 'v');
+            await cache.get('a', fetcher);
+            await cache.get('b', fetcher);
+            await cache.invalidate('a');
+            await cache.get('a', fetcher);
+            await cache.get('b', fetcher);
+            expect(fetcher).toHaveBeenCalledTimes(3);
+        });
+        it('clear removes every cached value', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 1000 });
+            const fetcher = jest.fn(async () => 'v');
+            await cache.get('a', fetcher);
+            await cache.get('b', fetcher);
+            await cache.clear();
+            await cache.get('a', fetcher);
+            expect(fetcher).toHaveBeenCalledTimes(3);
+        });
+    });
+});
+//# sourceMappingURL=in-memory-ttl-cache.test.js.map

package/build/cache/in-memory-ttl-cache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-ttl-cache.test.js","sourceRoot":"","sources":["../../src/cache/in-memory-ttl-cache.test.ts"],"names":[],"mappings":"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"}

package/build/cache/index.d.ts

@@ -0,0 +1,2 @@
+export type { TtlCache, TtlCacheOptions } from './ttl-cache.js';
+export { createInMemoryTtlCache } from './in-memory-ttl-cache.js';

package/build/cache/index.js

@@ -0,0 +1,2 @@
+export { createInMemoryTtlCache } from './in-memory-ttl-cache.js';
+//# sourceMappingURL=index.js.map

package/build/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/build/cache/ttl-cache.d.ts

@@ -0,0 +1,22 @@
+export interface TtlCacheOptions {
+    /** TTL in ms. `0` disables caching. */
+    ttlMs: number;
+    /**
+     * Maximum number of stored entries. When a write would exceed it, expired
+     * entries are removed first, then the least recently used live entry is
+     * evicted. Omit for no bound (suitable only when keys come from trusted
+     * configuration; caller-controlled keys need a cap so a stream of unique
+     * keys cannot grow process memory without limit).
+     */
+    maxEntries?: number;
+}
+export interface TtlCache<T> {
+    /**
+     * Returns the cached value for `key` if fresh; otherwise invokes
+     * `fetcher`, stores its result, and returns it. Implementations may
+     * deduplicate concurrent misses; rejected fetches are not cached.
+     */
+    get(key: string, fetcher: () => Promise<T>): Promise<T>;
+    invalidate(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/build/cache/ttl-cache.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ttl-cache.js.map

package/build/cache/ttl-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-cache.js","sourceRoot":"","sources":["../../src/cache/ttl-cache.ts"],"names":[],"mappings":""}

package/build/common/as-date-time.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns the date and time `value` refers to, when `value` is a well-formed
+ * RFC 3339 date-time for a day that exists. Otherwise returns `undefined`.
+ *
+ * `new Date()` alone is not enough. It accepts loose forms such as `2024-01-15`
+ * or `January 15, 2024`, and it quietly normalises an impossible date, turning
+ * `2024-02-30` into 1 March, which would report a date the document never
+ * asserted.
+ *
+ * `undefined` rather than `null` because this reports what a document does not
+ * usably contain. How to record that absence is the caller's decision.
+ */
+export declare function asDateTime(value: unknown): Date | undefined;

package/build/common/as-date-time.js

@@ -0,0 +1,44 @@
+/**
+ * Matches the JSON Schema `date-time` format (RFC 3339 section 5.6).
+ *
+ * As of UNTP 0.7.0, every data model declares a credential's `validFrom` and
+ * `validUntil` as `"type": "string", "format": "date-time"`, and that is what
+ * this system validates a payload against before signing it.
+ *
+ * The W3C VC Data Model 2.0 is looser: it requires only an XML Schema 1.1
+ * `dateTime`, which permits an offsetless local time, years outside four
+ * digits, and `24:00:00` (https://www.w3.org/TR/vc-data-model-2.0/#validity-period).
+ * A credential issued elsewhere may therefore carry a value this rejects, and
+ * it is reported as absent rather than guessed: with no timezone there is no
+ * way to tell which moment a local time such as `09:00` refers to.
+ */
+const RFC3339_DATE_TIME = /^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(\.\d+)?([Zz]|[+-]\d{2}:\d{2})$/;
+/**
+ * Returns the date and time `value` refers to, when `value` is a well-formed
+ * RFC 3339 date-time for a day that exists. Otherwise returns `undefined`.
+ *
+ * `new Date()` alone is not enough. It accepts loose forms such as `2024-01-15`
+ * or `January 15, 2024`, and it quietly normalises an impossible date, turning
+ * `2024-02-30` into 1 March, which would report a date the document never
+ * asserted.
+ *
+ * `undefined` rather than `null` because this reports what a document does not
+ * usably contain. How to record that absence is the caller's decision.
+ */
+export function asDateTime(value) {
+    if (typeof value !== 'string' || !RFC3339_DATE_TIME.test(value))
+        return undefined;
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime()))
+        return undefined;
+    // Round-trip the calendar day: a normalised day (30 February) lands on a
+    // different day-of-month than the string names.
+    const day = Number(value.slice(8, 10));
+    const offsetMatch = /([+-])(\d{2}):(\d{2})$/.exec(value);
+    const offsetMinutes = offsetMatch
+        ? (offsetMatch[1] === '-' ? -1 : 1) * (Number(offsetMatch[2]) * 60 + Number(offsetMatch[3]))
+        : 0;
+    const local = new Date(parsed.getTime() + offsetMinutes * 60_000);
+    return local.getUTCDate() === day ? parsed : undefined;
+}
+//# sourceMappingURL=as-date-time.js.map

package/build/common/as-date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-date-time.js","sourceRoot":"","sources":["../../src/common/as-date-time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,iBAAiB,GAAG,wEAAwE,CAAC;AAEnG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,yEAAyE;IACzE,gDAAgD;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,WAAW;QAC/B,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,MAAM,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/build/common/as-date-time.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/common/as-date-time.test.js

@@ -0,0 +1,42 @@
+import { asDateTime } from './as-date-time.js';
+describe('asDateTime', () => {
+    it('returns the date and time a well-formed UTC value refers to', () => {
+        expect(asDateTime('2024-01-15T00:00:00Z')).toEqual(new Date('2024-01-15T00:00:00.000Z'));
+        expect(asDateTime('2024-01-15T10:30:00.250Z')).toEqual(new Date('2024-01-15T10:30:00.250Z'));
+    });
+    it('reads an offset value as the same moment in UTC', () => {
+        expect(asDateTime('2024-01-15T23:30:00+10:00')).toEqual(new Date('2024-01-15T13:30:00.000Z'));
+        expect(asDateTime('2024-01-15T00:30:00-05:00')).toEqual(new Date('2024-01-15T05:30:00.000Z'));
+    });
+    it('returns undefined for a day the calendar does not have, rather than normalising it', () => {
+        expect(asDateTime('2024-02-30T00:00:00Z')).toBeUndefined();
+        expect(asDateTime('2023-02-29T00:00:00Z')).toBeUndefined();
+    });
+    it('accepts a real leap day', () => {
+        expect(asDateTime('2024-02-29T00:00:00Z')).toEqual(new Date('2024-02-29T00:00:00.000Z'));
+    });
+    it('returns undefined for a leap second', () => {
+        // Well-formed RFC 3339, but JavaScript has no value for it.
+        expect(asDateTime('1990-12-31T23:59:60Z')).toBeUndefined();
+    });
+    it.each([
+        ['a date with no time', '2024-01-15'],
+        ['a human-readable date', 'January 15, 2024'],
+        ['a bare number', '0'],
+        ['nonsense', 'not-a-date'],
+        ['the empty string', ''],
+        ['a time with no zone', '2024-01-15T00:00:00'],
+    ])('returns undefined for %s', (_label, value) => {
+        expect(asDateTime(value)).toBeUndefined();
+    });
+    it.each([
+        ['number', 1705276800000],
+        ['null', null],
+        ['undefined', undefined],
+        ['Date', new Date()],
+        ['object', {}],
+    ])('returns undefined for a non-string %s', (_label, value) => {
+        expect(asDateTime(value)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=as-date-time.test.js.map

package/build/common/as-date-time.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-date-time.test.js","sourceRoot":"","sources":["../../src/common/as-date-time.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACzF,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,GAAG,EAAE;QAC5F,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC3D,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,4DAA4D;QAC5D,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,qBAAqB,EAAE,YAAY,CAAC;QACrC,CAAC,uBAAuB,EAAE,kBAAkB,CAAC;QAC7C,CAAC,eAAe,EAAE,GAAG,CAAC;QACtB,CAAC,UAAU,EAAE,YAAY,CAAC;QAC1B,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACxB,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KAC/C,CAAC,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,QAAQ,EAAE,aAAa,CAAC;QACzB,CAAC,MAAM,EAAE,IAAI,CAAC;QACd,CAAC,WAAW,EAAE,SAAS,CAAC;QACxB,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACpB,CAAC,QAAQ,EAAE,EAAE,CAAC;KACf,CAAC,CAAC,uCAAuC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC5D,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/common/as-non-empty-string.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns `value` trimmed if it is a string with non-whitespace content,
+ * otherwise `undefined`.
+ *
+ * Surrounding whitespace is never meaningful in the values this reads (names,
+ * identifiers, labels), and a whitespace-only string carries no more
+ * information than an absent one, so both collapse to `undefined`.
+ *
+ * `undefined` rather than `null` because this reports what a document does
+ * not contain. Recording that absence as a stored or transmitted value is a
+ * separate decision, made by the caller at the boundary where a read becomes
+ * a row or a response.
+ */
+export declare function asNonEmptyString(value: unknown): string | undefined;