@lakutata/containerd 0.0.0-stage → 3.0.0-beta.1

package/dist/esm/client/Volumes.js

@@ -0,0 +1,73 @@
+import { mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * The named volumes of a namespace: <data root>/volumes/<namespace>/<name>/_data, their information in volume.json
+ */
+export class VolumeStore {
+    constructor(directory) {
+        this.directory = directory;
+    }
+    /**
+     * Whether a name is the one of a volume
+     * @param name
+     */
+    static ValidName(name) {
+        return /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(name);
+    }
+    path(name) {
+        if (!VolumeStore.ValidName(name))
+            throw new Error(`The name of a volume "${name}" is not valid ([a-zA-Z0-9][a-zA-Z0-9_.-]*)`);
+        return path.join(this.directory, name);
+    }
+    /**
+     * A volume, undefined when it does not exist
+     * @param name
+     */
+    async get(name) {
+        const directory = this.path(name);
+        try {
+            const info = JSON.parse(await readFile(path.join(directory, 'volume.json'), 'utf8'));
+            return { name: name, mountpoint: path.join(directory, '_data'), labels: info.labels ?? {}, createdAt: new Date(info.createdAt ?? (await stat(directory)).birthtime) };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async list() {
+        let names;
+        try {
+            names = (await readdir(this.directory)).filter(VolumeStore.ValidName).sort();
+        }
+        catch {
+            return [];
+        }
+        const volumes = [];
+        for (const name of names) {
+            const volume = await this.get(name);
+            if (volume)
+                volumes.push(volume);
+        }
+        return volumes;
+    }
+    /**
+     * Create a volume (the existing one is given when it exists, as Docker does)
+     * @param name
+     * @param labels
+     */
+    async create(name, labels = {}) {
+        const existing = await this.get(name);
+        if (existing)
+            return existing;
+        const directory = this.path(name);
+        await mkdir(path.join(directory, '_data'), { recursive: true });
+        await writeFile(path.join(directory, 'volume.json'), JSON.stringify({ name: name, labels: labels, createdAt: new Date().toISOString() }));
+        return (await this.get(name));
+    }
+    /**
+     * Remove a volume and its data
+     * @param name
+     */
+    async remove(name) {
+        await rm(this.path(name), { recursive: true, force: true });
+    }
+}