@oneuptime/common 12.0.5 → 12.0.6

package/build/dist/Server/Utils/Database/PostgresErrorTranslator.js

@@ -4,12 +4,46 @@ import BadDataException from "../../../Types/Exception/BadDataException";
  * https://www.postgresql.org/docs/current/errcodes-appendix.html
  */
 const FOREIGN_KEY_VIOLATION = "23503";
+const UNIQUE_VIOLATION = "23505";
 export default class PostgresErrorTranslator {
     static translate(error) {
         const driverError = this.getPostgresDriverError(error);
-        if (!driverError || driverError.code !== FOREIGN_KEY_VIOLATION) {
+        if (!driverError) {
             return error;
         }
+        if (driverError.code === FOREIGN_KEY_VIOLATION) {
+            return this.translateForeignKeyViolation(error, driverError);
+        }
+        if (driverError.code === UNIQUE_VIOLATION) {
+            return this.translateUniqueViolation(error, driverError);
+        }
+        return error;
+    }
+    /*
+     * `throw`-friendly wrapper. Kept synchronous so callers can keep using
+     * `throw translator(...)` on the synchronous throw path.
+     */
+    static translateException(error) {
+        return this.translate(error);
+    }
+    /*
+     * True for a unique violation whether or not it has been through translate().
+     * Callers that recover from a duplicate must use this rather than checking
+     * `code === "23505"` themselves: by the time a service's own catch block sees
+     * an error thrown out of DatabaseService, it has already been translated.
+     */
+    static isUniqueViolation(error) {
+        if (!error || typeof error !== "object") {
+            return false;
+        }
+        if (error.postgresErrorCode ===
+            UNIQUE_VIOLATION) {
+            return true;
+        }
+        const driverError = this.getPostgresDriverError(error);
+        return (driverError === null || driverError === void 0 ? void 0 : driverError.code) === UNIQUE_VIOLATION;
+    }
+    static translateForeignKeyViolation(error, driverError) {
         const detail = driverError.detail || "";
         /*
          * DELETE blocked by a child row:
@@ -17,9 +51,9 @@ export default class PostgresErrorTranslator {
          */
         if (detail.includes("is still referenced from table")) {
             const referencingTable = this.getTableNameFromDetail(detail) || driverError.table || "";
-            return new BadDataException(referencingTable
+            return this.tag(new BadDataException(referencingTable
                 ? `This item cannot be deleted because ${this.humanizeTableName(referencingTable)} records still reference it. Please delete those records first, and then try again.`
-                : "This item cannot be deleted because other records still reference it. Please delete those records first, and then try again.");
+                : "This item cannot be deleted because other records still reference it. Please delete those records first, and then try again."), driverError);
         }
         /*
          * INSERT/UPDATE pointing at a row that does not exist:
@@ -27,18 +61,47 @@ export default class PostgresErrorTranslator {
          */
         if (detail.includes("is not present in table")) {
             const referencedTable = this.getTableNameFromDetail(detail) || "";
-            return new BadDataException(referencedTable
+            return this.tag(new BadDataException(referencedTable
                 ? `This request references ${this.humanizeTableName(referencedTable)} that does not exist. Please check the request and try again.`
-                : "This request references an item that does not exist. Please check the request and try again.");
+                : "This request references an item that does not exist. Please check the request and try again."), driverError);
         }
         return error;
     }
     /*
-     * `throw`-friendly wrapper. Kept synchronous so callers can keep using
-     * `throw translator(...)` on the synchronous throw path.
+     * INSERT/UPDATE colliding with an existing row:
+     *   Key ("twilioAccountSID")=(AC123...) already exists.
+     *
+     * The column names go into the message because they tell the user which
+     * field to change. The values do not: they are another row's data, and that
+     * row may well belong to a different project (issue #3020 was reported
+     * against exactly such a cross-tenant collision).
      */
-    static translateException(error) {
-        return this.translate(error);
+    static translateUniqueViolation(error, driverError) {
+        const detail = driverError.detail || "";
+        if (!detail.includes("already exists")) {
+            return error;
+        }
+        const columns = this.getColumnNamesFromDetail(detail);
+        const subject = driverError.table
+            ? `A ${this.humanizeTableName(driverError.table)}`
+            : "A record";
+        if (columns.length === 0) {
+            return this.tag(new BadDataException(`${subject} with these values already exists. Please use different values and try again.`), driverError);
+        }
+        const fields = columns
+            .map((column) => {
+            return this.humanizeColumnName(column);
+        })
+            .join(", ");
+        return this.tag(new BadDataException(columns.length === 1
+            ? `${subject} with this ${fields} already exists. Please use a different value and try again.`
+            : `${subject} with the same ${fields} already exists. Please use different values and try again.`), driverError);
+    }
+    /* Records the SQLSTATE on the translated exception. See the interface above. */
+    static tag(exception, driverError) {
+        exception.postgresErrorCode =
+            driverError.code;
+        return exception;
     }
     static getPostgresDriverError(error) {
         if (!error || typeof error !== "object") {
@@ -65,6 +128,29 @@ export default class PostgresErrorTranslator {
         const match = detail.match(/table "([^"]+)"/);
         return match && match[1] ? match[1] : null;
     }
+    /*
+     * `Key ("twilioAccountSID")=(AC1)...` -> ["twilioAccountSID"]
+     * `Key (slug)=(acme)...`              -> ["slug"]
+     * `Key (a, "b")=(1, 2)...`            -> ["a", "b"]
+     *
+     * Postgres quotes an identifier only when it needs to, so both forms turn up
+     * in the same database. Anchored on the leading `Key (` so the value list
+     * that follows cannot be mistaken for the column list.
+     */
+    static getColumnNamesFromDetail(detail) {
+        const match = detail.match(/^Key \(([^)]*)\)=/);
+        if (!match || !match[1]) {
+            return [];
+        }
+        return match[1]
+            .split(",")
+            .map((column) => {
+            return column.trim().replace(/^"(.*)"$/, "$1");
+        })
+            .filter((column) => {
+            return column.length > 0;
+        });
+    }
     /*
      * "MonitorStatusTimeline" -> "Monitor Status Timeline". Table names are the
      * PascalCase model names, so this reads well enough to put in front of a
@@ -76,5 +162,13 @@ export default class PostgresErrorTranslator {
             .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
             .trim();
     }
+    /*
+     * "twilioAccountSID" -> "Twilio Account SID". Same split as table names, but
+     * columns are camelCase so the first letter needs capitalising too.
+     */
+    static humanizeColumnName(columnName) {
+        const humanized = this.humanizeTableName(columnName);
+        return humanized.charAt(0).toUpperCase() + humanized.slice(1);
+    }
 }
 //# sourceMappingURL=PostgresErrorTranslator.js.map

package/build/dist/Server/Utils/Database/PostgresErrorTranslator.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostgresErrorTranslator.js","sourceRoot":"","sources":["../../../../../Server/Utils/Database/PostgresErrorTranslator.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,2CAA2C,CAAC;AAGzE;;;GAGG;AACH,MAAM,qBAAqB,GAAW,OAAO,CAAC;AAoB9C,MAAM,CAAC,OAAO,OAAO,uBAAuB;IACnC,MAAM,CAAC,SAAS,CAAC,KAAc;QACpC,MAAM,WAAW,GACf,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAW,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;QAEhD;;;WAGG;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;YACtD,MAAM,gBAAgB,GACpB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YAEjE,OAAO,IAAI,gBAAgB,CACzB,gBAAgB;gBACd,CAAC,CAAC,uCAAuC,IAAI,CAAC,iBAAiB,CAC3D,gBAAgB,CACjB,qFAAqF;gBACxF,CAAC,CAAC,8HAA8H,CACnI,CAAC;QACJ,CAAC;QAED;;;WAGG;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAC/C,MAAM,eAAe,GAAW,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAE1E,OAAO,IAAI,gBAAgB,CACzB,eAAe;gBACb,CAAC,CAAC,2BAA2B,IAAI,CAAC,iBAAiB,CAC/C,eAAe,CAChB,+DAA+D;gBAClE,CAAC,CAAC,8FAA8F,CACnG,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,kBAAkB,CAAC,KAAgB;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAc,CAAC;IAC5C,CAAC;IAEO,MAAM,CAAC,sBAAsB,CACnC,KAAc;QAEd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;WAGG;QACH,MAAM,SAAS,GAAwB,KAA4B,CAAC;QAEpE,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,WAAW,GAAa,KAAmC;aAC9D,WAAW,CAAC;QAEf,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,OAAQ,WAAmC,CAAC,IAAI,KAAK,QAAQ,EAC7D,CAAC;YACD,OAAO,WAAkC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,MAAM,CAAC,sBAAsB,CAAC,MAAc;QAClD,MAAM,KAAK,GAA4B,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAEvE,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,iBAAiB,CAAC,SAAiB;QAChD,OAAO,SAAS;aACb,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;aACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;aACzC,IAAI,EAAE,CAAC;IACZ,CAAC;CACF"}
+{"version":3,"file":"PostgresErrorTranslator.js","sourceRoot":"","sources":["../../../../../Server/Utils/Database/PostgresErrorTranslator.ts"],"names":[],"mappings":"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"}

package/build/dist/Server/Utils/InProcessMemo.js

@@ -0,0 +1,113 @@
+/*
+ * Bounded, TTL-bearing in-process memo — the L1 layer in front of a Redis
+ * (GlobalCache) or Postgres lookup on a hot path.
+ *
+ * The telemetry ingest worker resolves the same handful of entities (hosts,
+ * clusters, services, retention configs) once per resource block per job, and
+ * a hostmetrics payload carries hundreds of resource blocks. Redis answers
+ * each of those lookups correctly but each answer still costs a serialized
+ * network round trip, so at fleet concurrency the round trips — not the
+ * answers — are what the workers spend their time on. A short-TTL in-process
+ * Map in front of the shared cache collapses the steady state to zero network
+ * cost per lookup, exactly as the existing service-resolution / project-
+ * retention memos in OpenTelemetryIngestService already do. This class is
+ * that pattern extracted so the eleven autoDiscover* paths, the maintenance
+ * fence, host resolution and the resource-retention lookup share one
+ * implementation instead of growing eleven hand-rolled copies (the
+ * ResourceHeartbeat header documents where hand-copying that shape ends up).
+ *
+ * Design constraints, in order:
+ *
+ *   - BOUNDED. The keys are attacker-influenced (resource attributes from
+ *     collectors), so an unbounded map is a memory leak with a network
+ *     trigger. At the cap the OLDEST entry is evicted — Map preserves insert
+ *     order, so eviction is O(1) with no bookkeeping to get wrong. Same
+ *     approach as DnsResolutionCache.
+ *
+ *   - SHORT TTL. This memo is never invalidated cross-process (GlobalCache
+ *     has no pub/sub primitive), so the TTL is the staleness bound. Callers
+ *     keep it modest — 60 seconds is the established norm on the ingest
+ *     path — and document what an entry going stale for that long means for
+ *     their data.
+ *
+ *   - NOT a correctness mechanism. Nothing here coordinates across pods; it
+ *     composes with the distributed layer underneath, it never replaces it.
+ *     (SingleFlight makes the same disclaimer for the concurrent-dedupe
+ *     dimension; this class covers the sequential-repeat dimension.)
+ *
+ * The clock is injectable for tests; the default reads Date.now() lazily so
+ * jest's Date.now spies work against instances constructed at module load.
+ */
+export default class InProcessMemo {
+    constructor(options) {
+        var _a, _b;
+        this.entries = new Map();
+        this.ttlInMs = options.ttlInMs;
+        this.maxEntries = (_a = options.maxEntries) !== null && _a !== void 0 ? _a : 10000;
+        /*
+         * Wrapped rather than stored as a bare `Date.now` reference so a test
+         * that spies on Date.now after this instance was constructed (module-
+         * level memos are constructed at import time) still steers the clock.
+         */
+        this.now =
+            (_b = options.now) !== null && _b !== void 0 ? _b : (() => {
+                return Date.now();
+            });
+    }
+    /**
+     * The memoed value, or undefined when absent or expired. An expired entry
+     * is deleted on read so steady churn cannot pin dead entries under the cap.
+     */
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (entry.expiresAtMs <= this.now()) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Store `value` for the configured TTL — or for `ttlInMsOverride` when the
+     * caller's staleness bound varies per entry (e.g. a memo whose lifetime
+     * must never exceed the specific Redis window it is fronting) — evicting
+     * the oldest entry at the cap.
+     */
+    set(key, value, ttlInMsOverride) {
+        if (this.entries.has(key)) {
+            /*
+             * Re-insert rather than update in place so Map insert order keeps
+             * approximating write recency and eviction stays oldest-first.
+             */
+            this.entries.delete(key);
+        }
+        else if (this.entries.size >= this.maxEntries) {
+            const oldestKey = this.entries.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.entries.delete(oldestKey);
+            }
+        }
+        this.entries.set(key, {
+            value: value,
+            expiresAtMs: this.now() + (ttlInMsOverride !== null && ttlInMsOverride !== void 0 ? ttlInMsOverride : this.ttlInMs),
+        });
+    }
+    /**
+     * Drop one entry immediately — the local half of an explicit cross-layer
+     * invalidation (e.g. releasing a maintenance fence this process observed).
+     */
+    delete(key) {
+        this.entries.delete(key);
+    }
+    /** Drop everything. For tests. */
+    clear() {
+        this.entries.clear();
+    }
+    /** Number of live-or-expired entries held. For tests and diagnostics. */
+    size() {
+        return this.entries.size;
+    }
+}
+//# sourceMappingURL=InProcessMemo.js.map

package/build/dist/Server/Utils/InProcessMemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InProcessMemo.js","sourceRoot":"","sources":["../../../../Server/Utils/InProcessMemo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAkBH,MAAM,CAAC,OAAO,OAAO,aAAa;IAUhC,YAAmB,OAA6B;;QATxC,YAAO,GAAmC,IAAI,GAAG,EAGtD,CAAC;QAOF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,KAAM,CAAC;QAC/C;;;;WAIG;QACH,IAAI,CAAC,GAAG;YACN,MAAA,OAAO,CAAC,GAAG,mCACX,CAAC,GAAW,EAAE;gBACZ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;YACpB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,GAAW;QACpB,MAAM,KAAK,GAAkC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,eAAwB;QAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B;;;eAGG;YACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,MAAM,SAAS,GAAuB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACvE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACpB,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,IAAI,CAAC,OAAO,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,GAAW;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAC3B,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,yEAAyE;IAClE,IAAI;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}