@alepha/bucket-vercel 0.13.1 → 0.13.2

package/dist/index.d.ts

@@ -11,7 +11,7 @@ import "node:fs";
 
 //#region ../alepha/src/core/constants/KIND.d.ts
 /**
- * Used for identifying descriptors.
+ * Used for identifying primitives.
  *
  * @internal
  */
@@ -64,34 +64,50 @@ interface ServiceSubstitution<T extends object = any> {
  */
 type ServiceEntry<T extends object = any> = Service<T> | ServiceSubstitution<T>;
 //#endregion
-//#region ../alepha/src/core/helpers/descriptor.d.ts
-interface DescriptorArgs<T extends object = {}> {
+//#region ../alepha/src/core/helpers/primitive.d.ts
+interface PrimitiveArgs<T extends object = {}> {
   options: T;
   alepha: Alepha;
   service: InstantiableClass<Service>;
   module?: Service;
 }
-interface DescriptorConfig {
+interface PrimitiveConfig {
   propertyKey: string;
   service: InstantiableClass<Service>;
   module?: Service;
 }
-declare abstract class Descriptor<T extends object = {}> {
+declare abstract class Primitive<T extends object = {}> {
   protected readonly alepha: Alepha;
   readonly options: T;
-  readonly config: DescriptorConfig;
-  constructor(args: DescriptorArgs<T>);
+  readonly config: PrimitiveConfig;
+  constructor(args: PrimitiveArgs<T>);
   /**
-   * Called automatically by Alepha after the descriptor is created.
+   * Called automatically by Alepha after the primitive is created.
    */
   protected onInit(): void;
 }
-type DescriptorFactoryLike<T extends object = any> = {
+type PrimitiveFactoryLike<T extends object = any> = {
   (options: T): any;
   [KIND]: any;
 };
 //#endregion
-//#region ../alepha/src/core/descriptors/$inject.d.ts
+//#region ../alepha/src/core/interfaces/Async.d.ts
+/**
+ * Represents a value that can be either a value or a promise of value.
+ */
+type Async<T> = T | Promise<T>;
+//#endregion
+//#region ../alepha/src/core/interfaces/LoggerInterface.d.ts
+type LogLevel = "ERROR" | "WARN" | "INFO" | "DEBUG" | "TRACE" | "SILENT";
+interface LoggerInterface {
+  trace(message: string, data?: unknown): void;
+  debug(message: string, data?: unknown): void;
+  info(message: string, data?: unknown): void;
+  warn(message: string, data?: unknown): void;
+  error(message: string, data?: unknown): void;
+}
+//#endregion
+//#region ../alepha/src/core/primitives/$inject.d.ts
 interface InjectOptions<T extends object = any> {
   /**
    * - 'transient' → Always a new instance on every inject. Zero caching.
@@ -116,8 +132,8 @@ interface InjectOptions<T extends object = any> {
   parent?: Service | null;
 }
 //#endregion
-//#region ../alepha/src/core/descriptors/$module.d.ts
-interface ModuleDescriptorOptions {
+//#region ../alepha/src/core/primitives/$module.d.ts
+interface ModulePrimitiveOptions {
   /**
    * Name of the module.
    *
@@ -132,9 +148,9 @@ interface ModuleDescriptorOptions {
    */
   services?: Array<Service>;
   /**
-   * List of $descriptors to register in the module.
+   * List of $primitives to register in the module.
    */
-  descriptors?: Array<DescriptorFactoryLike>;
+  primitives?: Array<PrimitiveFactoryLike>;
   /**
    * By default, module will register ALL services.
    * You can override this behavior by providing a register function.
@@ -148,7 +164,7 @@ interface ModuleDescriptorOptions {
  * Base class for all modules.
  */
 declare abstract class Module {
-  abstract readonly options: ModuleDescriptorOptions;
+  abstract readonly options: ModulePrimitiveOptions;
   abstract register(alepha: Alepha): void;
   static NAME_REGEX: RegExp;
   /**
@@ -163,22 +179,6 @@ declare abstract class Module {
   static of(ctor: Service): Service<Module> | undefined;
 }
 //#endregion
-//#region ../alepha/src/core/interfaces/Async.d.ts
-/**
- * Represents a value that can be either a value or a promise of value.
- */
-type Async<T> = T | Promise<T>;
-//#endregion
-//#region ../alepha/src/core/interfaces/LoggerInterface.d.ts
-type LogLevel = "ERROR" | "WARN" | "INFO" | "DEBUG" | "TRACE" | "SILENT";
-interface LoggerInterface {
-  trace(message: string, data?: unknown): void;
-  debug(message: string, data?: unknown): void;
-  info(message: string, data?: unknown): void;
-  warn(message: string, data?: unknown): void;
-  error(message: string, data?: unknown): void;
-}
-//#endregion
 //#region ../alepha/src/core/providers/AlsProvider.d.ts
 type AsyncLocalStorageData = any;
 declare class AlsProvider {
@@ -440,7 +440,7 @@ declare class EventManager {
   }): Promise<void>;
 }
 //#endregion
-//#region ../alepha/src/core/descriptors/$atom.d.ts
+//#region ../alepha/src/core/primitives/$atom.d.ts
 type AtomOptions<T extends TAtomObject, N extends string> = {
   name: N;
   schema: T;
@@ -569,7 +569,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * // You can access the environment variables using alepha.env
  * console.log(alepha.env.MY_VAR); // "value"
  *
- * // But you should use $env() descriptor to get typed values from the environment.
+ * // But you should use $env() primitive to get typed values from the environment.
  * class App {
  *   env = $env(
  *     t.object({
@@ -582,7 +582,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * ### Modules
  *
  * Modules are a way to group services together.
- * You can register a module using the `$module` descriptor.
+ * You can register a module using the `$module` primitive.
  *
  * ```ts
  * import { $module } from "alepha";
@@ -600,7 +600,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * ### Hooks
  *
  * Hooks are a way to run async functions from all registered providers/services.
- * You can register a hook using the `$hook` descriptor.
+ * You can register a hook using the `$hook` primitive.
  *
  * ```ts
  * import { $hook } from "alepha";
@@ -697,9 +697,9 @@ declare class Alepha {
     use: Service;
   }>;
   /**
-   * Registry of descriptors.
+   * Registry of primitives.
    */
-  protected descriptorRegistry: Map<Service<Descriptor<{}>>, Descriptor<{}>[]>;
+  protected primitiveRegistry: Map<Service<Primitive<{}>>, Primitive<{}>[]>;
   /**
    *  List of all services + how they are provided.
    */
@@ -719,7 +719,7 @@ declare class Alepha {
   /**
    * State manager to store arbitrary values.
    */
-  get state(): StateManager<State>;
+  get store(): StateManager<State>;
   /**
    * Codec manager for encoding and decoding data with different formats.
    *
@@ -792,7 +792,7 @@ declare class Alepha {
    * Starts the App.
    *
    * - Lock any further changes to the container.
-   * - Run "configure" hook for all services. Descriptors will be processed.
+   * - Run "configure" hook for all services. Primitives will be processed.
    * - Run "start" hook for all services. Providers will connect/listen/...
    * - Run "ready" hook for all services. This is the point where the App is ready to serve requests.
    *
@@ -897,13 +897,13 @@ declare class Alepha {
   }>;
   services<T extends object>(base: Service<T>): Array<T>;
   /**
-   * Get all descriptors of the specified type.
+   * Get all primitives of the specified type.
    */
-  descriptors<TDescriptor extends Descriptor>(factory: {
-    [KIND]: InstantiableClass<TDescriptor>;
-  } | string): Array<TDescriptor>;
+  primitives<TPrimitive extends Primitive>(factory: {
+    [KIND]: InstantiableClass<TPrimitive>;
+  } | string): Array<TPrimitive>;
   protected new<T extends object>(service: Service<T>, args?: any[]): T;
-  protected processDescriptor(value: Descriptor, propertyKey?: string): void;
+  protected processPrimitive(value: Primitive, propertyKey?: string): void;
 }
 interface Hook<T extends keyof Hooks = any> {
   caller?: Service;
@@ -1030,34 +1030,6 @@ interface Hooks {
   };
 }
 //#endregion
-//#region ../alepha/src/core/descriptors/$hook.d.ts
-interface HookOptions<T extends keyof Hooks> {
-  /**
-   * The name of the hook. "configure", "start", "ready", "stop", ...
-   */
-  on: T;
-  /**
-   * The handler to run when the hook is triggered.
-   */
-  handler: (args: Hooks[T]) => Async<any>;
-  /**
-   * Force the hook to run first or last on the list of hooks.
-   */
-  priority?: "first" | "last";
-  /**
-   * Empty placeholder, not implemented yet. :-)
-   */
-  before?: object | Array<object>;
-  /**
-   * Empty placeholder, not implemented yet. :-)
-   */
-  after?: object | Array<object>;
-}
-declare class HookDescriptor<T extends keyof Hooks> extends Descriptor<HookOptions<T>> {
-  called: number;
-  protected onInit(): void;
-}
-//#endregion
 //#region ../alepha/src/core/schemas/pageSchema.d.ts
 declare const pageMetadataSchema: TObject$1<{
   number: TInteger;
@@ -1090,6 +1062,34 @@ declare module "alepha" {
   }
 }
 //#endregion
+//#region ../alepha/src/core/primitives/$hook.d.ts
+interface HookOptions<T extends keyof Hooks> {
+  /**
+   * The name of the hook. "configure", "start", "ready", "stop", ...
+   */
+  on: T;
+  /**
+   * The handler to run when the hook is triggered.
+   */
+  handler: (args: Hooks[T]) => Async<any>;
+  /**
+   * Force the hook to run first or last on the list of hooks.
+   */
+  priority?: "first" | "last";
+  /**
+   * Empty placeholder, not implemented yet. :-)
+   */
+  before?: object | Array<object>;
+  /**
+   * Empty placeholder, not implemented yet. :-)
+   */
+  after?: object | Array<object>;
+}
+declare class HookPrimitive<T extends keyof Hooks> extends Primitive<HookOptions<T>> {
+  called: number;
+  protected onInit(): void;
+}
+//#endregion
 //#region ../alepha/src/logger/schemas/logEntrySchema.d.ts
 declare const logEntrySchema: TObject$1<{
   level: TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
@@ -1114,8 +1114,8 @@ declare class DateTimeProvider {
   protected readonly timeouts: Timeout[];
   protected readonly intervals: Interval[];
   constructor();
-  protected readonly onStart: HookDescriptor<"start">;
-  protected readonly onStop: HookDescriptor<"stop">;
+  protected readonly onStart: HookPrimitive<"start">;
+  protected readonly onStop: HookPrimitive<"stop">;
   setLocale(locale: string): void;
   isDateTime(value: unknown): value is DateTime;
   /**
@@ -1733,8 +1733,8 @@ declare class MemoryFileStorageProvider implements FileStorageProvider {
   protected createId(): string;
 }
 //#endregion
-//#region ../alepha/src/bucket/descriptors/$bucket.d.ts
-interface BucketDescriptorOptions extends BucketFileOptions {
+//#region ../alepha/src/bucket/primitives/$bucket.d.ts
+interface BucketPrimitiveOptions extends BucketFileOptions {
   /**
    * File storage provider configuration for the bucket.
    *
@@ -1866,7 +1866,7 @@ interface BucketFileOptions {
    */
   maxSize?: number;
 }
-declare class BucketDescriptor extends Descriptor<BucketDescriptorOptions> {
+declare class BucketPrimitive extends Primitive<BucketPrimitiveOptions> {
   readonly provider: FileStorageProvider | MemoryFileStorageProvider;
   private readonly fileSystem;
   get name(): string;
@@ -1929,7 +1929,7 @@ declare module "alepha" {
     "bucket:file:uploaded": {
       id: string;
       file: FileLike;
-      bucket: BucketDescriptor;
+      bucket: BucketPrimitive;
       options: BucketFileOptions;
     };
     /**
@@ -1937,14 +1937,14 @@ declare module "alepha" {
      */
     "bucket:file:deleted": {
       id: string;
-      bucket: BucketDescriptor;
+      bucket: BucketPrimitive;
     };
   }
 }
 /**
- * Provides file storage capabilities through declarative bucket descriptors with support for multiple storage backends.
+ * Provides file storage capabilities through declarative bucket primitives with support for multiple storage backends.
  *
- * The bucket module enables unified file operations across different storage systems using the `$bucket` descriptor
+ * The bucket module enables unified file operations across different storage systems using the `$bucket` primitive
  * on class properties. It abstracts storage provider differences, offering consistent APIs for local filesystem,
  * cloud storage, or in-memory storage for testing environments.
  *
@@ -1981,7 +1981,7 @@ declare class VercelFileStorageProvider implements FileStorageProvider {
   protected readonly fileDetector: FileDetector;
   protected readonly stores: Set<string>;
   protected readonly vercelBlobApi: VercelBlobApi;
-  protected readonly onStart: HookDescriptor<"start">;
+  protected readonly onStart: HookPrimitive<"start">;
   convertName(name: string): string;
   protected createId(mimeType: string): string;
   upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;

package/dist/index.js

@@ -30,7 +30,7 @@ var VercelFileStorageProvider = class {
 	onStart = $hook({
 		on: "start",
 		handler: async () => {
-			for (const bucket of this.alepha.descriptors($bucket)) {
+			for (const bucket of this.alepha.primitives($bucket)) {
 				if (bucket.provider !== this) continue;
 				const storeName = this.convertName(bucket.name);
 				this.log.debug(`Prepare store '${storeName}' ...`);

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 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  FileNotFoundError,\n  type FileStorageProvider,\n} from \"alepha/bucket\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileDetector, 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 fileDetector = $inject(FileDetector);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\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(mimeType: string): string {\n    const ext = this.fileDetector.getExtensionFromMimeType(mimeType);\n    return `${crypto.randomUUID()}.${ext}`;\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId(file.type);\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      const contentBuffer = Buffer.from(await file.arrayBuffer());\n\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        contentBuffer 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      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      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      const mimeType = this.fileDetector.getContentType(fileId);\n\n      return this.fileSystem.createFile({\n        buffer: Buffer.from(arrayBuffer),\n        name: fileId,\n        type: mimeType,\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":";;;;;;;;AAEA,IAAa,gBAAb,MAA2B;CACzB,MAAkB;CAClB,OAAoB;CACpB,MAAkB;;;;;ACgBpB,MAAM,YAAY,EAAE,OAAO,EACzB,uBAAuB,EAAE,KAAK,EAC5B,MAAM,QACP,CAAC,EACH,CAAC;;;;AASF,IAAa,4BAAb,MAAsE;CACpE,AAAmB,MAAM,SAAS;CAClC,AAAmB,MAAM,KAAK,UAAU;CACxC,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,OAAO,QAAQ,iBAAiB;CACnD,AAAmB,aAAa,QAAQ,mBAAmB;CAC3D,AAAmB,eAAe,QAAQ,aAAa;CACvD,AAAmB,yBAAsB,IAAI,KAAK;CAClD,AAAmB,gBAAgB,QAAQ,cAAc;CAEzD,AAAmB,UAAU,MAAM;EACjC,IAAI;EACJ,SAAS,YAAY;AACnB,QAAK,MAAM,UAAU,KAAK,OAAO,YAAY,QAAQ,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,SAAS,UAA0B;EAC3C,MAAM,MAAM,KAAK,aAAa,yBAAyB,SAAS;AAChE,SAAO,GAAG,OAAO,YAAY,CAAC,GAAG;;CAGnC,MAAa,OACX,YACA,MACA,QACiB;AACjB,aAAW,KAAK,SAAS,KAAK,KAAK;AAEnC,OAAK,IAAI,MACP,mBAAmB,KAAK,KAAK,eAAe,WAAW,aAAa,OAAO,MAC5E;EAGD,MAAM,WAAW,GADC,KAAK,YAAY,WAAW,CAChB,GAAG;AAEjC,MAAI;GACF,MAAM,gBAAgB,OAAO,KAAK,MAAM,KAAK,aAAa,CAAC;GAE3D,MAAM,SAAS,MAAM,KAAK,cAAc,IACtC,UACA,eACA;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,IAAI,YAAY,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;GACF,MAAM,aAAa,MAAM,KAAK,cAAc,KAAK,UAAU,EACzD,OAAO,KAAK,IAAI,uBACjB,CAAC;AAEF,OAAI,CAAC,WACH,OAAM,IAAI,kBACR,SAAS,OAAO,yBAAyB,WAAW,GACrD;GAGH,MAAM,WAAW,MAAM,MAAM,WAAW,IAAI;AAE5C,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,kBACR,yBAAyB,SAAS,aACnC;GAGH,MAAM,cAAc,MAAM,SAAS,aAAa;AAChD,OAAI,CAAC,YACH,OAAM,IAAI,kBAAkB,uCAAuC;GAGrE,MAAM,WAAW,KAAK,aAAa,eAAe,OAAO;AAEzD,UAAO,KAAK,WAAW,WAAW;IAChC,QAAQ,OAAO,KAAK,YAAY;IAChC,MAAM;IACN,MAAM;IACP,CAAC;WACK,OAAO;AACd,OAAI,iBAAiB,kBACnB,OAAM;AAGR,QAAK,IAAI,MAAM,4BAA4B,QAAQ;AACnD,OAAI,iBAAiB,MACnB,OAAM,IAAI,kBAAkB,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,IAAI,kBAAkB,uBAAuB,EAAE,OAAO,OAAO,CAAC;AAEtE,SAAM;;;;;;;;;;;;;AC5LZ,MAAa,qBAAqB,QAAQ;CACxC,MAAM;CACN,UAAU,CAAC,0BAA0B;CACrC,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,aAAa;CACxB,CAAC"}
+{"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  FileNotFoundError,\n  type FileStorageProvider,\n} from \"alepha/bucket\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { FileDetector, 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 fileDetector = $inject(FileDetector);\n  protected readonly stores: Set<string> = new Set();\n  protected readonly vercelBlobApi = $inject(VercelBlobApi);\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      for (const bucket of this.alepha.primitives($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(mimeType: string): string {\n    const ext = this.fileDetector.getExtensionFromMimeType(mimeType);\n    return `${crypto.randomUUID()}.${ext}`;\n  }\n\n  public async upload(\n    bucketName: string,\n    file: FileLike,\n    fileId?: string,\n  ): Promise<string> {\n    fileId ??= this.createId(file.type);\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      const contentBuffer = Buffer.from(await file.arrayBuffer());\n\n      const result = await this.vercelBlobApi.put(\n        pathname,\n        contentBuffer 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      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      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      const mimeType = this.fileDetector.getContentType(fileId);\n\n      return this.fileSystem.createFile({\n        buffer: Buffer.from(arrayBuffer),\n        name: fileId,\n        type: mimeType,\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

@@ -10,7 +10,7 @@
     "blob"
   ],
   "author": "Nicolas Foures",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -27,12 +27,12 @@
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
-    "alepha": "0.13.1",
+    "alepha": "0.13.2",
     "tsdown": "^0.16.7",
     "vitest": "^4.0.14"
   },
   "peerDependencies": {
-    "alepha": "0.13.1"
+    "alepha": "0.13.2"
   },
   "scripts": {
     "lint": "alepha lint",

package/src/providers/VercelFileStorageProvider.ts

@@ -45,7 +45,7 @@ export class VercelFileStorageProvider implements FileStorageProvider {
   protected readonly onStart = $hook({
     on: "start",
     handler: async () => {
-      for (const bucket of this.alepha.descriptors($bucket)) {
+      for (const bucket of this.alepha.primitives($bucket)) {
         if (bucket.provider !== this) {
           continue;
         }