@geekmidas/events 10.0.0-alpha.9 → 10.0.0-alpha.90

package/dist/registry-DIx25Q5s.d.cts

@@ -0,0 +1,255 @@
+import { InferStandardSchema } from "@geekmidas/schema";
+//#region ../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts
+/** The Standard Typed interface. This is a base type extended by other specs. */
+interface StandardTypedV1<Input = unknown, Output = Input> {
+  /** The Standard properties. */
+  readonly "~standard": StandardTypedV1.Props<Input, Output>;
+}
+declare namespace StandardTypedV1 {
+  /** The Standard Typed properties interface. */
+  interface Props<Input = unknown, Output = Input> {
+    /** The version number of the standard. */
+    readonly version: 1;
+    /** The vendor name of the schema library. */
+    readonly vendor: string;
+    /** Inferred types associated with the schema. */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+  /** The Standard Typed types interface. */
+  interface Types<Input = unknown, Output = Input> {
+    /** The input type of the schema. */
+    readonly input: Input;
+    /** The output type of the schema. */
+    readonly output: Output;
+  }
+  /** Infers the input type of a Standard Typed. */
+  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+  /** Infers the output type of a Standard Typed. */
+  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard Schema properties. */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+  /** The Standard Schema properties interface. */
+  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
+    /** Validates unknown input values. */
+    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+  }
+  /** The result interface of the validate function. */
+  type Result<Output> = SuccessResult<Output> | FailureResult;
+  /** The result interface if validation succeeds. */
+  interface SuccessResult<Output> {
+    /** The typed output value. */
+    readonly value: Output;
+    /** A falsy value for `issues` indicates success. */
+    readonly issues?: undefined;
+  }
+  interface Options {
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+  /** The result interface if validation fails. */
+  interface FailureResult {
+    /** The issues of failed validation. */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+  /** The issue interface of the failure output. */
+  interface Issue {
+    /** The error message of the issue. */
+    readonly message: string;
+    /** The path of the issue, if any. */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+  /** The path segment interface of the issue. */
+  interface PathSegment {
+    /** The key representing a path segment. */
+    readonly key: PropertyKey;
+  }
+  /** The Standard types interface. */
+  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
+  /** Infers the input type of a Standard. */
+  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
+  /** Infers the output type of a Standard. */
+  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * Represents a publishable event message with a type and payload.
+ *
+ * @template TType - The event type/name (e.g., 'user.created')
+ * @template TPayload - The event payload data
+ */
+type PublishableMessage<TType extends string, TPayload> = {
+  type: TType;
+  payload: TPayload;
+};
+/**
+ * Event publisher/subscriber types
+ */
+declare enum EventPublisherType {
+  Basic = "basic",
+  EventBridge = "eventbridge",
+  SQS = "sqs",
+  SNS = "sns",
+  Kafka = "kafka",
+  RabbitMQ = "rabbitmq",
+  PgBoss = "pgboss"
+}
+/**
+ * A connection string or connection whose transport nothing here implements —
+ * a typo'd scheme, or one of the listed-but-unbuilt ones (EventBridge, Kafka).
+ */
+declare class UnsupportedEventTransport extends Error {
+  readonly transport: string;
+  readonly role: 'publisher' | 'subscriber' | 'connection';
+  constructor(transport: string, role: 'publisher' | 'subscriber' | 'connection');
+}
+/**
+ * Base interface for event connections
+ * Connections manage the underlying transport (RabbitMQ channel, SQS client, etc.)
+ */
+interface EventConnection {
+  readonly type: EventPublisherType;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  isConnected(): boolean;
+}
+/**
+ * Interface for event publishers that handle the actual publishing of events.
+ * Implementations can send to EventBridge, SQS, Kafka, or any other event system.
+ *
+ * @template TMessage - The union type of all publishable messages
+ */
+type EventPublisher<TMessage extends PublishableMessage<string, any>> = {
+  publish: (message: TMessage[]) => Promise<void>;
+};
+/**
+ * Interface for event subscribers that handle receiving and processing events.
+ *
+ * @template TMessage - The union type of all publishable messages
+ */
+type EventSubscriber<TMessage extends PublishableMessage<string, any>> = {
+  subscribe: (messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>) => Promise<void>;
+};
+/**
+ * Utility type to extract the message from EventPublisher
+ */
+type ExtractPublisherMessage<T> = T extends EventPublisher<infer M> ? M : never;
+type MappedEvent<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined> = {
+  type: ExtractPublisherMessage<T>['type'];
+  payload: (ctx: InferStandardSchema<OutSchema>) => ExtractPublisherMessage<T>['payload'];
+  when?: (ctx: InferStandardSchema<OutSchema>) => boolean;
+};
+//#endregion
+//#region src/Publisher.d.ts
+/** How a publisher is used, beyond the address it reaches. */
+interface PublisherOptions {
+  /**
+   * The topic this publisher fans out to. SNS and RabbitMQ name the topic in
+   * their address already; pg-boss has one address for every topic and queue,
+   * so it is told here that a message goes to every subscriber rather than to
+   * one queue.
+   */
+  topic?: string;
+}
+/**
+ * Publishers for a connection string or a connection, through whichever
+ * driver is registered for its scheme — see `registerEventsDriver`.
+ */
+declare class Publisher {
+  /**
+   * Create a publisher from a connection string
+   * This creates both a connection and a publisher
+   *
+   * @throws {UnregisteredEventsScheme} when the broker's driver is not
+   * registered.
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventPublisherConnectionString, options?: PublisherOptions): Promise<EventPublisher<TMessage>>;
+  /**
+   * Create a publisher from an existing connection
+   * This allows sharing connections between publishers and subscribers
+   */
+  static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection, options?: PublisherOptions): Promise<EventPublisher<TMessage>>;
+}
+type EventPublisherConnectionString = `${EventPublisherType}://${string}`;
+//#endregion
+//#region src/registry.d.ts
+type AnyMessage = PublishableMessage<string, any>;
+/** How a subscriber built from a connection is used, beyond its address. */
+interface SubscriberOptions {
+  /**
+   * The topic subscribed to. pg-boss needs it, with {@link subscription}, to
+   * give each subscriber a queue of its own; the other brokers carry the topic
+   * in their address and ignore it.
+   */
+  topic?: string;
+  /** The subscriber's name — its own queue on pg-boss. */
+  subscription?: string;
+}
+/**
+ * One broker: the connections, publishers and subscribers for its scheme.
+ *
+ * A driver owns parsing — the shape of an `sns://` string is SNS's business —
+ * and is the only module that imports its broker's client library.
+ */
+interface EventsDriver {
+  /**
+   * The scheme this driver handles, without the colon — `'pgboss'`, `'sns'`.
+   * It is also the `type` of every connection the driver builds, which is how
+   * a connection finds its way back here.
+   */
+  readonly scheme: `${EventPublisherType}`;
+  /** A connection, connected, for a connection string. */
+  connect(connectionString: string): Promise<EventConnection>;
+  /** A publisher, with a connection of its own, for a connection string. */
+  publisher<TMessage extends AnyMessage>(connectionString: string, options: PublisherOptions): Promise<EventPublisher<TMessage>>;
+  /** A publisher on a connection this driver built. */
+  publisherFor<TMessage extends AnyMessage>(connection: EventConnection, options: PublisherOptions): EventPublisher<TMessage>;
+  /** A subscriber, with a connection of its own, for a connection string. */
+  subscriber<TMessage extends AnyMessage>(connectionString: string): Promise<EventSubscriber<TMessage>>;
+  /** A subscriber on a connection this driver built. */
+  subscriberFor<TMessage extends AnyMessage>(connection: EventConnection, options: SubscriberOptions): EventSubscriber<TMessage>;
+}
+/** Make a driver available to `Publisher`, `Subscriber` and friends. Idempotent. */
+declare function registerEventsDriver(driver: EventsDriver): void;
+/** Which schemes are currently registered — the useful half of a failure. */
+declare function registeredEventsSchemes(): string[];
+/**
+ * The driver for a scheme — `'pgboss'`, `'pgboss:'`, or a whole connection
+ * string, whichever the caller has.
+ *
+ * @throws {UnregisteredEventsScheme} when the scheme is a broker this package
+ * implements but nothing registered its driver.
+ * @throws {UnsupportedEventTransport} when no broker here has that scheme.
+ */
+declare function eventsDriverFor(scheme: string, role?: 'publisher' | 'subscriber' | 'connection'): EventsDriver;
+/**
+ * A connection string for a broker whose driver nothing registered.
+ *
+ * The broker exists — this is not a typo'd scheme — but the process was never
+ * told about it. Usually a script building its own publisher, or a build that
+ * registered the drivers for a different target than the one that composed
+ * the connection string.
+ */
+declare class UnregisteredEventsScheme extends Error {
+  /** The scheme with no driver, without the colon — `'pgboss'`. */
+  readonly scheme: string;
+  /** What is registered, so the caller can see what was chosen instead. */
+  readonly registered: readonly string[];
+  /** The subpath that exports the missing driver. */
+  readonly subpath: string;
+  /** The driver's export name. */
+  readonly driver: string;
+  constructor(
+  /** The scheme with no driver, without the colon — `'pgboss'`. */
+  scheme: string,
+  /** What is registered, so the caller can see what was chosen instead. */
+  registered: readonly string[]);
+}
+//#endregion
+export { UnsupportedEventTransport as _, registerEventsDriver as a, Publisher as c, EventPublisher as d, EventPublisherType as f, PublishableMessage as g, MappedEvent as h, eventsDriverFor as i, PublisherOptions as l, ExtractPublisherMessage as m, SubscriberOptions as n, registeredEventsSchemes as o, EventSubscriber as p, UnregisteredEventsScheme as r, EventPublisherConnectionString as s, EventsDriver as t, EventConnection as u };
+//# sourceMappingURL=registry-DIx25Q5s.d.cts.map

package/dist/registry-DIx25Q5s.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DIx25Q5s.d.cts","names":[],"sources":["../../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts","../src/types.ts","../src/Publisher.ts","../src/registry.ts"],"x_google_ignoreList":[0],"mappings":";;;UACU,gBAAgB,iBAAiB,SAAS;;WAEvC,aAAa,gBAAgB,MAAM,OAAO;;kBAErC;;YAEJ,MAAM,iBAAiB,SAAS;;aAE7B;;aAEA;;aAEA,QAAQ,MAAM,OAAO;;;YAGxB,MAAM,iBAAiB,SAAS;;aAE7B,OAAO;;aAEP,QAAQ;;;OAGhB,WAAW,eAAe,mBAAmB,YAAY;;OAEzD,YAAY,eAAe,mBAAmB,YAAY;;;UAGzD,iBAAiB,iBAAiB,SAAS;;WAExC,aAAa,iBAAiB,MAAM,OAAO;;kBAEtC;;YAEJ,MAAM,iBAAiB,SAAS,eAAe,gBAAgB,MAAM,OAAO;;aAEzE,WAAW,gBAAgB,UAAU,iBAAiB,wBAAwB,OAAO,UAAU,QAAQ,OAAO;;;OAGtH,OAAO,UAAU,cAAc,UAAU;;YAEpC,cAAc;;aAEX,OAAO;;aAEP;;YAEH;;aAEG,iBAAiB;;;YAGpB;;aAEG,QAAQ,cAAc;;;YAGzB;;aAEG;;aAEA,OAAO,cAAc,cAAc;;;YAGtC;;aAEG,KAAK;;;YAGR,MAAM,iBAAiB,SAAS,eAAe,gBAAgB,MAAM,OAAO;;OAGjF,WAAW,eAAe,mBAAmB,gBAAgB,WAAW;;OAExE,YAAY,eAAe,mBAAmB,gBAAgB,YAAY;;;;;;;;;;KCjEvE,mBAAmB,sBAAsB;EACpD,MAAM;EACN,SAAS;;;;;aAME;EACX;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;cAgBY,kCAAkC;WAEpC;WACA;EAFV,YACU,mBACA;;;;;;UAaM;WACP,MAAM;EACf,WAAW;EACX,SAAS;EACT;;;;;;;;KASW,eAAe,iBAAiB;EAC3C,UAAU,SAAS,eAAe;;;;;;;KAQvB,gBAAgB,iBAAiB;EAE3C,YACC,UAAU,oBACV,WAAW,SAAS,aAAa,kBAC7B;;;;;KAKK,wBAAwB,KACnC,UAAU,qBAAqB,KAAK;KAEzB,YACX,UAAU,iCACV,kBAAkB;EAElB,MAAM,wBAAwB;EAC9B,UACC,KAAK,oBAAoB,eACrB,wBAAwB;EAC7B,QAAQ,KAAK,oBAAoB;;;;;UC1FjB;;;;;;;EAOhB;;;;;;cAOY;;;;;;;;SAQC,qBACZ,iBAAiB,iCAEjB,eAAe,gCACf,UAAS,mBACP,QAAQ,eAAe;;;;;SAYb,eAAe,iBAAiB,iCAC5C,YAAY,iBACZ,UAAS,mBACP,QAAQ,eAAe;;KAQf,oCACR;;;KCrCC,aAAa;;UAGD;;;;;;EAMhB;;EAEA;;;;;;;;UASgB;;;;;;WAMP,WAAW;;EAEpB,QAAQ,2BAA2B,QAAQ;;EAE3C,UAAU,iBAAiB,YAC1B,0BACA,SAAS,mBACP,QAAQ,eAAe;;EAE1B,aAAa,iBAAiB,YAC7B,YAAY,iBACZ,SAAS,mBACP,eAAe;;EAElB,WAAW,iBAAiB,YAC3B,2BACE,QAAQ,gBAAgB;;EAE3B,cAAc,iBAAiB,YAC9B,YAAY,iBACZ,SAAS,oBACP,gBAAgB;;;iBA6CJ,qBAAqB,QAAQ;;iBAK7B;;;;;;;;;iBAYA,gBACf,gBACA,mDACE;;;;;;;;;cAyBU,iCAAiC;;WAQnC;;WAEA;;WARD;;WAEA;EAET,YAEU;;EAAA,gBAEA;;EAAA"}

package/dist/registry-DIx25Q5s.d.mts

@@ -0,0 +1,255 @@
+import { InferStandardSchema } from "@geekmidas/schema";
+//#region ../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts
+/** The Standard Typed interface. This is a base type extended by other specs. */
+interface StandardTypedV1<Input = unknown, Output = Input> {
+  /** The Standard properties. */
+  readonly "~standard": StandardTypedV1.Props<Input, Output>;
+}
+declare namespace StandardTypedV1 {
+  /** The Standard Typed properties interface. */
+  interface Props<Input = unknown, Output = Input> {
+    /** The version number of the standard. */
+    readonly version: 1;
+    /** The vendor name of the schema library. */
+    readonly vendor: string;
+    /** Inferred types associated with the schema. */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+  /** The Standard Typed types interface. */
+  interface Types<Input = unknown, Output = Input> {
+    /** The input type of the schema. */
+    readonly input: Input;
+    /** The output type of the schema. */
+    readonly output: Output;
+  }
+  /** Infers the input type of a Standard Typed. */
+  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+  /** Infers the output type of a Standard Typed. */
+  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard Schema properties. */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+  /** The Standard Schema properties interface. */
+  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
+    /** Validates unknown input values. */
+    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+  }
+  /** The result interface of the validate function. */
+  type Result<Output> = SuccessResult<Output> | FailureResult;
+  /** The result interface if validation succeeds. */
+  interface SuccessResult<Output> {
+    /** The typed output value. */
+    readonly value: Output;
+    /** A falsy value for `issues` indicates success. */
+    readonly issues?: undefined;
+  }
+  interface Options {
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+  /** The result interface if validation fails. */
+  interface FailureResult {
+    /** The issues of failed validation. */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+  /** The issue interface of the failure output. */
+  interface Issue {
+    /** The error message of the issue. */
+    readonly message: string;
+    /** The path of the issue, if any. */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+  /** The path segment interface of the issue. */
+  interface PathSegment {
+    /** The key representing a path segment. */
+    readonly key: PropertyKey;
+  }
+  /** The Standard types interface. */
+  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
+  /** Infers the input type of a Standard. */
+  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
+  /** Infers the output type of a Standard. */
+  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * Represents a publishable event message with a type and payload.
+ *
+ * @template TType - The event type/name (e.g., 'user.created')
+ * @template TPayload - The event payload data
+ */
+type PublishableMessage<TType extends string, TPayload> = {
+  type: TType;
+  payload: TPayload;
+};
+/**
+ * Event publisher/subscriber types
+ */
+declare enum EventPublisherType {
+  Basic = "basic",
+  EventBridge = "eventbridge",
+  SQS = "sqs",
+  SNS = "sns",
+  Kafka = "kafka",
+  RabbitMQ = "rabbitmq",
+  PgBoss = "pgboss"
+}
+/**
+ * A connection string or connection whose transport nothing here implements —
+ * a typo'd scheme, or one of the listed-but-unbuilt ones (EventBridge, Kafka).
+ */
+declare class UnsupportedEventTransport extends Error {
+  readonly transport: string;
+  readonly role: 'publisher' | 'subscriber' | 'connection';
+  constructor(transport: string, role: 'publisher' | 'subscriber' | 'connection');
+}
+/**
+ * Base interface for event connections
+ * Connections manage the underlying transport (RabbitMQ channel, SQS client, etc.)
+ */
+interface EventConnection {
+  readonly type: EventPublisherType;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  isConnected(): boolean;
+}
+/**
+ * Interface for event publishers that handle the actual publishing of events.
+ * Implementations can send to EventBridge, SQS, Kafka, or any other event system.
+ *
+ * @template TMessage - The union type of all publishable messages
+ */
+type EventPublisher<TMessage extends PublishableMessage<string, any>> = {
+  publish: (message: TMessage[]) => Promise<void>;
+};
+/**
+ * Interface for event subscribers that handle receiving and processing events.
+ *
+ * @template TMessage - The union type of all publishable messages
+ */
+type EventSubscriber<TMessage extends PublishableMessage<string, any>> = {
+  subscribe: (messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>) => Promise<void>;
+};
+/**
+ * Utility type to extract the message from EventPublisher
+ */
+type ExtractPublisherMessage<T> = T extends EventPublisher<infer M> ? M : never;
+type MappedEvent<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined> = {
+  type: ExtractPublisherMessage<T>['type'];
+  payload: (ctx: InferStandardSchema<OutSchema>) => ExtractPublisherMessage<T>['payload'];
+  when?: (ctx: InferStandardSchema<OutSchema>) => boolean;
+};
+//#endregion
+//#region src/Publisher.d.ts
+/** How a publisher is used, beyond the address it reaches. */
+interface PublisherOptions {
+  /**
+   * The topic this publisher fans out to. SNS and RabbitMQ name the topic in
+   * their address already; pg-boss has one address for every topic and queue,
+   * so it is told here that a message goes to every subscriber rather than to
+   * one queue.
+   */
+  topic?: string;
+}
+/**
+ * Publishers for a connection string or a connection, through whichever
+ * driver is registered for its scheme — see `registerEventsDriver`.
+ */
+declare class Publisher {
+  /**
+   * Create a publisher from a connection string
+   * This creates both a connection and a publisher
+   *
+   * @throws {UnregisteredEventsScheme} when the broker's driver is not
+   * registered.
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionStr: EventPublisherConnectionString, options?: PublisherOptions): Promise<EventPublisher<TMessage>>;
+  /**
+   * Create a publisher from an existing connection
+   * This allows sharing connections between publishers and subscribers
+   */
+  static fromConnection<TMessage extends PublishableMessage<string, any>>(connection: EventConnection, options?: PublisherOptions): Promise<EventPublisher<TMessage>>;
+}
+type EventPublisherConnectionString = `${EventPublisherType}://${string}`;
+//#endregion
+//#region src/registry.d.ts
+type AnyMessage = PublishableMessage<string, any>;
+/** How a subscriber built from a connection is used, beyond its address. */
+interface SubscriberOptions {
+  /**
+   * The topic subscribed to. pg-boss needs it, with {@link subscription}, to
+   * give each subscriber a queue of its own; the other brokers carry the topic
+   * in their address and ignore it.
+   */
+  topic?: string;
+  /** The subscriber's name — its own queue on pg-boss. */
+  subscription?: string;
+}
+/**
+ * One broker: the connections, publishers and subscribers for its scheme.
+ *
+ * A driver owns parsing — the shape of an `sns://` string is SNS's business —
+ * and is the only module that imports its broker's client library.
+ */
+interface EventsDriver {
+  /**
+   * The scheme this driver handles, without the colon — `'pgboss'`, `'sns'`.
+   * It is also the `type` of every connection the driver builds, which is how
+   * a connection finds its way back here.
+   */
+  readonly scheme: `${EventPublisherType}`;
+  /** A connection, connected, for a connection string. */
+  connect(connectionString: string): Promise<EventConnection>;
+  /** A publisher, with a connection of its own, for a connection string. */
+  publisher<TMessage extends AnyMessage>(connectionString: string, options: PublisherOptions): Promise<EventPublisher<TMessage>>;
+  /** A publisher on a connection this driver built. */
+  publisherFor<TMessage extends AnyMessage>(connection: EventConnection, options: PublisherOptions): EventPublisher<TMessage>;
+  /** A subscriber, with a connection of its own, for a connection string. */
+  subscriber<TMessage extends AnyMessage>(connectionString: string): Promise<EventSubscriber<TMessage>>;
+  /** A subscriber on a connection this driver built. */
+  subscriberFor<TMessage extends AnyMessage>(connection: EventConnection, options: SubscriberOptions): EventSubscriber<TMessage>;
+}
+/** Make a driver available to `Publisher`, `Subscriber` and friends. Idempotent. */
+declare function registerEventsDriver(driver: EventsDriver): void;
+/** Which schemes are currently registered — the useful half of a failure. */
+declare function registeredEventsSchemes(): string[];
+/**
+ * The driver for a scheme — `'pgboss'`, `'pgboss:'`, or a whole connection
+ * string, whichever the caller has.
+ *
+ * @throws {UnregisteredEventsScheme} when the scheme is a broker this package
+ * implements but nothing registered its driver.
+ * @throws {UnsupportedEventTransport} when no broker here has that scheme.
+ */
+declare function eventsDriverFor(scheme: string, role?: 'publisher' | 'subscriber' | 'connection'): EventsDriver;
+/**
+ * A connection string for a broker whose driver nothing registered.
+ *
+ * The broker exists — this is not a typo'd scheme — but the process was never
+ * told about it. Usually a script building its own publisher, or a build that
+ * registered the drivers for a different target than the one that composed
+ * the connection string.
+ */
+declare class UnregisteredEventsScheme extends Error {
+  /** The scheme with no driver, without the colon — `'pgboss'`. */
+  readonly scheme: string;
+  /** What is registered, so the caller can see what was chosen instead. */
+  readonly registered: readonly string[];
+  /** The subpath that exports the missing driver. */
+  readonly subpath: string;
+  /** The driver's export name. */
+  readonly driver: string;
+  constructor(
+  /** The scheme with no driver, without the colon — `'pgboss'`. */
+  scheme: string,
+  /** What is registered, so the caller can see what was chosen instead. */
+  registered: readonly string[]);
+}
+//#endregion
+export { UnsupportedEventTransport as _, registerEventsDriver as a, Publisher as c, EventPublisher as d, EventPublisherType as f, PublishableMessage as g, MappedEvent as h, eventsDriverFor as i, PublisherOptions as l, ExtractPublisherMessage as m, SubscriberOptions as n, registeredEventsSchemes as o, EventSubscriber as p, UnregisteredEventsScheme as r, EventPublisherConnectionString as s, EventsDriver as t, EventConnection as u };
+//# sourceMappingURL=registry-DIx25Q5s.d.mts.map

package/dist/registry-DIx25Q5s.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DIx25Q5s.d.mts","names":[],"sources":["../../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts","../src/types.ts","../src/Publisher.ts","../src/registry.ts"],"x_google_ignoreList":[0],"mappings":";;;UACU,gBAAgB,iBAAiB,SAAS;;WAEvC,aAAa,gBAAgB,MAAM,OAAO;;kBAErC;;YAEJ,MAAM,iBAAiB,SAAS;;aAE7B;;aAEA;;aAEA,QAAQ,MAAM,OAAO;;;YAGxB,MAAM,iBAAiB,SAAS;;aAE7B,OAAO;;aAEP,QAAQ;;;OAGhB,WAAW,eAAe,mBAAmB,YAAY;;OAEzD,YAAY,eAAe,mBAAmB,YAAY;;;UAGzD,iBAAiB,iBAAiB,SAAS;;WAExC,aAAa,iBAAiB,MAAM,OAAO;;kBAEtC;;YAEJ,MAAM,iBAAiB,SAAS,eAAe,gBAAgB,MAAM,OAAO;;aAEzE,WAAW,gBAAgB,UAAU,iBAAiB,wBAAwB,OAAO,UAAU,QAAQ,OAAO;;;OAGtH,OAAO,UAAU,cAAc,UAAU;;YAEpC,cAAc;;aAEX,OAAO;;aAEP;;YAEH;;aAEG,iBAAiB;;;YAGpB;;aAEG,QAAQ,cAAc;;;YAGzB;;aAEG;;aAEA,OAAO,cAAc,cAAc;;;YAGtC;;aAEG,KAAK;;;YAGR,MAAM,iBAAiB,SAAS,eAAe,gBAAgB,MAAM,OAAO;;OAGjF,WAAW,eAAe,mBAAmB,gBAAgB,WAAW;;OAExE,YAAY,eAAe,mBAAmB,gBAAgB,YAAY;;;;;;;;;;KCjEvE,mBAAmB,sBAAsB;EACpD,MAAM;EACN,SAAS;;;;;aAME;EACX;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;cAgBY,kCAAkC;WAEpC;WACA;EAFV,YACU,mBACA;;;;;;UAaM;WACP,MAAM;EACf,WAAW;EACX,SAAS;EACT;;;;;;;;KASW,eAAe,iBAAiB;EAC3C,UAAU,SAAS,eAAe;;;;;;;KAQvB,gBAAgB,iBAAiB;EAE3C,YACC,UAAU,oBACV,WAAW,SAAS,aAAa,kBAC7B;;;;;KAKK,wBAAwB,KACnC,UAAU,qBAAqB,KAAK;KAEzB,YACX,UAAU,iCACV,kBAAkB;EAElB,MAAM,wBAAwB;EAC9B,UACC,KAAK,oBAAoB,eACrB,wBAAwB;EAC7B,QAAQ,KAAK,oBAAoB;;;;;UC1FjB;;;;;;;EAOhB;;;;;;cAOY;;;;;;;;SAQC,qBACZ,iBAAiB,iCAEjB,eAAe,gCACf,UAAS,mBACP,QAAQ,eAAe;;;;;SAYb,eAAe,iBAAiB,iCAC5C,YAAY,iBACZ,UAAS,mBACP,QAAQ,eAAe;;KAQf,oCACR;;;KCrCC,aAAa;;UAGD;;;;;;EAMhB;;EAEA;;;;;;;;UASgB;;;;;;WAMP,WAAW;;EAEpB,QAAQ,2BAA2B,QAAQ;;EAE3C,UAAU,iBAAiB,YAC1B,0BACA,SAAS,mBACP,QAAQ,eAAe;;EAE1B,aAAa,iBAAiB,YAC7B,YAAY,iBACZ,SAAS,mBACP,eAAe;;EAElB,WAAW,iBAAiB,YAC3B,2BACE,QAAQ,gBAAgB;;EAE3B,cAAc,iBAAiB,YAC9B,YAAY,iBACZ,SAAS,oBACP,gBAAgB;;;iBA6CJ,qBAAqB,QAAQ;;iBAK7B;;;;;;;;;iBAYA,gBACf,gBACA,mDACE;;;;;;;;;cAyBU,iCAAiC;;WAQnC;;WAEA;;WARD;;WAEA;EAET,YAEU;;EAAA,gBAEA;;EAAA"}

package/dist/registry-DXLY1Xf6.mjs

@@ -0,0 +1,99 @@
+import { d as UnsupportedEventTransport } from "./telemetry-DjjgJMul.mjs";
+//#region src/registry.ts
+/**
+* Where each built-in driver lives, so a missing one can be named exactly —
+* the subpath to import and the export to register.
+*/
+const BUILT_IN = {
+	["basic"]: {
+		subpath: "@geekmidas/events/basic",
+		driver: "basicEventsDriver"
+	},
+	["pgboss"]: {
+		subpath: "@geekmidas/events/pgboss",
+		driver: "pgbossEventsDriver"
+	},
+	["sns"]: {
+		subpath: "@geekmidas/events/sns",
+		driver: "snsEventsDriver"
+	},
+	["sqs"]: {
+		subpath: "@geekmidas/events/sqs",
+		driver: "sqsEventsDriver"
+	},
+	["rabbitmq"]: {
+		subpath: "@geekmidas/events/rabbitmq",
+		driver: "rabbitmqEventsDriver"
+	}
+};
+/**
+* The registry lives on `globalThis`, so one registration is seen by every
+* copy of this module — the ESM and the CJS build of one install, which a
+* process can load side by side, as `Credentials` already has to allow for.
+*/
+const REGISTRY = Symbol.for("@geekmidas/events/drivers");
+function drivers() {
+	const global = globalThis;
+	global[REGISTRY] ??= /* @__PURE__ */ new Map();
+	return global[REGISTRY];
+}
+/** Make a driver available to `Publisher`, `Subscriber` and friends. Idempotent. */
+function registerEventsDriver(driver) {
+	drivers().set(driver.scheme, driver);
+}
+/** Which schemes are currently registered — the useful half of a failure. */
+function registeredEventsSchemes() {
+	return [...drivers().keys()].sort();
+}
+/**
+* The driver for a scheme — `'pgboss'`, `'pgboss:'`, or a whole connection
+* string, whichever the caller has.
+*
+* @throws {UnregisteredEventsScheme} when the scheme is a broker this package
+* implements but nothing registered its driver.
+* @throws {UnsupportedEventTransport} when no broker here has that scheme.
+*/
+function eventsDriverFor(scheme, role = "connection") {
+	const name = schemeOf(scheme);
+	const driver = drivers().get(name);
+	if (driver) return driver;
+	if (BUILT_IN[name]) throw new UnregisteredEventsScheme(name, registeredEventsSchemes());
+	throw new UnsupportedEventTransport(name, role);
+}
+/** `pgboss` from `pgboss`, `pgboss:` or `pgboss://…`. */
+function schemeOf(value) {
+	const separator = value.indexOf(":");
+	return separator === -1 ? value : value.slice(0, separator);
+}
+/**
+* A connection string for a broker whose driver nothing registered.
+*
+* The broker exists — this is not a typo'd scheme — but the process was never
+* told about it. Usually a script building its own publisher, or a build that
+* registered the drivers for a different target than the one that composed
+* the connection string.
+*/
+var UnregisteredEventsScheme = class extends Error {
+	scheme;
+	registered;
+	/** The subpath that exports the missing driver. */
+	subpath;
+	/** The driver's export name. */
+	driver;
+	constructor(scheme, registered) {
+		const { subpath, driver } = BUILT_IN[scheme] ?? {
+			subpath: `@geekmidas/events/${scheme}`,
+			driver: `${scheme}EventsDriver`
+		};
+		super(`No events driver is registered for '${scheme}://'. ` + (registered.length ? `Registered: ${registered.join(", ")}. ` : "Nothing is registered. ") + `Register it once where the process starts: import { registerEventsDriver } from '@geekmidas/events'; import { ${driver} } from '${subpath}'; registerEventsDriver(${driver});`);
+		this.scheme = scheme;
+		this.registered = registered;
+		this.name = "UnregisteredEventsScheme";
+		this.subpath = subpath;
+		this.driver = driver;
+	}
+};
+//#endregion
+export { registeredEventsSchemes as i, eventsDriverFor as n, registerEventsDriver as r, UnregisteredEventsScheme as t };
+
+//# sourceMappingURL=registry-DXLY1Xf6.mjs.map

package/dist/registry-DXLY1Xf6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DXLY1Xf6.mjs","names":[],"sources":["../src/registry.ts"],"sourcesContent":["/**\n * Events drivers, keyed by connection-string scheme.\n *\n * The same shape `@geekmidas/storage` and `@geekmidas/cache` use, for the same\n * reason: a topic or a queue is handed one connection string, and the scheme in\n * it (`pgboss://`, `sns://`, …) picks the broker. Which brokers exist is the\n * entry point's decision — a generated server registering pg-boss, a Lambda\n * registering SNS and SQS — so a bundle only ever contains the broker its\n * target uses, and never resolves the others' optional peer dependencies.\n *\n * Registration is explicit rather than an import side effect, because a\n * side-effecting module is exactly what a bundler is entitled to drop.\n */\n\nimport type { PublisherOptions } from './Publisher';\nimport type {\n\tEventConnection,\n\tEventPublisher,\n\tEventSubscriber,\n\tPublishableMessage,\n} from './types';\nimport { EventPublisherType, UnsupportedEventTransport } from './types';\n\ntype AnyMessage = PublishableMessage<string, any>;\n\n/** How a subscriber built from a connection is used, beyond its address. */\nexport interface SubscriberOptions {\n\t/**\n\t * The topic subscribed to. pg-boss needs it, with {@link subscription}, to\n\t * give each subscriber a queue of its own; the other brokers carry the topic\n\t * in their address and ignore it.\n\t */\n\ttopic?: string;\n\t/** The subscriber's name — its own queue on pg-boss. */\n\tsubscription?: string;\n}\n\n/**\n * One broker: the connections, publishers and subscribers for its scheme.\n *\n * A driver owns parsing — the shape of an `sns://` string is SNS's business —\n * and is the only module that imports its broker's client library.\n */\nexport interface EventsDriver {\n\t/**\n\t * The scheme this driver handles, without the colon — `'pgboss'`, `'sns'`.\n\t * It is also the `type` of every connection the driver builds, which is how\n\t * a connection finds its way back here.\n\t */\n\treadonly scheme: `${EventPublisherType}`;\n\t/** A connection, connected, for a connection string. */\n\tconnect(connectionString: string): Promise<EventConnection>;\n\t/** A publisher, with a connection of its own, for a connection string. */\n\tpublisher<TMessage extends AnyMessage>(\n\t\tconnectionString: string,\n\t\toptions: PublisherOptions,\n\t): Promise<EventPublisher<TMessage>>;\n\t/** A publisher on a connection this driver built. */\n\tpublisherFor<TMessage extends AnyMessage>(\n\t\tconnection: EventConnection,\n\t\toptions: PublisherOptions,\n\t): EventPublisher<TMessage>;\n\t/** A subscriber, with a connection of its own, for a connection string. */\n\tsubscriber<TMessage extends AnyMessage>(\n\t\tconnectionString: string,\n\t): Promise<EventSubscriber<TMessage>>;\n\t/** A subscriber on a connection this driver built. */\n\tsubscriberFor<TMessage extends AnyMessage>(\n\t\tconnection: EventConnection,\n\t\toptions: SubscriberOptions,\n\t): EventSubscriber<TMessage>;\n}\n\n/**\n * Where each built-in driver lives, so a missing one can be named exactly —\n * the subpath to import and the export to register.\n */\nconst BUILT_IN: Readonly<Record<string, { subpath: string; driver: string }>> =\n\t{\n\t\t[EventPublisherType.Basic]: {\n\t\t\tsubpath: '@geekmidas/events/basic',\n\t\t\tdriver: 'basicEventsDriver',\n\t\t},\n\t\t[EventPublisherType.PgBoss]: {\n\t\t\tsubpath: '@geekmidas/events/pgboss',\n\t\t\tdriver: 'pgbossEventsDriver',\n\t\t},\n\t\t[EventPublisherType.SNS]: {\n\t\t\tsubpath: '@geekmidas/events/sns',\n\t\t\tdriver: 'snsEventsDriver',\n\t\t},\n\t\t[EventPublisherType.SQS]: {\n\t\t\tsubpath: '@geekmidas/events/sqs',\n\t\t\tdriver: 'sqsEventsDriver',\n\t\t},\n\t\t[EventPublisherType.RabbitMQ]: {\n\t\t\tsubpath: '@geekmidas/events/rabbitmq',\n\t\t\tdriver: 'rabbitmqEventsDriver',\n\t\t},\n\t};\n\n/**\n * The registry lives on `globalThis`, so one registration is seen by every\n * copy of this module — the ESM and the CJS build of one install, which a\n * process can load side by side, as `Credentials` already has to allow for.\n */\nconst REGISTRY = Symbol.for('@geekmidas/events/drivers');\n\nfunction drivers(): Map<string, EventsDriver> {\n\tconst global = globalThis as { [REGISTRY]?: Map<string, EventsDriver> };\n\tglobal[REGISTRY] ??= new Map();\n\treturn global[REGISTRY];\n}\n\n/** Make a driver available to `Publisher`, `Subscriber` and friends. Idempotent. */\nexport function registerEventsDriver(driver: EventsDriver): void {\n\tdrivers().set(driver.scheme, driver);\n}\n\n/** Which schemes are currently registered — the useful half of a failure. */\nexport function registeredEventsSchemes(): string[] {\n\treturn [...drivers().keys()].sort();\n}\n\n/**\n * The driver for a scheme — `'pgboss'`, `'pgboss:'`, or a whole connection\n * string, whichever the caller has.\n *\n * @throws {UnregisteredEventsScheme} when the scheme is a broker this package\n * implements but nothing registered its driver.\n * @throws {UnsupportedEventTransport} when no broker here has that scheme.\n */\nexport function eventsDriverFor(\n\tscheme: string,\n\trole: 'publisher' | 'subscriber' | 'connection' = 'connection',\n): EventsDriver {\n\tconst name = schemeOf(scheme);\n\tconst driver = drivers().get(name);\n\tif (driver) return driver;\n\n\tif (BUILT_IN[name]) {\n\t\tthrow new UnregisteredEventsScheme(name, registeredEventsSchemes());\n\t}\n\tthrow new UnsupportedEventTransport(name, role);\n}\n\n/** `pgboss` from `pgboss`, `pgboss:` or `pgboss://…`. */\nfunction schemeOf(value: string): string {\n\tconst separator = value.indexOf(':');\n\treturn separator === -1 ? value : value.slice(0, separator);\n}\n\n/**\n * A connection string for a broker whose driver nothing registered.\n *\n * The broker exists — this is not a typo'd scheme — but the process was never\n * told about it. Usually a script building its own publisher, or a build that\n * registered the drivers for a different target than the one that composed\n * the connection string.\n */\nexport class UnregisteredEventsScheme extends Error {\n\t/** The subpath that exports the missing driver. */\n\treadonly subpath: string;\n\t/** The driver's export name. */\n\treadonly driver: string;\n\n\tconstructor(\n\t\t/** The scheme with no driver, without the colon — `'pgboss'`. */\n\t\treadonly scheme: string,\n\t\t/** What is registered, so the caller can see what was chosen instead. */\n\t\treadonly registered: readonly string[],\n\t) {\n\t\tconst { subpath, driver } = BUILT_IN[scheme] ?? {\n\t\t\tsubpath: `@geekmidas/events/${scheme}`,\n\t\t\tdriver: `${scheme}EventsDriver`,\n\t\t};\n\t\tsuper(\n\t\t\t`No events driver is registered for '${scheme}://'. ` +\n\t\t\t\t(registered.length\n\t\t\t\t\t? `Registered: ${registered.join(', ')}. `\n\t\t\t\t\t: 'Nothing is registered. ') +\n\t\t\t\t`Register it once where the process starts: ` +\n\t\t\t\t`import { registerEventsDriver } from '@geekmidas/events'; ` +\n\t\t\t\t`import { ${driver} } from '${subpath}'; ` +\n\t\t\t\t`registerEventsDriver(${driver});`,\n\t\t);\n\t\tthis.name = 'UnregisteredEventsScheme';\n\t\tthis.subpath = subpath;\n\t\tthis.driver = driver;\n\t}\n}\n"],"mappings":";;;;;;AA6EA,MAAM,WACL;EAC6B,UAAA;EAC3B,SAAS;EACT,QAAQ;CACT;EAC6B,WAAA;EAC5B,SAAS;EACT,QAAQ;CACT;EAC0B,QAAA;EACzB,SAAS;EACT,QAAQ;CACT;EAC0B,QAAA;EACzB,SAAS;EACT,QAAQ;CACT;EAC+B,aAAA;EAC9B,SAAS;EACT,QAAQ;CACT;AACD;;;;;;AAOD,MAAM,WAAW,OAAO,IAAI,2BAA2B;AAEvD,SAAS,UAAqC;CAC7C,MAAM,SAAS;CACf,OAAO,8BAAc,IAAI,IAAI;CAC7B,OAAO,OAAO;AACf;;AAGA,SAAgB,qBAAqB,QAA4B;CAChE,QAAQ,CAAC,CAAC,IAAI,OAAO,QAAQ,MAAM;AACpC;;AAGA,SAAgB,0BAAoC;CACnD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;AACnC;;;;;;;;;AAUA,SAAgB,gBACf,QACA,OAAkD,cACnC;CACf,MAAM,OAAO,SAAS,MAAM;CAC5B,MAAM,SAAS,QAAQ,CAAC,CAAC,IAAI,IAAI;CACjC,IAAI,QAAQ,OAAO;CAEnB,IAAI,SAAS,OACZ,MAAM,IAAI,yBAAyB,MAAM,wBAAwB,CAAC;CAEnE,MAAM,IAAI,0BAA0B,MAAM,IAAI;AAC/C;;AAGA,SAAS,SAAS,OAAuB;CACxC,MAAM,YAAY,MAAM,QAAQ,GAAG;CACnC,OAAO,cAAc,KAAK,QAAQ,MAAM,MAAM,GAAG,SAAS;AAC3D;;;;;;;;;AAUA,IAAa,2BAAb,cAA8C,MAAM;CAQzC;CAEA;;CARV;;CAEA;CAEA,YAEC,QAEA,YACC;EACD,MAAM,EAAE,SAAS,WAAW,SAAS,WAAW;GAC/C,SAAS,qBAAqB;GAC9B,QAAQ,GAAG,OAAO;EACnB;EACA,MACC,uCAAuC,OAAO,WAC5C,WAAW,SACT,eAAe,WAAW,KAAK,IAAI,EAAE,MACrC,6BACH,iHAEY,OAAO,WAAW,QAAQ,0BACd,OAAO,GACjC;EAjBS,KAAA,SAAA;EAEA,KAAA,aAAA;EAgBT,KAAK,OAAO;EACZ,KAAK,UAAU;EACf,KAAK,SAAS;CACf;AACD"}