@valentinkolb/filegate 2.4.0 → 2.5.3

package/src/client.ts

@@ -1,436 +0,0 @@
-import type { z } from "zod";
-import type {
-  FileInfoSchema,
-  DirInfoSchema,
-  SearchResponseSchema,
-  UploadStartResponseSchema,
-  UploadChunkResponseSchema,
-  ErrorSchema,
-} from "./schemas";
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export type FileInfo = z.infer<typeof FileInfoSchema>;
-export type DirInfo = z.infer<typeof DirInfoSchema>;
-export type SearchResponse = z.infer<typeof SearchResponseSchema>;
-export type UploadStartResponse = z.infer<typeof UploadStartResponseSchema>;
-export type UploadChunkResponse = z.infer<typeof UploadChunkResponseSchema>;
-export type ApiError = z.infer<typeof ErrorSchema>;
-
-export type FileProxyResponse<T> = { ok: true; data: T } | { ok: false; error: string; status: number };
-
-type Headers = Record<string, string>;
-
-export interface ClientOptions {
-  url: string;
-  token: string;
-  fetch?: typeof fetch;
-}
-
-// --- Info ---
-export interface InfoOptions {
-  path: string;
-  showHidden?: boolean;
-  /** If true, compute recursive sizes for directories (slower, default: false) */
-  computeSizes?: boolean;
-}
-
-// --- Download ---
-export interface DownloadOptions {
-  path: string;
-  /** If true, sets Content-Disposition: inline (view in browser) instead of attachment (download) */
-  inline?: boolean;
-}
-
-// --- Upload Single ---
-export interface UploadSingleOptions {
-  path: string;
-  filename: string;
-  data: Blob | ArrayBuffer | Uint8Array;
-  uid?: number;
-  gid?: number;
-  mode?: string;
-  /** Directory mode for auto-created parent directories (e.g. "755"). If not set, derived from mode. */
-  dirMode?: string;
-}
-
-// --- Upload Chunked Start ---
-export interface UploadChunkedStartOptions {
-  path: string;
-  filename: string;
-  size: number;
-  checksum: string;
-  chunkSize: number;
-  uid?: number;
-  gid?: number;
-  mode?: string;
-  /** Directory mode for auto-created parent directories (e.g. "755"). If not set, derived from mode. */
-  dirMode?: string;
-}
-
-// --- Upload Chunked Send ---
-export interface UploadChunkedSendOptions {
-  uploadId: string;
-  index: number;
-  data: Blob | ArrayBuffer | Uint8Array;
-  checksum?: string;
-}
-
-// --- Mkdir ---
-export interface MkdirOptions {
-  path: string;
-  uid?: number;
-  gid?: number;
-  mode?: string;
-}
-
-// --- Delete ---
-export interface DeleteOptions {
-  path: string;
-}
-
-// --- Transfer (Move/Copy) ---
-export interface TransferOptions {
-  from: string;
-  to: string;
-  mode: "move" | "copy";
-  /** If true (default), appends -01, -02, etc. to avoid overwriting existing files */
-  ensureUniqueName?: boolean;
-  /** Owner UID - required for cross-base copy */
-  uid?: number;
-  /** Owner GID - required for cross-base copy */
-  gid?: number;
-  /** File mode (e.g. "644") - required for cross-base copy */
-  fileMode?: string;
-  /** Directory mode (e.g. "755") - if not set, derived from fileMode */
-  dirMode?: string;
-}
-
-// --- Glob (Search) ---
-export interface GlobOptions {
-  paths: string[];
-  pattern: string;
-  showHidden?: boolean;
-  limit?: number;
-  /** Include files in results (default: true) */
-  files?: boolean;
-  /** Include directories in results (default: false) */
-  directories?: boolean;
-}
-
-// --- Thumbnail ---
-export type ThumbnailFit = "cover" | "contain" | "fill" | "inside" | "outside";
-export type ThumbnailPosition = "center" | "top" | "bottom" | "left" | "right" | "entropy" | "attention";
-export type ThumbnailFormat = "webp" | "jpeg" | "png" | "avif";
-
-export interface ImageThumbnailOptions {
-  path: string;
-  /** Width in pixels (default: 200, max: 2000) */
-  width?: number;
-  /** Height in pixels (default: 200, max: 2000) */
-  height?: number;
-  /** Scaling mode (default: cover) */
-  fit?: ThumbnailFit;
-  /** Crop position for cover fit (default: center) */
-  position?: ThumbnailPosition;
-  /** Output format (default: webp) */
-  format?: ThumbnailFormat;
-  /** Quality 1-100 (default: 80) */
-  quality?: number;
-}
-
-// ============================================================================
-// Thumbnail Namespace Class
-// ============================================================================
-
-class ThumbnailClient {
-  constructor(
-    private readonly url: string,
-    private readonly hdrs: () => Headers,
-    private readonly _fetch: typeof fetch,
-  ) {}
-
-  async image(opts: ImageThumbnailOptions): Promise<FileProxyResponse<Response>> {
-    const params = new URLSearchParams({ path: opts.path });
-    if (opts.width !== undefined) params.set("width", String(opts.width));
-    if (opts.height !== undefined) params.set("height", String(opts.height));
-    if (opts.fit) params.set("fit", opts.fit);
-    if (opts.position) params.set("position", opts.position);
-    if (opts.format) params.set("format", opts.format);
-    if (opts.quality !== undefined) params.set("quality", String(opts.quality));
-
-    const res = await this._fetch(`${this.url}/files/thumbnail/image?${params}`, {
-      headers: this.hdrs(),
-    });
-
-    if (!res.ok) {
-      const body = (await res.json().catch(() => ({ error: "unknown error" }))) as ApiError;
-      return { ok: false, error: body.error || "unknown error", status: res.status };
-    }
-
-    return { ok: true, data: res };
-  }
-}
-
-// ============================================================================
-// Upload Namespace Class
-// ============================================================================
-
-class UploadClient {
-  constructor(
-    private readonly url: string,
-    private readonly hdrs: () => Headers,
-    private readonly jsonHdrs: () => Headers,
-    private readonly _fetch: typeof fetch,
-    private readonly handleResponse: <T>(res: Response) => Promise<FileProxyResponse<T>>,
-  ) {}
-
-  async single(opts: UploadSingleOptions): Promise<FileProxyResponse<FileInfo>> {
-    const uploadHdrs: Headers = {
-      ...this.hdrs(),
-      "X-File-Path": opts.path,
-      "X-File-Name": opts.filename,
-    };
-    if (opts.uid !== undefined) uploadHdrs["X-Owner-UID"] = String(opts.uid);
-    if (opts.gid !== undefined) uploadHdrs["X-Owner-GID"] = String(opts.gid);
-    if (opts.mode) uploadHdrs["X-File-Mode"] = opts.mode;
-    if (opts.dirMode) uploadHdrs["X-Dir-Mode"] = opts.dirMode;
-
-    const res = await this._fetch(`${this.url}/files/content`, {
-      method: "PUT",
-      headers: uploadHdrs,
-      body: opts.data,
-    });
-    return this.handleResponse(res);
-  }
-
-  readonly chunked = {
-    start: async (opts: UploadChunkedStartOptions): Promise<FileProxyResponse<UploadStartResponse>> => {
-      const body = {
-        path: opts.path,
-        filename: opts.filename,
-        size: opts.size,
-        checksum: opts.checksum,
-        chunkSize: opts.chunkSize,
-        ownerUid: opts.uid,
-        ownerGid: opts.gid,
-        mode: opts.mode,
-        dirMode: opts.dirMode,
-      };
-
-      const res = await this._fetch(`${this.url}/files/upload/start`, {
-        method: "POST",
-        headers: this.jsonHdrs(),
-        body: JSON.stringify(body),
-      });
-      return this.handleResponse(res);
-    },
-
-    send: async (opts: UploadChunkedSendOptions): Promise<FileProxyResponse<UploadChunkResponse>> => {
-      const headers: Headers = {
-        ...this.hdrs(),
-        "X-Upload-Id": opts.uploadId,
-        "X-Chunk-Index": String(opts.index),
-      };
-      if (opts.checksum) {
-        headers["X-Chunk-Checksum"] = opts.checksum;
-      }
-
-      const res = await this._fetch(`${this.url}/files/upload/chunk`, {
-        method: "POST",
-        headers,
-        body: opts.data,
-      });
-      return this.handleResponse(res);
-    },
-  };
-}
-
-// ============================================================================
-// Client Class
-// ============================================================================
-
-export class Filegate {
-  private readonly url: string;
-  private readonly token: string;
-  private readonly _fetch: typeof fetch;
-
-  readonly upload: UploadClient;
-  readonly thumbnail: ThumbnailClient;
-
-  constructor(opts: ClientOptions) {
-    this.url = opts.url.replace(/\/$/, "");
-    this.token = opts.token;
-    this._fetch = opts.fetch ?? fetch;
-
-    this.upload = new UploadClient(
-      this.url,
-      () => this.hdrs(),
-      () => this.jsonHdrs(),
-      this._fetch,
-      (res) => this.handleResponse(res),
-    );
-
-    this.thumbnail = new ThumbnailClient(this.url, () => this.hdrs(), this._fetch);
-  }
-
-  private hdrs(): Headers {
-    return { Authorization: `Bearer ${this.token}` };
-  }
-
-  private jsonHdrs(): Headers {
-    return { ...this.hdrs(), "Content-Type": "application/json" };
-  }
-
-  private async handleResponse<T>(res: Response): Promise<FileProxyResponse<T>> {
-    if (!res.ok) {
-      const body = (await res.json().catch(() => ({ error: "unknown error" }))) as ApiError;
-      return { ok: false, error: body.error || "unknown error", status: res.status };
-    }
-    const data = (await res.json()) as T;
-    return { ok: true, data };
-  }
-
-  // ==========================================================================
-  // Info
-  // ==========================================================================
-
-  async info(opts: InfoOptions): Promise<FileProxyResponse<FileInfo | DirInfo>> {
-    const params = new URLSearchParams({
-      path: opts.path,
-      showHidden: String(opts.showHidden ?? false),
-    });
-    if (opts.computeSizes) params.set("computeSizes", "true");
-    const res = await this._fetch(`${this.url}/files/info?${params}`, { headers: this.hdrs() });
-    return this.handleResponse(res);
-  }
-
-  // ==========================================================================
-  // Download
-  // ==========================================================================
-
-  async download(opts: DownloadOptions): Promise<FileProxyResponse<Response>> {
-    const params = new URLSearchParams({ path: opts.path });
-    if (opts.inline) params.set("inline", "true");
-    const res = await this._fetch(`${this.url}/files/content?${params}`, { headers: this.hdrs() });
-    if (!res.ok) {
-      const body = (await res.json().catch(() => ({ error: "unknown error" }))) as ApiError;
-      return { ok: false, error: body.error || "unknown error", status: res.status };
-    }
-    return { ok: true, data: res };
-  }
-
-  // ==========================================================================
-  // Directory Operations
-  // ==========================================================================
-
-  async mkdir(opts: MkdirOptions): Promise<FileProxyResponse<FileInfo>> {
-    const body: Record<string, unknown> = { path: opts.path };
-    if (opts.uid !== undefined) body.ownerUid = opts.uid;
-    if (opts.gid !== undefined) body.ownerGid = opts.gid;
-    if (opts.mode) body.mode = opts.mode;
-
-    const res = await this._fetch(`${this.url}/files/mkdir`, {
-      method: "POST",
-      headers: this.jsonHdrs(),
-      body: JSON.stringify(body),
-    });
-    return this.handleResponse(res);
-  }
-
-  // ==========================================================================
-  // Delete
-  // ==========================================================================
-
-  async delete(opts: DeleteOptions): Promise<FileProxyResponse<void>> {
-    const params = new URLSearchParams({ path: opts.path });
-    const res = await this._fetch(`${this.url}/files/delete?${params}`, {
-      method: "DELETE",
-      headers: this.hdrs(),
-    });
-    if (!res.ok) {
-      const body = (await res.json().catch(() => ({ error: "unknown error" }))) as ApiError;
-      return { ok: false, error: body.error || "unknown error", status: res.status };
-    }
-    return { ok: true, data: undefined };
-  }
-
-  // ==========================================================================
-  // Transfer (Move/Copy)
-  // ==========================================================================
-
-  async transfer(opts: TransferOptions): Promise<FileProxyResponse<FileInfo>> {
-    const body: Record<string, unknown> = {
-      from: opts.from,
-      to: opts.to,
-      mode: opts.mode,
-    };
-    if (opts.ensureUniqueName !== undefined) body.ensureUniqueName = opts.ensureUniqueName;
-    if (opts.uid !== undefined) body.ownerUid = opts.uid;
-    if (opts.gid !== undefined) body.ownerGid = opts.gid;
-    if (opts.fileMode) body.fileMode = opts.fileMode;
-    if (opts.dirMode) body.dirMode = opts.dirMode;
-
-    const res = await this._fetch(`${this.url}/files/transfer`, {
-      method: "POST",
-      headers: this.jsonHdrs(),
-      body: JSON.stringify(body),
-    });
-    return this.handleResponse(res);
-  }
-
-  // ==========================================================================
-  // Glob (Search)
-  // ==========================================================================
-
-  async glob(opts: GlobOptions): Promise<FileProxyResponse<SearchResponse>> {
-    const params = new URLSearchParams({
-      paths: opts.paths.join(","),
-      pattern: opts.pattern,
-    });
-    if (opts.showHidden) params.set("showHidden", "true");
-    if (opts.limit) params.set("limit", String(opts.limit));
-    if (opts.files === false) params.set("files", "false");
-    if (opts.directories) params.set("directories", "true");
-
-    const res = await this._fetch(`${this.url}/files/search?${params}`, { headers: this.hdrs() });
-    return this.handleResponse(res);
-  }
-}
-
-// ============================================================================
-// Default Instance (server-side only)
-// ============================================================================
-
-const createDefaultInstance = (): Filegate => {
-  const url = process.env.FILEGATE_URL;
-  const token = process.env.FILEGATE_TOKEN;
-
-  if (!url || !token) {
-    throw new Error(
-      "FILEGATE_URL and FILEGATE_TOKEN environment variables are required.\n" +
-        "Either set these variables or create an instance manually:\n\n" +
-        '  import { Filegate } from "filegate/client";\n' +
-        '  const client = new Filegate({ url: "...", token: "..." });',
-    );
-  }
-
-  return new Filegate({ url, token });
-};
-
-let _instance: Filegate | null = null;
-
-export const filegate: Filegate = new Proxy({} as Filegate, {
-  get(_target, prop) {
-    if (_instance === null) {
-      _instance = createDefaultInstance();
-    }
-    const value = _instance[prop as keyof Filegate];
-    if (typeof value === "function") {
-      return value.bind(_instance);
-    }
-    return value;
-  },
-});

package/src/config.ts

@@ -1,41 +0,0 @@
-const required = (key: string): string => {
-  const value = process.env[key];
-  if (!value) throw new Error(`Missing required env: ${key}`);
-  return value;
-};
-
-const int = (key: string, def: number): number => parseInt(process.env[key] ?? "", 10) || def;
-
-const optionalInt = (key: string): number | undefined => {
-  const v = process.env[key];
-  return v ? parseInt(v, 10) : undefined;
-};
-
-const list = (key: string): string[] =>
-  required(key)
-    .split(",")
-    .map((s) => s.trim())
-    .filter(Boolean);
-
-export const config = {
-  token: required("FILE_PROXY_TOKEN"),
-  allowedPaths: list("ALLOWED_BASE_PATHS"),
-  port: int("PORT", 4000),
-  maxUploadBytes: int("MAX_UPLOAD_MB", 500) * 1024 * 1024,
-  maxDownloadBytes: int("MAX_DOWNLOAD_MB", 5000) * 1024 * 1024,
-  maxChunkBytes: int("MAX_CHUNK_SIZE_MB", 50) * 1024 * 1024,
-  searchMaxResults: int("SEARCH_MAX_RESULTS", 100),
-  searchMaxRecursiveWildcards: int("SEARCH_MAX_RECURSIVE_WILDCARDS", 10),
-  uploadExpirySecs: int("UPLOAD_EXPIRY_HOURS", 24) * 60 * 60,
-  uploadTempDir: process.env.UPLOAD_TEMP_DIR ?? "/tmp/filegate-uploads",
-  diskCleanupIntervalMs: int("DISK_CLEANUP_INTERVAL_HOURS", 6) * 60 * 60 * 1000,
-  indexEnabled: process.env.ENABLE_INDEX !== "false",
-  indexDatabaseUrl: process.env.INDEX_DATABASE_URL ?? "sqlite://:memory:",
-  indexRescanIntervalMs: int("INDEX_RESCAN_INTERVAL_MINUTES", 30) * 60 * 1000,
-  indexScanConcurrency: int("INDEX_SCAN_CONCURRENCY", 4),
-  devUid: optionalInt("DEV_UID_OVERRIDE"),
-  devGid: optionalInt("DEV_GID_OVERRIDE"),
-  get isDev() {
-    return this.devUid !== undefined || this.devGid !== undefined;
-  },
-} as const;