akeyless-server-commons 1.0.203 → 1.0.205

package/dist/cjs/managers/rabbitmq_manager.d.ts

@@ -0,0 +1,60 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type EventHeaderValue = string | number | boolean;
+export interface RabbitEvent<T extends JsonValue = JsonValue> {
+    body: T;
+    event_id?: string;
+    created_at?: string;
+    redelivered: boolean;
+    headers: Record<string, unknown>;
+}
+export interface PushEventOptions {
+    /** RabbitMQ message time-to-live, in seconds. */
+    ttl_seconds?: number;
+    headers?: Record<string, EventHeaderValue>;
+}
+export interface SubscribeOptions {
+    /** Requeue messages when the handler throws or rejects. Defaults to true. */
+    requeue_on_error?: boolean;
+}
+export interface Subscription {
+    queue_name: string;
+    consumer_tag: string;
+    cancel(): Promise<void>;
+}
+export type EventHandler<T extends JsonValue = JsonValue> = (event: RabbitEvent<T>) => void | Promise<void>;
+/**
+ * JSON event transport backed by durable fanout exchanges and durable queues.
+ *
+ * Each channel name maps to an exchange. Each distinct subscriber name gets a
+ * queue and therefore its own copy of every event. Instances sharing the same
+ * subscriber name compete for work, which supports horizontal scaling.
+ */
+export declare class RabbitManager {
+    readonly prefetch_count: number;
+    private connection;
+    private channel;
+    private connecting;
+    constructor();
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    push_event<T extends JsonValue>(channel_name: string, payload: T, options?: PushEventOptions): Promise<string>;
+    private subscriptions;
+    subscribe_for_channel<T extends JsonValue>(channel_name: string, subscriber_name: string, handler: EventHandler<T>, options?: SubscribeOptions): Promise<Subscription>;
+    cancel_subscriptions(): Promise<void>;
+    pull_and_delete<T extends JsonValue>(channel_name: string, subscriber_name: string): Promise<RabbitEvent<T> | undefined>;
+    /**
+     * Diagnostic peek implemented as get + nack + requeue.
+     * It is not a reliable queue browser: the same event can repeat or move.
+     */
+    pull_and_leave<T extends JsonValue>(channel_name: string, subscriber_name: string): Promise<RabbitEvent<T> | undefined>;
+    private open_connection;
+    private get_channel;
+    private declare_exchange;
+    private declare_subscription;
+    private handle_message;
+    private to_event;
+    private validate_name;
+}
+export declare const rabbitmq: RabbitManager;

package/dist/cjs/managers/rabbitmq_manager.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rabbitmq = exports.RabbitManager = void 0;
+const amqplib_1 = __importDefault(require("amqplib"));
+const node_crypto_1 = require("node:crypto");
+const logger_manager_1 = require("./logger_manager");
+const SAFE_NAME = /^[A-Za-z0-9_.:-]{1,120}$/;
+/**
+ * JSON event transport backed by durable fanout exchanges and durable queues.
+ *
+ * Each channel name maps to an exchange. Each distinct subscriber name gets a
+ * queue and therefore its own copy of every event. Instances sharing the same
+ * subscriber name compete for work, which supports horizontal scaling.
+ */
+class RabbitManager {
+    prefetch_count = 10;
+    connection;
+    channel;
+    connecting;
+    constructor() {
+        if (!(process.env.RABBITMQ_URL ?? "")) {
+            logger_manager_1.logger.warn("Missing ENV parameter RABBITMQ_URL");
+        }
+    }
+    async connect() {
+        if (this.connection && this.channel)
+            return;
+        this.connecting ??= this.open_connection().finally(() => {
+            this.connecting = undefined;
+        });
+        await this.connecting;
+    }
+    async close() {
+        const channel = this.channel;
+        const connection = this.connection;
+        this.channel = undefined;
+        this.connection = undefined;
+        if (channel)
+            await channel.close().catch(() => undefined);
+        if (connection)
+            await connection.close().catch(() => undefined);
+    }
+    async push_event(channel_name, payload, options = {}) {
+        const channel = await this.declare_exchange(channel_name);
+        const { ttl_seconds, headers = {} } = options;
+        if (ttl_seconds !== undefined && (!Number.isFinite(ttl_seconds) || ttl_seconds <= 0)) {
+            throw new Error("ttl_seconds must be a finite number greater than zero");
+        }
+        let encoded;
+        try {
+            encoded = JSON.stringify(payload);
+        }
+        catch (error) {
+            throw new Error("payload must be JSON serializable", { cause: error });
+        }
+        if (encoded === undefined)
+            throw new Error("payload must be JSON serializable");
+        const event_id = (0, node_crypto_1.randomUUID)();
+        const created_at = new Date().toISOString();
+        channel.publish(channel_name, "", Buffer.from(encoded, "utf8"), {
+            contentType: "application/json",
+            contentEncoding: "utf-8",
+            persistent: true,
+            messageId: event_id,
+            timestamp: Math.floor(Date.now() / 1_000),
+            ...(ttl_seconds === undefined ? {} : { expiration: String(Math.round(ttl_seconds * 1_000)) }),
+            headers: { created_at, ...headers },
+        });
+        await channel.waitForConfirms();
+        return event_id;
+    }
+    subscriptions = [];
+    async subscribe_for_channel(channel_name, subscriber_name, handler, options = {}) {
+        const { channel, queue_name } = await this.declare_subscription(channel_name, subscriber_name);
+        const requeue_on_error = options.requeue_on_error ?? true;
+        const reply = await channel.consume(queue_name, (message) => {
+            if (!message)
+                return;
+            void this.handle_message(channel, message, handler, requeue_on_error);
+        }, { noAck: false });
+        const subscription = {
+            queue_name,
+            consumer_tag: reply.consumerTag,
+            cancel: async () => {
+                await channel.cancel(reply.consumerTag);
+            },
+        };
+        this.subscriptions.push(subscription);
+        return subscription;
+    }
+    async cancel_subscriptions() {
+        await Promise.all(this.subscriptions.map((subscription) => subscription.cancel()));
+    }
+    async pull_and_delete(channel_name, subscriber_name) {
+        const { channel, queue_name } = await this.declare_subscription(channel_name, subscriber_name);
+        const message = await channel.get(queue_name, { noAck: false });
+        if (!message)
+            return undefined;
+        const event = this.to_event(message);
+        channel.ack(message);
+        return event;
+    }
+    /**
+     * Diagnostic peek implemented as get + nack + requeue.
+     * It is not a reliable queue browser: the same event can repeat or move.
+     */
+    async pull_and_leave(channel_name, subscriber_name) {
+        const { channel, queue_name } = await this.declare_subscription(channel_name, subscriber_name);
+        const message = await channel.get(queue_name, { noAck: false });
+        if (!message)
+            return undefined;
+        const event = this.to_event(message);
+        channel.nack(message, false, true);
+        return event;
+    }
+    async open_connection() {
+        if (!(process.env.RABBITMQ_URL ?? "")) {
+            return;
+        }
+        const connection_url = new URL(process.env.RABBITMQ_URL);
+        if (!connection_url.searchParams.has("heartbeat")) {
+            connection_url.searchParams.set("heartbeat", "30");
+        }
+        const connection = await amqplib_1.default.connect(connection_url.toString(), { timeout: 30_000 });
+        const channel = await connection.createConfirmChannel();
+        await channel.prefetch(this.prefetch_count);
+        this.connection = connection;
+        this.channel = channel;
+    }
+    async get_channel() {
+        await this.connect();
+        if (!this.channel)
+            throw new Error("RabbitMQ channel is not available");
+        return this.channel;
+    }
+    async declare_exchange(channel_name) {
+        this.validate_name(channel_name, "channel_name");
+        const channel = await this.get_channel();
+        await channel.assertExchange(channel_name, "fanout", { durable: true });
+        return channel;
+    }
+    async declare_subscription(channel_name, subscriber_name) {
+        this.validate_name(channel_name, "channel_name");
+        this.validate_name(subscriber_name, "subscriber_name");
+        const channel = await this.declare_exchange(channel_name);
+        const queue_name = `${channel_name}.${subscriber_name}`;
+        await channel.assertQueue(queue_name, { durable: true });
+        await channel.bindQueue(queue_name, channel_name, "");
+        return { channel, queue_name };
+    }
+    async handle_message(channel, message, handler, requeue_on_error) {
+        try {
+            await handler(this.to_event(message));
+            channel.ack(message);
+        }
+        catch (error) {
+            console.error(`RabbitMQ handler failed for ${message.properties.messageId ?? "unknown"}`, error);
+            channel.nack(message, false, requeue_on_error);
+        }
+    }
+    to_event(message) {
+        let body;
+        try {
+            body = JSON.parse(message.content.toString("utf8"));
+        }
+        catch (error) {
+            throw new Error("received a message that is not valid JSON", { cause: error });
+        }
+        const headers = { ...message.properties.headers };
+        const created_at = headers.created_at;
+        return {
+            body,
+            redelivered: message.fields.redelivered,
+            headers,
+            ...(message.properties.messageId ? { event_id: message.properties.messageId } : {}),
+            ...(typeof created_at === "string" ? { created_at } : {}),
+        };
+    }
+    validate_name(value, parameter) {
+        if (!SAFE_NAME.test(value)) {
+            throw new Error(`${parameter} must be 1-120 characters using letters, digits, _, ., :, or -`);
+        }
+    }
+}
+exports.RabbitManager = RabbitManager;
+exports.rabbitmq = new RabbitManager();
+//# sourceMappingURL=rabbitmq_manager.js.map

package/dist/cjs/managers/rabbitmq_manager.js.map

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

package/dist/esm/helpers/index.d.ts

@@ -7,7 +7,7 @@ export * from "./notification_helpers";
 export * from "./email_helpers";
 export * from "./phone_number_helpers";
 export * from "./tasks_helpers";
+export * from "./postponed_actions";
 export * from "./boards_helpers";
 export * from "./redis";
 export * from "./location_helpers";
-export * from "./rabbitmq_helpers";

package/dist/esm/helpers/index.js

@@ -7,8 +7,8 @@ export * from "./notification_helpers";
 export * from "./email_helpers";
 export * from "./phone_number_helpers";
 export * from "./tasks_helpers";
+export * from "./postponed_actions";
 export * from "./boards_helpers";
 export * from "./redis";
 export * from "./location_helpers";
-export * from "./rabbitmq_helpers";
 //# sourceMappingURL=index.js.map

package/dist/esm/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC"}

package/dist/esm/helpers/postponed_actions.d.ts

@@ -0,0 +1,113 @@
+import { TObject } from "akeyless-types-commons";
+export declare enum PostponedActionStatus {
+    pending = "pending",
+    processing = "processing",
+    completed = "completed",
+    cancelled = "cancelled",
+    failed = "failed"
+}
+export type PostponedActionTime = Date | string | {
+    minutes?: number;
+    hours?: number;
+};
+export type JsonPayload = TObject<any>;
+export interface PostponedAction {
+    key: string;
+    details: JsonPayload;
+    action_type: string;
+    description: string;
+    execute_at: Date;
+    status: PostponedActionStatus;
+    attempt_count: number;
+    created_at: Date;
+    updated_at: Date;
+    started_at?: Date;
+    completed_at?: Date;
+    cancelled_at?: Date;
+    failed_at?: Date;
+    error?: string;
+}
+export interface AddPostponedAction {
+    key: string;
+    details: JsonPayload;
+    action_type: string;
+    description: string;
+    execute_at: PostponedActionTime;
+}
+export interface UpdatePostponedAction {
+    details?: JsonPayload;
+    action_type?: string;
+    description?: string;
+    execute_at?: PostponedActionTime;
+}
+export declare const resolve_postponed_action_time: (value: PostponedActionTime, now?: Date) => Date;
+export declare const get_postponed_action: (key: string) => Promise<PostponedAction | null>;
+export declare const add_postponed_action: (input: AddPostponedAction) => Promise<PostponedAction>;
+export declare const update_postponed_action: (key: string, input: UpdatePostponedAction) => Promise<void>;
+export declare const repostpone_postponed_action: (key: string, execute_at: PostponedActionTime) => Promise<void>;
+export declare const cancel_postponed_action: (key: string) => Promise<void>;
+export declare const complete_postponed_action: (key: string) => Promise<void>;
+export declare const fail_postponed_action: (key: string, error: unknown) => Promise<void>;
+export declare const delete_postponed_action: (key: string) => Promise<void>;
+export declare const claim_postponed_action: (key: string, action_type: string, now?: Date | undefined) => Promise<PostponedAction | null>;
+export declare const claim_due_postponed_actions: (action_type: string, limit?: number | undefined, now?: Date | undefined) => Promise<PostponedAction[]>;
+/**
+ * @example Add an action for a specific date and time.
+ * ```ts
+ * await postponed_actions.add({
+ *     key: "subscription:123:expire",
+ *     action_type: "subscription_expiration",
+ *     description: "Expire subscription 123",
+ *     details: { subscription_id: "123", notify_customer: true },
+ *     execute_at: new Date("2026-08-01T12:00:00Z"),
+ * });
+ * ```
+ *
+ * @example Add an action relative to the current time. Adding the same key
+ * updates the pending action.
+ * ```ts
+ * await postponed_actions.add({
+ *     key: "invoice:456:reminder",
+ *     action_type: "invoice_reminder",
+ *     description: "Send invoice 456 reminder",
+ *     details: { invoice_id: "456" },
+ *     execute_at: { hours: 2, minutes: 30 },
+ * });
+ * ```
+ *
+ * @example Update, repostpone, or cancel a pending action.
+ * ```ts
+ * await postponed_actions.update("invoice:456:reminder", {
+ *     description: "Send the final invoice reminder",
+ *     execute_at: { minutes: 15 },
+ * });
+ * await postponed_actions.repostpone("invoice:456:reminder", { hours: 1 });
+ * await postponed_actions.cancel("invoice:456:reminder");
+ * ```
+ *
+ * @example Claim and execute due actions. Claiming is atomic, so concurrent
+ * workers cannot claim the same action.
+ * ```ts
+ * const actions = await postponed_actions.claim_due("invoice_reminder", 25);
+ * for (const action of actions) {
+ *     try {
+ *         await execute_action(action.details);
+ *         await postponed_actions.complete(action.key);
+ *     } catch (error) {
+ *         await postponed_actions.fail(action.key, error);
+ *     }
+ * }
+ * ```
+ */
+export declare const postponed_actions: {
+    get: (key: string) => Promise<PostponedAction | null>;
+    add: (input: AddPostponedAction) => Promise<PostponedAction>;
+    update: (key: string, input: UpdatePostponedAction) => Promise<void>;
+    repostpone: (key: string, execute_at: PostponedActionTime) => Promise<void>;
+    cancel: (key: string) => Promise<void>;
+    complete: (key: string) => Promise<void>;
+    fail: (key: string, error: unknown) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    claim: (key: string, action_type: string, now?: Date | undefined) => Promise<PostponedAction | null>;
+    claim_due: (action_type: string, limit?: number | undefined, now?: Date | undefined) => Promise<PostponedAction[]>;
+};