@volcanicminds/backend 3.3.0 → 3.5.0

package/dist/lib/util/cache.js

@@ -0,0 +1,189 @@
+const DEFAULTS = { enabled: false, ttl: 3600, maxEntries: 1000 };
+let settings = { ...DEFAULTS };
+const store = new Map();
+let hits = 0;
+let misses = 0;
+let sweepTimer = null;
+const nowMs = () => Date.now();
+function startSweep(intervalMs = 60_000) {
+    if (sweepTimer)
+        clearInterval(sweepTimer);
+    sweepTimer = setInterval(() => {
+        const t = nowMs();
+        for (const [k, e] of store)
+            if (e.expires <= t)
+                store.delete(k);
+    }, intervalMs);
+    sweepTimer.unref?.();
+}
+export function configureCache(opts) {
+    settings = {
+        enabled: opts?.enabled === true,
+        ttl: Number(opts?.ttl) > 0 ? Number(opts?.ttl) : DEFAULTS.ttl,
+        maxEntries: Number(opts?.maxEntries) > 0 ? Number(opts?.maxEntries) : DEFAULTS.maxEntries
+    };
+    store.clear();
+    hits = 0;
+    misses = 0;
+    if (settings.enabled) {
+        startSweep();
+        if (log?.i)
+            log.info(`Cache 🧊 enabled — ttl ${settings.ttl}s, maxEntries ${settings.maxEntries}, strategy LRU+TTL`);
+    }
+    else {
+        if (sweepTimer) {
+            clearInterval(sweepTimer);
+            sweepTimer = null;
+        }
+        if (log?.i)
+            log.info('Cache 🧊 disabled');
+    }
+    return settings;
+}
+export const cacheEnabled = () => settings.enabled;
+export const defaultTtl = () => settings.ttl;
+export function cacheGet(key) {
+    const e = store.get(key);
+    if (!e) {
+        misses++;
+        return undefined;
+    }
+    if (e.expires <= nowMs()) {
+        store.delete(key);
+        misses++;
+        return undefined;
+    }
+    store.delete(key);
+    store.set(key, e);
+    hits++;
+    return e.value;
+}
+export function cacheSet(key, value, ttlSec) {
+    const ttl = Number(ttlSec) > 0 ? Number(ttlSec) : settings.ttl;
+    if (store.has(key))
+        store.delete(key);
+    store.set(key, { value, expires: ttl > 0 ? nowMs() + ttl * 1000 : Infinity });
+    while (store.size > settings.maxEntries) {
+        const oldest = store.keys().next().value;
+        if (oldest === undefined)
+            break;
+        store.delete(oldest);
+    }
+}
+export function invalidateCache(keyGroups) {
+    if (keyGroups == null) {
+        const n = store.size;
+        store.clear();
+        if (log?.d)
+            log.debug(`Cache 🧊 flushAll — ${n} entries removed`);
+        return n;
+    }
+    const list = Array.isArray(keyGroups) ? keyGroups : [keyGroups];
+    const prefixes = list.map((g) => `${g}::`);
+    let n = 0;
+    for (const k of [...store.keys()]) {
+        if (prefixes.some((p) => k.startsWith(p))) {
+            store.delete(k);
+            n++;
+        }
+    }
+    if (log?.d)
+        log.debug(`Cache 🧊 invalidate [${list.join(', ')}] — ${n} entries removed`);
+    return n;
+}
+export function cacheStats() {
+    return { size: store.size, hits, misses, ...settings };
+}
+export const cache = {
+    get: cacheGet,
+    set: cacheSet,
+    del: (key) => store.delete(key),
+    invalidate: invalidateCache,
+    flushAll: () => invalidateCache(),
+    stats: cacheStats,
+    enabled: cacheEnabled
+};
+export function normalizeRouteCache(input, defaultKeyGroup) {
+    if (input == null || input === false)
+        return undefined;
+    const obj = input === true ? {} : typeof input === 'number' ? { ttl: input } : input;
+    const enabled = obj.enabled !== false;
+    const invalidates = obj.invalidates == null ? undefined : Array.isArray(obj.invalidates) ? obj.invalidates : [obj.invalidates];
+    if (!enabled && !invalidates?.length)
+        return undefined;
+    return {
+        enabled,
+        ttl: typeof obj.ttl === 'number' && obj.ttl > 0 ? obj.ttl : undefined,
+        keyGroup: obj.keyGroup || defaultKeyGroup,
+        invalidates
+    };
+}
+const HIT = Symbol('volcanic.cacheHit');
+const HEADER_ALLOW = /^(content-type|v-)/i;
+function scope(req) {
+    const tenant = req.tenant?.id ?? '';
+    const subject = req.user?.externalId ?? req.token?.getId?.() ?? 'anon';
+    const rolesList = typeof req.roles === 'function' ? req.roles() : [];
+    const rolesKey = [...(rolesList || [])].sort().join(',');
+    return `${tenant}|${subject}|${rolesKey}`;
+}
+function keyFor(req, keyGroup) {
+    return `${keyGroup}::${scope(req)}::${req.method} ${req.url}`;
+}
+function tenantMissing(req) {
+    const mt = global.config?.options?.multi_tenant?.enabled;
+    const tenantCtx = req.routeOptions?.config?.tenantContext;
+    return Boolean(mt && tenantCtx !== false && !req.tenant);
+}
+export function buildCacheHooks(routeCache) {
+    const cacheable = routeCache.enabled === true;
+    const keyGroup = routeCache.keyGroup;
+    const ttl = routeCache.ttl;
+    const invalidates = routeCache.invalidates;
+    const preHandler = cacheable
+        ? async (req, reply) => {
+            if (!cacheEnabled() || req.method !== 'GET' || tenantMissing(req))
+                return;
+            const hit = cacheGet(keyFor(req, keyGroup));
+            if (hit) {
+                for (const [h, v] of Object.entries(hit.headers))
+                    reply.header(h, v);
+                req[HIT] = true;
+                reply.code(hit.statusCode);
+                if (log?.d)
+                    log.debug(`Cache 🧊 hit ${keyGroup} ${req.method} ${req.url}`);
+                return reply.send(hit.payload);
+            }
+            if (log?.d)
+                log.debug(`Cache 🧊 miss ${keyGroup} ${req.method} ${req.url}`);
+        }
+        : undefined;
+    const onSend = async (req, reply, payload) => {
+        if (!cacheEnabled())
+            return payload;
+        if (cacheable &&
+            !req[HIT] &&
+            req.method === 'GET' &&
+            reply.statusCode >= 200 &&
+            reply.statusCode < 300 &&
+            typeof payload === 'string' &&
+            !tenantMissing(req) &&
+            !reply.getHeader('set-cookie')) {
+            const headers = {};
+            const all = reply.getHeaders();
+            for (const h of Object.keys(all))
+                if (HEADER_ALLOW.test(h))
+                    headers[h] = all[h];
+            cacheSet(keyFor(req, keyGroup), { payload, headers, statusCode: reply.statusCode }, ttl);
+        }
+        if (invalidates?.length &&
+            req.method !== 'GET' &&
+            reply.statusCode >= 200 &&
+            reply.statusCode < 300) {
+            invalidateCache(invalidates);
+        }
+        return payload;
+    };
+    return { preHandler, onSend };
+}
+//# sourceMappingURL=cache.js.map

package/dist/lib/util/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../lib/util/cache.ts"],"names":[],"mappings":"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"}

package/dist/lib/util/tracker.d.ts

@@ -1,4 +1,5 @@
 import type { FastifyRequest, FastifyReply } from '../../types/global.js';
 export declare function initialize(req: FastifyRequest, _reply: FastifyReply): Promise<void>;
 export declare function track(req: FastifyRequest, _reply: FastifyReply, payload: any): Promise<void>;
+export declare function isFieldChanged(oldValue: any, newValue: any): boolean;
 //# sourceMappingURL=tracker.d.ts.map

package/dist/lib/util/tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../lib/util/tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzE,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,iBAmBzE;AAED,wBAAsB,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,iBAsDlF"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../lib/util/tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzE,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,iBAmBzE;AAED,wBAAsB,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,iBAsDlF;AAWD,wBAAgB,cAAc,CAAC,QAAQ,KAAA,EAAE,QAAQ,KAAA,WAyBhD"}

package/dist/lib/util/tracker.js

@@ -78,18 +78,18 @@ function getTrackingConfigIfEnabled(req) {
         log.error(error);
     }
 }
-function isFieldChanged(oldValue, newValue) {
+export function isFieldChanged(oldValue, newValue) {
     if ((oldValue instanceof Date || newValue instanceof Date) && oldValue != null && newValue != undefined) {
         return !dayjs(oldValue).isSame(dayjs(newValue));
     }
     if ((oldValue instanceof Object || newValue instanceof Object) && oldValue != null && newValue != undefined) {
         const primaryKey = global.trackingConfig?.primaryKey;
-        const oldId = oldValue != null && primaryKey in oldValue
+        const oldId = oldValue != null && typeof oldValue === 'object' && primaryKey in oldValue
             ? oldValue[primaryKey]
             : typeof oldValue === 'string'
                 ? oldValue
                 : undefined;
-        const newId = newValue != null && primaryKey in newValue
+        const newId = newValue != null && typeof newValue === 'object' && primaryKey in newValue
             ? newValue[primaryKey]
             : typeof newValue === 'string'
                 ? newValue

package/dist/lib/util/tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../lib/util/tracker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../lib/util/tracker.ts"],"names":[],"mappings":"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"}

package/dist/types/global.d.ts

@@ -69,6 +69,25 @@ export interface RouteConfig {
   consumes?: any
   rawBody?: boolean
   manifest?: ManifestHints // structural hints for the generated manifest (group + resource)
+  cache?: boolean | number | RouteCache // file-level cache default (inherited by every route; per-route `cache` overrides)
+}
+
+// Per-route caching (opt-in). Authored on the route: `true` (default TTL), a number
+// (TTL in seconds), or the full object. Only GET responses with a 2xx status are
+// cached; `invalidates` works on any method (typically mutations).
+export interface RouteCache {
+  enabled?: boolean // default true when the object is present
+  ttl?: number // seconds; default from global config (options.cache.ttl)
+  keyGroup?: string // logical key-group for invalidation; default = the api folder (area)
+  invalidates?: string | string[] // key-groups to flush after a successful (2xx) response
+}
+
+// The normalized form threaded onto a ConfiguredRoute (keyGroup always resolved).
+export interface NormalizedRouteCache {
+  enabled: boolean
+  ttl?: number
+  keyGroup: string
+  invalidates?: string[]
 }
 
 export interface Route {
@@ -79,6 +98,7 @@ export interface Route {
   middlewares: string[]
   config?: RouteConfig
   rateLimit?: any
+  cache?: boolean | number | RouteCache
 }
 
 export interface GeneralConfig {
@@ -105,6 +125,12 @@ export interface GeneralConfig {
     manifest?: {
       enabled: boolean
     }
+    // In-memory per-route response cache (opt-in per route via `cache`).
+    cache?: {
+      enabled?: boolean // master switch (default true)
+      ttl?: number // default TTL in seconds for routes without an explicit ttl
+      maxEntries?: number // LRU cap (slots) before least-recently-used eviction
+    }
   }
 }
 
@@ -157,6 +183,7 @@ export interface ConfiguredRoute {
   }
   group?: string // structural hint (manifest)
   resource?: ResourceHints // structural hints (manifest)
+  cache?: NormalizedRouteCache // per-route caching (normalized)
 }
 
 export interface TrackChanges {
@@ -340,6 +367,7 @@ declare global {
   var entity: any
   var repository: any
   var routes: ConfiguredRoute[]
+  var cache: any
 }
 
 export { global }

package/lib/config/general.ts

@@ -17,7 +17,13 @@ export default {
       query_key: 'tid'
     },
     manifest: {
-      enabled: false // opt-in: exposes GET /admin/manifest (admin-only) for the backoffice engine
+      // opt-in: exposes GET /admin/manifest (admin-only) for the backoffice engine
+      enabled: false
+    },
+    cache: {
+      // opt-in: in-memory LRU+TTL cache for routes that declare `cache:`.
+      // When enabled, ttl (default 3600s) and maxEntries (default 1000) can be set here.
+      enabled: false
     }
   }
 }

package/lib/config/plugins.ts

@@ -60,6 +60,14 @@ export default [
     enable: false,
     options: {}
   },
+  {
+    // Serve a static folder (e.g. public uploads in dev; nginx/CDN in prod).
+    // Options are @fastify/static's: { root, prefix?, decorateReply? }, or an array
+    // of them for multiple mounts. Disabled by default.
+    name: 'static',
+    enable: false,
+    options: {}
+  },
   {
     name: 'rawBody',
     enable: false,

package/lib/hooks/onError.ts

@@ -2,32 +2,37 @@
 import { FastifyRequest, FastifyReply } from 'fastify'
 
 export default async (_req: FastifyRequest, reply: FastifyReply, error: any) => {
-  if (log.e) log.error(`${error?.message || error}`)
+  // Normalize the message up-front: `error` may be a string, or an object without
+  // a `message` — reading `.includes` on an undefined message would crash the
+  // error handler itself (and mask the real error as an unhandled 500).
+  const message = typeof error?.message === 'string' ? error.message : String(error?.message ?? error ?? '')
+
+  if (log.e) log.error(message || `${error}`)
   if (log.t) log.trace(error)
 
-  if (error.statusCode && error.statusCode >= 400) {
+  if (error?.statusCode && error.statusCode >= 400) {
     return reply.code(error.statusCode).send(error)
   }
 
-  if (error.message === 'Wrong credentials' || error.message === 'Unauthorized') {
+  if (message === 'Wrong credentials' || message === 'Unauthorized') {
     return reply.code(403).send({
       statusCode: 403,
       error: 'Forbidden',
-      message: error.message
+      message
     })
   }
 
-  if (error.message.includes('not found')) {
+  if (message.includes('not found')) {
     return reply.code(404).send({
       statusCode: 404,
       error: 'Not Found',
-      message: error.message
+      message
     })
   }
 
   return reply.code(500).send({
     statusCode: 500,
     error: 'Internal Server Error',
-    message: error.message
+    message
   })
 }

package/lib/loader/general.ts

@@ -20,6 +20,9 @@ export async function load() {
       },
       manifest: {
         enabled: false
+      },
+      cache: {
+        enabled: false
       }
     }
   }

package/lib/loader/router.ts

@@ -3,6 +3,7 @@ import yn from '../util/yn.js'
 import type { Role, Route, ConfiguredRoute, RouteConfig } from '../../types/global.js'
 import { FastifyReply, FastifyRequest } from 'fastify'
 import { normalizePatterns } from '../util/path.js'
+import { normalizeRouteCache, buildCacheHooks, cacheEnabled } from '../util/cache.js'
 import { globSync } from 'glob'
 import path from 'path'
 import { fileURLToPath } from 'url'
@@ -83,7 +84,8 @@ export function processRoute(
     roles: rs = [],
     config = {} as RouteConfig,
     middlewares = [],
-    rateLimit
+    rateLimit,
+    cache: cacheInput
   } = route
 
   const rsp = !rs.length ? [roles.public] : rs
@@ -186,6 +188,9 @@ export function processRoute(
       tenantContext,
       rawBody,
       rateLimit,
+      // Per-route cache (falls back to the file-level `config.cache`); the default
+      // key-group is the api folder (`dir`), overridable.
+      cache: normalizeRouteCache(cacheInput ?? defaultConfig?.cache, dir),
       base,
       file: path.join(base, defaultConfig.controller || 'controller', handlerParts[0]),
       func: handlerParts[1],
@@ -245,13 +250,33 @@ async function applyRoutes(server: any, routes: ConfiguredRoute[]): Promise<void
   let countRoutes = 0
   for (const route of routes) {
     if (route?.enable) {
-      const { handler, method, path, middlewares, roles, rawBody, rateLimit, base, file, func, doc, tenantContext } =
+      const { handler, method, path, middlewares, roles, rawBody, rateLimit, base, file, func, doc, tenantContext, cache } =
         route
 
       if (log.d) log.debug(`* Add path ${method} ${path} on handle ${handler}`)
       const midds = await loadMiddlewares(base, middlewares)
 
-      server.route({
+      // Attach the cache read (preHandler, runs after auth) and write (onSend)
+      // hooks only when the route opts in — no overhead on uncached routes.
+      const cacheHooks = cache && (cache.enabled || cache.invalidates?.length) ? buildCacheHooks(cache) : null
+
+      // Courtesy log at wiring time: describe each cache-declaring route, and warn
+      // when a route opts in while the global master switch is off (hooks are inert).
+      if (cacheHooks) {
+        if (!cacheEnabled()) {
+          if (log.w)
+            log.warn(
+              `Cache 🧊 route ${method} ${path} declares cache/invalidation but global cache is disabled (options.cache.enabled) — inert`
+            )
+        } else if (log.d) {
+          const parts: string[] = []
+          if (cache?.enabled) parts.push(`read+write ttl ${cache.ttl ?? 'default'}s keyGroup '${cache.keyGroup}'`)
+          if (cache?.invalidates?.length) parts.push(`invalidates [${cache.invalidates.join(', ')}]`)
+          log.debug(`Cache 🧊 route ${method} ${path} — ${parts.join(', ')}`)
+        }
+      }
+
+      const routeDef: any = {
         method: method,
         path: path,
         schema: doc,
@@ -260,7 +285,8 @@ async function applyRoutes(server: any, routes: ConfiguredRoute[]): Promise<void
           requiredRoles: roles || [],
           rawBody: rawBody || false,
           rateLimit: rateLimit || undefined,
-          tenantContext: tenantContext
+          tenantContext: tenantContext,
+          cache: cache || undefined
         },
         handler: async function (req: FastifyRequest, reply: FastifyReply) {
           let module
@@ -286,7 +312,16 @@ async function applyRoutes(server: any, routes: ConfiguredRoute[]): Promise<void
 
           return await module[func](req, reply)
         }
-      })
+      }
+
+      if (cacheHooks?.preHandler) {
+        // Cache read runs before the route middlewares; auth/roles are already
+        // enforced in the global onRequest hook, so this is safe.
+        routeDef.preHandler = [cacheHooks.preHandler, ...((midds as any).preHandler || [])]
+      }
+      if (cacheHooks?.onSend) routeDef.onSend = cacheHooks.onSend
+
+      server.route(routeDef)
 
       countRoutes++
     }

package/lib/manifest/generator.ts

@@ -313,7 +313,7 @@ function collectFields(
     const kind = crudKind(r.method, rest)
     // Write side: create/update bodies, plus a PUT/PATCH on the BASE path — the singleton
     // update (e.g. PUT /company), which crudKind classifies as 'action'. Restricted to the
-    // base path so sub-route action payloads (e.g. /vehicles/:id/images/reorder) don't leak in.
+    // base path so sub-route action payloads (e.g. /posts/:id/attachments/reorder) don't leak in.
     const isSingletonWrite = rest.length === 0 && (r.method === 'PUT' || r.method === 'PATCH')
     if (kind === 'create' || kind === 'update' || isSingletonWrite) addSide(r.doc?.body, 'write')
     if (kind === 'read' || kind === 'list') {