@effectstream/utils 0.100.19 → 0.100.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effectstream/utils",
-  "version": "0.100.19",
+  "version": "0.100.21",
   "license": "MIT",
   "homepage": "https://effectstream.github.io/docs/",
   "repository": {

package/src/config.ts

@@ -239,6 +239,13 @@ const definitions: Record<string, ConfigDefinition> = {
     defaultValue: undefined,
     description: "Enable PGLite Debug/Verbose mode. Example: '1'",
   },
+  ALLOW_NO_PG_IVM: {
+    key: "ALLOW_NO_PG_IVM",
+    type: "boolean",
+    defaultValue: false,
+    description:
+      "Permits the engine to start when the pg_ivm extension is not installed, falling back to plain SQL views over the trigger-maintained intermediate tables. Intended for dev/test and low-volume apps only — the fallback degrades sharply on high-cardinality data. Production deployments should install pg_ivm. ('true' or 'false')",
+  },
   OTEL_COLLECTOR_PORT: {
     key: "OTEL_COLLECTOR_PORT",
     type: "number",
@@ -307,6 +314,13 @@ const definitions: Record<string, ConfigDefinition> = {
     description:
       "Snapshot retention: keep one snapshot per day for this many days. Snapshots older than this are deleted. Default: 7.",
   },
+  EFFECTSTREAM_COALESCE_EMPTY_BLOCKS: {
+    key: "EFFECTSTREAM_COALESCE_EMPTY_BLOCKS",
+    type: "boolean",
+    defaultValue: false,
+    description:
+      "Fold consecutive empty catch-up blocks into one DB transaction when behind the chain tip. Default: false.",
+  },
 } as const;
 
 type ENV_TYPES = string | number | boolean | undefined;
@@ -405,6 +419,9 @@ export class ENV {
   static get DEBUG_PGLITE(): number {
     return ENV.getConfig(definitions.DEBUG_PGLITE);
   }
+  static get ALLOW_NO_PG_IVM(): boolean {
+    return ENV.getConfig(definitions.ALLOW_NO_PG_IVM);
+  }
   static get OTEL_COLLECTOR_PORT(): number {
     return ENV.getConfig(definitions.OTEL_COLLECTOR_PORT);
   }
@@ -441,6 +458,9 @@ export class ENV {
   static get EFFECTSTREAM_SNAPSHOT_LAST_N_DAYS(): number {
     return ENV.getConfig(definitions.EFFECTSTREAM_SNAPSHOT_LAST_N_DAYS);
   }
+  static get EFFECTSTREAM_COALESCE_EMPTY_BLOCKS(): boolean {
+    return ENV.getConfig(definitions.EFFECTSTREAM_COALESCE_EMPTY_BLOCKS);
+  }
 
   public static getConfig<T>(config: ConfigDefinition): T {
     switch (config.type) {