@quadnix/octo 0.0.30 → 0.1.0

package/dist/services/state-management/file-app-lock.utility.js

@@ -0,0 +1,124 @@
+import { randomUUID } from 'node:crypto';
+import { readFile, rm, writeFile } from 'node:fs/promises';
+import { TransactionError } from '../../errors/index.js';
+/**
+ * The app lock, kept as a file on disk. Shared by the state providers that keep state in a directory.
+ *
+ * The lock is taken with an exclusive create, which the filesystem resolves atomically: of two
+ * processes racing for the same path, exactly one succeeds. Reading first and writing second would
+ * let both believe they hold it.
+ *
+ * The lock never expires, so a run that died holding one leaves it held until a person releases it
+ * with `octo unlock --force`. That decision turns on whether the holder is still working, so the
+ * record carries the time it was taken and a blocked run is told how long it has been held.
+ *
+ * @internal
+ */
+export class FileAppLockUtility {
+    /**
+     * @internal
+     */
+    static async getAppLock(lockFilePath) {
+        return (await this.readLock(lockFilePath))?.lockId;
+    }
+    /**
+     * @internal
+     */
+    static async isAppLocked(lockFilePath, lockId) {
+        const existingLockId = await this.getAppLock(lockFilePath);
+        if (!existingLockId) {
+            return false;
+        }
+        if (existingLockId !== lockId) {
+            throw new TransactionError('Invalid lock ID!');
+        }
+        return true;
+    }
+    /**
+     * @internal
+     */
+    static async lockApp(lockFilePath) {
+        const lockId = randomUUID();
+        const record = { lockId, startedAt: new Date().toISOString() };
+        try {
+            await writeFile(lockFilePath, JSON.stringify(record), { flag: 'wx' });
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                // The holder is read back and reported, so a blocked run can be told what to break without a
+                // separate command to ask, and how long it has been held without one either.
+                const holder = await this.readLock(lockFilePath);
+                const heldFor = holder?.startedAt ? this.describeAge(holder.startedAt) : undefined;
+                throw new TransactionError(`App already locked with lock ID "${holder?.lockId}"${heldFor ? `, held for ${heldFor}` : ''}!`);
+            }
+            throw error;
+        }
+        return { lockId };
+    }
+    /**
+     * @internal
+     */
+    static async unlockApp(lockFilePath, lockId) {
+        const existingLockId = await this.getAppLock(lockFilePath);
+        if (!existingLockId) {
+            return;
+        }
+        if (existingLockId !== lockId) {
+            throw new TransactionError('Invalid lock ID!');
+        }
+        await rm(lockFilePath, { force: true });
+    }
+    /**
+     * How long the lock has been held, as a short readable span. Undefined when the recorded time
+     * cannot be read as one, so a broken value is left out rather than reported as a negative age.
+     */
+    static describeAge(startedAt) {
+        const heldForMs = Date.now() - Date.parse(startedAt);
+        if (!Number.isFinite(heldForMs) || heldForMs < 0) {
+            return undefined;
+        }
+        const seconds = Math.floor(heldForMs / 1000);
+        if (seconds < 60) {
+            return `${seconds}s`;
+        }
+        const minutes = Math.floor(seconds / 60);
+        if (minutes < 60) {
+            return `${minutes}m`;
+        }
+        const hours = Math.floor(minutes / 60);
+        if (hours < 24) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        return `${Math.floor(hours / 24)}d ${hours % 24}h`;
+    }
+    /**
+     * The lock file's record, or undefined when no lock is held. A file holding an id and nothing else
+     * is a lock taken before the record carried a time, and reads as that id with no age.
+     */
+    static async readLock(lockFilePath) {
+        let contents;
+        try {
+            contents = (await readFile(lockFilePath, 'utf-8')).trim();
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return undefined;
+            }
+            throw error;
+        }
+        if (!contents) {
+            return undefined;
+        }
+        if (!contents.startsWith('{')) {
+            return { lockId: contents };
+        }
+        try {
+            const record = JSON.parse(contents);
+            return typeof record.lockId === 'string' ? record : { lockId: contents };
+        }
+        catch (error) {
+            return { lockId: contents };
+        }
+    }
+}
+//# sourceMappingURL=file-app-lock.utility.js.map

package/dist/services/state-management/file-app-lock.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-app-lock.utility.js","sourceRoot":"","sources":["../../../src/services/state-management/file-app-lock.utility.ts"],"names":[],"mappings":"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"}

package/dist/services/state-management/local-encryption.state-provider.d.ts

@@ -1,20 +1,71 @@
 import type { IStateProvider } from './state-provider.interface.js';
 /**
+ * Keeps state in a local directory, encrypted, with an `.enc` suffix.
+ *
+ * The point is that the resulting files are safe to commit to version control, which gives a small
+ * team shared state without any infrastructure to run.
+ *
+ * @example
+ * ```ts
+ * await octo.initialize(new LocalEncryptionStateProvider('./infrastructure', process.env.OCTO_KEY!));
+ * ```
+ *
  * @group Services/State Management
+ *
+ * @see Techniques for [State Providers](/docs/techniques/state-providers).
  */
 export declare class LocalEncryptionStateProvider implements IStateProvider {
     private readonly encryptionKey;
     private readonly localStateDirectoryPath;
     private readonly lockFilePath;
+    /**
+     * @param localStateDirectoryPath The directory state files are written into.
+     * @param encryptionKey The key state is encrypted with. It must be at least 3 characters.
+     * @throws {@link TransactionError} If the key is too weak.
+     */
     constructor(localStateDirectoryPath: string, encryptionKey: string);
-    private addOrUpdateAppLock;
+    /**
+     * Deletes a state file. Deleting one that is not there is not an error.
+     */
+    deleteState(stateFileName: string): Promise<void>;
+    /**
+     * The id of the lock currently held, or `undefined` when the app is unlocked. The lock file is not
+     * encrypted - a lock id identifies a run, and reveals nothing about the state it guards.
+     */
     getAppLock(): Promise<string | undefined>;
+    /**
+     * Reads a state file.
+     *
+     * @throws {@link TransactionError} With the message `No state found!` when the file does not exist.
+     */
     getState(stateFileName: string): Promise<Buffer>;
+    /**
+     * Whether `lockId` is the lock currently held.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     isAppLocked(lockId: string): Promise<boolean>;
+    /**
+     * The names of the state files whose name starts with `prefix`, with the `.enc` suffix removed so
+     * a caller can read them back by the name it knows.
+     */
+    listStates(prefix: string): Promise<string[]>;
+    /**
+     * Takes the app lock, writing its id into `local-state.lock` beside the state files.
+     *
+     * @throws {@link TransactionError} When a lock is held, naming the id that holds it.
+     */
     lockApp(): Promise<{
         lockId: string;
     }>;
+    /**
+     * Writes a state file, overwriting whatever was there.
+     */
     saveState(stateFileName: string, data: Buffer): Promise<void>;
+    /**
+     * Releases the app lock by deleting the lock file.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     unlockApp(lockId: string): Promise<void>;
-    updateAppLockTransaction(lockId: string): Promise<void>;
 }

package/dist/services/state-management/local-encryption.state-provider.js

@@ -1,40 +1,55 @@
-import { readFile, writeFile } from 'fs/promises';
+import { readdir, rm } from 'fs/promises';
 import { join, resolve } from 'path';
 import { TransactionError } from '../../errors/index.js';
 import { FileUtility } from '../../utilities/file/file.utility.js';
+import { FileAppLockUtility } from './file-app-lock.utility.js';
 /**
+ * Keeps state in a local directory, encrypted, with an `.enc` suffix.
+ *
+ * The point is that the resulting files are safe to commit to version control, which gives a small
+ * team shared state without any infrastructure to run.
+ *
+ * @example
+ * ```ts
+ * await octo.initialize(new LocalEncryptionStateProvider('./infrastructure', process.env.OCTO_KEY!));
+ * ```
+ *
  * @group Services/State Management
+ *
+ * @see Techniques for [State Providers](/docs/techniques/state-providers).
  */
 export class LocalEncryptionStateProvider {
+    /**
+     * @param localStateDirectoryPath The directory state files are written into.
+     * @param encryptionKey The key state is encrypted with. It must be at least 3 characters.
+     * @throws {@link TransactionError} If the key is too weak.
+     */
     constructor(localStateDirectoryPath, encryptionKey) {
         if (encryptionKey.length < 3) {
             throw new TransactionError('Selected encryption key is too weak!');
         }
         this.encryptionKey = encryptionKey;
         this.localStateDirectoryPath = resolve(localStateDirectoryPath);
-        this.lockFilePath = resolve(join(localStateDirectoryPath, 'local-state.lock'));
+        this.lockFilePath = join(this.localStateDirectoryPath, 'local-state.lock');
     }
-    async addOrUpdateAppLock(lockId) {
-        await writeFile(this.lockFilePath, lockId);
+    /**
+     * Deletes a state file. Deleting one that is not there is not an error.
+     */
+    async deleteState(stateFileName) {
+        await rm(join(this.localStateDirectoryPath, stateFileName + '.enc'), { force: true });
     }
+    /**
+     * The id of the lock currently held, or `undefined` when the app is unlocked. The lock file is not
+     * encrypted - a lock id identifies a run, and reveals nothing about the state it guards.
+     */
     async getAppLock() {
-        try {
-            const contents = await readFile(this.lockFilePath, 'utf-8');
-            const appLock = contents.replace(/\s/g, '');
-            if (!appLock) {
-                return undefined;
-            }
-            return appLock;
-        }
-        catch (error) {
-            if (error.code === 'ENOENT') {
-                return undefined;
-            }
-            else {
-                throw error;
-            }
-        }
+        return FileAppLockUtility.getAppLock(this.lockFilePath);
     }
+    /**
+     * Reads a state file.
+     *
+     * @throws {@link TransactionError} With the message `No state found!` when the file does not exist.
+     */
     async getState(stateFileName) {
         try {
             return await FileUtility.decryptFileToBuffer(join(this.localStateDirectoryPath, stateFileName + '.enc'), this.encryptionKey);
@@ -46,45 +61,56 @@ export class LocalEncryptionStateProvider {
             throw error;
         }
     }
+    /**
+     * Whether `lockId` is the lock currently held.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     async isAppLocked(lockId) {
-        const existingLockId = await this.getAppLock();
-        if (!existingLockId) {
-            return false;
-        }
-        if (lockId !== existingLockId) {
-            throw new TransactionError('Invalid lock ID!');
+        return FileAppLockUtility.isAppLocked(this.lockFilePath, lockId);
+    }
+    /**
+     * The names of the state files whose name starts with `prefix`, with the `.enc` suffix removed so
+     * a caller can read them back by the name it knows.
+     */
+    async listStates(prefix) {
+        let entries;
+        try {
+            entries = await readdir(this.localStateDirectoryPath);
         }
-        else {
-            return true;
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
         }
+        return entries
+            .filter((entry) => entry.endsWith('.enc') && entry.startsWith(prefix))
+            .map((entry) => entry.slice(0, -'.enc'.length));
     }
+    /**
+     * Takes the app lock, writing its id into `local-state.lock` beside the state files.
+     *
+     * @throws {@link TransactionError} When a lock is held, naming the id that holds it.
+     */
     async lockApp() {
-        const existingLockId = await this.getAppLock();
-        if (existingLockId) {
-            throw new TransactionError('App already locked!');
-        }
-        const lockId = crypto.randomUUID();
-        await this.addOrUpdateAppLock(lockId);
-        return { lockId };
+        await FileUtility.ensureDirectory(this.localStateDirectoryPath);
+        return FileAppLockUtility.lockApp(this.lockFilePath);
     }
+    /**
+     * Writes a state file, overwriting whatever was there.
+     */
     async saveState(stateFileName, data) {
+        await FileUtility.ensureDirectory(this.localStateDirectoryPath);
         await FileUtility.encryptBufferToFile(data, join(this.localStateDirectoryPath, stateFileName + '.enc'), this.encryptionKey);
     }
+    /**
+     * Releases the app lock by deleting the lock file.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     async unlockApp(lockId) {
-        const existingLockId = await this.getAppLock();
-        if (!existingLockId) {
-            return;
-        }
-        if (lockId !== existingLockId) {
-            throw new TransactionError('Invalid lock ID!');
-        }
-        await this.addOrUpdateAppLock('');
-    }
-    async updateAppLockTransaction(lockId) {
-        const isAppLocked = await this.isAppLocked(lockId);
-        if (!isAppLocked) {
-            throw new TransactionError('App is unlocked!');
-        }
+        return FileAppLockUtility.unlockApp(this.lockFilePath, lockId);
     }
 }
 //# sourceMappingURL=local-encryption.state-provider.js.map

package/dist/services/state-management/local-encryption.state-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-encryption.state-provider.js","sourceRoot":"","sources":["../../../src/services/state-management/local-encryption.state-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-encryption.state-provider.js","sourceRoot":"","sources":["../../../src/services/state-management/local-encryption.state-provider.ts"],"names":[],"mappings":"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"}

package/dist/services/state-management/local.state-provider.d.ts

@@ -1,19 +1,66 @@
 import type { IStateProvider } from './state-provider.interface.js';
 /**
+ * Keeps state in a directory on the local filesystem.
+ *
+ * Good for experimenting on your own machine. It is not shared, so a team running Octo against the
+ * same infrastructure needs a provider that persists somewhere they all reach.
+ *
+ * @example
+ * ```ts
+ * await octo.initialize(new LocalStateProvider('./infrastructure'));
+ * ```
+ *
  * @group Services/State Management
+ *
+ * @see Techniques for [State Providers](/docs/techniques/state-providers).
  */
 export declare class LocalStateProvider implements IStateProvider {
     private readonly localStateDirectoryPath;
     private readonly lockFilePath;
+    /**
+     * @param localStateDirectoryPath The directory state files are written into.
+     */
     constructor(localStateDirectoryPath: string);
-    private addOrUpdateAppLock;
+    /**
+     * Deletes a state file. Deleting one that is not there is not an error.
+     */
+    deleteState(stateFileName: string): Promise<void>;
+    /**
+     * The id of the lock currently held, or `undefined` when the app is unlocked.
+     */
     getAppLock(): Promise<string | undefined>;
+    /**
+     * Reads a state file.
+     *
+     * @throws {@link TransactionError} With the message `No state found!` when the file does not exist.
+     */
     getState(stateFileName: string): Promise<Buffer>;
+    /**
+     * Whether `lockId` is the lock currently held.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     isAppLocked(lockId: string): Promise<boolean>;
+    /**
+     * The names of the state files whose name starts with `prefix`.
+     */
+    listStates(prefix: string): Promise<string[]>;
+    /**
+     * Takes the app lock, writing its id into `local-state.lock` beside the state files.
+     *
+     * @throws {@link TransactionError} When a lock is held, naming the id that holds it.
+     */
     lockApp(): Promise<{
         lockId: string;
     }>;
+    /**
+     * Writes a state file, overwriting whatever was there.
+     */
     saveState(stateFileName: string, data: Buffer): Promise<void>;
+    /**
+     * Releases the app lock by deleting the lock file.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     unlockApp(lockId: string): Promise<void>;
-    updateAppLockTransaction(lockId: string): Promise<void>;
 }

package/dist/services/state-management/local.state-provider.js

@@ -1,35 +1,48 @@
-import { readFile, writeFile } from 'fs/promises';
+import { readFile, readdir, rm, writeFile } from 'fs/promises';
 import { join, resolve } from 'path';
 import { TransactionError } from '../../errors/index.js';
+import { FileUtility } from '../../utilities/file/file.utility.js';
+import { FileAppLockUtility } from './file-app-lock.utility.js';
 /**
+ * Keeps state in a directory on the local filesystem.
+ *
+ * Good for experimenting on your own machine. It is not shared, so a team running Octo against the
+ * same infrastructure needs a provider that persists somewhere they all reach.
+ *
+ * @example
+ * ```ts
+ * await octo.initialize(new LocalStateProvider('./infrastructure'));
+ * ```
+ *
  * @group Services/State Management
+ *
+ * @see Techniques for [State Providers](/docs/techniques/state-providers).
  */
 export class LocalStateProvider {
+    /**
+     * @param localStateDirectoryPath The directory state files are written into.
+     */
     constructor(localStateDirectoryPath) {
         this.localStateDirectoryPath = resolve(localStateDirectoryPath);
-        this.lockFilePath = resolve(join(localStateDirectoryPath, 'local-state.lock'));
+        this.lockFilePath = join(this.localStateDirectoryPath, 'local-state.lock');
     }
-    async addOrUpdateAppLock(lockId) {
-        await writeFile(this.lockFilePath, lockId);
+    /**
+     * Deletes a state file. Deleting one that is not there is not an error.
+     */
+    async deleteState(stateFileName) {
+        await rm(join(this.localStateDirectoryPath, stateFileName), { force: true });
     }
+    /**
+     * The id of the lock currently held, or `undefined` when the app is unlocked.
+     */
     async getAppLock() {
-        try {
-            const contents = await readFile(this.lockFilePath, 'utf-8');
-            const appLock = contents.replace(/\s/g, '');
-            if (!appLock) {
-                return undefined;
-            }
-            return appLock;
-        }
-        catch (error) {
-            if (error.code === 'ENOENT') {
-                return undefined;
-            }
-            else {
-                throw error;
-            }
-        }
+        return FileAppLockUtility.getAppLock(this.lockFilePath);
     }
+    /**
+     * Reads a state file.
+     *
+     * @throws {@link TransactionError} With the message `No state found!` when the file does not exist.
+     */
     async getState(stateFileName) {
         try {
             return await readFile(join(this.localStateDirectoryPath, stateFileName));
@@ -41,45 +54,53 @@ export class LocalStateProvider {
             throw error;
         }
     }
+    /**
+     * Whether `lockId` is the lock currently held.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     async isAppLocked(lockId) {
-        const existingLockId = await this.getAppLock();
-        if (!existingLockId) {
-            return false;
-        }
-        if (lockId !== existingLockId) {
-            throw new TransactionError('Invalid lock ID!');
+        return FileAppLockUtility.isAppLocked(this.lockFilePath, lockId);
+    }
+    /**
+     * The names of the state files whose name starts with `prefix`.
+     */
+    async listStates(prefix) {
+        let entries;
+        try {
+            entries = await readdir(this.localStateDirectoryPath);
         }
-        else {
-            return true;
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
         }
+        return entries.filter((entry) => entry.startsWith(prefix));
     }
+    /**
+     * Takes the app lock, writing its id into `local-state.lock` beside the state files.
+     *
+     * @throws {@link TransactionError} When a lock is held, naming the id that holds it.
+     */
     async lockApp() {
-        const existingLockId = await this.getAppLock();
-        if (existingLockId) {
-            throw new TransactionError('App already locked!');
-        }
-        const lockId = crypto.randomUUID();
-        await this.addOrUpdateAppLock(lockId);
-        return { lockId };
+        await FileUtility.ensureDirectory(this.localStateDirectoryPath);
+        return FileAppLockUtility.lockApp(this.lockFilePath);
     }
+    /**
+     * Writes a state file, overwriting whatever was there.
+     */
     async saveState(stateFileName, data) {
+        await FileUtility.ensureDirectory(this.localStateDirectoryPath);
         await writeFile(join(this.localStateDirectoryPath, stateFileName), data);
     }
+    /**
+     * Releases the app lock by deleting the lock file.
+     *
+     * @throws {@link TransactionError} With the message `Invalid lock ID!` when a different lock is held.
+     */
     async unlockApp(lockId) {
-        const existingLockId = await this.getAppLock();
-        if (!existingLockId) {
-            return;
-        }
-        if (lockId !== existingLockId) {
-            throw new TransactionError('Invalid lock ID!');
-        }
-        await this.addOrUpdateAppLock('');
-    }
-    async updateAppLockTransaction(lockId) {
-        const isAppLocked = await this.isAppLocked(lockId);
-        if (!isAppLocked) {
-            throw new TransactionError('App is unlocked!');
-        }
+        return FileAppLockUtility.unlockApp(this.lockFilePath, lockId);
     }
 }
 //# sourceMappingURL=local.state-provider.js.map

package/dist/services/state-management/local.state-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"local.state-provider.js","sourceRoot":"","sources":["../../../src/services/state-management/local.state-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local.state-provider.js","sourceRoot":"","sources":["../../../src/services/state-management/local.state-provider.ts"],"names":[],"mappings":"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"}