@layered-loader/sqs 1.0.0

package/dist/lib/SqsGroupNotificationFactory.js

@@ -0,0 +1,40 @@
+import { randomUUID } from 'node:crypto';
+import { SqsGroupNotificationConsumer, } from './SqsGroupNotificationConsumer.js';
+import { SqsGroupNotificationPublisher, } from './SqsGroupNotificationPublisher.js';
+export function createGroupNotificationPair(config) {
+    const serverUuid = config.serverUuid ?? randomUUID();
+    const publisherConfig = config.publisher;
+    const consumerConfig = config.consumer;
+    const publisher = new SqsGroupNotificationPublisher(publisherConfig.creationConfig
+        ? {
+            serverUuid,
+            channel: config.channel,
+            errorHandler: config.publisherErrorHandler,
+            dependencies: publisherConfig.dependencies,
+            creationConfig: publisherConfig.creationConfig,
+        }
+        : {
+            serverUuid,
+            channel: config.channel,
+            errorHandler: config.publisherErrorHandler,
+            dependencies: publisherConfig.dependencies,
+            locatorConfig: publisherConfig.locatorConfig,
+        });
+    const consumer = new SqsGroupNotificationConsumer(consumerConfig.creationConfig
+        ? {
+            serverUuid,
+            errorHandler: config.consumerErrorHandler,
+            dependencies: consumerConfig.dependencies,
+            subscriptionConfig: consumerConfig.subscriptionConfig,
+            creationConfig: consumerConfig.creationConfig,
+        }
+        : {
+            serverUuid,
+            errorHandler: config.consumerErrorHandler,
+            dependencies: consumerConfig.dependencies,
+            subscriptionConfig: consumerConfig.subscriptionConfig,
+            locatorConfig: consumerConfig.locatorConfig,
+        });
+    return { publisher, consumer };
+}
+//# sourceMappingURL=SqsGroupNotificationFactory.js.map

package/dist/lib/SqsGroupNotificationFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsGroupNotificationFactory.js","sourceRoot":"","sources":["../../lib/SqsGroupNotificationFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EACL,4BAA4B,GAE7B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,6BAA6B,GAE9B,MAAM,oCAAoC,CAAA;AAiB3C,MAAM,UAAU,2BAA2B,CAAc,MAAkC;IAIzF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,UAAU,EAAE,CAAA;IAEpD,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAA;IACxC,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAA;IAEtC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CACjD,eAAe,CAAC,cAAc;QAC5B,CAAC,CAAC;YACE,UAAU;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,qBAAqB;YAC1C,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,cAAc,EAAE,eAAe,CAAC,cAAc;SAC/C;QACH,CAAC,CAAC;YACE,UAAU;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,qBAAqB;YAC1C,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CACN,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,4BAA4B,CAC/C,cAAc,CAAC,cAAc;QAC3B,CAAC,CAAC;YACE,UAAU;YACV,YAAY,EAAE,MAAM,CAAC,oBAAoB;YACzC,YAAY,EAAE,cAAc,CAAC,YAAY;YACzC,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;YACrD,cAAc,EAAE,cAAc,CAAC,cAAc;SAC9C;QACH,CAAC,CAAC;YACE,UAAU;YACV,YAAY,EAAE,MAAM,CAAC,oBAAoB;YACzC,YAAY,EAAE,cAAc,CAAC,YAAY;YACzC,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;YACrD,aAAa,EAAE,cAAc,CAAC,aAAa;SAC5C,CACN,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAChC,CAAC"}

package/dist/lib/SqsGroupNotificationPublisher.d.ts

@@ -0,0 +1,38 @@
+import { type SNSCreationConfig, type SNSDependencies, type SNSTopicLocatorType } from '@message-queue-toolkit/sns';
+import type { GroupNotificationPublisher, PublisherErrorHandler } from 'layered-loader';
+export type SqsGroupNotificationPublisherConfig = {
+    creationConfig: SNSCreationConfig;
+    locatorConfig?: never;
+} | {
+    creationConfig?: never;
+    locatorConfig: SNSTopicLocatorType;
+};
+export type SqsGroupNotificationPublisherParams = {
+    serverUuid: string;
+    errorHandler?: PublisherErrorHandler;
+    channel?: string;
+    dependencies: SNSDependencies;
+} & SqsGroupNotificationPublisherConfig;
+export declare class SqsGroupNotificationPublisher<LoadedValue> implements GroupNotificationPublisher<LoadedValue> {
+    readonly channel: string;
+    readonly errorHandler: PublisherErrorHandler;
+    private readonly serverUuid;
+    private readonly publisher;
+    private initPromise?;
+    private initialized;
+    constructor(params: SqsGroupNotificationPublisherParams);
+    subscribe(): Promise<void>;
+    private initializePublisher;
+    deleteFromGroup(key: string, group: string): Promise<unknown>;
+    deleteGroup(group: string): Promise<unknown>;
+    clear(): Promise<unknown>;
+    close(): Promise<void>;
+    /**
+     * Returns the resolved topic ARN. Available only after `subscribe()` (or the
+     * first publish) has fully completed; returns `undefined` while init is in
+     * flight or before it has been triggered.
+     */
+    get topicArn(): string | undefined;
+    private publishCommand;
+    private buildEnvelope;
+}

package/dist/lib/SqsGroupNotificationPublisher.js

@@ -0,0 +1,102 @@
+import { randomUUID } from 'node:crypto';
+import { AbstractSnsPublisher, } from '@message-queue-toolkit/sns';
+import { resolveChannelName } from './channelNameResolver.js';
+import { CLEAR_COMMAND, DELETE_FROM_GROUP_COMMAND, DELETE_GROUP_COMMAND, GROUP_NOTIFICATION_SCHEMAS, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, } from './groupNotificationSchemas.js';
+const DEFAULT_PUBLISHER_ERROR_HANDLER = (err, channel, logger) => {
+    logger.error(`Error while publishing notification to channel ${channel}: ${err.message}`);
+};
+class SnsGroupInvalidationPublisher extends AbstractSnsPublisher {
+    get publicTopicArn() {
+        return this.topicArn;
+    }
+}
+export class SqsGroupNotificationPublisher {
+    channel;
+    errorHandler;
+    serverUuid;
+    publisher;
+    initPromise;
+    initialized = false;
+    constructor(params) {
+        this.serverUuid = params.serverUuid;
+        this.errorHandler = params.errorHandler ?? DEFAULT_PUBLISHER_ERROR_HANDLER;
+        this.channel = resolveChannelName(params);
+        // mqt's `messageSchemas` is `readonly ZodSchema<UnionType>[]`. Our schemas
+        // are narrower (one per command type) and `ZodSchema` is invariant in T,
+        // so the array of narrow schemas does not satisfy the broad type at the
+        // type level — even though mqt resolves them correctly at runtime via the
+        // configured `messageTypeResolver`.
+        const options = {
+            messageSchemas: GROUP_NOTIFICATION_SCHEMAS,
+            messageTypeResolver: { messageTypePath: NOTIFICATION_TYPE_FIELD },
+            messageIdField: NOTIFICATION_ID_FIELD,
+            messageTimestampField: NOTIFICATION_TIMESTAMP_FIELD,
+            ...(params.creationConfig
+                ? { creationConfig: params.creationConfig }
+                : { locatorConfig: params.locatorConfig }),
+        };
+        this.publisher = new SnsGroupInvalidationPublisher(params.dependencies, options);
+    }
+    async subscribe() {
+        if (this.initialized)
+            return;
+        if (!this.initPromise) {
+            this.initPromise = this.initializePublisher();
+        }
+        return this.initPromise;
+    }
+    async initializePublisher() {
+        try {
+            await this.publisher.init();
+            this.initialized = true;
+        }
+        catch (err) {
+            this.initPromise = undefined;
+            throw err;
+        }
+    }
+    deleteFromGroup(key, group) {
+        return this.publishCommand({
+            type: DELETE_FROM_GROUP_COMMAND,
+            key,
+            group,
+            ...this.buildEnvelope(),
+        });
+    }
+    deleteGroup(group) {
+        return this.publishCommand({
+            type: DELETE_GROUP_COMMAND,
+            group,
+            ...this.buildEnvelope(),
+        });
+    }
+    clear() {
+        return this.publishCommand({
+            type: CLEAR_COMMAND,
+            ...this.buildEnvelope(),
+        });
+    }
+    async close() {
+        await this.publisher.close();
+    }
+    /**
+     * Returns the resolved topic ARN. Available only after `subscribe()` (or the
+     * first publish) has fully completed; returns `undefined` while init is in
+     * flight or before it has been triggered.
+     */
+    get topicArn() {
+        return this.initialized ? this.publisher.publicTopicArn : undefined;
+    }
+    async publishCommand(command) {
+        await this.subscribe();
+        await this.publisher.publish(command);
+    }
+    buildEnvelope() {
+        return {
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            originUuid: this.serverUuid,
+        };
+    }
+}
+//# sourceMappingURL=SqsGroupNotificationPublisher.js.map

package/dist/lib/SqsGroupNotificationPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsGroupNotificationPublisher.js","sourceRoot":"","sources":["../../lib/SqsGroupNotificationPublisher.ts"],"names":[],"mappings":"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"}

package/dist/lib/SqsNotificationConsumer.d.ts

@@ -0,0 +1,44 @@
+import type { SubscribeCommandInput } from '@aws-sdk/client-sns';
+import { type SNSSQSConsumerDependencies, type SNSSQSCreationConfig, type SNSSQSQueueLocatorType } from '@message-queue-toolkit/sns';
+import type { ConsumerErrorHandler } from 'layered-loader';
+import { AbstractNotificationConsumer } from 'layered-loader';
+/**
+ * Mirror of `SNSSubscriptionOptions` from `@message-queue-toolkit/sns/utils/snsSubscriber`,
+ * which is not re-exported from the package's main entry point.
+ */
+export type SqsSubscriptionOptions = Omit<SubscribeCommandInput, 'TopicArn' | 'Endpoint' | 'Protocol' | 'ReturnSubscriptionArn'> & {
+    updateAttributesIfExists: boolean;
+};
+export type SqsNotificationConsumerConfig = {
+    creationConfig: SNSSQSCreationConfig;
+    locatorConfig?: never;
+} | {
+    creationConfig?: never;
+    locatorConfig: SNSSQSQueueLocatorType;
+};
+export type SqsNotificationConsumerParams = {
+    serverUuid: string;
+    errorHandler?: ConsumerErrorHandler;
+    dependencies: SNSSQSConsumerDependencies;
+    subscriptionConfig?: SqsSubscriptionOptions;
+} & SqsNotificationConsumerConfig;
+export declare class SqsNotificationConsumer<LoadedValue> extends AbstractNotificationConsumer<LoadedValue> {
+    private readonly params;
+    private internalConsumer?;
+    private subscribePromise?;
+    constructor(params: SqsNotificationConsumerParams);
+    subscribe(): Promise<unknown>;
+    close(): Promise<void>;
+    /**
+     * Returns the resolved topic ARN. Available only after subscribe() has completed.
+     */
+    get topicArn(): string | undefined;
+    /**
+     * Returns the resolved subscription ARN. Available only after subscribe() has completed.
+     */
+    get subscriptionArn(): string | undefined;
+    /**
+     * Returns the resolved queue URL. Available only after subscribe() has completed.
+     */
+    get queueUrl(): string | undefined;
+}

package/dist/lib/SqsNotificationConsumer.js

@@ -0,0 +1,123 @@
+import { MessageHandlerConfigBuilder } from '@message-queue-toolkit/core';
+import { AbstractSnsSqsConsumer, } from '@message-queue-toolkit/sns';
+import { AbstractNotificationConsumer } from 'layered-loader';
+import { CLEAR_NOTIFICATION_SCHEMA, DELETE_MANY_NOTIFICATION_SCHEMA, DELETE_NOTIFICATION_SCHEMA, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, SET_NOTIFICATION_SCHEMA, } from './notificationSchemas.js';
+class SnsSqsInvalidationConsumer extends AbstractSnsSqsConsumer {
+    constructor(dependencies, options, context) {
+        super(dependencies, options, context);
+    }
+    get publicTopicArn() {
+        return this.topicArn;
+    }
+    get publicSubscriptionArn() {
+        return this.subscriptionArn;
+    }
+    get publicQueueUrl() {
+        return this.queueUrl;
+    }
+}
+export class SqsNotificationConsumer extends AbstractNotificationConsumer {
+    params;
+    internalConsumer;
+    subscribePromise;
+    constructor(params) {
+        super(params.serverUuid, params.errorHandler);
+        this.params = params;
+    }
+    async subscribe() {
+        if (this.internalConsumer) {
+            return this.internalConsumer;
+        }
+        if (this.subscribePromise) {
+            return this.subscribePromise;
+        }
+        if (!this.targetCache) {
+            throw new Error('targetCache must be set via setTargetCache() before subscribe() is called');
+        }
+        const handlers = new MessageHandlerConfigBuilder()
+            .addConfig(DELETE_NOTIFICATION_SCHEMA, async (message, ctx) => {
+            if (message.originUuid !== ctx.serverUuid) {
+                ctx.targetCache.delete(message.key);
+            }
+            return { result: 'success' };
+        })
+            .addConfig(DELETE_MANY_NOTIFICATION_SCHEMA, async (message, ctx) => {
+            if (message.originUuid !== ctx.serverUuid) {
+                ctx.targetCache.deleteMany(message.keys);
+            }
+            return { result: 'success' };
+        })
+            .addConfig(CLEAR_NOTIFICATION_SCHEMA, async (message, ctx) => {
+            if (message.originUuid !== ctx.serverUuid) {
+                ctx.targetCache.clear();
+            }
+            return { result: 'success' };
+        })
+            .addConfig(SET_NOTIFICATION_SCHEMA, async (message, ctx) => {
+            if (message.originUuid !== ctx.serverUuid) {
+                ctx.targetCache.set(message.key, message.value ?? null);
+            }
+            return { result: 'success' };
+        })
+            .build();
+        const options = {
+            handlers,
+            messageTypeResolver: { messageTypePath: NOTIFICATION_TYPE_FIELD },
+            messageIdField: NOTIFICATION_ID_FIELD,
+            messageTimestampField: NOTIFICATION_TIMESTAMP_FIELD,
+            subscriptionConfig: this.params.subscriptionConfig ?? { updateAttributesIfExists: false },
+            ...(this.params.creationConfig
+                ? { creationConfig: this.params.creationConfig }
+                : { locatorConfig: this.params.locatorConfig }),
+        };
+        const consumer = new SnsSqsInvalidationConsumer(this.params.dependencies, options, { serverUuid: this.serverUuid, targetCache: this.targetCache });
+        // Single-flight: concurrent subscribe() calls share one init/start; the
+        // internal consumer is only assigned once both succeed, so a partial
+        // failure leaves the instance in a re-tryable state.
+        this.subscribePromise = (async () => {
+            try {
+                await consumer.init();
+                await consumer.start();
+                this.internalConsumer = consumer;
+                return consumer;
+            }
+            catch (err) {
+                await consumer.close().catch(() => undefined);
+                throw err;
+            }
+            finally {
+                this.subscribePromise = undefined;
+            }
+        })();
+        return this.subscribePromise;
+    }
+    async close() {
+        if (this.subscribePromise) {
+            await this.subscribePromise.catch(() => undefined);
+        }
+        if (!this.internalConsumer)
+            return;
+        const consumer = this.internalConsumer;
+        this.internalConsumer = undefined;
+        await consumer.close();
+    }
+    /**
+     * Returns the resolved topic ARN. Available only after subscribe() has completed.
+     */
+    get topicArn() {
+        return this.internalConsumer?.publicTopicArn;
+    }
+    /**
+     * Returns the resolved subscription ARN. Available only after subscribe() has completed.
+     */
+    get subscriptionArn() {
+        return this.internalConsumer?.publicSubscriptionArn;
+    }
+    /**
+     * Returns the resolved queue URL. Available only after subscribe() has completed.
+     */
+    get queueUrl() {
+        return this.internalConsumer?.publicQueueUrl;
+    }
+}
+//# sourceMappingURL=SqsNotificationConsumer.js.map

package/dist/lib/SqsNotificationConsumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsNotificationConsumer.js","sourceRoot":"","sources":["../../lib/SqsNotificationConsumer.ts"],"names":[],"mappings":"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"}

package/dist/lib/SqsNotificationFactory.d.ts

@@ -0,0 +1,29 @@
+import type { SNSDependencies, SNSSQSConsumerDependencies } from '@message-queue-toolkit/sns';
+import type { ConsumerErrorHandler, PublisherErrorHandler } from 'layered-loader';
+import { SqsNotificationConsumer, type SqsNotificationConsumerConfig, type SqsSubscriptionOptions } from './SqsNotificationConsumer.js';
+import { SqsNotificationPublisher, type SqsNotificationPublisherConfig } from './SqsNotificationPublisher.js';
+export type SqsNotificationConfig = {
+    /**
+     * Logical channel name used for error reporting.
+     * Defaults to the topic name/ARN derived from the publisher config.
+     */
+    channel?: string;
+    /**
+     * Stable identifier for this process. When omitted, a random UUID is generated.
+     * Messages whose `originUuid` matches this value are treated as self-emitted and skipped.
+     */
+    serverUuid?: string;
+    publisherErrorHandler?: PublisherErrorHandler;
+    consumerErrorHandler?: ConsumerErrorHandler;
+    publisher: {
+        dependencies: SNSDependencies;
+    } & SqsNotificationPublisherConfig;
+    consumer: {
+        dependencies: SNSSQSConsumerDependencies;
+        subscriptionConfig?: SqsSubscriptionOptions;
+    } & SqsNotificationConsumerConfig;
+};
+export declare function createNotificationPair<LoadedValue>(config: SqsNotificationConfig): {
+    publisher: SqsNotificationPublisher<LoadedValue>;
+    consumer: SqsNotificationConsumer<LoadedValue>;
+};

package/dist/lib/SqsNotificationFactory.js

@@ -0,0 +1,40 @@
+import { randomUUID } from 'node:crypto';
+import { SqsNotificationConsumer, } from './SqsNotificationConsumer.js';
+import { SqsNotificationPublisher, } from './SqsNotificationPublisher.js';
+export function createNotificationPair(config) {
+    const serverUuid = config.serverUuid ?? randomUUID();
+    const publisherConfig = config.publisher;
+    const consumerConfig = config.consumer;
+    const publisher = new SqsNotificationPublisher(publisherConfig.creationConfig
+        ? {
+            serverUuid,
+            channel: config.channel,
+            errorHandler: config.publisherErrorHandler,
+            dependencies: publisherConfig.dependencies,
+            creationConfig: publisherConfig.creationConfig,
+        }
+        : {
+            serverUuid,
+            channel: config.channel,
+            errorHandler: config.publisherErrorHandler,
+            dependencies: publisherConfig.dependencies,
+            locatorConfig: publisherConfig.locatorConfig,
+        });
+    const consumer = new SqsNotificationConsumer(consumerConfig.creationConfig
+        ? {
+            serverUuid,
+            errorHandler: config.consumerErrorHandler,
+            dependencies: consumerConfig.dependencies,
+            subscriptionConfig: consumerConfig.subscriptionConfig,
+            creationConfig: consumerConfig.creationConfig,
+        }
+        : {
+            serverUuid,
+            errorHandler: config.consumerErrorHandler,
+            dependencies: consumerConfig.dependencies,
+            subscriptionConfig: consumerConfig.subscriptionConfig,
+            locatorConfig: consumerConfig.locatorConfig,
+        });
+    return { publisher, consumer };
+}
+//# sourceMappingURL=SqsNotificationFactory.js.map

package/dist/lib/SqsNotificationFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsNotificationFactory.js","sourceRoot":"","sources":["../../lib/SqsNotificationFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EACL,uBAAuB,GAGxB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,wBAAwB,GAEzB,MAAM,+BAA+B,CAAA;AAwBtC,MAAM,UAAU,sBAAsB,CAAc,MAA6B;IAI/E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,UAAU,EAAE,CAAA;IAEpD,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAA;IACxC,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAA;IAEtC,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAC5C,eAAe,CAAC,cAAc;QAC5B,CAAC,CAAC;YACE,UAAU;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,qBAAqB;YAC1C,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,cAAc,EAAE,eAAe,CAAC,cAAc;SAC/C;QACH,CAAC,CAAC;YACE,UAAU;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,qBAAqB;YAC1C,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CACN,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAC1C,cAAc,CAAC,cAAc;QAC3B,CAAC,CAAC;YACE,UAAU;YACV,YAAY,EAAE,MAAM,CAAC,oBAAoB;YACzC,YAAY,EAAE,cAAc,CAAC,YAAY;YACzC,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;YACrD,cAAc,EAAE,cAAc,CAAC,cAAc;SAC9C;QACH,CAAC,CAAC;YACE,UAAU;YACV,YAAY,EAAE,MAAM,CAAC,oBAAoB;YACzC,YAAY,EAAE,cAAc,CAAC,YAAY;YACzC,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;YACrD,aAAa,EAAE,cAAc,CAAC,aAAa;SAC5C,CACN,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAChC,CAAC"}

package/dist/lib/SqsNotificationPublisher.d.ts

@@ -0,0 +1,39 @@
+import { type SNSCreationConfig, type SNSDependencies, type SNSTopicLocatorType } from '@message-queue-toolkit/sns';
+import type { NotificationPublisher, PublisherErrorHandler } from 'layered-loader';
+export type SqsNotificationPublisherConfig = {
+    creationConfig: SNSCreationConfig;
+    locatorConfig?: never;
+} | {
+    creationConfig?: never;
+    locatorConfig: SNSTopicLocatorType;
+};
+export type SqsNotificationPublisherParams = {
+    serverUuid: string;
+    errorHandler?: PublisherErrorHandler;
+    channel?: string;
+    dependencies: SNSDependencies;
+} & SqsNotificationPublisherConfig;
+export declare class SqsNotificationPublisher<LoadedValue> implements NotificationPublisher<LoadedValue> {
+    readonly channel: string;
+    readonly errorHandler: PublisherErrorHandler;
+    private readonly serverUuid;
+    private readonly publisher;
+    private initPromise?;
+    private initialized;
+    constructor(params: SqsNotificationPublisherParams);
+    subscribe(): Promise<void>;
+    private initializePublisher;
+    set(key: string, value: LoadedValue | null): Promise<unknown>;
+    delete(key: string): Promise<unknown>;
+    deleteMany(keys: string[]): Promise<unknown>;
+    clear(): Promise<unknown>;
+    close(): Promise<void>;
+    /**
+     * Returns the resolved topic ARN. Available only after `subscribe()` (or the
+     * first publish) has fully completed; returns `undefined` while init is in
+     * flight or before it has been triggered.
+     */
+    get topicArn(): string | undefined;
+    private publishCommand;
+    private buildEnvelope;
+}

package/dist/lib/SqsNotificationPublisher.js

@@ -0,0 +1,109 @@
+import { randomUUID } from 'node:crypto';
+import { AbstractSnsPublisher, } from '@message-queue-toolkit/sns';
+import { resolveChannelName } from './channelNameResolver.js';
+import { CLEAR_COMMAND, DELETE_COMMAND, DELETE_MANY_COMMAND, NOTIFICATION_ID_FIELD, NOTIFICATION_SCHEMAS, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, SET_COMMAND, } from './notificationSchemas.js';
+const DEFAULT_PUBLISHER_ERROR_HANDLER = (err, channel, logger) => {
+    logger.error(`Error while publishing notification to channel ${channel}: ${err.message}`);
+};
+class SnsInvalidationPublisher extends AbstractSnsPublisher {
+    get publicTopicArn() {
+        return this.topicArn;
+    }
+}
+export class SqsNotificationPublisher {
+    channel;
+    errorHandler;
+    serverUuid;
+    publisher;
+    initPromise;
+    initialized = false;
+    constructor(params) {
+        this.serverUuid = params.serverUuid;
+        this.errorHandler = params.errorHandler ?? DEFAULT_PUBLISHER_ERROR_HANDLER;
+        this.channel = resolveChannelName(params);
+        // mqt's `messageSchemas` is `readonly ZodSchema<UnionType>[]`. Our schemas
+        // are narrower (one per command type) and `ZodSchema` is invariant in T,
+        // so the array of narrow schemas does not satisfy the broad type at the
+        // type level — even though mqt resolves them correctly at runtime via the
+        // configured `messageTypeResolver`.
+        const options = {
+            messageSchemas: NOTIFICATION_SCHEMAS,
+            messageTypeResolver: { messageTypePath: NOTIFICATION_TYPE_FIELD },
+            messageIdField: NOTIFICATION_ID_FIELD,
+            messageTimestampField: NOTIFICATION_TIMESTAMP_FIELD,
+            ...(params.creationConfig
+                ? { creationConfig: params.creationConfig }
+                : { locatorConfig: params.locatorConfig }),
+        };
+        this.publisher = new SnsInvalidationPublisher(params.dependencies, options);
+    }
+    async subscribe() {
+        if (this.initialized)
+            return;
+        if (!this.initPromise) {
+            this.initPromise = this.initializePublisher();
+        }
+        return this.initPromise;
+    }
+    async initializePublisher() {
+        try {
+            await this.publisher.init();
+            this.initialized = true;
+        }
+        catch (err) {
+            this.initPromise = undefined;
+            throw err;
+        }
+    }
+    set(key, value) {
+        return this.publishCommand({
+            type: SET_COMMAND,
+            key,
+            value,
+            ...this.buildEnvelope(),
+        });
+    }
+    delete(key) {
+        return this.publishCommand({
+            type: DELETE_COMMAND,
+            key,
+            ...this.buildEnvelope(),
+        });
+    }
+    deleteMany(keys) {
+        return this.publishCommand({
+            type: DELETE_MANY_COMMAND,
+            keys,
+            ...this.buildEnvelope(),
+        });
+    }
+    clear() {
+        return this.publishCommand({
+            type: CLEAR_COMMAND,
+            ...this.buildEnvelope(),
+        });
+    }
+    async close() {
+        await this.publisher.close();
+    }
+    /**
+     * Returns the resolved topic ARN. Available only after `subscribe()` (or the
+     * first publish) has fully completed; returns `undefined` while init is in
+     * flight or before it has been triggered.
+     */
+    get topicArn() {
+        return this.initialized ? this.publisher.publicTopicArn : undefined;
+    }
+    async publishCommand(command) {
+        await this.subscribe();
+        await this.publisher.publish(command);
+    }
+    buildEnvelope() {
+        return {
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            originUuid: this.serverUuid,
+        };
+    }
+}
+//# sourceMappingURL=SqsNotificationPublisher.js.map

package/dist/lib/SqsNotificationPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsNotificationPublisher.js","sourceRoot":"","sources":["../../lib/SqsNotificationPublisher.ts"],"names":[],"mappings":"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"}

package/dist/lib/channelNameResolver.d.ts

@@ -0,0 +1,12 @@
+import type { SNSCreationConfig, SNSTopicLocatorType } from '@message-queue-toolkit/sns';
+export type ChannelNameSource = {
+    channel?: string;
+    creationConfig?: SNSCreationConfig;
+    locatorConfig?: SNSTopicLocatorType;
+};
+/**
+ * Derive a logical channel name (used in error messages and logs) from a
+ * publisher params object that has either an explicit `channel`, a
+ * `creationConfig.topic.Name`, or a `locatorConfig` with `topicName`/`topicArn`.
+ */
+export declare function resolveChannelName(source: ChannelNameSource): string;

package/dist/lib/channelNameResolver.js

@@ -0,0 +1,18 @@
+const DEFAULT_CHANNEL_NAME = 'sqs-notification-channel';
+/**
+ * Derive a logical channel name (used in error messages and logs) from a
+ * publisher params object that has either an explicit `channel`, a
+ * `creationConfig.topic.Name`, or a `locatorConfig` with `topicName`/`topicArn`.
+ */
+export function resolveChannelName(source) {
+    if (source.channel)
+        return source.channel;
+    if (source.creationConfig?.topic?.Name)
+        return source.creationConfig.topic.Name;
+    if (source.locatorConfig?.topicName)
+        return source.locatorConfig.topicName;
+    if (source.locatorConfig?.topicArn)
+        return source.locatorConfig.topicArn;
+    return DEFAULT_CHANNEL_NAME;
+}
+//# sourceMappingURL=channelNameResolver.js.map

package/dist/lib/channelNameResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelNameResolver.js","sourceRoot":"","sources":["../../lib/channelNameResolver.ts"],"names":[],"mappings":"AAQA,MAAM,oBAAoB,GAAG,0BAA0B,CAAA;AAEvD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,OAAO,CAAA;IACzC,IAAI,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAA;IAC/E,IAAI,MAAM,CAAC,aAAa,EAAE,SAAS;QAAE,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,CAAA;IAC1E,IAAI,MAAM,CAAC,aAAa,EAAE,QAAQ;QAAE,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAA;IACxE,OAAO,oBAAoB,CAAA;AAC7B,CAAC"}