@geekmidas/events 1.0.0 → 1.1.1

package/dist/sqs/index.mjs

@@ -1,6 +1,6 @@
-import "../types-B63qHVOG.mjs";
-import { SQSConnection } from "../SQSConnection-BwHhXLIu.mjs";
-import { SQSSubscriber } from "../SQSSubscriber-ux7QEMdd.mjs";
-import { SQSPublisher } from "../SQSPublisher-BDGMw1uf.mjs";
+import "../types-BrdcSEnd.mjs";
+import { SQSConnection } from "../SQSConnection-CT3S7_zP.mjs";
+import { SQSSubscriber } from "../SQSSubscriber-CQdSFzpe.mjs";
+import { SQSPublisher } from "../SQSPublisher-B-32CC4G.mjs";
 
 export { SQSConnection, SQSPublisher, SQSSubscriber };

package/dist/{types-B63qHVOG.mjs → types-BrdcSEnd.mjs}

@@ -9,9 +9,10 @@ let EventPublisherType = /* @__PURE__ */ function(EventPublisherType$1) {
 	EventPublisherType$1["SNS"] = "sns";
 	EventPublisherType$1["Kafka"] = "kafka";
 	EventPublisherType$1["RabbitMQ"] = "rabbitmq";
+	EventPublisherType$1["PgBoss"] = "pgboss";
 	return EventPublisherType$1;
 }({});
 
 //#endregion
 export { EventPublisherType };
-//# sourceMappingURL=types-B63qHVOG.mjs.map
+//# sourceMappingURL=types-BrdcSEnd.mjs.map

package/dist/types-BrdcSEnd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BrdcSEnd.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { InferStandardSchema } from '@geekmidas/schema';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Represents a publishable event message with a type and payload.\n *\n * @template TType - The event type/name (e.g., 'user.created')\n * @template TPayload - The event payload data\n */\nexport type PublishableMessage<TType extends string, TPayload> = {\n\ttype: TType;\n\tpayload: TPayload;\n};\n\n/**\n * Event publisher/subscriber types\n */\nexport enum EventPublisherType {\n\tBasic = 'basic',\n\tEventBridge = 'eventbridge',\n\tSQS = 'sqs',\n\tSNS = 'sns',\n\tKafka = 'kafka',\n\tRabbitMQ = 'rabbitmq',\n\tPgBoss = 'pgboss',\n}\n\n/**\n * Base interface for event connections\n * Connections manage the underlying transport (RabbitMQ channel, SQS client, etc.)\n */\nexport interface EventConnection {\n\treadonly type: EventPublisherType;\n\tconnect(): Promise<void>;\n\tclose(): Promise<void>;\n\tisConnected(): boolean;\n}\n\n/**\n * Interface for event publishers that handle the actual publishing of events.\n * Implementations can send to EventBridge, SQS, Kafka, or any other event system.\n *\n * @template TMessage - The union type of all publishable messages\n */\nexport type EventPublisher<TMessage extends PublishableMessage<string, any>> = {\n\tpublish: (message: TMessage[]) => Promise<void>;\n};\n\n/**\n * Interface for event subscribers that handle receiving and processing events.\n *\n * @template TMessage - The union type of all publishable messages\n */\nexport type EventSubscriber<TMessage extends PublishableMessage<string, any>> =\n\t{\n\t\tsubscribe: (\n\t\t\tmessages: TMessage['type'][],\n\t\t\tlistener: (payload: TMessage) => Promise<void>,\n\t\t) => Promise<void>;\n\t};\n/**\n * Utility type to extract the message from EventPublisher\n */\nexport type ExtractPublisherMessage<T> =\n\tT extends EventPublisher<infer M> ? M : never;\n\nexport type MappedEvent<\n\tT extends EventPublisher<any> | undefined,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n> = {\n\ttype: ExtractPublisherMessage<T>['type'];\n\tpayload: (\n\t\tctx: InferStandardSchema<OutSchema>,\n\t) => ExtractPublisherMessage<T>['payload'];\n\twhen?: (ctx: InferStandardSchema<OutSchema>) => boolean;\n};\n"],"mappings":";;;;AAiBA,IAAY,oEAAL;AACN;AACA;AACA;AACA;AACA;AACA;AACA;;AACA"}

package/dist/{types-CvSMEO5z.cjs → types-Byv8N9ma.cjs}

@@ -10,6 +10,7 @@ let EventPublisherType = /* @__PURE__ */ function(EventPublisherType$1) {
 	EventPublisherType$1["SNS"] = "sns";
 	EventPublisherType$1["Kafka"] = "kafka";
 	EventPublisherType$1["RabbitMQ"] = "rabbitmq";
+	EventPublisherType$1["PgBoss"] = "pgboss";
 	return EventPublisherType$1;
 }({});
 
@@ -20,4 +21,4 @@ Object.defineProperty(exports, 'EventPublisherType', {
     return EventPublisherType;
   }
 });
-//# sourceMappingURL=types-CvSMEO5z.cjs.map
+//# sourceMappingURL=types-Byv8N9ma.cjs.map

package/dist/types-Byv8N9ma.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Byv8N9ma.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { InferStandardSchema } from '@geekmidas/schema';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Represents a publishable event message with a type and payload.\n *\n * @template TType - The event type/name (e.g., 'user.created')\n * @template TPayload - The event payload data\n */\nexport type PublishableMessage<TType extends string, TPayload> = {\n\ttype: TType;\n\tpayload: TPayload;\n};\n\n/**\n * Event publisher/subscriber types\n */\nexport enum EventPublisherType {\n\tBasic = 'basic',\n\tEventBridge = 'eventbridge',\n\tSQS = 'sqs',\n\tSNS = 'sns',\n\tKafka = 'kafka',\n\tRabbitMQ = 'rabbitmq',\n\tPgBoss = 'pgboss',\n}\n\n/**\n * Base interface for event connections\n * Connections manage the underlying transport (RabbitMQ channel, SQS client, etc.)\n */\nexport interface EventConnection {\n\treadonly type: EventPublisherType;\n\tconnect(): Promise<void>;\n\tclose(): Promise<void>;\n\tisConnected(): boolean;\n}\n\n/**\n * Interface for event publishers that handle the actual publishing of events.\n * Implementations can send to EventBridge, SQS, Kafka, or any other event system.\n *\n * @template TMessage - The union type of all publishable messages\n */\nexport type EventPublisher<TMessage extends PublishableMessage<string, any>> = {\n\tpublish: (message: TMessage[]) => Promise<void>;\n};\n\n/**\n * Interface for event subscribers that handle receiving and processing events.\n *\n * @template TMessage - The union type of all publishable messages\n */\nexport type EventSubscriber<TMessage extends PublishableMessage<string, any>> =\n\t{\n\t\tsubscribe: (\n\t\t\tmessages: TMessage['type'][],\n\t\t\tlistener: (payload: TMessage) => Promise<void>,\n\t\t) => Promise<void>;\n\t};\n/**\n * Utility type to extract the message from EventPublisher\n */\nexport type ExtractPublisherMessage<T> =\n\tT extends EventPublisher<infer M> ? M : never;\n\nexport type MappedEvent<\n\tT extends EventPublisher<any> | undefined,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n> = {\n\ttype: ExtractPublisherMessage<T>['type'];\n\tpayload: (\n\t\tctx: InferStandardSchema<OutSchema>,\n\t) => ExtractPublisherMessage<T>['payload'];\n\twhen?: (ctx: InferStandardSchema<OutSchema>) => boolean;\n};\n"],"mappings":";;;;;AAiBA,IAAY,oEAAL;AACN;AACA;AACA;AACA;AACA;AACA;AACA;;AACA"}

package/dist/{types-DSVsPgKd.d.mts → types-Dh9Jyinx.d.mts}

@@ -23,6 +23,7 @@ declare enum EventPublisherType {
   SNS = "sns",
   Kafka = "kafka",
   RabbitMQ = "rabbitmq",
+  PgBoss = "pgboss",
 }
 /**
  * Base interface for event connections
@@ -63,4 +64,4 @@ type MappedEvent<T extends EventPublisher<any> | undefined, OutSchema extends St
 //# sourceMappingURL=types.d.ts.map
 //#endregion
 export { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage };
-//# sourceMappingURL=types-DSVsPgKd.d.mts.map
+//# sourceMappingURL=types-Dh9Jyinx.d.mts.map

package/dist/types-Dh9Jyinx.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Dh9Jyinx.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;AASA;;;;AAEkB,KAFN,kBAEM,CAAA,cAAA,MAAA,EAAA,QAAA,CAAA,GAAA;EAMN,IAAA,EAPL,KAOK;EAcK,OAAA,EApBP,QAoBO;CAAe;;;;AAGf,aAjBL,kBAAA;EA2BA,KAAA,GAAA,OAAA;EAAc,WAAA,GAAA,aAAA;EAAA,GAAkB,GAAA,KAAA;EAAkB,GAC1C,GAAA,KAAA;EAAQ,KAAO,GAAA,OAAA;EAAO,QAAA,GAAA,UAAA;EAQ9B,MAAA,GAAA,QAAA;;;;;;AAKL,UA3BU,eAAA,CA2BV;EAAO,SAAA,IAAA,EA1BE,kBA0BF;EAKF,OAAA,EAAA,EA9BA,OA8BA,CAAA,IAAA,CAAA;EAAuB,KAAA,EAAA,EA7BzB,OA6ByB,CAAA,IAAA,CAAA;EAAA,WAClC,EAAA,EAAA,OAAA;;;AAAqC;AAEtC;;;;AAI+B,KA1BnB,cA0BmB,CAAA,iBA1Ba,kBA0Bb,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;EAAC,OAAzB,EAAA,CAAA,OAAA,EAzBa,QAyBb,EAAA,EAAA,GAzB4B,OAyB5B,CAAA,IAAA,CAAA;CAAuB;;;;;;AAIG,KArBrB,eAqBqB,CAAA,iBArBY,kBAqBZ,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;wBAlBpB,wCACU,aAAa,kBAC7B;;;;;KAKK,6BACX,UAAU,0BAA0B;KAEzB,sBACD,mDACQ;QAEZ,wBAAwB;iBAExB,oBAAoB,eACrB,wBAAwB;eAChB,oBAAoB"}

package/dist/{types-Dmbp1U-6.d.cts → types-Dj23od3e.d.cts}

@@ -23,6 +23,7 @@ declare enum EventPublisherType {
   SNS = "sns",
   Kafka = "kafka",
   RabbitMQ = "rabbitmq",
+  PgBoss = "pgboss",
 }
 /**
  * Base interface for event connections
@@ -63,4 +64,4 @@ type MappedEvent<T extends EventPublisher<any> | undefined, OutSchema extends St
 //# sourceMappingURL=types.d.ts.map
 //#endregion
 export { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage };
-//# sourceMappingURL=types-Dmbp1U-6.d.cts.map
+//# sourceMappingURL=types-Dj23od3e.d.cts.map

package/dist/types-Dj23od3e.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Dj23od3e.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;AASA;;;;AAEkB,KAFN,kBAEM,CAAA,cAAA,MAAA,EAAA,QAAA,CAAA,GAAA;EAMN,IAAA,EAPL,KAOK;EAcK,OAAA,EApBP,QAoBO;CAAe;;;;AAGf,aAjBL,kBAAA;EA2BA,KAAA,GAAA,OAAA;EAAc,WAAA,GAAA,aAAA;EAAA,GAAkB,GAAA,KAAA;EAAkB,GAC1C,GAAA,KAAA;EAAQ,KAAO,GAAA,OAAA;EAAO,QAAA,GAAA,UAAA;EAQ9B,MAAA,GAAA,QAAA;;;;;;AAKL,UA3BU,eAAA,CA2BV;EAAO,SAAA,IAAA,EA1BE,kBA0BF;EAKF,OAAA,EAAA,EA9BA,OA8BA,CAAA,IAAA,CAAA;EAAuB,KAAA,EAAA,EA7BzB,OA6ByB,CAAA,IAAA,CAAA;EAAA,WAClC,EAAA,EAAA,OAAA;;;AAAqC;AAEtC;;;;AAI+B,KA1BnB,cA0BmB,CAAA,iBA1Ba,kBA0Bb,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;EAAC,OAAzB,EAAA,CAAA,OAAA,EAzBa,QAyBb,EAAA,EAAA,GAzB4B,OAyB5B,CAAA,IAAA,CAAA;CAAuB;;;;;;AAIG,KArBrB,eAqBqB,CAAA,iBArBY,kBAqBZ,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;wBAlBpB,wCACU,aAAa,kBAC7B;;;;;KAKK,6BACX,UAAU,0BAA0B;KAEzB,sBACD,mDACQ;QAEZ,wBAAwB;iBAExB,oBAAoB,eACrB,wBAAwB;eAChB,oBAAoB"}

package/dist/types.cjs

@@ -1,3 +1,3 @@
-const require_types = require('./types-CvSMEO5z.cjs');
+const require_types = require('./types-Byv8N9ma.cjs');
 
 exports.EventPublisherType = require_types.EventPublisherType;

package/dist/types.d.cts

@@ -1,2 +1,2 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage } from "./types-Dmbp1U-6.cjs";
+import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage } from "./types-Dj23od3e.cjs";
 export { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage } from "./types-DSVsPgKd.mjs";
+import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage } from "./types-Dh9Jyinx.mjs";
 export { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, ExtractPublisherMessage, MappedEvent, PublishableMessage };

package/dist/types.mjs

@@ -1,3 +1,3 @@
-import { EventPublisherType } from "./types-B63qHVOG.mjs";
+import { EventPublisherType } from "./types-BrdcSEnd.mjs";
 
 export { EventPublisherType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/events",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "type": "module",
   "exports": {
     ".": {
@@ -27,6 +27,11 @@
       "types": "./dist/sns/index.d.ts",
       "import": "./dist/sns/index.mjs",
       "require": "./dist/sns/index.cjs"
+    },
+    "./pgboss": {
+      "types": "./dist/pgboss/index.d.ts",
+      "import": "./dist/pgboss/index.mjs",
+      "require": "./dist/pgboss/index.cjs"
     }
   },
   "repository": {
@@ -44,6 +49,7 @@
     "amqplib": "^0.10.3",
     "@aws-sdk/client-sqs": "~3.908.0",
     "@aws-sdk/client-sns": "~3.908.0",
+    "pg-boss": ">=12.0.0",
     "@geekmidas/schema": "^1.0.0"
   },
   "peerDependenciesMeta": {
@@ -58,11 +64,15 @@
     },
     "@aws-sdk/client-sns": {
       "optional": true
+    },
+    "pg-boss": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/amqplib": "~0.10.7",
     "@types/lodash.chunk": "~4.2.0",
+    "pg-boss": "~12.18.1",
     "@geekmidas/schema": "^1.0.0"
   }
 }

package/src/EventConnection.ts

@@ -29,6 +29,10 @@ export class EventConnectionFactory {
 				const { SNSConnection } = await import('./sns');
 				return SNSConnection.fromConnectionString(connectionStr);
 			}
+			case EventPublisherType.PgBoss: {
+				const { PgBossConnection } = await import('./pgboss');
+				return PgBossConnection.fromConnectionString(connectionStr);
+			}
 			default:
 				throw new Error(`Unsupported connection type: ${protocol}`);
 		}

package/src/Publisher.ts

@@ -35,6 +35,10 @@ export class Publisher {
 				const { SNSPublisher } = await import('./sns');
 				return SNSPublisher.fromConnectionString<TMessage>(connectionStr);
 			}
+			case EventPublisherType.PgBoss: {
+				const { PgBossPublisher } = await import('./pgboss');
+				return PgBossPublisher.fromConnectionString<TMessage>(connectionStr);
+			}
 			// Future implementations for EventBridge, Kafka, etc.
 			default:
 				throw new Error(`Unsupported event publisher type: ${url.protocol}`);
@@ -77,6 +81,13 @@ export class Publisher {
 					connection as InstanceType<typeof SNSConnection>,
 				);
 			}
+			case EventPublisherType.PgBoss: {
+				const { PgBossPublisher } = await import('./pgboss');
+				const { PgBossConnection } = await import('./pgboss');
+				return new PgBossPublisher<TMessage>(
+					connection as InstanceType<typeof PgBossConnection>,
+				);
+			}
 			default:
 				throw new Error(`Unsupported connection type: ${connection.type}`);
 		}

package/src/Subscriber.ts

@@ -50,6 +50,10 @@ export class Subscriber {
 					await SQSConnection.fromConnectionString(connectionStr);
 				return new SQSSubscriber<TMessage>(connection);
 			}
+			case EventPublisherType.PgBoss: {
+				const { PgBossSubscriber } = await import('./pgboss');
+				return PgBossSubscriber.fromConnectionString<TMessage>(connectionStr);
+			}
 			// Future implementations for EventBridge, Kafka, etc.
 			default:
 				throw new Error(`Unsupported event subscriber type: ${url.protocol}`);
@@ -92,6 +96,13 @@ export class Subscriber {
 					connection as InstanceType<typeof SQSConnection>,
 				);
 			}
+			case EventPublisherType.PgBoss: {
+				const { PgBossSubscriber } = await import('./pgboss');
+				const { PgBossConnection } = await import('./pgboss');
+				return new PgBossSubscriber<TMessage>(
+					connection as InstanceType<typeof PgBossConnection>,
+				);
+			}
 			default:
 				throw new Error(`Unsupported connection type: ${connection.type}`);
 		}

package/src/pgboss/PgBossConnection.ts

@@ -0,0 +1,91 @@
+import { PgBoss } from 'pg-boss';
+import type { EventConnection } from '../types';
+import { EventPublisherType } from '../types';
+
+export interface PgBossConnectionConfig {
+	connectionString: string;
+	schema?: string;
+}
+
+export class PgBossConnection implements EventConnection {
+	readonly type = EventPublisherType.PgBoss;
+	private boss?: PgBoss;
+	private connecting?: Promise<void>;
+
+	constructor(private config: PgBossConnectionConfig) {}
+
+	/**
+	 * Create a PgBossConnection from a connection string.
+	 * Format: pgboss://user:pass@host:5432/database?schema=pgboss
+	 */
+	static async fromConnectionString(
+		connectionString: string,
+	): Promise<PgBossConnection> {
+		const url = new URL(connectionString);
+		const params = url.searchParams;
+
+		const postgresUrl = `postgres://${url.username ? `${url.username}:${url.password}@` : ''}${url.host}${url.pathname}`;
+
+		const config: PgBossConnectionConfig = {
+			connectionString: postgresUrl,
+			schema: params.get('schema') || undefined,
+		};
+
+		const connection = new PgBossConnection(config);
+		await connection.connect();
+		return connection;
+	}
+
+	async connect(): Promise<void> {
+		if (this.boss) return;
+
+		if (this.connecting) {
+			await this.connecting;
+			return;
+		}
+
+		this.connecting = (async () => {
+			try {
+				const boss = new PgBoss({
+					connectionString: this.config.connectionString,
+					...(this.config.schema && { schema: this.config.schema }),
+				});
+
+				await boss.start();
+				this.boss = boss;
+			} catch (error) {
+				this.cleanup();
+				throw error;
+			}
+		})();
+
+		await this.connecting;
+		this.connecting = undefined;
+	}
+
+	async close(): Promise<void> {
+		try {
+			await this.boss?.stop({ graceful: true });
+		} catch {
+			// Ignore errors during close
+		} finally {
+			this.cleanup();
+		}
+	}
+
+	isConnected(): boolean {
+		return !!this.boss;
+	}
+
+	private cleanup(): void {
+		this.boss = undefined;
+		this.connecting = undefined;
+	}
+
+	/**
+	 * Get the underlying pg-boss instance for publishing/subscribing
+	 */
+	get instance(): PgBoss | undefined {
+		return this.boss;
+	}
+}

package/src/pgboss/PgBossPublisher.ts

@@ -0,0 +1,49 @@
+import type { EventPublisher, PublishableMessage } from '../types';
+import type { PgBossConnection } from './PgBossConnection';
+
+export class PgBossPublisher<TMessage extends PublishableMessage<string, any>>
+	implements EventPublisher<TMessage>
+{
+	constructor(private connection: PgBossConnection) {}
+
+	/**
+	 * Create a PgBossPublisher from a connection string.
+	 * Format: pgboss://user:pass@host:5432/database?schema=pgboss
+	 */
+	static async fromConnectionString<
+		TMessage extends PublishableMessage<string, any>,
+	>(connectionString: string): Promise<PgBossPublisher<TMessage>> {
+		const { PgBossConnection } = await import('./PgBossConnection');
+		const connection =
+			await PgBossConnection.fromConnectionString(connectionString);
+		return new PgBossPublisher<TMessage>(connection);
+	}
+
+	async publish(messages: TMessage[]): Promise<void> {
+		if (!this.connection.isConnected()) {
+			await this.connection.connect();
+		}
+
+		const boss = this.connection.instance;
+		if (!boss) {
+			throw new Error('PgBoss instance not initialized');
+		}
+
+		// Group jobs by queue name (v11+ requires per-queue insert calls)
+		const groups = new Map<string, { data: TMessage['payload'] }[]>();
+		for (const m of messages) {
+			const list = groups.get(m.type) ?? [];
+			list.push({ data: m.payload });
+			groups.set(m.type, list);
+		}
+
+		for (const [name, jobs] of groups) {
+			await boss.createQueue(name);
+			await boss.insert(name, jobs);
+		}
+	}
+
+	async close(): Promise<void> {
+		// Publisher doesn't own the connection
+	}
+}

package/src/pgboss/PgBossSubscriber.ts

@@ -0,0 +1,81 @@
+import type { EventSubscriber, PublishableMessage } from '../types';
+import type { PgBossConnection } from './PgBossConnection';
+
+export interface PgBossSubscriberOptions {
+	batchSize?: number;
+	pollingIntervalSeconds?: number;
+}
+
+export class PgBossSubscriber<TMessage extends PublishableMessage<string, any>>
+	implements EventSubscriber<TMessage>
+{
+	constructor(
+		private connection: PgBossConnection,
+		private options: PgBossSubscriberOptions = {},
+	) {}
+
+	/**
+	 * Create a PgBossSubscriber from a connection string.
+	 * Format: pgboss://user:pass@host:5432/database?schema=pgboss&batchSize=5
+	 */
+	static async fromConnectionString<
+		TMessage extends PublishableMessage<string, any>,
+	>(connectionString: string): Promise<PgBossSubscriber<TMessage>> {
+		const url = new URL(connectionString);
+		const params = url.searchParams;
+
+		const { PgBossConnection } = await import('./PgBossConnection');
+		const connection =
+			await PgBossConnection.fromConnectionString(connectionString);
+
+		const options: PgBossSubscriberOptions = {
+			batchSize: params.get('batchSize')
+				? Number.parseInt(params.get('batchSize')!, 10)
+				: undefined,
+			pollingIntervalSeconds: params.get('pollingIntervalSeconds')
+				? Number.parseInt(params.get('pollingIntervalSeconds')!, 10)
+				: undefined,
+		};
+
+		return new PgBossSubscriber<TMessage>(connection, options);
+	}
+
+	async subscribe(
+		messages: TMessage['type'][],
+		listener: (payload: TMessage) => Promise<void>,
+	): Promise<void> {
+		if (!this.connection.isConnected()) {
+			await this.connection.connect();
+		}
+
+		const boss = this.connection.instance;
+		if (!boss) {
+			throw new Error('PgBoss instance not initialized');
+		}
+
+		for (const messageType of messages) {
+			await boss.createQueue(messageType);
+			await boss.work(
+				messageType,
+				{
+					...(this.options.batchSize && {
+						batchSize: this.options.batchSize,
+					}),
+					...(this.options.pollingIntervalSeconds && {
+						pollingIntervalSeconds: this.options.pollingIntervalSeconds,
+					}),
+				},
+				async (jobs) => {
+					for (const job of jobs) {
+						const fullMessage = {
+							type: job.name,
+							payload: job.data,
+						} as TMessage;
+
+						await listener(fullMessage);
+					}
+				},
+			);
+		}
+	}
+}

package/src/pgboss/__tests__/pgboss.spec.ts

@@ -0,0 +1,183 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import type { PublishableMessage } from '../../types';
+import { PgBossConnection } from '../PgBossConnection';
+import { PgBossPublisher } from '../PgBossPublisher';
+import { PgBossSubscriber } from '../PgBossSubscriber';
+
+type TestMessage =
+	| PublishableMessage<'user.created', { userId: string }>
+	| PublishableMessage<'user.updated', { userId: string; name: string }>;
+
+const POSTGRES_URL = 'postgres://geekmidas:geekmidas@localhost:5432/geekmidas';
+const PGBOSS_CONNECTION_STRING =
+	'pgboss://geekmidas:geekmidas@localhost:5432/geekmidas?schema=pgboss_test';
+
+const uniqueQueue = () =>
+	`test-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+
+describe('PgBossConnection', () => {
+	it('should connect and report connected status', async () => {
+		const connection = new PgBossConnection({
+			connectionString: POSTGRES_URL,
+			schema: 'pgboss_conn_test',
+		});
+
+		expect(connection.isConnected()).toBe(false);
+		expect(connection.instance).toBeUndefined();
+
+		await connection.connect();
+
+		expect(connection.isConnected()).toBe(true);
+		expect(connection.instance).toBeDefined();
+
+		await connection.close();
+
+		expect(connection.isConnected()).toBe(false);
+	});
+
+	it('should not reconnect if already connected', async () => {
+		const connection = new PgBossConnection({
+			connectionString: POSTGRES_URL,
+			schema: 'pgboss_conn_test2',
+		});
+
+		await connection.connect();
+		const firstInstance = connection.instance;
+
+		await connection.connect();
+		expect(connection.instance).toBe(firstInstance);
+
+		await connection.close();
+	});
+
+	it('should parse connection string correctly', async () => {
+		const connection = await PgBossConnection.fromConnectionString(
+			PGBOSS_CONNECTION_STRING,
+		);
+
+		expect(connection.isConnected()).toBe(true);
+		expect(connection.instance).toBeDefined();
+
+		await connection.close();
+	});
+});
+
+describe('PgBossPublisher', () => {
+	let connection: PgBossConnection;
+
+	beforeAll(async () => {
+		connection = new PgBossConnection({
+			connectionString: POSTGRES_URL,
+			schema: 'pgboss_pub_test',
+		});
+		await connection.connect();
+	});
+
+	afterAll(async () => {
+		await connection.close();
+	});
+
+	it('should publish messages without errors', async () => {
+		const publisher = new PgBossPublisher<TestMessage>(connection);
+
+		await publisher.publish([
+			{ type: uniqueQueue() as any, payload: { userId: '1' } },
+		]);
+	});
+
+	it('should publish multiple messages with different types', async () => {
+		const publisher = new PgBossPublisher<TestMessage>(connection);
+		const queue1 = uniqueQueue() as any;
+		const queue2 = uniqueQueue() as any;
+
+		await publisher.publish([
+			{ type: queue1, payload: { userId: '1' } },
+			{ type: queue1, payload: { userId: '2' } },
+			{ type: queue2, payload: { userId: '3', name: 'Alice' } },
+		]);
+	});
+
+	it('should create publisher from connection string', async () => {
+		const publisher = await PgBossPublisher.fromConnectionString<TestMessage>(
+			PGBOSS_CONNECTION_STRING,
+		);
+
+		expect(publisher).toBeInstanceOf(PgBossPublisher);
+	});
+});
+
+describe('PgBossSubscriber', () => {
+	let connection: PgBossConnection;
+
+	beforeAll(async () => {
+		connection = new PgBossConnection({
+			connectionString: POSTGRES_URL,
+			schema: 'pgboss_sub_test',
+		});
+		await connection.connect();
+	});
+
+	afterAll(async () => {
+		await connection.close();
+	});
+
+	it('should receive published messages', async () => {
+		const queueName = uniqueQueue() as any;
+		const publisher = new PgBossPublisher<TestMessage>(connection);
+		const subscriber = new PgBossSubscriber<TestMessage>(connection, {
+			pollingIntervalSeconds: 1,
+		});
+
+		const received: TestMessage[] = [];
+
+		await subscriber.subscribe([queueName], async (message) => {
+			received.push(message);
+		});
+
+		await publisher.publish([{ type: queueName, payload: { userId: '42' } }]);
+
+		// Wait for pg-boss to poll and deliver
+		await new Promise((resolve) => setTimeout(resolve, 3000));
+
+		expect(received.length).toBe(1);
+		expect(received[0]).toEqual({
+			type: queueName,
+			payload: { userId: '42' },
+		});
+	});
+
+	it('should subscribe to multiple message types', async () => {
+		const queue1 = uniqueQueue() as any;
+		const queue2 = uniqueQueue() as any;
+		const publisher = new PgBossPublisher<TestMessage>(connection);
+		const subscriber = new PgBossSubscriber<TestMessage>(connection, {
+			pollingIntervalSeconds: 1,
+		});
+
+		const received: TestMessage[] = [];
+
+		await subscriber.subscribe([queue1, queue2], async (message) => {
+			received.push(message);
+		});
+
+		await publisher.publish([
+			{ type: queue1, payload: { userId: '1' } },
+			{ type: queue2, payload: { userId: '2', name: 'Bob' } },
+		]);
+
+		await new Promise((resolve) => setTimeout(resolve, 3000));
+
+		expect(received.length).toBe(2);
+		expect(received.map((m) => m.payload)).toEqual(
+			expect.arrayContaining([{ userId: '1' }, { userId: '2', name: 'Bob' }]),
+		);
+	});
+
+	it('should create subscriber from connection string with options', async () => {
+		const subscriber = await PgBossSubscriber.fromConnectionString<TestMessage>(
+			`${PGBOSS_CONNECTION_STRING}&batchSize=10`,
+		);
+
+		expect(subscriber).toBeInstanceOf(PgBossSubscriber);
+	});
+});

package/src/pgboss/index.ts

@@ -0,0 +1,5 @@
+export type { PgBossConnectionConfig } from './PgBossConnection';
+export { PgBossConnection } from './PgBossConnection';
+export { PgBossPublisher } from './PgBossPublisher';
+export type { PgBossSubscriberOptions } from './PgBossSubscriber';
+export { PgBossSubscriber } from './PgBossSubscriber';

package/src/types.ts

@@ -22,6 +22,7 @@ export enum EventPublisherType {
 	SNS = 'sns',
 	Kafka = 'kafka',
 	RabbitMQ = 'rabbitmq',
+	PgBoss = 'pgboss',
 }
 
 /**

package/dist/Subscriber-Bd9hb_jp.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Subscriber-Bd9hb_jp.mjs","names":["connectionStr: EventSubscriberConnectionString","url","connection: EventConnection"],"sources":["../src/Subscriber.ts"],"sourcesContent":["import type {\n\tEventConnection,\n\tEventSubscriber,\n\tPublishableMessage,\n} from './types';\nimport { EventPublisherType } from './types';\n\nexport class Subscriber {\n\t/**\n\t * Create a subscriber from a connection string\n\t * This creates both a connection and a subscriber\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(\n\t\tconnectionStr: EventSubscriberConnectionString,\n\t): Promise<EventSubscriber<TMessage>> {\n\t\tconst url = new URL(connectionStr);\n\t\tswitch (url.protocol.replace(':', '')) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicConnection, BasicSubscriber } = await import('./basic');\n\t\t\t\tconst connection =\n\t\t\t\t\tawait BasicConnection.fromConnectionString(connectionStr);\n\t\t\t\treturn new BasicSubscriber<TMessage>(connection);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQSubscriber } = await import('./rabbitmq');\n\t\t\t\treturn RabbitMQSubscriber.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\treturn SNSSubscriber.fromConnectionString<TMessage>(connectionStr);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst url = new URL(connectionStr);\n\t\t\t\tconst topicArn = url.searchParams.get('topicArn');\n\n\t\t\t\t// If topicArn is present, use managed SNS→SQS subscription\n\t\t\t\tif (topicArn) {\n\t\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\t\t// Convert SQS connection string to SNS connection string\n\t\t\t\t\tconst snsConnectionStr = connectionStr.replace('sqs://', 'sns://');\n\t\t\t\t\treturn SNSSubscriber.fromConnectionString<TMessage>(snsConnectionStr);\n\t\t\t\t}\n\n\t\t\t\t// Direct SQS subscriber\n\t\t\t\tconst { SQSSubscriber } = await import('./sqs');\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\tconst connection =\n\t\t\t\t\tawait SQSConnection.fromConnectionString(connectionStr);\n\t\t\t\treturn new SQSSubscriber<TMessage>(connection);\n\t\t\t}\n\t\t\t// Future implementations for EventBridge, Kafka, etc.\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported event subscriber type: ${url.protocol}`);\n\t\t}\n\t}\n\n\t/**\n\t * Create a subscriber from an existing connection\n\t * This allows sharing connections between publishers and subscribers\n\t */\n\tstatic async fromConnection<TMessage extends PublishableMessage<string, any>>(\n\t\tconnection: EventConnection,\n\t): Promise<EventSubscriber<TMessage>> {\n\t\tswitch (connection.type) {\n\t\t\tcase EventPublisherType.Basic: {\n\t\t\t\tconst { BasicSubscriber } = await import('./basic');\n\t\t\t\tconst { BasicConnection } = await import('./basic');\n\t\t\t\treturn new BasicSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof BasicConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.RabbitMQ: {\n\t\t\t\tconst { RabbitMQSubscriber } = await import('./rabbitmq');\n\t\t\t\tconst { RabbitMQConnection } = await import('./rabbitmq');\n\t\t\t\treturn new RabbitMQSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof RabbitMQConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SNS: {\n\t\t\t\tconst { SNSSubscriber } = await import('./sns');\n\t\t\t\tconst { SNSConnection } = await import('./sns');\n\t\t\t\treturn new SNSSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SNSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tcase EventPublisherType.SQS: {\n\t\t\t\tconst { SQSSubscriber } = await import('./sqs');\n\t\t\t\tconst { SQSConnection } = await import('./sqs');\n\t\t\t\treturn new SQSSubscriber<TMessage>(\n\t\t\t\t\tconnection as InstanceType<typeof SQSConnection>,\n\t\t\t\t);\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`Unsupported connection type: ${connection.type}`);\n\t\t}\n\t}\n}\n\nexport type EventSubscriberConnectionString =\n\t`${EventPublisherType}://${string}`;\n"],"mappings":";;;AAOA,IAAa,aAAb,MAAwB;;;;;CAKvB,aAAa,qBAGZA,eACqC;EACrC,MAAM,MAAM,IAAI,IAAI;AACpB,UAAQ,IAAI,SAAS,QAAQ,KAAK,GAAG,EAArC;GACC,KAAK,mBAAmB,OAAO;IAC9B,MAAM,EAAE,iBAAiB,iBAAiB,GAAG,MAAM,OAAO;IAC1D,MAAM,aACL,MAAM,gBAAgB,qBAAqB,cAAc;AAC1D,WAAO,IAAI,gBAA0B;GACrC;GACD,KAAK,mBAAmB,UAAU;IACjC,MAAM,EAAE,oBAAoB,GAAG,MAAM,OAAO;AAC5C,WAAO,mBAAmB,qBAA+B,cAAc;GACvE;GACD,KAAK,mBAAmB,KAAK;IAC5B,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;AACvC,WAAO,cAAc,qBAA+B,cAAc;GAClE;GACD,KAAK,mBAAmB,KAAK;IAC5B,MAAMC,QAAM,IAAI,IAAI;IACpB,MAAM,WAAW,MAAI,aAAa,IAAI,WAAW;AAGjD,QAAI,UAAU;KACb,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;KAEvC,MAAM,mBAAmB,cAAc,QAAQ,UAAU,SAAS;AAClE,YAAO,cAAc,qBAA+B,iBAAiB;IACrE;IAGD,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;IACvC,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;IACvC,MAAM,aACL,MAAM,cAAc,qBAAqB,cAAc;AACxD,WAAO,IAAI,cAAwB;GACnC;GAED,QACC,OAAM,IAAI,OAAO,qCAAqC,IAAI,SAAS;EACpE;CACD;;;;;CAMD,aAAa,eACZC,YACqC;AACrC,UAAQ,WAAW,MAAnB;GACC,KAAK,mBAAmB,OAAO;IAC9B,MAAM,EAAE,iBAAiB,GAAG,MAAM,OAAO;IACzC,MAAM,EAAE,iBAAiB,GAAG,MAAM,OAAO;AACzC,WAAO,IAAI,gBACV;GAED;GACD,KAAK,mBAAmB,UAAU;IACjC,MAAM,EAAE,oBAAoB,GAAG,MAAM,OAAO;IAC5C,MAAM,EAAE,oBAAoB,GAAG,MAAM,OAAO;AAC5C,WAAO,IAAI,mBACV;GAED;GACD,KAAK,mBAAmB,KAAK;IAC5B,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;IACvC,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;AACvC,WAAO,IAAI,cACV;GAED;GACD,KAAK,mBAAmB,KAAK;IAC5B,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;IACvC,MAAM,EAAE,eAAe,GAAG,MAAM,OAAO;AACvC,WAAO,IAAI,cACV;GAED;GACD,QACC,OAAM,IAAI,OAAO,+BAA+B,WAAW,KAAK;EACjE;CACD;AACD"}