@streetjs/storage 1.0.0

package/dist/versioning.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @streetjs/storage — the versioning manager.
+ *
+ * Versioning retains the prior content of an object whenever a versioned key is
+ * overwritten, so historical Versions can be listed, restored, and deleted
+ * (Requirement 12). {@link VersioningManager} provides this capability in a
+ * **provider-agnostic** way:
+ *
+ * - When the backing {@link StorageDriver} implements the optional native
+ *   `versioning` capability, the manager delegates each operation to the driver
+ *   so a provider with first-class versioning (e.g. S3 bucket versioning) is
+ *   used directly.
+ * - Otherwise the manager **simulates** versioning over the mandatory driver
+ *   primitives (`put`/`get`/`stat`/`list`/`delete`). Each snapshot copies the
+ *   current object's bytes and write-time metadata to a reserved key
+ *   `${VERSION_KEY_PREFIX}<key>/<versionId>` (mirroring the design's
+ *   `.versions/<key>/<versionId>` layout). Versions are enumerated by listing
+ *   that reserved prefix and restored/deleted by reading/removing the reserved
+ *   copy. No cap is imposed on the number of retained Versions (Requirement
+ *   12.1).
+ *
+ * Semantics (Requirement 12):
+ * - {@link VersioningManager.snapshot} captures the current content of `key` as
+ *   a new Version and returns its id, or `null` when there is nothing to
+ *   snapshot (the key does not yet exist). Crucially, when the snapshot itself
+ *   fails for any reason — a storage constraint or system error — it returns
+ *   `null` **without throwing** so the caller's overwrite still proceeds without
+ *   a Version being created (Requirement 12.5).
+ * - {@link VersioningManager.listVersions} returns the {@link VersionInfo}
+ *   descriptors of the retained Versions for `key` (Requirement 12.2).
+ * - {@link VersioningManager.restoreVersion} makes the content of the identified
+ *   Version the current object content and returns the resulting metadata
+ *   (Requirement 12.3).
+ * - {@link VersioningManager.deleteVersion} removes exactly the identified
+ *   Version while retaining the rest (Requirement 12.4).
+ *
+ * The module depends only on the driver contract, the shared type surface, the
+ * error hierarchy, the metadata layer, and `node:crypto`, keeping the
+ * dependency direction acyclic.
+ *
+ * _Requirements: 12.1, 12.2, 12.3, 12.4, 12.5_
+ */
+import type { StorageDriver } from "./driver.js";
+import type { StorageObjectMetadata, VersionInfo } from "./types.js";
+/**
+ * Provider-agnostic versioning manager built on the driver contract.
+ *
+ * A single instance is held by the facade and bound to one {@link StorageDriver}
+ * for its lifetime, so the native-vs-simulated decision (based on whether the
+ * driver exposes a `versioning` capability) is stable across every call.
+ */
+export declare class VersioningManager {
+    /** The driver every operation is delegated to or simulated over. */
+    private readonly driver;
+    constructor(driver: StorageDriver);
+    /** The driver's native versioning capability, when present. */
+    private get native();
+    /**
+     * Capture the current content of `key` as a new Version and return its id, or
+     * `null` when there is nothing to snapshot (the key does not exist yet).
+     *
+     * This is invoked by the facade immediately before an overwriting `put` when
+     * versioning is enabled. Per Requirement 12.5, a failure of the versioning
+     * mechanism must never block the overwrite: any error raised while reading the
+     * current object or persisting the snapshot is swallowed and `null` is
+     * returned, so the caller proceeds to overwrite without a Version. The prior
+     * content retained on success is unlimited in count (Requirement 12.1).
+     */
+    snapshot(key: string): Promise<string | null>;
+    /**
+     * Return the {@link VersionInfo} descriptors of the retained Versions for
+     * `key` (Requirement 12.2). For the simulated path the reserved version prefix
+     * is listed and each version's `size`/`checksum`/`createdAt` is read from its
+     * stored metadata; entries are returned oldest-first by creation time. Only
+     * direct Versions of `key` are included — copies belonging to a deeper key
+     * that merely shares this key's prefix are excluded.
+     */
+    listVersions(key: string): Promise<VersionInfo[]>;
+    /**
+     * Make the content of the Version identified by `versionId` the current
+     * object content for `key` and return the resulting metadata (Requirement
+     * 12.3). For the simulated path the reserved copy is read and written back to
+     * `key` with its preserved write-time metadata. The overwrite is performed
+     * directly against the driver, so restoring does not itself trigger a new
+     * snapshot. Throws {@link NotFoundError} when the Version does not exist.
+     */
+    restoreVersion(key: string, versionId: string): Promise<StorageObjectMetadata>;
+    /**
+     * Remove exactly the Version identified by `versionId` for `key` while
+     * retaining the remaining Versions (Requirement 12.4). For the simulated path
+     * the reserved copy is deleted; deleting a missing Version is an idempotent
+     * no-op at the driver level.
+     */
+    deleteVersion(key: string, versionId: string): Promise<void>;
+    /** The reserved driver key a simulated Version is persisted under. */
+    private versionKey;
+    /** The reserved driver key prefix that all simulated Versions of `key` share. */
+    private versionPrefix;
+}
+//# sourceMappingURL=versioning.d.ts.map

package/dist/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUrE;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,EAAE,aAAa;IAIjC,+DAA+D;IAC/D,OAAO,KAAK,MAAM,GAEjB;IAED;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwBnD;;;;;;;OAOG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BvD;;;;;;;OAOG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgBpF;;;;;OAKG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAIlB,iFAAiF;IACjF,OAAO,CAAC,aAAa;CAGtB"}

package/dist/versioning.js

@@ -0,0 +1,179 @@
+/**
+ * @streetjs/storage — the versioning manager.
+ *
+ * Versioning retains the prior content of an object whenever a versioned key is
+ * overwritten, so historical Versions can be listed, restored, and deleted
+ * (Requirement 12). {@link VersioningManager} provides this capability in a
+ * **provider-agnostic** way:
+ *
+ * - When the backing {@link StorageDriver} implements the optional native
+ *   `versioning` capability, the manager delegates each operation to the driver
+ *   so a provider with first-class versioning (e.g. S3 bucket versioning) is
+ *   used directly.
+ * - Otherwise the manager **simulates** versioning over the mandatory driver
+ *   primitives (`put`/`get`/`stat`/`list`/`delete`). Each snapshot copies the
+ *   current object's bytes and write-time metadata to a reserved key
+ *   `${VERSION_KEY_PREFIX}<key>/<versionId>` (mirroring the design's
+ *   `.versions/<key>/<versionId>` layout). Versions are enumerated by listing
+ *   that reserved prefix and restored/deleted by reading/removing the reserved
+ *   copy. No cap is imposed on the number of retained Versions (Requirement
+ *   12.1).
+ *
+ * Semantics (Requirement 12):
+ * - {@link VersioningManager.snapshot} captures the current content of `key` as
+ *   a new Version and returns its id, or `null` when there is nothing to
+ *   snapshot (the key does not yet exist). Crucially, when the snapshot itself
+ *   fails for any reason — a storage constraint or system error — it returns
+ *   `null` **without throwing** so the caller's overwrite still proceeds without
+ *   a Version being created (Requirement 12.5).
+ * - {@link VersioningManager.listVersions} returns the {@link VersionInfo}
+ *   descriptors of the retained Versions for `key` (Requirement 12.2).
+ * - {@link VersioningManager.restoreVersion} makes the content of the identified
+ *   Version the current object content and returns the resulting metadata
+ *   (Requirement 12.3).
+ * - {@link VersioningManager.deleteVersion} removes exactly the identified
+ *   Version while retaining the rest (Requirement 12.4).
+ *
+ * The module depends only on the driver contract, the shared type surface, the
+ * error hierarchy, the metadata layer, and `node:crypto`, keeping the
+ * dependency direction acyclic.
+ *
+ * _Requirements: 12.1, 12.2, 12.3, 12.4, 12.5_
+ */
+import { randomUUID } from "node:crypto";
+import { NotFoundError } from "./errors.js";
+import { normalizeMetadata, toWriteMetadata } from "./metadata.js";
+/**
+ * Reserved key prefix under which simulated Versions are persisted via the
+ * driver primitives. A Version of `<key>` lives at
+ * `${VERSION_KEY_PREFIX}<key>/<versionId>`. These reserved keys hold historical
+ * copies and are never surfaced through the object-operation API.
+ */
+const VERSION_KEY_PREFIX = ".versions/";
+/**
+ * Provider-agnostic versioning manager built on the driver contract.
+ *
+ * A single instance is held by the facade and bound to one {@link StorageDriver}
+ * for its lifetime, so the native-vs-simulated decision (based on whether the
+ * driver exposes a `versioning` capability) is stable across every call.
+ */
+export class VersioningManager {
+    /** The driver every operation is delegated to or simulated over. */
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    /** The driver's native versioning capability, when present. */
+    get native() {
+        return this.driver.versioning;
+    }
+    /**
+     * Capture the current content of `key` as a new Version and return its id, or
+     * `null` when there is nothing to snapshot (the key does not exist yet).
+     *
+     * This is invoked by the facade immediately before an overwriting `put` when
+     * versioning is enabled. Per Requirement 12.5, a failure of the versioning
+     * mechanism must never block the overwrite: any error raised while reading the
+     * current object or persisting the snapshot is swallowed and `null` is
+     * returned, so the caller proceeds to overwrite without a Version. The prior
+     * content retained on success is unlimited in count (Requirement 12.1).
+     */
+    async snapshot(key) {
+        try {
+            if (this.native !== undefined) {
+                return await this.native.snapshot(key);
+            }
+            const current = await this.driver.get(key);
+            if (!current.found) {
+                // Nothing to snapshot: first write to this key creates no Version.
+                return null;
+            }
+            const versionId = randomUUID();
+            await this.driver.put(this.versionKey(key, versionId), current.bytes, toWriteMetadata(current.metadata));
+            return versionId;
+        }
+        catch {
+            // Requirement 12.5: a versioning failure allows the overwrite to proceed
+            // WITHOUT creating a Version. Never propagate the error to the write path.
+            return null;
+        }
+    }
+    /**
+     * Return the {@link VersionInfo} descriptors of the retained Versions for
+     * `key` (Requirement 12.2). For the simulated path the reserved version prefix
+     * is listed and each version's `size`/`checksum`/`createdAt` is read from its
+     * stored metadata; entries are returned oldest-first by creation time. Only
+     * direct Versions of `key` are included — copies belonging to a deeper key
+     * that merely shares this key's prefix are excluded.
+     */
+    async listVersions(key) {
+        if (this.native !== undefined) {
+            return this.native.list(key);
+        }
+        const prefix = this.versionPrefix(key);
+        const items = await this.driver.list(prefix);
+        const versions = [];
+        for (const item of items) {
+            const versionId = item.key.slice(prefix.length);
+            // Skip copies belonging to a deeper key (e.g. Versions of "a/b" when
+            // listing Versions of "a"); a direct Version id contains no delimiter.
+            if (versionId === "" || versionId.includes("/")) {
+                continue;
+            }
+            const metadata = await this.driver.stat(item.key);
+            if (metadata === null) {
+                continue;
+            }
+            versions.push({
+                versionId,
+                size: metadata.size,
+                createdAt: metadata.createdAt,
+                checksum: metadata.checksum,
+            });
+        }
+        versions.sort((a, b) => a.createdAt - b.createdAt);
+        return versions;
+    }
+    /**
+     * Make the content of the Version identified by `versionId` the current
+     * object content for `key` and return the resulting metadata (Requirement
+     * 12.3). For the simulated path the reserved copy is read and written back to
+     * `key` with its preserved write-time metadata. The overwrite is performed
+     * directly against the driver, so restoring does not itself trigger a new
+     * snapshot. Throws {@link NotFoundError} when the Version does not exist.
+     */
+    async restoreVersion(key, versionId) {
+        if (this.native !== undefined) {
+            return normalizeMetadata(await this.native.restore(key, versionId));
+        }
+        const versionKey = this.versionKey(key, versionId);
+        const result = await this.driver.get(versionKey);
+        if (!result.found) {
+            throw new NotFoundError(versionKey, `Version "${versionId}" for key "${key}" was not found.`);
+        }
+        const metadata = await this.driver.put(key, result.bytes, toWriteMetadata(result.metadata));
+        return normalizeMetadata(metadata);
+    }
+    /**
+     * Remove exactly the Version identified by `versionId` for `key` while
+     * retaining the remaining Versions (Requirement 12.4). For the simulated path
+     * the reserved copy is deleted; deleting a missing Version is an idempotent
+     * no-op at the driver level.
+     */
+    async deleteVersion(key, versionId) {
+        if (this.native !== undefined) {
+            await this.native.deleteVersion(key, versionId);
+            return;
+        }
+        await this.driver.delete(this.versionKey(key, versionId));
+    }
+    /** The reserved driver key a simulated Version is persisted under. */
+    versionKey(key, versionId) {
+        return `${this.versionPrefix(key)}${versionId}`;
+    }
+    /** The reserved driver key prefix that all simulated Versions of `key` share. */
+    versionPrefix(key) {
+        return `${VERSION_KEY_PREFIX}${key}/`;
+    }
+}
+//# sourceMappingURL=versioning.js.map

package/dist/versioning.js.map

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

package/package.json

@@ -0,0 +1,137 @@
+{
+  "name": "@streetjs/storage",
+  "version": "1.0.0",
+  "description": "StreetJS unified storage framework: a strongly-typed, plugin-first, driver-based object storage layer with zero-dependency in-memory and filesystem drivers, streaming, validation, metadata, multipart, resumable uploads, signed URLs, versioning, lifecycle, access control, and optional cloud provider integrations (S3, R2, Supabase, GCS, Azure, MinIO, Backblaze) isolated behind optional submodules.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./s3": {
+      "import": "./dist/drivers/s3.js",
+      "types": "./dist/drivers/s3.d.ts"
+    },
+    "./r2": {
+      "import": "./dist/drivers/r2.js",
+      "types": "./dist/drivers/r2.d.ts"
+    },
+    "./supabase": {
+      "import": "./dist/drivers/supabase.js",
+      "types": "./dist/drivers/supabase.d.ts"
+    },
+    "./gcs": {
+      "import": "./dist/drivers/gcs.js",
+      "types": "./dist/drivers/gcs.d.ts"
+    },
+    "./azure": {
+      "import": "./dist/drivers/azure.js",
+      "types": "./dist/drivers/azure.d.ts"
+    },
+    "./minio": {
+      "import": "./dist/drivers/minio.js",
+      "types": "./dist/drivers/minio.d.ts"
+    },
+    "./backblaze": {
+      "import": "./dist/drivers/backblaze.js",
+      "types": "./dist/drivers/backblaze.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test dist/tests/*.test.js",
+    "example": "node dist/examples/storage-demo.js",
+    "lint": "tsc --noEmit",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  },
+  "keywords": [
+    "streetjs",
+    "street-framework",
+    "storage",
+    "object-storage",
+    "file-storage",
+    "s3",
+    "r2",
+    "supabase",
+    "gcs",
+    "azure",
+    "minio",
+    "backblaze",
+    "signed-url",
+    "multipart",
+    "streaming",
+    "typescript",
+    "esm"
+  ],
+  "author": "street contributors",
+  "license": "MIT",
+  "homepage": "https://hassanmubiru.github.io/StreetJS/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hassanmubiru/StreetJS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hassanmubiru/StreetJS/issues"
+  },
+  "dependencies": {
+    "streetjs": "^1.0.25"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "fast-check": "^4.8.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0",
+    "@aws-sdk/client-s3": ">=3.0.0",
+    "@aws-sdk/s3-request-presigner": ">=3.0.0",
+    "@supabase/supabase-js": ">=2.0.0",
+    "@google-cloud/storage": ">=7.0.0",
+    "@azure/storage-blob": ">=12.0.0",
+    "minio": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    },
+    "@google-cloud/storage": {
+      "optional": true
+    },
+    "@azure/storage-blob": {
+      "optional": true
+    },
+    "minio": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}