@amqp-contract/client 0.14.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/dist/index.cjs +1 -0
  2. package/dist/index.d.cts +52 -9
  3. package/dist/index.d.cts.map +1 -1
  4. package/dist/index.d.mts +52 -9
  5. package/dist/index.d.mts.map +1 -1
  6. package/dist/index.mjs.map +1 -1
  7. package/docs/index.md +24 -24
  8. package/package.json +9 -9
package/dist/index.cjs CHANGED
@@ -1,3 +1,4 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
1
2
  let _amqp_contract_core = require("@amqp-contract/core");
2
3
  let _swan_io_boxed = require("@swan-io/boxed");
3
4
  let node_zlib = require("node:zlib");
package/dist/index.d.cts CHANGED
@@ -1,10 +1,53 @@
1
1
  import { Logger, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
2
- import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
3
- import { CompressionAlgorithm, ContractDefinitionInput, InferPublisherNames, PublisherEntry } from "@amqp-contract/contract";
2
+ import * as amqp from "amqplib";
3
+ import { Options } from "amqplib";
4
+ import { TcpSocketConnectOpts } from "net";
5
+ import { ConnectionOptions } from "tls";
6
+ import { CompressionAlgorithm, ContractDefinition, InferPublisherNames, PublisherEntry } from "@amqp-contract/contract";
4
7
  import { Future, Result } from "@swan-io/boxed";
5
8
  import { StandardSchemaV1 } from "@standard-schema/spec";
6
- import { Options } from "amqplib";
7
9
 
10
+ //#region ../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts
11
+ type ConnectionUrl = string | amqp.Options.Connect | {
12
+ url: string;
13
+ connectionOptions?: AmqpConnectionOptions;
14
+ };
15
+ type AmqpConnectionOptions = (ConnectionOptions | TcpSocketConnectOpts) & {
16
+ noDelay?: boolean;
17
+ timeout?: number;
18
+ keepAlive?: boolean;
19
+ keepAliveDelay?: number;
20
+ clientProperties?: any;
21
+ credentials?: {
22
+ mechanism: string;
23
+ username: string;
24
+ password: string;
25
+ response: () => Buffer;
26
+ } | {
27
+ mechanism: string;
28
+ response: () => Buffer;
29
+ } | undefined;
30
+ };
31
+ interface AmqpConnectionManagerOptions {
32
+ /** Interval to send heartbeats to broker. Defaults to 5 seconds. */
33
+ heartbeatIntervalInSeconds?: number;
34
+ /**
35
+ * The time to wait before trying to reconnect. If not specified, defaults
36
+ * to `heartbeatIntervalInSeconds`.
37
+ */
38
+ reconnectTimeInSeconds?: number | undefined;
39
+ /**
40
+ * `findServers` is a function that which returns one or more servers to
41
+ * connect to. This should return either a single URL or an array of URLs.
42
+ * This is handy when you're using a service discovery mechanism such as
43
+ * Consul or etcd. Instead of taking a callback, this can also return a
44
+ * Promise. Note that if this is supplied, then `urls` is ignored.
45
+ */
46
+ findServers?: ((callback: (urls: ConnectionUrl | ConnectionUrl[]) => void) => void) | (() => Promise<ConnectionUrl | ConnectionUrl[]>) | undefined;
47
+ /** Connection options, passed as options to the amqplib.connect() method. */
48
+ connectionOptions?: AmqpConnectionOptions;
49
+ }
50
+ //#endregion
8
51
  //#region src/types.d.ts
9
52
  /**
10
53
  * Infer the TypeScript type from a schema
@@ -23,15 +66,15 @@ type PublisherInferInput<TPublisher extends PublisherEntry> = TPublisher extends
23
66
  /**
24
67
  * Infer all publishers from contract
25
68
  */
26
- type InferPublishers<TContract extends ContractDefinitionInput> = NonNullable<TContract["publishers"]>;
69
+ type InferPublishers<TContract extends ContractDefinition> = NonNullable<TContract["publishers"]>;
27
70
  /**
28
71
  * Get specific publisher definition from contract
29
72
  */
30
- type InferPublisher<TContract extends ContractDefinitionInput, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
73
+ type InferPublisher<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
31
74
  /**
32
75
  * Infer publisher input type (message payload) for a specific publisher in a contract
33
76
  */
34
- type ClientInferPublisherInput<TContract extends ContractDefinitionInput, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
77
+ type ClientInferPublisherInput<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
35
78
  //#endregion
36
79
  //#region src/errors.d.ts
37
80
  /**
@@ -58,7 +101,7 @@ type PublishOptions = Options.Publish & {
58
101
  /**
59
102
  * Options for creating a client
60
103
  */
61
- type CreateClientOptions<TContract extends ContractDefinitionInput> = {
104
+ type CreateClientOptions<TContract extends ContractDefinition> = {
62
105
  contract: TContract;
63
106
  urls: ConnectionUrl[];
64
107
  connectionOptions?: AmqpConnectionManagerOptions | undefined;
@@ -73,7 +116,7 @@ type CreateClientOptions<TContract extends ContractDefinitionInput> = {
73
116
  /**
74
117
  * Type-safe AMQP client for publishing messages
75
118
  */
76
- declare class TypedAmqpClient<TContract extends ContractDefinitionInput> {
119
+ declare class TypedAmqpClient<TContract extends ContractDefinition> {
77
120
  private readonly contract;
78
121
  private readonly amqpClient;
79
122
  private readonly logger?;
@@ -89,7 +132,7 @@ declare class TypedAmqpClient<TContract extends ContractDefinitionInput> {
89
132
  * Connections are automatically shared across clients with the same URLs and
90
133
  * connection options, following RabbitMQ best practices.
91
134
  */
92
- static create<TContract extends ContractDefinitionInput>({
135
+ static create<TContract extends ContractDefinition>({
93
136
  contract,
94
137
  urls,
95
138
  connectionOptions,
package/dist/index.d.cts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAUK,iCAAiC,oBACpC,gBAAgB;;;AAN4C;;;KAazD,mBAPa,CAAA,mBAO0B,cAP1B,CAAA,GAO4C,UAP5C,SAAA;EAAgB,OAAA,EAAA;IAO7B,OAAA,EACiB,gBADE;EAAoB,CAAA;CAAkB,GAG1D,gBAH0D,CAGzC,UAHyC,CAAA,SAAA,CAAA,CAAA,SAAA,CAAA,CAAA,GAAA,KAAA;;;;KASzD,eANe,CAAA,kBAMmB,uBANnB,CAAA,GAM8C,WAN9C,CAOlB,SAPkB,CAAA,YAAA,CAAA,CAAA;AAAA;;;KAaf,cAP6D,CAAA,kBAQ9C,uBAR8C,EAAA,cASlD,mBATkD,CAS9B,SAT8B,CAAA,CAAA,GAU9D,eAV8D,CAU9C,SAV8C,CAAA,CAUnC,KAVmC,CAAA;;AAAW;;AASzC,KAMxB,yBANwB,CAAA,kBAOhB,uBAPgB,EAAA,cAQpB,mBARoB,CAQA,SARA,CAAA,CAAA,GAShC,mBATgC,CASZ,cATY,CASG,SATH,EASc,KATd,CAAA,CAAA;;;;;;cCjCvB,sBAAA,SAA+B,KAAA;;;;;;;;ADEkB;;AAM5D,KEeU,cAAA,GAAiB,OAAA,CAAQ,OFfnC,GAAA;EAAgB;;AAAgB;;;EAQZ,WAAA,CAAA,EEaN,oBFbM,GAAA,SAAA;CAED;;;AAAD;AAMmB,KEW3B,mBFX2B,CAAA,kBEWW,uBFXX,CAAA,GAAA;EACrC,QAAA,EEWU,SFXV;EADgE,IAAA,EEa1D,aFb0D,EAAA;EAAW,iBAAA,CAAA,EEcvD,4BFduD,GAAA,SAAA;EAOxE,MAAA,CAAA,EEQM,MFRN,GAAc,SAAA;EACC;;;;;EAEW,SAAA,CAAA,EEWjB,iBFXiB,GAAA,SAAA;CAAK;AAKpC;;;AAEgB,cEUH,eFVG,CAAA,kBEU+B,uBFV/B,CAAA,CAAA;EACuB,iBAAA,QAAA;EAAW,iBAAA,UAAA;EAA1B,iBAAA,MAAA;EAApB,iBAAA,SAAA;EAAmB,QAAA,WAAA,CAAA;;;;AC1CvB;;;;ACuBA;AAYA;;EACY,OAAA,MAAA,CAAA,kBAiCsB,uBAjCtB,CAAA,CAAA;IAAA,QAAA;IAAA,IAAA;IAAA,iBAAA;IAAA,MAAA;IAAA;EAAA,CAAA,EAuCP,mBAvCO,CAuCa,SAvCb,CAAA,CAAA,EAuC0B,MAvC1B,CAuCiC,MAvCjC,CAuCwC,eAvCxC,CAuCwD,SAvCxD,CAAA,EAuCoE,cAvCpE,CAAA,CAAA;EACJ;;;;;AAcR;;;;;;;;;EAwBK;;;;EAAwC,OAAA,CAAA,cA6BrB,mBA7BqB,CA6BD,SA7BC,CAAA,CAAA,CAAA,aAAA,EA8B1B,KA9B0B,EAAA,OAAA,EA+BhC,yBA/BgC,CA+BN,SA/BM,EA+BK,KA/BL,CAAA,EAAA,OAAA,CAAA,EAgC/B,cAhC+B,CAAA,EAiCxC,MAjCwC,CAiCjC,MAjCiC,CAAA,IAAA,EAiCpB,cAjCoB,GAiCH,sBAjCG,CAAA,CAAA;EAAP;;;EA8BnB,KAAA,CAAA,CAAA,EA6FR,MA7FQ,CA6FD,MA7FC,CAAA,IAAA,EA6FY,cA7FZ,CAAA,CAAA;EACoB,QAAA,sBAAA"}
1
+ {"version":3,"file":"index.d.cts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/types.ts","../src/errors.ts","../src/client.ts"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;KAKYM,aAAAA,YAAyBN,IAAAA,CAAKO,OAAAA,CAAQC,OAAAA;EAC9CE,GAAAA;EACAC,iBAAAA,GAAoBF,qBAAAA;AAAAA;AAAAA,KAcZA,qBAAAA,IAAyBN,iBAAAA,GAAoBD,oBAAAA;EACrDkB,OAAAA;EACAC,OAAAA;EACAC,SAAAA;EACAC,cAAAA;EACAC,gBAAAA;EACAC,WAAAA;IACIC,SAAAA;IACAC,QAAAA;IACAC,QAAAA;IACAC,QAAAA,QAAgBV,MAAAA;EAAAA;IAEhBO,SAAAA;IACAG,QAAAA,QAAgBV,MAAAA;EAAAA;AAAAA;AAAAA,UAGPW,4BAAAA;EAVbL;EAYAO,0BAAAA;EAVIL;;;;EAeJM,sBAAAA;EAVIJ;;;;AAGR;;;EAeIK,WAAAA,KAAgBE,QAAAA,GAAWD,IAAAA,EAAM7B,aAAAA,GAAgBA,aAAAA,+BAA4CyB,OAAAA,CAAQzB,aAAAA,GAAgBA,aAAAA;EAApEA;EAEjDK,iBAAAA,GAAoBF,qBAAAA;AAAAA;;;;;;KC5CnB,gBAAA,iBAAiC,gBAAA,IACpC,OAAA,SAAgB,gBAAA,iBAAiC,MAAA;;;;;ADNnD;KCaK,mBAAA,oBAAuC,cAAA,IAAkB,UAAA;EAC5D,OAAA;IAAW,OAAA,EAAS,gBAAA;EAAA;AAAA,IAElB,gBAAA,CAAiB,UAAA;;;;KAMhB,eAAA,mBAAkC,kBAAA,IAAsB,WAAA,CAAY,SAAA;;;ADNzE;KCWK,cAAA,mBACe,kBAAA,gBACJ,mBAAA,CAAoB,SAAA,KAChC,eAAA,CAAgB,SAAA,EAAW,KAAA;;;;KAKnB,yBAAA,mBACQ,kBAAA,gBACJ,mBAAA,CAAoB,SAAA,KAChC,mBAAA,CAAoB,cAAA,CAAe,SAAA,EAAW,KAAA;;;;;;cCxCrC,sBAAA,SAA+B,KAAA;EAAA,SAExB,aAAA;EAAA,SACA,MAAA;cADA,aAAA,UACA,MAAA;AAAA;;;;;;KCoBR,cAAA,GAAiB,OAAA,CAAQ,OAAA;EHrBZ;;;;;EG2BvB,WAAA,GAAc,oBAAA;AAAA;;;;KAMJ,mBAAA,mBAAsC,kBAAA;EAChD,QAAA,EAAU,SAAA;EACV,IAAA,EAAM,aAAA;EACN,iBAAA,GAAoB,4BAAA;EACpB,MAAA,GAAS,MAAA;EHrB8CP;;;;;EG2BvD,SAAA,GAAY,iBAAA;AAAA;;;;cAMD,eAAA,mBAAkC,kBAAA;EAAA,iBAE1B,QAAA;EAAA,iBACA,UAAA;EAAA,iBACA,MAAA;EAAA,iBACA,SAAA;EAAA,QAJZ,WAAA,CAAA;EHxBD2B;;;;;;;AAMR;;;EANQA,OGyCC,MAAA,mBAAyB,kBAAA,CAAA,CAAA;IAC9B,QAAA;IACA,IAAA;IACA,iBAAA;IACA,MAAA;IACA;EAAA,GACC,mBAAA,CAAoB,SAAA,IAAa,MAAA,CAAO,MAAA,CAAO,eAAA,CAAgB,SAAA,GAAY,cAAA;EH1B3BvB;;;;;;;;;;;;;;EAA4CyB;;;;EGuD/F,OAAA,eAAsB,mBAAA,CAAoB,SAAA,EAAA,CACxC,aAAA,EAAe,KAAA,EACf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,KAAA,GAC9C,OAAA,GAAU,cAAA,GACT,MAAA,CAAO,MAAA,OAAa,cAAA,GAAiB,sBAAA;EHzDG;;;EGmJ3C,KAAA,CAAA,GAAS,MAAA,CAAO,MAAA,OAAa,cAAA;EAAA,QAIrB,sBAAA;AAAA"}
package/dist/index.d.mts CHANGED
@@ -1,10 +1,53 @@
1
1
  import { Logger, TechnicalError, TelemetryProvider } from "@amqp-contract/core";
2
2
  import { Future, Result } from "@swan-io/boxed";
3
- import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
4
- import { CompressionAlgorithm, ContractDefinitionInput, InferPublisherNames, PublisherEntry } from "@amqp-contract/contract";
5
- import { StandardSchemaV1 } from "@standard-schema/spec";
3
+ import * as amqp from "amqplib";
6
4
  import { Options } from "amqplib";
5
+ import { TcpSocketConnectOpts } from "net";
6
+ import { ConnectionOptions } from "tls";
7
+ import { CompressionAlgorithm, ContractDefinition, InferPublisherNames, PublisherEntry } from "@amqp-contract/contract";
8
+ import { StandardSchemaV1 } from "@standard-schema/spec";
7
9
 
10
+ //#region ../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts
11
+ type ConnectionUrl = string | amqp.Options.Connect | {
12
+ url: string;
13
+ connectionOptions?: AmqpConnectionOptions;
14
+ };
15
+ type AmqpConnectionOptions = (ConnectionOptions | TcpSocketConnectOpts) & {
16
+ noDelay?: boolean;
17
+ timeout?: number;
18
+ keepAlive?: boolean;
19
+ keepAliveDelay?: number;
20
+ clientProperties?: any;
21
+ credentials?: {
22
+ mechanism: string;
23
+ username: string;
24
+ password: string;
25
+ response: () => Buffer;
26
+ } | {
27
+ mechanism: string;
28
+ response: () => Buffer;
29
+ } | undefined;
30
+ };
31
+ interface AmqpConnectionManagerOptions {
32
+ /** Interval to send heartbeats to broker. Defaults to 5 seconds. */
33
+ heartbeatIntervalInSeconds?: number;
34
+ /**
35
+ * The time to wait before trying to reconnect. If not specified, defaults
36
+ * to `heartbeatIntervalInSeconds`.
37
+ */
38
+ reconnectTimeInSeconds?: number | undefined;
39
+ /**
40
+ * `findServers` is a function that which returns one or more servers to
41
+ * connect to. This should return either a single URL or an array of URLs.
42
+ * This is handy when you're using a service discovery mechanism such as
43
+ * Consul or etcd. Instead of taking a callback, this can also return a
44
+ * Promise. Note that if this is supplied, then `urls` is ignored.
45
+ */
46
+ findServers?: ((callback: (urls: ConnectionUrl | ConnectionUrl[]) => void) => void) | (() => Promise<ConnectionUrl | ConnectionUrl[]>) | undefined;
47
+ /** Connection options, passed as options to the amqplib.connect() method. */
48
+ connectionOptions?: AmqpConnectionOptions;
49
+ }
50
+ //#endregion
8
51
  //#region src/types.d.ts
9
52
  /**
10
53
  * Infer the TypeScript type from a schema
@@ -23,15 +66,15 @@ type PublisherInferInput<TPublisher extends PublisherEntry> = TPublisher extends
23
66
  /**
24
67
  * Infer all publishers from contract
25
68
  */
26
- type InferPublishers<TContract extends ContractDefinitionInput> = NonNullable<TContract["publishers"]>;
69
+ type InferPublishers<TContract extends ContractDefinition> = NonNullable<TContract["publishers"]>;
27
70
  /**
28
71
  * Get specific publisher definition from contract
29
72
  */
30
- type InferPublisher<TContract extends ContractDefinitionInput, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
73
+ type InferPublisher<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
31
74
  /**
32
75
  * Infer publisher input type (message payload) for a specific publisher in a contract
33
76
  */
34
- type ClientInferPublisherInput<TContract extends ContractDefinitionInput, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
77
+ type ClientInferPublisherInput<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
35
78
  //#endregion
36
79
  //#region src/errors.d.ts
37
80
  /**
@@ -58,7 +101,7 @@ type PublishOptions = Options.Publish & {
58
101
  /**
59
102
  * Options for creating a client
60
103
  */
61
- type CreateClientOptions<TContract extends ContractDefinitionInput> = {
104
+ type CreateClientOptions<TContract extends ContractDefinition> = {
62
105
  contract: TContract;
63
106
  urls: ConnectionUrl[];
64
107
  connectionOptions?: AmqpConnectionManagerOptions | undefined;
@@ -73,7 +116,7 @@ type CreateClientOptions<TContract extends ContractDefinitionInput> = {
73
116
  /**
74
117
  * Type-safe AMQP client for publishing messages
75
118
  */
76
- declare class TypedAmqpClient<TContract extends ContractDefinitionInput> {
119
+ declare class TypedAmqpClient<TContract extends ContractDefinition> {
77
120
  private readonly contract;
78
121
  private readonly amqpClient;
79
122
  private readonly logger?;
@@ -89,7 +132,7 @@ declare class TypedAmqpClient<TContract extends ContractDefinitionInput> {
89
132
  * Connections are automatically shared across clients with the same URLs and
90
133
  * connection options, following RabbitMQ best practices.
91
134
  */
92
- static create<TContract extends ContractDefinitionInput>({
135
+ static create<TContract extends ContractDefinition>({
93
136
  contract,
94
137
  urls,
95
138
  connectionOptions,
package/dist/index.d.mts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAUK,iCAAiC,oBACpC,gBAAgB;;;AAN4C;;;KAazD,mBAPa,CAAA,mBAO0B,cAP1B,CAAA,GAO4C,UAP5C,SAAA;EAAgB,OAAA,EAAA;IAO7B,OAAA,EACiB,gBADE;EAAoB,CAAA;CAAkB,GAG1D,gBAH0D,CAGzC,UAHyC,CAAA,SAAA,CAAA,CAAA,SAAA,CAAA,CAAA,GAAA,KAAA;;;;KASzD,eANe,CAAA,kBAMmB,uBANnB,CAAA,GAM8C,WAN9C,CAOlB,SAPkB,CAAA,YAAA,CAAA,CAAA;AAAA;;;KAaf,cAP6D,CAAA,kBAQ9C,uBAR8C,EAAA,cASlD,mBATkD,CAS9B,SAT8B,CAAA,CAAA,GAU9D,eAV8D,CAU9C,SAV8C,CAAA,CAUnC,KAVmC,CAAA;;AAAW;;AASzC,KAMxB,yBANwB,CAAA,kBAOhB,uBAPgB,EAAA,cAQpB,mBARoB,CAQA,SARA,CAAA,CAAA,GAShC,mBATgC,CASZ,cATY,CASG,SATH,EASc,KATd,CAAA,CAAA;;;;;;cCjCvB,sBAAA,SAA+B,KAAA;;;;;;;;ADEkB;;AAM5D,KEeU,cAAA,GAAiB,OAAA,CAAQ,OFfnC,GAAA;EAAgB;;AAAgB;;;EAQZ,WAAA,CAAA,EEaN,oBFbM,GAAA,SAAA;CAED;;;AAAD;AAMmB,KEW3B,mBFX2B,CAAA,kBEWW,uBFXX,CAAA,GAAA;EACrC,QAAA,EEWU,SFXV;EADgE,IAAA,EEa1D,aFb0D,EAAA;EAAW,iBAAA,CAAA,EEcvD,4BFduD,GAAA,SAAA;EAOxE,MAAA,CAAA,EEQM,MFRN,GAAc,SAAA;EACC;;;;;EAEW,SAAA,CAAA,EEWjB,iBFXiB,GAAA,SAAA;CAAK;AAKpC;;;AAEgB,cEUH,eFVG,CAAA,kBEU+B,uBFV/B,CAAA,CAAA;EACuB,iBAAA,QAAA;EAAW,iBAAA,UAAA;EAA1B,iBAAA,MAAA;EAApB,iBAAA,SAAA;EAAmB,QAAA,WAAA,CAAA;;;;AC1CvB;;;;ACuBA;AAYA;;EACY,OAAA,MAAA,CAAA,kBAiCsB,uBAjCtB,CAAA,CAAA;IAAA,QAAA;IAAA,IAAA;IAAA,iBAAA;IAAA,MAAA;IAAA;EAAA,CAAA,EAuCP,mBAvCO,CAuCa,SAvCb,CAAA,CAAA,EAuC0B,MAvC1B,CAuCiC,MAvCjC,CAuCwC,eAvCxC,CAuCwD,SAvCxD,CAAA,EAuCoE,cAvCpE,CAAA,CAAA;EACJ;;;;;AAcR;;;;;;;;;EAwBK;;;;EAAwC,OAAA,CAAA,cA6BrB,mBA7BqB,CA6BD,SA7BC,CAAA,CAAA,CAAA,aAAA,EA8B1B,KA9B0B,EAAA,OAAA,EA+BhC,yBA/BgC,CA+BN,SA/BM,EA+BK,KA/BL,CAAA,EAAA,OAAA,CAAA,EAgC/B,cAhC+B,CAAA,EAiCxC,MAjCwC,CAiCjC,MAjCiC,CAAA,IAAA,EAiCpB,cAjCoB,GAiCH,sBAjCG,CAAA,CAAA;EAAP;;;EA8BnB,KAAA,CAAA,CAAA,EA6FR,MA7FQ,CA6FD,MA7FC,CAAA,IAAA,EA6FY,cA7FZ,CAAA,CAAA;EACoB,QAAA,sBAAA"}
1
+ {"version":3,"file":"index.d.mts","names":["amqp","EventEmitter","TcpSocketConnectOpts","ConnectionOptions","ChannelWrapper","CreateChannelOpts","ConnectionUrl","Options","Connect","AmqpConnectionOptions","url","connectionOptions","ConnectListener","Connection","connection","arg","ConnectFailedListener","Error","err","Buffer","noDelay","timeout","keepAlive","keepAliveDelay","clientProperties","credentials","mechanism","username","password","response","AmqpConnectionManagerOptions","Promise","heartbeatIntervalInSeconds","reconnectTimeInSeconds","findServers","urls","callback","IAmqpConnectionManager","Function","ChannelModel","addListener","event","args","listener","reason","listeners","eventName","on","once","prependListener","prependOnceListener","removeListener","connect","options","reconnect","createChannel","close","isConnected","channelCount","AmqpConnectionManager","_channels","_currentUrl","_closed","_cancelRetriesHandler","_connectPromise","_currentConnection","_findServers","_urls","constructor","_connect","default"],"sources":["../../../node_modules/.pnpm/amqp-connection-manager@5.0.0_amqplib@0.10.9/node_modules/amqp-connection-manager/dist/types/AmqpConnectionManager.d.ts","../src/types.ts","../src/errors.ts","../src/client.ts"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;KAKYM,aAAAA,YAAyBN,IAAAA,CAAKO,OAAAA,CAAQC,OAAAA;EAC9CE,GAAAA;EACAC,iBAAAA,GAAoBF,qBAAAA;AAAAA;AAAAA,KAcZA,qBAAAA,IAAyBN,iBAAAA,GAAoBD,oBAAAA;EACrDkB,OAAAA;EACAC,OAAAA;EACAC,SAAAA;EACAC,cAAAA;EACAC,gBAAAA;EACAC,WAAAA;IACIC,SAAAA;IACAC,QAAAA;IACAC,QAAAA;IACAC,QAAAA,QAAgBV,MAAAA;EAAAA;IAEhBO,SAAAA;IACAG,QAAAA,QAAgBV,MAAAA;EAAAA;AAAAA;AAAAA,UAGPW,4BAAAA;EAVbL;EAYAO,0BAAAA;EAVIL;;;;EAeJM,sBAAAA;EAVIJ;;;;AAGR;;;EAeIK,WAAAA,KAAgBE,QAAAA,GAAWD,IAAAA,EAAM7B,aAAAA,GAAgBA,aAAAA,+BAA4CyB,OAAAA,CAAQzB,aAAAA,GAAgBA,aAAAA;EAApEA;EAEjDK,iBAAAA,GAAoBF,qBAAAA;AAAAA;;;;;;KC5CnB,gBAAA,iBAAiC,gBAAA,IACpC,OAAA,SAAgB,gBAAA,iBAAiC,MAAA;;;;;ADNnD;KCaK,mBAAA,oBAAuC,cAAA,IAAkB,UAAA;EAC5D,OAAA;IAAW,OAAA,EAAS,gBAAA;EAAA;AAAA,IAElB,gBAAA,CAAiB,UAAA;;;;KAMhB,eAAA,mBAAkC,kBAAA,IAAsB,WAAA,CAAY,SAAA;;;ADNzE;KCWK,cAAA,mBACe,kBAAA,gBACJ,mBAAA,CAAoB,SAAA,KAChC,eAAA,CAAgB,SAAA,EAAW,KAAA;;;;KAKnB,yBAAA,mBACQ,kBAAA,gBACJ,mBAAA,CAAoB,SAAA,KAChC,mBAAA,CAAoB,cAAA,CAAe,SAAA,EAAW,KAAA;;;;;;cCxCrC,sBAAA,SAA+B,KAAA;EAAA,SAExB,aAAA;EAAA,SACA,MAAA;cADA,aAAA,UACA,MAAA;AAAA;;;;;;KCoBR,cAAA,GAAiB,OAAA,CAAQ,OAAA;EHrBZ;;;;;EG2BvB,WAAA,GAAc,oBAAA;AAAA;;;;KAMJ,mBAAA,mBAAsC,kBAAA;EAChD,QAAA,EAAU,SAAA;EACV,IAAA,EAAM,aAAA;EACN,iBAAA,GAAoB,4BAAA;EACpB,MAAA,GAAS,MAAA;EHrB8CP;;;;;EG2BvD,SAAA,GAAY,iBAAA;AAAA;;;;cAMD,eAAA,mBAAkC,kBAAA;EAAA,iBAE1B,QAAA;EAAA,iBACA,UAAA;EAAA,iBACA,MAAA;EAAA,iBACA,SAAA;EAAA,QAJZ,WAAA,CAAA;EHxBD2B;;;;;;;AAMR;;;EANQA,OGyCC,MAAA,mBAAyB,kBAAA,CAAA,CAAA;IAC9B,QAAA;IACA,IAAA;IACA,iBAAA;IACA,MAAA;IACA;EAAA,GACC,mBAAA,CAAoB,SAAA,IAAa,MAAA,CAAO,MAAA,CAAO,eAAA,CAAgB,SAAA,GAAY,cAAA;EH1B3BvB;;;;;;;;;;;;;;EAA4CyB;;;;EGuD/F,OAAA,eAAsB,mBAAA,CAAoB,SAAA,EAAA,CACxC,aAAA,EAAe,KAAA,EACf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,KAAA,GAC9C,OAAA,GAAU,cAAA,GACT,MAAA,CAAO,MAAA,OAAa,cAAA,GAAiB,sBAAA;EHzDG;;;EGmJ3C,KAAA,CAAA,GAAS,MAAA,CAAO,MAAA,OAAa,cAAA;EAAA,QAIrB,sBAAA;AAAA"}
package/dist/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/compression.ts","../src/client.ts"],"sourcesContent":["/**\n * Error thrown when message validation fails\n */\nexport class MessageValidationError extends Error {\n constructor(\n public readonly publisherName: string,\n public readonly issues: unknown,\n ) {\n super(`Message validation failed for publisher \"${publisherName}\"`);\n this.name = \"MessageValidationError\";\n // Node.js specific stack trace capture\n const ErrorConstructor = Error as unknown as {\n captureStackTrace?: (target: object, constructor: Function) => void;\n };\n if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n ErrorConstructor.captureStackTrace(this, this.constructor);\n }\n }\n}\n","import { Future, Result } from \"@swan-io/boxed\";\nimport { deflate, gzip } from \"node:zlib\";\nimport type { CompressionAlgorithm } from \"@amqp-contract/contract\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { match } from \"ts-pattern\";\nimport { promisify } from \"node:util\";\n\nconst gzipAsync = promisify(gzip);\nconst deflateAsync = promisify(deflate);\n\n/**\n * Compress a buffer using the specified compression algorithm.\n *\n * @param buffer - The buffer to compress\n * @param algorithm - The compression algorithm to use\n * @returns A Future with the compressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function compressBuffer(\n buffer: Buffer,\n algorithm: CompressionAlgorithm,\n): Future<Result<Buffer, TechnicalError>> {\n return match(algorithm)\n .with(\"gzip\", () =>\n Future.fromPromise(gzipAsync(buffer)).mapError(\n (error) => new TechnicalError(\"Failed to compress with gzip\", error),\n ),\n )\n .with(\"deflate\", () =>\n Future.fromPromise(deflateAsync(buffer)).mapError(\n (error) => new TechnicalError(\"Failed to compress with deflate\", error),\n ),\n )\n .exhaustive();\n}\n","import {\n AmqpClient,\n type Logger,\n TechnicalError,\n type TelemetryProvider,\n defaultTelemetryProvider,\n endSpanError,\n endSpanSuccess,\n recordPublishMetric,\n startPublishSpan,\n} from \"@amqp-contract/core\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type {\n CompressionAlgorithm,\n ContractDefinitionInput,\n InferPublisherNames,\n} from \"@amqp-contract/contract\";\nimport { Future, Result } from \"@swan-io/boxed\";\nimport type { ClientInferPublisherInput } from \"./types.js\";\nimport { MessageValidationError } from \"./errors.js\";\nimport type { Options } from \"amqplib\";\nimport { compressBuffer } from \"./compression.js\";\n\n/**\n * Publish options that extend amqplib's Options.Publish with optional compression support.\n */\nexport type PublishOptions = Options.Publish & {\n /**\n * Optional compression algorithm to use for the message payload.\n * When specified, the message will be compressed using the chosen algorithm\n * and the contentEncoding header will be set automatically.\n */\n compression?: CompressionAlgorithm | undefined;\n};\n\n/**\n * Options for creating a client\n */\nexport type CreateClientOptions<TContract extends ContractDefinitionInput> = {\n contract: TContract;\n urls: ConnectionUrl[];\n connectionOptions?: AmqpConnectionManagerOptions | undefined;\n logger?: Logger | undefined;\n /**\n * Optional telemetry provider for tracing and metrics.\n * If not provided, uses the default provider which attempts to load OpenTelemetry.\n * OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed.\n */\n telemetry?: TelemetryProvider | undefined;\n};\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinitionInput> {\n private constructor(\n private readonly contract: TContract,\n private readonly amqpClient: AmqpClient,\n private readonly logger?: Logger,\n private readonly telemetry: TelemetryProvider = defaultTelemetryProvider,\n ) {}\n\n /**\n * Create a type-safe AMQP client from a contract.\n *\n * Connection management (including automatic reconnection) is handled internally\n * by amqp-connection-manager via the {@link AmqpClient}. The client establishes\n * infrastructure asynchronously in the background once the connection is ready.\n *\n * Connections are automatically shared across clients with the same URLs and\n * connection options, following RabbitMQ best practices.\n */\n static create<TContract extends ContractDefinitionInput>({\n contract,\n urls,\n connectionOptions,\n logger,\n telemetry,\n }: CreateClientOptions<TContract>): Future<Result<TypedAmqpClient<TContract>, TechnicalError>> {\n const client = new TypedAmqpClient(\n contract,\n new AmqpClient(contract, { urls, connectionOptions }),\n logger,\n telemetry ?? defaultTelemetryProvider,\n );\n\n return client.waitForConnectionReady().mapOk(() => client);\n }\n\n /**\n * Publish a message using a defined publisher\n *\n * @param publisherName - The name of the publisher to use\n * @param message - The message to publish\n * @param options - Optional publish options including compression, headers, priority, etc.\n *\n * @remarks\n * If `options.compression` is specified, the message will be compressed before publishing\n * and the `contentEncoding` property will be set automatically. Any `contentEncoding`\n * value already in options will be overwritten by the compression algorithm.\n *\n * @returns Result.Ok(void) on success, or Result.Error with specific error on failure\n */\n /**\n * Publish a message using a defined publisher.\n * TypeScript guarantees publisher exists for valid publisher names.\n */\n publish<TName extends InferPublisherNames<TContract>>(\n publisherName: TName,\n message: ClientInferPublisherInput<TContract, TName>,\n options?: PublishOptions,\n ): Future<Result<void, TechnicalError | MessageValidationError>> {\n const startTime = Date.now();\n // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n const publisher = this.contract.publishers![publisherName as string]!;\n const { exchange, routingKey } = publisher;\n\n // Start telemetry span\n const span = startPublishSpan(this.telemetry, exchange.name, routingKey, {\n \"amqp.publisher.name\": String(publisherName),\n });\n\n const validateMessage = () => {\n const validationResult = publisher.message.payload[\"~standard\"].validate(message);\n return Future.fromPromise(\n validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult),\n )\n .mapError((error) => new TechnicalError(`Validation failed`, error))\n .mapOkToResult((validation) => {\n if (validation.issues) {\n return Result.Error(\n new MessageValidationError(String(publisherName), validation.issues),\n );\n }\n\n return Result.Ok(validation.value);\n });\n };\n\n const publishMessage = (validatedMessage: unknown): Future<Result<void, TechnicalError>> => {\n // Extract compression from options and create publish options without it\n const { compression, ...restOptions } = options ?? {};\n const publishOptions: Options.Publish = { ...restOptions };\n\n // Prepare payload and options based on compression configuration\n const preparePayload = (): Future<Result<Buffer | unknown, TechnicalError>> => {\n if (compression) {\n // Compress the message payload\n const messageBuffer = Buffer.from(JSON.stringify(validatedMessage));\n publishOptions.contentEncoding = compression;\n\n return compressBuffer(messageBuffer, compression);\n }\n\n // No compression: use the channel's built-in JSON serialization\n return Future.value(Result.Ok(validatedMessage));\n };\n\n // Publish the prepared payload\n return preparePayload().flatMapOk((payload) =>\n this.amqpClient\n .publish(publisher.exchange.name, publisher.routingKey ?? \"\", payload, publishOptions)\n .mapOkToResult((published) => {\n if (!published) {\n return Result.Error(\n new TechnicalError(\n `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n ),\n );\n }\n\n this.logger?.info(\"Message published successfully\", {\n publisherName: String(publisherName),\n exchange: publisher.exchange.name,\n routingKey: publisher.routingKey,\n compressed: !!compression,\n });\n\n return Result.Ok(undefined);\n }),\n );\n };\n\n // Validate message using schema\n return validateMessage()\n .flatMapOk((validatedMessage) => publishMessage(validatedMessage))\n .tapOk(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, true, durationMs);\n })\n .tapError((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, false, durationMs);\n });\n }\n\n /**\n * Close the channel and connection\n */\n close(): Future<Result<void, TechnicalError>> {\n return this.amqpClient.close().mapOk(() => undefined);\n }\n\n private waitForConnectionReady(): Future<Result<void, TechnicalError>> {\n return this.amqpClient.waitForConnect();\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/compression.ts","../src/client.ts"],"sourcesContent":["/**\n * Error thrown when message validation fails\n */\nexport class MessageValidationError extends Error {\n constructor(\n public readonly publisherName: string,\n public readonly issues: unknown,\n ) {\n super(`Message validation failed for publisher \"${publisherName}\"`);\n this.name = \"MessageValidationError\";\n // Node.js specific stack trace capture\n const ErrorConstructor = Error as unknown as {\n captureStackTrace?: (target: object, constructor: Function) => void;\n };\n if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n ErrorConstructor.captureStackTrace(this, this.constructor);\n }\n }\n}\n","import { Future, Result } from \"@swan-io/boxed\";\nimport { deflate, gzip } from \"node:zlib\";\nimport type { CompressionAlgorithm } from \"@amqp-contract/contract\";\nimport { TechnicalError } from \"@amqp-contract/core\";\nimport { match } from \"ts-pattern\";\nimport { promisify } from \"node:util\";\n\nconst gzipAsync = promisify(gzip);\nconst deflateAsync = promisify(deflate);\n\n/**\n * Compress a buffer using the specified compression algorithm.\n *\n * @param buffer - The buffer to compress\n * @param algorithm - The compression algorithm to use\n * @returns A Future with the compressed buffer or a TechnicalError\n *\n * @internal\n */\nexport function compressBuffer(\n buffer: Buffer,\n algorithm: CompressionAlgorithm,\n): Future<Result<Buffer, TechnicalError>> {\n return match(algorithm)\n .with(\"gzip\", () =>\n Future.fromPromise(gzipAsync(buffer)).mapError(\n (error) => new TechnicalError(\"Failed to compress with gzip\", error),\n ),\n )\n .with(\"deflate\", () =>\n Future.fromPromise(deflateAsync(buffer)).mapError(\n (error) => new TechnicalError(\"Failed to compress with deflate\", error),\n ),\n )\n .exhaustive();\n}\n","import {\n AmqpClient,\n type Logger,\n TechnicalError,\n type TelemetryProvider,\n defaultTelemetryProvider,\n endSpanError,\n endSpanSuccess,\n recordPublishMetric,\n startPublishSpan,\n} from \"@amqp-contract/core\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\nimport type {\n CompressionAlgorithm,\n ContractDefinition,\n InferPublisherNames,\n} from \"@amqp-contract/contract\";\nimport { Future, Result } from \"@swan-io/boxed\";\nimport type { ClientInferPublisherInput } from \"./types.js\";\nimport { MessageValidationError } from \"./errors.js\";\nimport type { Options } from \"amqplib\";\nimport { compressBuffer } from \"./compression.js\";\n\n/**\n * Publish options that extend amqplib's Options.Publish with optional compression support.\n */\nexport type PublishOptions = Options.Publish & {\n /**\n * Optional compression algorithm to use for the message payload.\n * When specified, the message will be compressed using the chosen algorithm\n * and the contentEncoding header will be set automatically.\n */\n compression?: CompressionAlgorithm | undefined;\n};\n\n/**\n * Options for creating a client\n */\nexport type CreateClientOptions<TContract extends ContractDefinition> = {\n contract: TContract;\n urls: ConnectionUrl[];\n connectionOptions?: AmqpConnectionManagerOptions | undefined;\n logger?: Logger | undefined;\n /**\n * Optional telemetry provider for tracing and metrics.\n * If not provided, uses the default provider which attempts to load OpenTelemetry.\n * OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed.\n */\n telemetry?: TelemetryProvider | undefined;\n};\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinition> {\n private constructor(\n private readonly contract: TContract,\n private readonly amqpClient: AmqpClient,\n private readonly logger?: Logger,\n private readonly telemetry: TelemetryProvider = defaultTelemetryProvider,\n ) {}\n\n /**\n * Create a type-safe AMQP client from a contract.\n *\n * Connection management (including automatic reconnection) is handled internally\n * by amqp-connection-manager via the {@link AmqpClient}. The client establishes\n * infrastructure asynchronously in the background once the connection is ready.\n *\n * Connections are automatically shared across clients with the same URLs and\n * connection options, following RabbitMQ best practices.\n */\n static create<TContract extends ContractDefinition>({\n contract,\n urls,\n connectionOptions,\n logger,\n telemetry,\n }: CreateClientOptions<TContract>): Future<Result<TypedAmqpClient<TContract>, TechnicalError>> {\n const client = new TypedAmqpClient(\n contract,\n new AmqpClient(contract, { urls, connectionOptions }),\n logger,\n telemetry ?? defaultTelemetryProvider,\n );\n\n return client.waitForConnectionReady().mapOk(() => client);\n }\n\n /**\n * Publish a message using a defined publisher\n *\n * @param publisherName - The name of the publisher to use\n * @param message - The message to publish\n * @param options - Optional publish options including compression, headers, priority, etc.\n *\n * @remarks\n * If `options.compression` is specified, the message will be compressed before publishing\n * and the `contentEncoding` property will be set automatically. Any `contentEncoding`\n * value already in options will be overwritten by the compression algorithm.\n *\n * @returns Result.Ok(void) on success, or Result.Error with specific error on failure\n */\n /**\n * Publish a message using a defined publisher.\n * TypeScript guarantees publisher exists for valid publisher names.\n */\n publish<TName extends InferPublisherNames<TContract>>(\n publisherName: TName,\n message: ClientInferPublisherInput<TContract, TName>,\n options?: PublishOptions,\n ): Future<Result<void, TechnicalError | MessageValidationError>> {\n const startTime = Date.now();\n // Non-null assertions safe: TypeScript guarantees these exist for valid TName\n const publisher = this.contract.publishers![publisherName as string]!;\n const { exchange, routingKey } = publisher;\n\n // Start telemetry span\n const span = startPublishSpan(this.telemetry, exchange.name, routingKey, {\n \"amqp.publisher.name\": String(publisherName),\n });\n\n const validateMessage = () => {\n const validationResult = publisher.message.payload[\"~standard\"].validate(message);\n return Future.fromPromise(\n validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult),\n )\n .mapError((error) => new TechnicalError(`Validation failed`, error))\n .mapOkToResult((validation) => {\n if (validation.issues) {\n return Result.Error(\n new MessageValidationError(String(publisherName), validation.issues),\n );\n }\n\n return Result.Ok(validation.value);\n });\n };\n\n const publishMessage = (validatedMessage: unknown): Future<Result<void, TechnicalError>> => {\n // Extract compression from options and create publish options without it\n const { compression, ...restOptions } = options ?? {};\n const publishOptions: Options.Publish = { ...restOptions };\n\n // Prepare payload and options based on compression configuration\n const preparePayload = (): Future<Result<Buffer | unknown, TechnicalError>> => {\n if (compression) {\n // Compress the message payload\n const messageBuffer = Buffer.from(JSON.stringify(validatedMessage));\n publishOptions.contentEncoding = compression;\n\n return compressBuffer(messageBuffer, compression);\n }\n\n // No compression: use the channel's built-in JSON serialization\n return Future.value(Result.Ok(validatedMessage));\n };\n\n // Publish the prepared payload\n return preparePayload().flatMapOk((payload) =>\n this.amqpClient\n .publish(publisher.exchange.name, publisher.routingKey ?? \"\", payload, publishOptions)\n .mapOkToResult((published) => {\n if (!published) {\n return Result.Error(\n new TechnicalError(\n `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n ),\n );\n }\n\n this.logger?.info(\"Message published successfully\", {\n publisherName: String(publisherName),\n exchange: publisher.exchange.name,\n routingKey: publisher.routingKey,\n compressed: !!compression,\n });\n\n return Result.Ok(undefined);\n }),\n );\n };\n\n // Validate message using schema\n return validateMessage()\n .flatMapOk((validatedMessage) => publishMessage(validatedMessage))\n .tapOk(() => {\n const durationMs = Date.now() - startTime;\n endSpanSuccess(span);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, true, durationMs);\n })\n .tapError((error) => {\n const durationMs = Date.now() - startTime;\n endSpanError(span, error);\n recordPublishMetric(this.telemetry, exchange.name, routingKey, false, durationMs);\n });\n }\n\n /**\n * Close the channel and connection\n */\n close(): Future<Result<void, TechnicalError>> {\n return this.amqpClient.close().mapOk(() => undefined);\n }\n\n private waitForConnectionReady(): Future<Result<void, TechnicalError>> {\n return this.amqpClient.waitForConnect();\n }\n}\n"],"mappings":"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"}
package/docs/index.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  ### MessageValidationError
10
10
 
11
- Defined in: [packages/client/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/errors.ts#L4)
11
+ Defined in: [packages/client/src/errors.ts:4](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/errors.ts#L4)
12
12
 
13
13
  Error thrown when message validation fails
14
14
 
@@ -24,7 +24,7 @@ Error thrown when message validation fails
24
24
  new MessageValidationError(publisherName, issues): MessageValidationError;
25
25
  ```
26
26
 
27
- Defined in: [packages/client/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/errors.ts#L5)
27
+ Defined in: [packages/client/src/errors.ts:5](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/errors.ts#L5)
28
28
 
29
29
  ###### Parameters
30
30
 
@@ -48,12 +48,12 @@ Error.constructor
48
48
  | Property | Modifier | Type | Description | Inherited from | Defined in |
49
49
  | ------ | ------ | ------ | ------ | ------ | ------ |
50
50
  | <a id="cause"></a> `cause?` | `public` | `unknown` | - | `Error.cause` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:26 |
51
- | <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/client/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/errors.ts#L7) |
51
+ | <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/client/src/errors.ts:7](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/errors.ts#L7) |
52
52
  | <a id="message"></a> `message` | `public` | `string` | - | `Error.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
53
53
  | <a id="name"></a> `name` | `public` | `string` | - | `Error.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
54
- | <a id="publishername"></a> `publisherName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:6](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/errors.ts#L6) |
54
+ | <a id="publishername"></a> `publisherName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:6](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/errors.ts#L6) |
55
55
  | <a id="stack"></a> `stack?` | `public` | `string` | - | `Error.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
56
- | <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:67 |
56
+ | <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:67 |
57
57
 
58
58
  #### Methods
59
59
 
@@ -63,7 +63,7 @@ Error.constructor
63
63
  static captureStackTrace(targetObject, constructorOpt?): void;
64
64
  ```
65
65
 
66
- Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:51
66
+ Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:51
67
67
 
68
68
  Creates a `.stack` property on `targetObject`, which when accessed returns
69
69
  a string representing the location in the code at which
@@ -132,7 +132,7 @@ Error.captureStackTrace
132
132
  static prepareStackTrace(err, stackTraces): any;
133
133
  ```
134
134
 
135
- Defined in: node\_modules/.pnpm/@types+node@25.0.9/node\_modules/@types/node/globals.d.ts:55
135
+ Defined in: node\_modules/.pnpm/@types+node@25.2.1/node\_modules/@types/node/globals.d.ts:55
136
136
 
137
137
  ###### Parameters
138
138
 
@@ -159,7 +159,7 @@ Error.prepareStackTrace
159
159
 
160
160
  ### TypedAmqpClient
161
161
 
162
- Defined in: [packages/client/src/client.ts:55](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L55)
162
+ Defined in: [packages/client/src/client.ts:55](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L55)
163
163
 
164
164
  Type-safe AMQP client for publishing messages
165
165
 
@@ -167,7 +167,7 @@ Type-safe AMQP client for publishing messages
167
167
 
168
168
  | Type Parameter |
169
169
  | ------ |
170
- | `TContract` *extends* `ContractDefinitionInput` |
170
+ | `TContract` *extends* `ContractDefinition` |
171
171
 
172
172
  #### Methods
173
173
 
@@ -177,7 +177,7 @@ Type-safe AMQP client for publishing messages
177
177
  close(): Future<Result<void, TechnicalError>>;
178
178
  ```
179
179
 
180
- Defined in: [packages/client/src/client.ts:202](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L202)
180
+ Defined in: [packages/client/src/client.ts:202](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L202)
181
181
 
182
182
  Close the channel and connection
183
183
 
@@ -194,7 +194,7 @@ publish<TName>(
194
194
  options?): Future<Result<void, TechnicalError | MessageValidationError>>;
195
195
  ```
196
196
 
197
- Defined in: [packages/client/src/client.ts:108](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L108)
197
+ Defined in: [packages/client/src/client.ts:108](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L108)
198
198
 
199
199
  Publish a message using a defined publisher.
200
200
  TypeScript guarantees publisher exists for valid publisher names.
@@ -223,7 +223,7 @@ TypeScript guarantees publisher exists for valid publisher names.
223
223
  static create<TContract>(__namedParameters): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
224
224
  ```
225
225
 
226
- Defined in: [packages/client/src/client.ts:73](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L73)
226
+ Defined in: [packages/client/src/client.ts:73](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L73)
227
227
 
228
228
  Create a type-safe AMQP client from a contract.
229
229
 
@@ -238,7 +238,7 @@ connection options, following RabbitMQ best practices.
238
238
 
239
239
  | Type Parameter |
240
240
  | ------ |
241
- | `TContract` *extends* `ContractDefinitionInput` |
241
+ | `TContract` *extends* `ContractDefinition` |
242
242
 
243
243
  ###### Parameters
244
244
 
@@ -258,7 +258,7 @@ connection options, following RabbitMQ best practices.
258
258
  type ClientInferPublisherInput<TContract, TName> = PublisherInferInput<InferPublisher<TContract, TName>>;
259
259
  ```
260
260
 
261
- Defined in: [packages/client/src/types.ts:43](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/types.ts#L43)
261
+ Defined in: [packages/client/src/types.ts:41](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/types.ts#L41)
262
262
 
263
263
  Infer publisher input type (message payload) for a specific publisher in a contract
264
264
 
@@ -266,7 +266,7 @@ Infer publisher input type (message payload) for a specific publisher in a contr
266
266
 
267
267
  | Type Parameter |
268
268
  | ------ |
269
- | `TContract` *extends* `ContractDefinitionInput` |
269
+ | `TContract` *extends* `ContractDefinition` |
270
270
  | `TName` *extends* `InferPublisherNames`&lt;`TContract`&gt; |
271
271
 
272
272
  ***
@@ -277,7 +277,7 @@ Infer publisher input type (message payload) for a specific publisher in a contr
277
277
  type CreateClientOptions<TContract> = object;
278
278
  ```
279
279
 
280
- Defined in: [packages/client/src/client.ts:39](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L39)
280
+ Defined in: [packages/client/src/client.ts:39](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L39)
281
281
 
282
282
  Options for creating a client
283
283
 
@@ -285,17 +285,17 @@ Options for creating a client
285
285
 
286
286
  | Type Parameter |
287
287
  | ------ |
288
- | `TContract` *extends* `ContractDefinitionInput` |
288
+ | `TContract` *extends* `ContractDefinition` |
289
289
 
290
290
  #### Properties
291
291
 
292
292
  | Property | Type | Description | Defined in |
293
293
  | ------ | ------ | ------ | ------ |
294
- | <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | - | [packages/client/src/client.ts:42](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L42) |
295
- | <a id="contract"></a> `contract` | `TContract` | - | [packages/client/src/client.ts:40](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L40) |
296
- | <a id="logger"></a> `logger?` | `Logger` | - | [packages/client/src/client.ts:43](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L43) |
297
- | <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/client/src/client.ts:49](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L49) |
298
- | <a id="urls"></a> `urls` | `ConnectionUrl`[] | - | [packages/client/src/client.ts:41](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L41) |
294
+ | <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | - | [packages/client/src/client.ts:42](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L42) |
295
+ | <a id="contract"></a> `contract` | `TContract` | - | [packages/client/src/client.ts:40](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L40) |
296
+ | <a id="logger"></a> `logger?` | `Logger` | - | [packages/client/src/client.ts:43](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L43) |
297
+ | <a id="telemetry"></a> `telemetry?` | `TelemetryProvider` | Optional telemetry provider for tracing and metrics. If not provided, uses the default provider which attempts to load OpenTelemetry. OpenTelemetry instrumentation is automatically enabled if @opentelemetry/api is installed. | [packages/client/src/client.ts:49](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L49) |
298
+ | <a id="urls"></a> `urls` | `ConnectionUrl`[] | - | [packages/client/src/client.ts:41](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L41) |
299
299
 
300
300
  ***
301
301
 
@@ -305,7 +305,7 @@ Options for creating a client
305
305
  type PublishOptions = Options.Publish & object;
306
306
  ```
307
307
 
308
- Defined in: [packages/client/src/client.ts:27](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L27)
308
+ Defined in: [packages/client/src/client.ts:27](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L27)
309
309
 
310
310
  Publish options that extend amqplib's Options.Publish with optional compression support.
311
311
 
@@ -313,4 +313,4 @@ Publish options that extend amqplib's Options.Publish with optional compression
313
313
 
314
314
  | Name | Type | Description | Defined in |
315
315
  | ------ | ------ | ------ | ------ |
316
- | `compression?` | `CompressionAlgorithm` | Optional compression algorithm to use for the message payload. When specified, the message will be compressed using the chosen algorithm and the contentEncoding header will be set automatically. | [packages/client/src/client.ts:33](https://github.com/btravers/amqp-contract/blob/d132d062ebeaa9cc84db5471805355a29e3a50dc/packages/client/src/client.ts#L33) |
316
+ | `compression?` | `CompressionAlgorithm` | Optional compression algorithm to use for the message payload. When specified, the message will be compressed using the chosen algorithm and the contentEncoding header will be set automatically. | [packages/client/src/client.ts:33](https://github.com/btravers/amqp-contract/blob/14b3465c61d25678b908341226a86fc481470ac6/packages/client/src/client.ts#L33) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amqp-contract/client",
3
- "version": "0.14.0",
3
+ "version": "0.16.0",
4
4
  "description": "Client utilities for publishing messages using amqp-contract",
5
5
  "keywords": [
6
6
  "amqp",
@@ -53,22 +53,22 @@
53
53
  "@standard-schema/spec": "1.1.0",
54
54
  "@swan-io/boxed": "3.2.1",
55
55
  "ts-pattern": "5.9.0",
56
- "@amqp-contract/contract": "0.14.0",
57
- "@amqp-contract/core": "0.14.0"
56
+ "@amqp-contract/contract": "0.16.0",
57
+ "@amqp-contract/core": "0.16.0"
58
58
  },
59
59
  "devDependencies": {
60
60
  "@types/amqplib": "0.10.8",
61
- "@types/node": "25.0.9",
62
- "@vitest/coverage-v8": "4.0.17",
61
+ "@types/node": "25.2.1",
62
+ "@vitest/coverage-v8": "4.0.18",
63
63
  "amqp-connection-manager": "5.0.0",
64
64
  "amqplib": "0.10.9",
65
- "tsdown": "0.19.0",
65
+ "tsdown": "0.20.3",
66
66
  "typedoc": "0.28.16",
67
67
  "typedoc-plugin-markdown": "4.9.0",
68
68
  "typescript": "5.9.3",
69
- "vitest": "4.0.17",
70
- "zod": "4.3.5",
71
- "@amqp-contract/testing": "0.14.0",
69
+ "vitest": "4.0.18",
70
+ "zod": "4.3.6",
71
+ "@amqp-contract/testing": "0.16.0",
72
72
  "@amqp-contract/tsconfig": "0.1.0",
73
73
  "@amqp-contract/typedoc": "0.1.0"
74
74
  },