@lde/distribution-monitor 0.1.13 → 0.1.14

package/dist/store.d.ts

@@ -1,3 +1,4 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
 import type { ObservationStore, Observation } from './types.js';
 /**
  * PostgreSQL implementation of the ObservationStore interface.
@@ -24,4 +25,26 @@ export declare class PostgresObservationStore implements ObservationStore {
     store(observation: Omit<Observation, 'id'>): Promise<Observation>;
     refreshLatestObservationsView(): Promise<void>;
 }
+/**
+ * Create the unique index that `REFRESH ... CONCURRENTLY` requires on the
+ * `latest_observations` materialized view. drizzle's `pgMaterializedView` does
+ * not model it, so `pushSchema` never emits it; create it idempotently here —
+ * `IF NOT EXISTS` matches by name and skips (no rebuild) when it already exists.
+ *
+ * The statement takes a SHARE lock on the view, which conflicts with the
+ * EXCLUSIVE lock held by a `REFRESH ... CONCURRENTLY` running in another
+ * instance. During a rolling deploy the old and new pods overlap, so that wait
+ * can exceed `lock_timeout` and raise `55P03` (lock_not_available). Tolerate it:
+ * whenever the view is being refreshed the index already exists, so a failed
+ * re-check is harmless — far better than aborting startup and crash-looping the
+ * monitor. Re-throw anything else.
+ */
+export declare function ensureLatestObservationsIndex(db: Pick<PostgresJsDatabase, 'execute'>): Promise<void>;
+/**
+ * Whether an error is (or wraps) the PostgreSQL `lock_not_available` (`55P03`)
+ * SQLSTATE, raised when a statement exceeds `lock_timeout` waiting for a
+ * contended lock. drizzle wraps the driver error, so the SQLSTATE lives on a
+ * nested `cause` rather than the top-level error.
+ */
+export declare function isLockNotAvailable(error: unknown): boolean;
 //# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBhE;;GAEG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,EAAE,CAAqB;IAE/B,OAAO;IAYP;;;;;;;;;;;OAWG;WACU,MAAM,CACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC;IA6C9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAK9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAS5C,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAQjE,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrD"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBhE;;GAEG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,EAAE,CAAqB;IAE/B,OAAO;IAYP;;;;;;;;;;;OAWG;WACU,MAAM,CACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC;IAsC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAK9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAS5C,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAQjE,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,6BAA6B,CACjD,EAAE,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU1D"}

package/dist/store.js

@@ -62,12 +62,7 @@ export class PostgresObservationStore {
         for (const statement of sqlStatements) {
             await store.db.execute(sql.raw(statement));
         }
-        // The unique index on the materialized view is required for
-        // REFRESH ... CONCURRENTLY but is not modelled by drizzle's
-        // `pgMaterializedView`, so `pushSchema` never emits it. Create it
-        // idempotently — `IF NOT EXISTS` matches by name and skips (no rebuild) when
-        // it already exists.
-        await store.db.execute(sql `CREATE UNIQUE INDEX IF NOT EXISTS latest_observations_monitor_idx ON latest_observations (monitor)`);
+        await ensureLatestObservationsIndex(store.db);
         return store;
     }
     async close() {
@@ -97,3 +92,42 @@ export class PostgresObservationStore {
         await this.db.execute(refreshLatestObservationsViewSql);
     }
 }
+/**
+ * Create the unique index that `REFRESH ... CONCURRENTLY` requires on the
+ * `latest_observations` materialized view. drizzle's `pgMaterializedView` does
+ * not model it, so `pushSchema` never emits it; create it idempotently here —
+ * `IF NOT EXISTS` matches by name and skips (no rebuild) when it already exists.
+ *
+ * The statement takes a SHARE lock on the view, which conflicts with the
+ * EXCLUSIVE lock held by a `REFRESH ... CONCURRENTLY` running in another
+ * instance. During a rolling deploy the old and new pods overlap, so that wait
+ * can exceed `lock_timeout` and raise `55P03` (lock_not_available). Tolerate it:
+ * whenever the view is being refreshed the index already exists, so a failed
+ * re-check is harmless — far better than aborting startup and crash-looping the
+ * monitor. Re-throw anything else.
+ */
+export async function ensureLatestObservationsIndex(db) {
+    try {
+        await db.execute(sql `CREATE UNIQUE INDEX IF NOT EXISTS latest_observations_monitor_idx ON latest_observations (monitor)`);
+    }
+    catch (error) {
+        if (!isLockNotAvailable(error)) {
+            throw error;
+        }
+    }
+}
+/**
+ * Whether an error is (or wraps) the PostgreSQL `lock_not_available` (`55P03`)
+ * SQLSTATE, raised when a statement exceeds `lock_timeout` waiting for a
+ * contended lock. drizzle wraps the driver error, so the SQLSTATE lives on a
+ * nested `cause` rather than the top-level error.
+ */
+export function isLockNotAvailable(error) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    if ('code' in error && error.code === '55P03') {
+        return true;
+    }
+    return ('cause' in error && isLockNotAvailable(error.cause));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/distribution-monitor",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Monitor DCAT distributions (SPARQL endpoints and data dumps) with periodic probes",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",