@merkl/api 1.19.27 → 1.20.12

package/dist/src/utils/safeEngineQuery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Decorator that wraps an async method with a timeout + fallback for engine DB reads.
+ * On timeout or any thrown error, logs a warning and returns `fallback`.
+ *
+ * `fallback` may be either a value or a function receiving the original call args
+ * — use the function form when the fallback shape depends on call inputs.
+ *
+ * Compose with `@Cached` by placing `@SafeEngineQuery` ABOVE `@Cached` so
+ * failures fall back without polluting the cache.
+ *
+ * Intended for HTTP request-path code only — serving stale/empty data is preferable
+ * to a 5xx response. Do NOT use in jobs, scripts, or engine code.
+ */
+export declare function SafeEngineQuery<F>(fallback: F | ((...args: any[]) => F)): <T extends (...args: any[]) => Promise<any>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;

package/dist/src/utils/safeEngineQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeEngineQuery.js","sourceRoot":"","sources":["../../../../../apps/api/src/utils/safeEngineQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAElE;;;;GAIG;AACH,SAAS,aAAa,CAAI,QAAqC,EAAE,IAAW,EAAK;IAC/E,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAQ,QAA+B,CAAC,GAAG,IAAI,CAAC,CAAC;IACrF,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACvE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AAAA,CAClC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAI,QAAqC,EAAE;IACxE,OAAO,CACL,MAAW,EACX,WAAmB,EACnB,UAAsC,EACtC,EAAE,CAAC;QACH,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAM,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI,WAAW,CAAC;QAC3E,MAAM,KAAK,GAAG,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;QAE5C,MAAM,OAAO,GAAG,KAAK,WAAsB,GAAG,IAAW,EAAE;YACzD,IAAI,CAAC;gBACH,OAAO,MAAM,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,YAAY,CAAC,IAAI,CACf,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,0BAA0B,EAAE,EACrD,4CAA4C,CAC7C,CAAC;gBACF,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;QAAA,CACU,CAAC;QAEd,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC;QAC3B,OAAO,UAAU,CAAC;IAAA,CACnB,CAAC;AAAA,CACH"}