@fedify/postgres 2.3.6 → 2.3.8

package/dist/kv.cjs

@@ -26,7 +26,8 @@ const logger = (0, require("@logtape/logtape").getLogger)([
 var PostgresKvStore = class {
 	#sql;
 	#tableName;
-	#initialized;
+	#skipDdl;
+	#initialized = false;
 	#driverSerializesJson = false;
 	/**
 	* Creates a new PostgreSQL key–value store.
@@ -36,7 +37,7 @@ var PostgresKvStore = class {
 	constructor(sql, options = {}) {
 		this.#sql = sql;
 		this.#tableName = options.tableName ?? "fedify_kv_v2";
-		this.#initialized = options.initialized ?? false;
+		this.#skipDdl = options.initialized ?? false;
 	}
 	async #expire() {
 		await this.#sql`
@@ -116,6 +117,12 @@ var PostgresKvStore = class {
 	async initialize() {
 		if (this.#initialized) return;
 		logger.debug("Initializing the key–value store table {tableName}...", { tableName: this.#tableName });
+		if (!this.#skipDdl) await this.#initializeTable();
+		this.#driverSerializesJson = await require_utils.driverSerializesJson(this.#sql);
+		this.#initialized = true;
+		logger.debug("Initialized the key–value store table {tableName}.", { tableName: this.#tableName });
+	}
+	async #initializeTable() {
 		await this.#sql`
       CREATE UNLOGGED TABLE IF NOT EXISTS ${this.#sql(this.#tableName)} (
         key text[] PRIMARY KEY,
@@ -124,9 +131,6 @@ var PostgresKvStore = class {
         ttl interval
       );
     `;
-		this.#driverSerializesJson = await require_utils.driverSerializesJson(this.#sql);
-		this.#initialized = true;
-		logger.debug("Initialized the key–value store table {tableName}.", { tableName: this.#tableName });
 	}
 	/**
 	* Drops the table used by the key–value store.  Does nothing if the table

package/dist/kv.d.cts

@@ -15,6 +15,10 @@ interface PostgresKvStoreOptions {
   readonly tableName?: string;
   /**
   * Whether the table has been initialized.  `false` by default.
+  *
+  * This skips only the table's schema DDL.  Driver-specific runtime setup,
+  * such as detecting whether the driver serializes JSON parameters on its
+  * own, still runs before the first key is read or written.
   * @default `false`
   */
   readonly initialized?: boolean;

package/dist/kv.d.ts

@@ -15,6 +15,10 @@ interface PostgresKvStoreOptions {
   readonly tableName?: string;
   /**
   * Whether the table has been initialized.  `false` by default.
+  *
+  * This skips only the table's schema DDL.  Driver-specific runtime setup,
+  * such as detecting whether the driver serializes JSON parameters on its
+  * own, still runs before the first key is read or written.
   * @default `false`
   */
   readonly initialized?: boolean;

package/dist/kv.js

@@ -25,7 +25,8 @@ const logger = getLogger([
 var PostgresKvStore = class {
 	#sql;
 	#tableName;
-	#initialized;
+	#skipDdl;
+	#initialized = false;
 	#driverSerializesJson = false;
 	/**
 	* Creates a new PostgreSQL key–value store.
@@ -35,7 +36,7 @@ var PostgresKvStore = class {
 	constructor(sql, options = {}) {
 		this.#sql = sql;
 		this.#tableName = options.tableName ?? "fedify_kv_v2";
-		this.#initialized = options.initialized ?? false;
+		this.#skipDdl = options.initialized ?? false;
 	}
 	async #expire() {
 		await this.#sql`
@@ -115,6 +116,12 @@ var PostgresKvStore = class {
 	async initialize() {
 		if (this.#initialized) return;
 		logger.debug("Initializing the key–value store table {tableName}...", { tableName: this.#tableName });
+		if (!this.#skipDdl) await this.#initializeTable();
+		this.#driverSerializesJson = await driverSerializesJson(this.#sql);
+		this.#initialized = true;
+		logger.debug("Initialized the key–value store table {tableName}.", { tableName: this.#tableName });
+	}
+	async #initializeTable() {
 		await this.#sql`
       CREATE UNLOGGED TABLE IF NOT EXISTS ${this.#sql(this.#tableName)} (
         key text[] PRIMARY KEY,
@@ -123,9 +130,6 @@ var PostgresKvStore = class {
         ttl interval
       );
     `;
-		this.#driverSerializesJson = await driverSerializesJson(this.#sql);
-		this.#initialized = true;
-		logger.debug("Initialized the key–value store table {tableName}.", { tableName: this.#tableName });
 	}
 	/**
 	* Drops the table used by the key–value store.  Does nothing if the table

package/dist/mq.cjs

@@ -60,7 +60,8 @@ var PostgresMessageQueue = class {
 	#channelName;
 	#pollIntervalMs;
 	#handlerTimeoutMs;
-	#initialized;
+	#skipDdl;
+	#initialized = false;
 	#initPromise;
 	#driverSerializesJson = false;
 	constructor(sql, options = {}) {
@@ -69,7 +70,7 @@ var PostgresMessageQueue = class {
 		this.#channelName = options?.channelName ?? "fedify_channel";
 		this.#pollIntervalMs = Temporal.Duration.from(options?.pollInterval ?? { seconds: 5 }).total("millisecond");
 		this.#handlerTimeoutMs = Temporal.Duration.from(options?.handlerTimeout ?? { seconds: 60 }).total("millisecond");
-		this.#initialized = options?.initialized ?? false;
+		this.#skipDdl = options?.initialized ?? false;
 	}
 	async enqueue(message, options) {
 		await this.initialize();
@@ -308,6 +309,12 @@ var PostgresMessageQueue = class {
 	}
 	async #doInitialize() {
 		logger.debug("Initializing the message queue table {tableName}...", { tableName: this.#tableName });
+		if (!this.#skipDdl) await this.#initializeTable();
+		this.#driverSerializesJson = await require_utils.driverSerializesJson(this.#sql);
+		this.#initialized = true;
+		logger.debug("Initialized the message queue table {tableName}.", { tableName: this.#tableName });
+	}
+	async #initializeTable() {
 		for (let attempt = 1; attempt <= INITIALIZE_MAX_ATTEMPTS; attempt++) try {
 			await this.#sql`
       CREATE TABLE IF NOT EXISTS ${this.#sql(this.#tableName)} (
@@ -342,9 +349,6 @@ var PostgresMessageQueue = class {
 			});
 			await sleep(backoffMs);
 		}
-		this.#driverSerializesJson = await require_utils.driverSerializesJson(this.#sql);
-		this.#initialized = true;
-		logger.debug("Initialized the message queue table {tableName}.", { tableName: this.#tableName });
 	}
 	/**
 	* Drops the message queue table if it exists.

package/dist/mq.d.cts

@@ -21,6 +21,10 @@ interface PostgresMessageQueueOptions {
   readonly channelName?: string;
   /**
   * Whether the table has been initialized.  `false` by default.
+  *
+  * This skips only the table's schema DDL.  Driver-specific runtime setup,
+  * such as detecting whether the driver serializes JSON parameters on its
+  * own, still runs before the first message is enqueued.
   * @default `false`
   */
   readonly initialized?: boolean;

package/dist/mq.d.ts

@@ -21,6 +21,10 @@ interface PostgresMessageQueueOptions {
   readonly channelName?: string;
   /**
   * Whether the table has been initialized.  `false` by default.
+  *
+  * This skips only the table's schema DDL.  Driver-specific runtime setup,
+  * such as detecting whether the driver serializes JSON parameters on its
+  * own, still runs before the first message is enqueued.
   * @default `false`
   */
   readonly initialized?: boolean;

package/dist/mq.js

@@ -57,7 +57,8 @@ var PostgresMessageQueue = class {
 	#channelName;
 	#pollIntervalMs;
 	#handlerTimeoutMs;
-	#initialized;
+	#skipDdl;
+	#initialized = false;
 	#initPromise;
 	#driverSerializesJson = false;
 	constructor(sql, options = {}) {
@@ -66,7 +67,7 @@ var PostgresMessageQueue = class {
 		this.#channelName = options?.channelName ?? "fedify_channel";
 		this.#pollIntervalMs = Temporal.Duration.from(options?.pollInterval ?? { seconds: 5 }).total("millisecond");
 		this.#handlerTimeoutMs = Temporal.Duration.from(options?.handlerTimeout ?? { seconds: 60 }).total("millisecond");
-		this.#initialized = options?.initialized ?? false;
+		this.#skipDdl = options?.initialized ?? false;
 	}
 	async enqueue(message, options) {
 		await this.initialize();
@@ -305,6 +306,12 @@ var PostgresMessageQueue = class {
 	}
 	async #doInitialize() {
 		logger.debug("Initializing the message queue table {tableName}...", { tableName: this.#tableName });
+		if (!this.#skipDdl) await this.#initializeTable();
+		this.#driverSerializesJson = await driverSerializesJson(this.#sql);
+		this.#initialized = true;
+		logger.debug("Initialized the message queue table {tableName}.", { tableName: this.#tableName });
+	}
+	async #initializeTable() {
 		for (let attempt = 1; attempt <= INITIALIZE_MAX_ATTEMPTS; attempt++) try {
 			await this.#sql`
       CREATE TABLE IF NOT EXISTS ${this.#sql(this.#tableName)} (
@@ -339,9 +346,6 @@ var PostgresMessageQueue = class {
 			});
 			await sleep(backoffMs);
 		}
-		this.#driverSerializesJson = await driverSerializesJson(this.#sql);
-		this.#initialized = true;
-		logger.debug("Initialized the message queue table {tableName}.", { tableName: this.#tableName });
 	}
 	/**
 	* Drops the message queue table if it exists.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/postgres",
-  "version": "2.3.6",
+  "version": "2.3.8",
   "description": "PostgreSQL drivers for Fedify",
   "keywords": [
     "fedify",
@@ -74,14 +74,14 @@
   },
   "peerDependencies": {
     "postgres": "^3.4.7",
-    "@fedify/fedify": "^2.3.6"
+    "@fedify/fedify": "^2.3.8"
   },
   "devDependencies": {
     "@std/async": "npm:@jsr/std__async@^1.0.13",
     "tsdown": "^0.22.0",
     "typescript": "^6.0.0",
     "@fedify/fixture": "^2.0.0",
-    "@fedify/testing": "^2.3.6"
+    "@fedify/testing": "^2.3.8"
   },
   "scripts": {
     "build:self": "tsdown",