alepha 0.21.2 → 0.22.0

package/dist/bucket/index.d.ts

@@ -1,12 +1,9 @@
-import * as _$alepha from "alepha";
 import { Alepha, AlephaError, FileLike, KIND, Primitive, Service, Static } from "alepha";
 import { FileDetector, FileSystemProvider } from "alepha/system";
 import { CryptoProvider } from "alepha/crypto";
 import * as fs from "node:fs";
-import * as _$alepha_logger0 from "alepha/logger";
 import { S3mini } from "s3mini";
 import { R2Bucket } from "@cloudflare/workers-types";
-import * as _$typebox from "typebox";
 
 //#region ../../src/bucket/providers/FileStorageProvider.d.ts
 declare abstract class FileStorageProvider {
@@ -50,6 +47,18 @@ declare abstract class FileStorageProvider {
    * @param fileIds - Identifiers of the files to delete
    */
   abstract deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
+  /**
+   * Lists the file identifiers stored in a bucket, like `ls` on a directory.
+   *
+   * This is a flat, unpaginated listing intended for small buckets. Providers
+   * cap the result at their natural page size (~1000 for S3/R2); anything beyond
+   * that is silently dropped. It is NOT a search API — use `alepha/api/files`
+   * when you need querying or pagination.
+   *
+   * @param bucketName - Container name
+   * @return The identifiers of the files in the bucket (empty if none).
+   */
+  abstract list(bucketName: string): Promise<string[]>;
 }
 //#endregion
 //#region ../../src/bucket/providers/MemoryFileStorageProvider.d.ts
@@ -69,6 +78,7 @@ declare class MemoryFileStorageProvider implements FileStorageProvider {
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
   deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
+  list(bucketName: string): Promise<string[]>;
   protected createId(): string;
 }
 //#endregion
@@ -280,6 +290,15 @@ declare class BucketPrimitive extends Primitive<BucketPrimitiveOptions> {
    * Checks if a file exists in the bucket.
    */
   exists(fileId: string): Promise<boolean>;
+  /**
+   * Lists the file identifiers stored in the bucket, like `ls` on a directory.
+   *
+   * This is a flat, unpaginated listing meant for small buckets — the result is
+   * capped at the provider's natural page size (~1000 for S3/R2) and anything
+   * beyond that is silently dropped. It is NOT a search API; reach for
+   * `alepha/api/files` when you need querying or pagination.
+   */
+  list(): Promise<string[]>;
   /**
    * Downloads a file from the bucket.
    */
@@ -308,7 +327,44 @@ declare class FileNotFoundError extends AlephaError {
   readonly status = 404;
 }
 //#endregion
-//#region ../../src/bucket/providers/CloudflareR2Provider.d.ts
+//#region ../../src/bucket/providers/LocalFileStorageProvider.d.ts
+/**
+ * Local file storage configuration atom
+ */
+declare const localFileStorageOptions: import("alepha").Atom<import("typebox").TObject<{
+  storagePath: import("typebox").TString;
+}>, "alepha.bucket.local.options">;
+type LocalFileStorageProviderOptions = Static<typeof localFileStorageOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [localFileStorageOptions.key]: LocalFileStorageProviderOptions;
+  }
+}
+declare class LocalFileStorageProvider implements FileStorageProvider {
+  protected readonly alepha: Alepha;
+  protected readonly log: import("alepha/logger").Logger;
+  protected readonly fileDetector: FileDetector;
+  protected readonly fileSystemProvider: FileSystemProvider;
+  protected readonly crypto: CryptoProvider;
+  protected readonly options: Readonly<{
+    storagePath: string;
+  }>;
+  protected get storagePath(): string;
+  protected readonly onConfigure: import("alepha").HookPrimitive<"configure">;
+  protected readonly onStart: import("alepha").HookPrimitive<"start">;
+  upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
+  download(bucketName: string, fileId: string): Promise<FileLike>;
+  exists(bucketName: string, fileId: string): Promise<boolean>;
+  delete(bucketName: string, fileId: string): Promise<void>;
+  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
+  list(bucketName: string): Promise<string[]>;
+  protected stat(bucket: string, fileId: string): Promise<fs.Stats>;
+  protected createId(mimeType: string): string;
+  protected path(bucket: string, fileId?: string): string;
+  protected isErrorNoEntry(error: unknown): boolean;
+}
+//#endregion
+//#region ../../src/bucket/providers/R2FileStorageProvider.d.ts
 /**
  * Cloudflare R2 storage provider.
  *
@@ -354,9 +410,9 @@ declare class FileNotFoundError extends AlephaError {
  * // Files stored at: myapp/avatars/uuid.png, myapp/documents/uuid.pdf
  * ```
  */
-declare class CloudflareR2Provider implements FileStorageProvider {
+declare class R2FileStorageProvider implements FileStorageProvider {
   protected readonly alepha: Alepha;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly crypto: CryptoProvider;
   protected readonly env: {
     R2_BUCKET_NAME: string;
@@ -371,12 +427,13 @@ declare class CloudflareR2Provider implements FileStorageProvider {
    * Used for multi-app setups sharing the same R2 bucket.
    */
   get prefix(): string | undefined;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
+  protected readonly onStart: import("alepha").HookPrimitive<"start">;
   upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
   deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
+  list(bucketName: string): Promise<string[]>;
   /**
    * Build the full R2 key: {prefix}/{bucketName}/{fileId}
    */
@@ -385,44 +442,8 @@ declare class CloudflareR2Provider implements FileStorageProvider {
   protected createId(filename: string): string;
 }
 //#endregion
-//#region ../../src/bucket/providers/LocalFileStorageProvider.d.ts
-/**
- * Local file storage configuration atom
- */
-declare const localFileStorageOptions: _$alepha.Atom<_$typebox.TObject<{
-  storagePath: _$typebox.TString;
-}>, "alepha.bucket.local.options">;
-type LocalFileStorageProviderOptions = Static<typeof localFileStorageOptions.schema>;
-declare module "alepha" {
-  interface State {
-    [localFileStorageOptions.key]: LocalFileStorageProviderOptions;
-  }
-}
-declare class LocalFileStorageProvider implements FileStorageProvider {
-  protected readonly alepha: Alepha;
-  protected readonly log: _$alepha_logger0.Logger;
-  protected readonly fileDetector: FileDetector;
-  protected readonly fileSystemProvider: FileSystemProvider;
-  protected readonly crypto: CryptoProvider;
-  protected readonly options: Readonly<{
-    storagePath: string;
-  }>;
-  protected get storagePath(): string;
-  protected readonly onConfigure: _$alepha.HookPrimitive<"configure">;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
-  upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
-  download(bucketName: string, fileId: string): Promise<FileLike>;
-  exists(bucketName: string, fileId: string): Promise<boolean>;
-  delete(bucketName: string, fileId: string): Promise<void>;
-  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
-  protected stat(bucket: string, fileId: string): Promise<fs.Stats>;
-  protected createId(mimeType: string): string;
-  protected path(bucket: string, fileId?: string): string;
-  protected isErrorNoEntry(error: unknown): boolean;
-}
-//#endregion
-//#region ../../src/bucket/providers/NodeS3BucketProvider.d.ts
-declare const envSchema: _$alepha.TObject<{
+//#region ../../src/bucket/providers/S3FileStorageProvider.d.ts
+declare const envSchema: import("alepha").TObject<{
   /**
    * S3 endpoint URL. The bucket name is appended (path-style) per request.
    *
@@ -432,21 +453,21 @@ declare const envSchema: _$alepha.TObject<{
    * - MinIO: `http://localhost:9000`
    * - DigitalOcean Spaces: `https://<region>.digitaloceanspaces.com`
    */
-  S3_ENDPOINT: _$alepha.TString;
+  S3_ENDPOINT: import("alepha").TString;
   /**
    * AWS region or "auto" for R2.
    *
    * @default "auto"
    */
-  S3_REGION: _$alepha.TOptional<_$alepha.TString>;
+  S3_REGION: import("alepha").TOptional<import("alepha").TString>;
   /**
    * Access key ID for S3 authentication.
    */
-  S3_ACCESS_KEY_ID: _$alepha.TString;
+  S3_ACCESS_KEY_ID: import("alepha").TString;
   /**
    * Secret access key for S3 authentication.
    */
-  S3_SECRET_ACCESS_KEY: _$alepha.TString;
+  S3_SECRET_ACCESS_KEY: import("alepha").TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -459,8 +480,8 @@ declare module "alepha" {
  *
  * Uses path-style addressing (`<endpoint>/<bucket>`).
  */
-declare class NodeS3BucketProvider implements FileStorageProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+declare class S3FileStorageProvider implements FileStorageProvider {
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly env: {
     S3_REGION?: string | undefined;
     S3_ENDPOINT: string;
@@ -478,12 +499,13 @@ declare class NodeS3BucketProvider implements FileStorageProvider {
    */
   convertName(name: string): string;
   protected getClient(bucketName: string): S3mini;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
+  protected readonly onStart: import("alepha").HookPrimitive<"start">;
   protected createId(mimeType: string): string;
   upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
+  list(bucketName: string): Promise<string[]>;
   deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
 }
 //#endregion
@@ -531,7 +553,7 @@ declare module "alepha" {
  *
  * @module alepha.bucket
  */
-declare const AlephaBucket: _$alepha.Service<_$alepha.Module>;
+declare const AlephaBucket: import("alepha").Service<import("alepha").Module>;
 //#endregion
-export { $bucket, AlephaBucket, BucketFileOptions, BucketPrimitive, BucketPrimitiveOptions, CloudflareR2Provider, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, LocalFileStorageProviderOptions, MemoryFileStorageProvider, NodeS3BucketProvider, localFileStorageOptions };
+export { $bucket, AlephaBucket, BucketFileOptions, BucketPrimitive, BucketPrimitiveOptions, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, LocalFileStorageProviderOptions, MemoryFileStorageProvider, R2FileStorageProvider, S3FileStorageProvider, localFileStorageOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/bucket/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/CloudflareR2Provider.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/providers/NodeS3BucketProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/providers/R2FileStorageProvider.ts","../../src/bucket/providers/S3FileStorageProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}

package/dist/bucket/index.js

@@ -2,11 +2,12 @@ import { $atom, $env, $hook, $inject, $module, $state, Alepha, AlephaError, KIND
 import { FileDetector, FileSystemProvider } from "alepha/system";
 import { CryptoProvider } from "alepha/crypto";
 import { createReadStream } from "node:fs";
-import { mkdir, stat, unlink } from "node:fs/promises";
+import { mkdir, readdir, stat, unlink } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { $logger } from "alepha/logger";
 import { Buffer as Buffer$1 } from "node:buffer";
+import { Readable } from "node:stream";
 import { S3mini } from "s3mini";
 //#region ../../src/bucket/errors/InvalidFileError.ts
 var InvalidFileError = class extends AlephaError {
@@ -62,6 +63,10 @@ var MemoryFileStorageProvider = class {
 	async deleteMany(bucketName, fileIds) {
 		for (const id of fileIds) delete this.files[`${bucketName}/${id}`];
 	}
+	async list(bucketName) {
+		const prefix = `${bucketName}/`;
+		return Object.keys(this.files).filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));
+	}
 	createId() {
 		return this.crypto.randomUUID();
 	}
@@ -139,6 +144,11 @@ var BucketPrimitive = class extends Primitive {
 			const mimeType = file.type || "application/octet-stream";
 			if (!mimeTypes.includes(mimeType)) throw new InvalidFileError(`MIME type ${mimeType} is not allowed in bucket ${this.name}`);
 		}
+		if (file.size === 0) file = this.fileSystem.createFile({
+			arrayBuffer: await file.arrayBuffer(),
+			name: file.name,
+			type: file.type
+		});
 		if (file.size > maxSize * 1024 * 1024) throw new InvalidFileError(`File size ${file.size} exceeds the maximum size of ${maxSize} MB in bucket ${this.name}`);
 		const id = await this.provider.upload(this.name, file);
 		await this.alepha.events.emit("bucket:file:uploaded", {
@@ -181,6 +191,17 @@ var BucketPrimitive = class extends Primitive {
 		return this.provider.exists(this.name, fileId);
 	}
 	/**
+	* Lists the file identifiers stored in the bucket, like `ls` on a directory.
+	*
+	* This is a flat, unpaginated listing meant for small buckets — the result is
+	* capped at the provider's natural page size (~1000 for S3/R2) and anything
+	* beyond that is silently dropped. It is NOT a search API; reach for
+	* `alepha/api/files` when you need querying or pagination.
+	*/
+	async list() {
+		return this.provider.list(this.name);
+	}
+	/**
 	* Downloads a file from the bucket.
 	*/
 	async download(fileId) {
@@ -283,6 +304,14 @@ var LocalFileStorageProvider = class {
 			throw new AlephaError("Error deleting file", { cause: error });
 		})));
 	}
+	async list(bucketName) {
+		try {
+			return (await readdir(this.path(bucketName), { withFileTypes: true })).filter((entry) => entry.isFile()).map((entry) => entry.name);
+		} catch (error) {
+			if (this.isErrorNoEntry(error)) return [];
+			throw new AlephaError("Error listing files", { cause: error });
+		}
+	}
 	stat(bucket, fileId) {
 		return stat(this.path(bucket, fileId));
 	}
@@ -298,7 +327,7 @@ var LocalFileStorageProvider = class {
 	}
 };
 //#endregion
-//#region ../../src/bucket/providers/NodeS3BucketProvider.ts
+//#region ../../src/bucket/providers/S3FileStorageProvider.ts
 const envSchema = t.object({
 	/**
 	* S3 endpoint URL. The bucket name is appended (path-style) per request.
@@ -333,7 +362,7 @@ const envSchema = t.object({
 *
 * Uses path-style addressing (`<endpoint>/<bucket>`).
 */
-var NodeS3BucketProvider = class {
+var S3FileStorageProvider = class {
 	log = $logger();
 	env = $env(envSchema);
 	alepha = $inject(Alepha);
@@ -402,15 +431,21 @@ var NodeS3BucketProvider = class {
 		this.log.trace(`Downloading file '${fileId}' from bucket '${bucketName}'...`);
 		const response = await this.getClient(bucketName).getObjectResponse(fileId);
 		if (!response) throw new FileNotFoundError(`File '${fileId}' not found in bucket '${bucketName}'`);
-		const buffer = Buffer$1.from(await response.arrayBuffer());
 		const mimeType = response.headers.get("content-type") || this.fileDetector.getContentType(fileId);
 		const metaName = response.headers.get("x-amz-meta-name");
 		const name = metaName ? decodeURIComponent(metaName) : fileId;
+		const contentLength = response.headers.get("content-length");
+		const size = contentLength ? Number.parseInt(contentLength, 10) : 0;
+		if (!response.body) return this.fileSystem.createFile({
+			buffer: Buffer$1.alloc(0),
+			name,
+			type: mimeType
+		});
 		return this.fileSystem.createFile({
-			buffer,
+			stream: Readable.fromWeb(response.body),
 			name,
 			type: mimeType,
-			size: buffer.length
+			size
 		});
 	}
 	async exists(bucketName, fileId) {
@@ -428,6 +463,12 @@ var NodeS3BucketProvider = class {
 			throw error;
 		}
 	}
+	async list(bucketName) {
+		this.log.trace(`Listing files in bucket '${bucketName}'...`);
+		const objects = await this.getClient(bucketName).listObjects();
+		if (!objects) return [];
+		return objects.map((object) => object.Key);
+	}
 	async deleteMany(bucketName, fileIds) {
 		if (fileIds.length === 0) return;
 		this.log.trace(`Deleting ${fileIds.length} files from bucket '${bucketName}'...`);
@@ -447,7 +488,7 @@ var NodeS3BucketProvider = class {
 	}
 };
 //#endregion
-//#region ../../src/bucket/providers/CloudflareR2Provider.ts
+//#region ../../src/bucket/providers/R2FileStorageProvider.ts
 /**
 * Cloudflare R2 storage provider.
 *
@@ -493,7 +534,7 @@ var NodeS3BucketProvider = class {
 * // Files stored at: myapp/avatars/uuid.png, myapp/documents/uuid.pdf
 * ```
 */
-var CloudflareR2Provider = class {
+var R2FileStorageProvider = class {
 	alepha = $inject(Alepha);
 	log = $logger();
 	crypto = $inject(CryptoProvider);
@@ -583,6 +624,12 @@ R2_BUCKET_NAME: t.string({ description: "R2 bucket name in Cloudflare" }) }));
 		this.log.trace(`Deleting ${keys.length} keys from '${bucketName}'`);
 		for (let i = 0; i < keys.length; i += 1e3) await r2.delete(keys.slice(i, i + 1e3));
 	}
+	async list(bucketName) {
+		const r2 = this.getR2();
+		const keyPrefix = this.key(bucketName, "");
+		this.log.trace(`Listing files in '${keyPrefix}'`);
+		return (await r2.list({ prefix: keyPrefix })).objects.map((object) => object.key.slice(keyPrefix.length));
+	}
 	/**
 	* Build the full R2 key: {prefix}/{bucketName}/{fileId}
 	*/
@@ -624,18 +671,18 @@ const AlephaBucket = $module({
 	variants: [
 		MemoryFileStorageProvider,
 		LocalFileStorageProvider,
-		NodeS3BucketProvider
+		S3FileStorageProvider
 	],
 	register: (alepha) => {
 		const useS3 = !!alepha.env.S3_ENDPOINT;
 		alepha.with({
 			optional: true,
 			provide: FileStorageProvider,
-			use: alepha.isTest() || alepha.isServerless() ? MemoryFileStorageProvider : useS3 ? NodeS3BucketProvider : LocalFileStorageProvider
+			use: alepha.isTest() || alepha.isServerless() ? MemoryFileStorageProvider : useS3 ? S3FileStorageProvider : LocalFileStorageProvider
 		});
 	}
 });
 //#endregion
-export { $bucket, AlephaBucket, BucketPrimitive, CloudflareR2Provider, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, MemoryFileStorageProvider, NodeS3BucketProvider, localFileStorageOptions };
+export { $bucket, AlephaBucket, BucketPrimitive, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, MemoryFileStorageProvider, R2FileStorageProvider, S3FileStorageProvider, localFileStorageOptions };
 
 //# sourceMappingURL=index.js.map