@webda/azure 0.0.0-stage → 4.0.0-beta.13

package/lib/services/monitorlogger.service.js

@@ -0,0 +1,131 @@
+import { LogsIngestionClient } from "@azure/monitor-ingestion";
+import { Service, useCoreEvents, WebdaError } from "@webda/core";
+import { LogFilter, useWorkerOutput } from "@webda/workout";
+import { format } from "node:util";
+import { AzureParameters, getAzureCredential } from "./azure-parameters.js";
+/** Azure Monitor Logs Ingestion settings. */
+export class AzureMonitorLoggerParameters extends AzureParameters {
+    constructor() {
+        super(...arguments);
+        this.logLevel = "INFO";
+        this.batchSize = 100;
+        this.flushInterval = 5000;
+        this.maxBufferedLogs = 10000;
+    }
+}
+/** Forward Webda logs to a custom Azure Monitor table.
+ * @WebdaModda
+ */
+export class AzureMonitorLogger extends Service {
+    constructor() {
+        super(...arguments);
+        this.buffer = [];
+        /** Number of records dropped because the bounded buffer was full. */
+        this.droppedLogs = 0;
+        /** Last delivery error, available to health checks without recursively logging it. */
+        this.lastDeliveryFailed = false;
+    }
+    /**
+     * Perform init.
+     * @override
+     */
+    async init() {
+        await super.init();
+        const p = this.parameters;
+        if (!p.endpoint ||
+            !p.ruleId ||
+            !p.streamName ||
+            !Number.isInteger(p.batchSize) ||
+            p.batchSize < 1 ||
+            !Number.isInteger(p.maxBufferedLogs) ||
+            p.maxBufferedLogs < p.batchSize ||
+            p.flushInterval < 1) {
+            throw new WebdaError.BadRequest("Azure Monitor requires endpoint, ruleId, streamName and positive buffer settings");
+        }
+        this.removeListeners();
+        this.client = new LogsIngestionClient(p.endpoint, getAzureCredential(p));
+        this.messageListener = message => {
+            if (message.type === "log" && message.log && LogFilter(message.log.level, p.logLevel)) {
+                this._log(message.log.level, ...message.log.args);
+            }
+        };
+        useWorkerOutput().on("message", this.messageListener);
+        this.resultListenerOff = useCoreEvents("Webda.Result", () => this.sendLogs());
+        this.timer = setInterval(() => {
+            void this.sendLogs();
+        }, p.flushInterval);
+        this.timer.unref();
+        return this;
+    }
+    /**
+     * Buffer one record. SecretString values retain their masked representation.
+     * @param level - Worker log level
+     * @param args - Log arguments
+     */
+    _log(level, ...args) {
+        if (this.buffer.length >= this.parameters.maxBufferedLogs) {
+            this.droppedLogs++;
+            return;
+        }
+        this.buffer.push({ TimeGenerated: new Date().toISOString(), Level: level, Message: format(...args) });
+        if (this.buffer.length >= this.parameters.batchSize)
+            void this.sendLogs();
+    }
+    /**
+     * Serialize flushes; failed records stay at the front for the next scheduled retry.
+     * @returns Completion of the current flush attempt
+     */
+    sendLogs() {
+        if (this.sending)
+            return this.sending;
+        this.sending = this.flush().finally(() => {
+            this.sending = undefined;
+        });
+        return this.sending;
+    }
+    /**
+     * Deliver buffered records in bounded batches.
+     */
+    async flush() {
+        while (this.buffer.length) {
+            const records = this.buffer.splice(0, this.parameters.batchSize);
+            try {
+                await this.client.upload(this.parameters.ruleId, this.parameters.streamName, records);
+                this.lastDeliveryFailed = false;
+            }
+            catch {
+                this.lastDeliveryFailed = true;
+                this.buffer.unshift(...records);
+                const overflow = Math.max(0, this.buffer.length - this.parameters.maxBufferedLogs);
+                this.buffer.splice(this.parameters.maxBufferedLogs, overflow);
+                this.droppedLogs += overflow;
+                return;
+            }
+        }
+    }
+    /**
+     * Detach log forwarding and stop scheduled flushing.
+     */
+    removeListeners() {
+        if (this.messageListener)
+            useWorkerOutput().off("message", this.messageListener);
+        this.messageListener = undefined;
+        this.resultListenerOff?.();
+        this.resultListenerOff = undefined;
+        clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    /**
+     * Perform stop.
+     * @override
+     */
+    async stop() {
+        this.removeListeners();
+        await this.sendLogs();
+        await super.stop();
+        if (this.buffer.length)
+            throw new WebdaError.ServiceUnavailable("Unable to flush remaining Azure Monitor logs");
+    }
+}
+AzureMonitorLogger.Parameters = AzureMonitorLoggerParameters;
+//# sourceMappingURL=monitorlogger.service.js.map

package/lib/services/monitorlogger.service.js.map

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

package/lib/services/servicebus.service.d.ts

@@ -0,0 +1,128 @@
+import { ServiceBusAdministrationClient, ServiceBusClient, ServiceBusReceivedMessage, ServiceBusReceiver, ServiceBusSender } from "@azure/service-bus";
+import { MessageReceipt, PubSubService, Queue, QueueParameters, SecretString } from "@webda/core";
+import { CancelablePromise } from "@webda/utils";
+import { AzureParameters, AzureServiceParameters } from "./azure-parameters.js";
+import { AzureContributor, AzureDeployerInfo, AzureResourceContribution } from "./contributors.js";
+interface ServiceBusSettings extends AzureServiceParameters {
+    namespace: string;
+    connectionString?: string | SecretString;
+    createIfNotExists?: boolean;
+}
+/** Service Bus work queue settings. */
+export declare class ServiceBusQueueParameters extends QueueParameters implements ServiceBusSettings {
+    namespace: string;
+    connectionString?: string | SecretString;
+    createIfNotExists: boolean;
+    queue: string;
+    tenantId?: string;
+    clientId?: string;
+    clientSecret?: string | SecretString;
+    subscriptionId?: string;
+    endpoint?: string;
+    maxMessages: number;
+    maxWaitTimeInMs: number;
+    maxPendingMessages: number;
+    /**
+     * Perform load.
+     * @override
+     */
+    load(params?: any): this;
+}
+/** Service Bus peek-lock queue. Receipts retain their exact SDK message until completion or expiry.
+ * @WebdaModda
+ */
+export declare class ServiceBusQueue<T = any> extends Queue<T, ServiceBusQueueParameters> implements AzureContributor {
+    static Parameters: typeof ServiceBusQueueParameters;
+    protected client: ServiceBusClient;
+    protected admin: ServiceBusAdministrationClient;
+    protected sender: ServiceBusSender;
+    protected receiver: ServiceBusReceiver;
+    protected pending: Map<string, ServiceBusReceivedMessage>;
+    /**
+     * Perform init.
+     * @override
+     */
+    init(): Promise<this>;
+    /**
+     * Perform send message.
+     * @override
+     */
+    sendMessage(event: T): Promise<void>;
+    /**
+     * Perform receive message.
+     * @override
+     */
+    receiveMessage<L>(proto?: new () => L): Promise<MessageReceipt<L>[]>;
+    /**
+     * Perform delete message.
+     * @override
+     */
+    deleteMessage(handle: string): Promise<void>;
+    /**
+     * Perform size.
+     * @override
+     */
+    size(): Promise<number>;
+    /**
+     * Perform stop.
+     * @override
+     */
+    stop(): Promise<void>;
+    /**
+     * Describe the Azure resources and identity permissions required by this service.
+     * @param deployer - Deployment scope and identity helpers
+     * @returns The azure resources result
+     */
+    getAzureResources(deployer: AzureDeployerInfo): AzureResourceContribution;
+}
+/** Service Bus pub/sub settings. Omit subscription to create one temporary subscription per consumer. */
+export declare class ServiceBusPubSubParameters extends AzureParameters implements ServiceBusSettings {
+    namespace: string;
+    connectionString?: string | SecretString;
+    createIfNotExists: boolean;
+    topic: string;
+    subscription?: string;
+}
+/** Service Bus topic with explicit completion after successful processing.
+ * @WebdaModda
+ */
+export declare class ServiceBusPubSub<T = any> extends PubSubService<T, ServiceBusPubSubParameters> implements AzureContributor {
+    static Parameters: typeof ServiceBusPubSubParameters;
+    protected client: ServiceBusClient;
+    protected admin: ServiceBusAdministrationClient;
+    protected sender: ServiceBusSender;
+    protected consumers: Set<CancelablePromise<void>>;
+    /**
+     * Perform init.
+     * @override
+     */
+    init(): Promise<this>;
+    /**
+     * Perform send message.
+     * @override
+     */
+    sendMessage(event: T): Promise<void>;
+    /**
+     * Perform size.
+     * @override
+     */
+    size(): Promise<number>;
+    /**
+     * Perform consume.
+     * @override
+     */
+    consume(callback: (event: T) => Promise<void>, proto?: new () => T, onBind?: () => void): CancelablePromise;
+    /**
+     * Perform stop.
+     * @override
+     */
+    stop(): Promise<void>;
+    /**
+     * Describe the Azure resources and identity permissions required by this service.
+     * @param deployer - Deployment scope and identity helpers
+     * @returns The azure resources result
+     */
+    getAzureResources(deployer: AzureDeployerInfo): AzureResourceContribution;
+}
+export {};
+//# sourceMappingURL=servicebus.service.d.ts.map

package/lib/services/servicebus.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servicebus.service.d.ts","sources":["../../src/services/servicebus.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAa,MAAM,cAAc,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,sBAAsB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,UAAU,kBAAmB,SAAQ,sBAAsB;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA8DD,uCAAuC;AACvC,qBAAa,yBAA0B,SAAQ,eAAgB,YAAW,kBAAkB;IAC1F,SAAS,EAAG,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACzC,iBAAiB,UAAS;IAC1B,KAAK,EAAG,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,SAAM;IACjB,eAAe,SAAQ;IACvB,kBAAkB,SAAQ;IAE1B;;;OAGG;IACH,IAAI,CAAC,MAAM,GAAE,GAAQ,GAAG,IAAI,CAG3B;CACF;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAE,YAAW,gBAAgB;IAC3G,MAAM,CAAC,UAAU,mCAA6B;IAC9C,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC;IACpC,SAAS,CAAC,KAAK,EAAG,8BAA8B,CAAC;IACjD,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAG,kBAAkB,CAAC;IACxC,SAAS,CAAC,OAAO,yCAAgD;IAEjE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB1B;IAED;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzC;IAED;;;OAGG;IACG,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAuBzE;IAED;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjD;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAY1B;IAED;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,CAExE;CACF;AAED,yGAAyG;AACzG,qBAAa,0BAA2B,SAAQ,eAAgB,YAAW,kBAAkB;IAC3F,SAAS,EAAG,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACzC,iBAAiB,UAAS;IAC1B,KAAK,EAAG,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC,GAAG,GAAG,CACnC,SAAQ,aAAa,CAAC,CAAC,EAAE,0BAA0B,CACnD,YAAW,gBAAgB;IAE3B,MAAM,CAAC,UAAU,oCAA8B;IAC/C,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC;IACpC,SAAS,CAAC,KAAK,EAAG,8BAA8B,CAAC;IACjD,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC;IACpC,SAAS,CAAC,SAAS,+BAAgC;IAEnD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1B;IAED;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzC;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAK5B;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,iBAAiB,CAoE1G;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1B;IAED;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,CAExE;CACF"}

package/lib/services/servicebus.service.js

@@ -0,0 +1,324 @@
+import { ServiceBusAdministrationClient, ServiceBusClient } from "@azure/service-bus";
+import { PubSubService, Queue, QueueParameters, SecretString, WebdaError } from "@webda/core";
+import { CancelablePromise, JSONUtils } from "@webda/utils";
+import { randomUUID } from "node:crypto";
+import { AzureParameters, getAzureCredential, loadAzureParameters } from "./azure-parameters.js";
+/**
+ * Construct SDK clients without performing network I/O.
+ * @param params - Raw configuration parameters
+ * @returns The clients result
+ */
+function createClients(params) {
+    if (params.connectionString !== undefined) {
+        const connection = SecretString.from(params.connectionString, "connectionString");
+        return { client: new ServiceBusClient(connection), admin: new ServiceBusAdministrationClient(connection) };
+    }
+    const credential = getAzureCredential(params);
+    return {
+        client: new ServiceBusClient(params.namespace, credential),
+        admin: new ServiceBusAdministrationClient(params.namespace, credential)
+    };
+}
+/**
+ * Describe an existing namespace's messaging entities and managed identity permissions.
+ * @param params - Raw configuration parameters
+ * @param deployer - Deployment scope and identity helpers
+ * @param entity - Queue or topic name
+ * @param topic - Whether the entity is a topic
+ * @param subscription - Configured subscription name, if any
+ * @returns The contribute result
+ */
+function contribute(params, deployer, entity, topic, subscription) {
+    const namespace = params.namespace.split(".")[0];
+    const entityType = topic ? "topics" : "queues";
+    const name = `${namespace}/${entity}`;
+    const scope = `/subscriptions/${deployer.resources.subscriptionId}/resourceGroups/${deployer.resources.resourceGroup}/providers/Microsoft.ServiceBus/namespaces/${name.replace("/", `/${entityType}/`)}`;
+    const resources = [
+        { type: `Microsoft.ServiceBus/namespaces/${entityType}`, apiVersion: "2024-01-01", name, properties: {} }
+    ];
+    if (topic && subscription)
+        resources.push({
+            type: "Microsoft.ServiceBus/namespaces/topics/subscriptions",
+            apiVersion: "2024-01-01",
+            name: `${name}/${subscription}`,
+            dependsOn: [scope],
+            properties: {}
+        });
+    const roles = ["69a216fc-b8fb-44d8-bc22-1f3c2cd27a39", "4f6d3b9b-027b-4f4c-9142-0e5a2a2247e0"];
+    // Temporary subscriptions need management rights on the topic, in addition to data-plane access.
+    if (topic && !subscription)
+        roles.push("090c5cfd-751d-490a-894a-3ce6f1109419");
+    return {
+        resources,
+        roleAssignments: roles.map(role => ({
+            scope,
+            roleDefinitionId: `/subscriptions/${deployer.resources.subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/${role}`
+        }))
+    };
+}
+/** Service Bus work queue settings. */
+export class ServiceBusQueueParameters extends QueueParameters {
+    constructor() {
+        super(...arguments);
+        this.createIfNotExists = false;
+        this.maxMessages = 10;
+        this.maxWaitTimeInMs = 1000;
+        this.maxPendingMessages = 1000;
+    }
+    /**
+     * Perform load.
+     * @override
+     */
+    load(params = {}) {
+        super.load(params);
+        return loadAzureParameters(this);
+    }
+}
+/** Service Bus peek-lock queue. Receipts retain their exact SDK message until completion or expiry.
+ * @WebdaModda
+ */
+export class ServiceBusQueue extends Queue {
+    constructor() {
+        super(...arguments);
+        this.pending = new Map();
+    }
+    /**
+     * Perform init.
+     * @override
+     */
+    async init() {
+        await super.init();
+        const p = this.parameters;
+        if (!Number.isInteger(p.maxMessages) ||
+            p.maxMessages < 1 ||
+            !Number.isInteger(p.maxPendingMessages) ||
+            p.maxPendingMessages < p.maxMessages) {
+            throw new WebdaError.BadRequest("Service Bus requires positive message limits");
+        }
+        ({ client: this.client, admin: this.admin } = createClients(p));
+        if (p.createIfNotExists && !(await this.admin.queueExists(p.queue)))
+            await this.admin.createQueue(p.queue);
+        this.sender = this.client.createSender(p.queue);
+        this.receiver = this.client.createReceiver(p.queue, { receiveMode: "peekLock" });
+        return this;
+    }
+    /**
+     * Perform send message.
+     * @override
+     */
+    async sendMessage(event) {
+        await this.sender.sendMessages({ body: JSONUtils.stringify(event), contentType: "application/json" });
+        this.metrics.messages_sent.inc();
+    }
+    /**
+     * Perform receive message.
+     * @override
+     */
+    async receiveMessage(proto) {
+        for (const [handle, message] of this.pending) {
+            if (!message.lockedUntilUtc || message.lockedUntilUtc.getTime() <= Date.now())
+                this.pending.delete(handle);
+        }
+        const count = Math.min(this.parameters.maxMessages, this.parameters.maxPendingMessages - this.pending.size);
+        if (!count)
+            return [];
+        const messages = await this.receiver.receiveMessages(count, { maxWaitTimeInMs: this.parameters.maxWaitTimeInMs });
+        const receipts = [];
+        for (const message of messages) {
+            try {
+                const value = this.unserialize(typeof message.body === "string" ? message.body : JSONUtils.stringify(message.body), proto);
+                const handle = randomUUID();
+                this.pending.set(handle, message);
+                receipts.push({ Message: value, ReceiptHandle: handle });
+            }
+            catch {
+                this.metrics.errors.inc();
+                await this.receiver.abandonMessage(message);
+            }
+        }
+        return receipts;
+    }
+    /**
+     * Perform delete message.
+     * @override
+     */
+    async deleteMessage(handle) {
+        const message = this.pending.get(handle);
+        if (!message)
+            throw new WebdaError.NotFound("Service Bus receipt is unknown or expired");
+        await this.receiver.completeMessage(message);
+        this.pending.delete(handle);
+    }
+    /**
+     * Perform size.
+     * @override
+     */
+    async size() {
+        return (await this.admin.getQueueRuntimeProperties(this.parameters.queue)).activeMessageCount;
+    }
+    /**
+     * Perform stop.
+     * @override
+     */
+    async stop() {
+        try {
+            await this.receiver?.close();
+        }
+        finally {
+            this.pending.clear();
+            try {
+                await this.sender?.close();
+            }
+            finally {
+                await this.client?.close();
+            }
+        }
+        await super.stop();
+    }
+    /**
+     * Describe the Azure resources and identity permissions required by this service.
+     * @param deployer - Deployment scope and identity helpers
+     * @returns The azure resources result
+     */
+    getAzureResources(deployer) {
+        return contribute(this.parameters, deployer, this.parameters.queue, false);
+    }
+}
+ServiceBusQueue.Parameters = ServiceBusQueueParameters;
+/** Service Bus pub/sub settings. Omit subscription to create one temporary subscription per consumer. */
+export class ServiceBusPubSubParameters extends AzureParameters {
+    constructor() {
+        super(...arguments);
+        this.createIfNotExists = false;
+    }
+}
+/** Service Bus topic with explicit completion after successful processing.
+ * @WebdaModda
+ */
+export class ServiceBusPubSub extends PubSubService {
+    constructor() {
+        super(...arguments);
+        this.consumers = new Set();
+    }
+    /**
+     * Perform init.
+     * @override
+     */
+    async init() {
+        await super.init();
+        ({ client: this.client, admin: this.admin } = createClients(this.parameters));
+        if (this.parameters.createIfNotExists && !(await this.admin.topicExists(this.parameters.topic)))
+            await this.admin.createTopic(this.parameters.topic);
+        this.sender = this.client.createSender(this.parameters.topic);
+        return this;
+    }
+    /**
+     * Perform send message.
+     * @override
+     */
+    async sendMessage(event) {
+        await this.sender.sendMessages({ body: JSONUtils.stringify(event), contentType: "application/json" });
+        this.metrics.messages_sent.inc();
+    }
+    /**
+     * Perform size.
+     * @override
+     */
+    async size() {
+        return this.parameters.subscription
+            ? (await this.admin.getSubscriptionRuntimeProperties(this.parameters.topic, this.parameters.subscription))
+                .activeMessageCount
+            : 0;
+    }
+    /**
+     * Perform consume.
+     * @override
+     */
+    consume(callback, proto, onBind) {
+        const topic = this.parameters.topic;
+        const temporary = !this.parameters.subscription;
+        const subscription = this.parameters.subscription ?? `webda-${randomUUID()}`;
+        let receiver;
+        let created = false;
+        let closing;
+        const cleanup = () => (closing ?? (closing = (async () => {
+            try {
+                await receiver?.close();
+            }
+            finally {
+                if (created)
+                    await this.admin.deleteSubscription(topic, subscription);
+            }
+        })()));
+        const binding = (async () => {
+            if (temporary ||
+                (this.parameters.createIfNotExists && !(await this.admin.subscriptionExists(topic, subscription)))) {
+                await this.admin.createSubscription(topic, subscription, temporary ? { autoDeleteOnIdle: "PT5M" } : {});
+                created = temporary;
+            }
+            receiver = this.client.createReceiver(topic, subscription, { receiveMode: "peekLock" });
+            receiver.subscribe({
+                processMessage: async (message) => {
+                    this.metrics.messages_received.inc();
+                    const end = this.metrics.processing_duration.startTimer();
+                    try {
+                        await callback(this.unserialize(typeof message.body === "string" ? message.body : JSONUtils.stringify(message.body), proto));
+                        await receiver.completeMessage(message);
+                    }
+                    catch {
+                        this.metrics.errors.inc();
+                        await receiver.abandonMessage(message);
+                    }
+                    finally {
+                        end();
+                    }
+                },
+                processError: async () => {
+                    this.metrics.errors.inc();
+                }
+            }, { autoCompleteMessages: false });
+            onBind?.();
+        })();
+        const consumer = new CancelablePromise((_resolve, reject) => {
+            void binding.catch(async (error) => {
+                await cleanup().catch(() => { });
+                reject(error);
+            });
+        }, async () => {
+            await binding.catch(() => { });
+            await cleanup();
+        });
+        this.consumers.add(consumer);
+        // The consumer remains pending until cancellation or failure; observe its rejection during shutdown.
+        void consumer.catch(() => this.consumers.delete(consumer));
+        return consumer;
+    }
+    /**
+     * Perform stop.
+     * @override
+     */
+    async stop() {
+        try {
+            await Promise.all([...this.consumers].map(consumer => consumer.cancel()));
+        }
+        finally {
+            try {
+                await this.sender?.close();
+            }
+            finally {
+                await this.client?.close();
+            }
+        }
+        await super.stop();
+    }
+    /**
+     * Describe the Azure resources and identity permissions required by this service.
+     * @param deployer - Deployment scope and identity helpers
+     * @returns The azure resources result
+     */
+    getAzureResources(deployer) {
+        return contribute(this.parameters, deployer, this.parameters.topic, true, this.parameters.subscription);
+    }
+}
+ServiceBusPubSub.Parameters = ServiceBusPubSubParameters;
+//# sourceMappingURL=servicebus.service.js.map

package/lib/services/servicebus.service.js.map

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

package/lib/template.d.ts

@@ -0,0 +1,53 @@
+/** ARM template shape shared by Azure deployers and contributors. */
+export interface AzureTemplate {
+    $schema: string;
+    contentVersion: string;
+    parameters: Record<string, {
+        type: string;
+    }>;
+    resources: Record<string, any>[];
+    outputs: Record<string, any>;
+}
+/**
+ * Create an empty ARM deployment template.
+ * @returns The azure template result
+ */
+export declare function createAzureTemplate(): AzureTemplate;
+/**
+ * Quote a literal embedded inside an ARM expression.
+ * @param value - Value to convert or protect
+ * @returns The arm literal result
+ */
+export declare function armLiteral(value: string): string;
+/**
+ * Strip the brackets of an expression, or quote a literal for a larger expression.
+ * @param value - Value to convert or protect
+ * @returns The arm value result
+ */
+export declare function armValue(value: string): string;
+/**
+ * Construct a resource identifier without interpolating unescaped names.
+ * @param type - ARM resource type
+ * @param names - Resource name segments
+ * @returns The resource id result
+ */
+export declare function resourceId(type: string, ...names: string[]): string;
+/**
+ * Resource identifier for a role assignment at a resource scope.
+ * @param resource - ARM resource declaration
+ * @returns The role assignment id result
+ */
+export declare function roleAssignmentId(resource: Record<string, any>): string;
+/**
+ * Azure Container Apps uses five cron fields; sub-minute schedules cannot be represented.
+ * @param cron - Cron expression
+ * @returns The container apps schedule result
+ */
+export declare function containerAppsSchedule(cron: string): string;
+/**
+ * Functions timers use six-field NCRONTAB with seconds first.
+ * @param cron - Cron expression
+ * @returns The functions schedule result
+ */
+export declare function functionsSchedule(cron: string): string;
+//# sourceMappingURL=template.d.ts.map

package/lib/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sources":["../src/template.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AACD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AACD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD"}