@gradientedge/cdk-utils-azure 2.52.1 → 2.53.0

package/dist/src/services/servicebus/main.d.ts

@@ -29,6 +29,13 @@ export declare class AzureServiceBusManager {
      * @see [Pulumi Azure Native Service Bus Namespace]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/service bus/namespace/}
      */
     createServiceBusNamespace(id: string, scope: CommonAzureConstruct, props: ServiceBusNamespaceProps, resourceOptions?: ResourceOptions): import("@pulumi/azure-native/servicebus/namespace.js").Namespace;
+    /**
+     * Provisions the geo-replication topology for a Service Bus namespace via an ARM
+     * deployment. The deployment PATCHes the existing namespace using the 2024-01-01
+     * Service Bus API version, which exposes the `geoDataReplication` property that is
+     * not yet surfaced by `@pulumi/azure-native`'s strongly-typed `Namespace` resource.
+     */
+    private createServiceBusGeoReplicationDeployment;
     /**
      * @summary Method to create a new service bus topic
      * @param id scoped id of the resource

package/dist/src/services/servicebus/main.js

@@ -1,4 +1,6 @@
+import { Deployment, DeploymentMode } from '@pulumi/azure-native/resources/index.js';
 import { getQueueOutput, ManagedServiceIdentityType, Namespace, Queue, QueueAuthorizationRule, SkuName, Subscription, Topic, } from '@pulumi/azure-native/servicebus/index.js';
+import { all, output } from '@pulumi/pulumi';
 /**
  * Provides operations on Azure Servicebus using Pulumi
  * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
@@ -29,25 +31,89 @@ export class AzureServiceBusManager {
     createServiceBusNamespace(id, scope, props, resourceOptions) {
         if (!props)
             throw new Error(`Props undefined for ${id}`);
+        const { enableGeoReplication, geoReplication, ...namespaceProps } = props;
+        if (enableGeoReplication && !geoReplication) {
+            throw new Error(`enableGeoReplication is true but geoReplication config is missing for ${id}`);
+        }
         // Get resource group name
-        const resourceGroupName = props.resourceGroupName ?? scope.resourceNameFormatter.format(scope.props.resourceGroupName);
-        return new Namespace(`${id}-sn`, {
-            ...props,
-            namespaceName: scope.resourceNameFormatter.format(props.namespaceName?.toString(), scope.props.resourceNameOptions?.serviceBusNamespace),
+        const resourceGroupName = namespaceProps.resourceGroupName ?? scope.resourceNameFormatter.format(scope.props.resourceGroupName);
+        const sku = namespaceProps.sku ?? { name: SkuName.Standard };
+        if (enableGeoReplication) {
+            // Geo-replication requires Premium. Callers pass `sku` as a literal SBSkuArgs in
+            // practice; validate synchronously so misconfiguration fails at construct time
+            // rather than during preview/up.
+            const skuName = sku.name;
+            if (skuName !== SkuName.Premium) {
+                throw new Error(`Service Bus geo-replication requires the Premium SKU, but ${id} was configured with "${String(skuName)}"`);
+            }
+        }
+        const namespace = new Namespace(`${id}-sn`, {
+            ...namespaceProps,
+            namespaceName: scope.resourceNameFormatter.format(namespaceProps.namespaceName?.toString(), scope.props.resourceNameOptions?.serviceBusNamespace),
             resourceGroupName,
-            location: props.location ?? scope.props.location,
-            identity: props.identity ?? {
+            location: namespaceProps.location ?? scope.props.location,
+            identity: namespaceProps.identity ?? {
                 type: ManagedServiceIdentityType.SystemAssigned,
             },
-            sku: props.sku ?? {
-                name: SkuName.Standard,
-            },
+            sku,
             tags: {
                 environment: scope.props.stage,
                 ...scope.props.defaultTags,
-                ...props.tags,
+                ...namespaceProps.tags,
             },
         }, { parent: scope, ...resourceOptions });
+        if (enableGeoReplication && geoReplication) {
+            this.createServiceBusGeoReplicationDeployment(id, scope, namespace, resourceGroupName, sku, geoReplication, resourceOptions);
+        }
+        return namespace;
+    }
+    /**
+     * Provisions the geo-replication topology for a Service Bus namespace via an ARM
+     * deployment. The deployment PATCHes the existing namespace using the 2024-01-01
+     * Service Bus API version, which exposes the `geoDataReplication` property that is
+     * not yet surfaced by `@pulumi/azure-native`'s strongly-typed `Namespace` resource.
+     */
+    createServiceBusGeoReplicationDeployment(id, scope, namespace, resourceGroupName, sku, geoReplication, resourceOptions) {
+        const template = all([
+            namespace.name,
+            namespace.location,
+            output(sku),
+            output(geoReplication.maxReplicationLagDurationInSeconds ?? 0),
+            output(geoReplication.locations),
+        ]).apply(([namespaceName, location, resolvedSku, maxLagSeconds, locations]) => ({
+            $schema: 'https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#',
+            contentVersion: '1.0.0.0',
+            resources: [
+                {
+                    type: 'Microsoft.ServiceBus/namespaces',
+                    apiVersion: '2024-01-01',
+                    name: namespaceName,
+                    location,
+                    sku: {
+                        name: resolvedSku.name,
+                        tier: resolvedSku.tier ?? resolvedSku.name,
+                        capacity: resolvedSku.capacity ?? 1,
+                    },
+                    properties: {
+                        geoDataReplication: {
+                            maxReplicationLagDurationInSeconds: maxLagSeconds,
+                            locations: locations.map(location => ({
+                                locationName: location.locationName,
+                                roleType: location.roleType,
+                            })),
+                        },
+                    },
+                },
+            ],
+        }));
+        return new Deployment(`${id}-sn-geo`, {
+            resourceGroupName,
+            deploymentName: scope.resourceNameFormatter.format(`${id}-sn-geo`),
+            properties: {
+                mode: DeploymentMode.Incremental,
+                template,
+            },
+        }, { ...resourceOptions, parent: namespace, dependsOn: [namespace] });
     }
     /**
      * @summary Method to create a new service bus topic

package/dist/src/services/servicebus/types.d.ts

@@ -1,10 +1,55 @@
 import { GetQueueOutputArgs, NamespaceArgs, QueueArgs, QueueAuthorizationRuleArgs, SubscriptionArgs, TopicArgs } from '@pulumi/azure-native/servicebus/index.js';
+import { Input } from '@pulumi/pulumi';
+/**
+ * Role of a replica within a Service Bus geo-replication topology. Mirrors the
+ * `roleType` values accepted by the Service Bus ARM API. Declared locally because
+ * `@pulumi/azure-native` does not yet surface a strongly-typed enum for this field;
+ * swap to the upstream enum once it ships.
+ * @category Enum
+ */
+export declare const ServiceBusGeoReplicationRoleType: {
+    readonly Primary: "Primary";
+    readonly Secondary: "Secondary";
+};
+export type ServiceBusGeoReplicationRoleType = (typeof ServiceBusGeoReplicationRoleType)[keyof typeof ServiceBusGeoReplicationRoleType];
+/**
+ * Geo-replication replica configuration for a Service Bus namespace.
+ * @category Interface
+ */
+export interface ServiceBusGeoReplicationLocation {
+    /** Azure region name (e.g. "westeurope"). */
+    locationName: Input<string>;
+    /** Replica role — exactly one entry must be `Primary`, the rest `Secondary`. */
+    roleType: Input<ServiceBusGeoReplicationRoleType>;
+}
+/**
+ * Geo-replication configuration for a Service Bus namespace.
+ * Provisioned via an ARM deployment using the 2024-01-01 Service Bus API version,
+ * which is the first stable version that exposes the `geoDataReplication` block.
+ * @category Interface
+ */
+export interface ServiceBusGeoReplicationProps {
+    /**
+     * Replication lag tolerance in seconds. `0` means synchronous replication.
+     * Async values typically sit in the 60–1440 range.
+     */
+    maxReplicationLagDurationInSeconds?: Input<number>;
+    /** Primary + one or more secondary regions. */
+    locations: Input<Input<ServiceBusGeoReplicationLocation>[]>;
+}
 /**
  * Properties for creating a Service Bus namespace
  * @see [Pulumi Azure Native Service Bus Namespace]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/servicebus/namespace/}
  * @category Interface
  */
 export interface ServiceBusNamespaceProps extends NamespaceArgs {
+    /**
+     * Enables Service Bus geo-replication. Requires the namespace SKU to be `Premium`.
+     * When `true`, {@link geoReplication} must be supplied.
+     */
+    enableGeoReplication?: boolean;
+    /** Geo-replication topology. Only consumed when {@link enableGeoReplication} is `true`. */
+    geoReplication?: ServiceBusGeoReplicationProps;
 }
 /**
  * Properties for creating a Service Bus topic

package/dist/src/services/servicebus/types.js

@@ -1 +1,11 @@
-export {};
+/**
+ * Role of a replica within a Service Bus geo-replication topology. Mirrors the
+ * `roleType` values accepted by the Service Bus ARM API. Declared locally because
+ * `@pulumi/azure-native` does not yet surface a strongly-typed enum for this field;
+ * swap to the upstream enum once it ships.
+ * @category Enum
+ */
+export const ServiceBusGeoReplicationRoleType = {
+    Primary: 'Primary',
+    Secondary: 'Secondary',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils-azure",
-  "version": "2.52.1",
+  "version": "2.53.0",
   "description": "Azure Pulumi utilities for @gradientedge/cdk-utils",
   "type": "module",
   "main": "dist/src/index.js",
@@ -17,7 +17,7 @@
     "@pulumi/archive": "0.5.0",
     "@pulumi/azure-native": "3.19.0",
     "@pulumi/azuread": "6.9.1",
-    "@pulumi/pulumi": "3.244.0",
+    "@pulumi/pulumi": "3.245.0",
     "@types/lodash": "4.17.24",
     "app-root-path": "3.1.0",
     "lodash": "4.18.1",