@lpdjs/firestore-repo-service 2.4.3 → 2.6.2-beta.0

package/README.md

@@ -102,20 +102,23 @@ if (post) {
 }
 
 // Update
-const updated = await repos.users.update("user123", { name: "New name", age: 31 });
+const updated = await repos.users.update("user123", {
+  name: "New name",
+  age: 31,
+});
 ```
 
 ## API reference
 
 ### `createRepositoryConfig()`
 
-| Option        | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `path`        | Collection path in Firestore                            |
-| `isGroup`     | `true` for collection group, `false` for simple         |
-| `foreignKeys` | Keys for `get.by*` methods (single document lookup)     |
-| `queryKeys`   | Keys for `query.by*` methods (multi-document query)     |
-| `refCb`       | Function that returns the document reference            |
+| Option        | Description                                         |
+| ------------- | --------------------------------------------------- |
+| `path`        | Collection path in Firestore                        |
+| `isGroup`     | `true` for collection group, `false` for simple     |
+| `foreignKeys` | Keys for `get.by*` methods (single document lookup) |
+| `queryKeys`   | Keys for `query.by*` methods (multi-document query) |
+| `refCb`       | Function that returns the document reference        |
 
 **Sub-collection example:**
 
@@ -134,8 +137,8 @@ comments: createRepositoryConfig<CommentModel>()({
 
 ```typescript
 interface QueryOptions<T> {
-  where?: [keyof T, WhereFilterOp, any][];      // AND conditions
-  orWhere?: [keyof T, WhereFilterOp, any][][];  // OR conditions
+  where?: [keyof T, WhereFilterOp, any][]; // AND conditions
+  orWhere?: [keyof T, WhereFilterOp, any][][]; // OR conditions
   orderBy?: { field: keyof T; direction?: "asc" | "desc" }[];
   limit?: number;
   offset?: number;
@@ -226,7 +229,9 @@ const page = await repos.posts.query.paginate({
 ```typescript
 import { count, sum, average } from "@lpdjs/firestore-repo-service";
 
-const activeCount = await repos.users.aggregate.count({ where: [["isActive", "==", true]] });
+const activeCount = await repos.users.aggregate.count({
+  where: [["isActive", "==", true]],
+});
 const totalViews = await repos.posts.aggregate.sum("views");
 const avgAge = await repos.users.aggregate.average("age");
 ```
@@ -237,7 +242,9 @@ const avgAge = await repos.users.aggregate.average("age");
 const result = await repos.users.transaction.run(async (txn) => {
   const user = await txn.get(repos.users.documentRef("user123"));
   if (user.exists()) {
-    txn.update(repos.users.documentRef("user123"), { age: user.data().age + 1 });
+    txn.update(repos.users.documentRef("user123"), {
+      age: user.data().age + 1,
+    });
   }
   return { success: true };
 });
@@ -249,8 +256,14 @@ const result = await repos.users.transaction.run(async (txn) => {
 // (status = 'active' AND age >= 18) OR (status = 'pending' AND verified = true)
 const users = await repos.users.query.by({
   orWhere: [
-    [["status", "==", "active"], ["age", ">=", 18]],
-    [["status", "==", "pending"], ["verified", "==", true]],
+    [
+      ["status", "==", "active"],
+      ["age", ">=", 18],
+    ],
+    [
+      ["status", "==", "pending"],
+      ["verified", "==", true],
+    ],
   ],
 });
 ```
@@ -304,9 +317,9 @@ npm i -D @asteasolutions/zod-to-openapi
 ### Bootstrap
 
 ```bash
-npx frs-hono init          # interactive — creates apis.ts + manifest stub
-npx frs-hono new createPost --domain posts --method post --api v1
-npx frs-hono gen --root src/domains   # refresh manifest (run before each build)
+npx frs init          # interactive — creates apis.ts + manifest stub
+npx frs new createPost --domain posts --method post --api v1
+npx frs gen --root src/domains   # refresh manifest (run before each build)
 ```
 
 ### Configure your APIs (`apis.ts`)
@@ -337,7 +350,7 @@ import { z } from "zod";
 import { defineRoute } from "../../../../apis.js";
 
 export default defineRoute({
-  api: "v1",           // typed: only registered tags accepted
+  api: "v1", // typed: only registered tags accepted
   method: "post",
   input: z.object({ title: z.string() }),
   output: z.object({ id: z.string() }),
@@ -365,16 +378,16 @@ export const { v1 } = apis.toFunctions(routes, onRequest, {
 
 ### Key features
 
-| Feature | Details |
-| --- | --- |
-| **File-based routing** | `routes.ts` next to each useCase, scanned at build time |
-| **Multi-API registry** | One Cloud Function per tag, typed `api` field |
-| **Zod validation** | Body / query / path params + optional response validation |
-| **OpenAPI 3.1** | Auto-generated from Zod schemas; Scalar UI at `/docs` |
-| **Interceptor** | Around-style hook for envelopes, error mapping, tracing |
-| **Middlewares** | Per-API and per-route Hono middlewares |
-| **Typed context** | Augment `ContextVariableMap` once, `c.get("user")` typed everywhere |
-| **CLI** | `init` / `new` (interactive) / `gen` |
+| Feature                | Details                                                             |
+| ---------------------- | ------------------------------------------------------------------- |
+| **File-based routing** | `routes.ts` next to each useCase, scanned at build time             |
+| **Multi-API registry** | One Cloud Function per tag, typed `api` field                       |
+| **Zod validation**     | Body / query / path params + optional response validation           |
+| **OpenAPI 3.1**        | Auto-generated from Zod schemas; Scalar UI at `/docs`               |
+| **Interceptor**        | Around-style hook for envelopes, error mapping, tracing             |
+| **Middlewares**        | Per-API and per-route Hono middlewares                              |
+| **Typed context**      | Augment `ContextVariableMap` once, `c.get("user")` typed everywhere |
+| **CLI**                | `init` / `new` (interactive) / `gen`                                |
 
 Full documentation: [frs.lpdjs.fr/guide/hono](https://frs.lpdjs.fr/guide/hono)
 
@@ -446,9 +459,18 @@ export const { functions } = servers.sync({
 
 // Spread Cloud Functions into your exports
 export const {
-  users_onCreate, users_onUpdate, users_onDelete, sync_users,
-  posts_onCreate, posts_onUpdate, posts_onDelete, sync_posts,
-  comments_onCreate, comments_onUpdate, comments_onDelete, sync_comments,
+  users_onCreate,
+  users_onUpdate,
+  users_onDelete,
+  sync_users,
+  posts_onCreate,
+  posts_onUpdate,
+  posts_onDelete,
+  sync_posts,
+  comments_onCreate,
+  comments_onUpdate,
+  comments_onDelete,
+  sync_comments,
   adminsync,
 } = functions;
 ```
@@ -488,7 +510,6 @@ Firestore emulator runs on `localhost:8080`, UI on `http://localhost:4000`.
 
 MIT
 
-
 ## Installation
 
 ```bash
@@ -579,20 +600,23 @@ if (post) {
 }
 
 // Update
-const updated = await repos.users.update("user123", { name: "New name", age: 31 });
+const updated = await repos.users.update("user123", {
+  name: "New name",
+  age: 31,
+});
 ```
 
 ## API reference
 
 ### `createRepositoryConfig()`
 
-| Option        | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `path`        | Collection path in Firestore                            |
-| `isGroup`     | `true` for collection group, `false` for simple         |
-| `foreignKeys` | Keys for `get.by*` methods (single document lookup)     |
-| `queryKeys`   | Keys for `query.by*` methods (multi-document query)     |
-| `refCb`       | Function that returns the document reference            |
+| Option        | Description                                         |
+| ------------- | --------------------------------------------------- |
+| `path`        | Collection path in Firestore                        |
+| `isGroup`     | `true` for collection group, `false` for simple     |
+| `foreignKeys` | Keys for `get.by*` methods (single document lookup) |
+| `queryKeys`   | Keys for `query.by*` methods (multi-document query) |
+| `refCb`       | Function that returns the document reference        |
 
 **Sub-collection example:**
 
@@ -611,8 +635,8 @@ comments: createRepositoryConfig<CommentModel>()({
 
 ```typescript
 interface QueryOptions<T> {
-  where?: [keyof T, WhereFilterOp, any][];      // AND conditions
-  orWhere?: [keyof T, WhereFilterOp, any][][];  // OR conditions
+  where?: [keyof T, WhereFilterOp, any][]; // AND conditions
+  orWhere?: [keyof T, WhereFilterOp, any][][]; // OR conditions
   orderBy?: { field: keyof T; direction?: "asc" | "desc" }[];
   limit?: number;
   offset?: number;
@@ -703,7 +727,9 @@ const page = await repos.posts.query.paginate({
 ```typescript
 import { count, sum, average } from "@lpdjs/firestore-repo-service";
 
-const activeCount = await repos.users.aggregate.count({ where: [["isActive", "==", true]] });
+const activeCount = await repos.users.aggregate.count({
+  where: [["isActive", "==", true]],
+});
 const totalViews = await repos.posts.aggregate.sum("views");
 const avgAge = await repos.users.aggregate.average("age");
 ```
@@ -714,7 +740,9 @@ const avgAge = await repos.users.aggregate.average("age");
 const result = await repos.users.transaction.run(async (txn) => {
   const user = await txn.get(repos.users.documentRef("user123"));
   if (user.exists()) {
-    txn.update(repos.users.documentRef("user123"), { age: user.data().age + 1 });
+    txn.update(repos.users.documentRef("user123"), {
+      age: user.data().age + 1,
+    });
   }
   return { success: true };
 });
@@ -726,8 +754,14 @@ const result = await repos.users.transaction.run(async (txn) => {
 // (status = 'active' AND age >= 18) OR (status = 'pending' AND verified = true)
 const users = await repos.users.query.by({
   orWhere: [
-    [["status", "==", "active"], ["age", ">=", 18]],
-    [["status", "==", "pending"], ["verified", "==", true]],
+    [
+      ["status", "==", "active"],
+      ["age", ">=", 18],
+    ],
+    [
+      ["status", "==", "pending"],
+      ["verified", "==", true],
+    ],
   ],
 });
 ```
@@ -798,9 +832,18 @@ export const { functions } = servers.sync({
 
 // Spread Cloud Functions into your exports
 export const {
-  users_onCreate, users_onUpdate, users_onDelete, sync_users,
-  posts_onCreate, posts_onUpdate, posts_onDelete, sync_posts,
-  comments_onCreate, comments_onUpdate, comments_onDelete, sync_comments,
+  users_onCreate,
+  users_onUpdate,
+  users_onDelete,
+  sync_users,
+  posts_onCreate,
+  posts_onUpdate,
+  posts_onDelete,
+  sync_posts,
+  comments_onCreate,
+  comments_onUpdate,
+  comments_onDelete,
+  sync_comments,
   adminsync,
 } = functions;
 ```
@@ -837,4 +880,3 @@ Firestore emulator runs on `localhost:8080`, UI on `http://localhost:4000`.
 ## License
 
 MIT
-

package/dist/{create-servers-B9dTUhvR.d.cts → create-servers-B4GrBqdA.d.cts}

@@ -1,11 +1,11 @@
-import { S as SyncQueue } from './queue-xMOZxY0M.cjs';
-import { F as FirestoreSyncConfig, S as SyncEvent } from './types-BgIGWlR1.cjs';
-import { O as OpenAPIDocument } from './openapi-ML_1hTx2.cjs';
+import { S as SyncQueue } from './queue-B8YUTnBT.cjs';
+import { F as FirestoreSyncConfig, S as SyncEvent } from './types-wcX7xfdo.cjs';
+import { O as OpenAPIDocument } from './openapi-B2w5tVRR.cjs';
 import * as firebase_functions_v2_https from 'firebase-functions/v2/https';
 import { onRequest, HttpsOptions } from 'firebase-functions/v2/https';
-import { H as HistoryTriggersConfig } from './read-BSyLao3I.cjs';
-import { C as ConfiguredRepository, a as CrudServerOptions, b as CrudRepoConfig } from './types-BtdC0Qhu.cjs';
-import { A as AdminServerOptions, a as AdminRepoConfig } from './index-BmagC7uw.cjs';
+import { H as HistoryTriggersConfig } from './read-CTWZjxyh.cjs';
+import { C as ConfiguredRepository, a as CrudServerOptions, b as CrudRepoConfig } from './types-GvexCqrq.cjs';
+import { A as AdminServerOptions, a as AdminRepoConfig } from './index-DzO9MfNI.cjs';
 
 /** Per-repo admin config with `repo` omitted (auto-bound from the registry key). */
 type BoundAdminRepoConfig<TRepo extends ConfiguredRepository<any>> = Omit<AdminRepoConfig<TRepo>, "repo">;

package/dist/{create-servers-BFhdPPeo.d.ts → create-servers-CVudVM8e.d.ts}

@@ -1,11 +1,11 @@
-import { S as SyncQueue } from './queue-CVchaGAh.js';
-import { F as FirestoreSyncConfig, S as SyncEvent } from './types-ChzVPw4k.js';
-import { O as OpenAPIDocument } from './openapi-DIoQV_yQ.js';
+import { S as SyncQueue } from './queue-DYmbVDu5.js';
+import { F as FirestoreSyncConfig, S as SyncEvent } from './types-FLGn8CAI.js';
+import { O as OpenAPIDocument } from './openapi-DB8bXZB-.js';
 import * as firebase_functions_v2_https from 'firebase-functions/v2/https';
 import { onRequest, HttpsOptions } from 'firebase-functions/v2/https';
-import { H as HistoryTriggersConfig } from './read-BSyLao3I.js';
-import { C as ConfiguredRepository, a as CrudServerOptions, b as CrudRepoConfig } from './types-5vgXdUM2.js';
-import { A as AdminServerOptions, a as AdminRepoConfig } from './index-BxurOEz1.js';
+import { H as HistoryTriggersConfig } from './read-CTWZjxyh.js';
+import { C as ConfiguredRepository, a as CrudServerOptions, b as CrudRepoConfig } from './types-BHZ-Gk-s.js';
+import { A as AdminServerOptions, a as AdminRepoConfig } from './index-oFhGCBrY.js';
 
 /** Per-repo admin config with `repo` omitted (auto-bound from the registry key). */
 type BoundAdminRepoConfig<TRepo extends ConfiguredRepository<any>> = Omit<AdminRepoConfig<TRepo>, "repo">;

package/dist/{firebase-auth-D1APf9PA.d.cts → firebase-auth-Dpvrd8MP.d.cts}

@@ -272,6 +272,19 @@ interface FirebaseAuthConfig<TContext = unknown> {
     secureCookie?: boolean;
     /** Cookie `SameSite`. Default: `"Lax"`. */
     sameSite?: "Strict" | "Lax" | "None";
+    /**
+     * Enable the built-in CSRF defense: state-changing requests
+     * (`POST`/`PUT`/`PATCH`/`DELETE`) authenticated by **session cookie** must
+     * carry an `Origin`/`Referer` header matching the request host. Bearer
+     * requests are exempt (a browser never auto-attaches an `Authorization`
+     * header, so they are not CSRF-able).
+     *
+     * Defaults to `true` for `cookie`/`both` modes and `false` for `bearer`.
+     * This is the primary protection when `sameSite: "None"` is used and a
+     * defense-in-depth layer otherwise. Disable only if you implement your own
+     * CSRF protection upstream.
+     */
+    csrfProtection?: boolean;
     /**
      * Behaviour when authentication fails or `allow()` returns `null`.
      * - `"redirect"` (default in cookie mode) → 302 to the login page,

package/dist/{firebase-auth-D1APf9PA.d.ts → firebase-auth-Dpvrd8MP.d.ts}

@@ -272,6 +272,19 @@ interface FirebaseAuthConfig<TContext = unknown> {
     secureCookie?: boolean;
     /** Cookie `SameSite`. Default: `"Lax"`. */
     sameSite?: "Strict" | "Lax" | "None";
+    /**
+     * Enable the built-in CSRF defense: state-changing requests
+     * (`POST`/`PUT`/`PATCH`/`DELETE`) authenticated by **session cookie** must
+     * carry an `Origin`/`Referer` header matching the request host. Bearer
+     * requests are exempt (a browser never auto-attaches an `Authorization`
+     * header, so they are not CSRF-able).
+     *
+     * Defaults to `true` for `cookie`/`both` modes and `false` for `bearer`.
+     * This is the primary protection when `sameSite: "None"` is used and a
+     * defense-in-depth layer otherwise. Disable only if you implement your own
+     * CSRF protection upstream.
+     */
+    csrfProtection?: boolean;
     /**
      * Behaviour when authentication fails or `allow()` returns `null`.
      * - `"redirect"` (default in cookie mode) → 302 to the login page,

package/dist/history/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var firestore=require('firebase-admin/firestore'),crypto=require('crypto');function O(t){if(t===null)return "null";if(t===void 0)return "undefined";if(t instanceof firestore.Timestamp)return "timestamp";if(t instanceof Date)return "date";if(Array.isArray(t))return "array";let e=typeof t;return e==="string"||e==="number"||e==="boolean"?e:"object"}function C(t,e){if(t===e)return  true;if(t===null||e===null||t===void 0||e===void 0)return t===e;if(t instanceof firestore.Timestamp&&e instanceof firestore.Timestamp)return t.isEqual(e);if(t instanceof Date&&e instanceof Date)return t.getTime()===e.getTime();if(Array.isArray(t)&&Array.isArray(e)){if(t.length!==e.length)return  false;for(let r=0;r<t.length;r++)if(!C(t[r],e[r]))return  false;return  true}if(typeof t=="object"&&typeof e=="object")try{return JSON.stringify(t)===JSON.stringify(e)}catch{return  false}return  false}function b(t,e,r={}){let o=new Set([...r.exclude??[],...r.metaFields??[],...r.systemKeys??[]]),s=r.include?new Set(r.include):null,l=t??{},a=e??{},y=new Set([...Object.keys(l),...Object.keys(a)]),T={};for(let p of y){if(o.has(p)||s&&!s.has(p))continue;let i=l[p],n=a[p];C(i,n)||(T[p]={oldValue:i===void 0?null:i,newValue:n===void 0?null:n,type:{old:O(i),new:O(n)}});}return T}var U=7e5;function w(t){let e=t.ttlOverride??t.config.ttl,o={schemaVersion:2,historyDocId:crypto.randomUUID(),historyToObjectId:t.entityId,historySetAt:firestore.Timestamp.now(),operation:t.operation,meta:t.meta,changes:t.changes};e&&(o.expiresAt=firestore.Timestamp.fromMillis(Date.now()+e.days*24*60*60*1e3));let s=l=>{try{return Buffer.byteLength(JSON.stringify(l,(a,y)=>y instanceof firestore.Timestamp?y.toMillis():y),"utf8")}catch{return 0}};if(s(o.changes)>U){let l={};for(let[a,y]of Object.entries(o.changes)){let T=s(y.oldValue),p=s(y.newValue);l[a]={oldValue:T>5e4?"[truncated]":y.oldValue,newValue:p>5e4?"[truncated]":y.newValue,type:y.type};}o.changes=l,o._truncated=true;}return o}async function D(t,e,r,o){let s=e;return r.onBeforeWrite&&(s=await r.onBeforeWrite(e,o)),s?(await t.doc(s.historyDocId).set(s),{written:true,entry:s}):{written:false,reason:"dropped-by-onBeforeWrite"}}function M(t,e){let r=t??{},o={},s=e.meta;if(!s)return o;let l=i=>{if(!i)return;let n=r[i];return n===void 0||n===null?null:String(n)},a=l(s.userId);a!==void 0&&(o.userId=a);let y=l(s.userEmail);y!==void 0&&(o.userEmail=y);let T=l(s.reason);T!==void 0&&(o.reason=T);let p=l(s.comment);if(p!==void 0&&(o.comment=p),s.extras&&s.extras.length>0){let i={},n=false;for(let f of s.extras)f in r&&(i[f]=r[f],n=true);n&&(o.extras=i);}return o}function E(t){let e=t.meta;if(!e)return [];let r=[];return e.userId&&r.push(e.userId),e.userEmail&&r.push(e.userEmail),e.reason&&r.push(e.reason),e.comment&&r.push(e.comment),e.extras&&r.push(...e.extras),r}var B="history";function N(t,e){let r=e.ref?.path??void 0;return r?`${r}/{docId}`:(console.warn(`[HistoryTriggers] Cannot determine collection path for "${t}". Skipping.`),null)}function K(t,e){let{onDocumentWritten:r}=e.deps,o={};for(let[s,l]of Object.entries(t)){let a=l._historyConfig??(typeof l.history=="object"&&l.history!==null&&"enabled"in l.history?l.history:void 0);if(!a?.enabled)continue;let y=a.subcollection??B,T=a.ttl??e.defaults?.ttl,p=e.repos?.[s],i;if(l._isGroup){if(!p?.triggerPath){console.warn(`[HistoryTriggers] Skipping collection-group repo "${s}". Provide a triggerPath in the history triggers repos override.`);continue}i=p.triggerPath;}else i=p?.triggerPath??N(s,l);if(!i)continue;let n=l._systemKeys??[],f=n[0]??"docId",c=E(a);o[`${s}_onHistory`]=r(i,async u=>{try{let m=u.data?.before?.data(),d=u.data?.after?.data(),H;if(!m&&d)H="create";else if(m&&!d)H="delete";else if(m&&d)H="update";else return;let h=String(d?.[f]??m?.[f]??u.params?.docId??u.data?.after?.id??u.data?.before?.id??"");if(!h)return;let g=b(m??{},d??{},{include:a.include,exclude:a.exclude,metaFields:c,systemKeys:n});if(H==="update"&&Object.keys(g).length===0)return;let x=M(d??m??null,a),L=w({entityId:h,operation:H,changes:g,meta:x,config:a,ttlOverride:T}),I=u.data?.after?.ref??u.data?.before?.ref;if(!I)return;let P=I.collection(y);await D(P,L,a,{repoName:s,docId:h,before:m??null,after:d??null});}catch(m){console.error(`[HistoryTriggers] Failed to record history for "${s}":`,m);}});}return o}var S=5;function v(t){return t.schemaVersion===2}function F(t){if(typeof t!="string")return "object";switch(t){case "string":case "number":case "boolean":case "object":case "array":case "timestamp":case "date":case "null":case "undefined":return t;default:return "object"}}function W(t){return {historyDocId:t.historyDocId,historyToObjectId:t.historyToObjectId,historySetAt:t.historySetAt,schemaVersion:2,operation:t.operation,meta:t.meta??{},changes:t.changes??{}}}function z(t){let e={};t.historyUserId!==void 0&&(e.userId=t.historyUserId??null),t.historyUserEmail!==void 0&&(e.userEmail=t.historyUserEmail??null);let r=t.extraHistoryDetails??null;r&&(r.reason!==void 0&&(e.reason=r.reason??null),r.comment!==void 0&&(e.comment=r.comment??null));let o={},s=false;if(t.historyDetails&&typeof t.historyDetails=="object")for(let[l,a]of Object.entries(t.historyDetails))o[l]=a,s=true;if(t.extraContentKeys&&typeof t.extraContentKeys=="object")for(let[l,a]of Object.entries(t.extraContentKeys))o[`content.${l}`]=a,s=true;return s&&(e.extras=o),e}function $(t){let e=t.changes?.oldValue??null,r=t.changes?.newValue??null,o=t.types?.oldValue,s=t.types?.newValue;return {oldValue:e,newValue:r,type:{old:o?F(o):O(e),new:s?F(s):O(r)}}}function q(t){let e=$(t),r=z(t);return {historyDocId:t.historyDocId,historyToObjectId:t.historyToObjectId,historySetAt:t.historySetAt,schemaVersion:1,operation:"update",meta:r,changes:{[t.field]:e}}}function G(t,e,r){return Math.abs(t.toMillis()-e.toMillis())<=r}function J(t,e){return (t.userId??null)===(e.userId??null)}function A(t,e={}){let r=e.groupToleranceMs??S,o=[];for(let s of t){if(v(s)){o.push(W(s));continue}let a=q(s),y=o[o.length-1];y&&y.schemaVersion===1&&G(y.historySetAt,a.historySetAt,r)&&J(y.meta,a.meta)?Object.assign(y.changes,a.changes):o.push(a);}return o}var X="history",Y=50;function j(t,e,r){return t(...r).collection(e)}function Q(t){return String(t[t.length-1]??"")}function Z(t,e,r,o){if(!o?.enabled)return null;let s=o.subcollection??X;async function l(...i){let n={},f=i,c=i[i.length-1];c!==null&&typeof c=="object"&&!(c instanceof firestore.Timestamp)&&("limit"in c||"cursor"in c||"direction"in c)&&(n=c,f=i.slice(0,-1));let u=j(t,s,f),m=n.direction??"desc",d=u.orderBy("historySetAt",m);return n.cursor&&(d=d.startAfter(n.cursor)),n.limit&&n.limit>0&&(d=d.limit(n.limit)),(await d.get()).docs.map(h=>({id:h.id,data:h.data()}))}async function a(...i){let n={},f=i,c=i[i.length-1];c!==null&&typeof c=="object"&&!(c instanceof firestore.Timestamp)&&("limit"in c||"cursor"in c||"direction"in c||"fields"in c||"operations"in c)&&(n=c,f=i.slice(0,-1));let u=n.limit??Y,m=Math.max(u,Math.min(u*8,500)),d=await l(...f,{limit:m,cursor:n.cursor,direction:n.direction??"desc"}),H=A(d.map(h=>h.data));if(n.fields&&n.fields.length>0){let h=new Set(n.fields);H=H.filter(g=>Object.keys(g.changes).some(x=>h.has(x)));}if(n.operations&&n.operations.length>0){let h=new Set(n.operations);H=H.filter(g=>h.has(g.operation));}return H.slice(0,u)}async function y(...i){let n=i[i.length-1],f={},c,u;return n!==null&&typeof n=="object"&&!(n instanceof firestore.Timestamp)?(f=n,c=i[i.length-2],u=i.slice(0,-2)):(c=n,u=i.slice(0,-1)),a(...u,{...f,fields:[c]})}async function T(...i){let n=i[i.length-1],f={},c,u;return n!==null&&typeof n=="object"&&!(n instanceof firestore.Timestamp)?(f=n,c=i[i.length-2],u=i.slice(0,-2)):(c=n,u=i.slice(0,-1)),a(...u,{...f,operations:[c]})}async function p(...i){let n=i[i.length-1],f=i.slice(0,-1),c=Q(f),u=b(n.before??{},n.after??{},{include:o.include,exclude:o.exclude,metaFields:E(o),systemKeys:e});if(n.operation==="update"&&Object.keys(u).length===0)return null;let d={...M(n.after??n.before??null,o),...n.meta??{}},H=w({entityId:c,operation:n.operation,changes:u,meta:d,config:o}),h=j(t,s,f),g=await D(h,H,o,{repoName:r,docId:c,before:n.before??null,after:n.after??null});return !g.written||!g.entry?null:{historyDocId:g.entry.historyDocId,historyToObjectId:g.entry.historyToObjectId,historySetAt:g.entry.historySetAt,schemaVersion:2,operation:g.entry.operation,meta:g.entry.meta,changes:g.entry.changes}}return {list:a,raw:l,byField:y,byOperation:T,recordManual:p}}exports.DEFAULT_GROUP_TOLERANCE_MS=S;exports.buildHistoryEntry=w;exports.computeDiff=b;exports.createHistoryMethods=Z;exports.createHistoryTriggers=K;exports.extractMeta=M;exports.metaFieldsOf=E;exports.normalizeHistoryDocs=A;exports.valueType=O;exports.valuesEqual=C;exports.writeHistoryEntry=D;//# sourceMappingURL=index.cjs.map
+'use strict';var firestore=require('firebase-admin/firestore'),crypto=require('crypto');function w(t){if(t===null)return "null";if(t===void 0)return "undefined";if(t instanceof firestore.Timestamp)return "timestamp";if(t instanceof Date)return "date";if(Array.isArray(t))return "array";let e=typeof t;return e==="string"||e==="number"||e==="boolean"?e:"object"}function V(t,e,o=new WeakMap){if(t===e)return  true;if(t===null||e===null||t===void 0||e===void 0)return t===e;if(t instanceof firestore.Timestamp&&e instanceof firestore.Timestamp)return t.isEqual(e);if(t instanceof Date&&e instanceof Date)return t.getTime()===e.getTime();if(Array.isArray(t)||Array.isArray(e)){if(!Array.isArray(t)||!Array.isArray(e)||t.length!==e.length)return  false;if(o.get(t)===e)return  true;o.set(t,e);for(let r=0;r<t.length;r++)if(!V(t[r],e[r],o))return  false;return  true}if(typeof t=="object"&&typeof e=="object"){if(t instanceof Date||e instanceof Date||t instanceof firestore.Timestamp||e instanceof firestore.Timestamp)return  false;if(o.get(t)===e)return  true;o.set(t,e);let r=Object.keys(t),i=Object.keys(e);if(r.length!==i.length)return  false;for(let a of r)if(!Object.prototype.hasOwnProperty.call(e,a)||!V(t[a],e[a],o))return  false;return  true}return  false}function D(t,e,o={}){let r=new Set([...o.exclude??[],...o.metaFields??[],...o.systemKeys??[]]),i=o.include?new Set(o.include):null,a=t??{},c=e??{},y=new Set([...Object.keys(a),...Object.keys(c)]),T={};for(let p of y){if(r.has(p)||i&&!i.has(p))continue;let s=a[p],n=c[p];V(s,n)||(T[p]={oldValue:s===void 0?null:s,newValue:n===void 0?null:n,type:{old:w(s),new:w(n)}});}return T}var U=7e5;function b(t){let e=t.ttlOverride??t.config.ttl,r={schemaVersion:2,historyDocId:crypto.randomUUID(),historyToObjectId:t.entityId,historySetAt:firestore.Timestamp.now(),operation:t.operation,meta:t.meta,changes:t.changes};e&&(r.expiresAt=firestore.Timestamp.fromMillis(Date.now()+e.days*24*60*60*1e3));let i=a=>{try{return Buffer.byteLength(JSON.stringify(a,(c,y)=>y instanceof firestore.Timestamp?y.toMillis():y),"utf8")}catch{return 0}};if(i(r.changes)>U){let a={};for(let[c,y]of Object.entries(r.changes)){let T=i(y.oldValue),p=i(y.newValue);a[c]={oldValue:T>5e4?"[truncated]":y.oldValue,newValue:p>5e4?"[truncated]":y.newValue,type:y.type};}r.changes=a,r._truncated=true;}return r}async function M(t,e,o,r){let i=e;return o.onBeforeWrite&&(i=await o.onBeforeWrite(e,r)),i?(await t.doc(i.historyDocId).set(i),{written:true,entry:i}):{written:false,reason:"dropped-by-onBeforeWrite"}}function k(t,e){let o=t??{},r={},i=e.meta;if(!i)return r;let a=s=>{if(!s)return;let n=o[s];return n===void 0||n===null?null:String(n)},c=a(i.userId);c!==void 0&&(r.userId=c);let y=a(i.userEmail);y!==void 0&&(r.userEmail=y);let T=a(i.reason);T!==void 0&&(r.reason=T);let p=a(i.comment);if(p!==void 0&&(r.comment=p),i.extras&&i.extras.length>0){let s={},n=false;for(let f of i.extras)f in o&&(s[f]=o[f],n=true);n&&(r.extras=s);}return r}function E(t){let e=t.meta;if(!e)return [];let o=[];return e.userId&&o.push(e.userId),e.userEmail&&o.push(e.userEmail),e.reason&&o.push(e.reason),e.comment&&o.push(e.comment),e.extras&&o.push(...e.extras),o}var B="history";function K(t,e){let o=e.ref?.path??void 0;return o?`${o}/{docId}`:(console.warn(`[HistoryTriggers] Cannot determine collection path for "${t}". Skipping.`),null)}function N(t,e){let{onDocumentWritten:o}=e.deps,r={};for(let[i,a]of Object.entries(t)){let c=a._historyConfig??(typeof a.history=="object"&&a.history!==null&&"enabled"in a.history?a.history:void 0);if(!c?.enabled)continue;let y=c.subcollection??B,T=c.ttl??e.defaults?.ttl,p=e.repos?.[i],s;if(a._isGroup){if(!p?.triggerPath){console.warn(`[HistoryTriggers] Skipping collection-group repo "${i}". Provide a triggerPath in the history triggers repos override.`);continue}s=p.triggerPath;}else s=p?.triggerPath??K(i,a);if(!s)continue;let n=a._systemKeys??[],f=n[0]??"docId",l=E(c);r[`${i}_onHistory`]=o(s,async u=>{try{let m=u.data?.before?.data(),d=u.data?.after?.data(),H;if(!m&&d)H="create";else if(m&&!d)H="delete";else if(m&&d)H="update";else return;let h=String(d?.[f]??m?.[f]??u.params?.docId??u.data?.after?.id??u.data?.before?.id??"");if(!h)return;let g=D(m??{},d??{},{include:c.include,exclude:c.exclude,metaFields:l,systemKeys:n});if(H==="update"&&Object.keys(g).length===0)return;let R=k(d??m??null,c),L=b({entityId:h,operation:H,changes:g,meta:R,config:c,ttlOverride:T}),I=u.data?.after?.ref??u.data?.before?.ref;if(!I)return;let P=I.collection(y);await M(P,L,c,{repoName:i,docId:h,before:m??null,after:d??null});}catch(m){console.error(`[HistoryTriggers] Failed to record history for "${i}":`,m);}});}return r}var j=5;function W(t){return t.schemaVersion===2}function F(t){if(typeof t!="string")return "object";switch(t){case "string":case "number":case "boolean":case "object":case "array":case "timestamp":case "date":case "null":case "undefined":return t;default:return "object"}}function v(t){return {historyDocId:t.historyDocId,historyToObjectId:t.historyToObjectId,historySetAt:t.historySetAt,schemaVersion:2,operation:t.operation,meta:t.meta??{},changes:t.changes??{}}}function z(t){let e={};t.historyUserId!==void 0&&(e.userId=t.historyUserId??null),t.historyUserEmail!==void 0&&(e.userEmail=t.historyUserEmail??null);let o=t.extraHistoryDetails??null;o&&(o.reason!==void 0&&(e.reason=o.reason??null),o.comment!==void 0&&(e.comment=o.comment??null));let r={},i=false;if(t.historyDetails&&typeof t.historyDetails=="object")for(let[a,c]of Object.entries(t.historyDetails))r[a]=c,i=true;if(t.extraContentKeys&&typeof t.extraContentKeys=="object")for(let[a,c]of Object.entries(t.extraContentKeys))r[`content.${a}`]=c,i=true;return i&&(e.extras=r),e}function $(t){let e=t.changes?.oldValue??null,o=t.changes?.newValue??null,r=t.types?.oldValue,i=t.types?.newValue;return {oldValue:e,newValue:o,type:{old:r?F(r):w(e),new:i?F(i):w(o)}}}function q(t){let e=$(t),o=z(t);return {historyDocId:t.historyDocId,historyToObjectId:t.historyToObjectId,historySetAt:t.historySetAt,schemaVersion:1,operation:"update",meta:o,changes:{[t.field]:e}}}function G(t,e,o){return Math.abs(t.toMillis()-e.toMillis())<=o}function J(t,e){return (t.userId??null)===(e.userId??null)}function C(t,e={}){let o=e.groupToleranceMs??j,r=[];for(let i of t){if(W(i)){r.push(v(i));continue}let c=q(i),y=r[r.length-1];y&&y.schemaVersion===1&&G(y.historySetAt,c.historySetAt,o)&&J(y.meta,c.meta)?Object.assign(y.changes,c.changes):r.push(c);}return r}var X="history",Y=50;function S(t,e,o){return t(...o).collection(e)}function Q(t){return String(t[t.length-1]??"")}function Z(t,e,o,r){if(!r?.enabled)return null;let i=r.subcollection??X;async function a(...s){let n={},f=s,l=s[s.length-1];l!==null&&typeof l=="object"&&!(l instanceof firestore.Timestamp)&&("limit"in l||"cursor"in l||"direction"in l)&&(n=l,f=s.slice(0,-1));let u=S(t,i,f),m=n.direction??"desc",d=u.orderBy("historySetAt",m);return n.cursor&&(d=d.startAfter(n.cursor)),n.limit&&n.limit>0&&(d=d.limit(n.limit)),(await d.get()).docs.map(h=>({id:h.id,data:h.data()}))}async function c(...s){let n={},f=s,l=s[s.length-1];l!==null&&typeof l=="object"&&!(l instanceof firestore.Timestamp)&&("limit"in l||"cursor"in l||"direction"in l||"fields"in l||"operations"in l)&&(n=l,f=s.slice(0,-1));let u=n.limit??Y,m=Math.max(u,Math.min(u*8,500)),d=await a(...f,{limit:m,cursor:n.cursor,direction:n.direction??"desc"}),H=C(d.map(h=>h.data));if(n.fields&&n.fields.length>0){let h=new Set(n.fields);H=H.filter(g=>Object.keys(g.changes).some(R=>h.has(R)));}if(n.operations&&n.operations.length>0){let h=new Set(n.operations);H=H.filter(g=>h.has(g.operation));}return H.slice(0,u)}async function y(...s){let n=s[s.length-1],f={},l,u;return n!==null&&typeof n=="object"&&!(n instanceof firestore.Timestamp)?(f=n,l=s[s.length-2],u=s.slice(0,-2)):(l=n,u=s.slice(0,-1)),c(...u,{...f,fields:[l]})}async function T(...s){let n=s[s.length-1],f={},l,u;return n!==null&&typeof n=="object"&&!(n instanceof firestore.Timestamp)?(f=n,l=s[s.length-2],u=s.slice(0,-2)):(l=n,u=s.slice(0,-1)),c(...u,{...f,operations:[l]})}async function p(...s){let n=s[s.length-1],f=s.slice(0,-1),l=Q(f),u=D(n.before??{},n.after??{},{include:r.include,exclude:r.exclude,metaFields:E(r),systemKeys:e});if(n.operation==="update"&&Object.keys(u).length===0)return null;let d={...k(n.after??n.before??null,r),...n.meta??{}},H=b({entityId:l,operation:n.operation,changes:u,meta:d,config:r}),h=S(t,i,f),g=await M(h,H,r,{repoName:o,docId:l,before:n.before??null,after:n.after??null});return !g.written||!g.entry?null:{historyDocId:g.entry.historyDocId,historyToObjectId:g.entry.historyToObjectId,historySetAt:g.entry.historySetAt,schemaVersion:2,operation:g.entry.operation,meta:g.entry.meta,changes:g.entry.changes}}return {list:c,raw:a,byField:y,byOperation:T,recordManual:p}}exports.DEFAULT_GROUP_TOLERANCE_MS=j;exports.buildHistoryEntry=b;exports.computeDiff=D;exports.createHistoryMethods=Z;exports.createHistoryTriggers=N;exports.extractMeta=k;exports.metaFieldsOf=E;exports.normalizeHistoryDocs=C;exports.valueType=w;exports.valuesEqual=V;exports.writeHistoryEntry=M;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map