@uplift-io/uplift 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Uplift contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# Uplift
+
+[![npm version](https://img.shields.io/npm/v/@uplift-io/uplift?color=0f766e)](https://www.npmjs.com/package/@uplift-io/uplift)
+[![npm downloads](https://img.shields.io/npm/dm/@uplift-io/uplift?color=2563eb)](https://www.npmjs.com/package/@uplift-io/uplift)
+[![npm downloads total](https://img.shields.io/npm/dt/@uplift-io/uplift?color=7c3aed)](https://www.npmjs.com/package/@uplift-io/uplift)
+[![CI](https://github.com/Itzfeminisce/uplift/actions/workflows/ci.yml/badge.svg)](https://github.com/Itzfeminisce/uplift/actions/workflows/ci.yml)
+[![bundle size](https://img.shields.io/badge/bundle-measured%20locally-14b8a6)](https://github.com/Itzfeminisce/uplift/blob/main/docs/BUNDLE_SIZE.md)
+[![license](https://img.shields.io/npm/l/@uplift-io/uplift)](https://github.com/Itzfeminisce/uplift/blob/main/LICENSE)
+
+Dead-simple, type-safe file uploads for TypeScript applications.
+
+Define upload routes once on the server. Get a typed client on the frontend.
+
+```ts
+await upload.avatar(file);
+await upload.gallery(files);
+```
+
+## Install
+
+Install core plus the adapters you use:
+
+```bash
+pnpm add @uplift-io/uplift @uplift-io/next @uplift-io/s3
+```
+
+## Quick Start
+
+```ts
+import { image, uplift } from "@uplift-io/uplift";
+import { s3 } from "@uplift-io/s3";
+
+export const uploads = uplift({
+  storage: s3({
+    bucket: process.env.S3_BUCKET!,
+    region: "us-east-1",
+    accessKeyId: process.env.S3_ACCESS_KEY_ID!,
+    secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!
+  }),
+  routes: {
+    avatar: image()
+      .max("2mb")
+      .auth(async ({ req }) => ({ id: req.headers.get("x-user-id")! }))
+      .key(({ user }) => `avatars/${user.id}.png`)
+      .done(async ({ file }) => {
+        console.log(file.url);
+      }),
+    gallery: image().max("8mb").multiple(10)
+  }
+});
+
+export type Uploads = typeof uploads;
+```
+
+```ts
+import { createUploadClient } from "@uplift-io/uplift/client";
+import type { Uploads } from "./uploads";
+
+export const upload = createUploadClient<Uploads>("/api/upload");
+
+const avatar = await upload.avatar(file);
+const gallery = await upload.gallery(fileList);
+```
+
+## More
+
+- Full docs: [itzfeminisce.github.io/uplift](https://itzfeminisce.github.io/uplift/)
+- Bundle size report: [docs/BUNDLE_SIZE.md](https://github.com/Itzfeminisce/uplift/blob/main/docs/BUNDLE_SIZE.md)
+- Next local example: [examples/next-local](https://github.com/Itzfeminisce/uplift/tree/main/examples/next-local)
+- GitHub: [github.com/Itzfeminisce/uplift](https://github.com/Itzfeminisce/uplift)
+- License: MIT
+
+## Storage
+
+Uplift publishes S3, R2, Bunny, Cloudinary, local, memory, and UploadThing-compatible adapters as separate packages. The UploadThing adapter accepts a server-side uploader compatible with `UTApi.uploadFiles()` and keeps UploadThing optional:
+
+```ts
+import { uploadthing } from "@uplift-io/uploadthing";
+import { UTApi } from "uploadthing/server";
+
+const utapi = new UTApi();
+const storage = uploadthing({
+  uploader: (file) => utapi.uploadFiles(file)
+});
+```

package/dist/client.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  createUploadClient: () => createUploadClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/types.ts
+var UploadError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "UploadError";
+    this.code = code;
+  }
+  toJSON() {
+    return {
+      message: this.message,
+      code: this.code
+    };
+  }
+};
+
+// src/client.ts
+function createUploadClient(baseUrl, options = {}) {
+  const fetcher = options.fetch ?? fetch;
+  return new Proxy({}, {
+    get(_target, property) {
+      if (typeof property !== "string") return void 0;
+      return async (input) => {
+        const files = input instanceof File ? [input] : Array.from(input);
+        const form = new FormData();
+        const field = files.length === 1 ? "file" : "files";
+        for (const file of files) form.append(field, file);
+        const url = routeUrl(baseUrl, property);
+        if (!options.fetch && typeof XMLHttpRequest !== "undefined") {
+          return uploadWithXhr(url, form, property, options.onProgress);
+        }
+        options.onProgress?.(property, 0);
+        const response = await fetcher(url, { method: "POST", body: form });
+        const body = await response.json();
+        if (!response.ok) {
+          throw new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed.");
+        }
+        options.onProgress?.(property, 100);
+        return body.result;
+      };
+    }
+  });
+}
+function routeUrl(baseUrl, route) {
+  const url = new URL(baseUrl, globalThis.location?.href ?? "http://localhost");
+  url.searchParams.set("route", route);
+  const value = url.toString();
+  return baseUrl.startsWith("/") ? `${url.pathname}${url.search}` : value;
+}
+function uploadWithXhr(url, form, route, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("POST", url);
+    xhr.upload.onprogress = (event) => {
+      if (!event.lengthComputable) return;
+      onProgress?.(route, Math.round(event.loaded / event.total * 100));
+    };
+    xhr.onload = () => {
+      const body = JSON.parse(xhr.responseText || "{}");
+      if (xhr.status < 200 || xhr.status >= 300) {
+        reject(new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed."));
+        return;
+      }
+      onProgress?.(route, 100);
+      resolve(body.result);
+    };
+    xhr.onerror = () => reject(new UploadError("UPLOAD_FAILED", "Upload request failed."));
+    onProgress?.(route, 0);
+    xhr.send(form);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createUploadClient
+});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["import { UploadError, type UpliftApp, type UploadClient } from \"./types\";\r\n\r\nexport type UploadProgressHandler = (progress: number) => void;\r\n\r\nexport function createUploadClient<TApp extends UpliftApp>(\r\n  baseUrl: string,\r\n  options: { fetch?: typeof fetch; onProgress?: (route: string, progress: number) => void } = {}\r\n): UploadClient<TApp> {\r\n  const fetcher = options.fetch ?? fetch;\r\n\r\n  return new Proxy({}, {\r\n    get(_target, property) {\r\n      if (typeof property !== \"string\") return undefined;\r\n      return async (input: File | File[] | FileList) => {\r\n        const files = input instanceof File ? [input] : Array.from(input);\r\n        const form = new FormData();\r\n        const field = files.length === 1 ? \"file\" : \"files\";\r\n        for (const file of files) form.append(field, file);\r\n\r\n        const url = routeUrl(baseUrl, property);\r\n        if (!options.fetch && typeof XMLHttpRequest !== \"undefined\") {\r\n          return uploadWithXhr(url, form, property, options.onProgress);\r\n        }\r\n\r\n        options.onProgress?.(property, 0);\r\n        const response = await fetcher(url, { method: \"POST\", body: form });\r\n        const body = await response.json() as { result?: unknown; error?: { code: string; message: string } };\r\n        if (!response.ok) {\r\n          throw new UploadError((body.error?.code ?? \"UNKNOWN\") as never, body.error?.message ?? \"Upload failed.\");\r\n        }\r\n        options.onProgress?.(property, 100);\r\n        return body.result;\r\n      };\r\n    }\r\n  }) as UploadClient<TApp>;\r\n}\r\n\r\nfunction routeUrl(baseUrl: string, route: string): string {\r\n  const url = new URL(baseUrl, globalThis.location?.href ?? \"http://localhost\");\r\n  url.searchParams.set(\"route\", route);\r\n  const value = url.toString();\r\n  return baseUrl.startsWith(\"/\") ? `${url.pathname}${url.search}` : value;\r\n}\r\n\r\nfunction uploadWithXhr(\r\n  url: string,\r\n  form: FormData,\r\n  route: string,\r\n  onProgress?: (route: string, progress: number) => void\r\n): Promise<unknown> {\r\n  return new Promise((resolve, reject) => {\r\n    const xhr = new XMLHttpRequest();\r\n    xhr.open(\"POST\", url);\r\n    xhr.upload.onprogress = (event) => {\r\n      if (!event.lengthComputable) return;\r\n      onProgress?.(route, Math.round((event.loaded / event.total) * 100));\r\n    };\r\n    xhr.onload = () => {\r\n      const body = JSON.parse(xhr.responseText || \"{}\") as {\r\n        result?: unknown;\r\n        error?: { code: string; message: string };\r\n      };\r\n      if (xhr.status < 200 || xhr.status >= 300) {\r\n        reject(new UploadError((body.error?.code ?? \"UNKNOWN\") as never, body.error?.message ?? \"Upload failed.\"));\r\n        return;\r\n      }\r\n      onProgress?.(route, 100);\r\n      resolve(body.result);\r\n    };\r\n    xhr.onerror = () => reject(new UploadError(\"UPLOAD_FAILED\", \"Upload request failed.\"));\r\n    onProgress?.(route, 0);\r\n    xhr.send(form);\r\n  });\r\n}\r\n","export type SizeValue = `${number}b` | `${number}kb` | `${number}mb` | `${number}gb`;\r\nexport type DurationValue = `${number}s` | `${number}m` | `${number}h`;\r\n\r\nexport type UploadInputFile = {\r\n  name: string;\r\n  type: string;\r\n  size: number;\r\n  extension?: string;\r\n  file?: File;\r\n};\r\n\r\nexport type UploadedFile = {\r\n  url: string;\r\n  key: string;\r\n  name: string;\r\n  type: string;\r\n  size: number;\r\n  extension?: string | undefined;\r\n  provider: string;\r\n};\r\n\r\nexport type UploadErrorCode =\r\n  | \"FILE_TOO_LARGE\"\r\n  | \"FILE_TOO_SMALL\"\r\n  | \"INVALID_TYPE\"\r\n  | \"AUTH_FAILED\"\r\n  | \"VALIDATION_FAILED\"\r\n  | \"UPLOAD_FAILED\"\r\n  | \"UNKNOWN\";\r\n\r\nexport class UploadError extends Error {\r\n  readonly code: UploadErrorCode;\r\n\r\n  constructor(code: UploadErrorCode, message: string) {\r\n    super(message);\r\n    this.name = \"UploadError\";\r\n    this.code = code;\r\n  }\r\n\r\n  toJSON() {\r\n    return {\r\n      message: this.message,\r\n      code: this.code\r\n    };\r\n  }\r\n}\r\n\r\nexport type StandardSchema<T = unknown> = {\r\n  parse(input: unknown): T;\r\n};\r\n\r\nexport type KeyContext<TAuth = unknown, TMeta = unknown> = {\r\n  req: Request;\r\n  file: UploadInputFile;\r\n  user: TAuth;\r\n  meta: TMeta;\r\n};\r\n\r\nexport type DoneContext<\r\n  TAuth = unknown,\r\n  TMeta = unknown,\r\n  TMultiple extends boolean = false\r\n> = TMultiple extends true\r\n  ? { req: Request; files: UploadedFile[]; user: TAuth; meta: TMeta[] }\r\n  : { req: Request; file: UploadedFile; user: TAuth; meta: TMeta };\r\n\r\nexport type StoragePutInput = {\r\n  key: string;\r\n  file: UploadInputFile;\r\n  body: File;\r\n};\r\n\r\nexport type StorageAdapter = {\r\n  provider: string;\r\n  put(input: StoragePutInput): Promise<UploadedFile>;\r\n};\r\n\r\nexport type Middleware<TUser = unknown> = (ctx: { req: Request }) => TUser | Promise<TUser>;\r\n\r\nexport type UploadKind =\r\n  | \"any\"\r\n  | \"image\"\r\n  | \"pdf\"\r\n  | \"video\"\r\n  | \"audio\"\r\n  | \"text\"\r\n  | \"json\"\r\n  | \"csv\"\r\n  | \"custom\";\r\n\r\nexport type UploadRouteDefinition = {\r\n  kind: UploadKind;\r\n  maxBytes?: number;\r\n  minBytes?: number;\r\n  multiple: boolean;\r\n  multipleLimit?: number;\r\n  auth?: Middleware<unknown>;\r\n  overrideAuth: boolean;\r\n  key?: (ctx: KeyContext<unknown, unknown>) => string | Promise<string>;\r\n  meta?: (ctx: { req: Request; file: UploadInputFile; user: unknown }) => unknown | Promise<unknown>;\r\n  validate?: (ctx: {\r\n    req: Request;\r\n    file: UploadInputFile;\r\n    user: unknown;\r\n    meta: unknown;\r\n  }) => true | string | Promise<true | string>;\r\n  done?: (ctx: DoneContext<unknown, unknown, boolean>) => void | Promise<void>;\r\n  extensions?: string[];\r\n  mimeTypes?: string[];\r\n  dimensionRule?: { minWidth?: number; minHeight?: number; maxWidth?: number; maxHeight?: number };\r\n  requireSquare?: boolean;\r\n  aspectRatio?: `${number}:${number}`;\r\n  encoding?: \"utf-8\" | \"utf-16\" | \"ascii\";\r\n  schema?: StandardSchema;\r\n  headers?: string[];\r\n  delimiter?: \",\" | \";\" | \"\\t\" | \"|\";\r\n  pageRule?: { min?: number; max?: number };\r\n  encrypted?: boolean;\r\n  durationRule?: { min?: DurationValue; max?: DurationValue };\r\n};\r\n\r\nexport type UploadRoutes = Record<string, { _def: UploadRouteDefinition }>;\r\n\r\nexport type UpliftApp<TRoutes extends UploadRoutes = UploadRoutes> = {\r\n  storage: StorageAdapter;\r\n  routes: TRoutes;\r\n  middleware?: Middleware<unknown> | undefined;\r\n  onUploadComplete?: ((ctx: {\r\n    route: keyof TRoutes & string;\r\n    result: UploadedFile | UploadedFile[];\r\n    user: unknown;\r\n  }) => void | Promise<void>) | undefined;\r\n};\r\n\r\nexport type IsMultiple<TRoute> = TRoute extends { __multiple?: infer TMultiple }\r\n  ? TMultiple extends true\r\n    ? true\r\n    : false\r\n  : false;\r\n\r\nexport type ClientInput<TRoute> = IsMultiple<TRoute> extends true ? File[] | FileList : File;\r\nexport type ClientOutput<TRoute> = IsMultiple<TRoute> extends true ? UploadedFile[] : UploadedFile;\r\n\r\nexport type UploadClient<TApp extends UpliftApp> = {\r\n  [TRouteName in keyof TApp[\"routes\"] & string]: (\r\n    input: ClientInput<TApp[\"routes\"][TRouteName]>\r\n  ) => Promise<ClientOutput<TApp[\"routes\"][TRouteName]>>;\r\n};\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC8BO,IAAM,cAAN,cAA0B,MAAM;AAAA,EAC5B;AAAA,EAET,YAAY,MAAuB,SAAiB;AAClD,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,IACb;AAAA,EACF;AACF;;;ADzCO,SAAS,mBACd,SACA,UAA4F,CAAC,GACzE;AACpB,QAAM,UAAU,QAAQ,SAAS;AAEjC,SAAO,IAAI,MAAM,CAAC,GAAG;AAAA,IACnB,IAAI,SAAS,UAAU;AACrB,UAAI,OAAO,aAAa,SAAU,QAAO;AACzC,aAAO,OAAO,UAAoC;AAChD,cAAM,QAAQ,iBAAiB,OAAO,CAAC,KAAK,IAAI,MAAM,KAAK,KAAK;AAChE,cAAM,OAAO,IAAI,SAAS;AAC1B,cAAM,QAAQ,MAAM,WAAW,IAAI,SAAS;AAC5C,mBAAW,QAAQ,MAAO,MAAK,OAAO,OAAO,IAAI;AAEjD,cAAM,MAAM,SAAS,SAAS,QAAQ;AACtC,YAAI,CAAC,QAAQ,SAAS,OAAO,mBAAmB,aAAa;AAC3D,iBAAO,cAAc,KAAK,MAAM,UAAU,QAAQ,UAAU;AAAA,QAC9D;AAEA,gBAAQ,aAAa,UAAU,CAAC;AAChC,cAAM,WAAW,MAAM,QAAQ,KAAK,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC;AAClE,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAI,CAAC,SAAS,IAAI;AAChB,gBAAM,IAAI,YAAa,KAAK,OAAO,QAAQ,WAAqB,KAAK,OAAO,WAAW,gBAAgB;AAAA,QACzG;AACA,gBAAQ,aAAa,UAAU,GAAG;AAClC,eAAO,KAAK;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,SAAS,SAAiB,OAAuB;AACxD,QAAM,MAAM,IAAI,IAAI,SAAS,WAAW,UAAU,QAAQ,kBAAkB;AAC5E,MAAI,aAAa,IAAI,SAAS,KAAK;AACnC,QAAM,QAAQ,IAAI,SAAS;AAC3B,SAAO,QAAQ,WAAW,GAAG,IAAI,GAAG,IAAI,QAAQ,GAAG,IAAI,MAAM,KAAK;AACpE;AAEA,SAAS,cACP,KACA,MACA,OACA,YACkB;AAClB,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,MAAM,IAAI,eAAe;AAC/B,QAAI,KAAK,QAAQ,GAAG;AACpB,QAAI,OAAO,aAAa,CAAC,UAAU;AACjC,UAAI,CAAC,MAAM,iBAAkB;AAC7B,mBAAa,OAAO,KAAK,MAAO,MAAM,SAAS,MAAM,QAAS,GAAG,CAAC;AAAA,IACpE;AACA,QAAI,SAAS,MAAM;AACjB,YAAM,OAAO,KAAK,MAAM,IAAI,gBAAgB,IAAI;AAIhD,UAAI,IAAI,SAAS,OAAO,IAAI,UAAU,KAAK;AACzC,eAAO,IAAI,YAAa,KAAK,OAAO,QAAQ,WAAqB,KAAK,OAAO,WAAW,gBAAgB,CAAC;AACzG;AAAA,MACF;AACA,mBAAa,OAAO,GAAG;AACvB,cAAQ,KAAK,MAAM;AAAA,IACrB;AACA,QAAI,UAAU,MAAM,OAAO,IAAI,YAAY,iBAAiB,wBAAwB,CAAC;AACrF,iBAAa,OAAO,CAAC;AACrB,QAAI,KAAK,IAAI;AAAA,EACf,CAAC;AACH;","names":[]}

package/dist/client.d.cts

@@ -0,0 +1,9 @@
+import { g as UpliftApp, j as UploadClient } from './types-BdcszAj8.cjs';
+
+type UploadProgressHandler = (progress: number) => void;
+declare function createUploadClient<TApp extends UpliftApp>(baseUrl: string, options?: {
+    fetch?: typeof fetch;
+    onProgress?: (route: string, progress: number) => void;
+}): UploadClient<TApp>;
+
+export { type UploadProgressHandler, createUploadClient };

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+import { g as UpliftApp, j as UploadClient } from './types-BdcszAj8.js';
+
+type UploadProgressHandler = (progress: number) => void;
+declare function createUploadClient<TApp extends UpliftApp>(baseUrl: string, options?: {
+    fetch?: typeof fetch;
+    onProgress?: (route: string, progress: number) => void;
+}): UploadClient<TApp>;
+
+export { type UploadProgressHandler, createUploadClient };

package/dist/client.js

@@ -0,0 +1,75 @@
+// src/types.ts
+var UploadError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "UploadError";
+    this.code = code;
+  }
+  toJSON() {
+    return {
+      message: this.message,
+      code: this.code
+    };
+  }
+};
+
+// src/client.ts
+function createUploadClient(baseUrl, options = {}) {
+  const fetcher = options.fetch ?? fetch;
+  return new Proxy({}, {
+    get(_target, property) {
+      if (typeof property !== "string") return void 0;
+      return async (input) => {
+        const files = input instanceof File ? [input] : Array.from(input);
+        const form = new FormData();
+        const field = files.length === 1 ? "file" : "files";
+        for (const file of files) form.append(field, file);
+        const url = routeUrl(baseUrl, property);
+        if (!options.fetch && typeof XMLHttpRequest !== "undefined") {
+          return uploadWithXhr(url, form, property, options.onProgress);
+        }
+        options.onProgress?.(property, 0);
+        const response = await fetcher(url, { method: "POST", body: form });
+        const body = await response.json();
+        if (!response.ok) {
+          throw new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed.");
+        }
+        options.onProgress?.(property, 100);
+        return body.result;
+      };
+    }
+  });
+}
+function routeUrl(baseUrl, route) {
+  const url = new URL(baseUrl, globalThis.location?.href ?? "http://localhost");
+  url.searchParams.set("route", route);
+  const value = url.toString();
+  return baseUrl.startsWith("/") ? `${url.pathname}${url.search}` : value;
+}
+function uploadWithXhr(url, form, route, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("POST", url);
+    xhr.upload.onprogress = (event) => {
+      if (!event.lengthComputable) return;
+      onProgress?.(route, Math.round(event.loaded / event.total * 100));
+    };
+    xhr.onload = () => {
+      const body = JSON.parse(xhr.responseText || "{}");
+      if (xhr.status < 200 || xhr.status >= 300) {
+        reject(new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed."));
+        return;
+      }
+      onProgress?.(route, 100);
+      resolve(body.result);
+    };
+    xhr.onerror = () => reject(new UploadError("UPLOAD_FAILED", "Upload request failed."));
+    onProgress?.(route, 0);
+    xhr.send(form);
+  });
+}
+export {
+  createUploadClient
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts"],"sourcesContent":["export type SizeValue = `${number}b` | `${number}kb` | `${number}mb` | `${number}gb`;\r\nexport type DurationValue = `${number}s` | `${number}m` | `${number}h`;\r\n\r\nexport type UploadInputFile = {\r\n  name: string;\r\n  type: string;\r\n  size: number;\r\n  extension?: string;\r\n  file?: File;\r\n};\r\n\r\nexport type UploadedFile = {\r\n  url: string;\r\n  key: string;\r\n  name: string;\r\n  type: string;\r\n  size: number;\r\n  extension?: string | undefined;\r\n  provider: string;\r\n};\r\n\r\nexport type UploadErrorCode =\r\n  | \"FILE_TOO_LARGE\"\r\n  | \"FILE_TOO_SMALL\"\r\n  | \"INVALID_TYPE\"\r\n  | \"AUTH_FAILED\"\r\n  | \"VALIDATION_FAILED\"\r\n  | \"UPLOAD_FAILED\"\r\n  | \"UNKNOWN\";\r\n\r\nexport class UploadError extends Error {\r\n  readonly code: UploadErrorCode;\r\n\r\n  constructor(code: UploadErrorCode, message: string) {\r\n    super(message);\r\n    this.name = \"UploadError\";\r\n    this.code = code;\r\n  }\r\n\r\n  toJSON() {\r\n    return {\r\n      message: this.message,\r\n      code: this.code\r\n    };\r\n  }\r\n}\r\n\r\nexport type StandardSchema<T = unknown> = {\r\n  parse(input: unknown): T;\r\n};\r\n\r\nexport type KeyContext<TAuth = unknown, TMeta = unknown> = {\r\n  req: Request;\r\n  file: UploadInputFile;\r\n  user: TAuth;\r\n  meta: TMeta;\r\n};\r\n\r\nexport type DoneContext<\r\n  TAuth = unknown,\r\n  TMeta = unknown,\r\n  TMultiple extends boolean = false\r\n> = TMultiple extends true\r\n  ? { req: Request; files: UploadedFile[]; user: TAuth; meta: TMeta[] }\r\n  : { req: Request; file: UploadedFile; user: TAuth; meta: TMeta };\r\n\r\nexport type StoragePutInput = {\r\n  key: string;\r\n  file: UploadInputFile;\r\n  body: File;\r\n};\r\n\r\nexport type StorageAdapter = {\r\n  provider: string;\r\n  put(input: StoragePutInput): Promise<UploadedFile>;\r\n};\r\n\r\nexport type Middleware<TUser = unknown> = (ctx: { req: Request }) => TUser | Promise<TUser>;\r\n\r\nexport type UploadKind =\r\n  | \"any\"\r\n  | \"image\"\r\n  | \"pdf\"\r\n  | \"video\"\r\n  | \"audio\"\r\n  | \"text\"\r\n  | \"json\"\r\n  | \"csv\"\r\n  | \"custom\";\r\n\r\nexport type UploadRouteDefinition = {\r\n  kind: UploadKind;\r\n  maxBytes?: number;\r\n  minBytes?: number;\r\n  multiple: boolean;\r\n  multipleLimit?: number;\r\n  auth?: Middleware<unknown>;\r\n  overrideAuth: boolean;\r\n  key?: (ctx: KeyContext<unknown, unknown>) => string | Promise<string>;\r\n  meta?: (ctx: { req: Request; file: UploadInputFile; user: unknown }) => unknown | Promise<unknown>;\r\n  validate?: (ctx: {\r\n    req: Request;\r\n    file: UploadInputFile;\r\n    user: unknown;\r\n    meta: unknown;\r\n  }) => true | string | Promise<true | string>;\r\n  done?: (ctx: DoneContext<unknown, unknown, boolean>) => void | Promise<void>;\r\n  extensions?: string[];\r\n  mimeTypes?: string[];\r\n  dimensionRule?: { minWidth?: number; minHeight?: number; maxWidth?: number; maxHeight?: number };\r\n  requireSquare?: boolean;\r\n  aspectRatio?: `${number}:${number}`;\r\n  encoding?: \"utf-8\" | \"utf-16\" | \"ascii\";\r\n  schema?: StandardSchema;\r\n  headers?: string[];\r\n  delimiter?: \",\" | \";\" | \"\\t\" | \"|\";\r\n  pageRule?: { min?: number; max?: number };\r\n  encrypted?: boolean;\r\n  durationRule?: { min?: DurationValue; max?: DurationValue };\r\n};\r\n\r\nexport type UploadRoutes = Record<string, { _def: UploadRouteDefinition }>;\r\n\r\nexport type UpliftApp<TRoutes extends UploadRoutes = UploadRoutes> = {\r\n  storage: StorageAdapter;\r\n  routes: TRoutes;\r\n  middleware?: Middleware<unknown> | undefined;\r\n  onUploadComplete?: ((ctx: {\r\n    route: keyof TRoutes & string;\r\n    result: UploadedFile | UploadedFile[];\r\n    user: unknown;\r\n  }) => void | Promise<void>) | undefined;\r\n};\r\n\r\nexport type IsMultiple<TRoute> = TRoute extends { __multiple?: infer TMultiple }\r\n  ? TMultiple extends true\r\n    ? true\r\n    : false\r\n  : false;\r\n\r\nexport type ClientInput<TRoute> = IsMultiple<TRoute> extends true ? File[] | FileList : File;\r\nexport type ClientOutput<TRoute> = IsMultiple<TRoute> extends true ? UploadedFile[] : UploadedFile;\r\n\r\nexport type UploadClient<TApp extends UpliftApp> = {\r\n  [TRouteName in keyof TApp[\"routes\"] & string]: (\r\n    input: ClientInput<TApp[\"routes\"][TRouteName]>\r\n  ) => Promise<ClientOutput<TApp[\"routes\"][TRouteName]>>;\r\n};\r\n","import { UploadError, type UpliftApp, type UploadClient } from \"./types\";\r\n\r\nexport type UploadProgressHandler = (progress: number) => void;\r\n\r\nexport function createUploadClient<TApp extends UpliftApp>(\r\n  baseUrl: string,\r\n  options: { fetch?: typeof fetch; onProgress?: (route: string, progress: number) => void } = {}\r\n): UploadClient<TApp> {\r\n  const fetcher = options.fetch ?? fetch;\r\n\r\n  return new Proxy({}, {\r\n    get(_target, property) {\r\n      if (typeof property !== \"string\") return undefined;\r\n      return async (input: File | File[] | FileList) => {\r\n        const files = input instanceof File ? [input] : Array.from(input);\r\n        const form = new FormData();\r\n        const field = files.length === 1 ? \"file\" : \"files\";\r\n        for (const file of files) form.append(field, file);\r\n\r\n        const url = routeUrl(baseUrl, property);\r\n        if (!options.fetch && typeof XMLHttpRequest !== \"undefined\") {\r\n          return uploadWithXhr(url, form, property, options.onProgress);\r\n        }\r\n\r\n        options.onProgress?.(property, 0);\r\n        const response = await fetcher(url, { method: \"POST\", body: form });\r\n        const body = await response.json() as { result?: unknown; error?: { code: string; message: string } };\r\n        if (!response.ok) {\r\n          throw new UploadError((body.error?.code ?? \"UNKNOWN\") as never, body.error?.message ?? \"Upload failed.\");\r\n        }\r\n        options.onProgress?.(property, 100);\r\n        return body.result;\r\n      };\r\n    }\r\n  }) as UploadClient<TApp>;\r\n}\r\n\r\nfunction routeUrl(baseUrl: string, route: string): string {\r\n  const url = new URL(baseUrl, globalThis.location?.href ?? \"http://localhost\");\r\n  url.searchParams.set(\"route\", route);\r\n  const value = url.toString();\r\n  return baseUrl.startsWith(\"/\") ? `${url.pathname}${url.search}` : value;\r\n}\r\n\r\nfunction uploadWithXhr(\r\n  url: string,\r\n  form: FormData,\r\n  route: string,\r\n  onProgress?: (route: string, progress: number) => void\r\n): Promise<unknown> {\r\n  return new Promise((resolve, reject) => {\r\n    const xhr = new XMLHttpRequest();\r\n    xhr.open(\"POST\", url);\r\n    xhr.upload.onprogress = (event) => {\r\n      if (!event.lengthComputable) return;\r\n      onProgress?.(route, Math.round((event.loaded / event.total) * 100));\r\n    };\r\n    xhr.onload = () => {\r\n      const body = JSON.parse(xhr.responseText || \"{}\") as {\r\n        result?: unknown;\r\n        error?: { code: string; message: string };\r\n      };\r\n      if (xhr.status < 200 || xhr.status >= 300) {\r\n        reject(new UploadError((body.error?.code ?? \"UNKNOWN\") as never, body.error?.message ?? \"Upload failed.\"));\r\n        return;\r\n      }\r\n      onProgress?.(route, 100);\r\n      resolve(body.result);\r\n    };\r\n    xhr.onerror = () => reject(new UploadError(\"UPLOAD_FAILED\", \"Upload request failed.\"));\r\n    onProgress?.(route, 0);\r\n    xhr.send(form);\r\n  });\r\n}\r\n"],"mappings":";AA8BO,IAAM,cAAN,cAA0B,MAAM;AAAA,EAC5B;AAAA,EAET,YAAY,MAAuB,SAAiB;AAClD,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,IACb;AAAA,EACF;AACF;;;ACzCO,SAAS,mBACd,SACA,UAA4F,CAAC,GACzE;AACpB,QAAM,UAAU,QAAQ,SAAS;AAEjC,SAAO,IAAI,MAAM,CAAC,GAAG;AAAA,IACnB,IAAI,SAAS,UAAU;AACrB,UAAI,OAAO,aAAa,SAAU,QAAO;AACzC,aAAO,OAAO,UAAoC;AAChD,cAAM,QAAQ,iBAAiB,OAAO,CAAC,KAAK,IAAI,MAAM,KAAK,KAAK;AAChE,cAAM,OAAO,IAAI,SAAS;AAC1B,cAAM,QAAQ,MAAM,WAAW,IAAI,SAAS;AAC5C,mBAAW,QAAQ,MAAO,MAAK,OAAO,OAAO,IAAI;AAEjD,cAAM,MAAM,SAAS,SAAS,QAAQ;AACtC,YAAI,CAAC,QAAQ,SAAS,OAAO,mBAAmB,aAAa;AAC3D,iBAAO,cAAc,KAAK,MAAM,UAAU,QAAQ,UAAU;AAAA,QAC9D;AAEA,gBAAQ,aAAa,UAAU,CAAC;AAChC,cAAM,WAAW,MAAM,QAAQ,KAAK,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC;AAClE,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,YAAI,CAAC,SAAS,IAAI;AAChB,gBAAM,IAAI,YAAa,KAAK,OAAO,QAAQ,WAAqB,KAAK,OAAO,WAAW,gBAAgB;AAAA,QACzG;AACA,gBAAQ,aAAa,UAAU,GAAG;AAClC,eAAO,KAAK;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,SAAS,SAAiB,OAAuB;AACxD,QAAM,MAAM,IAAI,IAAI,SAAS,WAAW,UAAU,QAAQ,kBAAkB;AAC5E,MAAI,aAAa,IAAI,SAAS,KAAK;AACnC,QAAM,QAAQ,IAAI,SAAS;AAC3B,SAAO,QAAQ,WAAW,GAAG,IAAI,GAAG,IAAI,QAAQ,GAAG,IAAI,MAAM,KAAK;AACpE;AAEA,SAAS,cACP,KACA,MACA,OACA,YACkB;AAClB,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,MAAM,IAAI,eAAe;AAC/B,QAAI,KAAK,QAAQ,GAAG;AACpB,QAAI,OAAO,aAAa,CAAC,UAAU;AACjC,UAAI,CAAC,MAAM,iBAAkB;AAC7B,mBAAa,OAAO,KAAK,MAAO,MAAM,SAAS,MAAM,QAAS,GAAG,CAAC;AAAA,IACpE;AACA,QAAI,SAAS,MAAM;AACjB,YAAM,OAAO,KAAK,MAAM,IAAI,gBAAgB,IAAI;AAIhD,UAAI,IAAI,SAAS,OAAO,IAAI,UAAU,KAAK;AACzC,eAAO,IAAI,YAAa,KAAK,OAAO,QAAQ,WAAqB,KAAK,OAAO,WAAW,gBAAgB,CAAC;AACzG;AAAA,MACF;AACA,mBAAa,OAAO,GAAG;AACvB,cAAQ,KAAK,MAAM;AAAA,IACrB;AACA,QAAI,UAAU,MAAM,OAAO,IAAI,YAAY,iBAAiB,wBAAwB,CAAC;AACrF,iBAAa,OAAO,CAAC;AACrB,QAAI,KAAK,IAAI;AAAA,EACf,CAAC;AACH;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,275 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  UploadBuilder: () => UploadBuilder,
+  UploadError: () => UploadError,
+  any: () => any,
+  audio: () => audio,
+  createUploadClient: () => createUploadClient,
+  csv: () => csv,
+  custom: () => custom,
+  image: () => image,
+  json: () => json,
+  pdf: () => pdf,
+  text: () => text,
+  uplift: () => uplift,
+  video: () => video
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var UploadError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "UploadError";
+    this.code = code;
+  }
+  toJSON() {
+    return {
+      message: this.message,
+      code: this.code
+    };
+  }
+};
+
+// src/utils.ts
+var sizeUnits = {
+  b: 1,
+  kb: 1024,
+  mb: 1024 * 1024,
+  gb: 1024 * 1024 * 1024
+};
+function parseSize(value) {
+  const match = /^(\d+(?:\.\d+)?)(b|kb|mb|gb)$/.exec(value);
+  if (!match) throw new UploadError("VALIDATION_FAILED", `Invalid size value: ${value}`);
+  const amount = Number(match[1]);
+  const unit = match[2];
+  return Math.floor(amount * sizeUnits[unit]);
+}
+
+// src/builder.ts
+var UploadBuilder = class {
+  __auth;
+  __meta;
+  __multiple;
+  __kind;
+  _def;
+  constructor(kind, mimeTypes = [], extensions = []) {
+    this._def = {
+      kind,
+      multiple: false,
+      overrideAuth: false
+    };
+    if (mimeTypes.length > 0) this._def.mimeTypes = mimeTypes;
+    if (extensions.length > 0) this._def.extensions = extensions;
+  }
+  max(size) {
+    this._def.maxBytes = parseSize(size);
+    return this;
+  }
+  min(size) {
+    this._def.minBytes = parseSize(size);
+    return this;
+  }
+  multiple(count) {
+    this._def.multiple = true;
+    if (count !== void 0) this._def.multipleLimit = count;
+    return this;
+  }
+  auth(handler) {
+    this._def.auth = handler;
+    this._def.overrideAuth = false;
+    return this;
+  }
+  overrideAuth() {
+    this._def.overrideAuth = true;
+    delete this._def.auth;
+    return this;
+  }
+  key(handler) {
+    this._def.key = handler;
+    return this;
+  }
+  meta(handler) {
+    this._def.meta = handler;
+    return this;
+  }
+  validate(handler) {
+    this._def.validate = handler;
+    return this;
+  }
+  done(handler) {
+    this._def.done = handler;
+    return this;
+  }
+  types(types) {
+    this._def.extensions = types.map((type) => type.toLowerCase());
+    return this;
+  }
+  dimensions(rule) {
+    this._def.dimensionRule = rule;
+    return this;
+  }
+  square() {
+    this._def.requireSquare = true;
+    return this;
+  }
+  aspectRatio(value) {
+    this._def.aspectRatio = value;
+    return this;
+  }
+  encoding(value) {
+    this._def.encoding = value;
+    return this;
+  }
+  schema(schema) {
+    this._def.schema = schema;
+    return this;
+  }
+  headers(headers) {
+    this._def.headers = headers;
+    return this;
+  }
+  delimiter(value) {
+    this._def.delimiter = value;
+    return this;
+  }
+  pages(rule) {
+    this._def.pageRule = rule;
+    return this;
+  }
+  encrypted(value) {
+    this._def.encrypted = value;
+    return this;
+  }
+  duration(rule) {
+    this._def.durationRule = rule;
+    return this;
+  }
+};
+function any() {
+  return new UploadBuilder("any");
+}
+function image() {
+  return new UploadBuilder("image", ["image/"], ["png", "jpg", "jpeg", "webp", "gif", "avif"]);
+}
+function pdf() {
+  return new UploadBuilder("pdf", ["application/pdf"], ["pdf"]);
+}
+function video() {
+  return new UploadBuilder("video", ["video/"], ["mp4", "webm", "mov", "avi", "mkv"]);
+}
+function audio() {
+  return new UploadBuilder("audio", ["audio/"], ["mp3", "wav", "ogg", "m4a", "aac", "flac"]);
+}
+function text() {
+  return new UploadBuilder("text", ["text/"], ["txt", "md", "log"]);
+}
+function json() {
+  return new UploadBuilder("json", ["application/json"], ["json"]);
+}
+function csv() {
+  return new UploadBuilder("csv", ["text/csv"], ["csv"]);
+}
+function custom(type) {
+  const mimeTypes = Array.isArray(type) ? type : [type];
+  return new UploadBuilder("custom", mimeTypes);
+}
+
+// src/client.ts
+function createUploadClient(baseUrl, options = {}) {
+  const fetcher = options.fetch ?? fetch;
+  return new Proxy({}, {
+    get(_target, property) {
+      if (typeof property !== "string") return void 0;
+      return async (input) => {
+        const files = input instanceof File ? [input] : Array.from(input);
+        const form = new FormData();
+        const field = files.length === 1 ? "file" : "files";
+        for (const file of files) form.append(field, file);
+        const url = routeUrl(baseUrl, property);
+        if (!options.fetch && typeof XMLHttpRequest !== "undefined") {
+          return uploadWithXhr(url, form, property, options.onProgress);
+        }
+        options.onProgress?.(property, 0);
+        const response = await fetcher(url, { method: "POST", body: form });
+        const body = await response.json();
+        if (!response.ok) {
+          throw new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed.");
+        }
+        options.onProgress?.(property, 100);
+        return body.result;
+      };
+    }
+  });
+}
+function routeUrl(baseUrl, route) {
+  const url = new URL(baseUrl, globalThis.location?.href ?? "http://localhost");
+  url.searchParams.set("route", route);
+  const value = url.toString();
+  return baseUrl.startsWith("/") ? `${url.pathname}${url.search}` : value;
+}
+function uploadWithXhr(url, form, route, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("POST", url);
+    xhr.upload.onprogress = (event) => {
+      if (!event.lengthComputable) return;
+      onProgress?.(route, Math.round(event.loaded / event.total * 100));
+    };
+    xhr.onload = () => {
+      const body = JSON.parse(xhr.responseText || "{}");
+      if (xhr.status < 200 || xhr.status >= 300) {
+        reject(new UploadError(body.error?.code ?? "UNKNOWN", body.error?.message ?? "Upload failed."));
+        return;
+      }
+      onProgress?.(route, 100);
+      resolve(body.result);
+    };
+    xhr.onerror = () => reject(new UploadError("UPLOAD_FAILED", "Upload request failed."));
+    onProgress?.(route, 0);
+    xhr.send(form);
+  });
+}
+
+// src/index.ts
+function uplift(config) {
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UploadBuilder,
+  UploadError,
+  any,
+  audio,
+  createUploadClient,
+  csv,
+  custom,
+  image,
+  json,
+  pdf,
+  text,
+  uplift,
+  video
+});
+//# sourceMappingURL=index.cjs.map