@namzu/sdk 30.2.0 → 31.0.0

package/dist/store/kv/revision-record-store.js

@@ -0,0 +1,290 @@
+import { link, mkdir, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { NamzuError } from '../../types/errors/index.js';
+import { temporaryPathFor } from '../../utils/atomic-write.js';
+import { stamp } from '../schema.js';
+import { DiskRecordStore } from './record-store.js';
+/** Only strict positive safe-integer revision names are commits. */
+const REVISION_NAME = /^([1-9][0-9]{0,15})\.json$/;
+/** A hot record may advance while a reader obtains its directory snapshot. */
+const READ_SNAPSHOT_ATTEMPTS = 8;
+/** Filesystems on which a complete exclusive hard-link publication cannot be made. */
+const NO_LINK = new Set(['EPERM', 'ENOTSUP', 'EOPNOTSUPP', 'ENOSYS', 'EXDEV', 'EMLINK']);
+function isErrno(err, code) {
+    return typeof err === 'object' && err !== null && err.code === code;
+}
+function assertRevision(value, context) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new NamzuError({
+            code: 'storage_error',
+            message: `${context}: revision must be a positive safe integer, got ${value}.`,
+            details: { revision: value },
+            retryable: false,
+        });
+    }
+}
+/**
+ * Turn an opaque public id into exactly one injective filesystem segment.
+ *
+ * The unescaped alphabet deliberately excludes `.`, `%`, `~` and every path
+ * separator. Each other UTF-16 code unit has one fixed-width spelling, so
+ * `../x`, a literal escape-looking id, and an unpaired surrogate cannot
+ * collide or leave the store root.
+ */
+export function revisionFileSegment(value) {
+    if (value.length === 0)
+        return '~empty';
+    let out = '';
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        const safe = (code >= 48 && code <= 57) ||
+            (code >= 65 && code <= 90) ||
+            (code >= 97 && code <= 122) ||
+            code === 45 ||
+            code === 95;
+        out += safe ? value[i] : `~${code.toString(16).padStart(4, '0')}`;
+    }
+    return out;
+}
+/**
+ * Recover an opaque id from its canonical revision-directory segment.
+ *
+ * Listing stores need the inverse: a committed first write can exist without
+ * its best-effort legacy projection, so enumerating projection files alone
+ * would make a successful commit invisible. Non-canonical names return null
+ * rather than aliasing a real id; re-encoding is the final canonicality check.
+ */
+export function decodeRevisionFileSegment(segment) {
+    if (segment === '~empty')
+        return '';
+    if (segment.length === 0)
+        return null;
+    let value = '';
+    for (let i = 0; i < segment.length; i++) {
+        const char = segment[i];
+        if (char === undefined)
+            return null;
+        if (char !== '~') {
+            if (!/[0-9A-Za-z_-]/u.test(char))
+                return null;
+            value += char;
+            continue;
+        }
+        const escaped = segment.slice(i + 1, i + 5);
+        if (!/^[0-9a-f]{4}$/u.test(escaped))
+            return null;
+        value += String.fromCharCode(Number.parseInt(escaped, 16));
+        i += 4;
+    }
+    return revisionFileSegment(value) === segment ? value : null;
+}
+/**
+ * Preserve the old single-file name whenever it was already one path
+ * component. The immutable log always uses {@link revisionFileSegment}, but
+ * changing a dotted, spaced or Unicode id's projection name would strand the
+ * record written by the previous store implementation during upgrade.
+ */
+export function legacyRevisionFileSegment(value) {
+    return /[\\/\0]/u.test(value) ? revisionFileSegment(value) : value;
+}
+/**
+ * Immutable revision commits over a filesystem.
+ *
+ * The body is complete before `link` publishes its revision name. `link`
+ * supplies the one kernel decision a read-check-replace sequence lacks:
+ * exactly one process can create `N.json`. Revision names are never deleted;
+ * deleting one would let an arbitrarily delayed stale writer issue N again.
+ *
+ * The old single-file record remains a compatibility projection. It is not
+ * authoritative once immutable commits exist, but it is checked on every
+ * read. A different value at the same revision, or a legacy revision ahead
+ * of the commit head, is evidence of an incompatible writer and is refused.
+ */
+export class DiskRevisionRecordStore {
+    schema;
+    label;
+    revisionOf;
+    records;
+    constructor(schema, label, revisionOf) {
+        this.schema = schema;
+        this.label = label;
+        this.revisionOf = revisionOf;
+        this.records = new DiskRecordStore(schema);
+    }
+    checkedRevision(record, context) {
+        const revision = this.revisionOf(record);
+        assertRevision(revision, context);
+        return revision;
+    }
+    async read(location) {
+        return await this.readStable(location, 1);
+    }
+    async readStable(location, attempt) {
+        const { headRevision, headName } = await this.findHead(location);
+        const legacy = await this.records.read(location.legacyPath);
+        const legacyRevision = legacy === null ? undefined : this.checkedRevision(legacy, `${this.label} legacy projection`);
+        if (headName === undefined)
+            return legacy;
+        const head = await this.records.read(join(location.revisionsDir, headName));
+        if (head === null) {
+            // Revision commits are immutable and never removed. ENOENT after the
+            // listing therefore means another, incompatible actor changed the store.
+            throw this.incompatible(location, 'the immutable head disappeared after it was listed', {
+                headRevision,
+            });
+        }
+        const bodyRevision = this.checkedRevision(head, `${this.label} immutable head`);
+        if (bodyRevision !== headRevision) {
+            throw this.incompatible(location, 'the revision filename and record body disagree', {
+                headRevision,
+                bodyRevision,
+            });
+        }
+        if (legacy !== null && legacyRevision !== undefined && legacyRevision > bodyRevision) {
+            // A current writer commits the next immutable entry before updating
+            // the projection. If it completed between our first directory listing
+            // and projection read, the pair looks exactly like a legacy writer ahead
+            // until we list the head again. Distinguish that read race from durable
+            // disagreement before refusing the record.
+            const refreshed = await this.findHead(location);
+            if (refreshed.headRevision > bodyRevision) {
+                if (attempt < READ_SNAPSHOT_ATTEMPTS) {
+                    return await this.readStable(location, attempt + 1);
+                }
+                throw new NamzuError({
+                    code: 'storage_error',
+                    message: `${this.label}: the record kept advancing while its revision snapshot was read; retry after the writers settle.`,
+                    details: {
+                        path: location.legacyPath,
+                        headRevision: bodyRevision,
+                        refreshedRevision: refreshed.headRevision,
+                        attempts: attempt,
+                    },
+                    retryable: true,
+                });
+            }
+            throw this.incompatible(location, 'the legacy projection is ahead of the immutable commit head', { headRevision: bodyRevision, legacyRevision });
+        }
+        if (legacy !== null && legacyRevision === bodyRevision && !isDeepStrictEqual(legacy, head)) {
+            throw this.incompatible(location, 'the legacy projection and immutable head contain different values at one revision', { headRevision: bodyRevision, legacyRevision });
+        }
+        return head;
+    }
+    async findHead(location) {
+        const names = await this.records.scanNames(location.revisionsDir, '');
+        let headRevision = 0;
+        let headName;
+        for (const name of names) {
+            const match = REVISION_NAME.exec(name);
+            if (!match)
+                continue;
+            const revision = Number(match[1]);
+            if (!Number.isSafeInteger(revision) || revision <= headRevision)
+                continue;
+            headRevision = revision;
+            headName = name;
+        }
+        return { headRevision, headName };
+    }
+    async transact(location, mutate) {
+        const current = await this.read(location);
+        const proposal = mutate(current);
+        const currentRevision = current === null ? 0 : this.checkedRevision(current, `${this.label} current record`);
+        const expectedNext = currentRevision + 1;
+        const proposedRevision = this.checkedRevision(proposal.record, `${this.label} proposed record`);
+        if (proposedRevision !== expectedNext) {
+            throw new NamzuError({
+                code: 'storage_error',
+                message: `${this.label}: mutation proposed revision ${proposedRevision}, but the next committed revision is ${expectedNext}.`,
+                details: {
+                    path: location.revisionsDir,
+                    currentRevision,
+                    proposedRevision,
+                },
+                retryable: false,
+            });
+        }
+        await mkdir(location.revisionsDir, { recursive: true });
+        const target = join(location.revisionsDir, `${proposedRevision}.json`);
+        try {
+            await this.publish(target, proposal.record);
+        }
+        catch (err) {
+            if (!isErrno(err, 'EEXIST'))
+                throw err;
+            // A contender committed this exact next revision. Re-evaluate the
+            // domain guard against its complete value so the public store reports
+            // its own Stale*/Exists error with the durable actual revision.
+            const winner = await this.read(location);
+            mutate(winner);
+            const winnerRevision = winner === null ? 0 : this.checkedRevision(winner, `${this.label} winning record`);
+            throw this.incompatible(location, 'a revision destination already existed but the domain mutation still accepted its winner', { revision: winnerRevision });
+        }
+        // The immutable entry above is the commit. This projection lets an old
+        // reader see the latest value after a stopped upgrade, but it cannot be
+        // allowed to turn a committed success into an ambiguous failure. A later
+        // current reader accepts a projection behind the head; the next successful
+        // mutation refreshes it. Equal-but-different and ahead are refused in read().
+        if (location.publishLegacyProjection !== false) {
+            await (async () => {
+                await mkdir(dirname(location.legacyPath), { recursive: true });
+                await this.records.write(location.legacyPath, proposal.record);
+            })().catch(() => undefined);
+        }
+        return proposal.result;
+    }
+    async publish(target, record) {
+        const temporary = temporaryPathFor(target);
+        try {
+            try {
+                await writeFile(temporary, `${JSON.stringify(stamp(this.schema, record), null, 2)}\n`, {
+                    encoding: 'utf-8',
+                    flag: 'wx',
+                });
+            }
+            catch (err) {
+                if (isErrno(err, 'EEXIST')) {
+                    throw new NamzuError({
+                        code: 'storage_error',
+                        message: `${this.label}: temporary publication path already exists; refusing a scratch collision.`,
+                        details: { path: temporary },
+                        retryable: false,
+                        cause: err,
+                    });
+                }
+                throw err;
+            }
+            try {
+                await link(temporary, target);
+            }
+            catch (err) {
+                if (isErrno(err, 'EEXIST'))
+                    throw err;
+                const code = err.code;
+                if (code !== undefined && NO_LINK.has(code)) {
+                    throw new NamzuError({
+                        code: 'capability_unavailable',
+                        message: `${this.label}: this filesystem cannot publish an exclusive complete revision (${code}). Put the store on a filesystem with hard-link support or use a single in-memory owner; refusing rather than degrading to read-check-replace.`,
+                        details: { path: dirname(target), code },
+                        retryable: false,
+                        cause: err,
+                    });
+                }
+                throw err;
+            }
+        }
+        finally {
+            await unlink(temporary).catch(() => undefined);
+        }
+    }
+    incompatible(location, reason, details) {
+        return new NamzuError({
+            code: 'storage_error',
+            message: `${this.label}: incompatible writers or damaged revision data: ${reason}. Stop every process using another SDK version, then repair or restore this record before retrying.`,
+            details: { path: location.legacyPath, ...details },
+            retryable: false,
+        });
+    }
+}
+//# sourceMappingURL=revision-record-store.js.map

package/dist/store/kv/revision-record-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-record-store.js","sourceRoot":"","sources":["../../../src/store/kv/revision-record-store.ts"],"names":[],"mappings":"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"}

package/dist/store/memory/disk.d.ts

@@ -7,17 +7,20 @@ export interface DiskMemoryStoreConfig {
     logger?: Logger;
 }
 export declare class DiskMemoryStore implements MemoryStore {
-    private baseDir;
-    private log;
-    private index;
-    private initialized;
+    private readonly baseDir;
+    private readonly log;
+    private readonly index;
+    private location?;
     private readonly records;
     private readonly indexRecords;
     constructor(config: DiskMemoryStoreConfig);
-    private get indexPath();
     private get contentDir();
+    private storageLocation;
     private contentPath;
-    private ensureInit;
+    private reloadIndex;
+    private withAuthoritativeIndex;
+    private readContent;
+    private writeIndex;
     create(params: CreateMemoryParams): Promise<{
         entry: MemoryIndexEntry;
         content: MemoryContent;
@@ -27,6 +30,5 @@ export declare class DiskMemoryStore implements MemoryStore {
     delete(id: MemoryId): Promise<boolean>;
     list(params?: MemorySearchParams): Promise<MemorySearchResult>;
     getIndex(): InMemoryMemoryIndex;
-    private persistIndex;
 }
 //# sourceMappingURL=disk.d.ts.map

package/dist/store/memory/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/memory/disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,6BAA6B,CAAA;AAGpC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAYhD,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAgB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,WAAW,CAAQ;IAK3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2D;gBAE5E,MAAM,EAAE,qBAAqB;IAKzC,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,UAAU,GAErB;IAED,OAAO,CAAC,WAAW;YAIL,UAAU;IAwBlB,MAAM,CACX,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAgCzD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAarD,MAAM,CACX,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IA8ClC,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAatC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKpE,QAAQ,IAAI,mBAAmB;YAIjB,YAAY;CAI1B"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/memory/disk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,6BAA6B,CAAA;AAGpC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAyJhD,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAgB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAKlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;gBAExD,MAAM,EAAE,qBAAqB;IAKzC,OAAO,KAAK,UAAU,GAErB;YAEa,eAAe;IAkB7B,OAAO,CAAC,WAAW;YASL,WAAW;YAkBX,sBAAsB;YAUtB,WAAW;YAOX,UAAU;IAOlB,MAAM,CACX,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IA0CzD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAQrD,MAAM,CACX,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAqClC,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBtC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpE,QAAQ,IAAI,mBAAmB;CAG/B"}