@walkeros/server-destination-aws 4.7.0-next-1790722899482 → 4.7.0

package/dist/index.d.mts

@@ -5,84 +5,180 @@ import { SNSClientConfig, CreateTopicCommandInput, PublishCommandInput, GetTopic
 import { STSClientConfig, GetCallerIdentityCommandInput } from '@aws-sdk/client-sts';
 
 /**
- * The part of an AWS SDK v3 client this destination calls: `send` with a
- * command. `FirehoseClient` satisfies it, and so does an injected mock (tests,
- * simulate) without a cast.
+ * The part of an AWS SDK v3 client this package calls: `send` with a command,
+ * and `destroy` on a client it created. The SDK clients satisfy it, and so
+ * does an injected mock (tests, simulate) without a cast.
  */
-interface SendClient$1 {
+interface SendClient {
     send(command: object): Promise<unknown>;
+    destroy?(): void;
 }
-interface Settings$1 {
+/**
+ * Tracks the sends an instance has in flight, so `destroy` can let them land
+ * before it closes the client under them.
+ */
+declare class InFlight {
+    private readonly pending;
+    track<T>(promise: Promise<T>): Promise<T>;
+    get size(): number;
+    /** Resolves once every tracked send settled, whatever its outcome. */
+    settle(): Promise<void>;
+}
+
+/**
+ * Static AWS keys, the shape `config.credentials` takes. Back each value with
+ * `$secret`; a literal key in a flow file is a leaked key.
+ */
+interface AwsCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+/** `config.credentials` as written: the object, or the same object as JSON. */
+type CredentialsInput = AwsCredentials | string;
+
+/** Client and stream options, as the deprecated `settings.firehose` held them. */
+interface FirehoseConfig {
+    streamName?: string;
+    client?: SendClient;
+    region?: string;
+    config?: FirehoseClientConfig;
+}
+/**
+ * Settings as a user writes them. Only `streamName` is required (here or in
+ * the deprecated `firehose` alias); `init` fills in the rest.
+ */
+interface InitSettings$1 {
+    /** Name of the Firehose stream. */
+    streamName?: string;
+    /** AWS region. Default: `AWS_REGION` or the profile, else `eu-central-1`. */
+    region?: string;
+    /** Append `\n` to every record. Default `true`. */
+    newline?: boolean;
+    /** Raw `FirehoseClient` options, passed through to the SDK. */
+    config?: FirehoseClientConfig;
+    /** A client of your own. Used as is and never closed by the destination. */
+    client?: SendClient;
+    /** @deprecated Use the flat fields. Read at `init` as an alias. */
     firehose?: FirehoseConfig;
+    /** Runtime-only, set by `init`: what the destination owns. Not user-facing. */
+    runtime?: Runtime$1;
+}
+/** What `init` resolved. Every field is present. */
+interface Settings$1 {
+    streamName: string;
+    region: string;
+    newline: boolean;
+    config?: FirehoseClientConfig;
+    client: SendClient;
+    runtime: Runtime$1;
 }
-type InitSettings$1 = Partial<Settings$1>;
+/** Runtime-only state of one initialized instance. */
+interface Runtime$1 {
+    /**
+     * True when the destination built the client from nothing the user owns,
+     * and so closes it. A user client, or a user request handler instance in
+     * `settings.config`, keeps it false.
+     */
+    ownsClient: boolean;
+    /** Sends in flight, awaited by `destroy`. */
+    inflight: InFlight;
+    /** Where the client's credentials come from, for the debug line. */
+    credentialSource: CredentialSource;
+}
+type CredentialSource = 'config.credentials' | 'settings.config.credentials' | 'default chain' | 'client';
 interface Mapping$1 {
 }
+type FirehoseClientConstructor = new (config: FirehoseClientConfig) => SendClient;
+type PutRecordBatchCommandConstructor = new (input: PutRecordBatchCommandInput) => {
+    readonly input: PutRecordBatchCommandInput;
+};
+/**
+ * Optional SDK overrides. Each one present wins over the SDK the package
+ * imports; tests and simulate inject mocks here.
+ */
 interface Env$1 extends DestinationServer.Env {
-    AWS: {
-        FirehoseClient: new (config: FirehoseClientConfig) => SendClient$1;
-        PutRecordBatchCommand: new (input: PutRecordBatchCommandInput) => {
-            readonly input: PutRecordBatchCommandInput;
-        };
+    AWS?: {
+        FirehoseClient?: FirehoseClientConstructor;
+        PutRecordBatchCommand?: PutRecordBatchCommandConstructor;
     };
 }
-type Types$1 = Destination$2.Types<Settings$1, Mapping$1, Env$1, InitSettings$1>;
+type Types$1 = Destination$2.Types<Settings$1, Mapping$1, Env$1, InitSettings$1, unknown, CredentialsInput>;
 interface Destination$1 extends DestinationServer.Destination<Types$1> {
-    init: DestinationServer.InitFn<Types$1>;
+    init: InitFn$1;
+    pushBatch: PushBatchFn;
 }
 type Config$1 = {
-    settings: Settings$1;
+    settings: InitSettings$1;
 } & DestinationServer.Config<Types$1>;
 type InitFn$1 = DestinationServer.InitFn<Types$1>;
 type PushFn$1 = DestinationServer.PushFn<Types$1>;
+type PushBatchFn = Destination$2.PushBatchFn<Types$1>;
 type PartialConfig$1 = DestinationServer.PartialConfig<Types$1>;
 type PushEvents$1 = DestinationServer.PushEvents<Mapping$1>;
 type Rule$1 = Mapping$2.Rule<Mapping$1>;
 type Rules$1 = Mapping$2.Rules<Rule$1>;
-interface FirehoseConfig {
-    streamName: string;
-    client?: SendClient$1;
-    region?: string;
-    config?: FirehoseClientConfig;
-}
 
+type index$1_CredentialSource = CredentialSource;
+type index$1_FirehoseClientConstructor = FirehoseClientConstructor;
 type index$1_FirehoseConfig = FirehoseConfig;
+type index$1_PushBatchFn = PushBatchFn;
+type index$1_PutRecordBatchCommandConstructor = PutRecordBatchCommandConstructor;
+type index$1_SendClient = SendClient;
 declare namespace index$1 {
-  export type { Config$1 as Config, Destination$1 as Destination, Env$1 as Env, index$1_FirehoseConfig as FirehoseConfig, InitFn$1 as InitFn, InitSettings$1 as InitSettings, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, PushEvents$1 as PushEvents, PushFn$1 as PushFn, Rule$1 as Rule, Rules$1 as Rules, SendClient$1 as SendClient, Settings$1 as Settings, Types$1 as Types };
+  export type { Config$1 as Config, index$1_CredentialSource as CredentialSource, Destination$1 as Destination, Env$1 as Env, index$1_FirehoseClientConstructor as FirehoseClientConstructor, index$1_FirehoseConfig as FirehoseConfig, InitFn$1 as InitFn, InitSettings$1 as InitSettings, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, index$1_PushBatchFn as PushBatchFn, PushEvents$1 as PushEvents, PushFn$1 as PushFn, index$1_PutRecordBatchCommandConstructor as PutRecordBatchCommandConstructor, Rule$1 as Rule, Rules$1 as Rules, Runtime$1 as Runtime, index$1_SendClient as SendClient, Settings$1 as Settings, Types$1 as Types };
 }
 
-declare const destinationFirehose: Destination$1;
-
 /**
- * The part of an AWS SDK v3 client this destination calls: `send` with a
- * command. `SNSClient` and `STSClient` satisfy it, and so does an injected
- * mock (tests, simulate) without a cast.
+ * The Firehose destination. Batching is on by default: a flushed batch goes
+ * out as `PutRecordBatch` calls of at most 500 records.
  */
-interface SendClient {
-    send(command: object): Promise<unknown>;
-}
+declare const destinationFirehose: Destination$1;
+
 /** An AWS SDK v3 command class, as far as this destination builds one. */
 type CommandConstructor<Input> = new (input: Input) => {
     readonly input: Input;
 };
-interface Settings {
-    /** Topic name (without `.fifo` suffix unless fifoTopic is true). REQUIRED. */
-    topicName: string;
-    /** Pre-configured client. Optional; created from env if absent. */
-    client?: SendClient;
-    /** AWS region. Mirrors setup.region default ('eu-central-1'). */
-    region?: string;
-    /** SDK client config (credentials, etc.). Optional. */
-    config?: SNSClientConfig;
-    /** Topic ARN, populated at init() from CreateTopic. Operator may pre-set to skip init's CreateTopic call. */
-    topicArn?: string;
-}
+/**
+ * Settings as a user writes them. `topicArn` alone is enough: region and
+ * topic name derive from it. `topicName` (with `region`) also works, and the
+ * ARN is then completed with the account id at the first publish.
+ */
 interface InitSettings {
-    topicName: string;
-    client?: SendClient;
+    /** Topic ARN. Region and topic name derive from it. */
+    topicArn?: string;
+    /** Topic name (with `.fifo` for FIFO topics). Needed by `walkeros setup`. */
+    topicName?: string;
+    /** AWS region. Default: the ARN's region, `AWS_REGION` or the profile, else `eu-central-1`. */
     region?: string;
+    /** Raw `SNSClient` options, passed through to the SDK. */
     config?: SNSClientConfig;
+    /** A client of your own. Used as is and never closed by the destination. */
+    client?: SendClient;
+    /** Runtime-only, set by `init`: what the destination owns. Not user-facing. */
+    runtime?: Runtime;
+}
+/** What `init` resolved. */
+interface Settings {
     topicArn?: string;
+    topicName?: string;
+    region: string;
+    config?: SNSClientConfig;
+    client: SendClient;
+    runtime: Runtime;
+}
+/** Runtime-only state of one initialized instance. */
+interface Runtime {
+    /**
+     * True when the destination built the client from nothing the user owns,
+     * and so closes it. A user client, or a user request handler instance in
+     * `settings.config`, keeps it false.
+     */
+    ownsClient: boolean;
+    /** Publishes in flight, awaited by `destroy`. */
+    inflight: InFlight;
+    /** The topic ARN, completed once with the account id when only a name was given. */
+    topicArn: () => Promise<string>;
 }
 interface Mapping {
     /**
@@ -98,18 +194,25 @@ interface Mapping {
      * `messageGroupId: 'user.id'` (path) instead of hard-coding a literal.
      */
     messageGroupId?: Mapping$2.Value;
-    /** FIFO deduplication ID. `Mapping.Value`, same reasoning as `messageGroupId`. */
+    /**
+     * FIFO deduplication ID. `Mapping.Value`, same reasoning as
+     * `messageGroupId`. Defaults to the event id on FIFO topics.
+     */
     messageDeduplicationId?: Mapping$2.Value;
 }
+/**
+ * Optional SDK overrides. Each one present wins over the SDK the package
+ * imports; tests and simulate inject mocks here.
+ */
 interface Env extends DestinationServer.Env {
-    AWS: {
-        SNSClient: new (config: SNSClientConfig) => SendClient;
-        CreateTopicCommand: CommandConstructor<CreateTopicCommandInput>;
-        PublishCommand: CommandConstructor<PublishCommandInput>;
-        GetTopicAttributesCommand: CommandConstructor<GetTopicAttributesCommandInput>;
-        SubscribeCommand: CommandConstructor<SubscribeCommandInput>;
-        STSClient: new (config: STSClientConfig) => SendClient;
-        GetCallerIdentityCommand: CommandConstructor<GetCallerIdentityCommandInput>;
+    AWS?: {
+        SNSClient?: new (config: SNSClientConfig) => SendClient;
+        CreateTopicCommand?: CommandConstructor<CreateTopicCommandInput>;
+        PublishCommand?: CommandConstructor<PublishCommandInput>;
+        GetTopicAttributesCommand?: CommandConstructor<GetTopicAttributesCommandInput>;
+        SubscribeCommand?: CommandConstructor<SubscribeCommandInput>;
+        STSClient?: new (config: STSClientConfig) => SendClient;
+        GetCallerIdentityCommand?: CommandConstructor<GetCallerIdentityCommandInput>;
     };
 }
 /**
@@ -119,7 +222,7 @@ interface Env extends DestinationServer.Env {
  * `topicName` lives in Settings (one source of truth for setup AND runtime publish).
  */
 interface Setup {
-    /** AWS region for the topic. Default: 'eu-central-1'. */
+    /** AWS region for the topic. Default: the runtime region order. */
     region?: string;
     /** Display name. Optional. */
     displayName?: string;
@@ -139,20 +242,17 @@ interface SetupSubscription {
     filterPolicy?: Record<string, unknown>;
     deadLetterTargetArn?: string;
 }
-type Types = Destination$2.Types<Settings, Mapping, Env, InitSettings, Setup>;
+type Types = Destination$2.Types<Settings, Mapping, Env, InitSettings, Setup, CredentialsInput>;
 interface Destination extends DestinationServer.Destination<Types> {
     init: DestinationServer.InitFn<Types>;
 }
 type Config = {
-    settings: Settings;
+    settings: InitSettings;
 } & DestinationServer.Config<Types>;
 type InitFn = DestinationServer.InitFn<Types>;
 type PushFn = DestinationServer.PushFn<Types>;
 type SetupFn = SetupFn$1<Config, Env>;
-type PartialConfig = Omit<DestinationServer.PartialConfig<Types>, 'settings' | 'setup'> & {
-    settings?: Partial<Settings> | Settings;
-    setup?: boolean | Setup;
-};
+type PartialConfig = DestinationServer.PartialConfig<Types>;
 type PushEvents = DestinationServer.PushEvents<Mapping>;
 type Rule = Mapping$2.Rule<Mapping>;
 type Rules = Mapping$2.Rules<Rule>;
@@ -169,6 +269,7 @@ type index_PushEvents = PushEvents;
 type index_PushFn = PushFn;
 type index_Rule = Rule;
 type index_Rules = Rules;
+type index_Runtime = Runtime;
 type index_SendClient = SendClient;
 type index_Settings = Settings;
 type index_Setup = Setup;
@@ -176,7 +277,7 @@ type index_SetupFn = SetupFn;
 type index_SetupSubscription = SetupSubscription;
 type index_Types = Types;
 declare namespace index {
-  export type { index_CommandConstructor as CommandConstructor, index_Config as Config, index_Destination as Destination, index_Env as Env, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_Rule as Rule, index_Rules as Rules, index_SendClient as SendClient, index_Settings as Settings, index_Setup as Setup, index_SetupFn as SetupFn, index_SetupSubscription as SetupSubscription, index_Types as Types };
+  export type { index_CommandConstructor as CommandConstructor, index_Config as Config, index_Destination as Destination, index_Env as Env, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_Rule as Rule, index_Rules as Rules, index_Runtime as Runtime, index_SendClient as SendClient, index_Settings as Settings, index_Setup as Setup, index_SetupFn as SetupFn, index_SetupSubscription as SetupSubscription, index_Types as Types };
 }
 
 declare const destinationSNS: Destination;

package/dist/index.d.ts

@@ -5,84 +5,180 @@ import { SNSClientConfig, CreateTopicCommandInput, PublishCommandInput, GetTopic
 import { STSClientConfig, GetCallerIdentityCommandInput } from '@aws-sdk/client-sts';
 
 /**
- * The part of an AWS SDK v3 client this destination calls: `send` with a
- * command. `FirehoseClient` satisfies it, and so does an injected mock (tests,
- * simulate) without a cast.
+ * The part of an AWS SDK v3 client this package calls: `send` with a command,
+ * and `destroy` on a client it created. The SDK clients satisfy it, and so
+ * does an injected mock (tests, simulate) without a cast.
  */
-interface SendClient$1 {
+interface SendClient {
     send(command: object): Promise<unknown>;
+    destroy?(): void;
 }
-interface Settings$1 {
+/**
+ * Tracks the sends an instance has in flight, so `destroy` can let them land
+ * before it closes the client under them.
+ */
+declare class InFlight {
+    private readonly pending;
+    track<T>(promise: Promise<T>): Promise<T>;
+    get size(): number;
+    /** Resolves once every tracked send settled, whatever its outcome. */
+    settle(): Promise<void>;
+}
+
+/**
+ * Static AWS keys, the shape `config.credentials` takes. Back each value with
+ * `$secret`; a literal key in a flow file is a leaked key.
+ */
+interface AwsCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+/** `config.credentials` as written: the object, or the same object as JSON. */
+type CredentialsInput = AwsCredentials | string;
+
+/** Client and stream options, as the deprecated `settings.firehose` held them. */
+interface FirehoseConfig {
+    streamName?: string;
+    client?: SendClient;
+    region?: string;
+    config?: FirehoseClientConfig;
+}
+/**
+ * Settings as a user writes them. Only `streamName` is required (here or in
+ * the deprecated `firehose` alias); `init` fills in the rest.
+ */
+interface InitSettings$1 {
+    /** Name of the Firehose stream. */
+    streamName?: string;
+    /** AWS region. Default: `AWS_REGION` or the profile, else `eu-central-1`. */
+    region?: string;
+    /** Append `\n` to every record. Default `true`. */
+    newline?: boolean;
+    /** Raw `FirehoseClient` options, passed through to the SDK. */
+    config?: FirehoseClientConfig;
+    /** A client of your own. Used as is and never closed by the destination. */
+    client?: SendClient;
+    /** @deprecated Use the flat fields. Read at `init` as an alias. */
     firehose?: FirehoseConfig;
+    /** Runtime-only, set by `init`: what the destination owns. Not user-facing. */
+    runtime?: Runtime$1;
+}
+/** What `init` resolved. Every field is present. */
+interface Settings$1 {
+    streamName: string;
+    region: string;
+    newline: boolean;
+    config?: FirehoseClientConfig;
+    client: SendClient;
+    runtime: Runtime$1;
 }
-type InitSettings$1 = Partial<Settings$1>;
+/** Runtime-only state of one initialized instance. */
+interface Runtime$1 {
+    /**
+     * True when the destination built the client from nothing the user owns,
+     * and so closes it. A user client, or a user request handler instance in
+     * `settings.config`, keeps it false.
+     */
+    ownsClient: boolean;
+    /** Sends in flight, awaited by `destroy`. */
+    inflight: InFlight;
+    /** Where the client's credentials come from, for the debug line. */
+    credentialSource: CredentialSource;
+}
+type CredentialSource = 'config.credentials' | 'settings.config.credentials' | 'default chain' | 'client';
 interface Mapping$1 {
 }
+type FirehoseClientConstructor = new (config: FirehoseClientConfig) => SendClient;
+type PutRecordBatchCommandConstructor = new (input: PutRecordBatchCommandInput) => {
+    readonly input: PutRecordBatchCommandInput;
+};
+/**
+ * Optional SDK overrides. Each one present wins over the SDK the package
+ * imports; tests and simulate inject mocks here.
+ */
 interface Env$1 extends DestinationServer.Env {
-    AWS: {
-        FirehoseClient: new (config: FirehoseClientConfig) => SendClient$1;
-        PutRecordBatchCommand: new (input: PutRecordBatchCommandInput) => {
-            readonly input: PutRecordBatchCommandInput;
-        };
+    AWS?: {
+        FirehoseClient?: FirehoseClientConstructor;
+        PutRecordBatchCommand?: PutRecordBatchCommandConstructor;
     };
 }
-type Types$1 = Destination$2.Types<Settings$1, Mapping$1, Env$1, InitSettings$1>;
+type Types$1 = Destination$2.Types<Settings$1, Mapping$1, Env$1, InitSettings$1, unknown, CredentialsInput>;
 interface Destination$1 extends DestinationServer.Destination<Types$1> {
-    init: DestinationServer.InitFn<Types$1>;
+    init: InitFn$1;
+    pushBatch: PushBatchFn;
 }
 type Config$1 = {
-    settings: Settings$1;
+    settings: InitSettings$1;
 } & DestinationServer.Config<Types$1>;
 type InitFn$1 = DestinationServer.InitFn<Types$1>;
 type PushFn$1 = DestinationServer.PushFn<Types$1>;
+type PushBatchFn = Destination$2.PushBatchFn<Types$1>;
 type PartialConfig$1 = DestinationServer.PartialConfig<Types$1>;
 type PushEvents$1 = DestinationServer.PushEvents<Mapping$1>;
 type Rule$1 = Mapping$2.Rule<Mapping$1>;
 type Rules$1 = Mapping$2.Rules<Rule$1>;
-interface FirehoseConfig {
-    streamName: string;
-    client?: SendClient$1;
-    region?: string;
-    config?: FirehoseClientConfig;
-}
 
+type index$1_CredentialSource = CredentialSource;
+type index$1_FirehoseClientConstructor = FirehoseClientConstructor;
 type index$1_FirehoseConfig = FirehoseConfig;
+type index$1_PushBatchFn = PushBatchFn;
+type index$1_PutRecordBatchCommandConstructor = PutRecordBatchCommandConstructor;
+type index$1_SendClient = SendClient;
 declare namespace index$1 {
-  export type { Config$1 as Config, Destination$1 as Destination, Env$1 as Env, index$1_FirehoseConfig as FirehoseConfig, InitFn$1 as InitFn, InitSettings$1 as InitSettings, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, PushEvents$1 as PushEvents, PushFn$1 as PushFn, Rule$1 as Rule, Rules$1 as Rules, SendClient$1 as SendClient, Settings$1 as Settings, Types$1 as Types };
+  export type { Config$1 as Config, index$1_CredentialSource as CredentialSource, Destination$1 as Destination, Env$1 as Env, index$1_FirehoseClientConstructor as FirehoseClientConstructor, index$1_FirehoseConfig as FirehoseConfig, InitFn$1 as InitFn, InitSettings$1 as InitSettings, Mapping$1 as Mapping, PartialConfig$1 as PartialConfig, index$1_PushBatchFn as PushBatchFn, PushEvents$1 as PushEvents, PushFn$1 as PushFn, index$1_PutRecordBatchCommandConstructor as PutRecordBatchCommandConstructor, Rule$1 as Rule, Rules$1 as Rules, Runtime$1 as Runtime, index$1_SendClient as SendClient, Settings$1 as Settings, Types$1 as Types };
 }
 
-declare const destinationFirehose: Destination$1;
-
 /**
- * The part of an AWS SDK v3 client this destination calls: `send` with a
- * command. `SNSClient` and `STSClient` satisfy it, and so does an injected
- * mock (tests, simulate) without a cast.
+ * The Firehose destination. Batching is on by default: a flushed batch goes
+ * out as `PutRecordBatch` calls of at most 500 records.
  */
-interface SendClient {
-    send(command: object): Promise<unknown>;
-}
+declare const destinationFirehose: Destination$1;
+
 /** An AWS SDK v3 command class, as far as this destination builds one. */
 type CommandConstructor<Input> = new (input: Input) => {
     readonly input: Input;
 };
-interface Settings {
-    /** Topic name (without `.fifo` suffix unless fifoTopic is true). REQUIRED. */
-    topicName: string;
-    /** Pre-configured client. Optional; created from env if absent. */
-    client?: SendClient;
-    /** AWS region. Mirrors setup.region default ('eu-central-1'). */
-    region?: string;
-    /** SDK client config (credentials, etc.). Optional. */
-    config?: SNSClientConfig;
-    /** Topic ARN, populated at init() from CreateTopic. Operator may pre-set to skip init's CreateTopic call. */
-    topicArn?: string;
-}
+/**
+ * Settings as a user writes them. `topicArn` alone is enough: region and
+ * topic name derive from it. `topicName` (with `region`) also works, and the
+ * ARN is then completed with the account id at the first publish.
+ */
 interface InitSettings {
-    topicName: string;
-    client?: SendClient;
+    /** Topic ARN. Region and topic name derive from it. */
+    topicArn?: string;
+    /** Topic name (with `.fifo` for FIFO topics). Needed by `walkeros setup`. */
+    topicName?: string;
+    /** AWS region. Default: the ARN's region, `AWS_REGION` or the profile, else `eu-central-1`. */
     region?: string;
+    /** Raw `SNSClient` options, passed through to the SDK. */
     config?: SNSClientConfig;
+    /** A client of your own. Used as is and never closed by the destination. */
+    client?: SendClient;
+    /** Runtime-only, set by `init`: what the destination owns. Not user-facing. */
+    runtime?: Runtime;
+}
+/** What `init` resolved. */
+interface Settings {
     topicArn?: string;
+    topicName?: string;
+    region: string;
+    config?: SNSClientConfig;
+    client: SendClient;
+    runtime: Runtime;
+}
+/** Runtime-only state of one initialized instance. */
+interface Runtime {
+    /**
+     * True when the destination built the client from nothing the user owns,
+     * and so closes it. A user client, or a user request handler instance in
+     * `settings.config`, keeps it false.
+     */
+    ownsClient: boolean;
+    /** Publishes in flight, awaited by `destroy`. */
+    inflight: InFlight;
+    /** The topic ARN, completed once with the account id when only a name was given. */
+    topicArn: () => Promise<string>;
 }
 interface Mapping {
     /**
@@ -98,18 +194,25 @@ interface Mapping {
      * `messageGroupId: 'user.id'` (path) instead of hard-coding a literal.
      */
     messageGroupId?: Mapping$2.Value;
-    /** FIFO deduplication ID. `Mapping.Value`, same reasoning as `messageGroupId`. */
+    /**
+     * FIFO deduplication ID. `Mapping.Value`, same reasoning as
+     * `messageGroupId`. Defaults to the event id on FIFO topics.
+     */
     messageDeduplicationId?: Mapping$2.Value;
 }
+/**
+ * Optional SDK overrides. Each one present wins over the SDK the package
+ * imports; tests and simulate inject mocks here.
+ */
 interface Env extends DestinationServer.Env {
-    AWS: {
-        SNSClient: new (config: SNSClientConfig) => SendClient;
-        CreateTopicCommand: CommandConstructor<CreateTopicCommandInput>;
-        PublishCommand: CommandConstructor<PublishCommandInput>;
-        GetTopicAttributesCommand: CommandConstructor<GetTopicAttributesCommandInput>;
-        SubscribeCommand: CommandConstructor<SubscribeCommandInput>;
-        STSClient: new (config: STSClientConfig) => SendClient;
-        GetCallerIdentityCommand: CommandConstructor<GetCallerIdentityCommandInput>;
+    AWS?: {
+        SNSClient?: new (config: SNSClientConfig) => SendClient;
+        CreateTopicCommand?: CommandConstructor<CreateTopicCommandInput>;
+        PublishCommand?: CommandConstructor<PublishCommandInput>;
+        GetTopicAttributesCommand?: CommandConstructor<GetTopicAttributesCommandInput>;
+        SubscribeCommand?: CommandConstructor<SubscribeCommandInput>;
+        STSClient?: new (config: STSClientConfig) => SendClient;
+        GetCallerIdentityCommand?: CommandConstructor<GetCallerIdentityCommandInput>;
     };
 }
 /**
@@ -119,7 +222,7 @@ interface Env extends DestinationServer.Env {
  * `topicName` lives in Settings (one source of truth for setup AND runtime publish).
  */
 interface Setup {
-    /** AWS region for the topic. Default: 'eu-central-1'. */
+    /** AWS region for the topic. Default: the runtime region order. */
     region?: string;
     /** Display name. Optional. */
     displayName?: string;
@@ -139,20 +242,17 @@ interface SetupSubscription {
     filterPolicy?: Record<string, unknown>;
     deadLetterTargetArn?: string;
 }
-type Types = Destination$2.Types<Settings, Mapping, Env, InitSettings, Setup>;
+type Types = Destination$2.Types<Settings, Mapping, Env, InitSettings, Setup, CredentialsInput>;
 interface Destination extends DestinationServer.Destination<Types> {
     init: DestinationServer.InitFn<Types>;
 }
 type Config = {
-    settings: Settings;
+    settings: InitSettings;
 } & DestinationServer.Config<Types>;
 type InitFn = DestinationServer.InitFn<Types>;
 type PushFn = DestinationServer.PushFn<Types>;
 type SetupFn = SetupFn$1<Config, Env>;
-type PartialConfig = Omit<DestinationServer.PartialConfig<Types>, 'settings' | 'setup'> & {
-    settings?: Partial<Settings> | Settings;
-    setup?: boolean | Setup;
-};
+type PartialConfig = DestinationServer.PartialConfig<Types>;
 type PushEvents = DestinationServer.PushEvents<Mapping>;
 type Rule = Mapping$2.Rule<Mapping>;
 type Rules = Mapping$2.Rules<Rule>;
@@ -169,6 +269,7 @@ type index_PushEvents = PushEvents;
 type index_PushFn = PushFn;
 type index_Rule = Rule;
 type index_Rules = Rules;
+type index_Runtime = Runtime;
 type index_SendClient = SendClient;
 type index_Settings = Settings;
 type index_Setup = Setup;
@@ -176,7 +277,7 @@ type index_SetupFn = SetupFn;
 type index_SetupSubscription = SetupSubscription;
 type index_Types = Types;
 declare namespace index {
-  export type { index_CommandConstructor as CommandConstructor, index_Config as Config, index_Destination as Destination, index_Env as Env, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_Rule as Rule, index_Rules as Rules, index_SendClient as SendClient, index_Settings as Settings, index_Setup as Setup, index_SetupFn as SetupFn, index_SetupSubscription as SetupSubscription, index_Types as Types };
+  export type { index_CommandConstructor as CommandConstructor, index_Config as Config, index_Destination as Destination, index_Env as Env, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_Rule as Rule, index_Rules as Rules, index_Runtime as Runtime, index_SendClient as SendClient, index_Settings as Settings, index_Setup as Setup, index_SetupFn as SetupFn, index_SetupSubscription as SetupSubscription, index_Types as Types };
 }
 
 declare const destinationSNS: Destination;