@alepha/bucket-vercel 0.11.10 → 0.11.12

package/README.md

@@ -14,25 +14,13 @@ npm install alepha
 
 Plugin for Alepha Bucket that provides Vercel Blob Storage capabilities.
 
-This module can be imported and used as follows:
-
-```typescript
-import { Alepha, run } from "alepha";
-import { AlephaBucketVercel } from "alepha/bucket/vercel";
-
-const alepha = Alepha.create()
-	.with(AlephaBucketVercel);
-
-run(alepha);
-```
-
 ## API Reference
 
 ### Providers
 
 Providers are classes that encapsulate specific functionality and can be injected into your application. They handle initialization, configuration, and lifecycle management.
 
-For more details, see the [Providers documentation](/docs/providers).
+For more details, see the [Providers documentation](https://feunard.github.io/alepha/).
 
 #### VercelFileStorageProvider
 

package/dist/index.cjs

@@ -1,9 +1,8 @@
-let __alepha_bucket = require("@alepha/bucket");
-let __alepha_core = require("@alepha/core");
-let node_crypto = require("node:crypto");
-let __alepha_datetime = require("@alepha/datetime");
-let __alepha_file = require("@alepha/file");
-let __alepha_logger = require("@alepha/logger");
+let alepha = require("alepha");
+let alepha_bucket = require("alepha/bucket");
+let alepha_datetime = require("alepha/datetime");
+let alepha_file = require("alepha/file");
+let alepha_logger = require("alepha/logger");
 let __vercel_blob = require("@vercel/blob");
 
 //#region src/providers/VercelBlobProvider.ts
@@ -15,23 +14,23 @@ var VercelBlobApi = class {
 
 //#endregion
 //#region src/providers/VercelFileStorageProvider.ts
-const envSchema = __alepha_core.t.object({ BLOB_READ_WRITE_TOKEN: __alepha_core.t.text({ size: "long" }) });
+const envSchema = alepha.t.object({ BLOB_READ_WRITE_TOKEN: alepha.t.text({ size: "long" }) });
 /**
 * Vercel Blob Storage implementation of File Storage Provider.
 */
 var VercelFileStorageProvider = class {
-	log = (0, __alepha_logger.$logger)();
-	env = (0, __alepha_core.$env)(envSchema);
-	alepha = (0, __alepha_core.$inject)(__alepha_core.Alepha);
-	time = (0, __alepha_core.$inject)(__alepha_datetime.DateTimeProvider);
-	fileSystem = (0, __alepha_core.$inject)(__alepha_file.FileSystem);
+	log = (0, alepha_logger.$logger)();
+	env = (0, alepha.$env)(envSchema);
+	alepha = (0, alepha.$inject)(alepha.Alepha);
+	time = (0, alepha.$inject)(alepha_datetime.DateTimeProvider);
+	fileSystem = (0, alepha.$inject)(alepha_file.FileSystemProvider);
 	stores = /* @__PURE__ */ new Set();
-	vercelBlobApi = (0, __alepha_core.$inject)(VercelBlobApi);
-	metadataService = (0, __alepha_core.$inject)(__alepha_bucket.FileMetadataService);
-	onStart = (0, __alepha_core.$hook)({
+	vercelBlobApi = (0, alepha.$inject)(VercelBlobApi);
+	metadataService = (0, alepha.$inject)(alepha_bucket.FileMetadataService);
+	onStart = (0, alepha.$hook)({
 		on: "start",
 		handler: async () => {
-			for (const bucket of this.alepha.descriptors(__alepha_bucket.$bucket)) {
+			for (const bucket of this.alepha.descriptors(alepha_bucket.$bucket)) {
 				if (bucket.provider !== this) continue;
 				const storeName = this.convertName(bucket.name);
 				this.log.debug(`Prepare store '${storeName}' ...`);
@@ -44,7 +43,7 @@ var VercelFileStorageProvider = class {
 		return name.replaceAll("/", "-").toLowerCase();
 	}
 	createId() {
-		return (0, node_crypto.randomUUID)();
+		return crypto.randomUUID();
 	}
 	async upload(bucketName, file, fileId) {
 		fileId ??= this.createId();
@@ -63,7 +62,7 @@ var VercelFileStorageProvider = class {
 			return fileId;
 		} catch (error) {
 			this.log.error(`Failed to upload file: ${error}`);
-			if (error instanceof Error) throw new __alepha_core.AlephaError(`Upload failed: ${error.message}`, { cause: error });
+			if (error instanceof Error) throw new alepha.AlephaError(`Upload failed: ${error.message}`, { cause: error });
 			throw error;
 		}
 	}
@@ -72,11 +71,11 @@ var VercelFileStorageProvider = class {
 		const pathname = `${this.convertName(bucketName)}/${fileId}`;
 		try {
 			const headResult = await this.vercelBlobApi.head(pathname, { token: this.env.BLOB_READ_WRITE_TOKEN });
-			if (!headResult) throw new __alepha_bucket.FileNotFoundError(`File '${fileId}' not found in bucket '${bucketName}'`);
+			if (!headResult) throw new alepha_bucket.FileNotFoundError(`File '${fileId}' not found in bucket '${bucketName}'`);
 			const response = await fetch(headResult.url);
-			if (!response.ok) throw new __alepha_bucket.FileNotFoundError(`Failed to fetch file: ${response.statusText}`);
+			if (!response.ok) throw new alepha_bucket.FileNotFoundError(`Failed to fetch file: ${response.statusText}`);
 			const arrayBuffer = await response.arrayBuffer();
-			if (!arrayBuffer) throw new __alepha_bucket.FileNotFoundError("File not found - empty response body");
+			if (!arrayBuffer) throw new alepha_bucket.FileNotFoundError("File not found - empty response body");
 			const buffer = Buffer.from(arrayBuffer);
 			const { metadata, contentStart } = this.metadataService.decodeMetadataFromBuffer(buffer);
 			const content = buffer.subarray(contentStart);
@@ -86,9 +85,9 @@ var VercelFileStorageProvider = class {
 				type: metadata.type
 			});
 		} catch (error) {
-			if (error instanceof __alepha_bucket.FileNotFoundError) throw error;
+			if (error instanceof alepha_bucket.FileNotFoundError) throw error;
 			this.log.error(`Failed to download file: ${error}`);
-			if (error instanceof Error) throw new __alepha_bucket.FileNotFoundError("Error downloading file", { cause: error });
+			if (error instanceof Error) throw new alepha_bucket.FileNotFoundError("Error downloading file", { cause: error });
 			throw error;
 		}
 	}
@@ -108,7 +107,7 @@ var VercelFileStorageProvider = class {
 			await this.vercelBlobApi.del(pathname, { token: this.env.BLOB_READ_WRITE_TOKEN });
 		} catch (error) {
 			this.log.error(`Failed to delete file: ${error}`);
-			if (error instanceof Error) throw new __alepha_bucket.FileNotFoundError("Error deleting file", { cause: error });
+			if (error instanceof Error) throw new alepha_bucket.FileNotFoundError("Error deleting file", { cause: error });
 			throw error;
 		}
 	}
@@ -122,14 +121,14 @@ var VercelFileStorageProvider = class {
 * @see {@link VercelFileStorageProvider}
 * @module alepha.bucket.vercel
 */
-const AlephaBucketVercel = (0, __alepha_core.$module)({
+const AlephaBucketVercel = (0, alepha.$module)({
 	name: "alepha.bucket.vercel",
 	services: [VercelFileStorageProvider],
-	register: (alepha) => alepha.with({
+	register: (alepha$1) => alepha$1.with({
 		optional: true,
-		provide: __alepha_bucket.FileStorageProvider,
+		provide: alepha_bucket.FileStorageProvider,
 		use: VercelFileStorageProvider
-	}).with(__alepha_bucket.AlephaBucket)
+	}).with(alepha_bucket.AlephaBucket)
 });
 
 //#endregion

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["put","head","del","t","Alepha","DateTimeProvider","FileSystem","FileMetadataService","$bucket","AlephaError","FileNotFoundError","FileStorageProvider","AlephaBucket"],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":["import { del, head, put } from \"@vercel/blob\";\n\nexport class VercelBlobApi {\n  put: typeof put = put;\n  head: typeof head = head;\n  del: typeof del = del;\n}\n","import { randomUUID } from \"node:crypto\";\nimport type { Readable } from \"node:stream\";\nimport {\n  $bucket,\n  FileMetadataService,\n  FileNotFoundError,\n  type FileStorageProvider,\n} from \"@alepha/bucket\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type FileLike,\n  type Static,\n  t,\n} from \"@alepha/core\";\nimport { DateTimeProvider } from \"@alepha/datetime\";\nimport { FileSystem } from \"@alepha/file\";\nimport { $logger } from \"@alepha/logger\";\nimport { VercelBlobApi } from \"./VercelBlobProvider.ts\";\n\nconst envSchema = t.object({\n  BLOB_READ_WRITE_TOKEN: t.text({\n    size: \"long\",\n  }),\n});\n\ndeclare module \"@alepha/core\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Vercel Blob Storage implementation of File Storage Provider.\n */\nexport class VercelFileStorageProvider implements FileStorageProvider {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly time = $inject(DateTimeProvider);\n  protected readonly fileSystem = $inject(FileSystem);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\n  protected readonly metadataService = $inject(FileMetadataService);\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      for (const bucket of this.alepha.descriptors($bucket)) {\n        if (bucket.provider !== this) {\n          continue;\n        }\n\n        const storeName = this.convertName(bucket.name);\n\n        this.log.debug(`Prepare store '${storeName}' ...`);\n\n        // Vercel Blob doesn't require explicit store/container creation\n        // We just track the store names for reference\n        this.stores.add(storeName);\n\n        this.log.info(`Blob storage '${bucket.name}' OK`);\n      }\n    },\n  });\n\n  public convertName(name: string): string {\n    // Convert to a valid path-like name for Vercel Blob\n    return name.replaceAll(\"/\", \"-\").toLowerCase();\n  }\n\n  protected createId(): string {\n    return randomUUID();\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId();\n\n    this.log.trace(\n      `Uploading file '${file.name}' to bucket '${bucketName}' with id '${fileId}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // Create a buffer with metadata and content\n      const contentBuffer = Buffer.from(await file.arrayBuffer());\n      const fileBuffer = this.metadataService.createFileBuffer(\n        file,\n        contentBuffer,\n      );\n\n      // Upload the complete buffer (metadata + content) to Vercel Blob\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        fileBuffer as unknown as Readable,\n        {\n          access: \"public\",\n          contentType: file.type || \"application/octet-stream\",\n          token: this.env.BLOB_READ_WRITE_TOKEN,\n          allowOverwrite: true,\n        },\n      );\n\n      this.log.trace(`File uploaded successfully: ${result.url}`);\n      return fileId;\n    } catch (error) {\n      this.log.error(`Failed to upload file: ${error}`);\n      if (error instanceof Error) {\n        throw new AlephaError(`Upload failed: ${error.message}`, {\n          cause: error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  public async download(bucketName: string, fileId: string): Promise<FileLike> {\n    this.log.trace(\n      `Downloading file '${fileId}' from bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // check if the file exists and get metadata\n      const headResult = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n\n      if (!headResult) {\n        throw new FileNotFoundError(\n          `File '${fileId}' not found in bucket '${bucketName}'`,\n        );\n      }\n\n      // fetch the actual file content (with metadata)\n      const response = await fetch(headResult.url);\n\n      if (!response.ok) {\n        throw new FileNotFoundError(\n          `Failed to fetch file: ${response.statusText}`,\n        );\n      }\n\n      const arrayBuffer = await response.arrayBuffer();\n      if (!arrayBuffer) {\n        throw new FileNotFoundError(\"File not found - empty response body\");\n      }\n\n      // Decode metadata from the buffer\n      const buffer = Buffer.from(arrayBuffer);\n      const { metadata, contentStart } =\n        this.metadataService.decodeMetadataFromBuffer(buffer);\n\n      // Extract the actual content\n      const content = buffer.subarray(contentStart);\n\n      return this.fileSystem.createFile({\n        buffer: content,\n        name: metadata.name,\n        type: metadata.type,\n      });\n    } catch (error) {\n      if (error instanceof FileNotFoundError) {\n        throw error;\n      }\n\n      this.log.error(`Failed to download file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error downloading file\", { cause: error });\n      }\n\n      throw error;\n    }\n  }\n\n  public async exists(bucketName: string, fileId: string): Promise<boolean> {\n    this.log.trace(\n      `Checking existence of file '${fileId}' in bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      const result = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n      return result !== null;\n    } catch (error) {\n      // Vercel Blob head() throws for non-existent files\n      return false;\n    }\n  }\n\n  public async delete(bucketName: string, fileId: string): Promise<void> {\n    this.log.trace(`Deleting file '${fileId}' from bucket '${bucketName}'...`);\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      await this.vercelBlobApi.del(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n    } catch (error) {\n      this.log.error(`Failed to delete file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error deleting file\", { cause: error });\n      }\n      throw error;\n    }\n  }\n}\n","import { AlephaBucket, FileStorageProvider } from \"@alepha/bucket\";\nimport { $module } from \"@alepha/core\";\nimport { VercelFileStorageProvider } from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Bucket that provides Vercel Blob Storage capabilities.\n *\n * @see {@link VercelFileStorageProvider}\n * @module alepha.bucket.vercel\n */\nexport const AlephaBucketVercel = $module({\n  name: \"alepha.bucket.vercel\",\n  services: [VercelFileStorageProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileStorageProvider,\n        use: VercelFileStorageProvider,\n      })\n      .with(AlephaBucket),\n});\n"],"mappings":";;;;;;;;;AAEA,IAAa,gBAAb,MAA2B;CACzB,MAAkBA;CAClB,OAAoBC;CACpB,MAAkBC;;;;;ACkBpB,MAAM,YAAYC,gBAAE,OAAO,EACzB,uBAAuBA,gBAAE,KAAK,EAC5B,MAAM,QACP,CAAC,EACH,CAAC;;;;AASF,IAAa,4BAAb,MAAsE;CACpE,AAAmB,oCAAe;CAClC,AAAmB,8BAAW,UAAU;CACxC,AAAmB,oCAAiBC,qBAAO;CAC3C,AAAmB,kCAAeC,mCAAiB;CACnD,AAAmB,wCAAqBC,yBAAW;CACnD,AAAmB,yBAAsB,IAAI,KAAK;CAClD,AAAmB,2CAAwB,cAAc;CACzD,AAAmB,6CAA0BC,oCAAoB;CAEjE,AAAmB,mCAAgB;EACjC,IAAI;EACJ,SAAS,YAAY;AACnB,QAAK,MAAM,UAAU,KAAK,OAAO,YAAYC,wBAAQ,EAAE;AACrD,QAAI,OAAO,aAAa,KACtB;IAGF,MAAM,YAAY,KAAK,YAAY,OAAO,KAAK;AAE/C,SAAK,IAAI,MAAM,kBAAkB,UAAU,OAAO;AAIlD,SAAK,OAAO,IAAI,UAAU;AAE1B,SAAK,IAAI,KAAK,iBAAiB,OAAO,KAAK,MAAM;;;EAGtD,CAAC;CAEF,AAAO,YAAY,MAAsB;AAEvC,SAAO,KAAK,WAAW,KAAK,IAAI,CAAC,aAAa;;CAGhD,AAAU,WAAmB;AAC3B,sCAAmB;;CAGrB,MAAa,OACX,YACA,MACA,QACiB;AACjB,aAAW,KAAK,UAAU;AAE1B,OAAK,IAAI,MACP,mBAAmB,KAAK,KAAK,eAAe,WAAW,aAAa,OAAO,MAC5E;EAGD,MAAM,WAAW,GADC,KAAK,YAAY,WAAW,CAChB,GAAG;AAEjC,MAAI;GAEF,MAAM,gBAAgB,OAAO,KAAK,MAAM,KAAK,aAAa,CAAC;GAC3D,MAAM,aAAa,KAAK,gBAAgB,iBACtC,MACA,cACD;GAGD,MAAM,SAAS,MAAM,KAAK,cAAc,IACtC,UACA,YACA;IACE,QAAQ;IACR,aAAa,KAAK,QAAQ;IAC1B,OAAO,KAAK,IAAI;IAChB,gBAAgB;IACjB,CACF;AAED,QAAK,IAAI,MAAM,+BAA+B,OAAO,MAAM;AAC3D,UAAO;WACA,OAAO;AACd,QAAK,IAAI,MAAM,0BAA0B,QAAQ;AACjD,OAAI,iBAAiB,MACnB,OAAM,IAAIC,0BAAY,kBAAkB,MAAM,WAAW,EACvD,OAAO,OACR,CAAC;AAGJ,SAAM;;;CAIV,MAAa,SAAS,YAAoB,QAAmC;AAC3E,OAAK,IAAI,MACP,qBAAqB,OAAO,iBAAiB,WAAW,MACzD;EAGD,MAAM,WAAW,GADC,KAAK,YAAY,WAAW,CAChB,GAAG;AAEjC,MAAI;GAEF,MAAM,aAAa,MAAM,KAAK,cAAc,KAAK,UAAU,EACzD,OAAO,KAAK,IAAI,uBACjB,CAAC;AAEF,OAAI,CAAC,WACH,OAAM,IAAIC,kCACR,SAAS,OAAO,yBAAyB,WAAW,GACrD;GAIH,MAAM,WAAW,MAAM,MAAM,WAAW,IAAI;AAE5C,OAAI,CAAC,SAAS,GACZ,OAAM,IAAIA,kCACR,yBAAyB,SAAS,aACnC;GAGH,MAAM,cAAc,MAAM,SAAS,aAAa;AAChD,OAAI,CAAC,YACH,OAAM,IAAIA,kCAAkB,uCAAuC;GAIrE,MAAM,SAAS,OAAO,KAAK,YAAY;GACvC,MAAM,EAAE,UAAU,iBAChB,KAAK,gBAAgB,yBAAyB,OAAO;GAGvD,MAAM,UAAU,OAAO,SAAS,aAAa;AAE7C,UAAO,KAAK,WAAW,WAAW;IAChC,QAAQ;IACR,MAAM,SAAS;IACf,MAAM,SAAS;IAChB,CAAC;WACK,OAAO;AACd,OAAI,iBAAiBA,kCACnB,OAAM;AAGR,QAAK,IAAI,MAAM,4BAA4B,QAAQ;AACnD,OAAI,iBAAiB,MACnB,OAAM,IAAIA,kCAAkB,0BAA0B,EAAE,OAAO,OAAO,CAAC;AAGzE,SAAM;;;CAIV,MAAa,OAAO,YAAoB,QAAkC;AACxE,OAAK,IAAI,MACP,+BAA+B,OAAO,eAAe,WAAW,MACjE;EAGD,MAAM,WAAW,GADC,KAAK,YAAY,WAAW,CAChB,GAAG;AAEjC,MAAI;AAIF,UAHe,MAAM,KAAK,cAAc,KAAK,UAAU,EACrD,OAAO,KAAK,IAAI,uBACjB,CAAC,KACgB;WACX,OAAO;AAEd,UAAO;;;CAIX,MAAa,OAAO,YAAoB,QAA+B;AACrE,OAAK,IAAI,MAAM,kBAAkB,OAAO,iBAAiB,WAAW,MAAM;EAG1E,MAAM,WAAW,GADC,KAAK,YAAY,WAAW,CAChB,GAAG;AAEjC,MAAI;AACF,SAAM,KAAK,cAAc,IAAI,UAAU,EACrC,OAAO,KAAK,IAAI,uBACjB,CAAC;WACK,OAAO;AACd,QAAK,IAAI,MAAM,0BAA0B,QAAQ;AACjD,OAAI,iBAAiB,MACnB,OAAM,IAAIA,kCAAkB,uBAAuB,EAAE,OAAO,OAAO,CAAC;AAEtE,SAAM;;;;;;;;;;;;;AC3MZ,MAAa,gDAA6B;CACxC,MAAM;CACN,UAAU,CAAC,0BAA0B;CACrC,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAASC;EACT,KAAK;EACN,CAAC,CACD,KAAKC,6BAAa;CACxB,CAAC"}
+{"version":3,"file":"index.cjs","names":["put","head","del","t","Alepha","DateTimeProvider","FileSystemProvider","FileMetadataService","$bucket","AlephaError","FileNotFoundError","alepha","FileStorageProvider","AlephaBucket"],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":["import { del, head, put } from \"@vercel/blob\";\n\nexport class VercelBlobApi {\n  put: typeof put = put;\n  head: typeof head = head;\n  del: typeof del = del;\n}\n","import type { Readable } from \"node:stream\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type FileLike,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  $bucket,\n  FileMetadataService,\n  FileNotFoundError,\n  type FileStorageProvider,\n} from \"alepha/bucket\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileSystemProvider } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { VercelBlobApi } from \"./VercelBlobProvider.ts\";\n\nconst envSchema = t.object({\n  BLOB_READ_WRITE_TOKEN: t.text({\n    size: \"long\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Vercel Blob Storage implementation of File Storage Provider.\n */\nexport class VercelFileStorageProvider implements FileStorageProvider {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly time = $inject(DateTimeProvider);\n  protected readonly fileSystem = $inject(FileSystemProvider);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\n  protected readonly metadataService = $inject(FileMetadataService);\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      for (const bucket of this.alepha.descriptors($bucket)) {\n        if (bucket.provider !== this) {\n          continue;\n        }\n\n        const storeName = this.convertName(bucket.name);\n\n        this.log.debug(`Prepare store '${storeName}' ...`);\n\n        // Vercel Blob doesn't require explicit store/container creation\n        // We just track the store names for reference\n        this.stores.add(storeName);\n\n        this.log.info(`Blob storage '${bucket.name}' OK`);\n      }\n    },\n  });\n\n  public convertName(name: string): string {\n    // Convert to a valid path-like name for Vercel Blob\n    return name.replaceAll(\"/\", \"-\").toLowerCase();\n  }\n\n  protected createId(): string {\n    return crypto.randomUUID();\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId();\n\n    this.log.trace(\n      `Uploading file '${file.name}' to bucket '${bucketName}' with id '${fileId}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // Create a buffer with metadata and content\n      const contentBuffer = Buffer.from(await file.arrayBuffer());\n      const fileBuffer = this.metadataService.createFileBuffer(\n        file,\n        contentBuffer,\n      );\n\n      // Upload the complete buffer (metadata + content) to Vercel Blob\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        fileBuffer as unknown as Readable,\n        {\n          access: \"public\",\n          contentType: file.type || \"application/octet-stream\",\n          token: this.env.BLOB_READ_WRITE_TOKEN,\n          allowOverwrite: true,\n        },\n      );\n\n      this.log.trace(`File uploaded successfully: ${result.url}`);\n      return fileId;\n    } catch (error) {\n      this.log.error(`Failed to upload file: ${error}`);\n      if (error instanceof Error) {\n        throw new AlephaError(`Upload failed: ${error.message}`, {\n          cause: error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  public async download(bucketName: string, fileId: string): Promise<FileLike> {\n    this.log.trace(\n      `Downloading file '${fileId}' from bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // check if the file exists and get metadata\n      const headResult = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n\n      if (!headResult) {\n        throw new FileNotFoundError(\n          `File '${fileId}' not found in bucket '${bucketName}'`,\n        );\n      }\n\n      // fetch the actual file content (with metadata)\n      const response = await fetch(headResult.url);\n\n      if (!response.ok) {\n        throw new FileNotFoundError(\n          `Failed to fetch file: ${response.statusText}`,\n        );\n      }\n\n      const arrayBuffer = await response.arrayBuffer();\n      if (!arrayBuffer) {\n        throw new FileNotFoundError(\"File not found - empty response body\");\n      }\n\n      // Decode metadata from the buffer\n      const buffer = Buffer.from(arrayBuffer);\n      const { metadata, contentStart } =\n        this.metadataService.decodeMetadataFromBuffer(buffer);\n\n      // Extract the actual content\n      const content = buffer.subarray(contentStart);\n\n      return this.fileSystem.createFile({\n        buffer: content,\n        name: metadata.name,\n        type: metadata.type,\n      });\n    } catch (error) {\n      if (error instanceof FileNotFoundError) {\n        throw error;\n      }\n\n      this.log.error(`Failed to download file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error downloading file\", { cause: error });\n      }\n\n      throw error;\n    }\n  }\n\n  public async exists(bucketName: string, fileId: string): Promise<boolean> {\n    this.log.trace(\n      `Checking existence of file '${fileId}' in bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      const result = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n      return result !== null;\n    } catch (error) {\n      // Vercel Blob head() throws for non-existent files\n      return false;\n    }\n  }\n\n  public async delete(bucketName: string, fileId: string): Promise<void> {\n    this.log.trace(`Deleting file '${fileId}' from bucket '${bucketName}'...`);\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      await this.vercelBlobApi.del(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n    } catch (error) {\n      this.log.error(`Failed to delete file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error deleting file\", { cause: error });\n      }\n      throw error;\n    }\n  }\n}\n","import { $module } from \"alepha\";\nimport { AlephaBucket, FileStorageProvider } from \"alepha/bucket\";\nimport { VercelFileStorageProvider } from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Bucket that provides Vercel Blob Storage capabilities.\n *\n * @see {@link VercelFileStorageProvider}\n * @module alepha.bucket.vercel\n */\nexport const AlephaBucketVercel = $module({\n  name: \"alepha.bucket.vercel\",\n  services: [VercelFileStorageProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileStorageProvider,\n        use: VercelFileStorageProvider,\n      })\n      .with(AlephaBucket),\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import * as _alepha_core1 from "@alepha/core";
-import { Alepha, FileLike, Static } from "@alepha/core";
-import * as _alepha_logger0 from "@alepha/logger";
-import { FileMetadataService, FileStorageProvider } from "@alepha/bucket";
-import { DateTimeProvider } from "@alepha/datetime";
-import { FileSystem } from "@alepha/file";
+import * as alepha1 from "alepha";
+import { Alepha, FileLike, Static } from "alepha";
+import * as alepha_logger0 from "alepha/logger";
+import { FileMetadataService, FileStorageProvider } from "alepha/bucket";
+import { DateTimeProvider } from "alepha/datetime";
+import { FileSystemProvider } from "alepha/file";
 import { del, head, put } from "@vercel/blob";
 
 //#region src/providers/VercelBlobProvider.d.ts
@@ -14,27 +14,27 @@ declare class VercelBlobApi {
 }
 //#endregion
 //#region src/providers/VercelFileStorageProvider.d.ts
-declare const envSchema: _alepha_core1.TObject<{
-  BLOB_READ_WRITE_TOKEN: _alepha_core1.TString;
+declare const envSchema: alepha1.TObject<{
+  BLOB_READ_WRITE_TOKEN: alepha1.TString;
 }>;
-declare module "@alepha/core" {
+declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 /**
  * Vercel Blob Storage implementation of File Storage Provider.
  */
 declare class VercelFileStorageProvider implements FileStorageProvider {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: alepha_logger0.Logger;
   protected readonly env: {
     BLOB_READ_WRITE_TOKEN: string;
   };
   protected readonly alepha: Alepha;
   protected readonly time: DateTimeProvider;
-  protected readonly fileSystem: FileSystem;
+  protected readonly fileSystem: FileSystemProvider;
   protected readonly stores: Set<string>;
   protected readonly vercelBlobApi: VercelBlobApi;
   protected readonly metadataService: FileMetadataService;
-  protected readonly onStart: _alepha_core1.HookDescriptor<"start">;
+  protected readonly onStart: alepha1.HookDescriptor<"start">;
   convertName(name: string): string;
   protected createId(): string;
   upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
@@ -50,7 +50,7 @@ declare class VercelFileStorageProvider implements FileStorageProvider {
  * @see {@link VercelFileStorageProvider}
  * @module alepha.bucket.vercel
  */
-declare const AlephaBucketVercel: _alepha_core1.Service<_alepha_core1.Module>;
+declare const AlephaBucketVercel: alepha1.Service<alepha1.Module>;
 //#endregion
 export { AlephaBucketVercel, VercelFileStorageProvider };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAEa,aAAA;cACC;eACC;cACD;;;;cCkBR,WAIJ,aAAA,CAJa;yBAIb,aAAA,CAAA;;;EDzBW,UAAA,GAAA,SC4BW,OD5BE,CC4BM,MD5BN,CAAA,OC4BoB,SD5BpB,CAAA,CAAA,CAAA,CACZ;;;;;cCiCD,yBAAA,YAAqC;0BAAX,eAAA,CACf;EAdlB,mBAIJ,GAAA,EAAA;IAJa,qBAAA,EAAA,MAAA;EAAA,CAAA;qBAAA,MAAA,EAgBY,MAhBZ;EAO+B,mBAAA,IAAA,EAUrB,gBAVqB;EAAd,mBAAA,UAAA,EAWD,UAXC;EAAR,mBAAA,MAAA,EAYK,GAZL,CAAA,MAAA,CAAA;EAAO,mBAAA,aAAA,EAaG,aAbH;EAAA,mBAAA,eAAA,EAcK,mBAdL;EAAA,mBAAA,OAAA,EAcK,aAAA,CAER,cAhBG,CAAA,OAAA,CAAA;EAMlB,WAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAA0B;EAAA,UAAA,QACf,CAAA,CAAA,EAAA,MAAA;EAEG,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,IAAA,EAuCjB,QAvCiB,EAAA,MAAA,CAAA,EAAA,MAAA,CAAA,EAyCtB,OAzCsB,CAAA,MAAA,CAAA;EACF,QAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAoFoC,OApFpC,CAoF4C,QApF5C,CAAA;EACM,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAgJ4B,OAhJ5B,CAAA,OAAA,CAAA;EACF,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAkK8B,OAlK9B,CAAA,IAAA,CAAA;;;;;;;;;;cC1BhB,oBAAkB,aAAA,CAAA,QAW7B,aAAA,CAX6B,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAEa,aAAA;cACC;eACC;cACD;;;;cCiBR,WAIJ,OAAA,CAJa;yBAIb,OAAA,CAAA;;;EDxBW,UAAA,GAAA,SC2BW,OD3BE,CC2BM,MD3BN,CAAA,OC2BoB,SD3BpB,CAAA,CAAA,CAAA,CACZ;;;;;cCgCD,yBAAA,YAAqC;0BAAX,cAAA,CACf;EAdlB,mBAIJ,GAAA,EAAA;IAJa,qBAAA,EAAA,MAAA;EAAA,CAAA;qBAAA,MAAA,EAgBY,MAhBZ;EAO+B,mBAAA,IAAA,EAUrB,gBAVqB;EAAd,mBAAA,UAAA,EAWD,kBAXC;EAAR,mBAAA,MAAA,EAYK,GAZL,CAAA,MAAA,CAAA;EAAO,mBAAA,aAAA,EAaG,aAbH;EAAA,mBAAA,eAAA,EAcK,mBAdL;EAAA,mBAAA,OAAA,EAcK,OAAA,CAER,cAhBG,CAAA,OAAA,CAAA;EAMlB,WAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAA0B;EAAA,UAAA,QACf,CAAA,CAAA,EAAA,MAAA;EAEG,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,IAAA,EAuCjB,QAvCiB,EAAA,MAAA,CAAA,EAAA,MAAA,CAAA,EAyCtB,OAzCsB,CAAA,MAAA,CAAA;EACF,QAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAoFoC,OApFpC,CAoF4C,QApF5C,CAAA;EACM,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAgJ4B,OAhJ5B,CAAA,OAAA,CAAA;EACF,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAkK8B,OAlK9B,CAAA,IAAA,CAAA;;;;;;;;;;cCzBhB,oBAAkB,OAAA,CAAA,QAW7B,OAAA,CAX6B,MAAA"}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { FileMetadataService, FileStorageProvider } from "@alepha/bucket";
-import * as _alepha_core1 from "@alepha/core";
-import { Alepha, FileLike, Static } from "@alepha/core";
-import { DateTimeProvider } from "@alepha/datetime";
-import { FileSystem } from "@alepha/file";
-import * as _alepha_logger0 from "@alepha/logger";
+import * as alepha1 from "alepha";
+import { Alepha, FileLike, Static } from "alepha";
+import { FileMetadataService, FileStorageProvider } from "alepha/bucket";
+import { DateTimeProvider } from "alepha/datetime";
+import { FileSystemProvider } from "alepha/file";
+import * as alepha_logger0 from "alepha/logger";
 import { del, head, put } from "@vercel/blob";
 
 //#region src/providers/VercelBlobProvider.d.ts
@@ -14,27 +14,27 @@ declare class VercelBlobApi {
 }
 //#endregion
 //#region src/providers/VercelFileStorageProvider.d.ts
-declare const envSchema: _alepha_core1.TObject<{
-  BLOB_READ_WRITE_TOKEN: _alepha_core1.TString;
+declare const envSchema: alepha1.TObject<{
+  BLOB_READ_WRITE_TOKEN: alepha1.TString;
 }>;
-declare module "@alepha/core" {
+declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 /**
  * Vercel Blob Storage implementation of File Storage Provider.
  */
 declare class VercelFileStorageProvider implements FileStorageProvider {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: alepha_logger0.Logger;
   protected readonly env: {
     BLOB_READ_WRITE_TOKEN: string;
   };
   protected readonly alepha: Alepha;
   protected readonly time: DateTimeProvider;
-  protected readonly fileSystem: FileSystem;
+  protected readonly fileSystem: FileSystemProvider;
   protected readonly stores: Set<string>;
   protected readonly vercelBlobApi: VercelBlobApi;
   protected readonly metadataService: FileMetadataService;
-  protected readonly onStart: _alepha_core1.HookDescriptor<"start">;
+  protected readonly onStart: alepha1.HookDescriptor<"start">;
   convertName(name: string): string;
   protected createId(): string;
   upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
@@ -50,7 +50,7 @@ declare class VercelFileStorageProvider implements FileStorageProvider {
  * @see {@link VercelFileStorageProvider}
  * @module alepha.bucket.vercel
  */
-declare const AlephaBucketVercel: _alepha_core1.Service<_alepha_core1.Module>;
+declare const AlephaBucketVercel: alepha1.Service<alepha1.Module>;
 //#endregion
 export { AlephaBucketVercel, VercelFileStorageProvider };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAEa,aAAA;cACC;eACC;cACD;;;;cCkBR,WAIJ,aAAA,CAJa;yBAIb,aAAA,CAAA;;;EDzBW,UAAA,GAAA,SC4BW,OD5BE,CC4BM,MD5BN,CAAA,OC4BoB,SD5BpB,CAAA,CAAA,CAAA,CACZ;;;;;cCiCD,yBAAA,YAAqC;0BAAX,eAAA,CACf;EAdlB,mBAIJ,GAAA,EAAA;IAJa,qBAAA,EAAA,MAAA;EAAA,CAAA;qBAAA,MAAA,EAgBY,MAhBZ;EAO+B,mBAAA,IAAA,EAUrB,gBAVqB;EAAd,mBAAA,UAAA,EAWD,UAXC;EAAR,mBAAA,MAAA,EAYK,GAZL,CAAA,MAAA,CAAA;EAAO,mBAAA,aAAA,EAaG,aAbH;EAAA,mBAAA,eAAA,EAcK,mBAdL;EAAA,mBAAA,OAAA,EAcK,aAAA,CAER,cAhBG,CAAA,OAAA,CAAA;EAMlB,WAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAA0B;EAAA,UAAA,QACf,CAAA,CAAA,EAAA,MAAA;EAEG,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,IAAA,EAuCjB,QAvCiB,EAAA,MAAA,CAAA,EAAA,MAAA,CAAA,EAyCtB,OAzCsB,CAAA,MAAA,CAAA;EACF,QAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAoFoC,OApFpC,CAoF4C,QApF5C,CAAA;EACM,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAgJ4B,OAhJ5B,CAAA,OAAA,CAAA;EACF,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAkK8B,OAlK9B,CAAA,IAAA,CAAA;;;;;;;;;;cC1BhB,oBAAkB,aAAA,CAAA,QAW7B,aAAA,CAX6B,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAEa,aAAA;cACC;eACC;cACD;;;;cCiBR,WAIJ,OAAA,CAJa;yBAIb,OAAA,CAAA;;;EDxBW,UAAA,GAAA,SC2BW,OD3BE,CC2BM,MD3BN,CAAA,OC2BoB,SD3BpB,CAAA,CAAA,CAAA,CACZ;;;;;cCgCD,yBAAA,YAAqC;0BAAX,cAAA,CACf;EAdlB,mBAIJ,GAAA,EAAA;IAJa,qBAAA,EAAA,MAAA;EAAA,CAAA;qBAAA,MAAA,EAgBY,MAhBZ;EAO+B,mBAAA,IAAA,EAUrB,gBAVqB;EAAd,mBAAA,UAAA,EAWD,kBAXC;EAAR,mBAAA,MAAA,EAYK,GAZL,CAAA,MAAA,CAAA;EAAO,mBAAA,aAAA,EAaG,aAbH;EAAA,mBAAA,eAAA,EAcK,mBAdL;EAAA,mBAAA,OAAA,EAcK,OAAA,CAER,cAhBG,CAAA,OAAA,CAAA;EAMlB,WAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAA0B;EAAA,UAAA,QACf,CAAA,CAAA,EAAA,MAAA;EAEG,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,IAAA,EAuCjB,QAvCiB,EAAA,MAAA,CAAA,EAAA,MAAA,CAAA,EAyCtB,OAzCsB,CAAA,MAAA,CAAA;EACF,QAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAoFoC,OApFpC,CAoF4C,QApF5C,CAAA;EACM,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAgJ4B,OAhJ5B,CAAA,OAAA,CAAA;EACF,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAkK8B,OAlK9B,CAAA,IAAA,CAAA;;;;;;;;;;cCzBhB,oBAAkB,OAAA,CAAA,QAW7B,OAAA,CAX6B,MAAA"}

package/dist/index.js

@@ -1,9 +1,8 @@
-import { $bucket, AlephaBucket, FileMetadataService, FileNotFoundError, FileStorageProvider } from "@alepha/bucket";
-import { $env, $hook, $inject, $module, Alepha, AlephaError, t } from "@alepha/core";
-import { randomUUID } from "node:crypto";
-import { DateTimeProvider } from "@alepha/datetime";
-import { FileSystem } from "@alepha/file";
-import { $logger } from "@alepha/logger";
+import { $env, $hook, $inject, $module, Alepha, AlephaError, t } from "alepha";
+import { $bucket, AlephaBucket, FileMetadataService, FileNotFoundError, FileStorageProvider } from "alepha/bucket";
+import { DateTimeProvider } from "alepha/datetime";
+import { FileSystemProvider } from "alepha/file";
+import { $logger } from "alepha/logger";
 import { del, head, put } from "@vercel/blob";
 
 //#region src/providers/VercelBlobProvider.ts
@@ -24,7 +23,7 @@ var VercelFileStorageProvider = class {
 	env = $env(envSchema);
 	alepha = $inject(Alepha);
 	time = $inject(DateTimeProvider);
-	fileSystem = $inject(FileSystem);
+	fileSystem = $inject(FileSystemProvider);
 	stores = /* @__PURE__ */ new Set();
 	vercelBlobApi = $inject(VercelBlobApi);
 	metadataService = $inject(FileMetadataService);
@@ -44,7 +43,7 @@ var VercelFileStorageProvider = class {
 		return name.replaceAll("/", "-").toLowerCase();
 	}
 	createId() {
-		return randomUUID();
+		return crypto.randomUUID();
 	}
 	async upload(bucketName, file, fileId) {
 		fileId ??= this.createId();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":["import { del, head, put } from \"@vercel/blob\";\n\nexport class VercelBlobApi {\n  put: typeof put = put;\n  head: typeof head = head;\n  del: typeof del = del;\n}\n","import { randomUUID } from \"node:crypto\";\nimport type { Readable } from \"node:stream\";\nimport {\n  $bucket,\n  FileMetadataService,\n  FileNotFoundError,\n  type FileStorageProvider,\n} from \"@alepha/bucket\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type FileLike,\n  type Static,\n  t,\n} from \"@alepha/core\";\nimport { DateTimeProvider } from \"@alepha/datetime\";\nimport { FileSystem } from \"@alepha/file\";\nimport { $logger } from \"@alepha/logger\";\nimport { VercelBlobApi } from \"./VercelBlobProvider.ts\";\n\nconst envSchema = t.object({\n  BLOB_READ_WRITE_TOKEN: t.text({\n    size: \"long\",\n  }),\n});\n\ndeclare module \"@alepha/core\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Vercel Blob Storage implementation of File Storage Provider.\n */\nexport class VercelFileStorageProvider implements FileStorageProvider {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly time = $inject(DateTimeProvider);\n  protected readonly fileSystem = $inject(FileSystem);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\n  protected readonly metadataService = $inject(FileMetadataService);\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      for (const bucket of this.alepha.descriptors($bucket)) {\n        if (bucket.provider !== this) {\n          continue;\n        }\n\n        const storeName = this.convertName(bucket.name);\n\n        this.log.debug(`Prepare store '${storeName}' ...`);\n\n        // Vercel Blob doesn't require explicit store/container creation\n        // We just track the store names for reference\n        this.stores.add(storeName);\n\n        this.log.info(`Blob storage '${bucket.name}' OK`);\n      }\n    },\n  });\n\n  public convertName(name: string): string {\n    // Convert to a valid path-like name for Vercel Blob\n    return name.replaceAll(\"/\", \"-\").toLowerCase();\n  }\n\n  protected createId(): string {\n    return randomUUID();\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId();\n\n    this.log.trace(\n      `Uploading file '${file.name}' to bucket '${bucketName}' with id '${fileId}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // Create a buffer with metadata and content\n      const contentBuffer = Buffer.from(await file.arrayBuffer());\n      const fileBuffer = this.metadataService.createFileBuffer(\n        file,\n        contentBuffer,\n      );\n\n      // Upload the complete buffer (metadata + content) to Vercel Blob\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        fileBuffer as unknown as Readable,\n        {\n          access: \"public\",\n          contentType: file.type || \"application/octet-stream\",\n          token: this.env.BLOB_READ_WRITE_TOKEN,\n          allowOverwrite: true,\n        },\n      );\n\n      this.log.trace(`File uploaded successfully: ${result.url}`);\n      return fileId;\n    } catch (error) {\n      this.log.error(`Failed to upload file: ${error}`);\n      if (error instanceof Error) {\n        throw new AlephaError(`Upload failed: ${error.message}`, {\n          cause: error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  public async download(bucketName: string, fileId: string): Promise<FileLike> {\n    this.log.trace(\n      `Downloading file '${fileId}' from bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // check if the file exists and get metadata\n      const headResult = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n\n      if (!headResult) {\n        throw new FileNotFoundError(\n          `File '${fileId}' not found in bucket '${bucketName}'`,\n        );\n      }\n\n      // fetch the actual file content (with metadata)\n      const response = await fetch(headResult.url);\n\n      if (!response.ok) {\n        throw new FileNotFoundError(\n          `Failed to fetch file: ${response.statusText}`,\n        );\n      }\n\n      const arrayBuffer = await response.arrayBuffer();\n      if (!arrayBuffer) {\n        throw new FileNotFoundError(\"File not found - empty response body\");\n      }\n\n      // Decode metadata from the buffer\n      const buffer = Buffer.from(arrayBuffer);\n      const { metadata, contentStart } =\n        this.metadataService.decodeMetadataFromBuffer(buffer);\n\n      // Extract the actual content\n      const content = buffer.subarray(contentStart);\n\n      return this.fileSystem.createFile({\n        buffer: content,\n        name: metadata.name,\n        type: metadata.type,\n      });\n    } catch (error) {\n      if (error instanceof FileNotFoundError) {\n        throw error;\n      }\n\n      this.log.error(`Failed to download file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error downloading file\", { cause: error });\n      }\n\n      throw error;\n    }\n  }\n\n  public async exists(bucketName: string, fileId: string): Promise<boolean> {\n    this.log.trace(\n      `Checking existence of file '${fileId}' in bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      const result = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n      return result !== null;\n    } catch (error) {\n      // Vercel Blob head() throws for non-existent files\n      return false;\n    }\n  }\n\n  public async delete(bucketName: string, fileId: string): Promise<void> {\n    this.log.trace(`Deleting file '${fileId}' from bucket '${bucketName}'...`);\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      await this.vercelBlobApi.del(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n    } catch (error) {\n      this.log.error(`Failed to delete file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error deleting file\", { cause: error });\n      }\n      throw error;\n    }\n  }\n}\n","import { AlephaBucket, FileStorageProvider } from \"@alepha/bucket\";\nimport { $module } from \"@alepha/core\";\nimport { VercelFileStorageProvider } from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Bucket that provides Vercel Blob Storage capabilities.\n *\n * @see {@link VercelFileStorageProvider}\n * @module alepha.bucket.vercel\n */\nexport const AlephaBucketVercel = $module({\n  name: \"alepha.bucket.vercel\",\n  services: [VercelFileStorageProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileStorageProvider,\n        use: VercelFileStorageProvider,\n      })\n      .with(AlephaBucket),\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/providers/VercelBlobProvider.ts","../src/providers/VercelFileStorageProvider.ts","../src/index.ts"],"sourcesContent":["import { del, head, put } from \"@vercel/blob\";\n\nexport class VercelBlobApi {\n  put: typeof put = put;\n  head: typeof head = head;\n  del: typeof del = del;\n}\n","import type { Readable } from \"node:stream\";\nimport {\n  $env,\n  $hook,\n  $inject,\n  Alepha,\n  AlephaError,\n  type FileLike,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  $bucket,\n  FileMetadataService,\n  FileNotFoundError,\n  type FileStorageProvider,\n} from \"alepha/bucket\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileSystemProvider } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { VercelBlobApi } from \"./VercelBlobProvider.ts\";\n\nconst envSchema = t.object({\n  BLOB_READ_WRITE_TOKEN: t.text({\n    size: \"long\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Vercel Blob Storage implementation of File Storage Provider.\n */\nexport class VercelFileStorageProvider implements FileStorageProvider {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly time = $inject(DateTimeProvider);\n  protected readonly fileSystem = $inject(FileSystemProvider);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\n  protected readonly metadataService = $inject(FileMetadataService);\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      for (const bucket of this.alepha.descriptors($bucket)) {\n        if (bucket.provider !== this) {\n          continue;\n        }\n\n        const storeName = this.convertName(bucket.name);\n\n        this.log.debug(`Prepare store '${storeName}' ...`);\n\n        // Vercel Blob doesn't require explicit store/container creation\n        // We just track the store names for reference\n        this.stores.add(storeName);\n\n        this.log.info(`Blob storage '${bucket.name}' OK`);\n      }\n    },\n  });\n\n  public convertName(name: string): string {\n    // Convert to a valid path-like name for Vercel Blob\n    return name.replaceAll(\"/\", \"-\").toLowerCase();\n  }\n\n  protected createId(): string {\n    return crypto.randomUUID();\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId();\n\n    this.log.trace(\n      `Uploading file '${file.name}' to bucket '${bucketName}' with id '${fileId}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // Create a buffer with metadata and content\n      const contentBuffer = Buffer.from(await file.arrayBuffer());\n      const fileBuffer = this.metadataService.createFileBuffer(\n        file,\n        contentBuffer,\n      );\n\n      // Upload the complete buffer (metadata + content) to Vercel Blob\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        fileBuffer as unknown as Readable,\n        {\n          access: \"public\",\n          contentType: file.type || \"application/octet-stream\",\n          token: this.env.BLOB_READ_WRITE_TOKEN,\n          allowOverwrite: true,\n        },\n      );\n\n      this.log.trace(`File uploaded successfully: ${result.url}`);\n      return fileId;\n    } catch (error) {\n      this.log.error(`Failed to upload file: ${error}`);\n      if (error instanceof Error) {\n        throw new AlephaError(`Upload failed: ${error.message}`, {\n          cause: error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  public async download(bucketName: string, fileId: string): Promise<FileLike> {\n    this.log.trace(\n      `Downloading file '${fileId}' from bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      // check if the file exists and get metadata\n      const headResult = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n\n      if (!headResult) {\n        throw new FileNotFoundError(\n          `File '${fileId}' not found in bucket '${bucketName}'`,\n        );\n      }\n\n      // fetch the actual file content (with metadata)\n      const response = await fetch(headResult.url);\n\n      if (!response.ok) {\n        throw new FileNotFoundError(\n          `Failed to fetch file: ${response.statusText}`,\n        );\n      }\n\n      const arrayBuffer = await response.arrayBuffer();\n      if (!arrayBuffer) {\n        throw new FileNotFoundError(\"File not found - empty response body\");\n      }\n\n      // Decode metadata from the buffer\n      const buffer = Buffer.from(arrayBuffer);\n      const { metadata, contentStart } =\n        this.metadataService.decodeMetadataFromBuffer(buffer);\n\n      // Extract the actual content\n      const content = buffer.subarray(contentStart);\n\n      return this.fileSystem.createFile({\n        buffer: content,\n        name: metadata.name,\n        type: metadata.type,\n      });\n    } catch (error) {\n      if (error instanceof FileNotFoundError) {\n        throw error;\n      }\n\n      this.log.error(`Failed to download file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error downloading file\", { cause: error });\n      }\n\n      throw error;\n    }\n  }\n\n  public async exists(bucketName: string, fileId: string): Promise<boolean> {\n    this.log.trace(\n      `Checking existence of file '${fileId}' in bucket '${bucketName}'...`,\n    );\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      const result = await this.vercelBlobApi.head(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n      return result !== null;\n    } catch (error) {\n      // Vercel Blob head() throws for non-existent files\n      return false;\n    }\n  }\n\n  public async delete(bucketName: string, fileId: string): Promise<void> {\n    this.log.trace(`Deleting file '${fileId}' from bucket '${bucketName}'...`);\n\n    const storeName = this.convertName(bucketName);\n    const pathname = `${storeName}/${fileId}`;\n\n    try {\n      await this.vercelBlobApi.del(pathname, {\n        token: this.env.BLOB_READ_WRITE_TOKEN,\n      });\n    } catch (error) {\n      this.log.error(`Failed to delete file: ${error}`);\n      if (error instanceof Error) {\n        throw new FileNotFoundError(\"Error deleting file\", { cause: error });\n      }\n      throw error;\n    }\n  }\n}\n","import { $module } from \"alepha\";\nimport { AlephaBucket, FileStorageProvider } from \"alepha/bucket\";\nimport { VercelFileStorageProvider } from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/VercelFileStorageProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Bucket that provides Vercel Blob Storage capabilities.\n *\n * @see {@link VercelFileStorageProvider}\n * @module alepha.bucket.vercel\n */\nexport const AlephaBucketVercel = $module({\n  name: \"alepha.bucket.vercel\",\n  services: [VercelFileStorageProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileStorageProvider,\n        use: VercelFileStorageProvider,\n      })\n      .with(AlephaBucket),\n});\n"],"mappings":"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"}

package/package.json

@@ -1,59 +1,49 @@
 {
-	"name": "@alepha/bucket-vercel",
-	"description": "Vercel Blob Storage implementation for the bucket file storage.",
-	"keywords": [
-		"alepha",
-		"bucket",
-		"file-storage",
-		"file",
-		"vercel",
-		"blob"
-	],
-	"author": "Feunard",
-	"version": "0.11.10",
-	"type": "module",
-	"engines": {
-		"node": ">=22.0.0"
-	},
-	"license": "MIT",
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"files": [
-		"dist",
-		"src"
-	],
-	"dependencies": {
-		"@alepha/bucket": "0.11.10",
-		"@alepha/core": "0.11.10",
-		"@alepha/datetime": "0.11.10",
-		"@alepha/file": "0.11.10",
-		"@alepha/logger": "0.11.10",
-		"@vercel/blob": "^2.0.0"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^2.3.5",
-		"@types/node": "^24.10.1",
-		"tsdown": "^0.16.4",
-		"typescript": "^5.9.3",
-		"vitest": "^4.0.9"
-	},
-	"scripts": {
-		"test": "vitest run",
-		"lint": "biome check --fix",
-		"build": "tsdown -c=../../tsdown.config.ts",
-		"typecheck": "tsc --noEmit"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/feunard/alepha.git"
-	},
-	"homepage": "https://github.com/feunard/alepha",
-	"module": "./dist/index.js",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js",
-			"require": "./dist/index.cjs"
-		}
-	}
+  "name": "@alepha/bucket-vercel",
+  "description": "Vercel Blob Storage implementation for the bucket file storage.",
+  "keywords": [
+    "alepha",
+    "bucket",
+    "file-storage",
+    "file",
+    "vercel",
+    "blob"
+  ],
+  "author": "Feunard",
+  "version": "0.11.12",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@vercel/blob": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "alepha": "0.11.12",
+    "tsdown": "^0.16.4",
+    "vitest": "^4.0.9"
+  },
+  "peerDependencies": {
+    "alepha": "0.11.12"
+  },
+  "scripts": {
+    "lint": "alepha lint",
+    "typecheck": "alepha typecheck",
+    "test": "alepha test",
+    "build": "tsdown -c=../../tsdown.config.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/feunard/alepha.git"
+  },
+  "homepage": "https://github.com/feunard/alepha",
+  "module": "./dist/index.js"
 }

package/src/index.ts

@@ -1,5 +1,5 @@
-import { AlephaBucket, FileStorageProvider } from "@alepha/bucket";
-import { $module } from "@alepha/core";
+import { $module } from "alepha";
+import { AlephaBucket, FileStorageProvider } from "alepha/bucket";
 import { VercelFileStorageProvider } from "./providers/VercelFileStorageProvider.ts";
 
 // ---------------------------------------------------------------------------------------------------------------------

package/src/providers/VercelFileStorageProvider.ts

@@ -1,11 +1,4 @@
-import { randomUUID } from "node:crypto";
 import type { Readable } from "node:stream";
-import {
-  $bucket,
-  FileMetadataService,
-  FileNotFoundError,
-  type FileStorageProvider,
-} from "@alepha/bucket";
 import {
   $env,
   $hook,
@@ -15,10 +8,16 @@ import {
   type FileLike,
   type Static,
   t,
-} from "@alepha/core";
-import { DateTimeProvider } from "@alepha/datetime";
-import { FileSystem } from "@alepha/file";
-import { $logger } from "@alepha/logger";
+} from "alepha";
+import {
+  $bucket,
+  FileMetadataService,
+  FileNotFoundError,
+  type FileStorageProvider,
+} from "alepha/bucket";
+import { DateTimeProvider } from "alepha/datetime";
+import { FileSystemProvider } from "alepha/file";
+import { $logger } from "alepha/logger";
 import { VercelBlobApi } from "./VercelBlobProvider.ts";
 
 const envSchema = t.object({
@@ -27,7 +26,7 @@ const envSchema = t.object({
   }),
 });
 
-declare module "@alepha/core" {
+declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 
@@ -39,7 +38,7 @@ export class VercelFileStorageProvider implements FileStorageProvider {
   protected readonly env = $env(envSchema);
   protected readonly alepha = $inject(Alepha);
   protected readonly time = $inject(DateTimeProvider);
-  protected readonly fileSystem = $inject(FileSystem);
+  protected readonly fileSystem = $inject(FileSystemProvider);
   protected readonly stores: Set<string> = new Set();
   protected readonly vercelBlobApi = $inject(VercelBlobApi);
   protected readonly metadataService = $inject(FileMetadataService);
@@ -71,7 +70,7 @@ export class VercelFileStorageProvider implements FileStorageProvider {
   }
 
   protected createId(): string {
-    return randomUUID();
+    return crypto.randomUUID();
   }
 
   public async upload(