@gradientedge/cdk-utils-azure 2.52.1 → 2.53.1

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

@@ -1,7 +1,7 @@
 import { GetSystemTopicResult, SystemTopic } from '@pulumi/azure-native/eventgrid/index.js';
 import { Output, ResourceOptions } from '@pulumi/pulumi';
 import { CommonAzureConstruct } from '../../common/index.js';
-import { EventgridEventSubscriptionProps, EventgridSystemTopicEventSubscriptionProps, EventgridSystemTopicProps, EventgridTopicProps, ResolveEventgridTopicProps } from './types.js';
+import { EventgridEventSubscriptionProps, EventgridSystemTopicEventSubscriptionProps, EventgridSystemTopicProps, EventgridTopicProps, ResolveEventgridTopicProps, ResolveEventgridSystemTopicProps } from './types.js';
 /**
  * Provides operations on Azure Event Grid using Pulumi
  * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
@@ -67,4 +67,13 @@ export declare class AzureEventgridManager {
      * @see [Pulumi Azure Native Event Grid System Topic Event Subscription]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/eventgrid/systemtopiceventsubscription/}
      */
     createEventgridSystemTopicEventSubscription(id: string, scope: CommonAzureConstruct, props: EventgridSystemTopicEventSubscriptionProps, systemTopic: SystemTopic | Output<GetSystemTopicResult>, resourceOptions?: ResourceOptions): import("@pulumi/azure-native/eventgrid/systemTopicEventSubscription.js").SystemTopicEventSubscription;
+    /**
+     * @summary Method to resolve an existing eventgrid system topic
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props eventgrid system topic properties
+     * @param resourceOptions Optional settings to control resource behaviour
+     * @see [Pulumi Azure Native Event Grid System Topic Lookup]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/eventgrid/getsystemtopic/}
+     */
+    resolveEventgridSystemTopic(id: string, scope: CommonAzureConstruct, props: ResolveEventgridSystemTopicProps, resourceOptions?: ResourceOptions): Output<GetSystemTopicResult>;
 }

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

@@ -1,4 +1,4 @@
-import { DataResidencyBoundary, EventDeliverySchema, EventSubscription, getTopicOutput, SystemTopic, SystemTopicEventSubscription, TlsVersion, Topic, } from '@pulumi/azure-native/eventgrid/index.js';
+import { DataResidencyBoundary, EventDeliverySchema, EventSubscription, getTopicOutput, getSystemTopicOutput, SystemTopic, SystemTopicEventSubscription, TlsVersion, Topic, } from '@pulumi/azure-native/eventgrid/index.js';
 /**
  * Provides operations on Azure Event Grid using Pulumi
  * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
@@ -126,4 +126,21 @@ export class AzureEventgridManager {
             resourceGroupName,
         }, { parent: scope, ...resourceOptions });
     }
+    /**
+     * @summary Method to resolve an existing eventgrid system topic
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props eventgrid system topic properties
+     * @param resourceOptions Optional settings to control resource behaviour
+     * @see [Pulumi Azure Native Event Grid System Topic Lookup]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/eventgrid/getsystemtopic/}
+     */
+    resolveEventgridSystemTopic(id, scope, props, resourceOptions) {
+        if (!props)
+            throw new Error(`Props undefined for ${id}`);
+        return getSystemTopicOutput({
+            systemTopicName: props.systemTopicName ??
+                scope.resourceNameFormatter.format(props.systemTopicName, scope.props.resourceNameOptions?.eventGridSystemTopic),
+            resourceGroupName: props.resourceGroupName ?? scope.resourceNameFormatter.format(scope.props.resourceGroupName),
+        }, { parent: scope, ...resourceOptions });
+    }
 }

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

@@ -1,4 +1,4 @@
-import { EventSubscriptionArgs, GetTopicOutputArgs, SystemTopicArgs, SystemTopicEventSubscriptionArgs, TopicArgs } from '@pulumi/azure-native/eventgrid/index.js';
+import { EventSubscriptionArgs, GetSystemTopicOutputArgs, GetTopicOutputArgs, SystemTopicArgs, SystemTopicEventSubscriptionArgs, TopicArgs } from '@pulumi/azure-native/eventgrid/index.js';
 /**
  * Properties for creating an EventGrid topic
  * @see [Pulumi Azure Native Event Grid Topic]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/eventgrid/topic/}
@@ -34,3 +34,10 @@ export interface EventgridSystemTopicEventSubscriptionProps extends SystemTopicE
  */
 export interface ResolveEventgridTopicProps extends GetTopicOutputArgs {
 }
+/**
+ * Properties for resolving an existing EventGrid system topic
+ * @see [Pulumi Azure Native Event Grid System Topic]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/eventgrid/systemtopic/}
+ * @category Interface
+ */
+export interface ResolveEventgridSystemTopicProps extends GetSystemTopicOutputArgs {
+}

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/dist/src/services/storage/main.d.ts

@@ -2,7 +2,7 @@ import { StorageAccount } from '@pulumi/azure-native/storage/index.js';
 import * as pulumi from '@pulumi/pulumi';
 import { ResourceOptions } from '@pulumi/pulumi';
 import { CommonAzureConstruct } from '../../common/index.js';
-import { ContainerSasTokenProps, ManagementPolicyProps, StorageAccountProps, StorageBlobProps, StorageContainerProps, StorageTableProps } from './types.js';
+import { ContainerSasTokenProps, ManagementPolicyProps, ResolveStorageAccountProps, ResolveStorageContainerProps, StorageAccountProps, StorageBlobProps, StorageContainerProps, StorageTableProps } from './types.js';
 /**
  * Provides operations on Azure Storage using Pulumi
  * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
@@ -85,4 +85,20 @@ export declare class AzureStorageManager {
      * @see [Pulumi Azure Native Storage Table]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/storage/table/}
      */
     createTable(id: string, scope: CommonAzureConstruct, props: StorageTableProps, resourceOptions?: ResourceOptions): import("@pulumi/azure-native/storage/table.js").Table;
+    /**
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props storage account properties
+     * @param resourceOptions Optional settings to control resource behaviour
+     * @see [Pulumi Azure Native Storage Table]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/storage/table/}
+     */
+    resolveStorageAccount(id: string, scope: CommonAzureConstruct, props: ResolveStorageAccountProps, resourceOptions?: ResourceOptions): pulumi.Output<import("@pulumi/azure-native/storage/getStorageAccount.js").GetStorageAccountResult>;
+    /**
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props storage account container properties
+     * @param resourceOptions Optional settings to control resource behaviour
+  
+     */
+    resolveStorageContainer(id: string, scope: CommonAzureConstruct, props: ResolveStorageContainerProps, resourceOptions?: ResourceOptions): pulumi.Output<import("@pulumi/azure-native/storage/getBlobContainer.js").GetBlobContainerResult>;
 }

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

@@ -1,4 +1,4 @@
-import { Blob, BlobContainer, BlobServiceProperties, HttpProtocol, Kind, listStorageAccountSAS, ManagementPolicy, MinimumTlsVersion, Permissions, PublicAccess, Services, SignedResourceTypes, SkuName, StorageAccount, Table, } from '@pulumi/azure-native/storage/index.js';
+import { Blob, BlobContainer, BlobServiceProperties, getStorageAccountOutput, getBlobContainerOutput, HttpProtocol, Kind, listStorageAccountSAS, ManagementPolicy, MinimumTlsVersion, Permissions, PublicAccess, Services, SignedResourceTypes, SkuName, StorageAccount, Table, } from '@pulumi/azure-native/storage/index.js';
 import * as pulumi from '@pulumi/pulumi';
 /**
  * Provides operations on Azure Storage using Pulumi
@@ -169,4 +169,31 @@ export class AzureStorageManager {
             throw new Error(`Props undefined for ${id}`);
         return new Table(`${id}`, props, { parent: scope, ...resourceOptions });
     }
+    /**
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props storage account properties
+     * @param resourceOptions Optional settings to control resource behaviour
+     * @see [Pulumi Azure Native Storage Table]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/storage/table/}
+     */
+    resolveStorageAccount(id, scope, props, resourceOptions) {
+        return getStorageAccountOutput({
+            accountName: scope.resourceNameFormatter.format(props.accountName?.toString(), scope.props.resourceNameOptions?.storageAccount),
+            resourceGroupName: props.resourceGroupName ?? scope.resourceNameFormatter.format(scope.props.resourceGroupName),
+        }, { parent: scope, ...resourceOptions });
+    }
+    /**
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props storage account container properties
+     * @param resourceOptions Optional settings to control resource behaviour
+  
+     */
+    resolveStorageContainer(id, scope, props, resourceOptions) {
+        return getBlobContainerOutput({
+            accountName: scope.resourceNameFormatter.format(props.accountName?.toString(), scope.props.resourceNameOptions?.storageAccount),
+            containerName: props.containerName,
+            resourceGroupName: props.resourceGroupName ?? scope.resourceNameFormatter.format(scope.props.resourceGroupName),
+        }, { parent: scope, ...resourceOptions });
+    }
 }

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

@@ -1,4 +1,4 @@
-import { BlobArgs, BlobContainerArgs, BlobServicePropertiesArgs, ListStorageAccountSASArgs, ManagementPolicyArgs, StorageAccountArgs, TableArgs } from '@pulumi/azure-native/storage/index.js';
+import { BlobArgs, BlobContainerArgs, BlobServicePropertiesArgs, GetStorageAccountOutputArgs, GetBlobContainerOutputArgs, ListStorageAccountSASArgs, ManagementPolicyArgs, StorageAccountArgs, TableArgs } from '@pulumi/azure-native/storage/index.js';
 import { BaseAzureConfigProps } from '../../types/index.js';
 /**
  * Properties for creating an Azure Storage account
@@ -58,3 +58,17 @@ export interface ContainerSasTokenProps extends ListStorageAccountSASArgs {
     /** SAS expiry date in 'YYYY-MM-DD' format; defaults to 7 days from now */
     expiry?: string;
 }
+/**
+ * Properties for resolving an existing Storage account
+ * @see [Pulumi Azure Native Event Grid Topic]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/storage/getstorageaccount/}
+ * @category Interface
+ */
+export interface ResolveStorageAccountProps extends GetStorageAccountOutputArgs {
+}
+/**
+ * Properties for resolving an existing Storage account container
+ * @see [Pulumi Azure Native Event Grid Topic]{@link https://www.pulumi.com/registry/packages/azure-native/api-docs/storage/getstorageaccount/}
+ * @category Interface
+ */
+export interface ResolveStorageContainerProps extends GetBlobContainerOutputArgs {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils-azure",
-  "version": "2.52.1",
+  "version": "2.53.1",
   "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.246.0",
     "@types/lodash": "4.17.24",
     "app-root-path": "3.1.0",
     "lodash": "4.18.1",