@reyemtech/nimbus 0.1.0

package/dist/esm/global-lb/glb.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Global Load Balancer implementation.
+ *
+ * Routes traffic across multiple clusters using DNS-based health checks.
+ * Currently supports Route53 as the DNS provider. Azure Traffic Manager
+ * and Cloudflare can be added as future providers.
+ *
+ * @module global-lb/glb
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGlobalLoadBalancer = createGlobalLoadBalancer;
+const aws = __importStar(require("@pulumi/aws"));
+const pulumi = __importStar(require("@pulumi/pulumi"));
+/**
+ * Create a Global Load Balancer across multiple clusters.
+ *
+ * Uses DNS-based routing with health checks to distribute traffic.
+ * Supports active-active, active-passive, and geo-routing strategies.
+ *
+ * @example
+ * ```typescript
+ * const glb = createGlobalLoadBalancer("prod", {
+ *   strategy: "active-active",
+ *   clusters: [awsCluster, azureCluster],
+ *   domain: "app.example.com",
+ *   healthCheck: { path: "/health", port: 443, protocol: "HTTPS" },
+ *   dnsProvider: "route53",
+ * });
+ * ```
+ */
+function createGlobalLoadBalancer(name, config) {
+    switch (config.dnsProvider) {
+        case "route53":
+            return createRoute53Glb(name, config);
+        case "cloudflare":
+        case "azure-traffic-manager":
+            // Placeholder for future providers
+            return createRoute53Glb(name, config);
+    }
+}
+function createRoute53Glb(name, config) {
+    const hc = config.healthCheck;
+    // Create a hosted zone for the GLB domain (or reference existing)
+    const domainParts = config.domain.split(".");
+    const zoneDomain = domainParts.slice(-2).join(".");
+    const zone = aws.route53.getZoneOutput({ name: zoneDomain });
+    // Create health checks for each cluster
+    const healthChecks = config.clusters.map((cluster, i) => {
+        const healthCheck = new aws.route53.HealthCheck(`${name}-hc-${i}`, {
+            type: hc.protocol === "TCP" ? "TCP" : `${hc.protocol}_STR_MATCH`,
+            resourcePath: hc.protocol !== "TCP" ? hc.path : undefined,
+            port: hc.port,
+            requestInterval: hc.intervalSeconds ?? 30,
+            failureThreshold: hc.unhealthyThreshold ?? 3,
+            fqdn: cluster.endpoint.apply((ep) => {
+                try {
+                    return new URL(ep).hostname;
+                }
+                catch {
+                    return ep;
+                }
+            }),
+            searchString: hc.protocol !== "TCP" ? "ok" : undefined,
+            tags: { Name: `${name}-hc-${cluster.name}` },
+        });
+        return { cluster, healthCheck };
+    });
+    // Create DNS records based on routing strategy
+    switch (config.strategy) {
+        case "active-active": {
+            // Weighted routing — equal weight across all clusters
+            for (const [i, entry] of healthChecks.entries()) {
+                new aws.route53.Record(`${name}-record-${i}`, {
+                    zoneId: zone.zoneId,
+                    name: config.domain,
+                    type: "CNAME",
+                    ttl: 60,
+                    setIdentifier: `${name}-${entry.cluster.name}`,
+                    weightedRoutingPolicies: [{ weight: 100 }],
+                    healthCheckId: entry.healthCheck.id,
+                    records: [
+                        entry.cluster.endpoint.apply((ep) => {
+                            try {
+                                return new URL(ep).hostname;
+                            }
+                            catch {
+                                return ep;
+                            }
+                        }),
+                    ],
+                });
+            }
+            break;
+        }
+        case "active-passive": {
+            // Failover routing — primary + secondary
+            for (const [i, entry] of healthChecks.entries()) {
+                new aws.route53.Record(`${name}-record-${i}`, {
+                    zoneId: zone.zoneId,
+                    name: config.domain,
+                    type: "CNAME",
+                    ttl: 60,
+                    setIdentifier: `${name}-${entry.cluster.name}`,
+                    failoverRoutingPolicies: [{ type: i === 0 ? "PRIMARY" : "SECONDARY" }],
+                    healthCheckId: entry.healthCheck.id,
+                    records: [
+                        entry.cluster.endpoint.apply((ep) => {
+                            try {
+                                return new URL(ep).hostname;
+                            }
+                            catch {
+                                return ep;
+                            }
+                        }),
+                    ],
+                });
+            }
+            break;
+        }
+        case "geo": {
+            // Geolocation routing — defaults to continent-based
+            const continents = ["NA", "EU", "AP", "SA", "AF", "OC"];
+            for (const [i, entry] of healthChecks.entries()) {
+                new aws.route53.Record(`${name}-record-${i}`, {
+                    zoneId: zone.zoneId,
+                    name: config.domain,
+                    type: "CNAME",
+                    ttl: 60,
+                    setIdentifier: `${name}-${entry.cluster.name}`,
+                    geolocationRoutingPolicies: [
+                        i < continents.length ? { continent: continents[i] } : { country: "*" },
+                    ],
+                    healthCheckId: entry.healthCheck.id,
+                    records: [
+                        entry.cluster.endpoint.apply((ep) => {
+                            try {
+                                return new URL(ep).hostname;
+                            }
+                            catch {
+                                return ep;
+                            }
+                        }),
+                    ],
+                });
+            }
+            // Default fallback record
+            if (healthChecks.length > 0) {
+                const fallback = healthChecks[0];
+                if (fallback) {
+                    new aws.route53.Record(`${name}-record-default`, {
+                        zoneId: zone.zoneId,
+                        name: config.domain,
+                        type: "CNAME",
+                        ttl: 60,
+                        setIdentifier: `${name}-default`,
+                        geolocationRoutingPolicies: [{ country: "*" }],
+                        healthCheckId: fallback.healthCheck.id,
+                        records: [
+                            fallback.cluster.endpoint.apply((ep) => {
+                                try {
+                                    return new URL(ep).hostname;
+                                }
+                                catch {
+                                    return ep;
+                                }
+                            }),
+                        ],
+                    });
+                }
+            }
+            break;
+        }
+    }
+    // Health status output
+    const healthStatus = pulumi.all(healthChecks.map((entry) => pulumi.all([pulumi.output(entry.cluster.name), entry.healthCheck.id]).apply(([clusterName]) => ({
+        cluster: clusterName,
+        healthy: true, // Initial state; actual health determined by Route53
+    }))));
+    return {
+        name,
+        strategy: config.strategy,
+        endpoint: pulumi.output(config.domain),
+        healthStatus: healthStatus,
+    };
+}
+//# sourceMappingURL=glb.js.map

package/dist/esm/global-lb/glb.js.map

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

package/dist/esm/global-lb/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Global load balancer module — multi-cloud traffic routing.
+ *
+ * @module global-lb
+ */
+export type { RoutingStrategy, GlbDnsProvider, IHealthCheck, IGlobalLoadBalancerConfig, IClusterHealthStatus, IGlobalLoadBalancer, } from "./interfaces";
+export { createGlobalLoadBalancer } from "./glb";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/global-lb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/global-lb/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC"}

package/dist/esm/global-lb/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Global load balancer module — multi-cloud traffic routing.
+ *
+ * @module global-lb
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGlobalLoadBalancer = void 0;
+var glb_1 = require("./glb");
+Object.defineProperty(exports, "createGlobalLoadBalancer", { enumerable: true, get: function () { return glb_1.createGlobalLoadBalancer; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/global-lb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/global-lb/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAWH,6BAAiD;AAAxC,+GAAA,wBAAwB,OAAA"}

package/dist/esm/global-lb/interfaces.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Global load balancer interfaces for @reyemtech/nimbus.
+ *
+ * Multi-cloud traffic routing with health checks, supporting
+ * active-active, active-passive, and geo-routing strategies.
+ *
+ * @module global-lb/interfaces
+ */
+import type * as pulumi from "@pulumi/pulumi";
+import type { ICluster } from "../cluster";
+/** Routing strategy for multi-cluster traffic. */
+export type RoutingStrategy = "active-active" | "active-passive" | "geo";
+/** DNS provider for global load balancing. */
+export type GlbDnsProvider = "route53" | "cloudflare" | "azure-traffic-manager";
+/** Health check configuration. */
+export interface IHealthCheck {
+    readonly path: string;
+    readonly port: number;
+    readonly protocol: "HTTP" | "HTTPS" | "TCP";
+    /** Health check interval in seconds. Default: 30. */
+    readonly intervalSeconds?: number;
+    /** Timeout in seconds. Default: 10. */
+    readonly timeoutSeconds?: number;
+    /** Consecutive successes needed to mark healthy. Default: 3. */
+    readonly healthyThreshold?: number;
+    /** Consecutive failures needed to mark unhealthy. Default: 3. */
+    readonly unhealthyThreshold?: number;
+}
+/**
+ * Global load balancer configuration input.
+ *
+ * @example
+ * ```typescript
+ * const config: IGlobalLoadBalancerConfig = {
+ *   strategy: "active-active",
+ *   clusters: [awsCluster, azureCluster],
+ *   domain: "app.example.com",
+ *   healthCheck: { path: "/health", port: 443, protocol: "HTTPS" },
+ *   dnsProvider: "route53",
+ * };
+ * ```
+ */
+export interface IGlobalLoadBalancerConfig {
+    readonly strategy: RoutingStrategy;
+    readonly clusters: ReadonlyArray<ICluster>;
+    readonly domain: string;
+    readonly healthCheck: IHealthCheck;
+    readonly dnsProvider: GlbDnsProvider;
+}
+/** Cluster health status entry. */
+export interface IClusterHealthStatus {
+    readonly cluster: string;
+    readonly healthy: boolean;
+}
+/** Global load balancer output. */
+export interface IGlobalLoadBalancer {
+    readonly name: string;
+    readonly strategy: RoutingStrategy;
+    readonly endpoint: pulumi.Output<string>;
+    readonly healthStatus: pulumi.Output<ReadonlyArray<IClusterHealthStatus>>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/esm/global-lb/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/global-lb/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,kDAAkD;AAClD,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,gBAAgB,GAChB,KAAK,CAAC;AAEV,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,YAAY,GACZ,uBAAuB,CAAC;AAE5B,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAC5C,qDAAqD;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;CACtC;AAED,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;CAC3E"}

package/dist/esm/global-lb/interfaces.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Global load balancer interfaces for @reyemtech/nimbus.
+ *
+ * Multi-cloud traffic routing with health checks, supporting
+ * active-active, active-passive, and geo-routing strategies.
+ *
+ * @module global-lb/interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/esm/global-lb/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/global-lb/interfaces.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/esm/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @reyemtech/nimbus
+ *
+ * Cloud-agnostic infrastructure abstractions for Pulumi.
+ * Enables BCDR: any client environment fully reproducible from code,
+ * cloud migration = change one config value.
+ *
+ * @packageDocumentation
+ */
+export { type CloudProvider, type CloudTarget, type CloudArg, type ResolvedCloudTarget, DEFAULT_REGIONS, CLOUD_PROVIDERS, isCloudProvider, isCloudTarget, resolveCloudTarget, } from "./types";
+export { type ErrorCode, ERROR_CODES, AnyCloudError, CloudValidationError, CidrError, UnsupportedFeatureError, ConfigError, assertNever, } from "./types";
+export { type IRequiredTags, normalizeTags, isValidGcpLabel, mergeWithRequiredTags } from "./types";
+export { type IValidationResult, validateFeature, isFeatureSupported, validateMultiCloud, validateResourceName, assertValidMultiCloud, } from "./types";
+export type { INodeTaint, INodePool, IClusterConfig, ICluster, IEksClusterExtensions, IAksClusterExtensions, IGkeClusterExtensions, ProviderClusterExtensions, } from "./cluster";
+export type { NatStrategy, ISubnetConfig, INetworkConfig, INetwork } from "./network";
+export { parseCidr, formatIp, cidrsOverlap, detectOverlaps, validateNoOverlaps, autoOffsetCidrs, buildCidrMap, } from "./network";
+export type { DnsRecordType, IDnsRecord, IDnsConfig, IDns } from "./dns";
+export type { SecretBackend, ISecretRef, ISecretsConfig, ISecrets } from "./secrets";
+export type { DatabaseEngine, DatabaseMode, DatabaseOperator, IDatabaseBackupConfig, IDatabaseConfig, IDatabase, } from "./database";
+export type { CacheEngine, CacheMode, CacheArchitecture, ICacheConfig, ICache } from "./cache";
+export type { ILifecycleRule, ICorsRule, IObjectStorageConfig, IObjectStorage } from "./storage";
+export type { QueueEngine, QueueMode, QueueType, IQueueConfig, IQueue } from "./queue";
+export { type DnsProvider, type IPlatformComponentConfig, type IExternalDnsConfig, type IVaultConfig, type IPlatformStackConfig, type IPlatformStack, createPlatformStack, } from "./platform";
+export { type RoutingStrategy, type GlbDnsProvider, type IHealthCheck, type IGlobalLoadBalancerConfig, type IClusterHealthStatus, type IGlobalLoadBalancer, createGlobalLoadBalancer, } from "./global-lb";
+export { createNetwork, createCluster, createDns, createSecrets, type ICreateNetworkConfig, type ICreateClusterConfig, type ICreateDnsConfig, type ICreateSecretsConfig, type IProviderOptions, type IAwsProviderOptions, type IAzureProviderOptions, extractProvider, isMultiCloud, } from "./factories";
+export { createAwsNetwork, type IAwsNetworkOptions, createEksCluster, type IEksOptions, createRoute53Dns, createAwsSecrets, } from "./aws";
+export { createAzureNetwork, type IAzureNetworkOptions, createAksCluster, type IAksOptions, createAzureDns, type IAzureDnsOptions, createAzureSecrets, type IAzureSecretsOptions, } from "./azure";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,KAAK,SAAS,EACd,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEpG,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEtF,OAAO,EACL,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAGzE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrF,YAAY,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAG/F,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjG,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGvF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,WAAW,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * @reyemtech/nimbus
+ *
+ * Cloud-agnostic infrastructure abstractions for Pulumi.
+ * Enables BCDR: any client environment fully reproducible from code,
+ * cloud migration = change one config value.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAzureSecrets = exports.createAzureDns = exports.createAksCluster = exports.createAzureNetwork = exports.createAwsSecrets = exports.createRoute53Dns = exports.createEksCluster = exports.createAwsNetwork = exports.isMultiCloud = exports.extractProvider = exports.createSecrets = exports.createDns = exports.createCluster = exports.createNetwork = exports.createGlobalLoadBalancer = exports.createPlatformStack = exports.buildCidrMap = exports.autoOffsetCidrs = exports.validateNoOverlaps = exports.detectOverlaps = exports.cidrsOverlap = exports.formatIp = exports.parseCidr = exports.assertValidMultiCloud = exports.validateResourceName = exports.validateMultiCloud = exports.isFeatureSupported = exports.validateFeature = exports.mergeWithRequiredTags = exports.isValidGcpLabel = exports.normalizeTags = exports.assertNever = exports.ConfigError = exports.UnsupportedFeatureError = exports.CidrError = exports.CloudValidationError = exports.AnyCloudError = exports.ERROR_CODES = exports.resolveCloudTarget = exports.isCloudTarget = exports.isCloudProvider = exports.CLOUD_PROVIDERS = exports.DEFAULT_REGIONS = void 0;
+// Core types
+var types_1 = require("./types");
+Object.defineProperty(exports, "DEFAULT_REGIONS", { enumerable: true, get: function () { return types_1.DEFAULT_REGIONS; } });
+Object.defineProperty(exports, "CLOUD_PROVIDERS", { enumerable: true, get: function () { return types_1.CLOUD_PROVIDERS; } });
+Object.defineProperty(exports, "isCloudProvider", { enumerable: true, get: function () { return types_1.isCloudProvider; } });
+Object.defineProperty(exports, "isCloudTarget", { enumerable: true, get: function () { return types_1.isCloudTarget; } });
+Object.defineProperty(exports, "resolveCloudTarget", { enumerable: true, get: function () { return types_1.resolveCloudTarget; } });
+var types_2 = require("./types");
+Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return types_2.ERROR_CODES; } });
+Object.defineProperty(exports, "AnyCloudError", { enumerable: true, get: function () { return types_2.AnyCloudError; } });
+Object.defineProperty(exports, "CloudValidationError", { enumerable: true, get: function () { return types_2.CloudValidationError; } });
+Object.defineProperty(exports, "CidrError", { enumerable: true, get: function () { return types_2.CidrError; } });
+Object.defineProperty(exports, "UnsupportedFeatureError", { enumerable: true, get: function () { return types_2.UnsupportedFeatureError; } });
+Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return types_2.ConfigError; } });
+Object.defineProperty(exports, "assertNever", { enumerable: true, get: function () { return types_2.assertNever; } });
+var types_3 = require("./types");
+Object.defineProperty(exports, "normalizeTags", { enumerable: true, get: function () { return types_3.normalizeTags; } });
+Object.defineProperty(exports, "isValidGcpLabel", { enumerable: true, get: function () { return types_3.isValidGcpLabel; } });
+Object.defineProperty(exports, "mergeWithRequiredTags", { enumerable: true, get: function () { return types_3.mergeWithRequiredTags; } });
+var types_4 = require("./types");
+Object.defineProperty(exports, "validateFeature", { enumerable: true, get: function () { return types_4.validateFeature; } });
+Object.defineProperty(exports, "isFeatureSupported", { enumerable: true, get: function () { return types_4.isFeatureSupported; } });
+Object.defineProperty(exports, "validateMultiCloud", { enumerable: true, get: function () { return types_4.validateMultiCloud; } });
+Object.defineProperty(exports, "validateResourceName", { enumerable: true, get: function () { return types_4.validateResourceName; } });
+Object.defineProperty(exports, "assertValidMultiCloud", { enumerable: true, get: function () { return types_4.assertValidMultiCloud; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "parseCidr", { enumerable: true, get: function () { return network_1.parseCidr; } });
+Object.defineProperty(exports, "formatIp", { enumerable: true, get: function () { return network_1.formatIp; } });
+Object.defineProperty(exports, "cidrsOverlap", { enumerable: true, get: function () { return network_1.cidrsOverlap; } });
+Object.defineProperty(exports, "detectOverlaps", { enumerable: true, get: function () { return network_1.detectOverlaps; } });
+Object.defineProperty(exports, "validateNoOverlaps", { enumerable: true, get: function () { return network_1.validateNoOverlaps; } });
+Object.defineProperty(exports, "autoOffsetCidrs", { enumerable: true, get: function () { return network_1.autoOffsetCidrs; } });
+Object.defineProperty(exports, "buildCidrMap", { enumerable: true, get: function () { return network_1.buildCidrMap; } });
+// Platform
+var platform_1 = require("./platform");
+Object.defineProperty(exports, "createPlatformStack", { enumerable: true, get: function () { return platform_1.createPlatformStack; } });
+// Global Load Balancer
+var global_lb_1 = require("./global-lb");
+Object.defineProperty(exports, "createGlobalLoadBalancer", { enumerable: true, get: function () { return global_lb_1.createGlobalLoadBalancer; } });
+// Factory functions (primary API)
+var factories_1 = require("./factories");
+Object.defineProperty(exports, "createNetwork", { enumerable: true, get: function () { return factories_1.createNetwork; } });
+Object.defineProperty(exports, "createCluster", { enumerable: true, get: function () { return factories_1.createCluster; } });
+Object.defineProperty(exports, "createDns", { enumerable: true, get: function () { return factories_1.createDns; } });
+Object.defineProperty(exports, "createSecrets", { enumerable: true, get: function () { return factories_1.createSecrets; } });
+Object.defineProperty(exports, "extractProvider", { enumerable: true, get: function () { return factories_1.extractProvider; } });
+Object.defineProperty(exports, "isMultiCloud", { enumerable: true, get: function () { return factories_1.isMultiCloud; } });
+// AWS Provider (direct access)
+var aws_1 = require("./aws");
+Object.defineProperty(exports, "createAwsNetwork", { enumerable: true, get: function () { return aws_1.createAwsNetwork; } });
+Object.defineProperty(exports, "createEksCluster", { enumerable: true, get: function () { return aws_1.createEksCluster; } });
+Object.defineProperty(exports, "createRoute53Dns", { enumerable: true, get: function () { return aws_1.createRoute53Dns; } });
+Object.defineProperty(exports, "createAwsSecrets", { enumerable: true, get: function () { return aws_1.createAwsSecrets; } });
+// Azure Provider (direct access)
+var azure_1 = require("./azure");
+Object.defineProperty(exports, "createAzureNetwork", { enumerable: true, get: function () { return azure_1.createAzureNetwork; } });
+Object.defineProperty(exports, "createAksCluster", { enumerable: true, get: function () { return azure_1.createAksCluster; } });
+Object.defineProperty(exports, "createAzureDns", { enumerable: true, get: function () { return azure_1.createAzureDns; } });
+Object.defineProperty(exports, "createAzureSecrets", { enumerable: true, get: function () { return azure_1.createAzureSecrets; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,aAAa;AACb,iCAUiB;AALf,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,sGAAA,aAAa,OAAA;AACb,2GAAA,kBAAkB,OAAA;AAGpB,iCASiB;AAPf,oGAAA,WAAW,OAAA;AACX,sGAAA,aAAa,OAAA;AACb,6GAAA,oBAAoB,OAAA;AACpB,kGAAA,SAAS,OAAA;AACT,gHAAA,uBAAuB,OAAA;AACvB,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AAGb,iCAAoG;AAAvE,sGAAA,aAAa,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAElF,iCAOiB;AALf,wGAAA,eAAe,OAAA;AACf,2GAAA,kBAAkB,OAAA;AAClB,2GAAA,kBAAkB,OAAA;AAClB,6GAAA,oBAAoB,OAAA;AACpB,8GAAA,qBAAqB,OAAA;AAkBvB,qCAQmB;AAPjB,oGAAA,SAAS,OAAA;AACT,mGAAA,QAAQ,OAAA;AACR,uGAAA,YAAY,OAAA;AACZ,yGAAA,cAAc,OAAA;AACd,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,uGAAA,YAAY,OAAA;AA4Bd,WAAW;AACX,uCAQoB;AADlB,+GAAA,mBAAmB,OAAA;AAGrB,uBAAuB;AACvB,yCAQqB;AADnB,qHAAA,wBAAwB,OAAA;AAG1B,kCAAkC;AAClC,yCAcqB;AAbnB,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AACb,sGAAA,SAAS,OAAA;AACT,0GAAA,aAAa,OAAA;AAQb,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AAGd,+BAA+B;AAC/B,6BAOe;AANb,uGAAA,gBAAgB,OAAA;AAEhB,uGAAA,gBAAgB,OAAA;AAEhB,uGAAA,gBAAgB,OAAA;AAChB,uGAAA,gBAAgB,OAAA;AAGlB,iCAAiC;AACjC,iCASiB;AARf,2GAAA,kBAAkB,OAAA;AAElB,yGAAA,gBAAgB,OAAA;AAEhB,uGAAA,cAAc,OAAA;AAEd,2GAAA,kBAAkB,OAAA"}

package/dist/esm/network/cidr.d.ts

@@ -0,0 +1,92 @@
+/**
+ * CIDR utilities for multi-cloud network planning.
+ *
+ * Provides overlap detection, auto-offset for non-conflicting CIDRs,
+ * and validation for multi-cloud VPC peering/mesh scenarios.
+ *
+ * @module network/cidr
+ */
+/** Parsed CIDR representation. */
+interface ParsedCidr {
+    readonly network: number;
+    readonly prefix: number;
+    readonly size: number;
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * Parse a CIDR string into its numeric components.
+ *
+ * @param cidr - CIDR notation string (e.g., "10.0.0.0/16")
+ * @returns Parsed CIDR with start/end addresses
+ * @throws {CidrError} If the CIDR string is malformed
+ */
+export declare function parseCidr(cidr: string): ParsedCidr;
+/**
+ * Format a numeric IP address back to dotted notation.
+ *
+ * @param ip - 32-bit unsigned integer IP address
+ * @returns Dotted decimal string
+ */
+export declare function formatIp(ip: number): string;
+/**
+ * Check if two CIDR ranges overlap.
+ *
+ * @param a - First CIDR string
+ * @param b - Second CIDR string
+ * @returns True if ranges overlap
+ */
+export declare function cidrsOverlap(a: string, b: string): boolean;
+/**
+ * Detect overlaps in a set of CIDRs.
+ *
+ * @param cidrs - Array of CIDR strings to check
+ * @returns Array of overlapping pairs, empty if no conflicts
+ */
+export declare function detectOverlaps(cidrs: ReadonlyArray<string>): ReadonlyArray<[string, string]>;
+/**
+ * Validate that a set of CIDRs do not overlap.
+ *
+ * @param cidrs - Array of CIDR strings
+ * @throws {CidrError} If any CIDRs overlap
+ */
+export declare function validateNoOverlaps(cidrs: ReadonlyArray<string>): void;
+/**
+ * Auto-generate non-overlapping CIDRs for multiple clouds.
+ *
+ * Uses 10.{offset}.0.0/16 pattern with configurable base and step.
+ *
+ * @param count - Number of CIDRs to generate
+ * @param options - Base octet and step between CIDRs
+ * @returns Array of non-overlapping CIDR strings
+ *
+ * @example
+ * ```typescript
+ * autoOffsetCidrs(3); // ["10.0.0.0/16", "10.1.0.0/16", "10.2.0.0/16"]
+ * autoOffsetCidrs(2, { base: 10, step: 10 }); // ["10.10.0.0/16", "10.20.0.0/16"]
+ * ```
+ */
+export declare function autoOffsetCidrs(count: number, options?: {
+    base?: number;
+    step?: number;
+    prefix?: number;
+}): ReadonlyArray<string>;
+/**
+ * Build a CIDR map for named clouds from explicit values or auto-offset.
+ *
+ * If explicit CIDRs are provided for all clouds, validates no overlaps.
+ * For missing clouds, auto-generates non-overlapping CIDRs.
+ *
+ * @param clouds - Array of cloud names
+ * @param explicit - Explicit CIDR assignments (partial or full)
+ * @returns Complete CIDR map keyed by cloud name
+ *
+ * @example
+ * ```typescript
+ * buildCidrMap(["aws", "azure"], { aws: "10.0.0.0/16" });
+ * // { aws: "10.0.0.0/16", azure: "10.1.0.0/16" }
+ * ```
+ */
+export declare function buildCidrMap(clouds: ReadonlyArray<string>, explicit?: Readonly<Record<string, string>>): Readonly<Record<string, string>>;
+export {};
+//# sourceMappingURL=cidr.d.ts.map

package/dist/esm/network/cidr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr.d.ts","sourceRoot":"","sources":["../../../src/network/cidr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,kCAAkC;AAClC,UAAU,UAAU;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA6BlD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAc5F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAUrE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,aAAa,CAAC,MAAM,CAAC,CAkBvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA6ClC"}