@modelprofile.com/flexharness 9.10.0 → 10.1.0

package/dist_ts_stores_nosqldb/classes.nosqldbstores.js

@@ -0,0 +1,312 @@
+import * as plugins from './plugins.js';
+import { FlexHarnessStoreConflictError, FlexHarnessValidationError } from '../dist_ts/errors.js';
+import { assertFlexPermissionSnapshot, assertFlexProjectionSnapshot, assertFlexScopeSnapshot, } from '../dist_ts/utils.json.js';
+import { assertFlexProjectManagementRecord, assertFlexProjectManagementSnapshot, assertFlexProjectManagementTombstone, } from '../dist_ts/utils.projectmanagement.js';
+import { createAgentEventSnapshot, createToolJobSnapshot, normalizeJsonObjectUndefined, validateAgentEventArchive, validateAgentEventSnapshot, validateToolJobSnapshot, } from '../dist_ts/utils.storecodecs.js';
+import { assertProjectionSession, assertProjectManagementSaveAdmitted, assertSameArchiveEvents, isProjectManagementTombstoneAdmitted, providerKey, validateExpectedRevision, validateIdentifier, validateProjectManagementWriteContext, validateSnapshotSave, } from '../dist_ts/utils.storerules.js';
+import { FlexRecordStore } from './classes.recordstore.js';
+function revisionWrite(current, snapshot, expectedRevision, conflict) {
+    const actualRevision = current?.revision ?? 0;
+    if (actualRevision !== expectedRevision)
+        throw conflict(actualRevision);
+    return { revision: snapshot.revision, value: snapshot };
+}
+function validateScope(value) {
+    assertFlexScopeSnapshot(value);
+    return value;
+}
+function validatePermission(value) {
+    assertFlexPermissionSnapshot(value);
+    return value;
+}
+function validateProjectManagement(value) {
+    assertFlexProjectManagementRecord(value);
+    return value;
+}
+class NoSqlScopeStore {
+    records;
+    constructor(records) {
+        this.records = records;
+    }
+    load(storageKey) {
+        validateIdentifier(storageKey, 'storageKey');
+        return this.records.read({ domain: 'scope', storageKey }, validateScope);
+    }
+    async save(storageKey, snapshot, expectedRevision) {
+        validateIdentifier(storageKey, 'storageKey');
+        const validated = validateSnapshotSave(snapshot, expectedRevision, assertFlexScopeSnapshot);
+        const conflict = (actualRevision) => new FlexHarnessStoreConflictError(storageKey, expectedRevision, actualRevision);
+        await this.records.mutate({ domain: 'scope', storageKey }, {
+            validate: validateScope,
+            decide: (current) => revisionWrite(current, validated, expectedRevision, conflict),
+            contention: conflict,
+        });
+    }
+}
+class NoSqlProjectionStore {
+    records;
+    constructor(records) {
+        this.records = records;
+    }
+    validator(sessionId) {
+        return (value) => {
+            assertFlexProjectionSnapshot(value);
+            assertProjectionSession(value, sessionId);
+            return value;
+        };
+    }
+    load(storageKey, sessionId) {
+        providerKey(storageKey, sessionId);
+        return this.records.read({ domain: 'projection', storageKey, sessionId }, this.validator(sessionId));
+    }
+    async save(storageKey, sessionId, snapshot, expectedRevision) {
+        const key = providerKey(storageKey, sessionId);
+        const validated = validateSnapshotSave(snapshot, expectedRevision, assertFlexProjectionSnapshot);
+        assertProjectionSession(validated, sessionId);
+        const conflict = (actualRevision) => new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+        await this.records.mutate({ domain: 'projection', storageKey, sessionId }, {
+            validate: this.validator(sessionId),
+            decide: (current) => revisionWrite(current, validated, expectedRevision, conflict),
+            contention: conflict,
+        });
+    }
+    deleteSession(storageKey, sessionId) {
+        providerKey(storageKey, sessionId);
+        return this.records.deleteOwner(storageKey, sessionId, ['projection']);
+    }
+}
+class NoSqlPermissionStore {
+    records;
+    constructor(records) {
+        this.records = records;
+    }
+    load(storageKey, sessionId) {
+        providerKey(storageKey, sessionId);
+        return this.records.read({ domain: 'permission', storageKey, sessionId }, validatePermission);
+    }
+    async save(storageKey, sessionId, snapshot, expectedRevision) {
+        const key = providerKey(storageKey, sessionId);
+        const validated = validateSnapshotSave(snapshot, expectedRevision, assertFlexPermissionSnapshot);
+        const conflict = (actualRevision) => new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+        await this.records.mutate({ domain: 'permission', storageKey, sessionId }, {
+            validate: validatePermission,
+            decide: (current) => revisionWrite(current, validated, expectedRevision, conflict),
+            contention: conflict,
+        });
+    }
+    deleteSession(storageKey, sessionId) {
+        providerKey(storageKey, sessionId);
+        return this.records.deleteOwner(storageKey, sessionId, ['permission']);
+    }
+}
+class NoSqlProjectManagementStore {
+    records;
+    constructor(records) {
+        this.records = records;
+    }
+    load(storageKey, sessionId) {
+        providerKey(storageKey, sessionId);
+        return this.records.read({ domain: 'projectManagement', storageKey, sessionId }, validateProjectManagement);
+    }
+    async save(storageKey, sessionId, snapshot, expectedRevision, writeContext) {
+        const key = providerKey(storageKey, sessionId);
+        validateProjectManagementWriteContext(writeContext);
+        const validated = validateSnapshotSave(snapshot, expectedRevision, assertFlexProjectManagementSnapshot);
+        await this.records.mutate({ domain: 'projectManagement', storageKey, sessionId }, {
+            validate: validateProjectManagement,
+            decide: (current) => {
+                assertProjectManagementSaveAdmitted(key, current, validated, expectedRevision);
+                return { revision: validated.revision, value: validated };
+            },
+            contention: (actualRevision) => new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision),
+        });
+    }
+    async tombstoneSession(storageKey, sessionId, tombstone, expectedRevision) {
+        const key = providerKey(storageKey, sessionId);
+        const validated = validateSnapshotSave(tombstone, expectedRevision, assertFlexProjectManagementTombstone);
+        await this.records.mutate({ domain: 'projectManagement', storageKey, sessionId }, {
+            validate: validateProjectManagement,
+            decide: (current) => (isProjectManagementTombstoneAdmitted(key, current, validated, expectedRevision)
+                ? { revision: validated.revision, value: validated }
+                : undefined),
+            contention: (actualRevision) => new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision),
+        });
+    }
+    purgeNamespace(storageKey) {
+        validateIdentifier(storageKey, 'storageKey');
+        return this.records.purgeNamespace(storageKey, 'projectManagement');
+    }
+}
+class NoSqlAgentEventStore {
+    records;
+    storageKey;
+    sessionId;
+    eventSchemaVersion = 2;
+    constructor(records, storageKey, sessionId) {
+        this.records = records;
+        this.storageKey = storageKey;
+        this.sessionId = sessionId;
+    }
+    assertSession(sessionId) {
+        if (sessionId !== this.sessionId) {
+            throw new FlexHarnessValidationError(`Agent event store is bound to session "${this.sessionId}", not "${sessionId}".`);
+        }
+    }
+    validateSnapshot = (value) => validateAgentEventSnapshot(value, this.sessionId);
+    load(sessionId) {
+        this.assertSession(sessionId);
+        return this.records.read({ domain: 'agentEvents', storageKey: this.storageKey, sessionId }, this.validateSnapshot);
+    }
+    async save(sessionId, events, expectedRevision) {
+        this.assertSession(sessionId);
+        validateExpectedRevision(expectedRevision);
+        const snapshot = createAgentEventSnapshot(sessionId, events, expectedRevision + 1);
+        validateAgentEventSnapshot(snapshot, sessionId);
+        const conflict = (actualRevision) => new plugins.AgentEventStoreConflictError(sessionId, expectedRevision, actualRevision);
+        await this.records.mutate({ domain: 'agentEvents', storageKey: this.storageKey, sessionId }, {
+            validate: this.validateSnapshot,
+            decide: (current) => revisionWrite(current, snapshot, expectedRevision, conflict),
+            contention: conflict,
+        });
+        return snapshot.revision;
+    }
+    async archive(archive) {
+        this.assertSession(archive.sessionId);
+        const normalized = normalizeJsonObjectUndefined(archive, '$archive');
+        const validated = validateAgentEventArchive(normalized, this.sessionId, archive.archiveId);
+        const address = {
+            domain: 'agentEventArchive',
+            storageKey: this.storageKey,
+            sessionId: this.sessionId,
+            archiveId: archive.archiveId,
+        };
+        await this.records.mutate(address, {
+            validate: (value) => validateAgentEventArchive(value, this.sessionId, archive.archiveId),
+            decide: (current) => {
+                if (!current)
+                    return { revision: 0, value: validated };
+                assertSameArchiveEvents(current, validated);
+                return undefined;
+            },
+            contention: () => new Error(`Archive "${archive.archiveId}" is contended by concurrent writers.`),
+        });
+    }
+    loadArchive(sessionId, archiveId) {
+        this.assertSession(sessionId);
+        validateIdentifier(archiveId, 'archiveId');
+        return this.records.read({ domain: 'agentEventArchive', storageKey: this.storageKey, sessionId, archiveId }, (value) => validateAgentEventArchive(value, this.sessionId, archiveId));
+    }
+}
+class NoSqlAgentEventStoreProvider {
+    records;
+    stores = new Map();
+    constructor(records) {
+        this.records = records;
+    }
+    getStore(storageKey, sessionId) {
+        const key = providerKey(storageKey, sessionId);
+        let store = this.stores.get(key);
+        if (!store) {
+            store = new NoSqlAgentEventStore(this.records, storageKey, sessionId);
+            this.stores.set(key, store);
+        }
+        return store;
+    }
+    releaseSession(storageKey, sessionId) {
+        this.stores.delete(providerKey(storageKey, sessionId));
+    }
+    async deleteSession(storageKey, sessionId) {
+        const key = providerKey(storageKey, sessionId);
+        await this.records.deleteOwner(storageKey, sessionId, ['agentEvents', 'agentEventArchive']);
+        this.stores.delete(key);
+    }
+}
+class NoSqlToolJobStore {
+    records;
+    storageKey;
+    sessionId;
+    constructor(records, storageKey, sessionId) {
+        this.records = records;
+        this.storageKey = storageKey;
+        this.sessionId = sessionId;
+    }
+    async load(abortSignal) {
+        abortSignal?.throwIfAborted();
+        const snapshot = await this.records.read({ domain: 'jobs', storageKey: this.storageKey, sessionId: this.sessionId }, validateToolJobSnapshot);
+        abortSignal?.throwIfAborted();
+        return snapshot;
+    }
+    async save(jobs, expectedRevision, abortSignal) {
+        abortSignal?.throwIfAborted();
+        validateExpectedRevision(expectedRevision);
+        const snapshot = createToolJobSnapshot(jobs, expectedRevision + 1);
+        const conflict = (actualRevision) => new plugins.ToolJobStoreConflictError(expectedRevision, actualRevision);
+        await this.records.mutate({ domain: 'jobs', storageKey: this.storageKey, sessionId: this.sessionId }, {
+            validate: validateToolJobSnapshot,
+            decide: (current) => {
+                abortSignal?.throwIfAborted();
+                return revisionWrite(current, snapshot, expectedRevision, conflict);
+            },
+            contention: conflict,
+        });
+        return snapshot.revision;
+    }
+}
+class NoSqlToolJobStoreProvider {
+    records;
+    stores = new Map();
+    constructor(records) {
+        this.records = records;
+    }
+    getStore(storageKey, sessionId) {
+        const key = providerKey(storageKey, sessionId);
+        let store = this.stores.get(key);
+        if (!store) {
+            store = new NoSqlToolJobStore(this.records, storageKey, sessionId);
+            this.stores.set(key, store);
+        }
+        return store;
+    }
+    releaseSession(storageKey, sessionId) {
+        this.stores.delete(providerKey(storageKey, sessionId));
+    }
+    async deleteSession(storageKey, sessionId) {
+        const key = providerKey(storageKey, sessionId);
+        await this.records.deleteOwner(storageKey, sessionId, ['jobs']);
+        this.stores.delete(key);
+    }
+}
+/**
+ * Every FlexHarness persistence domain on `@lossless.org/client/nosqldb`, with compare-and-swap
+ * that holds across processes. Records live in `flexharness_records`; payloads longer than one
+ * chunk live in `flexharness_chunks`.
+ */
+export class NoSqlFlexHarnessStores {
+    scopes;
+    projections;
+    permissions;
+    projectManagement;
+    agentEvents;
+    jobs;
+    records;
+    constructor(options) {
+        if (!(options?.db instanceof plugins.SmartdataDb)) {
+            throw new FlexHarnessValidationError('NoSqlFlexHarnessStores requires a SmartdataDb.');
+        }
+        this.records = new FlexRecordStore(options);
+        this.scopes = new NoSqlScopeStore(this.records);
+        this.projections = new NoSqlProjectionStore(this.records);
+        this.permissions = new NoSqlPermissionStore(this.records);
+        this.projectManagement = new NoSqlProjectManagementStore(this.records);
+        this.agentEvents = new NoSqlAgentEventStoreProvider(this.records);
+        this.jobs = new NoSqlToolJobStoreProvider(this.records);
+    }
+    /**
+     * Creates or verifies the two collections and their indexes. Every store operation awaits the
+     * same preparation, so calling it at startup only moves that work, and its failure, forward.
+     */
+    prepare() {
+        return this.records.prepare();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ub3NxbGRic3RvcmVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfc3RvcmVzX25vc3FsZGIvY2xhc3Nlcy5ub3NxbGRic3RvcmVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSw2QkFBNkIsRUFBRSwwQkFBMEIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBa0I1RixPQUFPLEVBQ0wsNEJBQTRCLEVBQzVCLDRCQUE0QixFQUM1Qix1QkFBdUIsR0FDeEIsTUFBTSxxQkFBcUIsQ0FBQztBQUM3QixPQUFPLEVBQ0wsaUNBQWlDLEVBQ2pDLG1DQUFtQyxFQUNuQyxvQ0FBb0MsR0FDckMsTUFBTSxrQ0FBa0MsQ0FBQztBQUMxQyxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLHFCQUFxQixFQUNyQiw0QkFBNEIsRUFDNUIseUJBQXlCLEVBQ3pCLDBCQUEwQixFQUMxQix1QkFBdUIsR0FDeEIsTUFBTSw0QkFBNEIsQ0FBQztBQUNwQyxPQUFPLEVBQ0wsdUJBQXVCLEVBQ3ZCLG1DQUFtQyxFQUNuQyx1QkFBdUIsRUFDdkIsb0NBQW9DLEVBQ3BDLFdBQVcsRUFDWCx3QkFBd0IsRUFDeEIsa0JBQWtCLEVBQ2xCLHFDQUFxQyxFQUNyQyxvQkFBb0IsR0FDckIsTUFBTSwyQkFBMkIsQ0FBQztBQUNuQyxPQUFPLEVBQUUsZUFBZSxFQUF5QixNQUFNLDBCQUEwQixDQUFDO0FBRWxGLFNBQVMsYUFBYSxDQUNwQixPQUF5QyxFQUN6QyxRQUFtQixFQUNuQixnQkFBd0IsRUFDeEIsUUFBMkM7SUFFM0MsTUFBTSxjQUFjLEdBQUcsT0FBTyxFQUFFLFFBQVEsSUFBSSxDQUFDLENBQUM7SUFDOUMsSUFBSSxjQUFjLEtBQUssZ0JBQWdCO1FBQUUsTUFBTSxRQUFRLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDeEUsT0FBTyxFQUFFLFFBQVEsRUFBRSxRQUFRLENB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

package/dist_ts_stores_nosqldb/classes.recordstore.d.ts

@@ -0,0 +1,110 @@
+import * as plugins from './plugins.js';
+export type TFlexRecordDomain = 'scope' | 'projection' | 'permission' | 'projectManagement' | 'agentEvents' | 'agentEventArchive' | 'jobs';
+/** Names one record: a domain snapshot of a storage key, a session or an archive. */
+export interface IFlexRecordAddress {
+    domain: TFlexRecordDomain;
+    storageKey: string;
+    sessionId?: string;
+    archiveId?: string;
+}
+/** The next stored value a mutation decided on. */
+export interface IFlexRecordWrite {
+    revision: number;
+    value: unknown;
+}
+export interface IFlexRecordMutation<TValue> {
+    validate: (value: unknown) => TValue;
+    /** Decides on the stored value: the next value, nothing to write, or a thrown rejection. */
+    decide: (current: TValue | undefined) => IFlexRecordWrite | undefined;
+    /** The conflict to report when concurrent writers keep winning the compare-and-swap. */
+    contention: (actualRevision: number) => Error;
+}
+export declare const FLEX_RECORD_COLLECTION = "flexharness_records";
+export declare const FLEX_CHUNK_COLLECTION = "flexharness_chunks";
+/**
+ * UTF-16 code units a record holds inline, and the size of each chunk of a longer payload. A
+ * chunk stays below 3 MiB of UTF-8, far under the 16 MiB document limit NoSQLDB and MongoDB
+ * enforce, so a record and each of its chunks always fit one document.
+ */
+export declare const FLEX_RECORD_CHUNK_CODE_UNITS: number;
+/**
+ * The head of one record. A payload up to one chunk is stored inline; a longer one lives in
+ * immutable chunks named by `blobId`. `writeToken` changes on every committed write and is the
+ * compare-and-swap fence. A head without payload or blob is a placeholder that reserves the
+ * record for a chunked first write; it reads as absent.
+ */
+export declare class FlexRecordDocument extends plugins.SmartDataDbDoc<FlexRecordDocument, FlexRecordDocument> {
+    recordId: string;
+    domain: TFlexRecordDomain;
+    ownerKey: string;
+    namespaceKey: string;
+    revision: number;
+    writeToken: string;
+    payload: string | null;
+    blobId: string | null;
+    chunkCount: number;
+    payloadSha256: string | null;
+    /** Set before the first chunk of this record is written; the record's writes then sweep. */
+    chunked: boolean;
+    sweepCount: number;
+}
+/** One immutable piece of a chunked payload, written against the head token it will replace. */
+export declare class FlexChunkDocument extends plugins.SmartDataDbDoc<FlexChunkDocument, FlexChunkDocument> {
+    chunkId: string;
+    recordId: string;
+    domain: TFlexRecordDomain;
+    ownerKey: string;
+    namespaceKey: string;
+    blobId: string;
+    baseToken: string;
+    index: number;
+    data: string;
+}
+export interface IFlexRecordStoreOptions {
+    db: plugins.SmartdataDb;
+    operationTimeoutMs?: number;
+}
+/**
+ * Compare-and-swap records on `@lossless.org/client/nosqldb`. A write reads the head, decides,
+ * writes any chunks, and swaps the head only while its `writeToken` is unchanged. Chunks of a
+ * replaced or abandoned payload are swept in a transaction that also touches the head, so a
+ * concurrent deletion or writer can never lose chunks its head references.
+ */
+export declare class FlexRecordStore {
+    private readonly db;
+    private readonly timeoutMs;
+    private readonly records;
+    private readonly chunks;
+    private preparation?;
+    constructor(options: IFlexRecordStoreOptions);
+    /** Creates or verifies both collections and their indexes once; a failed attempt is retried. */
+    prepare(): Promise<void>;
+    private prepareCollections;
+    private resolve;
+    read<TValue>(address: IFlexRecordAddress, validate: (value: unknown) => TValue): Promise<TValue | undefined>;
+    mutate<TValue>(address: IFlexRecordAddress, mutation: IFlexRecordMutation<TValue>): Promise<void>;
+    /** Deletes every record and chunk one session owns in the given domains. */
+    deleteOwner(storageKey: string, sessionId: string, domains: readonly TFlexRecordDomain[]): Promise<void>;
+    /** Deletes every record and chunk of one domain in a storage namespace. */
+    purgeNamespace(storageKey: string, domain: TFlexRecordDomain): Promise<void>;
+    private deleteInTransaction;
+    private parse;
+    private findHead;
+    private readHead;
+    private readBlob;
+    /** Returns false when another writer swapped the head first; nothing of this write remains. */
+    private commit;
+    private newHead;
+    private insertHead;
+    /** Reserves the record for a chunked first write, so its chunks have a head token to replace. */
+    private insertPlaceholder;
+    private markChunked;
+    private writeBlob;
+    /**
+     * Deletes the record's chunks that no head can reference any more: every blob but the current
+     * one that was written against another head token. A writer that read the current token keeps
+     * its chunks. Touching the head in the same transaction makes a concurrent deletion conflict,
+     * so chunks written after a deletion are never swept by a transaction that predates it.
+     */
+    private sweep;
+}