@uplift-io/uplift 1.0.0

package/dist/server.js

@@ -0,0 +1,216 @@
+// 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 extensionFor(name) {
+  const index = name.lastIndexOf(".");
+  if (index < 0 || index === name.length - 1) return void 0;
+  return name.slice(index + 1).toLowerCase();
+}
+function toInputFile(file) {
+  const extension = extensionFor(file.name);
+  const input = {
+    name: file.name,
+    type: file.type,
+    size: file.size,
+    file
+  };
+  if (extension) input.extension = extension;
+  return input;
+}
+function defaultKey(file) {
+  const random = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;
+  return `${random}/${file.name}`;
+}
+async function readJsonFile(file) {
+  try {
+    return JSON.parse(await file.text());
+  } catch {
+    throw new UploadError("VALIDATION_FAILED", "Invalid JSON file.");
+  }
+}
+
+// src/server.ts
+async function handleUploadRequest(app, req) {
+  try {
+    if (req.method !== "POST") {
+      return json({ error: new UploadError("VALIDATION_FAILED", "Only POST upload requests are supported.") }, 405);
+    }
+    const routeName = routeNameFromRequest(req);
+    const route = app.routes[routeName];
+    if (!route) throw new UploadError("VALIDATION_FAILED", `Unknown upload route: ${routeName}`);
+    const user = await resolveUser(app, route._def, req);
+    const files = await filesFromRequest(req);
+    if (files.length === 0) throw new UploadError("VALIDATION_FAILED", "No files were uploaded.");
+    if (!route._def.multiple && files.length !== 1) {
+      throw new UploadError("VALIDATION_FAILED", "This route accepts exactly one file.");
+    }
+    if (route._def.multipleLimit !== void 0 && files.length > route._def.multipleLimit) {
+      throw new UploadError("VALIDATION_FAILED", `This route accepts at most ${route._def.multipleLimit} files.`);
+    }
+    const stored = [];
+    for (const item of files) {
+      const meta = await deriveMeta(route._def, req, item.input, user);
+      await validateFile(route._def, req, item, user, meta);
+      const key = route._def.key ? await route._def.key({ req, file: item.input, user, meta }) : defaultKey(item.input);
+      assertSafeStorageKey(key);
+      stored.push({
+        file: await app.storage.put({ key, file: item.input, body: item.body }),
+        meta
+      });
+    }
+    const uploaded = stored.map((item) => item.file);
+    const metas = stored.map((item) => item.meta);
+    const firstUpload = uploaded[0];
+    if (!firstUpload) throw new UploadError("UPLOAD_FAILED", "Upload did not produce a result.");
+    const result = route._def.multiple ? uploaded : firstUpload;
+    if (route._def.done) {
+      if (route._def.multiple) {
+        await route._def.done({ req, files: uploaded, user, meta: metas });
+      } else {
+        await route._def.done({ req, file: firstUpload, user, meta: metas[0] });
+      }
+    }
+    if (app.onUploadComplete) await app.onUploadComplete({ route: routeName, result, user });
+    return json({ result }, 200);
+  } catch (error) {
+    const uploadError = normalizeError(error);
+    return json({ error: uploadError }, statusFor(uploadError));
+  }
+}
+function assertSafeStorageKey(key) {
+  if (key.length === 0) {
+    throw new UploadError("VALIDATION_FAILED", "Storage key cannot be empty.");
+  }
+  if (key.includes("\0") || key.includes("\\") || key.includes("://") || key.split("/").includes("..") || /^([a-zA-Z]:)?\//.test(key)) {
+    throw new UploadError("VALIDATION_FAILED", "Storage key must be a relative object key.");
+  }
+}
+function routeNameFromRequest(req) {
+  const url = new URL(req.url);
+  const explicit = url.searchParams.get("route");
+  if (explicit) return explicit;
+  const parts = url.pathname.split("/").filter(Boolean);
+  return parts[parts.length - 1] ?? "";
+}
+async function resolveUser(app, route, req) {
+  if (route.overrideAuth) return void 0;
+  const middleware = route.auth ?? app.middleware;
+  if (!middleware) return void 0;
+  try {
+    return await middleware({ req });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Authentication failed.";
+    throw new UploadError("AUTH_FAILED", message);
+  }
+}
+async function filesFromRequest(req) {
+  const contentType = req.headers.get("content-type") ?? "";
+  if (!contentType.includes("multipart/form-data")) {
+    throw new UploadError("VALIDATION_FAILED", "Upload requests must be multipart/form-data.");
+  }
+  try {
+    const form = await req.formData();
+    const files = [];
+    for (const value of form.values()) {
+      if (!(value instanceof File)) continue;
+      files.push({ input: toInputFile(value), body: value });
+    }
+    return files;
+  } catch (error) {
+    if (error instanceof UploadError) throw error;
+    const message = error instanceof Error ? error.message : "Upload request body could not be parsed.";
+    throw new UploadError("VALIDATION_FAILED", message);
+  }
+}
+async function deriveMeta(route, req, file, user) {
+  if (!route.meta) return void 0;
+  return route.meta({ req, file, user });
+}
+async function validateFile(route, req, item, user, meta) {
+  if (route.maxBytes !== void 0 && item.input.size > route.maxBytes) {
+    throw new UploadError("FILE_TOO_LARGE", "File is larger than the route allows.");
+  }
+  if (route.minBytes !== void 0 && item.input.size < route.minBytes) {
+    throw new UploadError("FILE_TOO_SMALL", "File is smaller than the route allows.");
+  }
+  if (route.kind !== "any" && route.extensions && item.input.extension && !route.extensions.includes(item.input.extension)) {
+    throw new UploadError("INVALID_TYPE", "File type is not allowed.");
+  }
+  if (route.kind !== "any" && route.mimeTypes && route.mimeTypes.length > 0) {
+    const matches = route.mimeTypes.some((mime) => mime.endsWith("/") ? item.input.type.startsWith(mime) : item.input.type === mime);
+    if (!matches) throw new UploadError("INVALID_TYPE", "File MIME type is not allowed.");
+  }
+  if (route.schema) {
+    try {
+      route.schema.parse(await readJsonFile(item.body));
+    } catch (error) {
+      if (error instanceof UploadError) throw error;
+      const message = error instanceof Error ? error.message : "Schema validation failed.";
+      throw new UploadError("VALIDATION_FAILED", message);
+    }
+  }
+  await validateConfiguredInspection(route, item.body);
+  if (route.validate) {
+    const result = await route.validate({ req, file: item.input, user, meta });
+    if (result !== true) throw new UploadError("VALIDATION_FAILED", result);
+  }
+}
+async function validateConfiguredInspection(route, file) {
+  if (route.dimensionRule || route.requireSquare || route.aspectRatio) {
+    throw new UploadError("VALIDATION_FAILED", "Image dimension validation requires an image inspector and is not enabled in core.");
+  }
+  if (route.encoding) {
+    const text = await file.text();
+    if (route.encoding === "ascii" && /[^\x00-\x7F]/.test(text)) {
+      throw new UploadError("VALIDATION_FAILED", "Text file is not ASCII encoded.");
+    }
+  }
+  if (route.headers) {
+    const [headerLine = ""] = (await file.text()).split(/\r?\n/, 1);
+    const delimiter = route.delimiter ?? ",";
+    const actualHeaders = headerLine.split(delimiter).map((header) => header.trim());
+    if (route.headers.some((header, index) => actualHeaders[index] !== header)) {
+      throw new UploadError("VALIDATION_FAILED", "CSV headers do not match the route definition.");
+    }
+  }
+  if (route.pageRule || route.encrypted !== void 0 || route.durationRule) {
+    throw new UploadError("VALIDATION_FAILED", "Rich inspection is configured but no runtime inspector has been installed for this route.");
+  }
+}
+function normalizeError(error) {
+  if (error instanceof UploadError) return error;
+  if (error instanceof Error) return new UploadError("UNKNOWN", error.message);
+  return new UploadError("UNKNOWN", "Unknown upload failure.");
+}
+function statusFor(error) {
+  if (error.code === "AUTH_FAILED") return 401;
+  if (error.code === "UPLOAD_FAILED" || error.code === "UNKNOWN") return 500;
+  return 400;
+}
+function json(body, status) {
+  return Response.json(body, { status });
+}
+export {
+  handleUploadRequest
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/server.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 SizeValue, type UploadInputFile } from \"./types\";\r\n\r\nconst sizeUnits = {\r\n  b: 1,\r\n  kb: 1024,\r\n  mb: 1024 * 1024,\r\n  gb: 1024 * 1024 * 1024\r\n} as const;\r\n\r\nexport function parseSize(value: SizeValue): number {\r\n  const match = /^(\\d+(?:\\.\\d+)?)(b|kb|mb|gb)$/.exec(value);\r\n  if (!match) throw new UploadError(\"VALIDATION_FAILED\", `Invalid size value: ${value}`);\r\n  const amount = Number(match[1]);\r\n  const unit = match[2] as keyof typeof sizeUnits;\r\n  return Math.floor(amount * sizeUnits[unit]);\r\n}\r\n\r\nexport function extensionFor(name: string): string | undefined {\r\n  const index = name.lastIndexOf(\".\");\r\n  if (index < 0 || index === name.length - 1) return undefined;\r\n  return name.slice(index + 1).toLowerCase();\r\n}\r\n\r\nexport function toInputFile(file: File): UploadInputFile {\r\n  const extension = extensionFor(file.name);\r\n  const input: UploadInputFile = {\r\n    name: file.name,\r\n    type: file.type,\r\n    size: file.size,\r\n    file\r\n  };\r\n  if (extension) input.extension = extension;\r\n  return input;\r\n}\r\n\r\nexport function defaultKey(file: UploadInputFile): string {\r\n  const random = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;\r\n  return `${random}/${file.name}`;\r\n}\r\n\r\nexport async function readJsonFile(file: File): Promise<unknown> {\r\n  try {\r\n    return JSON.parse(await file.text());\r\n  } catch {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Invalid JSON file.\");\r\n  }\r\n}\r\n","import { UploadError, type UpliftApp, type UploadedFile, type UploadInputFile } from \"./types\";\r\nimport { defaultKey, readJsonFile, toInputFile } from \"./utils\";\r\n\r\ntype FileWithInput = {\r\n  input: UploadInputFile;\r\n  body: File;\r\n};\r\n\r\ntype StoredFile = {\r\n  file: UploadedFile;\r\n  meta: unknown;\r\n};\r\n\r\nexport async function handleUploadRequest(app: UpliftApp, req: Request): Promise<Response> {\r\n  try {\r\n    if (req.method !== \"POST\") {\r\n      return json({ error: new UploadError(\"VALIDATION_FAILED\", \"Only POST upload requests are supported.\") }, 405);\r\n    }\r\n\r\n    const routeName = routeNameFromRequest(req);\r\n    const route = app.routes[routeName];\r\n    if (!route) throw new UploadError(\"VALIDATION_FAILED\", `Unknown upload route: ${routeName}`);\r\n\r\n    const user = await resolveUser(app, route._def, req);\r\n    const files = await filesFromRequest(req);\r\n    if (files.length === 0) throw new UploadError(\"VALIDATION_FAILED\", \"No files were uploaded.\");\r\n    if (!route._def.multiple && files.length !== 1) {\r\n      throw new UploadError(\"VALIDATION_FAILED\", \"This route accepts exactly one file.\");\r\n    }\r\n    if (route._def.multipleLimit !== undefined && files.length > route._def.multipleLimit) {\r\n      throw new UploadError(\"VALIDATION_FAILED\", `This route accepts at most ${route._def.multipleLimit} files.`);\r\n    }\r\n\r\n    const stored: StoredFile[] = [];\r\n    for (const item of files) {\r\n      const meta = await deriveMeta(route._def, req, item.input, user);\r\n      await validateFile(route._def, req, item, user, meta);\r\n      const key = route._def.key ? await route._def.key({ req, file: item.input, user, meta }) : defaultKey(item.input);\r\n      assertSafeStorageKey(key);\r\n      stored.push({\r\n        file: await app.storage.put({ key, file: item.input, body: item.body }),\r\n        meta\r\n      });\r\n    }\r\n\r\n    const uploaded = stored.map((item) => item.file);\r\n    const metas = stored.map((item) => item.meta);\r\n    const firstUpload = uploaded[0];\r\n    if (!firstUpload) throw new UploadError(\"UPLOAD_FAILED\", \"Upload did not produce a result.\");\r\n    const result: UploadedFile | UploadedFile[] = route._def.multiple ? uploaded : firstUpload;\r\n\r\n    if (route._def.done) {\r\n      if (route._def.multiple) {\r\n        await route._def.done({ req, files: uploaded, user, meta: metas });\r\n      } else {\r\n        await route._def.done({ req, file: firstUpload, user, meta: metas[0] });\r\n      }\r\n    }\r\n\r\n    if (app.onUploadComplete) await app.onUploadComplete({ route: routeName, result, user });\r\n    return json({ result }, 200);\r\n  } catch (error) {\r\n    const uploadError = normalizeError(error);\r\n    return json({ error: uploadError }, statusFor(uploadError));\r\n  }\r\n}\r\n\r\nfunction assertSafeStorageKey(key: string): void {\r\n  if (key.length === 0) {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Storage key cannot be empty.\");\r\n  }\r\n  if (\r\n    key.includes(\"\\0\") ||\r\n    key.includes(\"\\\\\") ||\r\n    key.includes(\"://\") ||\r\n    key.split(\"/\").includes(\"..\") ||\r\n    /^([a-zA-Z]:)?\\//.test(key)\r\n  ) {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Storage key must be a relative object key.\");\r\n  }\r\n}\r\n\r\nfunction routeNameFromRequest(req: Request): string {\r\n  const url = new URL(req.url);\r\n  const explicit = url.searchParams.get(\"route\");\r\n  if (explicit) return explicit;\r\n  const parts = url.pathname.split(\"/\").filter(Boolean);\r\n  return parts[parts.length - 1] ?? \"\";\r\n}\r\n\r\nasync function resolveUser(app: UpliftApp, route: UpliftApp[\"routes\"][string][\"_def\"], req: Request): Promise<unknown> {\r\n  if (route.overrideAuth) return undefined;\r\n  const middleware = route.auth ?? app.middleware;\r\n  if (!middleware) return undefined;\r\n  try {\r\n    return await middleware({ req });\r\n  } catch (error) {\r\n    const message = error instanceof Error ? error.message : \"Authentication failed.\";\r\n    throw new UploadError(\"AUTH_FAILED\", message);\r\n  }\r\n}\r\n\r\nasync function filesFromRequest(req: Request): Promise<FileWithInput[]> {\r\n  const contentType = req.headers.get(\"content-type\") ?? \"\";\r\n  if (!contentType.includes(\"multipart/form-data\")) {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Upload requests must be multipart/form-data.\");\r\n  }\r\n\r\n  try {\r\n    const form = await req.formData();\r\n    const files: FileWithInput[] = [];\r\n    for (const value of form.values()) {\r\n      if (!(value instanceof File)) continue;\r\n      files.push({ input: toInputFile(value), body: value });\r\n    }\r\n    return files;\r\n  } catch (error) {\r\n    if (error instanceof UploadError) throw error;\r\n    const message = error instanceof Error ? error.message : \"Upload request body could not be parsed.\";\r\n    throw new UploadError(\"VALIDATION_FAILED\", message);\r\n  }\r\n}\r\n\r\nasync function deriveMeta(\r\n  route: UpliftApp[\"routes\"][string][\"_def\"],\r\n  req: Request,\r\n  file: UploadInputFile,\r\n  user: unknown\r\n): Promise<unknown> {\r\n  if (!route.meta) return undefined;\r\n  return route.meta({ req, file, user });\r\n}\r\n\r\nasync function validateFile(\r\n  route: UpliftApp[\"routes\"][string][\"_def\"],\r\n  req: Request,\r\n  item: FileWithInput,\r\n  user: unknown,\r\n  meta: unknown\r\n) {\r\n  if (route.maxBytes !== undefined && item.input.size > route.maxBytes) {\r\n    throw new UploadError(\"FILE_TOO_LARGE\", \"File is larger than the route allows.\");\r\n  }\r\n  if (route.minBytes !== undefined && item.input.size < route.minBytes) {\r\n    throw new UploadError(\"FILE_TOO_SMALL\", \"File is smaller than the route allows.\");\r\n  }\r\n  if (route.kind !== \"any\" && route.extensions && item.input.extension && !route.extensions.includes(item.input.extension)) {\r\n    throw new UploadError(\"INVALID_TYPE\", \"File type is not allowed.\");\r\n  }\r\n  if (route.kind !== \"any\" && route.mimeTypes && route.mimeTypes.length > 0) {\r\n    const matches = route.mimeTypes.some((mime) => mime.endsWith(\"/\") ? item.input.type.startsWith(mime) : item.input.type === mime);\r\n    if (!matches) throw new UploadError(\"INVALID_TYPE\", \"File MIME type is not allowed.\");\r\n  }\r\n  if (route.schema) {\r\n    try {\r\n      route.schema.parse(await readJsonFile(item.body));\r\n    } catch (error) {\r\n      if (error instanceof UploadError) throw error;\r\n      const message = error instanceof Error ? error.message : \"Schema validation failed.\";\r\n      throw new UploadError(\"VALIDATION_FAILED\", message);\r\n    }\r\n  }\r\n  await validateConfiguredInspection(route, item.body);\r\n  if (route.validate) {\r\n    const result = await route.validate({ req, file: item.input, user, meta });\r\n    if (result !== true) throw new UploadError(\"VALIDATION_FAILED\", result);\r\n  }\r\n}\r\n\r\nasync function validateConfiguredInspection(route: UpliftApp[\"routes\"][string][\"_def\"], file: File): Promise<void> {\r\n  if (route.dimensionRule || route.requireSquare || route.aspectRatio) {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Image dimension validation requires an image inspector and is not enabled in core.\");\r\n  }\r\n  if (route.encoding) {\r\n    const text = await file.text();\r\n    if (route.encoding === \"ascii\" && /[^\\x00-\\x7F]/.test(text)) {\r\n      throw new UploadError(\"VALIDATION_FAILED\", \"Text file is not ASCII encoded.\");\r\n    }\r\n  }\r\n  if (route.headers) {\r\n    const [headerLine = \"\"] = (await file.text()).split(/\\r?\\n/, 1);\r\n    const delimiter = route.delimiter ?? \",\";\r\n    const actualHeaders = headerLine.split(delimiter).map((header) => header.trim());\r\n    if (route.headers.some((header, index) => actualHeaders[index] !== header)) {\r\n      throw new UploadError(\"VALIDATION_FAILED\", \"CSV headers do not match the route definition.\");\r\n    }\r\n  }\r\n  if (route.pageRule || route.encrypted !== undefined || route.durationRule) {\r\n    throw new UploadError(\"VALIDATION_FAILED\", \"Rich inspection is configured but no runtime inspector has been installed for this route.\");\r\n  }\r\n}\r\n\r\nfunction normalizeError(error: unknown): UploadError {\r\n  if (error instanceof UploadError) return error;\r\n  if (error instanceof Error) return new UploadError(\"UNKNOWN\", error.message);\r\n  return new UploadError(\"UNKNOWN\", \"Unknown upload failure.\");\r\n}\r\n\r\nfunction statusFor(error: UploadError): number {\r\n  if (error.code === \"AUTH_FAILED\") return 401;\r\n  if (error.code === \"UPLOAD_FAILED\" || error.code === \"UNKNOWN\") return 500;\r\n  return 400;\r\n}\r\n\r\nfunction json(body: unknown, status: number): Response {\r\n  return Response.json(body, { status });\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/types-BdcszAj8.d.cts

@@ -0,0 +1,128 @@
+type SizeValue = `${number}b` | `${number}kb` | `${number}mb` | `${number}gb`;
+type DurationValue = `${number}s` | `${number}m` | `${number}h`;
+type UploadInputFile = {
+    name: string;
+    type: string;
+    size: number;
+    extension?: string;
+    file?: File;
+};
+type UploadedFile = {
+    url: string;
+    key: string;
+    name: string;
+    type: string;
+    size: number;
+    extension?: string | undefined;
+    provider: string;
+};
+type UploadErrorCode = "FILE_TOO_LARGE" | "FILE_TOO_SMALL" | "INVALID_TYPE" | "AUTH_FAILED" | "VALIDATION_FAILED" | "UPLOAD_FAILED" | "UNKNOWN";
+declare class UploadError extends Error {
+    readonly code: UploadErrorCode;
+    constructor(code: UploadErrorCode, message: string);
+    toJSON(): {
+        message: string;
+        code: UploadErrorCode;
+    };
+}
+type StandardSchema<T = unknown> = {
+    parse(input: unknown): T;
+};
+type KeyContext<TAuth = unknown, TMeta = unknown> = {
+    req: Request;
+    file: UploadInputFile;
+    user: TAuth;
+    meta: TMeta;
+};
+type DoneContext<TAuth = unknown, TMeta = unknown, TMultiple extends boolean = false> = TMultiple extends true ? {
+    req: Request;
+    files: UploadedFile[];
+    user: TAuth;
+    meta: TMeta[];
+} : {
+    req: Request;
+    file: UploadedFile;
+    user: TAuth;
+    meta: TMeta;
+};
+type StoragePutInput = {
+    key: string;
+    file: UploadInputFile;
+    body: File;
+};
+type StorageAdapter = {
+    provider: string;
+    put(input: StoragePutInput): Promise<UploadedFile>;
+};
+type Middleware<TUser = unknown> = (ctx: {
+    req: Request;
+}) => TUser | Promise<TUser>;
+type UploadKind = "any" | "image" | "pdf" | "video" | "audio" | "text" | "json" | "csv" | "custom";
+type UploadRouteDefinition = {
+    kind: UploadKind;
+    maxBytes?: number;
+    minBytes?: number;
+    multiple: boolean;
+    multipleLimit?: number;
+    auth?: Middleware<unknown>;
+    overrideAuth: boolean;
+    key?: (ctx: KeyContext<unknown, unknown>) => string | Promise<string>;
+    meta?: (ctx: {
+        req: Request;
+        file: UploadInputFile;
+        user: unknown;
+    }) => unknown | Promise<unknown>;
+    validate?: (ctx: {
+        req: Request;
+        file: UploadInputFile;
+        user: unknown;
+        meta: unknown;
+    }) => true | string | Promise<true | string>;
+    done?: (ctx: DoneContext<unknown, unknown, boolean>) => void | Promise<void>;
+    extensions?: string[];
+    mimeTypes?: string[];
+    dimensionRule?: {
+        minWidth?: number;
+        minHeight?: number;
+        maxWidth?: number;
+        maxHeight?: number;
+    };
+    requireSquare?: boolean;
+    aspectRatio?: `${number}:${number}`;
+    encoding?: "utf-8" | "utf-16" | "ascii";
+    schema?: StandardSchema;
+    headers?: string[];
+    delimiter?: "," | ";" | "\t" | "|";
+    pageRule?: {
+        min?: number;
+        max?: number;
+    };
+    encrypted?: boolean;
+    durationRule?: {
+        min?: DurationValue;
+        max?: DurationValue;
+    };
+};
+type UploadRoutes = Record<string, {
+    _def: UploadRouteDefinition;
+}>;
+type UpliftApp<TRoutes extends UploadRoutes = UploadRoutes> = {
+    storage: StorageAdapter;
+    routes: TRoutes;
+    middleware?: Middleware<unknown> | undefined;
+    onUploadComplete?: ((ctx: {
+        route: keyof TRoutes & string;
+        result: UploadedFile | UploadedFile[];
+        user: unknown;
+    }) => void | Promise<void>) | undefined;
+};
+type IsMultiple<TRoute> = TRoute extends {
+    __multiple?: infer TMultiple;
+} ? TMultiple extends true ? true : false : false;
+type ClientInput<TRoute> = IsMultiple<TRoute> extends true ? File[] | FileList : File;
+type ClientOutput<TRoute> = IsMultiple<TRoute> extends true ? UploadedFile[] : UploadedFile;
+type UploadClient<TApp extends UpliftApp> = {
+    [TRouteName in keyof TApp["routes"] & string]: (input: ClientInput<TApp["routes"][TRouteName]>) => Promise<ClientOutput<TApp["routes"][TRouteName]>>;
+};
+
+export { type ClientInput as C, type DurationValue as D, type KeyContext as K, type Middleware as M, type SizeValue as S, type UploadKind as U, type UploadRouteDefinition as a, type UploadInputFile as b, type DoneContext as c, type StandardSchema as d, type UploadRoutes as e, type StorageAdapter as f, type UpliftApp as g, type ClientOutput as h, type StoragePutInput as i, type UploadClient as j, UploadError as k, type UploadErrorCode as l, type UploadedFile as m };

package/dist/types-BdcszAj8.d.ts

@@ -0,0 +1,128 @@
+type SizeValue = `${number}b` | `${number}kb` | `${number}mb` | `${number}gb`;
+type DurationValue = `${number}s` | `${number}m` | `${number}h`;
+type UploadInputFile = {
+    name: string;
+    type: string;
+    size: number;
+    extension?: string;
+    file?: File;
+};
+type UploadedFile = {
+    url: string;
+    key: string;
+    name: string;
+    type: string;
+    size: number;
+    extension?: string | undefined;
+    provider: string;
+};
+type UploadErrorCode = "FILE_TOO_LARGE" | "FILE_TOO_SMALL" | "INVALID_TYPE" | "AUTH_FAILED" | "VALIDATION_FAILED" | "UPLOAD_FAILED" | "UNKNOWN";
+declare class UploadError extends Error {
+    readonly code: UploadErrorCode;
+    constructor(code: UploadErrorCode, message: string);
+    toJSON(): {
+        message: string;
+        code: UploadErrorCode;
+    };
+}
+type StandardSchema<T = unknown> = {
+    parse(input: unknown): T;
+};
+type KeyContext<TAuth = unknown, TMeta = unknown> = {
+    req: Request;
+    file: UploadInputFile;
+    user: TAuth;
+    meta: TMeta;
+};
+type DoneContext<TAuth = unknown, TMeta = unknown, TMultiple extends boolean = false> = TMultiple extends true ? {
+    req: Request;
+    files: UploadedFile[];
+    user: TAuth;
+    meta: TMeta[];
+} : {
+    req: Request;
+    file: UploadedFile;
+    user: TAuth;
+    meta: TMeta;
+};
+type StoragePutInput = {
+    key: string;
+    file: UploadInputFile;
+    body: File;
+};
+type StorageAdapter = {
+    provider: string;
+    put(input: StoragePutInput): Promise<UploadedFile>;
+};
+type Middleware<TUser = unknown> = (ctx: {
+    req: Request;
+}) => TUser | Promise<TUser>;
+type UploadKind = "any" | "image" | "pdf" | "video" | "audio" | "text" | "json" | "csv" | "custom";
+type UploadRouteDefinition = {
+    kind: UploadKind;
+    maxBytes?: number;
+    minBytes?: number;
+    multiple: boolean;
+    multipleLimit?: number;
+    auth?: Middleware<unknown>;
+    overrideAuth: boolean;
+    key?: (ctx: KeyContext<unknown, unknown>) => string | Promise<string>;
+    meta?: (ctx: {
+        req: Request;
+        file: UploadInputFile;
+        user: unknown;
+    }) => unknown | Promise<unknown>;
+    validate?: (ctx: {
+        req: Request;
+        file: UploadInputFile;
+        user: unknown;
+        meta: unknown;
+    }) => true | string | Promise<true | string>;
+    done?: (ctx: DoneContext<unknown, unknown, boolean>) => void | Promise<void>;
+    extensions?: string[];
+    mimeTypes?: string[];
+    dimensionRule?: {
+        minWidth?: number;
+        minHeight?: number;
+        maxWidth?: number;
+        maxHeight?: number;
+    };
+    requireSquare?: boolean;
+    aspectRatio?: `${number}:${number}`;
+    encoding?: "utf-8" | "utf-16" | "ascii";
+    schema?: StandardSchema;
+    headers?: string[];
+    delimiter?: "," | ";" | "\t" | "|";
+    pageRule?: {
+        min?: number;
+        max?: number;
+    };
+    encrypted?: boolean;
+    durationRule?: {
+        min?: DurationValue;
+        max?: DurationValue;
+    };
+};
+type UploadRoutes = Record<string, {
+    _def: UploadRouteDefinition;
+}>;
+type UpliftApp<TRoutes extends UploadRoutes = UploadRoutes> = {
+    storage: StorageAdapter;
+    routes: TRoutes;
+    middleware?: Middleware<unknown> | undefined;
+    onUploadComplete?: ((ctx: {
+        route: keyof TRoutes & string;
+        result: UploadedFile | UploadedFile[];
+        user: unknown;
+    }) => void | Promise<void>) | undefined;
+};
+type IsMultiple<TRoute> = TRoute extends {
+    __multiple?: infer TMultiple;
+} ? TMultiple extends true ? true : false : false;
+type ClientInput<TRoute> = IsMultiple<TRoute> extends true ? File[] | FileList : File;
+type ClientOutput<TRoute> = IsMultiple<TRoute> extends true ? UploadedFile[] : UploadedFile;
+type UploadClient<TApp extends UpliftApp> = {
+    [TRouteName in keyof TApp["routes"] & string]: (input: ClientInput<TApp["routes"][TRouteName]>) => Promise<ClientOutput<TApp["routes"][TRouteName]>>;
+};
+
+export { type ClientInput as C, type DurationValue as D, type KeyContext as K, type Middleware as M, type SizeValue as S, type UploadKind as U, type UploadRouteDefinition as a, type UploadInputFile as b, type DoneContext as c, type StandardSchema as d, type UploadRoutes as e, type StorageAdapter as f, type UpliftApp as g, type ClientOutput as h, type StoragePutInput as i, type UploadClient as j, UploadError as k, type UploadErrorCode as l, type UploadedFile as m };

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@uplift-io/uplift",
+  "version": "1.0.0",
+  "description": "Dead-simple, type-safe file handling for TypeScript applications.",
+  "license": "MIT",
+  "homepage": "https://itzfeminisce.github.io/uplift/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Itzfeminisce/uplift.git",
+    "directory": "packages/uplift"
+  },
+  "bugs": {
+    "url": "https://github.com/Itzfeminisce/uplift/issues"
+  },
+  "keywords": [
+    "upload",
+    "file-upload",
+    "typescript",
+    "multipart",
+    "s3",
+    "r2",
+    "nextjs",
+    "hono",
+    "express",
+    "react"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "react": "^19.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}