@layered-loader/sqs 1.0.0

package/dist/lib/groupNotificationSchemas.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { CLEAR_COMMAND, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD } from './notificationSchemas.js';
+export declare const DELETE_GROUP_COMMAND = "DELETE_GROUP";
+export declare const DELETE_FROM_GROUP_COMMAND = "DELETE_FROM_GROUP";
+export { CLEAR_COMMAND, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, };
+export declare const CLEAR_GROUP_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"CLEAR">;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export declare const DELETE_GROUP_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_GROUP">;
+    group: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export declare const DELETE_FROM_GROUP_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_FROM_GROUP">;
+    key: z.ZodString;
+    group: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export type ClearGroupNotificationCommand = z.infer<typeof CLEAR_GROUP_NOTIFICATION_SCHEMA>;
+export type DeleteGroupNotificationCommand = z.infer<typeof DELETE_GROUP_NOTIFICATION_SCHEMA>;
+export type DeleteFromGroupNotificationCommand = z.infer<typeof DELETE_FROM_GROUP_NOTIFICATION_SCHEMA>;
+export type GroupNotificationCommand = ClearGroupNotificationCommand | DeleteGroupNotificationCommand | DeleteFromGroupNotificationCommand;
+export declare const GROUP_NOTIFICATION_SCHEMAS: readonly [z.ZodObject<{
+    type: z.ZodLiteral<"CLEAR">;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_GROUP">;
+    group: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_FROM_GROUP">;
+    key: z.ZodString;
+    group: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>];

package/dist/lib/groupNotificationSchemas.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { CLEAR_COMMAND, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, } from './notificationSchemas.js';
+export const DELETE_GROUP_COMMAND = 'DELETE_GROUP';
+export const DELETE_FROM_GROUP_COMMAND = 'DELETE_FROM_GROUP';
+export { CLEAR_COMMAND, NOTIFICATION_ID_FIELD, NOTIFICATION_TIMESTAMP_FIELD, NOTIFICATION_TYPE_FIELD, };
+const NOTIFICATION_BASE_SHAPE = {
+    id: z.string().uuid(),
+    timestamp: z.string().datetime(),
+    originUuid: z.string().uuid(),
+};
+export const CLEAR_GROUP_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(CLEAR_COMMAND),
+});
+export const DELETE_GROUP_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(DELETE_GROUP_COMMAND),
+    group: z.string(),
+});
+export const DELETE_FROM_GROUP_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(DELETE_FROM_GROUP_COMMAND),
+    key: z.string(),
+    group: z.string(),
+});
+export const GROUP_NOTIFICATION_SCHEMAS = [
+    CLEAR_GROUP_NOTIFICATION_SCHEMA,
+    DELETE_GROUP_NOTIFICATION_SCHEMA,
+    DELETE_FROM_GROUP_NOTIFICATION_SCHEMA,
+];
+//# sourceMappingURL=groupNotificationSchemas.js.map

package/dist/lib/groupNotificationSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupNotificationSchemas.js","sourceRoot":"","sources":["../../lib/groupNotificationSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAA;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAA;AAE5D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GACxB,CAAA;AAED,MAAM,uBAAuB,GAAG;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC9B,CAAA;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;CAC/B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAaF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,+BAA+B;IAC/B,gCAAgC;IAChC,qCAAqC;CAC7B,CAAA"}

package/dist/lib/notificationSchemas.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const CLEAR_COMMAND = "CLEAR";
+export declare const DELETE_COMMAND = "DELETE";
+export declare const DELETE_MANY_COMMAND = "DELETE_MANY";
+export declare const SET_COMMAND = "SET";
+export declare const NOTIFICATION_TYPE_FIELD = "type";
+export declare const NOTIFICATION_ID_FIELD = "id";
+export declare const NOTIFICATION_TIMESTAMP_FIELD = "timestamp";
+export declare const CLEAR_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"CLEAR">;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export declare const DELETE_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"DELETE">;
+    key: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export declare const DELETE_MANY_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_MANY">;
+    keys: z.ZodArray<z.ZodString>;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export declare const SET_NOTIFICATION_SCHEMA: z.ZodObject<{
+    type: z.ZodLiteral<"SET">;
+    key: z.ZodString;
+    value: z.ZodNullable<z.ZodUnknown>;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>;
+export type ClearNotificationCommand = z.infer<typeof CLEAR_NOTIFICATION_SCHEMA>;
+export type DeleteNotificationCommand = z.infer<typeof DELETE_NOTIFICATION_SCHEMA>;
+export type DeleteManyNotificationCommand = z.infer<typeof DELETE_MANY_NOTIFICATION_SCHEMA>;
+export type SetNotificationCommand = z.infer<typeof SET_NOTIFICATION_SCHEMA>;
+export type NotificationCommand = ClearNotificationCommand | DeleteNotificationCommand | DeleteManyNotificationCommand | SetNotificationCommand;
+export declare const NOTIFICATION_SCHEMAS: readonly [z.ZodObject<{
+    type: z.ZodLiteral<"CLEAR">;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DELETE">;
+    key: z.ZodString;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"DELETE_MANY">;
+    keys: z.ZodArray<z.ZodString>;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"SET">;
+    key: z.ZodString;
+    value: z.ZodNullable<z.ZodUnknown>;
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    originUuid: z.ZodString;
+}, z.core.$strip>];

package/dist/lib/notificationSchemas.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export const CLEAR_COMMAND = 'CLEAR';
+export const DELETE_COMMAND = 'DELETE';
+export const DELETE_MANY_COMMAND = 'DELETE_MANY';
+export const SET_COMMAND = 'SET';
+export const NOTIFICATION_TYPE_FIELD = 'type';
+export const NOTIFICATION_ID_FIELD = 'id';
+export const NOTIFICATION_TIMESTAMP_FIELD = 'timestamp';
+const NOTIFICATION_BASE_SHAPE = {
+    id: z.string().uuid(),
+    timestamp: z.string().datetime(),
+    originUuid: z.string().uuid(),
+};
+export const CLEAR_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(CLEAR_COMMAND),
+});
+export const DELETE_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(DELETE_COMMAND),
+    key: z.string(),
+});
+export const DELETE_MANY_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(DELETE_MANY_COMMAND),
+    keys: z.array(z.string()),
+});
+export const SET_NOTIFICATION_SCHEMA = z.object({
+    ...NOTIFICATION_BASE_SHAPE,
+    type: z.literal(SET_COMMAND),
+    key: z.string(),
+    value: z.unknown().nullable(),
+});
+export const NOTIFICATION_SCHEMAS = [
+    CLEAR_NOTIFICATION_SCHEMA,
+    DELETE_NOTIFICATION_SCHEMA,
+    DELETE_MANY_NOTIFICATION_SCHEMA,
+    SET_NOTIFICATION_SCHEMA,
+];
+//# sourceMappingURL=notificationSchemas.js.map

package/dist/lib/notificationSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationSchemas.js","sourceRoot":"","sources":["../../lib/notificationSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAA;AAEhC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AACzC,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAA;AAEvD,MAAM,uBAAuB,GAAG;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC9B,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;CAC/B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,uBAAuB;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAA;AAaF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,yBAAyB;IACzB,0BAA0B;IAC1B,+BAA+B;IAC/B,uBAAuB;CACf,CAAA"}

package/dist/lib/triggers/AbstractSqsTrigger.d.ts

@@ -0,0 +1,62 @@
+import type { MessageHandlerConfig } from '@message-queue-toolkit/core';
+import { type SNSSQSConsumerDependencies, type SNSSQSCreationConfig, type SNSSQSQueueLocatorType } from '@message-queue-toolkit/sns';
+import { type SQSConsumerDependencies, type SQSCreationConfig, type SQSQueueLocatorType } from '@message-queue-toolkit/sqs';
+import type { SqsSubscriptionOptions } from '../SqsNotificationConsumer.js';
+import type { InvalidationTrigger } from './types.js';
+/**
+ * Discriminated source config shared by every SQS-based trigger
+ * (flat or group, current and future variants).
+ */
+export type SqsTriggerSource = {
+    sourceType: 'sqs-queue';
+    dependencies: SQSConsumerDependencies;
+    creationConfig: SQSCreationConfig;
+    locatorConfig?: never;
+} | {
+    sourceType: 'sqs-queue';
+    dependencies: SQSConsumerDependencies;
+    creationConfig?: never;
+    locatorConfig: SQSQueueLocatorType;
+} | {
+    sourceType: 'sns-topic';
+    dependencies: SNSSQSConsumerDependencies;
+    creationConfig: SNSSQSCreationConfig;
+    locatorConfig?: never;
+    subscriptionConfig?: SqsSubscriptionOptions;
+} | {
+    sourceType: 'sns-topic';
+    dependencies: SNSSQSConsumerDependencies;
+    creationConfig?: never;
+    locatorConfig: SNSSQSQueueLocatorType;
+    subscriptionConfig?: SqsSubscriptionOptions;
+};
+/** Minimal lifecycle slice we need from the underlying message-queue-toolkit consumer. */
+export interface InternalConsumerHandle {
+    init(): Promise<void>;
+    start(): Promise<void>;
+    close(abort?: boolean): Promise<void>;
+}
+/**
+ * Shared lifecycle (start/stop with idempotency + concurrent-call protection)
+ * and consumer construction logic for SQS-based triggers. Subclasses provide
+ * the concrete handler configuration via {@link buildHandlers}.
+ */
+export declare abstract class AbstractSqsTrigger<TMessage extends object, TContext> implements InvalidationTrigger {
+    private internalConsumer?;
+    private startPromise?;
+    protected abstract readonly source: SqsTriggerSource;
+    protected abstract readonly messageType: string;
+    protected abstract readonly channel: string;
+    /** Build the handler configuration for the underlying consumer. */
+    protected abstract buildHandlers(): MessageHandlerConfig<TMessage, TContext, undefined>[];
+    /** Construct the per-trigger execution context that handlers receive. */
+    protected abstract buildContext(): TContext;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private createConsumer;
+}
+/**
+ * Derive a human-readable channel name from any {@link SqsTriggerSource} for
+ * use in error messages and logging.
+ */
+export declare function deriveTriggerChannelName(source: SqsTriggerSource): string;

package/dist/lib/triggers/AbstractSqsTrigger.js

@@ -0,0 +1,104 @@
+import { AbstractSnsSqsConsumer, } from '@message-queue-toolkit/sns';
+import { AbstractSqsConsumer, } from '@message-queue-toolkit/sqs';
+/**
+ * Concrete subclasses of `AbstractSnsSqsConsumer` / `AbstractSqsConsumer` are
+ * needed because the upstream classes are abstract. They add no behaviour;
+ * they just expose the constructor.
+ */
+class SqsQueueTriggerConsumer extends AbstractSqsConsumer {
+    constructor(dependencies, options, context) {
+        super(dependencies, options, context);
+    }
+}
+class SnsTopicTriggerConsumer extends AbstractSnsSqsConsumer {
+    constructor(dependencies, options, context) {
+        super(dependencies, options, context);
+    }
+}
+/**
+ * Shared lifecycle (start/stop with idempotency + concurrent-call protection)
+ * and consumer construction logic for SQS-based triggers. Subclasses provide
+ * the concrete handler configuration via {@link buildHandlers}.
+ */
+export class AbstractSqsTrigger {
+    internalConsumer;
+    startPromise;
+    async start() {
+        if (this.startPromise)
+            return this.startPromise;
+        if (this.internalConsumer)
+            return;
+        this.startPromise = (async () => {
+            const consumer = this.createConsumer();
+            try {
+                await consumer.init();
+                await consumer.start();
+                this.internalConsumer = consumer;
+            }
+            finally {
+                this.startPromise = undefined;
+            }
+        })();
+        return this.startPromise;
+    }
+    async stop() {
+        // Wait for any in-flight start to settle so we don't leak a consumer.
+        if (this.startPromise) {
+            await this.startPromise.catch(() => undefined);
+        }
+        const consumer = this.internalConsumer;
+        if (!consumer)
+            return;
+        this.internalConsumer = undefined;
+        await consumer.close();
+    }
+    createConsumer() {
+        const handlers = this.buildHandlers();
+        const context = this.buildContext();
+        const messageTypeResolver = { literal: this.messageType };
+        if (this.source.sourceType === 'sqs-queue') {
+            const base = {
+                handlers,
+                messageTypeResolver,
+            };
+            const options = this.source.creationConfig
+                ? { ...base, creationConfig: this.source.creationConfig }
+                : { ...base, locatorConfig: this.source.locatorConfig };
+            return new SqsQueueTriggerConsumer(this.source.dependencies, options, context);
+        }
+        const base = {
+            handlers,
+            messageTypeResolver,
+            subscriptionConfig: this.source.subscriptionConfig ?? { updateAttributesIfExists: false },
+        };
+        const options = this.source.creationConfig
+            ? { ...base, creationConfig: this.source.creationConfig }
+            : { ...base, locatorConfig: this.source.locatorConfig };
+        return new SnsTopicTriggerConsumer(this.source.dependencies, options, context);
+    }
+}
+/**
+ * Derive a human-readable channel name from any {@link SqsTriggerSource} for
+ * use in error messages and logging.
+ */
+export function deriveTriggerChannelName(source) {
+    if (source.sourceType === 'sqs-queue') {
+        if (source.creationConfig?.queue?.QueueName)
+            return source.creationConfig.queue.QueueName;
+        if (source.locatorConfig?.queueName)
+            return source.locatorConfig.queueName;
+        if (source.locatorConfig?.queueUrl)
+            return source.locatorConfig.queueUrl;
+        return 'sqs-invalidation-trigger';
+    }
+    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;
+    if (source.locatorConfig?.queueUrl)
+        return source.locatorConfig.queueUrl;
+    return 'sns-invalidation-trigger';
+}
+//# sourceMappingURL=AbstractSqsTrigger.js.map

package/dist/lib/triggers/AbstractSqsTrigger.js.map

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

package/dist/lib/triggers/SqsGroupInvalidationTrigger.d.ts

@@ -0,0 +1,39 @@
+import { type MessageHandlerConfig } from '@message-queue-toolkit/core';
+import type { GroupNotificationPublisher } from 'layered-loader';
+import type { ZodSchema } from 'zod';
+import { AbstractSqsTrigger, type SqsTriggerSource } from './AbstractSqsTrigger.js';
+import type { GroupInvalidationAction, InvalidationResolver, TriggerErrorHandler } from './types.js';
+export type SqsGroupTriggerSourceConfig = SqsTriggerSource;
+export type SqsGroupInvalidationTriggerParams<TMessage extends object> = {
+    messageSchema: ZodSchema<TMessage>;
+    resolver: InvalidationResolver<TMessage, GroupInvalidationAction>;
+    /**
+     * The group notification publisher that propagates invalidation.
+     *
+     * Pass a publisher whose server UUID is distinct from any Loader's
+     * notification pair — otherwise the local pair's consumer treats trigger
+     * messages as self-emitted and drops them, leaving the local cache stale.
+     */
+    publisher: GroupNotificationPublisher<unknown>;
+    errorHandler?: TriggerErrorHandler;
+    channel?: string;
+} & SqsGroupTriggerSourceConfig;
+type GroupTriggerContext<TMessage> = {
+    resolver: InvalidationResolver<TMessage, GroupInvalidationAction>;
+    publisher: GroupNotificationPublisher<unknown>;
+    channel: string;
+    errorHandler: TriggerErrorHandler | undefined;
+};
+export declare class SqsGroupInvalidationTrigger<TMessage extends object> extends AbstractSqsTrigger<TMessage, GroupTriggerContext<TMessage>> {
+    protected readonly source: SqsTriggerSource;
+    protected readonly messageType = "layered-loader.group-invalidation-trigger";
+    protected readonly channel: string;
+    private readonly messageSchema;
+    private readonly resolver;
+    private readonly publisher;
+    private readonly errorHandler;
+    constructor(params: SqsGroupInvalidationTriggerParams<TMessage>);
+    protected buildContext(): GroupTriggerContext<TMessage>;
+    protected buildHandlers(): MessageHandlerConfig<TMessage, GroupTriggerContext<TMessage>, undefined>[];
+}
+export {};

package/dist/lib/triggers/SqsGroupInvalidationTrigger.js

@@ -0,0 +1,46 @@
+import { MessageHandlerConfigBuilder } from '@message-queue-toolkit/core';
+import { AbstractSqsTrigger, deriveTriggerChannelName, } from './AbstractSqsTrigger.js';
+import { runGroupPipeline } from './dispatch.js';
+const GROUP_TRIGGER_MESSAGE_TYPE = 'layered-loader.group-invalidation-trigger';
+export class SqsGroupInvalidationTrigger extends AbstractSqsTrigger {
+    source;
+    messageType = GROUP_TRIGGER_MESSAGE_TYPE;
+    channel;
+    messageSchema;
+    resolver;
+    publisher;
+    errorHandler;
+    constructor(params) {
+        super();
+        const { messageSchema, resolver, publisher, errorHandler, channel, ...source } = params;
+        this.source = source;
+        this.messageSchema = messageSchema;
+        this.resolver = resolver;
+        this.publisher = publisher;
+        this.errorHandler = errorHandler;
+        this.channel = channel ?? deriveTriggerChannelName(this.source);
+    }
+    buildContext() {
+        return {
+            resolver: this.resolver,
+            publisher: this.publisher,
+            channel: this.channel,
+            errorHandler: this.errorHandler,
+        };
+    }
+    buildHandlers() {
+        return new MessageHandlerConfigBuilder()
+            .addConfig(this.messageSchema, async (message, ctx) => {
+            try {
+                await runGroupPipeline(message, ctx.resolver, ctx.publisher);
+                return { result: 'success' };
+            }
+            catch (err) {
+                ctx.errorHandler?.(err, ctx.channel);
+                throw err;
+            }
+        }, { messageType: GROUP_TRIGGER_MESSAGE_TYPE })
+            .build();
+    }
+}
+//# sourceMappingURL=SqsGroupInvalidationTrigger.js.map

package/dist/lib/triggers/SqsGroupInvalidationTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsGroupInvalidationTrigger.js","sourceRoot":"","sources":["../../../lib/triggers/SqsGroupInvalidationTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAGpG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOhD,MAAM,0BAA0B,GAAG,2CAA2C,CAAA;AA0B9E,MAAM,OAAO,2BAAqD,SAAQ,kBAGzE;IACoB,MAAM,CAAkB;IACxB,WAAW,GAAG,0BAA0B,CAAA;IACxC,OAAO,CAAQ;IAEjB,aAAa,CAAqB;IAClC,QAAQ,CAAyD;IACjE,SAAS,CAAqC;IAC9C,YAAY,CAAiC;IAE9D,YAAY,MAAmD;QAC7D,KAAK,EAAE,CAAA;QACP,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAA;QACvF,IAAI,CAAC,MAAM,GAAG,MAA0B,CAAA;QACxC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjE,CAAC;IAES,YAAY;QACpB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAA;IACH,CAAC;IAES,aAAa;QAKrB,OAAO,IAAI,2BAA2B,EAA2C;aAC9E,SAAS,CACR,IAAI,CAAC,aAAa,EAClB,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;YACrB,IAAI,CAAC;gBACH,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;gBAC5D,OAAO,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAA;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,YAAY,EAAE,CAAC,GAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;gBAC7C,MAAM,GAAG,CAAA;YACX,CAAC;QACH,CAAC,EACD,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAC5C;aACA,KAAK,EAAE,CAAA;IACZ,CAAC;CACF"}

package/dist/lib/triggers/SqsInvalidationTrigger.d.ts

@@ -0,0 +1,56 @@
+import { type MessageHandlerConfig } from '@message-queue-toolkit/core';
+import type { NotificationPublisher } from 'layered-loader';
+import type { ZodSchema } from 'zod';
+import { AbstractSqsTrigger, type SqsTriggerSource } from './AbstractSqsTrigger.js';
+import type { InvalidationAction, InvalidationResolver, TriggerErrorHandler } from './types.js';
+export type SqsTriggerSourceConfig = SqsTriggerSource;
+export type SqsInvalidationTriggerParams<TMessage extends object> = {
+    /**
+     * Schema validating each message body delivered by the upstream transport.
+     * The resolver receives the validated `TMessage`. Use `z.unknown()` (or a
+     * permissive object schema) to accept arbitrary payloads.
+     */
+    messageSchema: ZodSchema<TMessage>;
+    resolver: InvalidationResolver<TMessage, InvalidationAction>;
+    /**
+     * The notification publisher that propagates invalidation across the cache
+     * cluster.
+     *
+     * **Important**: a trigger publishes invalidations on behalf of an external
+     * domain event, not on behalf of any local Loader. Pass a publisher that has
+     * its own server UUID (distinct from any Loader's notification pair),
+     * otherwise the local pair's consumer will treat the trigger's messages as
+     * self-emitted and drop them — leaving the local in-memory cache stale.
+     *
+     * Construct one with:
+     * ```
+     * const triggerPublisher = new SqsNotificationPublisher({
+     *   serverUuid: randomUUID(),
+     *   dependencies, locatorConfig: { topicName: 'app-invalidations' },
+     * })
+     * ```
+     */
+    publisher: NotificationPublisher<unknown>;
+    errorHandler?: TriggerErrorHandler;
+    /** Logical channel name passed to {@link errorHandler}. Defaults to a derived value. */
+    channel?: string;
+} & SqsTriggerSourceConfig;
+type FlatTriggerContext<TMessage> = {
+    resolver: InvalidationResolver<TMessage, InvalidationAction>;
+    publisher: NotificationPublisher<unknown>;
+    channel: string;
+    errorHandler: TriggerErrorHandler | undefined;
+};
+export declare class SqsInvalidationTrigger<TMessage extends object> extends AbstractSqsTrigger<TMessage, FlatTriggerContext<TMessage>> {
+    protected readonly source: SqsTriggerSource;
+    protected readonly messageType = "layered-loader.invalidation-trigger";
+    protected readonly channel: string;
+    private readonly messageSchema;
+    private readonly resolver;
+    private readonly publisher;
+    private readonly errorHandler;
+    constructor(params: SqsInvalidationTriggerParams<TMessage>);
+    protected buildContext(): FlatTriggerContext<TMessage>;
+    protected buildHandlers(): MessageHandlerConfig<TMessage, FlatTriggerContext<TMessage>, undefined>[];
+}
+export {};

package/dist/lib/triggers/SqsInvalidationTrigger.js

@@ -0,0 +1,47 @@
+import { MessageHandlerConfigBuilder } from '@message-queue-toolkit/core';
+import { AbstractSqsTrigger, deriveTriggerChannelName, } from './AbstractSqsTrigger.js';
+import { runFlatPipeline } from './dispatch.js';
+const TRIGGER_MESSAGE_TYPE = 'layered-loader.invalidation-trigger';
+export class SqsInvalidationTrigger extends AbstractSqsTrigger {
+    source;
+    messageType = TRIGGER_MESSAGE_TYPE;
+    channel;
+    messageSchema;
+    resolver;
+    publisher;
+    errorHandler;
+    constructor(params) {
+        super();
+        const { messageSchema, resolver, publisher, errorHandler, channel, ...source } = params;
+        this.source = source;
+        this.messageSchema = messageSchema;
+        this.resolver = resolver;
+        this.publisher = publisher;
+        this.errorHandler = errorHandler;
+        this.channel = channel ?? deriveTriggerChannelName(this.source);
+    }
+    buildContext() {
+        return {
+            resolver: this.resolver,
+            publisher: this.publisher,
+            channel: this.channel,
+            errorHandler: this.errorHandler,
+        };
+    }
+    buildHandlers() {
+        return new MessageHandlerConfigBuilder()
+            .addConfig(this.messageSchema, async (message, ctx) => {
+            try {
+                await runFlatPipeline(message, ctx.resolver, ctx.publisher);
+                return { result: 'success' };
+            }
+            catch (err) {
+                ctx.errorHandler?.(err, ctx.channel);
+                // Re-throw so message-queue-toolkit's standard retry/DLQ flow takes over.
+                throw err;
+            }
+        }, { messageType: TRIGGER_MESSAGE_TYPE })
+            .build();
+    }
+}
+//# sourceMappingURL=SqsInvalidationTrigger.js.map

package/dist/lib/triggers/SqsInvalidationTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqsInvalidationTrigger.js","sourceRoot":"","sources":["../../../lib/triggers/SqsInvalidationTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAGpG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAO/C,MAAM,oBAAoB,GAAG,qCAAqC,CAAA;AA2ClE,MAAM,OAAO,sBAAgD,SAAQ,kBAGpE;IACoB,MAAM,CAAkB;IACxB,WAAW,GAAG,oBAAoB,CAAA;IAClC,OAAO,CAAQ;IAEjB,aAAa,CAAqB;IAClC,QAAQ,CAAoD;IAC5D,SAAS,CAAgC;IACzC,YAAY,CAAiC;IAE9D,YAAY,MAA8C;QACxD,KAAK,EAAE,CAAA;QACP,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAA;QACvF,IAAI,CAAC,MAAM,GAAG,MAA0B,CAAA;QACxC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjE,CAAC;IAES,YAAY;QACpB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAA;IACH,CAAC;IAES,aAAa;QAKrB,OAAO,IAAI,2BAA2B,EAA0C;aAC7E,SAAS,CACR,IAAI,CAAC,aAAa,EAClB,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;YACrB,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;gBAC3D,OAAO,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAA;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,YAAY,EAAE,CAAC,GAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;gBAC7C,0EAA0E;gBAC1E,MAAM,GAAG,CAAA;YACX,CAAC;QACH,CAAC,EACD,EAAE,WAAW,EAAE,oBAAoB,EAAE,CACtC;aACA,KAAK,EAAE,CAAA;IACZ,CAAC;CACF"}

package/dist/lib/triggers/dispatch.d.ts

@@ -0,0 +1,19 @@
+import type { GroupNotificationPublisher, NotificationPublisher } from 'layered-loader';
+import type { GroupInvalidationAction, InvalidationAction, InvalidationResolver } from './types.js';
+/**
+ * Apply a resolved {@link InvalidationAction} to a flat
+ * {@link NotificationPublisher}.
+ */
+export declare function applyFlatAction(action: InvalidationAction, publisher: NotificationPublisher<unknown>): Promise<void>;
+/**
+ * Apply a resolved {@link GroupInvalidationAction} to a
+ * {@link GroupNotificationPublisher}.
+ */
+export declare function applyGroupAction(action: GroupInvalidationAction, publisher: GroupNotificationPublisher<unknown>): Promise<void>;
+/**
+ * Run the resolver and apply each emitted action sequentially. Errors
+ * propagate to the caller, allowing the transport adapter to decide whether
+ * to retry the source message.
+ */
+export declare function runFlatPipeline<TMessage>(message: TMessage, resolver: InvalidationResolver<TMessage, InvalidationAction>, publisher: NotificationPublisher<unknown>): Promise<void>;
+export declare function runGroupPipeline<TMessage>(message: TMessage, resolver: InvalidationResolver<TMessage, GroupInvalidationAction>, publisher: GroupNotificationPublisher<unknown>): Promise<void>;