@reyemtech/nimbus 0.1.0

package/dist/esm/types/cloud-target.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Cloud target types for @reyemtech/nimbus.
+ *
+ * Defines how users specify which cloud provider(s) and region(s)
+ * to deploy to. Supports string shorthand, explicit targets,
+ * and multi-cloud arrays.
+ *
+ * @module types/cloud-target
+ */
+/** Supported cloud providers. */
+export type CloudProvider = "aws" | "azure" | "gcp" | "rackspace";
+/**
+ * Explicit cloud target with provider and optional region.
+ *
+ * @example
+ * ```typescript
+ * const target: CloudTarget = { provider: "aws", region: "us-east-1" };
+ * ```
+ */
+export interface CloudTarget {
+    readonly provider: CloudProvider;
+    /** Falls back to DEFAULT_REGIONS[provider] if omitted. */
+    readonly region?: string;
+}
+/**
+ * Flexible cloud argument accepted by all factory functions.
+ *
+ * - `string` shorthand: `"aws"` → reads region from config or default
+ * - `CloudTarget`: explicit `{ provider, region }`
+ * - `Array`: multi-cloud deployment
+ *
+ * @example
+ * ```typescript
+ * // Simple
+ * cloud: "aws"
+ *
+ * // Explicit
+ * cloud: { provider: "aws", region: "us-east-1" }
+ *
+ * // Multi-cloud
+ * cloud: [
+ *   { provider: "aws", region: "us-east-1" },
+ *   { provider: "azure", region: "canadacentral" }
+ * ]
+ * ```
+ */
+export type CloudArg = CloudProvider | CloudTarget | ReadonlyArray<CloudProvider | CloudTarget>;
+/**
+ * Resolved cloud target — always has both provider and region.
+ * Produced by resolveCloudTarget() after applying config/defaults.
+ */
+export interface ResolvedCloudTarget {
+    readonly provider: CloudProvider;
+    readonly region: string;
+}
+/** Default regions when none specified and no config file entry found. */
+export declare const DEFAULT_REGIONS: Readonly<Record<CloudProvider, string>>;
+/** All valid cloud providers for exhaustive checks. */
+export declare const CLOUD_PROVIDERS: ReadonlyArray<CloudProvider>;
+/**
+ * Type guard: is the value a CloudProvider string?
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid CloudProvider
+ */
+export declare function isCloudProvider(value: unknown): value is CloudProvider;
+/**
+ * Type guard: is the value a CloudTarget object?
+ *
+ * @param value - Value to check
+ * @returns True if value is a CloudTarget
+ */
+export declare function isCloudTarget(value: unknown): value is CloudTarget;
+/**
+ * Resolve a CloudArg into one or more ResolvedCloudTargets.
+ *
+ * Resolution order:
+ * 1. Explicit region in CloudTarget
+ * 2. DEFAULT_REGIONS fallback
+ *
+ * @param cloud - The cloud argument to resolve
+ * @returns Resolved target(s) with provider and region
+ *
+ * @throws {CloudValidationError} If cloud argument is invalid
+ */
+export declare function resolveCloudTarget(cloud: CloudProvider | CloudTarget): ResolvedCloudTarget;
+export declare function resolveCloudTarget(cloud: ReadonlyArray<CloudProvider | CloudTarget>): ReadonlyArray<ResolvedCloudTarget>;
+export declare function resolveCloudTarget(cloud: CloudArg): ResolvedCloudTarget | ReadonlyArray<ResolvedCloudTarget>;
+//# sourceMappingURL=cloud-target.d.ts.map

package/dist/esm/types/cloud-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-target.d.ts","sourceRoot":"","sources":["../../../src/types/cloud-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC,aAAa,GAAG,WAAW,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAK1D,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,aAAa,CAK/C,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAOlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAC5F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,aAAa,GAAG,WAAW,CAAC,GAChD,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACtC,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,GACd,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/esm/types/cloud-target.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Cloud target types for @reyemtech/nimbus.
+ *
+ * Defines how users specify which cloud provider(s) and region(s)
+ * to deploy to. Supports string shorthand, explicit targets,
+ * and multi-cloud arrays.
+ *
+ * @module types/cloud-target
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLOUD_PROVIDERS = exports.DEFAULT_REGIONS = void 0;
+exports.isCloudProvider = isCloudProvider;
+exports.isCloudTarget = isCloudTarget;
+exports.resolveCloudTarget = resolveCloudTarget;
+const errors_1 = require("./errors");
+/** Default regions when none specified and no config file entry found. */
+exports.DEFAULT_REGIONS = {
+    aws: "us-east-1",
+    azure: "eastus",
+    gcp: "us-central1",
+    rackspace: "us-central-iad3",
+};
+/** All valid cloud providers for exhaustive checks. */
+exports.CLOUD_PROVIDERS = [
+    "aws",
+    "azure",
+    "gcp",
+    "rackspace",
+];
+/**
+ * Type guard: is the value a CloudProvider string?
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid CloudProvider
+ */
+function isCloudProvider(value) {
+    return typeof value === "string" && exports.CLOUD_PROVIDERS.includes(value);
+}
+/**
+ * Type guard: is the value a CloudTarget object?
+ *
+ * @param value - Value to check
+ * @returns True if value is a CloudTarget
+ */
+function isCloudTarget(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "provider" in value &&
+        isCloudProvider(value.provider));
+}
+function resolveCloudTarget(cloud) {
+    if (Array.isArray(cloud)) {
+        return cloud.map((c) => resolveSingle(c));
+    }
+    return resolveSingle(cloud);
+}
+function resolveSingle(cloud) {
+    if (isCloudProvider(cloud)) {
+        return {
+            provider: cloud,
+            region: exports.DEFAULT_REGIONS[cloud],
+        };
+    }
+    if (isCloudTarget(cloud)) {
+        return {
+            provider: cloud.provider,
+            region: cloud.region ?? exports.DEFAULT_REGIONS[cloud.provider],
+        };
+    }
+    throw new errors_1.CloudValidationError(`Invalid cloud argument: ${JSON.stringify(cloud)}. Expected CloudProvider string or CloudTarget object.`);
+}
+//# sourceMappingURL=cloud-target.js.map

package/dist/esm/types/cloud-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-target.js","sourceRoot":"","sources":["../../../src/types/cloud-target.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA4EH,0CAEC;AAQD,sCAOC;AAqBD,gDAOC;AAvHD,qCAAgD;AAoDhD,0EAA0E;AAC7D,QAAA,eAAe,GAA4C;IACtE,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,aAAa;IAClB,SAAS,EAAE,iBAAiB;CACpB,CAAC;AAEX,uDAAuD;AAC1C,QAAA,eAAe,GAAiC;IAC3D,KAAK;IACL,OAAO;IACP,KAAK;IACL,WAAW;CACH,CAAC;AAEX;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,uBAAe,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,UAAU,IAAI,KAAK;QACnB,eAAe,CAAE,KAAqB,CAAC,QAAQ,CAAC,CACjD,CAAC;AACJ,CAAC;AAqBD,SAAgB,kBAAkB,CAChC,KAAe;IAEf,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,aAAa,CAAC,KAAoC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,aAAa,CAAC,KAAkC;IACvD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,uBAAe,CAAC,KAAK,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,uBAAe,CAAC,KAAK,CAAC,QAAQ,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,6BAAoB,CAC5B,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,wDAAwD,CACzG,CAAC;AACJ,CAAC"}

package/dist/esm/types/errors.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Custom error classes for @reyemtech/nimbus.
+ *
+ * All errors extend AnyCloudError with a machine-readable code.
+ * Use discriminated error codes for programmatic handling.
+ *
+ * @module types/errors
+ */
+/** Error codes for all nimbus errors. */
+export declare const ERROR_CODES: {
+    readonly CLOUD_VALIDATION: "CLOUD_VALIDATION";
+    readonly CIDR_OVERLAP: "CIDR_OVERLAP";
+    readonly CIDR_INVALID: "CIDR_INVALID";
+    readonly UNSUPPORTED_FEATURE: "UNSUPPORTED_FEATURE";
+    readonly CONFIG_MISSING: "CONFIG_MISSING";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly SECRET_NOT_FOUND: "SECRET_NOT_FOUND";
+    readonly PROVIDER_MISMATCH: "PROVIDER_MISMATCH";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * Base error for all nimbus errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   createCluster("prod", { cloud: "invalid" as any });
+ * } catch (e) {
+ *   if (e instanceof AnyCloudError) {
+ *     console.log(e.code); // "CLOUD_VALIDATION"
+ *   }
+ * }
+ * ```
+ */
+export declare class AnyCloudError extends Error {
+    readonly code: ErrorCode;
+    constructor(message: string, code: ErrorCode);
+}
+/**
+ * Thrown when a cloud provider or region is invalid.
+ *
+ * @throws When an unsupported provider string is passed, or a required
+ *   region is missing and cannot be resolved from config/defaults.
+ */
+export declare class CloudValidationError extends AnyCloudError {
+    constructor(message: string);
+}
+/**
+ * Thrown when CIDR ranges overlap or are invalid.
+ *
+ * @throws When multi-cloud CIDRs would conflict (preventing peering/mesh),
+ *   or when a CIDR string cannot be parsed.
+ */
+export declare class CidrError extends AnyCloudError {
+    readonly cidrs?: ReadonlyArray<string>;
+    constructor(message: string, code: "CIDR_OVERLAP" | "CIDR_INVALID", cidrs?: ReadonlyArray<string>);
+}
+/**
+ * Thrown when a feature is not supported for a given cloud provider.
+ *
+ * @throws When requesting a feature that doesn't exist on the target
+ *   cloud (e.g., EKS Auto Mode on Azure).
+ */
+export declare class UnsupportedFeatureError extends AnyCloudError {
+    readonly feature: string;
+    readonly provider: string;
+    constructor(feature: string, provider: string);
+}
+/**
+ * Thrown when Pulumi config is missing or malformed.
+ *
+ * @throws When a required config value is not set in Pulumi.<stack>.yaml
+ *   or when the config value has an unexpected shape.
+ */
+export declare class ConfigError extends AnyCloudError {
+    readonly configKey?: string;
+    constructor(message: string, code: "CONFIG_MISSING" | "CONFIG_INVALID", configKey?: string);
+}
+/**
+ * Helper for exhaustive switch/case. Ensures all cases are handled at compile time.
+ *
+ * @param value - The value that should have been handled by a prior case
+ * @throws Always throws — reaching this function means a case was missed
+ *
+ * @example
+ * ```typescript
+ * switch (provider) {
+ *   case "aws": return createEks(...);
+ *   case "azure": return createAks(...);
+ *   case "gcp": return createGke(...);
+ *   default: assertNever(provider);
+ * }
+ * ```
+ */
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yCAAyC;AACzC,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;CAM7C;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GAAG,cAAc,EACrC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC;CAMhC;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAS9C;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,aAAa;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM;CAK3F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/esm/types/errors.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Custom error classes for @reyemtech/nimbus.
+ *
+ * All errors extend AnyCloudError with a machine-readable code.
+ * Use discriminated error codes for programmatic handling.
+ *
+ * @module types/errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigError = exports.UnsupportedFeatureError = exports.CidrError = exports.CloudValidationError = exports.AnyCloudError = exports.ERROR_CODES = void 0;
+exports.assertNever = assertNever;
+/** Error codes for all nimbus errors. */
+exports.ERROR_CODES = {
+    CLOUD_VALIDATION: "CLOUD_VALIDATION",
+    CIDR_OVERLAP: "CIDR_OVERLAP",
+    CIDR_INVALID: "CIDR_INVALID",
+    UNSUPPORTED_FEATURE: "UNSUPPORTED_FEATURE",
+    CONFIG_MISSING: "CONFIG_MISSING",
+    CONFIG_INVALID: "CONFIG_INVALID",
+    SECRET_NOT_FOUND: "SECRET_NOT_FOUND",
+    PROVIDER_MISMATCH: "PROVIDER_MISMATCH",
+};
+/**
+ * Base error for all nimbus errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   createCluster("prod", { cloud: "invalid" as any });
+ * } catch (e) {
+ *   if (e instanceof AnyCloudError) {
+ *     console.log(e.code); // "CLOUD_VALIDATION"
+ *   }
+ * }
+ * ```
+ */
+class AnyCloudError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "AnyCloudError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.AnyCloudError = AnyCloudError;
+/**
+ * Thrown when a cloud provider or region is invalid.
+ *
+ * @throws When an unsupported provider string is passed, or a required
+ *   region is missing and cannot be resolved from config/defaults.
+ */
+class CloudValidationError extends AnyCloudError {
+    constructor(message) {
+        super(message, exports.ERROR_CODES.CLOUD_VALIDATION);
+        this.name = "CloudValidationError";
+    }
+}
+exports.CloudValidationError = CloudValidationError;
+/**
+ * Thrown when CIDR ranges overlap or are invalid.
+ *
+ * @throws When multi-cloud CIDRs would conflict (preventing peering/mesh),
+ *   or when a CIDR string cannot be parsed.
+ */
+class CidrError extends AnyCloudError {
+    cidrs;
+    constructor(message, code, cidrs) {
+        super(message, code);
+        this.name = "CidrError";
+        this.cidrs = cidrs;
+    }
+}
+exports.CidrError = CidrError;
+/**
+ * Thrown when a feature is not supported for a given cloud provider.
+ *
+ * @throws When requesting a feature that doesn't exist on the target
+ *   cloud (e.g., EKS Auto Mode on Azure).
+ */
+class UnsupportedFeatureError extends AnyCloudError {
+    feature;
+    provider;
+    constructor(feature, provider) {
+        super(`Feature "${feature}" is not supported on provider "${provider}".`, exports.ERROR_CODES.UNSUPPORTED_FEATURE);
+        this.name = "UnsupportedFeatureError";
+        this.feature = feature;
+        this.provider = provider;
+    }
+}
+exports.UnsupportedFeatureError = UnsupportedFeatureError;
+/**
+ * Thrown when Pulumi config is missing or malformed.
+ *
+ * @throws When a required config value is not set in Pulumi.<stack>.yaml
+ *   or when the config value has an unexpected shape.
+ */
+class ConfigError extends AnyCloudError {
+    configKey;
+    constructor(message, code, configKey) {
+        super(message, code);
+        this.name = "ConfigError";
+        this.configKey = configKey;
+    }
+}
+exports.ConfigError = ConfigError;
+/**
+ * Helper for exhaustive switch/case. Ensures all cases are handled at compile time.
+ *
+ * @param value - The value that should have been handled by a prior case
+ * @throws Always throws — reaching this function means a case was missed
+ *
+ * @example
+ * ```typescript
+ * switch (provider) {
+ *   case "aws": return createEks(...);
+ *   case "azure": return createAks(...);
+ *   case "gcp": return createGke(...);
+ *   default: assertNever(provider);
+ * }
+ * ```
+ */
+function assertNever(value) {
+    throw new UnsupportedFeatureError(`Unhandled value: ${JSON.stringify(value)}`, String(value));
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA+HH,kCAEC;AA/HD,yCAAyC;AAC5B,QAAA,WAAW,GAAG;IACzB,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,MAAa,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAY;IAEzB,YAAY,OAAe,EAAE,IAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AATD,sCASC;AAED;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,mBAAW,CAAC,gBAAgB,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED;;;;;GAKG;AACH,MAAa,SAAU,SAAQ,aAAa;IACjC,KAAK,CAAyB;IAEvC,YACE,OAAe,EACf,IAAqC,EACrC,KAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAZD,8BAYC;AAED;;;;;GAKG;AACH,MAAa,uBAAwB,SAAQ,aAAa;IAC/C,OAAO,CAAS;IAChB,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CACH,YAAY,OAAO,mCAAmC,QAAQ,IAAI,EAClE,mBAAW,CAAC,mBAAmB,CAChC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAbD,0DAaC;AAED;;;;;GAKG;AACH,MAAa,WAAY,SAAQ,aAAa;IACnC,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,IAAyC,EAAE,SAAkB;QACxF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AARD,kCAQC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAChG,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Shared types, interfaces, and constants for @reyemtech/nimbus.
+ *
+ * @module types
+ */
+export { type CloudProvider, type CloudTarget, type CloudArg, type ResolvedCloudTarget, DEFAULT_REGIONS, CLOUD_PROVIDERS, isCloudProvider, isCloudTarget, resolveCloudTarget, } from "./cloud-target";
+export { type ErrorCode, ERROR_CODES, AnyCloudError, CloudValidationError, CidrError, UnsupportedFeatureError, ConfigError, assertNever, } from "./errors";
+export { type IRequiredTags, normalizeTags, isValidGcpLabel, mergeWithRequiredTags } from "./tags";
+export { type IValidationResult, validateFeature, isFeatureSupported, validateMultiCloud, validateResourceName, assertValidMultiCloud, } from "./validation";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,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,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,SAAS,EACd,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAEnG,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/esm/types/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Shared types, interfaces, and constants for @reyemtech/nimbus.
+ *
+ * @module types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+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;
+var cloud_target_1 = require("./cloud-target");
+Object.defineProperty(exports, "DEFAULT_REGIONS", { enumerable: true, get: function () { return cloud_target_1.DEFAULT_REGIONS; } });
+Object.defineProperty(exports, "CLOUD_PROVIDERS", { enumerable: true, get: function () { return cloud_target_1.CLOUD_PROVIDERS; } });
+Object.defineProperty(exports, "isCloudProvider", { enumerable: true, get: function () { return cloud_target_1.isCloudProvider; } });
+Object.defineProperty(exports, "isCloudTarget", { enumerable: true, get: function () { return cloud_target_1.isCloudTarget; } });
+Object.defineProperty(exports, "resolveCloudTarget", { enumerable: true, get: function () { return cloud_target_1.resolveCloudTarget; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return errors_1.ERROR_CODES; } });
+Object.defineProperty(exports, "AnyCloudError", { enumerable: true, get: function () { return errors_1.AnyCloudError; } });
+Object.defineProperty(exports, "CloudValidationError", { enumerable: true, get: function () { return errors_1.CloudValidationError; } });
+Object.defineProperty(exports, "CidrError", { enumerable: true, get: function () { return errors_1.CidrError; } });
+Object.defineProperty(exports, "UnsupportedFeatureError", { enumerable: true, get: function () { return errors_1.UnsupportedFeatureError; } });
+Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return errors_1.ConfigError; } });
+Object.defineProperty(exports, "assertNever", { enumerable: true, get: function () { return errors_1.assertNever; } });
+var tags_1 = require("./tags");
+Object.defineProperty(exports, "normalizeTags", { enumerable: true, get: function () { return tags_1.normalizeTags; } });
+Object.defineProperty(exports, "isValidGcpLabel", { enumerable: true, get: function () { return tags_1.isValidGcpLabel; } });
+Object.defineProperty(exports, "mergeWithRequiredTags", { enumerable: true, get: function () { return tags_1.mergeWithRequiredTags; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateFeature", { enumerable: true, get: function () { return validation_1.validateFeature; } });
+Object.defineProperty(exports, "isFeatureSupported", { enumerable: true, get: function () { return validation_1.isFeatureSupported; } });
+Object.defineProperty(exports, "validateMultiCloud", { enumerable: true, get: function () { return validation_1.validateMultiCloud; } });
+Object.defineProperty(exports, "validateResourceName", { enumerable: true, get: function () { return validation_1.validateResourceName; } });
+Object.defineProperty(exports, "assertValidMultiCloud", { enumerable: true, get: function () { return validation_1.assertValidMultiCloud; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAUwB;AALtB,+GAAA,eAAe,OAAA;AACf,+GAAA,eAAe,OAAA;AACf,+GAAA,eAAe,OAAA;AACf,6GAAA,aAAa,OAAA;AACb,kHAAA,kBAAkB,OAAA;AAGpB,mCASkB;AAPhB,qGAAA,WAAW,OAAA;AACX,uGAAA,aAAa,OAAA;AACb,8GAAA,oBAAoB,OAAA;AACpB,mGAAA,SAAS,OAAA;AACT,iHAAA,uBAAuB,OAAA;AACvB,qGAAA,WAAW,OAAA;AACX,qGAAA,WAAW,OAAA;AAGb,+BAAmG;AAAtE,qGAAA,aAAa,OAAA;AAAE,uGAAA,eAAe,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAElF,2CAOsB;AALpB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AACpB,mHAAA,qBAAqB,OAAA"}

package/dist/esm/types/tags.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cross-cloud tagging strategy for @reyemtech/nimbus.
+ *
+ * Normalizes tags/labels across AWS, Azure, and GCP.
+ * GCP has strict label requirements: lowercase, no special chars, max 63 chars.
+ *
+ * @module types/tags
+ */
+import type { CloudProvider } from "./cloud-target";
+/** Required tags applied to every resource. */
+export interface IRequiredTags {
+    readonly environment: string;
+    readonly client: string;
+    readonly costCenter: string;
+    readonly managedBy: "nimbus";
+}
+/**
+ * Normalize tags for a specific cloud provider.
+ *
+ * - **AWS:** Tags pass through as-is (supports most characters).
+ * - **Azure:** Tags pass through as-is (supports most characters).
+ * - **GCP:** Labels are lowercased, special chars replaced with hyphens,
+ *   truncated to 63 chars, and must start with a lowercase letter.
+ *
+ * @param tags - Raw tags to normalize
+ * @param provider - Target cloud provider
+ * @returns Normalized tags for the provider
+ *
+ * @example
+ * ```typescript
+ * const tags = { Environment: "Production", "Cost-Center": "Engineering" };
+ * normalizeTags(tags, "gcp");
+ * // { environment: "production", cost-center: "engineering" }
+ * ```
+ */
+export declare function normalizeTags(tags: Readonly<Record<string, string>>, provider: CloudProvider): Record<string, string>;
+/**
+ * Validate that a GCP label key or value is compliant.
+ *
+ * @param value - Label string to validate
+ * @returns True if the label is valid for GCP
+ */
+export declare function isValidGcpLabel(value: string): boolean;
+/**
+ * Merge required tags with user-provided tags.
+ * Required tags take precedence for the `managedBy` key.
+ *
+ * @param required - Required tag values
+ * @param userTags - User-provided additional tags
+ * @returns Merged tag set
+ */
+export declare function mergeWithRequiredTags(required: Omit<IRequiredTags, "managedBy">, userTags?: Readonly<Record<string, string>>): Record<string, string>;
+//# sourceMappingURL=tags.d.ts.map

package/dist/esm/types/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/types/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;CAC9B;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,QAAQ,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAuCD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/esm/types/tags.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Cross-cloud tagging strategy for @reyemtech/nimbus.
+ *
+ * Normalizes tags/labels across AWS, Azure, and GCP.
+ * GCP has strict label requirements: lowercase, no special chars, max 63 chars.
+ *
+ * @module types/tags
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTags = normalizeTags;
+exports.isValidGcpLabel = isValidGcpLabel;
+exports.mergeWithRequiredTags = mergeWithRequiredTags;
+/** Maximum label key/value length for GCP. */
+const GCP_LABEL_MAX_LENGTH = 63;
+/** Regex for valid GCP label characters (lowercase letters, numbers, hyphens, underscores). */
+const GCP_LABEL_REGEX = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Normalize tags for a specific cloud provider.
+ *
+ * - **AWS:** Tags pass through as-is (supports most characters).
+ * - **Azure:** Tags pass through as-is (supports most characters).
+ * - **GCP:** Labels are lowercased, special chars replaced with hyphens,
+ *   truncated to 63 chars, and must start with a lowercase letter.
+ *
+ * @param tags - Raw tags to normalize
+ * @param provider - Target cloud provider
+ * @returns Normalized tags for the provider
+ *
+ * @example
+ * ```typescript
+ * const tags = { Environment: "Production", "Cost-Center": "Engineering" };
+ * normalizeTags(tags, "gcp");
+ * // { environment: "production", cost-center: "engineering" }
+ * ```
+ */
+function normalizeTags(tags, provider) {
+    if (provider !== "gcp") {
+        return { ...tags };
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(tags)) {
+        const normalizedKey = normalizeGcpLabelKey(key);
+        const normalizedValue = normalizeGcpLabelValue(value);
+        if (normalizedKey in normalized) {
+            console.warn(`[nimbus] GCP label key collision: "${key}" normalizes to "${normalizedKey}" which already exists. Skipping.`);
+            continue;
+        }
+        normalized[normalizedKey] = normalizedValue;
+    }
+    return normalized;
+}
+/**
+ * Normalize a string to a valid GCP label key.
+ * Keys must start with a lowercase letter.
+ */
+function normalizeGcpLabelKey(value) {
+    let label = value
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "-")
+        .replace(/^[^a-z]/, "l$&")
+        .replace(/-+/g, "-")
+        .replace(/-$/, "");
+    if (label.length > GCP_LABEL_MAX_LENGTH) {
+        label = label.substring(0, GCP_LABEL_MAX_LENGTH);
+    }
+    return label;
+}
+/**
+ * Normalize a string to a valid GCP label value.
+ * Values can start with any valid character (including digits).
+ */
+function normalizeGcpLabelValue(value) {
+    let label = value
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/-$/, "");
+    if (label.length > GCP_LABEL_MAX_LENGTH) {
+        label = label.substring(0, GCP_LABEL_MAX_LENGTH);
+    }
+    return label;
+}
+/**
+ * Validate that a GCP label key or value is compliant.
+ *
+ * @param value - Label string to validate
+ * @returns True if the label is valid for GCP
+ */
+function isValidGcpLabel(value) {
+    return value.length > 0 && value.length <= GCP_LABEL_MAX_LENGTH && GCP_LABEL_REGEX.test(value);
+}
+/**
+ * Merge required tags with user-provided tags.
+ * Required tags take precedence for the `managedBy` key.
+ *
+ * @param required - Required tag values
+ * @param userTags - User-provided additional tags
+ * @returns Merged tag set
+ */
+function mergeWithRequiredTags(required, userTags) {
+    return {
+        ...userTags,
+        environment: required.environment,
+        client: required.client,
+        costCenter: required.costCenter,
+        managedBy: "nimbus",
+    };
+}
+//# sourceMappingURL=tags.js.map

package/dist/esm/types/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../../src/types/tags.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAqCH,sCAqBC;AA6CD,0CAEC;AAUD,sDAWC;AAlHD,8CAA8C;AAC9C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,+FAA+F;AAC/F,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,aAAa,CAC3B,IAAsC,EACtC,QAAuB;IAEvB,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CACV,sCAAsC,GAAG,oBAAoB,aAAa,mCAAmC,CAC9G,CAAC;YACF,SAAS;QACX,CAAC;QACD,UAAU,CAAC,aAAa,CAAC,GAAG,eAAe,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,KAAK,GAAG,KAAK;SACd,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC;SACzB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAErB,IAAI,KAAK,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACxC,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAAa;IAC3C,IAAI,KAAK,GAAG,KAAK;SACd,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAErB,IAAI,KAAK,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACxC,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,oBAAoB,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,QAA0C,EAC1C,QAA2C;IAE3C,OAAO;QACL,GAAG,QAAQ;QACX,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,SAAS,EAAE,QAAQ;KACpB,CAAC;AACJ,CAAC"}