@neottia/repository-store 0.2.0

package/dist/sqlite/cache-publication.js

@@ -0,0 +1,191 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { lstatSync, mkdirSync, opendirSync, renameSync, rmSync, rmdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { RecoveryError, ResourceLimitError } from '../errors.js';
+import { assertSafeRegular, ensurePrivateDirectory, readRegularFile, syncDirectory } from '../internal/filesystem.js';
+import { getPathState, getRootState, } from '../internal/model.js';
+import { publishExactRegularFile, recoverExactPublication } from '../internal/publication.js';
+import { assertLiveLease, checkControl } from '../lease.js';
+import { resolveManagedPath, validateRelativePath } from '../paths.js';
+import { computeByteRevision, isByteRevision } from '../revision.js';
+import { writeDurableFile } from '../transaction/journal.js';
+const STATE_NAME = /^([0-9a-f]{64})\.(prepare|active|cleanup)$/u;
+export function recoverCachePublications(root, lease, options = {}) {
+    assertLiveLease(root, lease);
+    checkControl(options);
+    const state = requireRootState(root);
+    const publications = publicationRoot(state.authorityRoot, state.managedRootId);
+    const entries = readDirectoryBounded(publications, state.limits.maxFiles, () => new ResourceLimitError('Cache publication recovery exceeds maxFiles.')).sort();
+    for (const name of entries) {
+        checkControl(options);
+        const match = STATE_NAME.exec(name);
+        if (match === null)
+            continue;
+        const token = match[1];
+        const phase = match[2];
+        const directory = join(publications, name);
+        assertStateDirectory(directory);
+        if (phase === 'active') {
+            const manifest = readManifest(directory, state.limits.maxJournalBytes);
+            validateManifest(manifest, state.authorityId, state.managedRootId, token);
+            const path = resolveManagedPath(root, manifest.path);
+            const pathState = getPathState(path);
+            if (pathState === undefined)
+                throw malformed('Recovered cache path is not a repository-store handle.');
+            recoverExactPublication(pathState.absolutePath, token, [manifest.originalRevision, manifest.intendedRevision], state.limits.maxTemporaryBytes);
+            const cleanup = join(publications, `${token}.cleanup`);
+            renameSync(directory, cleanup);
+            syncDirectory(publications);
+            cleanupStateDirectory(cleanup, publications, state.limits.maxJournalBytes);
+        }
+        else {
+            cleanupStateDirectory(directory, publications, state.limits.maxJournalBytes);
+        }
+    }
+}
+export function publishCacheDatabase(root, lease, path, bytes, expected, options = {}) {
+    assertLiveLease(root, lease);
+    checkControl(options);
+    const state = requireRootState(root);
+    const pathState = getPathState(path);
+    if (pathState === undefined)
+        throw malformed('Cache path is not a repository-store handle.');
+    const publications = publicationRoot(state.authorityRoot, state.managedRootId);
+    const token = randomBytes(32).toString('hex');
+    const prepare = join(publications, `${token}.prepare`);
+    mkdirSync(prepare, { mode: 0o700 });
+    const unsigned = {
+        version: 1,
+        token,
+        authorityId: state.authorityId,
+        managedRootId: state.managedRootId,
+        path: path.relativePath,
+        originalRevision: expected?.revision ?? null,
+        intendedRevision: computeByteRevision(bytes),
+        createdAt: new Date().toISOString(),
+    };
+    const manifest = { ...unsigned, digest: digest(unsigned) };
+    writeDurableFile(join(prepare, 'manifest.json'), new TextEncoder().encode(JSON.stringify(manifest)));
+    syncDirectory(prepare);
+    const active = join(publications, `${token}.active`);
+    renameSync(prepare, active);
+    syncDirectory(publications);
+    let publicationError;
+    try {
+        publishExactRegularFile(pathState.absolutePath, bytes, expected, token);
+    }
+    catch (error) {
+        publicationError = error;
+        recoverExactPublication(pathState.absolutePath, token, [manifest.originalRevision, manifest.intendedRevision], state.limits.maxTemporaryBytes);
+    }
+    const cleanup = join(publications, `${token}.cleanup`);
+    renameSync(active, cleanup);
+    syncDirectory(publications);
+    cleanupStateDirectory(cleanup, publications, state.limits.maxJournalBytes);
+    if (publicationError !== undefined)
+        throw publicationError;
+}
+function publicationRoot(authorityRoot, managedRootId) {
+    if (!/^[0-9a-f]{64}$/u.test(managedRootId))
+        throw malformed('Managed-root cache identity is invalid.');
+    const path = join(authorityRoot, '.neottia', 'repository-store', 'cache-publications', managedRootId);
+    ensurePrivateDirectory(path);
+    return path;
+}
+function readManifest(directory, maxBytes) {
+    const path = join(directory, 'manifest.json');
+    const stat = lstatSync(path);
+    assertSafeRegular(stat, path);
+    if (stat.size > maxBytes)
+        throw malformed('Cache publication manifest exceeds maxJournalBytes.');
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder().decode(readRegularFile(path, maxBytes)));
+    }
+    catch (error) {
+        throw malformed('Cache publication manifest is not valid JSON.', error);
+    }
+    if (!isManifest(value))
+        throw malformed('Cache publication manifest has an invalid schema.');
+    const { digest: actual, ...unsigned } = value;
+    if (digest(unsigned) !== actual)
+        throw malformed('Cache publication manifest digest does not match.');
+    return value;
+}
+function validateManifest(manifest, authorityId, managedRootId, token) {
+    if (manifest.authorityId !== authorityId || manifest.managedRootId !== managedRootId || manifest.token !== token)
+        throw malformed('Cache publication identity does not match its authority or state directory.');
+    validateRelativePath(manifest.path);
+}
+function cleanupStateDirectory(directory, parent, maxBytes) {
+    const entries = readDirectoryBounded(directory, 1, () => malformed('Cache publication state contains more than one artifact.'));
+    if (entries.some((name) => name !== 'manifest.json'))
+        throw malformed('Cache publication state contains an unowned artifact.');
+    if (entries.includes('manifest.json')) {
+        const path = join(directory, 'manifest.json');
+        const stat = lstatSync(path);
+        assertSafeRegular(stat, path);
+        if (stat.size > maxBytes)
+            throw malformed('Cache publication manifest exceeds maxJournalBytes.');
+        rmSync(path);
+    }
+    rmdirSync(directory);
+    syncDirectory(parent);
+}
+function readDirectoryBounded(path, limit, overflow) {
+    const directory = opendirSync(path);
+    const entries = [];
+    try {
+        while (true) {
+            const entry = directory.readSync();
+            if (entry === null)
+                return entries;
+            if (entries.length >= limit)
+                throw overflow();
+            entries.push(entry.name);
+        }
+    }
+    finally {
+        try {
+            directory.closeSync();
+        }
+        catch {
+        }
+    }
+}
+function assertStateDirectory(path) {
+    const stat = lstatSync(path);
+    if (stat.isSymbolicLink() || !stat.isDirectory())
+        throw malformed(`Unsafe cache publication state path: ${path}`);
+}
+function digest(manifest) {
+    return createHash('sha256').update(JSON.stringify(manifest)).digest('hex');
+}
+function isManifest(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const manifest = value;
+    return (manifest.version === 1 &&
+        typeof manifest.token === 'string' &&
+        /^[0-9a-f]{64}$/u.test(manifest.token) &&
+        typeof manifest.authorityId === 'string' &&
+        /^[0-9a-f]{64}$/u.test(manifest.authorityId) &&
+        typeof manifest.managedRootId === 'string' &&
+        /^[0-9a-f]{64}$/u.test(manifest.managedRootId) &&
+        typeof manifest.path === 'string' &&
+        (manifest.originalRevision === null || isByteRevision(manifest.originalRevision)) &&
+        isByteRevision(manifest.intendedRevision) &&
+        typeof manifest.createdAt === 'string' &&
+        typeof manifest.digest === 'string' &&
+        /^[0-9a-f]{64}$/u.test(manifest.digest));
+}
+function requireRootState(root) {
+    const state = getRootState(root);
+    if (state === undefined)
+        throw malformed('Managed root is not a repository-store handle.');
+    return state;
+}
+function malformed(message, cause) {
+    return new RecoveryError(message, 'RECOVERY_MALFORMED', undefined, cause === undefined ? undefined : { cause });
+}
+//# sourceMappingURL=cache-publication.js.map

package/dist/sqlite/cache-publication.js.map

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

package/dist/sqlite/cache.d.ts

@@ -0,0 +1,26 @@
+import type { SqliteConnection } from './adapter.js';
+import { type ManagedPath, type ManagedRoot, type RepositoryLease } from '../internal/model.js';
+import { type OperationControl } from '../lease.js';
+export interface DisposableCacheSpecification {
+    readonly path: ManagedPath;
+    readonly applicationId: number;
+    readonly schemaVersion: number;
+    readonly canonicalDigest: string;
+    readonly schemaSql: readonly string[];
+    populate(database: SqliteConnection): Promise<void>;
+    healthCheck(database: SqliteConnection): Promise<void>;
+}
+export interface DisposableSqliteCache {
+    readonly state: 'ready';
+    readonly database: SqliteConnection;
+    close(): Promise<void>;
+}
+export type CacheRebuildReason = 'missing' | 'corrupt' | 'wrong-application' | 'wrong-schema' | 'stale-digest' | 'failed-integrity' | 'contradictory';
+export type CacheOpenResult = DisposableSqliteCache | {
+    readonly state: 'rebuild-required';
+    readonly reason: CacheRebuildReason;
+};
+export declare function openDisposableSqliteCache(root: ManagedRoot, lease: RepositoryLease, specification: DisposableCacheSpecification, options?: OperationControl): Promise<CacheOpenResult>;
+export declare function rebuildDisposableSqliteCache(root: ManagedRoot, lease: RepositoryLease, specification: DisposableCacheSpecification, options?: OperationControl): Promise<DisposableSqliteCache>;
+export declare function removeDisposableSqliteCache(root: ManagedRoot, lease: RepositoryLease, path: ManagedPath, options?: OperationControl): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/sqlite/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/sqlite/cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAqC,MAAM,cAAc,CAAC;AAYxF,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAsD,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIxG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAGD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,SAAS,GAAG,mBAAmB,GAAG,cAAc,GAAG,cAAc,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAGvH,MAAM,MAAM,eAAe,GACzB,qBAAqB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAGtG,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,4BAA4B,EAC3C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA4D1B;AAGD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,4BAA4B,EAC3C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAuJhC;AAGD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAWf"}