@reyemtech/nimbus 0.1.0

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

@@ -0,0 +1,63 @@
+/**
+ * Cross-cloud validation utilities.
+ *
+ * Validates multi-cloud configurations for compatibility:
+ * - Region naming consistency
+ * - Resource naming conflicts
+ * - Feature availability per provider
+ *
+ * @module types/validation
+ */
+import type { CloudProvider, ResolvedCloudTarget } from "./cloud-target";
+/** Validation result with warnings and errors. */
+export interface IValidationResult {
+    readonly valid: boolean;
+    readonly errors: ReadonlyArray<string>;
+    readonly warnings: ReadonlyArray<string>;
+}
+/**
+ * Validate that a feature is supported on a given provider.
+ *
+ * @param feature - Feature name to check
+ * @param provider - Cloud provider
+ * @throws {UnsupportedFeatureError} If the feature is not available
+ */
+export declare function validateFeature(feature: string, provider: CloudProvider): void;
+/**
+ * Check if a feature is available on a provider (non-throwing).
+ *
+ * @param feature - Feature name
+ * @param provider - Cloud provider
+ * @returns True if the feature is supported
+ */
+export declare function isFeatureSupported(feature: string, provider: CloudProvider): boolean;
+/**
+ * Validate a multi-cloud deployment configuration.
+ *
+ * Checks for:
+ * - Duplicate provider+region combinations
+ * - Resource name length constraints per provider
+ * - Region availability
+ *
+ * @param targets - Array of resolved cloud targets
+ * @param resourceName - Name that will be used for resources
+ * @returns Validation result with any errors/warnings
+ */
+export declare function validateMultiCloud(targets: ReadonlyArray<ResolvedCloudTarget>, resourceName: string): IValidationResult;
+/**
+ * Validate a resource name against provider-specific constraints.
+ *
+ * @param name - Resource name to validate
+ * @param provider - Target cloud provider
+ * @returns Validation result
+ */
+export declare function validateResourceName(name: string, provider: CloudProvider): IValidationResult;
+/**
+ * Assert that a multi-cloud configuration is valid, throwing on errors.
+ *
+ * @param targets - Resolved cloud targets
+ * @param resourceName - Resource name
+ * @throws {CloudValidationError} If validation fails
+ */
+export declare function assertValidMultiCloud(targets: ReadonlyArray<ResolvedCloudTarget>, resourceName: string): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAwBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAK9E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC3C,YAAY,EAAE,MAAM,GACnB,iBAAiB,CA0BnB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CA0C7F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC3C,YAAY,EAAE,MAAM,GACnB,IAAI,CAKN"}

package/dist/esm/types/validation.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Cross-cloud validation utilities.
+ *
+ * Validates multi-cloud configurations for compatibility:
+ * - Region naming consistency
+ * - Resource naming conflicts
+ * - Feature availability per provider
+ *
+ * @module types/validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFeature = validateFeature;
+exports.isFeatureSupported = isFeatureSupported;
+exports.validateMultiCloud = validateMultiCloud;
+exports.validateResourceName = validateResourceName;
+exports.assertValidMultiCloud = assertValidMultiCloud;
+const errors_1 = require("./errors");
+/** Features that may not be available on all providers. */
+const PROVIDER_FEATURES = {
+    aws: new Set([
+        "eks-auto-mode",
+        "fck-nat",
+        "managed-nat",
+        "spot-instances",
+        "route53",
+        "secrets-manager",
+    ]),
+    azure: new Set([
+        "virtual-nodes",
+        "azure-cni",
+        "managed-nat",
+        "spot-instances",
+        "azure-dns",
+        "key-vault",
+    ]),
+    gcp: new Set(["autopilot", "managed-nat", "spot-instances", "cloud-dns", "secret-manager"]),
+    rackspace: new Set(["spot-instances"]),
+};
+/**
+ * Validate that a feature is supported on a given provider.
+ *
+ * @param feature - Feature name to check
+ * @param provider - Cloud provider
+ * @throws {UnsupportedFeatureError} If the feature is not available
+ */
+function validateFeature(feature, provider) {
+    const supported = PROVIDER_FEATURES[provider];
+    if (!supported.has(feature)) {
+        throw new errors_1.UnsupportedFeatureError(feature, provider);
+    }
+}
+/**
+ * Check if a feature is available on a provider (non-throwing).
+ *
+ * @param feature - Feature name
+ * @param provider - Cloud provider
+ * @returns True if the feature is supported
+ */
+function isFeatureSupported(feature, provider) {
+    return PROVIDER_FEATURES[provider].has(feature);
+}
+/**
+ * Validate a multi-cloud deployment configuration.
+ *
+ * Checks for:
+ * - Duplicate provider+region combinations
+ * - Resource name length constraints per provider
+ * - Region availability
+ *
+ * @param targets - Array of resolved cloud targets
+ * @param resourceName - Name that will be used for resources
+ * @returns Validation result with any errors/warnings
+ */
+function validateMultiCloud(targets, resourceName) {
+    const errors = [];
+    const warnings = [];
+    // Check for duplicate targets
+    const seen = new Set();
+    for (const target of targets) {
+        const key = `${target.provider}:${target.region}`;
+        if (seen.has(key)) {
+            errors.push(`Duplicate target: ${key}. Each provider+region combination must be unique.`);
+        }
+        seen.add(key);
+    }
+    // Validate resource naming per provider
+    for (const target of targets) {
+        const nameIssues = validateResourceName(resourceName, target.provider);
+        errors.push(...nameIssues.errors);
+        warnings.push(...nameIssues.warnings);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate a resource name against provider-specific constraints.
+ *
+ * @param name - Resource name to validate
+ * @param provider - Target cloud provider
+ * @returns Validation result
+ */
+function validateResourceName(name, provider) {
+    const errors = [];
+    const warnings = [];
+    switch (provider) {
+        case "aws":
+            // AWS names are generally flexible but some have 63-char limits
+            if (name.length > 63) {
+                errors.push(`Resource name "${name}" exceeds AWS 63-character limit.`);
+            }
+            break;
+        case "azure":
+            // Azure resource names: 1-63 chars, alphanumeric + hyphens
+            if (name.length > 63) {
+                errors.push(`Resource name "${name}" exceeds Azure 63-character limit.`);
+            }
+            if (/[^a-zA-Z0-9-]/.test(name)) {
+                warnings.push(`Resource name "${name}" contains characters not allowed in Azure (only alphanumeric + hyphens).`);
+            }
+            break;
+        case "gcp":
+            // GCP: 1-63 chars, lowercase + hyphens, must start with letter
+            if (name.length > 63) {
+                errors.push(`Resource name "${name}" exceeds GCP 63-character limit.`);
+            }
+            if (name !== name.toLowerCase()) {
+                warnings.push(`Resource name "${name}" will be lowercased for GCP.`);
+            }
+            if (!/^[a-z]/.test(name.toLowerCase())) {
+                errors.push(`Resource name "${name}" must start with a letter for GCP.`);
+            }
+            break;
+        case "rackspace":
+            if (name.length > 255) {
+                errors.push(`Resource name "${name}" exceeds Rackspace 255-character limit.`);
+            }
+            break;
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Assert that a multi-cloud configuration is valid, throwing on errors.
+ *
+ * @param targets - Resolved cloud targets
+ * @param resourceName - Resource name
+ * @throws {CloudValidationError} If validation fails
+ */
+function assertValidMultiCloud(targets, resourceName) {
+    const result = validateMultiCloud(targets, resourceName);
+    if (!result.valid) {
+        throw new errors_1.CloudValidationError(`Multi-cloud validation failed:\n${result.errors.join("\n")}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

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

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

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@reyemtech/nimbus",
+  "version": "0.1.0",
+  "description": "Cloud-agnostic infrastructure abstractions for Pulumi",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "docs:api": "typedoc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "pulumi",
+    "cloud",
+    "aws",
+    "azure",
+    "gcp",
+    "infrastructure",
+    "iac",
+    "multi-cloud"
+  ],
+  "author": "ReyemTech <mario@reyem.tech>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reyemtech/nimbus.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@pulumi/pulumi": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@pulumi/aws": "^7.19.0",
+    "@pulumi/awsx": "^3.1.0",
+    "@pulumi/azure-native": "^3.13.0",
+    "@pulumi/eks": "^4.2.0",
+    "@pulumi/kubernetes": "^4.25.0",
+    "@pulumi/pulumi": "^3.142.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "prettier": "^3.4.0",
+    "semantic-release": "^25.0.3",
+    "typedoc": "^0.28.16",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.0.0"
+  }
+}