@lpdjs/firestore-repo-service 2.2.9-beta.2 → 2.2.9-beta.3

package/dist/{index-Njwf8jvu.d.ts → index-BTrgC2ZA.d.cts}

@@ -1,121 +1,7 @@
 import { z } from 'zod';
 import { HttpsOptions } from 'firebase-functions/v2/https';
-import { C as ConfiguredRepository, R as RepositoryConfig, F as FieldPath, n as FieldRole } from './types-C822D0dX.js';
-
-/**
- * Minimal zero-dependency HTTP router for Firebase Functions.
- * Compatible with any Express-like (req, res) handler.
- *
- * Supports:
- *  - Named path parameters  (e.g. "/repos/:name/:id")
- *  - GET, POST, DELETE methods
- *  - Global middleware (before each route)
- *  - 404 / error fallbacks
- *
- * @example
- * ```typescript
- * import { MiniRouter } from "@lpdjs/firestore-repo-service/servers/admin";
- *
- * // Create router
- * const router = new MiniRouter();
- *
- * // Add global middleware (executed before every route)
- * router.use(async (req, res, next) => {
- *   console.log(`${req.method} ${req.url}`);
- *   await next();
- * });
- *
- * // Auth middleware
- * router.use((req, res, next) => {
- *   if (!req.headers?.authorization) {
- *     res.status(401).send("Unauthorized");
- *     return;
- *   }
- *   next();
- * });
- *
- * // Define routes with path parameters
- * router.get("/users", async (req, res) => {
- *   res.json({ users: await getAllUsers() });
- * });
- *
- * router.get("/users/:id", async (req, res) => {
- *   const user = await getUser(req.params.id); // Access path params
- *   if (!user) {
- *     res.status(404).send("User not found");
- *     return;
- *   }
- *   res.json(user);
- * });
- *
- * router.post("/users", async (req, res) => {
- *   const user = await createUser(req.body);
- *   res.status(201).json(user);
- * });
- *
- * router.delete("/users/:id", async (req, res) => {
- *   await deleteUser(req.params.id);
- *   res.status(204).end();
- * });
- *
- * // Custom 404 handler
- * router.onNotFound((req, res) => {
- *   res.status(404).json({ error: "Route not found", path: req.url });
- * });
- *
- * // Custom error handler
- * router.onError((err, req, res) => {
- *   console.error("Error:", err);
- *   res.status(500).json({ error: "Internal server error" });
- * });
- *
- * // Use with Firebase Functions
- * export const api = onRequest(async (req, res) => {
- *   await router.handle(req, res);
- * });
- * ```
- */
-type AnyReq = {
-    method?: string;
-    url?: string;
-    /** Express originalUrl — preserved before any router stripping, contains the full path including the Firebase Functions prefix */
-    originalUrl?: string;
-    path?: string;
-    headers?: Record<string, string | string[] | undefined>;
-    body?: unknown;
-    query?: Record<string, string | string[] | undefined>;
-};
-type AnyRes = {
-    status: (code: number) => AnyRes;
-    set: (key: string, value: string) => AnyRes;
-    send: (body: string) => void;
-    json: (body: unknown) => void;
-    end: () => void;
-};
-type RouteParams = Record<string, string>;
-type RouteHandler = (req: AnyReq & {
-    params: RouteParams;
-}, res: AnyRes) => void | Promise<void>;
-type Middleware = (req: AnyReq & {
-    params: RouteParams;
-}, res: AnyRes, next: () => void | Promise<void>) => void | Promise<void>;
-declare class MiniRouter {
-    private routes;
-    private middlewares;
-    private notFoundHandler;
-    private errorHandler;
-    use(middleware: Middleware): this;
-    get(path: string, handler: RouteHandler): this;
-    post(path: string, handler: RouteHandler): this;
-    put(path: string, handler: RouteHandler): this;
-    patch(path: string, handler: RouteHandler): this;
-    delete(path: string, handler: RouteHandler): this;
-    onNotFound(handler: RouteHandler): this;
-    onError(handler: (err: unknown, req: AnyReq, res: AnyRes) => void): this;
-    private addRoute;
-    handle(req: AnyReq, res: AnyRes): Promise<void>;
-    private runMiddlewareChain;
-}
+import { C as ConfiguredRepository, R as RepositoryConfig, F as FieldPath, n as FieldRole } from './types-DptSRAK6.cjs';
+import { A as AuthExtension, a as Middleware } from './firebase-auth-CBqtAeb5.cjs';
 
 interface PageOptions {
     title: string;
@@ -434,10 +320,12 @@ interface AdminServerOptions<TRepos extends Record<string, ConfiguredRepository<
     parseBody?: boolean;
     /**
      * Authentication guard executed before every request.
+     * - Pass an {@link AuthExtension} (e.g. result of `firebaseAuth({...})`) to
+     *   wire Firebase Auth with a bundled `/__login` page and session cookie.
      * - Pass a `BasicAuthConfig` to enable HTTP Basic Auth.
-     * - Pass a `Middleware` function for custom auth logic.
+     * - Pass a `Middleware` function for fully custom auth logic.
      */
-    auth?: BasicAuthConfig | Middleware;
+    auth?: AuthExtension | BasicAuthConfig | Middleware;
     /**
      * Additional middleware functions executed after auth, before route handlers.
      */
@@ -570,4 +458,4 @@ declare function createAdminServer<TRepos extends Record<string, ConfiguredRepos
     httpsOptions?: HttpsOptions;
 };
 
-export { type AdminRepoConfig as A, type BasicAuthConfig as B, type ColumnMeta as C, type FilterState as F, MiniRouter as M, type PageOptions as P, type QueryError as Q, type RelationalFieldMeta as R, type SortState as S, type AdminRepoEntry as a, type AdminServerOptions as b, type Middleware as c, type RepoRegistry as d, type RouteHandler as e, createAdminServer as f };
+export { type AdminRepoConfig as A, type BasicAuthConfig as B, type ColumnMeta as C, type FilterState as F, type PageOptions as P, type QueryError as Q, type RelationalFieldMeta as R, type SortState as S, type AdminRepoEntry as a, type AdminServerOptions as b, type RepoRegistry as c, createAdminServer as d };

package/dist/{index-BvKyjs6k.d.cts → index-CP4WoShV.d.ts}

@@ -1,121 +1,7 @@
 import { z } from 'zod';
 import { HttpsOptions } from 'firebase-functions/v2/https';
-import { C as ConfiguredRepository, R as RepositoryConfig, F as FieldPath, n as FieldRole } from './types-Z1Zy-2hs.cjs';
-
-/**
- * Minimal zero-dependency HTTP router for Firebase Functions.
- * Compatible with any Express-like (req, res) handler.
- *
- * Supports:
- *  - Named path parameters  (e.g. "/repos/:name/:id")
- *  - GET, POST, DELETE methods
- *  - Global middleware (before each route)
- *  - 404 / error fallbacks
- *
- * @example
- * ```typescript
- * import { MiniRouter } from "@lpdjs/firestore-repo-service/servers/admin";
- *
- * // Create router
- * const router = new MiniRouter();
- *
- * // Add global middleware (executed before every route)
- * router.use(async (req, res, next) => {
- *   console.log(`${req.method} ${req.url}`);
- *   await next();
- * });
- *
- * // Auth middleware
- * router.use((req, res, next) => {
- *   if (!req.headers?.authorization) {
- *     res.status(401).send("Unauthorized");
- *     return;
- *   }
- *   next();
- * });
- *
- * // Define routes with path parameters
- * router.get("/users", async (req, res) => {
- *   res.json({ users: await getAllUsers() });
- * });
- *
- * router.get("/users/:id", async (req, res) => {
- *   const user = await getUser(req.params.id); // Access path params
- *   if (!user) {
- *     res.status(404).send("User not found");
- *     return;
- *   }
- *   res.json(user);
- * });
- *
- * router.post("/users", async (req, res) => {
- *   const user = await createUser(req.body);
- *   res.status(201).json(user);
- * });
- *
- * router.delete("/users/:id", async (req, res) => {
- *   await deleteUser(req.params.id);
- *   res.status(204).end();
- * });
- *
- * // Custom 404 handler
- * router.onNotFound((req, res) => {
- *   res.status(404).json({ error: "Route not found", path: req.url });
- * });
- *
- * // Custom error handler
- * router.onError((err, req, res) => {
- *   console.error("Error:", err);
- *   res.status(500).json({ error: "Internal server error" });
- * });
- *
- * // Use with Firebase Functions
- * export const api = onRequest(async (req, res) => {
- *   await router.handle(req, res);
- * });
- * ```
- */
-type AnyReq = {
-    method?: string;
-    url?: string;
-    /** Express originalUrl — preserved before any router stripping, contains the full path including the Firebase Functions prefix */
-    originalUrl?: string;
-    path?: string;
-    headers?: Record<string, string | string[] | undefined>;
-    body?: unknown;
-    query?: Record<string, string | string[] | undefined>;
-};
-type AnyRes = {
-    status: (code: number) => AnyRes;
-    set: (key: string, value: string) => AnyRes;
-    send: (body: string) => void;
-    json: (body: unknown) => void;
-    end: () => void;
-};
-type RouteParams = Record<string, string>;
-type RouteHandler = (req: AnyReq & {
-    params: RouteParams;
-}, res: AnyRes) => void | Promise<void>;
-type Middleware = (req: AnyReq & {
-    params: RouteParams;
-}, res: AnyRes, next: () => void | Promise<void>) => void | Promise<void>;
-declare class MiniRouter {
-    private routes;
-    private middlewares;
-    private notFoundHandler;
-    private errorHandler;
-    use(middleware: Middleware): this;
-    get(path: string, handler: RouteHandler): this;
-    post(path: string, handler: RouteHandler): this;
-    put(path: string, handler: RouteHandler): this;
-    patch(path: string, handler: RouteHandler): this;
-    delete(path: string, handler: RouteHandler): this;
-    onNotFound(handler: RouteHandler): this;
-    onError(handler: (err: unknown, req: AnyReq, res: AnyRes) => void): this;
-    private addRoute;
-    handle(req: AnyReq, res: AnyRes): Promise<void>;
-    private runMiddlewareChain;
-}
+import { C as ConfiguredRepository, R as RepositoryConfig, F as FieldPath, n as FieldRole } from './types-CqXbEeXp.js';
+import { A as AuthExtension, a as Middleware } from './firebase-auth-CBqtAeb5.js';
 
 interface PageOptions {
     title: string;
@@ -434,10 +320,12 @@ interface AdminServerOptions<TRepos extends Record<string, ConfiguredRepository<
     parseBody?: boolean;
     /**
      * Authentication guard executed before every request.
+     * - Pass an {@link AuthExtension} (e.g. result of `firebaseAuth({...})`) to
+     *   wire Firebase Auth with a bundled `/__login` page and session cookie.
      * - Pass a `BasicAuthConfig` to enable HTTP Basic Auth.
-     * - Pass a `Middleware` function for custom auth logic.
+     * - Pass a `Middleware` function for fully custom auth logic.
      */
-    auth?: BasicAuthConfig | Middleware;
+    auth?: AuthExtension | BasicAuthConfig | Middleware;
     /**
      * Additional middleware functions executed after auth, before route handlers.
      */
@@ -570,4 +458,4 @@ declare function createAdminServer<TRepos extends Record<string, ConfiguredRepos
     httpsOptions?: HttpsOptions;
 };
 
-export { type AdminRepoConfig as A, type BasicAuthConfig as B, type ColumnMeta as C, type FilterState as F, MiniRouter as M, type PageOptions as P, type QueryError as Q, type RelationalFieldMeta as R, type SortState as S, type AdminRepoEntry as a, type AdminServerOptions as b, type Middleware as c, type RepoRegistry as d, type RouteHandler as e, createAdminServer as f };
+export { type AdminRepoConfig as A, type BasicAuthConfig as B, type ColumnMeta as C, type FilterState as F, type PageOptions as P, type QueryError as Q, type RelationalFieldMeta as R, type SortState as S, type AdminRepoEntry as a, type AdminServerOptions as b, type RepoRegistry as c, createAdminServer as d };