@open-xamu-co/firebase-nuxt 2.0.0-next.1 → 2.0.0-next.11

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 Firebase nuxt
 
+# [2.0.0-next.11](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.10...v2.0.0-next.11) (2026-04-03)
+
+
+### Bug Fixes
+
+* bump for editor fixes ([061e550](https://github.com/xamu-co/firebase-nuxt/commit/061e550052d42068c03ef25344aebb706ea29acd))
+
+# [2.0.0-next.10](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.9...v2.0.0-next.10) (2026-01-27)
+
+
+### Bug Fixes
+
+* define default cache header on helper handler ([48bcfab](https://github.com/xamu-co/firebase-nuxt/commit/48bcfab258e054179524824b67b89745a757eb60))
+* remove unsafe csurf module ([61c0487](https://github.com/xamu-co/firebase-nuxt/commit/61c0487a39ea7569e17468d64974dd8a1e8bd16c))
+
+
+### BREAKING CHANGES
+
+* removed csurf module and related helpers
+
+# [2.0.0-next.9](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.8...v2.0.0-next.9) (2026-01-21)
+
+
+### Bug Fixes
+
+* bump for editor fix ([46eec97](https://github.com/xamu-co/firebase-nuxt/commit/46eec975e7706188e883b375b314dfd020bf1968))
+
+# [2.0.0-next.8](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.7...v2.0.0-next.8) (2026-01-21)
+
+
+### Features
+
+* bump for useMarkdown ([8c7cfd2](https://github.com/xamu-co/firebase-nuxt/commit/8c7cfd28e750a940aa8705ac35308312c4cdc41e))
+
+# [2.0.0-next.7](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.6...v2.0.0-next.7) (2026-01-20)
+
+
+### Bug Fixes
+
+* configurable default on session store actions ([117ce2e](https://github.com/xamu-co/firebase-nuxt/commit/117ce2e206563f4aa14eba7d427c9432cbfb7705))
+
+# [2.0.0-next.6](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.5...v2.0.0-next.6) (2026-01-20)
+
+
+### Features
+
+* generate weighted search indexes ([36fdabc](https://github.com/xamu-co/firebase-nuxt/commit/36fdabc0ed5060813f2abf3aa748f023d9d3bb8f))
+
+# [2.0.0-next.5](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.4...v2.0.0-next.5) (2026-01-20)
+
+
+### Bug Fixes
+
+* bump for mapNodes priority ([08df299](https://github.com/xamu-co/firebase-nuxt/commit/08df29970297b82830253dfdd1920a1e9afd8f13))
+
+# [2.0.0-next.4](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.3...v2.0.0-next.4) (2026-01-20)
+
+
+### Bug Fixes
+
+* crash firestore method if missing instance ([4d29aec](https://github.com/xamu-co/firebase-nuxt/commit/4d29aece4c13e80070e97aa63ee8d8609755ef4b))
+* preserve creation date ([7a3c2d2](https://github.com/xamu-co/firebase-nuxt/commit/7a3c2d21a3ef82cc6d736f918d30f3086c4f6fae))
+* soundex algorithm as param ([2fceb8d](https://github.com/xamu-co/firebase-nuxt/commit/2fceb8d3097e92dee91baae642a0c88a3c3e061a))
+
+
+### Features
+
+* bump for code editor ([838f5b3](https://github.com/xamu-co/firebase-nuxt/commit/838f5b327c3dd4681cb3d68200ec4aa1be9a6afe))
+
+
+### BREAKING CHANGES
+
+* onDelete >>> onDeleted
+
+# [2.0.0-next.3](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.2...v2.0.0-next.3) (2026-01-16)
+
+
+### Bug Fixes
+
+* bump dependencies for h3 vurnerability ([30f8565](https://github.com/xamu-co/firebase-nuxt/commit/30f85650c08814838bf967a4f524d32f245f1f45))
+
+# [2.0.0-next.2](https://github.com/xamu-co/firebase-nuxt/compare/v2.0.0-next.1...v2.0.0-next.2) (2026-01-15)
+
+
+### Bug Fixes
+
+* prevent no content on head responses ([a16a768](https://github.com/xamu-co/firebase-nuxt/commit/a16a7682d3fb322bafda64177f5d57541069beac))
+
+
+### Features
+
+* accept head & options request ([2822f2f](https://github.com/xamu-co/firebase-nuxt/commit/2822f2ffeb27cc5b6034cb4fe131ae20ae0bde99))
+
+
+### BREAKING CHANGES
+
+* less args at resolveServerDocumentRefs
+
 # [2.0.0-next.1](https://github.com/xamu-co/firebase-nuxt/compare/v1.2.0-next.2...v2.0.0-next.1) (2026-01-13)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Xamu nuxt firebase module
 
-Powered by Nuxt.js
+Powered by [Nuxt.js](https://nuxt.com) & [Xamu UI](https://github.com/xamu-co/ui)
 
 ## Prerequisites
 
@@ -57,10 +57,6 @@ F_CLIENT_EMAIL=""
 # App check, site key, public
 RECAPTCHA_ENTERPRISE_SITE_KEY=
 
-# CSRF protection (32 bytes)
-# By default csurf uses `crypto.randomBytes(22).toString("base64")`
-CSURF_SECRET=
-
 # Project
 ORIGIN=
 COUNTRIES_API=

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^3.0.0"
   },
-  "version": "1.2.0-next.2",
+  "version": "2.0.0-next.10",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,6 +1,6 @@
 import { defineNuxtModule, createResolver, addPlugin, addImportsDir, addComponentsDir, addServerTemplate, addServerHandler } from '@nuxt/kit';
 import { locale } from '../dist/runtime/client/utils/locale.js';
-import { csurfSecret, debugNuxt, port, publicRuntimeConfig } from '../dist/runtime/server/utils/environment.js';
+import { debugNuxt, port, publicRuntimeConfig } from '../dist/runtime/server/utils/environment.js';
 
 const module$1 = defineNuxtModule({
   meta: {
@@ -84,50 +84,45 @@ const module$1 = defineNuxtModule({
       middleware: true,
       handler: resolve(runtimePath, "server/middleware/1.context")
     });
-    if (moduleOptions.media) {
-      addServerHandler({
-        method: "get",
-        route: "/api/media/**:path",
-        handler: resolve(runtimePath, "server/api/media.get")
-      });
-    }
-    if (moduleOptions.readCollection) {
-      addServerHandler({
-        method: "get",
-        route: "/api/all/:collectionId",
-        handler: resolve(runtimePath, "server/api/all-collection.get")
-      });
-      addServerHandler({
-        method: "get",
-        route: "/api/all/:collectionId/:documentId",
-        handler: resolve(runtimePath, "server/api/all-collection-document.get")
-      });
-    }
-    if (moduleOptions.readInstanceCollection) {
-      addServerHandler({
-        method: "get",
-        route: "/api/instance/all/:collectionId",
-        handler: resolve(runtimePath, "server/api/all-collection.get")
-      });
-      addServerHandler({
-        method: "get",
-        route: "/api/instance/all/:collectionId/:documentId",
-        handler: resolve(runtimePath, "server/api/all-collection-document.get")
-      });
-    }
+    const methods = ["get", "head", "options"];
+    methods.forEach((method) => {
+      if (moduleOptions.media) {
+        addServerHandler({
+          method,
+          route: "/api/media/**:path",
+          handler: resolve(runtimePath, "server/api/media")
+        });
+      }
+      if (moduleOptions.readCollection) {
+        addServerHandler({
+          method,
+          route: "/api/all/:collectionId",
+          handler: resolve(runtimePath, "server/api/all-collection")
+        });
+        addServerHandler({
+          method,
+          route: "/api/all/:collectionId/:documentId",
+          handler: resolve(runtimePath, "server/api/all-collection-document")
+        });
+      }
+      if (moduleOptions.readInstanceCollection) {
+        addServerHandler({
+          method,
+          route: "/api/instance/all/:collectionId",
+          handler: resolve(runtimePath, "server/api/all-collection")
+        });
+        addServerHandler({
+          method,
+          route: "/api/instance/all/:collectionId/:documentId",
+          handler: resolve(runtimePath, "server/api/all-collection-document")
+        });
+      }
+    });
   },
   moduleDependencies() {
     const { resolve } = createResolver(import.meta.url);
     const runtimePath = resolve("./runtime");
     return {
-      "nuxt-csurf": {
-        version: ">=1.6.5",
-        defaults: {
-          addCsrfTokenToEventCtx: true,
-          // Run server side
-          encryptSecret: csurfSecret.value() || void 0
-        }
-      },
       "@open-xamu-co/ui-nuxt": {
         version: ">=4.0.0-next.4",
         defaults: {

package/dist/runtime/client/types/entities/logs.d.ts

@@ -1,4 +1,5 @@
-import type { LogData } from "../../../functions/types/index.js";
+import type { DocumentReference } from "firebase/firestore";
+import type { LogData, OffenderData } from "../../../functions/types/index.js";
 import type { FromData } from "./base.js";
 import type { GetSharedRef } from "./user.js";
 /** @output Log */
@@ -7,3 +8,11 @@ export interface Log extends FromData<LogData> {
 /** @input Omit automation */
 export interface LogRef extends GetSharedRef<Log> {
 }
+/** @output Offender */
+export interface Offender extends FromData<OffenderData> {
+    lastLog?: Log;
+}
+/** @input Omit automation */
+export interface OffenderRef extends GetSharedRef<Offender> {
+    lastLogRef?: DocumentReference<LogData>;
+}

package/dist/runtime/client/types/entities/user.d.ts

@@ -9,7 +9,7 @@ import type { Instance, SharedDocument } from "./instance.js";
  * Removed properties are not required or are part of automation
  */
 export type GetSharedRef<T extends SharedDocument, O extends keyof T = never> = {
-    [K in keyof FromData<Omit<T, "id" | O>> as K extends `${string}At` ? never : K]: FromData<Omit<T, "id" | O>>[K];
+    [K in keyof FromData<Omit<T, O>> as K extends `${string}At` ? never : K]: FromData<Omit<T, O>>[K];
 } & {
     createdByRef?: DocumentReference | FieldValue;
     updatedByRef?: DocumentReference | FieldValue;

package/dist/runtime/client/utils/locale.d.ts

@@ -109,6 +109,12 @@ export declare const locale: {
     form_invalid_data: string;
     form_no_values: string;
     form_new_value: string;
+    form_editor_preview: string;
+    form_editor_see_preview: string;
+    form_editor_bold: string;
+    form_editor_italic: string;
+    form_editor_link: string;
+    form_editor_link_add_url: string;
     table_see_values: string;
     table_see_name: string;
     table_hide_name: string;

package/dist/runtime/composables/firestore/write.d.ts

@@ -1,11 +1,11 @@
 import { DocumentReference } from "firebase/firestore";
 import type { iNodeFnResponseStream } from "@open-xamu-co/ui-common-types";
-import type { GetRef, SharedDocument, FirebaseDocument, iSnapshotConfig } from "../../client/types/index.js";
+import type { GetRef, SharedDocument, FirebaseDocument, iSnapshotConfig, FromData } from "../../client/types/index.js";
 interface iUseDocumentOptions extends iSnapshotConfig {
     omitLoggings?: boolean;
 }
 /** Creates document with the given values */
-export declare function useDocumentCreate<Vgr extends GetRef<V>, V extends FirebaseDocument = FirebaseDocument>(collectionPath: string, partialRef: Vgr, createdCallback?: (ref: DocumentReference<Vgr, V>) => Promise<void> | void, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
+export declare function useDocumentCreate<Vgr extends GetRef<SharedDocument>, V extends FromData<Vgr> = FromData<Vgr>>(collectionPath: string, partialRef: Vgr, createdCallback?: (ref: DocumentReference<Vgr, V>) => Promise<void> | void, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
 /**
  * Updates a given document in Firestore.
  *
@@ -13,9 +13,9 @@ export declare function useDocumentCreate<Vgr extends GetRef<V>, V extends Fireb
  * @param partialRef - The partial data to update the document with.
  * @returns A boolean promise.
  */
-export declare function useDocumentUpdate<Vgr extends GetRef<V>, V extends FirebaseDocument = FirebaseDocument>(node: SharedDocument, middleRef?: Partial<Vgr>, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
+export declare function useDocumentUpdate<Vgr extends GetRef<SharedDocument>, V extends FromData<Vgr> = FromData<Vgr>>(node: SharedDocument, middleRef?: Partial<Vgr>, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
 /** Clones given document */
-export declare function useDocumentClone<Vgr extends GetRef<V>, V extends FirebaseDocument = FirebaseDocument>(node: SharedDocument, middleRef?: Partial<Vgr>, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
+export declare function useDocumentClone<Vgr extends GetRef<SharedDocument>, V extends FromData<Vgr> = FromData<Vgr>>(node: SharedDocument, middleRef?: Partial<Vgr>, { omitLoggings, ...config }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<V>>;
 /** Deletes given document */
 export declare function useDocumentDelete<T extends FirebaseDocument = FirebaseDocument>(node: SharedDocument, { omitLoggings }?: iUseDocumentOptions): Promise<iNodeFnResponseStream<T>>;
 export {};

package/dist/runtime/composables/firestore/write.js

@@ -13,10 +13,11 @@ import { getDocumentId } from "../../client/utils/resolver.js";
 import { TimedPromise } from "../../server/utils/guards.js";
 import { useAppLogger, useInstanceStore, useNuxtApp, useSessionStore } from "#imports";
 export async function useDocumentCreate(collectionPath, partialRef, createdCallback, { omitLoggings, ...config } = { omitLoggings: false, level: 0 }) {
-  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
-  if (!collectionPath || !$clientFirestore) throw new Error("Collection path is required");
   const SESSION = useSessionStore();
   const INSTANCE = useInstanceStore();
+  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
+  if (!collectionPath || !$clientFirestore) throw new Error("Collection path is required");
+  if (!INSTANCE) throw new Error("Missing instance");
   const collRef = collection($clientFirestore, collectionPath);
   if (collectionPath === "users") {
     const instanceRef = doc($clientFirestore, INSTANCE.id);
@@ -90,10 +91,11 @@ export async function useDocumentCreate(collectionPath, partialRef, createdCallb
   }
 }
 export async function useDocumentUpdate(node, middleRef = {}, { omitLoggings, ...config } = { omitLoggings: false, level: 0 }) {
-  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
-  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
   const SESSION = useSessionStore();
   const INSTANCE = useInstanceStore();
+  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
+  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
+  if (!INSTANCE) throw new Error("Missing instance");
   const docRef = doc($clientFirestore, node.id || "");
   const partialRef = middleRef;
   const lastUpdatedAt = node.updatedAt ? new Date(node.updatedAt).getTime() : 0;
@@ -158,10 +160,11 @@ export async function useDocumentUpdate(node, middleRef = {}, { omitLoggings, ..
   }
 }
 export async function useDocumentClone(node, middleRef = {}, { omitLoggings, ...config } = { omitLoggings: false, level: 0 }) {
-  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
-  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
   const SESSION = useSessionStore();
   const INSTANCE = useInstanceStore();
+  const { $clientFirestore, $resolveClientRefs } = useNuxtApp();
+  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
+  if (!INSTANCE) throw new Error("Missing instance");
   const docRef = doc($clientFirestore, node.id);
   const partialRef = middleRef;
   const source = (await getDoc(docRef)).data();
@@ -233,10 +236,11 @@ export async function useDocumentClone(node, middleRef = {}, { omitLoggings, ...
   }
 }
 export async function useDocumentDelete(node, { omitLoggings } = { omitLoggings: false, level: 0 }) {
-  const { $clientFirestore } = useNuxtApp();
-  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
   const SESSION = useSessionStore();
   const INSTANCE = useInstanceStore();
+  const { $clientFirestore } = useNuxtApp();
+  if (!node.id || !$clientFirestore) throw new Error("Document id is required");
+  if (!INSTANCE) throw new Error("Missing instance");
   const docRef = doc($clientFirestore, node.id);
   const memberId = getDocumentId(SESSION.path);
   const memberPath = `${INSTANCE.id}/members/${memberId}`;

package/dist/runtime/composables/store/session.d.ts

@@ -15,7 +15,7 @@ export declare const useSessionStore: import("pinia").StoreDefinition<"session",
     path: import("vue").ComputedRef<string>;
     setUser: ({ createdAt, updatedAt, ...userData }: User, token: string) => void;
     unsetSession: (expiredToken?: boolean) => void;
-    logout: (clientAuth?: Auth) => Promise<void>;
+    logout: (clientAuth?: Auth, unsetSessionFn?: (expiredToken?: boolean) => void) => Promise<void>;
     remove: (clientAuth?: Auth) => Promise<void>;
 }, "user" | "token" | "expiredToken">, Pick<{
     token: import("#app").CookieRef<string | null>;
@@ -24,7 +24,7 @@ export declare const useSessionStore: import("pinia").StoreDefinition<"session",
     path: import("vue").ComputedRef<string>;
     setUser: ({ createdAt, updatedAt, ...userData }: User, token: string) => void;
     unsetSession: (expiredToken?: boolean) => void;
-    logout: (clientAuth?: Auth) => Promise<void>;
+    logout: (clientAuth?: Auth, unsetSessionFn?: (expiredToken?: boolean) => void) => Promise<void>;
     remove: (clientAuth?: Auth) => Promise<void>;
 }, "path">, Pick<{
     token: import("#app").CookieRef<string | null>;
@@ -33,6 +33,6 @@ export declare const useSessionStore: import("pinia").StoreDefinition<"session",
     path: import("vue").ComputedRef<string>;
     setUser: ({ createdAt, updatedAt, ...userData }: User, token: string) => void;
     unsetSession: (expiredToken?: boolean) => void;
-    logout: (clientAuth?: Auth) => Promise<void>;
+    logout: (clientAuth?: Auth, unsetSessionFn?: (expiredToken?: boolean) => void) => Promise<void>;
     remove: (clientAuth?: Auth) => Promise<void>;
 }, "remove" | "setUser" | "unsetSession" | "logout">>;

package/dist/runtime/composables/store/session.js

@@ -1,7 +1,6 @@
 import { deleteUser } from "firebase/auth";
 import { defineStore, skipHydrate } from "pinia";
 import { computed } from "vue";
-import { getDocumentId } from "../../client/utils/resolver.js";
 import { useCookie, useRuntimeConfig, useSwal } from "#imports";
 const cookieOptionsDefaults = {
   sameSite: "strict",
@@ -28,10 +27,7 @@ export const useSessionStore = defineStore("session", () => {
     partitioned: false,
     default: () => void 0
   });
-  const path = computed(() => {
-    const id = user.value?.id;
-    return id ? `users/${getDocumentId(id)}` : "";
-  });
+  const path = computed(() => user.value?.id || "");
   function setToken(newToken, newExpiredToken = false) {
     token.value = newToken || null;
     expiredToken.value = newExpiredToken;
@@ -44,7 +40,7 @@ export const useSessionStore = defineStore("session", () => {
     setToken("", expiredToken2);
     user.value = void 0;
   }
-  async function logout(clientAuth) {
+  async function logout(clientAuth, unsetSessionFn = unsetSession) {
     if (import.meta.server) return;
     const Swal = useSwal();
     const { value } = await Swal.firePrevent({
@@ -52,7 +48,7 @@ export const useSessionStore = defineStore("session", () => {
       text: "\xBFEsta seguro de querer cerrar sesion?"
     });
     if (value) {
-      unsetSession();
+      unsetSessionFn();
       await clientAuth?.signOut();
       window.location.href = "/";
     }

package/dist/runtime/composables/useQuery.d.ts

@@ -1,8 +1,11 @@
 import type { NitroFetchOptions, NitroFetchRequest } from "nitropack";
 /**
- * Fetch wrapper with csrf token
+ * Inject auth headers and refresh token
+ *
+ * @param baseOptions
+ * @returns
  */
-export declare function useCsrfQuery<T, R extends NitroFetchRequest = NitroFetchRequest>(url: Extract<R, string>, baseOptions?: NitroFetchOptions<R>): Promise<any>;
+export declare function getQueryOptions<R extends NitroFetchRequest = NitroFetchRequest>(baseOptions?: NitroFetchOptions<R>): Promise<NitroFetchOptions<R>>;
 /**
  * Fetch wrapper
  *

package/dist/runtime/composables/useQuery.js

@@ -1,5 +1,5 @@
 import { useRequestHeaders, useNuxtApp, useRuntimeConfig, useSessionStore } from "#imports";
-async function getQueryOptions(baseOptions) {
+export async function getQueryOptions(baseOptions) {
   const SESSION = useSessionStore();
   const { $clientAuth } = useNuxtApp();
   const { cache } = useRuntimeConfig().public;
@@ -22,11 +22,6 @@ async function getQueryOptions(baseOptions) {
   }
   return { credentials: "same-origin", ...options, query, headers };
 }
-export async function useCsrfQuery(url, baseOptions) {
-  const { $csrfFetch } = useNuxtApp();
-  const { responseType, ...options } = await getQueryOptions(baseOptions);
-  return $csrfFetch(url, options);
-}
 export async function useQuery(url, baseOptions) {
   const options = await getQueryOptions(baseOptions);
   return $fetch(url, options);

package/dist/runtime/functions/types/entities/instance.d.ts

@@ -30,6 +30,12 @@ export interface RootData extends InstanceData {
     /** @example "Xamu" */
     poweredBy?: string;
 }
+export interface InstanceDataConfig extends FirebaseData {
+    /**
+     * When tenants are enabled, domains are required
+     */
+    domains?: string[];
+}
 /**
  * App instance
  *
@@ -46,13 +52,7 @@ export interface InstanceData extends SharedData {
      * @automated
      */
     url?: string;
-    config?: {
-        [key: string]: any;
-        /**
-         * When tenants are enabled, domains are required
-         */
-        domains?: string[];
-    };
+    config?: InstanceDataConfig;
 }
 /**
  * Firebase log

package/dist/runtime/functions/types/entities/logs.d.ts

@@ -1,3 +1,4 @@
+import type { DocumentReference } from "firebase-admin/firestore";
 import type { FirebaseData } from "./base.js";
 /** General log entity */
 export interface LogData extends FirebaseData {
@@ -13,3 +14,28 @@ export interface LogData extends FirebaseData {
      */
     internal?: boolean;
 }
+/**
+ * Offender entity
+ *
+ * Keep track of abbussive requests
+ */
+export interface OffenderData extends FirebaseData {
+    /** IP address */
+    ip?: string;
+    /** ISO country codes */
+    countries?: string[];
+    /** User agents */
+    userAgents?: string[];
+    /** Preferred languages */
+    languages?: string[];
+    /**
+     * Number of hits
+     * @automated
+     */
+    hits?: number;
+    /**
+     * Log reference
+     * @automated
+     */
+    lastLogRef?: DocumentReference<LogData>;
+}

package/dist/runtime/functions/utils/event.d.ts

@@ -49,7 +49,7 @@ export declare function onUpdated<T extends SharedData>(collectionPath: string,
  * @param callback callback fn
  * @returns firebase function
  */
-export declare function onDelete<T extends SharedData>(collectionPath: string, callback: (deletedDoc: QueryDocumentSnapshot<T>, utils: {
+export declare function onDeleted<T extends SharedData>(collectionPath: string, callback: (deletedDoc: QueryDocumentSnapshot<T>, utils: {
     deletedAt: Date;
     logger: tLogger;
 }) => void): import("firebase-functions/core").CloudFunction<import("firebase-functions/v2/firestore").FirestoreEvent<import("firebase-functions/v2/firestore").QueryDocumentSnapshot | undefined, Record<string, string>>>;

package/dist/runtime/functions/utils/event.js

@@ -51,8 +51,14 @@ export function onUpdated(collectionPath, callback, { defaults = {} } = {}) {
     const newDoc = data?.after;
     const oldDoc = data?.before;
     if (!newDoc || !oldDoc) return null;
-    const { updatedAt: oldUpdatedAt, updatedByRef, deletedByRef, lock } = newDoc.data();
-    const { updatedAt: newUpdatedAt } = oldDoc.data();
+    const {
+      updatedAt: oldUpdatedAt,
+      createdAt: newCreatedAt,
+      updatedByRef,
+      deletedByRef,
+      lock
+    } = newDoc.data();
+    const { updatedAt: newUpdatedAt, createdAt: oldCreatedAt = newCreatedAt } = oldDoc.data();
     const at = updatedByRef?.parent.parent || firebaseFirestore;
     const logger = makeFunctionsLogger(at, updatedByRef, metadata);
     if (deletedByRef && (!lock || Array.isArray(lock) && !lock.length)) {
@@ -60,10 +66,13 @@ export function onUpdated(collectionPath, callback, { defaults = {} } = {}) {
     }
     if (!oldUpdatedAt || !newUpdatedAt || !newUpdatedAt.isEqual(oldUpdatedAt)) return null;
     const callbackData = await callback?.(newDoc, oldDoc, { updatedAt, logger });
-    return newDoc.ref.set({ ...defaults, ...callbackData, updatedAt }, { merge: true });
+    return newDoc.ref.set(
+      { ...defaults, ...callbackData, updatedAt, createdAt: oldCreatedAt },
+      { merge: true }
+    );
   });
 }
-export function onDelete(collectionPath, callback) {
+export function onDeleted(collectionPath, callback) {
   const document = getDocumentPath(collectionPath);
   return onDocumentDeleted({ document, region: "us-east1" }, async ({ data, ...metadata }) => {
     const { firebaseFirestore } = getFirebase(`onDeleted: "${document}"`);

package/dist/runtime/functions/utils/logger.d.ts

@@ -1,3 +1,7 @@
 import { DocumentReference, type Firestore } from "firebase-admin/firestore";
 import type { tLogger } from "@open-xamu-co/ui-common-types";
 export declare function makeFunctionsLogger(at: DocumentReference | Firestore, authorRef?: DocumentReference, metadata?: Record<string, any>): tLogger;
+/**
+ * Log offending requests sources
+ */
+export declare function offenderLogger(at: DocumentReference | Firestore, lastLogRef: DocumentReference, metadata?: any): void;

package/dist/runtime/functions/utils/logger.js

@@ -1,4 +1,8 @@
-import { DocumentReference } from "firebase-admin/firestore";
+import {
+  DocumentReference,
+  FieldValue
+} from "firebase-admin/firestore";
+import acceptLanguageParser from "accept-language-parser";
 import { getLog } from "./logs.js";
 export function makeFunctionsLogger(at, authorRef, metadata = {}) {
   return function(...args) {
@@ -15,3 +19,22 @@ export function makeFunctionsLogger(at, authorRef, metadata = {}) {
     }
   };
 }
+export function offenderLogger(at, lastLogRef, metadata) {
+  if (!metadata || typeof metadata !== "object") return;
+  const headers = metadata.headers || {};
+  const ip = headers["cf-connecting-ip"] || headers["x-fah-client-ip"] || headers["ip"];
+  const userAgent = headers["from"] || headers["user-agent"];
+  const country = headers["cf-ipcountry"];
+  const [preferredLanguage] = acceptLanguageParser.parse(headers["accept-language"]);
+  if (!ip) return;
+  const offendersRef = at.collection("offenders");
+  const offenderDoc = offendersRef.doc(ip);
+  const offenderData = { ip, hits: FieldValue.increment(1), lastLogRef };
+  if (country) offenderData.countries = FieldValue.arrayUnion(country);
+  if (userAgent) offenderData.userAgents = FieldValue.arrayUnion(userAgent);
+  if (preferredLanguage) {
+    const { code, region } = preferredLanguage;
+    offenderData.languages = FieldValue.arrayUnion(`${code}-${region}`);
+  }
+  offenderDoc.set(offenderData, { merge: true });
+}

package/dist/runtime/functions/utils/search.d.ts

@@ -11,5 +11,25 @@ export declare function getWords(phrase: string): string[];
 export declare function soundexEs(phrase: string): string;
 /**
  * Generate indexes to be used as tokens in a fuzzy search
+ *
+ * Indexes allow to search for a phrase in a fuzzy way
+ *
+ * @param phrase phrase to generate indexes for
+ * @param soundexAlgorithm soundex algorithm to use
+ * @returns array of indexes
+ */
+export declare function getSearchIndexes(phrase: string, soundexAlgorithm?: (phrase: string) => string): string[];
+/**
+ * Generate indexes to be used as tokens in a fuzzy search
+ *
+ * Indexes allow to search for a phrase in a fuzzy way
+ * Weights allow to sort results based on their relevance
+ *
+ * @param phrase phrase to generate indexes for
+ * @param soundexAlgorithm soundex algorithm to use
+ * @returns array of objects with index and weight
  */
-export declare function getSearchIndexes(phrase: string): string[];
+export declare function getWeightedSearchIndexes(phrase: string, soundexAlgorithm?: (phrase: string) => string): {
+    indexes: string[];
+    indexesWeights: string[];
+};