@geekmidas/events 10.0.0-alpha.2 → 10.0.0-alpha.21

package/dist/sqs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["connection: SQSConnection","options: SQSPublisherOptions","connectionString: string","messages: TMessage[]","entries: SendMessageBatchRequestEntry[]","input: SendMessageBatchCommandInput","SendMessageBatchCommand"],"sources":["../../src/sqs/SQSPublisher.ts"],"sourcesContent":["import {\n\tSendMessageBatchCommand,\n\ttype SendMessageBatchCommandInput,\n\ttype SendMessageBatchRequestEntry,\n} from '@aws-sdk/client-sqs';\nimport chunk from 'lodash.chunk';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\n\nexport interface SQSPublisherOptions {\n\tmaxBatchSize?: number; // Default: 10 (SQS limit)\n}\n\nexport class SQSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\treadonly options: Required<SQSPublisherOptions>;\n\n\tconstructor(\n\t\treadonly connection: SQSConnection,\n\t\toptions: SQSPublisherOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tmaxBatchSize: options.maxBatchSize ?? 10, // SQS limit\n\t\t};\n\t}\n\n\t/**\n\t * Create an SQSPublisher from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SQSPublisher<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SQSConnection } = await import('./SQSConnection');\n\t\tconst connection =\n\t\t\tawait SQSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SQSPublisherOptions = {\n\t\t\tmaxBatchSize: params.get('maxBatchSize')\n\t\t\t\t? Number.parseInt(params.get('maxBatchSize')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SQSPublisher<TMessage>(connection, options);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Split messages into batches (SQS limit is 10 messages per batch)\n\t\tconst batches = chunk(messages, this.options.maxBatchSize);\n\n\t\t// Send all batches\n\t\tawait Promise.all(batches.map((batch) => this.sendBatch(batch)));\n\t}\n\n\tprivate async sendBatch(messages: TMessage[]): Promise<void> {\n\t\tconst entries: SendMessageBatchRequestEntry[] = messages.map(\n\t\t\t(message, index) => ({\n\t\t\t\tId: `${index}`,\n\t\t\t\tMessageBody: JSON.stringify({\n\t\t\t\t\ttype: message.type,\n\t\t\t\t\tpayload: message.payload,\n\t\t\t\t}),\n\t\t\t\tMessageAttributes: {\n\t\t\t\t\ttype: {\n\t\t\t\t\t\tDataType: 'String',\n\t\t\t\t\t\tStringValue: message.type,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n\t\tconst input: SendMessageBatchCommandInput = {\n\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\tEntries: entries,\n\t\t};\n\n\t\tconst command = new SendMessageBatchCommand(input);\n\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t// Check for failures\n\t\tif (response.Failed && response.Failed.length > 0) {\n\t\t\tconst errors = response.Failed.map(\n\t\t\t\t(f) => `${f.Id}: ${f.Code} - ${f.Message}`,\n\t\t\t).join(', ');\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to send ${response.Failed.length} messages: ${errors}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n"],"mappings":";;;;;;;;;AAaA,IAAa,eAAb,MAAa,aAEb;CACC,AAAS;CAET,YACUA,YACTC,UAA+B,CAAE,GAChC;EAFQ;AAGT,OAAK,UAAU,EACd,cAAc,QAAQ,gBAAgB,GACtC;CACD;;;;;CAMD,aAAa,qBAEXC,kBAA2D;EAC5D,MAAM,MAAM,IAAI,IAAI;EACpB,MAAM,SAAS,IAAI;EAEnB,MAAM,EAAE,gCAAe,GAAG,2CAAM;EAChC,MAAM,aACL,MAAM,gBAAc,qBAAqB,iBAAiB;EAE3D,MAAMD,UAA+B,EACpC,cAAc,OAAO,IAAI,eAAe,GACrC,OAAO,SAAS,OAAO,IAAI,eAAe,EAAG,GAAG,UAEnD;AAED,SAAO,IAAI,aAAuB,YAAY;CAC9C;CAED,MAAM,QAAQE,UAAqC;AAClD,MAAI,SAAS,WAAW,EAAG;AAE3B,OAAK,KAAK,WAAW,aAAa,CACjC,OAAM,KAAK,WAAW,SAAS;EAIhC,MAAM,UAAU,0BAAM,UAAU,KAAK,QAAQ,aAAa;AAG1D,QAAM,QAAQ,IAAI,QAAQ,IAAI,CAAC,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC;CAChE;CAED,MAAc,UAAUA,UAAqC;EAC5D,MAAMC,UAA0C,SAAS,IACxD,CAAC,SAAS,WAAW;GACpB,KAAK,EAAE,MAAM;GACb,aAAa,KAAK,UAAU;IAC3B,MAAM,QAAQ;IACd,SAAS,QAAQ;GACjB,EAAC;GACF,mBAAmB,EAClB,MAAM;IACL,UAAU;IACV,aAAa,QAAQ;GACrB,EACD;EACD,GACD;EAED,MAAMC,QAAsC;GAC3C,UAAU,KAAK,WAAW;GAC1B,SAAS;EACT;EAED,MAAM,UAAU,IAAIC,6CAAwB;EAC5C,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,KAAK,QAAQ;AAG9D,MAAI,SAAS,UAAU,SAAS,OAAO,SAAS,GAAG;GAClD,MAAM,SAAS,SAAS,OAAO,IAC9B,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,EAAE,QAAQ,EACzC,CAAC,KAAK,KAAK;AACZ,SAAM,IAAI,OACR,iBAAiB,SAAS,OAAO,OAAO,aAAa,OAAO;EAE9D;CACD;CAED,MAAM,QAAuB,CAG5B;AACD"}
+{"version":3,"file":"index.cjs","names":["chunk","SendMessageBatchCommand"],"sources":["../../src/sqs/SQSPublisher.ts"],"sourcesContent":["import {\n\tSendMessageBatchCommand,\n\ttype SendMessageBatchCommandInput,\n\ttype SendMessageBatchRequestEntry,\n} from '@aws-sdk/client-sqs';\nimport chunk from 'lodash.chunk';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\n\nexport interface SQSPublisherOptions {\n\tmaxBatchSize?: number; // Default: 10 (SQS limit)\n}\n\nexport class SQSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\treadonly options: Required<SQSPublisherOptions>;\n\n\tconstructor(\n\t\treadonly connection: SQSConnection,\n\t\toptions: SQSPublisherOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tmaxBatchSize: options.maxBatchSize ?? 10, // SQS limit\n\t\t};\n\t}\n\n\t/**\n\t * Create an SQSPublisher from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SQSPublisher<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SQSConnection } = await import('./SQSConnection');\n\t\tconst connection =\n\t\t\tawait SQSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SQSPublisherOptions = {\n\t\t\tmaxBatchSize: params.get('maxBatchSize')\n\t\t\t\t? Number.parseInt(params.get('maxBatchSize')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SQSPublisher<TMessage>(connection, options);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Split messages into batches (SQS limit is 10 messages per batch)\n\t\tconst batches = chunk(messages, this.options.maxBatchSize);\n\n\t\t// Send all batches\n\t\tawait Promise.all(batches.map((batch) => this.sendBatch(batch)));\n\t}\n\n\tprivate async sendBatch(messages: TMessage[]): Promise<void> {\n\t\tconst entries: SendMessageBatchRequestEntry[] = messages.map(\n\t\t\t(message, index) => ({\n\t\t\t\tId: `${index}`,\n\t\t\t\tMessageBody: JSON.stringify({\n\t\t\t\t\ttype: message.type,\n\t\t\t\t\tpayload: message.payload,\n\t\t\t\t}),\n\t\t\t\tMessageAttributes: {\n\t\t\t\t\ttype: {\n\t\t\t\t\t\tDataType: 'String',\n\t\t\t\t\t\tStringValue: message.type,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n\t\tconst input: SendMessageBatchCommandInput = {\n\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\tEntries: entries,\n\t\t};\n\n\t\tconst command = new SendMessageBatchCommand(input);\n\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t// Check for failures\n\t\tif (response.Failed && response.Failed.length > 0) {\n\t\t\tthrow new SqsBatchPartlyFailed(\n\t\t\t\tresponse.Failed.map((f) => ({\n\t\t\t\t\tid: f.Id,\n\t\t\t\t\tcode: f.Code,\n\t\t\t\t\tmessage: f.Message,\n\t\t\t\t})),\n\t\t\t);\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n\n/** SQS accepted the batch but refused some of its messages; the rest were sent. */\nexport class SqsBatchPartlyFailed extends Error {\n\tconstructor(\n\t\treadonly failed: readonly {\n\t\t\tid?: string;\n\t\t\tcode?: string;\n\t\t\tmessage?: string;\n\t\t}[],\n\t) {\n\t\tsuper(\n\t\t\t`Failed to send ${failed.length} messages: ${failed.map((f) => `${f.id}: ${f.code} - ${f.message}`).join(', ')}. The others in the batch were sent; retry only these.`,\n\t\t);\n\t\tthis.name = 'SqsBatchPartlyFailed';\n\t}\n}\n"],"mappings":";;;;;;;;AAaA,IAAa,eAAb,MAAa,aAEb;CAIW;CAHV;CAEA,YACC,YACA,UAA+B,CAAC,GAC/B;EAFQ,KAAA,aAAA;EAGT,KAAK,UAAU,EACd,cAAc,QAAQ,gBAAgB,GACvC;CACD;;;;;CAMA,aAAa,qBAEX,kBAA2D;EAE5D,MAAM,SAAS,IADC,IAAI,gBACH,CAAC,CAAC;EAEnB,MAAM,EAAE,kBAAkB,MAAA,QAAA,QAAA,CAAA,CAAA,WAAA,QAAM,+BAAA,CAAA,CAAA,CAAA,MAAA,MAAA,EAAA,qBAAA;EAChC,MAAM,aACL,MAAM,cAAc,qBAAqB,gBAAgB;EAE1D,MAAM,UAA+B,EACpC,cAAc,OAAO,IAAI,cAAc,IACpC,OAAO,SAAS,OAAO,IAAI,cAAc,GAAI,EAAE,IAC/C,KAAA,EACJ;EAEA,OAAO,IAAI,aAAuB,YAAY,OAAO;CACtD;CAEA,MAAM,QAAQ,UAAqC;EAClD,IAAI,SAAS,WAAW,GAAG;EAE3B,IAAI,CAAC,KAAK,WAAW,YAAY,GAChC,MAAM,KAAK,WAAW,QAAQ;EAI/B,MAAM,WAAA,GAAUA,aAAAA,QAAAA,CAAM,UAAU,KAAK,QAAQ,YAAY;EAGzD,MAAM,QAAQ,IAAI,QAAQ,KAAK,UAAU,KAAK,UAAU,KAAK,CAAC,CAAC;CAChE;CAEA,MAAc,UAAU,UAAqC;EAC5D,MAAM,UAA0C,SAAS,KACvD,SAAS,WAAW;GACpB,IAAI,GAAG;GACP,aAAa,KAAK,UAAU;IAC3B,MAAM,QAAQ;IACd,SAAS,QAAQ;GAClB,CAAC;GACD,mBAAmB,EAClB,MAAM;IACL,UAAU;IACV,aAAa,QAAQ;GACtB,EACD;EACD,EACD;EAEA,MAAM,QAAsC;GAC3C,UAAU,KAAK,WAAW;GAC1B,SAAS;EACV;EAEA,MAAM,UAAU,IAAIC,oBAAAA,wBAAwB,KAAK;EACjD,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,KAAK,OAAO;EAG7D,IAAI,SAAS,UAAU,SAAS,OAAO,SAAS,GAC/C,MAAM,IAAI,qBACT,SAAS,OAAO,KAAK,OAAO;GAC3B,IAAI,EAAE;GACN,MAAM,EAAE;GACR,SAAS,EAAE;EACZ,EAAE,CACH;CAEF;CAEA,MAAM,QAAuB,CAG7B;AACD;;AAGA,IAAa,uBAAb,cAA0C,MAAM;CAErC;CADV,YACC,QAKC;EACD,MACC,kBAAkB,OAAO,OAAO,aAAa,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,uDAChH;EARS,KAAA,SAAA;EAST,KAAK,OAAO;CACb;AACD"}

package/dist/sqs/index.d.cts

@@ -1,7 +1,6 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-BmixGrOD.cjs";
-import { SqsAddress, sqsUrl_d_exports } from "../sqsUrl-DZDPHxIk.cjs";
+import { i as EventSubscriber, n as EventPublisher, r as EventPublisherType, s as PublishableMessage, t as EventConnection } from "../types-gGaoT8qc.cjs";
+import { SqsAddress, t as sqsUrl_d_exports } from "./sqsUrl.cjs";
 import { SQSClient } from "@aws-sdk/client-sqs";
-
 //#region src/sqs/SQSConnection.d.ts
 interface SQSConnectionConfig {
   queueUrl: string;
@@ -13,7 +12,7 @@ interface SQSConnectionConfig {
     sessionToken?: string;
   };
 }
-declare class SQSConnection implements EventConnection {
+export declare class SQSConnection implements EventConnection {
   readonly config: SQSConnectionConfig;
   readonly type = EventPublisherType.SQS;
   private client;
@@ -36,13 +35,12 @@ declare class SQSConnection implements EventConnection {
    */
   get queueUrl(): string;
 }
-//# sourceMappingURL=SQSConnection.d.ts.map
 //#endregion
 //#region src/sqs/SQSPublisher.d.ts
 interface SQSPublisherOptions {
   maxBatchSize?: number;
 }
-declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+export declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
   readonly connection: SQSConnection;
   readonly options: Required<SQSPublisherOptions>;
   constructor(connection: SQSConnection, options?: SQSPublisherOptions);
@@ -55,7 +53,19 @@ declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> imp
   private sendBatch;
   close(): Promise<void>;
 }
-//# sourceMappingURL=SQSPublisher.d.ts.map
+/** SQS accepted the batch but refused some of its messages; the rest were sent. */
+export declare class SqsBatchPartlyFailed extends Error {
+  readonly failed: readonly {
+    id?: string;
+    code?: string;
+    message?: string;
+  }[];
+  constructor(failed: readonly {
+    id?: string;
+    code?: string;
+    message?: string;
+  }[]);
+}
 //#endregion
 //#region src/sqs/SQSSubscriber.d.ts
 interface SQSSubscriberOptions {
@@ -76,7 +86,7 @@ interface SQSSubscriberOptions {
  * - Filters by message type
  * - Processes the actual message payload
  */
-declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+export declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
   private connection;
   private polling;
   private messageTypes;
@@ -94,8 +104,6 @@ declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> im
   private deleteMessage;
   private sleep;
 }
-//# sourceMappingURL=SQSSubscriber.d.ts.map
-
 //#endregion
-export { SQSConnection, SQSConnectionConfig, SQSPublisher, SQSPublisherOptions, SQSSubscriber, SQSSubscriberOptions, SqsAddress, sqsUrl_d_exports as sqsUrl };
+export { type SQSConnectionConfig, type SQSPublisherOptions, type SQSSubscriberOptions, type SqsAddress, sqsUrl_d_exports as sqsUrl };
 //# sourceMappingURL=index.d.cts.map

package/dist/sqs/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"sourcesContent":[],"mappings":";;;;;UAKiB,mBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAWJ,QAAA,CAAA,EAAA,MAAc;EAAA,WAAA,CAAA,EAAA;IAKG,WAAA,EAAA,MAAA;IAJhB,eAAA,EAAA,MAAA;IAIgB,YAAA,CAAA,EAAA,MAAA;EAAmB,CAAA;;AAgD/B,cArDL,aAAA,YAAyB,eAqDpB,CAAA;EAAO,SAKT,MAAA,EArDc,mBAqDd;EAAO,SAYL,IAAA,GArEJ,kBAAA,CAAA,GAAA;EAqEa,QAtEW,MAAA;EAAe,QAAA,SAAA;sBAKvB;;;ACZ9B;AAIA;EAAyB,OAAA,oBAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ED0BrB,OC1BqB,CD0Bb,aC1Ba,CAAA;EAAA,OAAkB,CAAA,CAAA,EDwDzB,OCxDyB,CAAA,IAAA,CAAA;EAAkB,KAClC,CAAA,CAAA,ED4DX,OC5DW,CAAA,IAAA,CAAA;EAAQ,WAKZ,CAAA,CAAA,EAAA,OAAA;EAAa;;;EAAA,IACzB,SAAA,CAAA,CAAA,EDkEO,SClEP;EAAwB;;;EAae,IAApB,QAAA,CAAA,CAAA,EAAA,MAAA;;;;;UAxBb,mBAAA;;;ADJA,cCQJ,YDRuB,CAAA,iBCQO,kBDRP,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,YCSxB,cDTwB,CCST,QDTS,CAAA,CAAA;EAWvB,SAAA,UAAc,ECGJ,aDHI;EAAA,SAAA,OAAA,ECAR,QDAQ,CCAC,mBDAD,CAAA;EAAA,WAKG,CAAA,UAAA,ECFP,aDEO,EAAA,OAAA,CAAA,ECDnB,mBDCmB;EAAmB;;;;EAkBtC,OA8BO,oBAAA,CAAA,iBCrCC,kBDqCD,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ECpCY,ODoCZ,CCpCoB,YDoCpB,CCpCiC,QDoCjC,CAAA,CAAA;EAAO,OAKT,CAAA,QAAA,ECxBS,QDwBT,EAAA,CAAA,ECxBsB,ODwBtB,CAAA,IAAA,CAAA;EAAO,QAYL,SAAA;EAAS,KAtEW,CAAA,CAAA,ECoFtB,ODpFsB,CAAA,IAAA,CAAA;AAAe;;;;UERpC,oBAAA;;;EFHA,gBAAA,CAAA,EAAA,MAAmB;AAWpC;;;;;;;;;;;AAAqD;;;cEWxC,+BAA+B,4CAChC,gBAAgB;EDnBX,QAAA,UAAA;EAIJ,QAAA,OAAY;EAAA,QAAA,YAAA;EAAA,QAAkB,QAAA;EAAkB,QAClC,OAAA;EAAQ,WAKZ,CAAA,UAAA,ECiBD,aDjBC,EAAA,OAAA,CAAA,ECkBZ,oBDlBY;EAAa,SAHR,CAAA,QAAA,EC+BhB,QD/BgB,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,ECgCN,QDhCM,EAAA,GCgCO,ODhCP,CAAA,IAAA,CAAA,CAAA,ECiCxB,ODjCwB,CAAA,IAAA,CAAA;EAAmB,IAA5B,CAAA,CAAA,EAAA,IAAA;EAAQ,QAGJ,IAAA;EAAa,QACzB,eAAA;EAAwB;;;EAae,QAApB,YAAA;EAAO,QAiBZ,aAAA;EAAQ,QAAK,KAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"mappings":";;;;UAKiB;EAChB;EACA;EACA;EACA;IACC;IACA;IACA;;;qBAIW,yBAAyB;WAKhB,QAAQ;WAJpB,OAAI,mBAAA;UACL;UACA;EAER,YAAqB,QAAQ;;;;;SAgBhB,qBACZ,2BACE,QAAQ;EA8BL,WAAW;EAKX,SAAS;EAKf;;;;MAOI,aAAa;;;;MAOb;;;;UCpFY;EAChB;;qBAGY,aAAa,iBAAiB,4CAC/B,eAAe;WAKhB,YAAY;WAHb,SAAS,SAAS;EAE3B,YACU,YAAY,eACrB,UAAS;;;;;SAWG,qBACZ,iBAAiB,iCAChB,2BAA2B,QAAQ,aAAa;EAiB5C,QAAQ,UAAU,aAAa;UAcvB;EAqCR,SAAS;;;qBAOH,6BAA6B;WAE/B;IACR;IACA;IACA;;EAJF,YACU;IACR;IACA;IACA;;;;;UCzGc;EAChB;EACA;EACA;;;;;;;;;;;;;;;qBAgBY,cAAc,iBAAiB,4CAChC,gBAAgB;UAQlB;UAND;UACA;UACA;UACA;EAER,YACS,YAAY,eACpB,UAAS;EASJ,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;EAYH;UAIc;UAqBA;;;;UAiDN;UAgCM;UAUN"}

package/dist/sqs/index.d.mts

@@ -1,7 +1,6 @@
-import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-DycjsYms.mjs";
-import { SqsAddress, sqsUrl_d_exports } from "../sqsUrl-BV6zS-mi.mjs";
+import { i as EventSubscriber, n as EventPublisher, r as EventPublisherType, s as PublishableMessage, t as EventConnection } from "../types-gGaoT8qc.mjs";
+import { SqsAddress, t as sqsUrl_d_exports } from "./sqsUrl.mjs";
 import { SQSClient } from "@aws-sdk/client-sqs";
-
 //#region src/sqs/SQSConnection.d.ts
 interface SQSConnectionConfig {
   queueUrl: string;
@@ -13,7 +12,7 @@ interface SQSConnectionConfig {
     sessionToken?: string;
   };
 }
-declare class SQSConnection implements EventConnection {
+export declare class SQSConnection implements EventConnection {
   readonly config: SQSConnectionConfig;
   readonly type = EventPublisherType.SQS;
   private client;
@@ -36,13 +35,12 @@ declare class SQSConnection implements EventConnection {
    */
   get queueUrl(): string;
 }
-//# sourceMappingURL=SQSConnection.d.ts.map
 //#endregion
 //#region src/sqs/SQSPublisher.d.ts
 interface SQSPublisherOptions {
   maxBatchSize?: number;
 }
-declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+export declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
   readonly connection: SQSConnection;
   readonly options: Required<SQSPublisherOptions>;
   constructor(connection: SQSConnection, options?: SQSPublisherOptions);
@@ -55,7 +53,19 @@ declare class SQSPublisher<TMessage extends PublishableMessage<string, any>> imp
   private sendBatch;
   close(): Promise<void>;
 }
-//# sourceMappingURL=SQSPublisher.d.ts.map
+/** SQS accepted the batch but refused some of its messages; the rest were sent. */
+export declare class SqsBatchPartlyFailed extends Error {
+  readonly failed: readonly {
+    id?: string;
+    code?: string;
+    message?: string;
+  }[];
+  constructor(failed: readonly {
+    id?: string;
+    code?: string;
+    message?: string;
+  }[]);
+}
 //#endregion
 //#region src/sqs/SQSSubscriber.d.ts
 interface SQSSubscriberOptions {
@@ -76,7 +86,7 @@ interface SQSSubscriberOptions {
  * - Filters by message type
  * - Processes the actual message payload
  */
-declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+export declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
   private connection;
   private polling;
   private messageTypes;
@@ -94,8 +104,6 @@ declare class SQSSubscriber<TMessage extends PublishableMessage<string, any>> im
   private deleteMessage;
   private sleep;
 }
-//# sourceMappingURL=SQSSubscriber.d.ts.map
-
 //#endregion
-export { SQSConnection, SQSConnectionConfig, SQSPublisher, SQSPublisherOptions, SQSSubscriber, SQSSubscriberOptions, SqsAddress, sqsUrl_d_exports as sqsUrl };
+export { type SQSConnectionConfig, type SQSPublisherOptions, type SQSSubscriberOptions, type SqsAddress, sqsUrl_d_exports as sqsUrl };
 //# sourceMappingURL=index.d.mts.map

package/dist/sqs/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"sourcesContent":[],"mappings":";;;;;UAKiB,mBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAWJ,QAAA,CAAA,EAAA,MAAc;EAAA,WAAA,CAAA,EAAA;IAKG,WAAA,EAAA,MAAA;IAJhB,eAAA,EAAA,MAAA;IAIgB,YAAA,CAAA,EAAA,MAAA;EAAmB,CAAA;;AAgD/B,cArDL,aAAA,YAAyB,eAqDpB,CAAA;EAAO,SAKT,MAAA,EArDc,mBAqDd;EAAO,SAYL,IAAA,GArEJ,kBAAA,CAAA,GAAA;EAqEa,QAtEW,MAAA;EAAe,QAAA,SAAA;sBAKvB;;;ACZ9B;AAIA;EAAyB,OAAA,oBAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ED0BrB,OC1BqB,CD0Bb,aC1Ba,CAAA;EAAA,OAAkB,CAAA,CAAA,EDwDzB,OCxDyB,CAAA,IAAA,CAAA;EAAkB,KAClC,CAAA,CAAA,ED4DX,OC5DW,CAAA,IAAA,CAAA;EAAQ,WAKZ,CAAA,CAAA,EAAA,OAAA;EAAa;;;EAAA,IACzB,SAAA,CAAA,CAAA,EDkEO,SClEP;EAAwB;;;EAae,IAApB,QAAA,CAAA,CAAA,EAAA,MAAA;;;;;UAxBb,mBAAA;;;ADJA,cCQJ,YDRuB,CAAA,iBCQO,kBDRP,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,YCSxB,cDTwB,CCST,QDTS,CAAA,CAAA;EAWvB,SAAA,UAAc,ECGJ,aDHI;EAAA,SAAA,OAAA,ECAR,QDAQ,CCAC,mBDAD,CAAA;EAAA,WAKG,CAAA,UAAA,ECFP,aDEO,EAAA,OAAA,CAAA,ECDnB,mBDCmB;EAAmB;;;;EAkBtC,OA8BO,oBAAA,CAAA,iBCrCC,kBDqCD,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ECpCY,ODoCZ,CCpCoB,YDoCpB,CCpCiC,QDoCjC,CAAA,CAAA;EAAO,OAKT,CAAA,QAAA,ECxBS,QDwBT,EAAA,CAAA,ECxBsB,ODwBtB,CAAA,IAAA,CAAA;EAAO,QAYL,SAAA;EAAS,KAtEW,CAAA,CAAA,ECoFtB,ODpFsB,CAAA,IAAA,CAAA;AAAe;;;;UERpC,oBAAA;;;EFHA,gBAAA,CAAA,EAAA,MAAmB;AAWpC;;;;;;;;;;;AAAqD;;;cEWxC,+BAA+B,4CAChC,gBAAgB;EDnBX,QAAA,UAAA;EAIJ,QAAA,OAAY;EAAA,QAAA,YAAA;EAAA,QAAkB,QAAA;EAAkB,QAClC,OAAA;EAAQ,WAKZ,CAAA,UAAA,ECiBD,aDjBC,EAAA,OAAA,CAAA,ECkBZ,oBDlBY;EAAa,SAHR,CAAA,QAAA,EC+BhB,QD/BgB,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,ECgCN,QDhCM,EAAA,GCgCO,ODhCP,CAAA,IAAA,CAAA,CAAA,ECiCxB,ODjCwB,CAAA,IAAA,CAAA;EAAmB,IAA5B,CAAA,CAAA,EAAA,IAAA;EAAQ,QAGJ,IAAA;EAAa,QACzB,eAAA;EAAwB;;;EAae,QAApB,YAAA;EAAO,QAiBZ,aAAA;EAAQ,QAAK,KAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"mappings":";;;;UAKiB;EAChB;EACA;EACA;EACA;IACC;IACA;IACA;;;qBAIW,yBAAyB;WAKhB,QAAQ;WAJpB,OAAI,mBAAA;UACL;UACA;EAER,YAAqB,QAAQ;;;;;SAgBhB,qBACZ,2BACE,QAAQ;EA8BL,WAAW;EAKX,SAAS;EAKf;;;;MAOI,aAAa;;;;MAOb;;;;UCpFY;EAChB;;qBAGY,aAAa,iBAAiB,4CAC/B,eAAe;WAKhB,YAAY;WAHb,SAAS,SAAS;EAE3B,YACU,YAAY,eACrB,UAAS;;;;;SAWG,qBACZ,iBAAiB,iCAChB,2BAA2B,QAAQ,aAAa;EAiB5C,QAAQ,UAAU,aAAa;UAcvB;EAqCR,SAAS;;;qBAOH,6BAA6B;WAE/B;IACR;IACA;IACA;;EAJF,YACU;IACR;IACA;IACA;;;;;UCzGc;EAChB;EACA;EACA;;;;;;;;;;;;;;;qBAgBY,cAAc,iBAAiB,4CAChC,gBAAgB;UAQlB;UAND;UACA;UACA;UACA;EAER,YACS,YAAY,eACpB,UAAS;EASJ,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;EAYH;UAIc;UAqBA;;;;UAiDN;UAgCM;UAUN"}

package/dist/sqs/index.mjs

@@ -1,12 +1,10 @@
-import "../types-CYDt-2RQ.mjs";
-import { sqsUrl_exports } from "../sqsUrl-CbAsBFHI.mjs";
-import { SQSConnection } from "../SQSConnection-4tBMkVZE.mjs";
-import { SQSSubscriber } from "../SQSSubscriber-BMWZ3s5q.mjs";
+import { t as sqsUrl_exports } from "./sqsUrl.mjs";
+import { n as SQSConnection, t as SQSSubscriber } from "../SQSSubscriber-BXLE_1L3.mjs";
 import { SendMessageBatchCommand } from "@aws-sdk/client-sqs";
 import chunk from "lodash.chunk";
-
 //#region src/sqs/SQSPublisher.ts
 var SQSPublisher = class SQSPublisher {
+	connection;
 	options;
 	constructor(connection, options = {}) {
 		this.connection = connection;
@@ -17,10 +15,9 @@ var SQSPublisher = class SQSPublisher {
 	* Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10
 	*/
 	static async fromConnectionString(connectionString) {
-		const url = new URL(connectionString);
-		const params = url.searchParams;
-		const { SQSConnection: SQSConnection$1 } = await import("../SQSConnection-DbavOq8_.mjs");
-		const connection = await SQSConnection$1.fromConnectionString(connectionString);
+		const params = new URL(connectionString).searchParams;
+		const { SQSConnection } = await import("../SQSSubscriber-BXLE_1L3.mjs").then((n) => n.r);
+		const connection = await SQSConnection.fromConnectionString(connectionString);
 		const options = { maxBatchSize: params.get("maxBatchSize") ? Number.parseInt(params.get("maxBatchSize"), 10) : void 0 };
 		return new SQSPublisher(connection, options);
 	}
@@ -48,14 +45,24 @@ var SQSPublisher = class SQSPublisher {
 		};
 		const command = new SendMessageBatchCommand(input);
 		const response = await this.connection.sqsClient.send(command);
-		if (response.Failed && response.Failed.length > 0) {
-			const errors = response.Failed.map((f) => `${f.Id}: ${f.Code} - ${f.Message}`).join(", ");
-			throw new Error(`Failed to send ${response.Failed.length} messages: ${errors}`);
-		}
+		if (response.Failed && response.Failed.length > 0) throw new SqsBatchPartlyFailed(response.Failed.map((f) => ({
+			id: f.Id,
+			code: f.Code,
+			message: f.Message
+		})));
 	}
 	async close() {}
 };
-
+/** SQS accepted the batch but refused some of its messages; the rest were sent. */
+var SqsBatchPartlyFailed = class extends Error {
+	failed;
+	constructor(failed) {
+		super(`Failed to send ${failed.length} messages: ${failed.map((f) => `${f.id}: ${f.code} - ${f.message}`).join(", ")}. The others in the batch were sent; retry only these.`);
+		this.failed = failed;
+		this.name = "SqsBatchPartlyFailed";
+	}
+};
 //#endregion
-export { SQSConnection, SQSPublisher, SQSSubscriber, sqsUrl_exports as sqsUrl };
+export { SQSConnection, SQSPublisher, SQSSubscriber, SqsBatchPartlyFailed, sqsUrl_exports as sqsUrl };
+
 //# sourceMappingURL=index.mjs.map

package/dist/sqs/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["connection: SQSConnection","options: SQSPublisherOptions","connectionString: string","messages: TMessage[]","entries: SendMessageBatchRequestEntry[]","input: SendMessageBatchCommandInput"],"sources":["../../src/sqs/SQSPublisher.ts"],"sourcesContent":["import {\n\tSendMessageBatchCommand,\n\ttype SendMessageBatchCommandInput,\n\ttype SendMessageBatchRequestEntry,\n} from '@aws-sdk/client-sqs';\nimport chunk from 'lodash.chunk';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\n\nexport interface SQSPublisherOptions {\n\tmaxBatchSize?: number; // Default: 10 (SQS limit)\n}\n\nexport class SQSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\treadonly options: Required<SQSPublisherOptions>;\n\n\tconstructor(\n\t\treadonly connection: SQSConnection,\n\t\toptions: SQSPublisherOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tmaxBatchSize: options.maxBatchSize ?? 10, // SQS limit\n\t\t};\n\t}\n\n\t/**\n\t * Create an SQSPublisher from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SQSPublisher<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SQSConnection } = await import('./SQSConnection');\n\t\tconst connection =\n\t\t\tawait SQSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SQSPublisherOptions = {\n\t\t\tmaxBatchSize: params.get('maxBatchSize')\n\t\t\t\t? Number.parseInt(params.get('maxBatchSize')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SQSPublisher<TMessage>(connection, options);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Split messages into batches (SQS limit is 10 messages per batch)\n\t\tconst batches = chunk(messages, this.options.maxBatchSize);\n\n\t\t// Send all batches\n\t\tawait Promise.all(batches.map((batch) => this.sendBatch(batch)));\n\t}\n\n\tprivate async sendBatch(messages: TMessage[]): Promise<void> {\n\t\tconst entries: SendMessageBatchRequestEntry[] = messages.map(\n\t\t\t(message, index) => ({\n\t\t\t\tId: `${index}`,\n\t\t\t\tMessageBody: JSON.stringify({\n\t\t\t\t\ttype: message.type,\n\t\t\t\t\tpayload: message.payload,\n\t\t\t\t}),\n\t\t\t\tMessageAttributes: {\n\t\t\t\t\ttype: {\n\t\t\t\t\t\tDataType: 'String',\n\t\t\t\t\t\tStringValue: message.type,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n\t\tconst input: SendMessageBatchCommandInput = {\n\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\tEntries: entries,\n\t\t};\n\n\t\tconst command = new SendMessageBatchCommand(input);\n\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t// Check for failures\n\t\tif (response.Failed && response.Failed.length > 0) {\n\t\t\tconst errors = response.Failed.map(\n\t\t\t\t(f) => `${f.Id}: ${f.Code} - ${f.Message}`,\n\t\t\t).join(', ');\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to send ${response.Failed.length} messages: ${errors}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n"],"mappings":";;;;;;;;AAaA,IAAa,eAAb,MAAa,aAEb;CACC,AAAS;CAET,YACUA,YACTC,UAA+B,CAAE,GAChC;EAFQ;AAGT,OAAK,UAAU,EACd,cAAc,QAAQ,gBAAgB,GACtC;CACD;;;;;CAMD,aAAa,qBAEXC,kBAA2D;EAC5D,MAAM,MAAM,IAAI,IAAI;EACpB,MAAM,SAAS,IAAI;EAEnB,MAAM,EAAE,gCAAe,GAAG,MAAM,OAAO;EACvC,MAAM,aACL,MAAM,gBAAc,qBAAqB,iBAAiB;EAE3D,MAAMD,UAA+B,EACpC,cAAc,OAAO,IAAI,eAAe,GACrC,OAAO,SAAS,OAAO,IAAI,eAAe,EAAG,GAAG,UAEnD;AAED,SAAO,IAAI,aAAuB,YAAY;CAC9C;CAED,MAAM,QAAQE,UAAqC;AAClD,MAAI,SAAS,WAAW,EAAG;AAE3B,OAAK,KAAK,WAAW,aAAa,CACjC,OAAM,KAAK,WAAW,SAAS;EAIhC,MAAM,UAAU,MAAM,UAAU,KAAK,QAAQ,aAAa;AAG1D,QAAM,QAAQ,IAAI,QAAQ,IAAI,CAAC,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC;CAChE;CAED,MAAc,UAAUA,UAAqC;EAC5D,MAAMC,UAA0C,SAAS,IACxD,CAAC,SAAS,WAAW;GACpB,KAAK,EAAE,MAAM;GACb,aAAa,KAAK,UAAU;IAC3B,MAAM,QAAQ;IACd,SAAS,QAAQ;GACjB,EAAC;GACF,mBAAmB,EAClB,MAAM;IACL,UAAU;IACV,aAAa,QAAQ;GACrB,EACD;EACD,GACD;EAED,MAAMC,QAAsC;GAC3C,UAAU,KAAK,WAAW;GAC1B,SAAS;EACT;EAED,MAAM,UAAU,IAAI,wBAAwB;EAC5C,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,KAAK,QAAQ;AAG9D,MAAI,SAAS,UAAU,SAAS,OAAO,SAAS,GAAG;GAClD,MAAM,SAAS,SAAS,OAAO,IAC9B,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,EAAE,QAAQ,EACzC,CAAC,KAAK,KAAK;AACZ,SAAM,IAAI,OACR,iBAAiB,SAAS,OAAO,OAAO,aAAa,OAAO;EAE9D;CACD;CAED,MAAM,QAAuB,CAG5B;AACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/sqs/SQSPublisher.ts"],"sourcesContent":["import {\n\tSendMessageBatchCommand,\n\ttype SendMessageBatchCommandInput,\n\ttype SendMessageBatchRequestEntry,\n} from '@aws-sdk/client-sqs';\nimport chunk from 'lodash.chunk';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SQSConnection } from './SQSConnection';\n\nexport interface SQSPublisherOptions {\n\tmaxBatchSize?: number; // Default: 10 (SQS limit)\n}\n\nexport class SQSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\treadonly options: Required<SQSPublisherOptions>;\n\n\tconstructor(\n\t\treadonly connection: SQSConnection,\n\t\toptions: SQSPublisherOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tmaxBatchSize: options.maxBatchSize ?? 10, // SQS limit\n\t\t};\n\t}\n\n\t/**\n\t * Create an SQSPublisher from a connection string\n\t * Format: sqs://?queueUrl=https://sqs.region.amazonaws.com/accountId/queueName&region=us-east-1&endpoint=http://localhost:4566&maxBatchSize=10\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SQSPublisher<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SQSConnection } = await import('./SQSConnection');\n\t\tconst connection =\n\t\t\tawait SQSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SQSPublisherOptions = {\n\t\t\tmaxBatchSize: params.get('maxBatchSize')\n\t\t\t\t? Number.parseInt(params.get('maxBatchSize')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SQSPublisher<TMessage>(connection, options);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Split messages into batches (SQS limit is 10 messages per batch)\n\t\tconst batches = chunk(messages, this.options.maxBatchSize);\n\n\t\t// Send all batches\n\t\tawait Promise.all(batches.map((batch) => this.sendBatch(batch)));\n\t}\n\n\tprivate async sendBatch(messages: TMessage[]): Promise<void> {\n\t\tconst entries: SendMessageBatchRequestEntry[] = messages.map(\n\t\t\t(message, index) => ({\n\t\t\t\tId: `${index}`,\n\t\t\t\tMessageBody: JSON.stringify({\n\t\t\t\t\ttype: message.type,\n\t\t\t\t\tpayload: message.payload,\n\t\t\t\t}),\n\t\t\t\tMessageAttributes: {\n\t\t\t\t\ttype: {\n\t\t\t\t\t\tDataType: 'String',\n\t\t\t\t\t\tStringValue: message.type,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n\t\tconst input: SendMessageBatchCommandInput = {\n\t\t\tQueueUrl: this.connection.queueUrl,\n\t\t\tEntries: entries,\n\t\t};\n\n\t\tconst command = new SendMessageBatchCommand(input);\n\t\tconst response = await this.connection.sqsClient.send(command);\n\n\t\t// Check for failures\n\t\tif (response.Failed && response.Failed.length > 0) {\n\t\t\tthrow new SqsBatchPartlyFailed(\n\t\t\t\tresponse.Failed.map((f) => ({\n\t\t\t\t\tid: f.Id,\n\t\t\t\t\tcode: f.Code,\n\t\t\t\t\tmessage: f.Message,\n\t\t\t\t})),\n\t\t\t);\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n\n/** SQS accepted the batch but refused some of its messages; the rest were sent. */\nexport class SqsBatchPartlyFailed extends Error {\n\tconstructor(\n\t\treadonly failed: readonly {\n\t\t\tid?: string;\n\t\t\tcode?: string;\n\t\t\tmessage?: string;\n\t\t}[],\n\t) {\n\t\tsuper(\n\t\t\t`Failed to send ${failed.length} messages: ${failed.map((f) => `${f.id}: ${f.code} - ${f.message}`).join(', ')}. The others in the batch were sent; retry only these.`,\n\t\t);\n\t\tthis.name = 'SqsBatchPartlyFailed';\n\t}\n}\n"],"mappings":";;;;;AAaA,IAAa,eAAb,MAAa,aAEb;CAIW;CAHV;CAEA,YACC,YACA,UAA+B,CAAC,GAC/B;EAFQ,KAAA,aAAA;EAGT,KAAK,UAAU,EACd,cAAc,QAAQ,gBAAgB,GACvC;CACD;;;;;CAMA,aAAa,qBAEX,kBAA2D;EAE5D,MAAM,SAAS,IADC,IAAI,gBACH,CAAC,CAAC;EAEnB,MAAM,EAAE,kBAAkB,MAAM,OAAO,gCAAkB,CAAA,MAAA,MAAA,EAAA,CAAA;EACzD,MAAM,aACL,MAAM,cAAc,qBAAqB,gBAAgB;EAE1D,MAAM,UAA+B,EACpC,cAAc,OAAO,IAAI,cAAc,IACpC,OAAO,SAAS,OAAO,IAAI,cAAc,GAAI,EAAE,IAC/C,KAAA,EACJ;EAEA,OAAO,IAAI,aAAuB,YAAY,OAAO;CACtD;CAEA,MAAM,QAAQ,UAAqC;EAClD,IAAI,SAAS,WAAW,GAAG;EAE3B,IAAI,CAAC,KAAK,WAAW,YAAY,GAChC,MAAM,KAAK,WAAW,QAAQ;EAI/B,MAAM,UAAU,MAAM,UAAU,KAAK,QAAQ,YAAY;EAGzD,MAAM,QAAQ,IAAI,QAAQ,KAAK,UAAU,KAAK,UAAU,KAAK,CAAC,CAAC;CAChE;CAEA,MAAc,UAAU,UAAqC;EAC5D,MAAM,UAA0C,SAAS,KACvD,SAAS,WAAW;GACpB,IAAI,GAAG;GACP,aAAa,KAAK,UAAU;IAC3B,MAAM,QAAQ;IACd,SAAS,QAAQ;GAClB,CAAC;GACD,mBAAmB,EAClB,MAAM;IACL,UAAU;IACV,aAAa,QAAQ;GACtB,EACD;EACD,EACD;EAEA,MAAM,QAAsC;GAC3C,UAAU,KAAK,WAAW;GAC1B,SAAS;EACV;EAEA,MAAM,UAAU,IAAI,wBAAwB,KAAK;EACjD,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,KAAK,OAAO;EAG7D,IAAI,SAAS,UAAU,SAAS,OAAO,SAAS,GAC/C,MAAM,IAAI,qBACT,SAAS,OAAO,KAAK,OAAO;GAC3B,IAAI,EAAE;GACN,MAAM,EAAE;GACR,SAAS,EAAE;EACZ,EAAE,CACH;CAEF;CAEA,MAAM,QAAuB,CAG7B;AACD;;AAGA,IAAa,uBAAb,cAA0C,MAAM;CAErC;CADV,YACC,QAKC;EACD,MACC,kBAAkB,OAAO,OAAO,aAAa,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,uDAChH;EARS,KAAA,SAAA;EAST,KAAK,OAAO;CACb;AACD"}

package/dist/sqs/sqsUrl.cjs

@@ -1,7 +1,93 @@
-const require_sqsUrl = require('../sqsUrl-CdisN3GU.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/sqs/sqsUrl.ts
+var sqsUrl_exports = /* @__PURE__ */ require("../rolldown-runtime-C0BPl7ul.cjs").__exportAll({
+	MalformedQueueUrl: () => MalformedQueueUrl,
+	MissingQueueUrl: () => MissingQueueUrl,
+	UnexpectedQueueScheme: () => UnexpectedQueueScheme,
+	build: () => build,
+	parse: () => parse
+});
+const SCHEME = "sqs:";
+/**
+* Compose an address into a connection string.
+*
+* Credentials never appear. The AWS SDK resolves them from its own chain — an
+* execution role deployed, environment locally — so the string stays safe to log
+* and identical across environments that differ only in who is calling.
+*/
+function build(address) {
+	const { queueUrl, region, endpoint, maxBatchSize } = address;
+	if (!queueUrl) throw new MissingQueueUrl("");
+	const url = new URL(`${SCHEME}//`);
+	url.searchParams.set("queueUrl", queueUrl);
+	if (region) url.searchParams.set("region", region);
+	if (endpoint) url.searchParams.set("endpoint", endpoint);
+	if (maxBatchSize !== void 0) url.searchParams.set("maxBatchSize", String(maxBatchSize));
+	return url.toString();
+}
+/** Parse a connection string back into an address. */
+function parse(connectionString) {
+	let parsed;
+	try {
+		parsed = new URL(connectionString);
+	} catch {
+		throw new MalformedQueueUrl(connectionString);
+	}
+	if (parsed.protocol !== SCHEME) throw new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);
+	const queueUrl = parsed.searchParams.get("queueUrl");
+	if (!queueUrl) throw new MissingQueueUrl(connectionString);
+	const region = parsed.searchParams.get("region") ?? void 0;
+	const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
+	const batch = parsed.searchParams.get("maxBatchSize");
+	return {
+		queueUrl,
+		...region ? { region } : {},
+		...endpoint ? { endpoint } : {},
+		...batch ? { maxBatchSize: Number(batch) } : {}
+	};
+}
+/** The string is not a URL at all. */
+var MalformedQueueUrl = class extends Error {
+	url;
+	constructor(url) {
+		super(`'${url}' is not a valid connection string.`);
+		this.url = url;
+		this.name = "MalformedQueueUrl";
+	}
+};
+/** The string is a URL, but not an `sqs://` one. */
+var UnexpectedQueueScheme = class extends Error {
+	url;
+	expected;
+	actual;
+	constructor(url, expected, actual) {
+		super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
+		this.url = url;
+		this.expected = expected;
+		this.actual = actual;
+		this.name = "UnexpectedQueueScheme";
+	}
+};
+/** An `sqs://` string with no queue names nothing. */
+var MissingQueueUrl = class extends Error {
+	url;
+	constructor(url) {
+		super(url ? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.` : "An sqs:// connection string needs a queueUrl.");
+		this.url = url;
+		this.name = "MissingQueueUrl";
+	}
+};
+//#endregion
+exports.MalformedQueueUrl = MalformedQueueUrl;
+exports.MissingQueueUrl = MissingQueueUrl;
+exports.UnexpectedQueueScheme = UnexpectedQueueScheme;
+exports.build = build;
+exports.parse = parse;
+Object.defineProperty(exports, "sqsUrl_exports", {
+	enumerable: true,
+	get: function() {
+		return sqsUrl_exports;
+	}
+});
 
-exports.MalformedQueueUrl = require_sqsUrl.MalformedQueueUrl;
-exports.MissingQueueUrl = require_sqsUrl.MissingQueueUrl;
-exports.UnexpectedQueueScheme = require_sqsUrl.UnexpectedQueueScheme;
-exports.build = require_sqsUrl.build;
-exports.parse = require_sqsUrl.parse;
+//# sourceMappingURL=sqsUrl.cjs.map

package/dist/sqs/sqsUrl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqsUrl.cjs","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"sourcesContent":["/**\n * The `sqs://` connection-string codec — how a queue is addressed as one string.\n *\n * It lives beside the client rather than in a neutral package because\n * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer\n * knows only that a queue provides *one* connection string; what that string\n * says is between the component that composes it and the publisher that parses\n * it. The `pgboss://` form sits beside its own client and shares nothing here.\n *\n * Both directions live in this module so they cannot drift: `parse(build(x))`\n * is `x`, and the deploy target composing a string it cannot parse back is the\n * failure this shape rules out.\n */\n\n/** What an SQS connection string addresses. */\nexport interface SqsAddress {\n\tqueueUrl: string;\n\t/** Read off the queue, never inherited: a queue may live in another region. */\n\tregion?: string;\n\t/** Set for SQS-compatible backends such as LocalStack. */\n\tendpoint?: string;\n\t/** Largest batch the publisher may send in one call. */\n\tmaxBatchSize?: number;\n}\n\nconst SCHEME = 'sqs:';\n\n/**\n * Compose an address into a connection string.\n *\n * Credentials never appear. The AWS SDK resolves them from its own chain — an\n * execution role deployed, environment locally — so the string stays safe to log\n * and identical across environments that differ only in who is calling.\n */\nexport function build(address: SqsAddress): string {\n\tconst { queueUrl, region, endpoint, maxBatchSize } = address;\n\tif (!queueUrl) throw new MissingQueueUrl('');\n\n\tconst url = new URL(`${SCHEME}//`);\n\turl.searchParams.set('queueUrl', queueUrl);\n\tif (region) url.searchParams.set('region', region);\n\tif (endpoint) url.searchParams.set('endpoint', endpoint);\n\tif (maxBatchSize !== undefined) {\n\t\turl.searchParams.set('maxBatchSize', String(maxBatchSize));\n\t}\n\n\treturn url.toString();\n}\n\n/** Parse a connection string back into an address. */\nexport function parse(connectionString: string): SqsAddress {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(connectionString);\n\t} catch {\n\t\tthrow new MalformedQueueUrl(connectionString);\n\t}\n\n\tif (parsed.protocol !== SCHEME) {\n\t\tthrow new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);\n\t}\n\n\tconst queueUrl = parsed.searchParams.get('queueUrl');\n\tif (!queueUrl) throw new MissingQueueUrl(connectionString);\n\n\tconst region = parsed.searchParams.get('region') ?? undefined;\n\tconst endpoint = parsed.searchParams.get('endpoint') ?? undefined;\n\tconst batch = parsed.searchParams.get('maxBatchSize');\n\n\treturn {\n\t\tqueueUrl,\n\t\t...(region ? { region } : {}),\n\t\t...(endpoint ? { endpoint } : {}),\n\t\t...(batch ? { maxBatchSize: Number(batch) } : {}),\n\t};\n}\n\n/** The string is not a URL at all. */\nexport class MalformedQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(`'${url}' is not a valid connection string.`);\n\t\tthis.name = 'MalformedQueueUrl';\n\t}\n}\n\n/** The string is a URL, but not an `sqs://` one. */\nexport class UnexpectedQueueScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly expected: string,\n\t\treadonly actual: string,\n\t) {\n\t\tsuper(\n\t\t\t`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`,\n\t\t);\n\t\tthis.name = 'UnexpectedQueueScheme';\n\t}\n}\n\n/** An `sqs://` string with no queue names nothing. */\nexport class MissingQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\turl\n\t\t\t\t? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.`\n\t\t\t\t: 'An sqs:// connection string needs a queueUrl.',\n\t\t);\n\t\tthis.name = 'MissingQueueUrl';\n\t}\n}\n"],"mappings":";;;;;;;;;AAyBA,MAAM,SAAS;;;;;;;;AASf,SAAgB,MAAM,SAA6B;CAClD,MAAM,EAAE,UAAU,QAAQ,UAAU,iBAAiB;CACrD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,EAAE;CAE3C,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG;CACjC,IAAI,aAAa,IAAI,YAAY,QAAQ;CACzC,IAAI,QAAQ,IAAI,aAAa,IAAI,UAAU,MAAM;CACjD,IAAI,UAAU,IAAI,aAAa,IAAI,YAAY,QAAQ;CACvD,IAAI,iBAAiB,KAAA,GACpB,IAAI,aAAa,IAAI,gBAAgB,OAAO,YAAY,CAAC;CAG1D,OAAO,IAAI,SAAS;AACrB;;AAGA,SAAgB,MAAM,kBAAsC;CAC3D,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,gBAAgB;CAClC,QAAQ;EACP,MAAM,IAAI,kBAAkB,gBAAgB;CAC7C;CAEA,IAAI,OAAO,aAAa,QACvB,MAAM,IAAI,sBAAsB,kBAAkB,QAAQ,OAAO,QAAQ;CAG1E,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU;CACnD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,gBAAgB;CAEzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,KAAK,KAAA;CACpD,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU,KAAK,KAAA;CACxD,MAAM,QAAQ,OAAO,aAAa,IAAI,cAAc;CAEpD,OAAO;EACN;EACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,GAAI,QAAQ,EAAE,cAAc,OAAO,KAAK,EAAE,IAAI,CAAC;CAChD;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,KAAsB;EACjC,MAAM,IAAI,IAAI,oCAAoC;EAD9B,KAAA,MAAA;EAEpB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,wBAAb,cAA2C,MAAM;CAEtC;CACA;CACA;CAHV,YACC,KACA,UACA,QACC;EACD,MACC,eAAe,SAAS,iCAAiC,OAAO,UAAU,IAAI,GAC/E;EANS,KAAA,MAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,kBAAb,cAAqC,MAAM;CACrB;CAArB,YAAY,KAAsB;EACjC,MACC,MACG,IAAI,IAAI,mEACR,+CACJ;EALoB,KAAA,MAAA;EAMpB,KAAK,OAAO;CACb;AACD"}

package/dist/sqs/sqsUrl.d.cts

@@ -1,2 +1,56 @@
-import { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse } from "../sqsUrl-DZDPHxIk.cjs";
-export { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse };
+declare namespace sqsUrl_d_exports {
+  export { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse };
+}
+/**
+ * The `sqs://` connection-string codec — how a queue is addressed as one string.
+ *
+ * It lives beside the client rather than in a neutral package because
+ * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer
+ * knows only that a queue provides *one* connection string; what that string
+ * says is between the component that composes it and the publisher that parses
+ * it. The `pgboss://` form sits beside its own client and shares nothing here.
+ *
+ * Both directions live in this module so they cannot drift: `parse(build(x))`
+ * is `x`, and the deploy target composing a string it cannot parse back is the
+ * failure this shape rules out.
+ */
+/** What an SQS connection string addresses. */
+export interface SqsAddress {
+  queueUrl: string;
+  /** Read off the queue, never inherited: a queue may live in another region. */
+  region?: string;
+  /** Set for SQS-compatible backends such as LocalStack. */
+  endpoint?: string;
+  /** Largest batch the publisher may send in one call. */
+  maxBatchSize?: number;
+}
+/**
+ * Compose an address into a connection string.
+ *
+ * Credentials never appear. The AWS SDK resolves them from its own chain — an
+ * execution role deployed, environment locally — so the string stays safe to log
+ * and identical across environments that differ only in who is calling.
+ */
+export declare function build(address: SqsAddress): string;
+/** Parse a connection string back into an address. */
+export declare function parse(connectionString: string): SqsAddress;
+/** The string is not a URL at all. */
+export declare class MalformedQueueUrl extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+/** The string is a URL, but not an `sqs://` one. */
+export declare class UnexpectedQueueScheme extends Error {
+  readonly url: string;
+  readonly expected: string;
+  readonly actual: string;
+  constructor(url: string, expected: string, actual: string);
+}
+/** An `sqs://` string with no queue names nothing. */
+export declare class MissingQueueUrl extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+//#endregion
+export { sqsUrl_d_exports as t };
+//# sourceMappingURL=sqsUrl.d.cts.map

package/dist/sqs/sqsUrl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqsUrl.d.cts","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"mappings":";;;;;;;;;;;;;;;;;iBAeiB;EAChB;;EAEA;;EAEA;;EAEA;;;;;;;;;wBAYe,MAAM,SAAS;;wBAgBf,MAAM,2BAA2B;;qBA4BpC,0BAA0B;WACjB;EAArB,YAAqB;;;qBAOT,8BAA8B;WAEhC;WACA;WACA;EAHV,YACU,aACA,kBACA;;;qBAUE,wBAAwB;WACf;EAArB,YAAqB"}

package/dist/sqs/sqsUrl.d.mts

@@ -1,2 +1,56 @@
-import { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse } from "../sqsUrl-BV6zS-mi.mjs";
-export { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse };
+declare namespace sqsUrl_d_exports {
+  export { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse };
+}
+/**
+ * The `sqs://` connection-string codec — how a queue is addressed as one string.
+ *
+ * It lives beside the client rather than in a neutral package because
+ * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer
+ * knows only that a queue provides *one* connection string; what that string
+ * says is between the component that composes it and the publisher that parses
+ * it. The `pgboss://` form sits beside its own client and shares nothing here.
+ *
+ * Both directions live in this module so they cannot drift: `parse(build(x))`
+ * is `x`, and the deploy target composing a string it cannot parse back is the
+ * failure this shape rules out.
+ */
+/** What an SQS connection string addresses. */
+export interface SqsAddress {
+  queueUrl: string;
+  /** Read off the queue, never inherited: a queue may live in another region. */
+  region?: string;
+  /** Set for SQS-compatible backends such as LocalStack. */
+  endpoint?: string;
+  /** Largest batch the publisher may send in one call. */
+  maxBatchSize?: number;
+}
+/**
+ * Compose an address into a connection string.
+ *
+ * Credentials never appear. The AWS SDK resolves them from its own chain — an
+ * execution role deployed, environment locally — so the string stays safe to log
+ * and identical across environments that differ only in who is calling.
+ */
+export declare function build(address: SqsAddress): string;
+/** Parse a connection string back into an address. */
+export declare function parse(connectionString: string): SqsAddress;
+/** The string is not a URL at all. */
+export declare class MalformedQueueUrl extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+/** The string is a URL, but not an `sqs://` one. */
+export declare class UnexpectedQueueScheme extends Error {
+  readonly url: string;
+  readonly expected: string;
+  readonly actual: string;
+  constructor(url: string, expected: string, actual: string);
+}
+/** An `sqs://` string with no queue names nothing. */
+export declare class MissingQueueUrl extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+//#endregion
+export { sqsUrl_d_exports as t };
+//# sourceMappingURL=sqsUrl.d.mts.map

package/dist/sqs/sqsUrl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqsUrl.d.mts","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"mappings":";;;;;;;;;;;;;;;;;iBAeiB;EAChB;;EAEA;;EAEA;;EAEA;;;;;;;;;wBAYe,MAAM,SAAS;;wBAgBf,MAAM,2BAA2B;;qBA4BpC,0BAA0B;WACjB;EAArB,YAAqB;;;qBAOT,8BAA8B;WAEhC;WACA;WACA;EAHV,YACU,aACA,kBACA;;;qBAUE,wBAAwB;WACf;EAArB,YAAqB"}

package/dist/sqs/sqsUrl.mjs

@@ -1,3 +1,83 @@
-import { MalformedQueueUrl, MissingQueueUrl, UnexpectedQueueScheme, build, parse } from "../sqsUrl-CbAsBFHI.mjs";
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+//#region src/sqs/sqsUrl.ts
+var sqsUrl_exports = /* @__PURE__ */ __exportAll({
+	MalformedQueueUrl: () => MalformedQueueUrl,
+	MissingQueueUrl: () => MissingQueueUrl,
+	UnexpectedQueueScheme: () => UnexpectedQueueScheme,
+	build: () => build,
+	parse: () => parse
+});
+const SCHEME = "sqs:";
+/**
+* Compose an address into a connection string.
+*
+* Credentials never appear. The AWS SDK resolves them from its own chain — an
+* execution role deployed, environment locally — so the string stays safe to log
+* and identical across environments that differ only in who is calling.
+*/
+function build(address) {
+	const { queueUrl, region, endpoint, maxBatchSize } = address;
+	if (!queueUrl) throw new MissingQueueUrl("");
+	const url = new URL(`${SCHEME}//`);
+	url.searchParams.set("queueUrl", queueUrl);
+	if (region) url.searchParams.set("region", region);
+	if (endpoint) url.searchParams.set("endpoint", endpoint);
+	if (maxBatchSize !== void 0) url.searchParams.set("maxBatchSize", String(maxBatchSize));
+	return url.toString();
+}
+/** Parse a connection string back into an address. */
+function parse(connectionString) {
+	let parsed;
+	try {
+		parsed = new URL(connectionString);
+	} catch {
+		throw new MalformedQueueUrl(connectionString);
+	}
+	if (parsed.protocol !== SCHEME) throw new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);
+	const queueUrl = parsed.searchParams.get("queueUrl");
+	if (!queueUrl) throw new MissingQueueUrl(connectionString);
+	const region = parsed.searchParams.get("region") ?? void 0;
+	const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
+	const batch = parsed.searchParams.get("maxBatchSize");
+	return {
+		queueUrl,
+		...region ? { region } : {},
+		...endpoint ? { endpoint } : {},
+		...batch ? { maxBatchSize: Number(batch) } : {}
+	};
+}
+/** The string is not a URL at all. */
+var MalformedQueueUrl = class extends Error {
+	url;
+	constructor(url) {
+		super(`'${url}' is not a valid connection string.`);
+		this.url = url;
+		this.name = "MalformedQueueUrl";
+	}
+};
+/** The string is a URL, but not an `sqs://` one. */
+var UnexpectedQueueScheme = class extends Error {
+	url;
+	expected;
+	actual;
+	constructor(url, expected, actual) {
+		super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
+		this.url = url;
+		this.expected = expected;
+		this.actual = actual;
+		this.name = "UnexpectedQueueScheme";
+	}
+};
+/** An `sqs://` string with no queue names nothing. */
+var MissingQueueUrl = class extends Error {
+	url;
+	constructor(url) {
+		super(url ? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.` : "An sqs:// connection string needs a queueUrl.");
+		this.url = url;
+		this.name = "MissingQueueUrl";
+	}
+};
+//#endregion
+export { MalformedQueueUrl, MissingQueueUrl, UnexpectedQueueScheme, build, parse, sqsUrl_exports as t };
 
-export { MalformedQueueUrl, MissingQueueUrl, UnexpectedQueueScheme, build, parse };
+//# sourceMappingURL=sqsUrl.mjs.map

package/dist/sqs/sqsUrl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqsUrl.mjs","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"sourcesContent":["/**\n * The `sqs://` connection-string codec — how a queue is addressed as one string.\n *\n * It lives beside the client rather than in a neutral package because\n * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer\n * knows only that a queue provides *one* connection string; what that string\n * says is between the component that composes it and the publisher that parses\n * it. The `pgboss://` form sits beside its own client and shares nothing here.\n *\n * Both directions live in this module so they cannot drift: `parse(build(x))`\n * is `x`, and the deploy target composing a string it cannot parse back is the\n * failure this shape rules out.\n */\n\n/** What an SQS connection string addresses. */\nexport interface SqsAddress {\n\tqueueUrl: string;\n\t/** Read off the queue, never inherited: a queue may live in another region. */\n\tregion?: string;\n\t/** Set for SQS-compatible backends such as LocalStack. */\n\tendpoint?: string;\n\t/** Largest batch the publisher may send in one call. */\n\tmaxBatchSize?: number;\n}\n\nconst SCHEME = 'sqs:';\n\n/**\n * Compose an address into a connection string.\n *\n * Credentials never appear. The AWS SDK resolves them from its own chain — an\n * execution role deployed, environment locally — so the string stays safe to log\n * and identical across environments that differ only in who is calling.\n */\nexport function build(address: SqsAddress): string {\n\tconst { queueUrl, region, endpoint, maxBatchSize } = address;\n\tif (!queueUrl) throw new MissingQueueUrl('');\n\n\tconst url = new URL(`${SCHEME}//`);\n\turl.searchParams.set('queueUrl', queueUrl);\n\tif (region) url.searchParams.set('region', region);\n\tif (endpoint) url.searchParams.set('endpoint', endpoint);\n\tif (maxBatchSize !== undefined) {\n\t\turl.searchParams.set('maxBatchSize', String(maxBatchSize));\n\t}\n\n\treturn url.toString();\n}\n\n/** Parse a connection string back into an address. */\nexport function parse(connectionString: string): SqsAddress {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(connectionString);\n\t} catch {\n\t\tthrow new MalformedQueueUrl(connectionString);\n\t}\n\n\tif (parsed.protocol !== SCHEME) {\n\t\tthrow new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);\n\t}\n\n\tconst queueUrl = parsed.searchParams.get('queueUrl');\n\tif (!queueUrl) throw new MissingQueueUrl(connectionString);\n\n\tconst region = parsed.searchParams.get('region') ?? undefined;\n\tconst endpoint = parsed.searchParams.get('endpoint') ?? undefined;\n\tconst batch = parsed.searchParams.get('maxBatchSize');\n\n\treturn {\n\t\tqueueUrl,\n\t\t...(region ? { region } : {}),\n\t\t...(endpoint ? { endpoint } : {}),\n\t\t...(batch ? { maxBatchSize: Number(batch) } : {}),\n\t};\n}\n\n/** The string is not a URL at all. */\nexport class MalformedQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(`'${url}' is not a valid connection string.`);\n\t\tthis.name = 'MalformedQueueUrl';\n\t}\n}\n\n/** The string is a URL, but not an `sqs://` one. */\nexport class UnexpectedQueueScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly expected: string,\n\t\treadonly actual: string,\n\t) {\n\t\tsuper(\n\t\t\t`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`,\n\t\t);\n\t\tthis.name = 'UnexpectedQueueScheme';\n\t}\n}\n\n/** An `sqs://` string with no queue names nothing. */\nexport class MissingQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\turl\n\t\t\t\t? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.`\n\t\t\t\t: 'An sqs:// connection string needs a queueUrl.',\n\t\t);\n\t\tthis.name = 'MissingQueueUrl';\n\t}\n}\n"],"mappings":";;;;;;;;;AAyBA,MAAM,SAAS;;;;;;;;AASf,SAAgB,MAAM,SAA6B;CAClD,MAAM,EAAE,UAAU,QAAQ,UAAU,iBAAiB;CACrD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,EAAE;CAE3C,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG;CACjC,IAAI,aAAa,IAAI,YAAY,QAAQ;CACzC,IAAI,QAAQ,IAAI,aAAa,IAAI,UAAU,MAAM;CACjD,IAAI,UAAU,IAAI,aAAa,IAAI,YAAY,QAAQ;CACvD,IAAI,iBAAiB,KAAA,GACpB,IAAI,aAAa,IAAI,gBAAgB,OAAO,YAAY,CAAC;CAG1D,OAAO,IAAI,SAAS;AACrB;;AAGA,SAAgB,MAAM,kBAAsC;CAC3D,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,gBAAgB;CAClC,QAAQ;EACP,MAAM,IAAI,kBAAkB,gBAAgB;CAC7C;CAEA,IAAI,OAAO,aAAa,QACvB,MAAM,IAAI,sBAAsB,kBAAkB,QAAQ,OAAO,QAAQ;CAG1E,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU;CACnD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,gBAAgB;CAEzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,KAAK,KAAA;CACpD,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU,KAAK,KAAA;CACxD,MAAM,QAAQ,OAAO,aAAa,IAAI,cAAc;CAEpD,OAAO;EACN;EACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,GAAI,QAAQ,EAAE,cAAc,OAAO,KAAK,EAAE,IAAI,CAAC;CAChD;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,KAAsB;EACjC,MAAM,IAAI,IAAI,oCAAoC;EAD9B,KAAA,MAAA;EAEpB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,wBAAb,cAA2C,MAAM;CAEtC;CACA;CACA;CAHV,YACC,KACA,UACA,QACC;EACD,MACC,eAAe,SAAS,iCAAiC,OAAO,UAAU,IAAI,GAC/E;EANS,KAAA,MAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,kBAAb,cAAqC,MAAM;CACrB;CAArB,YAAY,KAAsB;EACjC,MACC,MACG,IAAI,IAAI,mEACR,+CACJ;EALoB,KAAA,MAAA;EAMpB,KAAK,OAAO;CACb;AACD"}