@digibuffer/file-manager 1.0.1

package/dist/router-CD_RQnlx.d.ts

@@ -0,0 +1,159 @@
+import { a as FileManagerConfig, c as ManagedFile, d as StorageFile, i as DownloadUrlOptions, l as PaginatedResponse, r as DeleteResult, s as ListFilesOptions, t as BatchDeleteResult } from "./types-Brk9aR7c.js";
+import { z } from "zod";
+
+//#region src/server/file-manager.d.ts
+/**
+ * File Manager for managing files in R2/S3
+ */
+declare class FileManager<TFile extends ManagedFile = ManagedFile> {
+  private client;
+  private bucketName;
+  private database?;
+  private defaultLimit;
+  private maxLimit;
+  constructor(config: FileManagerConfig<TFile>);
+  /**
+   * List files from storage with pagination
+   */
+  listFromStorage(options?: ListFilesOptions): Promise<PaginatedResponse<StorageFile>>;
+  /**
+   * List files from database with pagination
+   */
+  listFromDatabase(options?: ListFilesOptions): Promise<PaginatedResponse<TFile>>;
+  /**
+   * List files from both database and storage, merging results
+   */
+  listFromBoth(options?: ListFilesOptions): Promise<PaginatedResponse<TFile>>;
+  /**
+   * List files with automatic source selection
+   */
+  list(options?: ListFilesOptions): Promise<PaginatedResponse<TFile | StorageFile>>;
+  /**
+   * Delete a single file
+   */
+  delete(key: string): Promise<DeleteResult>;
+  /**
+   * Delete multiple files in batch
+   */
+  deleteBatch(keys: string[]): Promise<BatchDeleteResult>;
+  /**
+   * Generate a presigned download URL
+   */
+  getDownloadUrl(key: string, options?: DownloadUrlOptions): Promise<string>;
+  /**
+   * Check if a file exists
+   */
+  exists(key: string): Promise<boolean>;
+  /**
+   * Get file metadata from storage
+   */
+  getMetadata(key: string): Promise<StorageFile | null>;
+  /**
+   * Build URL helper - supports both path-style and virtual-hosted-style
+   */
+  private buildUrl;
+  /**
+   * Sort files helper
+   */
+  private sortFiles;
+  /**
+   * Create a FileManagerError
+   */
+  private createError;
+}
+//#endregion
+//#region src/server/router.d.ts
+declare const FileManagerRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  action: z.ZodLiteral<"list">;
+  limit: z.ZodOptional<z.ZodNumber>;
+  cursor: z.ZodOptional<z.ZodString>;
+  prefix: z.ZodOptional<z.ZodString>;
+  delimiter: z.ZodOptional<z.ZodString>;
+  source: z.ZodOptional<z.ZodEnum<{
+    storage: "storage";
+    database: "database";
+    both: "both";
+  }>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    lastModified: "lastModified";
+    size: "size";
+    name: "name";
+  }>>;
+  sortOrder: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodLiteral<"delete">;
+  key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodLiteral<"batchDelete">;
+  keys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodLiteral<"getUrl">;
+  key: z.ZodString;
+  expiresIn: z.ZodOptional<z.ZodNumber>;
+  filename: z.ZodOptional<z.ZodString>;
+  disposition: z.ZodOptional<z.ZodEnum<{
+    attachment: "attachment";
+    inline: "inline";
+  }>>;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodLiteral<"exists">;
+  key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  action: z.ZodLiteral<"getMetadata">;
+  key: z.ZodString;
+}, z.core.$strip>], "action">;
+type FileManagerRequest = z.infer<typeof FileManagerRequestSchema>;
+/**
+ * Route configuration
+ */
+type RouteConfig<TFile extends ManagedFile = ManagedFile> = {
+  fileManager: FileManager<TFile>;
+  /**
+   * Authorization check - return true to allow, false to deny
+   * Throw an error with a message for custom error responses
+   */
+  onAuthorize?: (request: FileManagerRequest, context?: any) => Promise<boolean> | boolean;
+  /**
+   * Before list hook - can modify options or deny access
+   */
+  onBeforeList?: (options: ListFilesOptions, context?: any) => Promise<ListFilesOptions | false> | ListFilesOptions | false;
+  /**
+   * Before delete hook - return false to deny deletion
+   */
+  onBeforeDelete?: (key: string, context?: any) => Promise<boolean> | boolean;
+  /**
+   * Before batch delete hook - can filter keys or deny access
+   */
+  onBeforeBatchDelete?: (keys: string[], context?: any) => Promise<string[] | false> | string[] | false;
+};
+/**
+ * Router for file management operations
+ */
+declare class FileManagerRouter<TFile extends ManagedFile = ManagedFile> {
+  private routes;
+  /**
+   * Register a route
+   */
+  route(path: string, config: RouteConfig<TFile>): this;
+  /**
+   * Handle a request
+   */
+  handle(path: string, body: unknown, context?: any): Promise<Response>;
+  /**
+   * Success response helper
+   */
+  private successResponse;
+  /**
+   * Error response helper
+   */
+  private errorResponse;
+}
+/**
+ * Create a file manager router
+ */
+declare function createFileManagerRouter<TFile extends ManagedFile = ManagedFile>(): FileManagerRouter<TFile>;
+//#endregion
+export { FileManager as a, createFileManagerRouter as i, FileManagerRouter as n, RouteConfig as r, FileManagerRequest as t };

package/dist/server/adapters/next.d.ts

@@ -0,0 +1,20 @@
+import { c as ManagedFile } from "../../types-Brk9aR7c.js";
+import { n as FileManagerRouter } from "../../router-CD_RQnlx.js";
+
+//#region src/server/adapters/next.d.ts
+
+/**
+ * Convert FileManagerRouter to Next.js App Router handler
+ */
+declare function toRouteHandler<TFile extends ManagedFile = ManagedFile>(router: FileManagerRouter<TFile>, options?: {
+  /** Route path to handle (default: 'default') */
+  path?: string;
+  /** Extract context from request (e.g., auth, user info) */
+  getContext?: (request: Request) => Promise<any> | any;
+}): (request: Request) => Promise<Response>;
+/**
+ * CORS headers helper for Next.js
+ */
+declare function withCors(handler: (request: Request) => Promise<Response>, allowedOrigins?: string[]): (request: Request) => Promise<Response>;
+//#endregion
+export { toRouteHandler, withCors };

package/dist/server/adapters/next.js

@@ -0,0 +1,63 @@
+//#region src/server/adapters/next.ts
+/**
+* Convert FileManagerRouter to Next.js App Router handler
+*/
+function toRouteHandler(router, options = {}) {
+	const path = options.path ?? "default";
+	return async function handler(request) {
+		if (request.method !== "POST") return new Response(JSON.stringify({
+			success: false,
+			error: { message: "Method not allowed" }
+		}), {
+			status: 405,
+			headers: { "Content-Type": "application/json" }
+		});
+		try {
+			const body = await request.json();
+			let context;
+			if (options.getContext) context = await options.getContext(request);
+			return await router.handle(path, body, context);
+		} catch (error) {
+			return new Response(JSON.stringify({
+				success: false,
+				error: { message: error instanceof Error ? error.message : "Failed to parse request body" }
+			}), {
+				status: 400,
+				headers: { "Content-Type": "application/json" }
+			});
+		}
+	};
+}
+/**
+* CORS headers helper for Next.js
+*/
+function withCors(handler, allowedOrigins = ["*"]) {
+	return async function corsHandler(request) {
+		const origin = request.headers.get("origin") ?? "";
+		const allowed = allowedOrigins.includes("*") || allowedOrigins.includes(origin);
+		if (request.method === "OPTIONS") return new Response(null, {
+			status: 204,
+			headers: {
+				"Access-Control-Allow-Origin": allowed ? origin || "*" : "",
+				"Access-Control-Allow-Methods": "POST, OPTIONS",
+				"Access-Control-Allow-Headers": "Content-Type, Authorization",
+				"Access-Control-Max-Age": "86400"
+			}
+		});
+		const response = await handler(request);
+		if (allowed) {
+			const headers = new Headers(response.headers);
+			headers.set("Access-Control-Allow-Origin", origin || "*");
+			headers.set("Access-Control-Allow-Credentials", "true");
+			return new Response(response.body, {
+				status: response.status,
+				statusText: response.statusText,
+				headers
+			});
+		}
+		return response;
+	};
+}
+
+//#endregion
+export { toRouteHandler, withCors };

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+import { a as FileManagerConfig, c as ManagedFile, d as StorageFile, i as DownloadUrlOptions, l as PaginatedResponse, n as DatabaseCallbacks, o as FileManagerError, r as DeleteResult, s as ListFilesOptions, t as BatchDeleteResult, u as PaginationOptions } from "../types-Brk9aR7c.js";
+import { a as FileManager, i as createFileManagerRouter, n as FileManagerRouter, r as RouteConfig, t as FileManagerRequest } from "../router-CD_RQnlx.js";
+import "../index-CHmsNSsb.js";
+export { BatchDeleteResult, DatabaseCallbacks, DeleteResult, DownloadUrlOptions, FileManager, FileManagerConfig, FileManagerError, FileManagerRequest, FileManagerRouter, ListFilesOptions, ManagedFile, PaginatedResponse, PaginationOptions, RouteConfig, StorageFile, createFileManagerRouter };

package/dist/server/index.js

@@ -0,0 +1,3 @@
+import { n as createFileManagerRouter, r as FileManager, t as FileManagerRouter } from "../server-CZrPOP0h.js";
+
+export { FileManager, FileManagerRouter, createFileManagerRouter };