@ayepi/files 0.1.0

package/dist/server.d.cts

@@ -0,0 +1,51 @@
+import { FileStore, Presigner } from "./index.cjs";
+import { AnySpec, MountHandle, Server } from "@ayepi/core";
+
+//#region src/server.d.ts
+
+/** Shared options for the two serving styles. */
+interface FilesServerOptions {
+  /** HMAC secret used to sign/verify presigned tokens (server-side only). */
+  readonly secret: string;
+  /** URL path the up/download routes live at (default `'/_files'`). */
+  readonly basePath?: string;
+  /** Default presigned-URL lifetime in seconds (default 900). */
+  readonly expiresIn?: number;
+  /** Clock injection (default `Date.now`) — for tests. */
+  readonly now?: () => number;
+}
+/**
+ * Hot-mount presigned `GET`/`PUT` routes for `store` onto a running `app` and return a
+ * {@link Presigner} for them. The download sets `Content-Length` (so HTTP Range / resumable
+ * downloads work) and the object's content-type; the upload streams the request body straight
+ * into `store.put`. Tear the routes down later with `app.uninstall(handle)`.
+ *
+ * @example
+ * ```ts
+ * const files = fsFiles({ dir: './uploads' });
+ * const { presign, handle } = mountFiles(app, files, { secret: process.env.FILES_SECRET! });
+ * const url = await presign.presignDownload('reports/2026.csv', { expiresIn: 60 });
+ * ```
+ */
+declare function mountFiles(app: Server<AnySpec>, store: FileStore, opts: FilesServerOptions): {
+  handle: MountHandle;
+  presign: Presigner;
+};
+/**
+ * Build a standalone `fetch(req)` that serves the presigned `GET`/`PUT` for `store`, plus a
+ * {@link Presigner} for them. Returns `undefined` for requests that aren't `basePath`, so you
+ * can compose it around your server's `fetch` (the example `_harness` pattern) — no spec, no
+ * mount, works on any runtime.
+ *
+ * @example
+ * ```ts
+ * const { fetch: filesFetch, presign } = createFilesHandler(files, { secret, basePath: '/files' });
+ * const handler = async (req: Request) => (await filesFetch(req)) ?? app.fetch(req);
+ * ```
+ */
+declare function createFilesHandler(store: FileStore, opts: FilesServerOptions): {
+  fetch: (req: Request) => Promise<Response | undefined>;
+  presign: Presigner;
+};
+//#endregion
+export { FilesServerOptions, createFilesHandler, mountFiles };

package/dist/server.d.ts

@@ -0,0 +1,51 @@
+import { FileStore, Presigner } from "./index.js";
+import { AnySpec, MountHandle, Server } from "@ayepi/core";
+
+//#region src/server.d.ts
+
+/** Shared options for the two serving styles. */
+interface FilesServerOptions {
+  /** HMAC secret used to sign/verify presigned tokens (server-side only). */
+  readonly secret: string;
+  /** URL path the up/download routes live at (default `'/_files'`). */
+  readonly basePath?: string;
+  /** Default presigned-URL lifetime in seconds (default 900). */
+  readonly expiresIn?: number;
+  /** Clock injection (default `Date.now`) — for tests. */
+  readonly now?: () => number;
+}
+/**
+ * Hot-mount presigned `GET`/`PUT` routes for `store` onto a running `app` and return a
+ * {@link Presigner} for them. The download sets `Content-Length` (so HTTP Range / resumable
+ * downloads work) and the object's content-type; the upload streams the request body straight
+ * into `store.put`. Tear the routes down later with `app.uninstall(handle)`.
+ *
+ * @example
+ * ```ts
+ * const files = fsFiles({ dir: './uploads' });
+ * const { presign, handle } = mountFiles(app, files, { secret: process.env.FILES_SECRET! });
+ * const url = await presign.presignDownload('reports/2026.csv', { expiresIn: 60 });
+ * ```
+ */
+declare function mountFiles(app: Server<AnySpec>, store: FileStore, opts: FilesServerOptions): {
+  handle: MountHandle;
+  presign: Presigner;
+};
+/**
+ * Build a standalone `fetch(req)` that serves the presigned `GET`/`PUT` for `store`, plus a
+ * {@link Presigner} for them. Returns `undefined` for requests that aren't `basePath`, so you
+ * can compose it around your server's `fetch` (the example `_harness` pattern) — no spec, no
+ * mount, works on any runtime.
+ *
+ * @example
+ * ```ts
+ * const { fetch: filesFetch, presign } = createFilesHandler(files, { secret, basePath: '/files' });
+ * const handler = async (req: Request) => (await filesFetch(req)) ?? app.fetch(req);
+ * ```
+ */
+declare function createFilesHandler(store: FileStore, opts: FilesServerOptions): {
+  fetch: (req: Request) => Promise<Response | undefined>;
+  presign: Presigner;
+};
+//#endregion
+export { FilesServerOptions, createFilesHandler, mountFiles };