@stackweld/core 0.3.1 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @stackweld/core
 
-[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/mundowise/Stackweld/releases)
+[![Version](https://img.shields.io/badge/version-0.4.0-blue.svg)](https://github.com/mundowise/Stackweld/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 The core engine for Stackweld. Handles stack persistence, compatibility rules, scaffolding orchestration, Docker lifecycle, and all analysis modules.

package/dist/engine/compose-generator.d.ts

@@ -1,7 +1,3 @@
-/**
- * Compose Generator — Pure function that generates docker-compose.yml content.
- * No disk I/O — returns structured data for preview or writing.
- */
 export interface ComposePreviewResult {
     yaml: string;
     services: string[];
@@ -24,10 +20,6 @@ interface ComposeTechnology {
     };
     port?: number;
 }
-/**
- * Generate a docker-compose.yml preview from a list of technologies.
- * Only includes technologies that have a `dockerImage`.
- */
 export declare function generateComposePreview(technologies: ComposeTechnology[], projectName: string): ComposePreviewResult;
 export {};
 //# sourceMappingURL=compose-generator.d.ts.map

package/dist/engine/compose-generator.js

@@ -1,17 +1,10 @@
-/**
- * Compose Generator — Pure function that generates docker-compose.yml content.
- * No disk I/O — returns structured data for preview or writing.
- */
+// No disk I/O — returns structured data, caller decides what to write.
 const DATA_MOUNTS = {
     postgresql: "/var/lib/postgresql/data",
     mysql: "/var/lib/mysql",
     mongodb: "/data/db",
     redis: "/data",
 };
-/**
- * Generate a docker-compose.yml preview from a list of technologies.
- * Only includes technologies that have a `dockerImage`.
- */
 export function generateComposePreview(technologies, projectName) {
     const services = [];
     const ports = {};
@@ -26,13 +19,11 @@ export function generateComposePreview(technologies, projectName) {
         lines.push(`  ${tech.id}:`);
         lines.push(`    image: ${tech.dockerImage}`);
         lines.push("    restart: unless-stopped");
-        // Ports
         if (port) {
             lines.push("    ports:");
             lines.push(`      - "${port}:${port}"`);
             ports[tech.id] = port;
         }
-        // Environment variables
         const envVars = tech.envVars ? Object.entries(tech.envVars) : [];
         if (envVars.length > 0) {
             lines.push("    environment:");
@@ -40,7 +31,6 @@ export function generateComposePreview(technologies, projectName) {
                 lines.push(`      ${key}: "${value}"`);
             }
         }
-        // Health check
         if (tech.healthCheck) {
             lines.push("    healthcheck:");
             if (tech.healthCheck.command) {
@@ -59,7 +49,6 @@ export function generateComposePreview(technologies, projectName) {
                 lines.push(`      retries: ${tech.healthCheck.retries}`);
             }
         }
-        // Volumes for databases
         const mountPath = DATA_MOUNTS[tech.id];
         if (mountPath && tech.category === "database") {
             const volName = `${tech.id}_data`;
@@ -67,12 +56,10 @@ export function generateComposePreview(technologies, projectName) {
             lines.push(`      - ${volName}:${mountPath}`);
             volumes.push(volName);
         }
-        // Network
         lines.push("    networks:");
         lines.push(`      - ${networkName}`);
         lines.push("");
     }
-    // Named volumes
     if (volumes.length > 0) {
         lines.push("volumes:");
         for (const vol of volumes) {
@@ -80,7 +67,6 @@ export function generateComposePreview(technologies, projectName) {
         }
         lines.push("");
     }
-    // Network
     lines.push("networks:");
     lines.push(`  ${networkName}:`);
     lines.push("    driver: bridge");

package/dist/engine/license-manager.d.ts

@@ -0,0 +1,29 @@
+export type LicenseTier = "community" | "pro" | "enterprise";
+export interface LicenseInfo {
+    tier: LicenseTier;
+    email: string | null;
+    validUntil: string | null;
+    active: boolean;
+}
+export interface FeatureGate {
+    feature: string;
+    requiredTier: LicenseTier;
+    description: string;
+}
+export declare function activateLicense(key: string, email: string): {
+    success: boolean;
+    message: string;
+};
+export declare function deactivateLicense(): {
+    success: boolean;
+    message: string;
+};
+export declare function getLicenseInfo(): LicenseInfo;
+export declare function checkFeatureAccess(feature: string): {
+    allowed: boolean;
+    requiredTier: LicenseTier;
+    message: string;
+};
+export declare function listFeatures(): FeatureGate[];
+export declare function getFeatureTier(feature: string): LicenseTier;
+//# sourceMappingURL=license-manager.d.ts.map

package/dist/engine/license-manager.js

@@ -0,0 +1,130 @@
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+const PRO_FEATURES = [
+    {
+        feature: "ai",
+        requiredTier: "pro",
+        description: "AI-powered suggestions, README generation, and architecture explanations",
+    },
+    {
+        feature: "infra",
+        requiredTier: "pro",
+        description: "Infrastructure as Code generation (VPS, AWS, GCP)",
+    },
+    { feature: "cost", requiredTier: "pro", description: "Hosting cost estimation across providers" },
+    { feature: "benchmark", requiredTier: "pro", description: "Stack performance profiling" },
+    { feature: "migrate", requiredTier: "pro", description: "Technology migration planner" },
+    { feature: "deploy", requiredTier: "pro", description: "Deployment configuration generation" },
+    { feature: "plugin-install", requiredTier: "pro", description: "Install community plugins" },
+    { feature: "cloud-sync", requiredTier: "enterprise", description: "Sync stacks across machines" },
+    {
+        feature: "team-standards",
+        requiredTier: "enterprise",
+        description: "Enforce team-wide stack standards",
+    },
+    {
+        feature: "audit-log",
+        requiredTier: "enterprise",
+        description: "Detailed audit trail of all operations",
+    },
+];
+const TIER_HIERARCHY = {
+    community: 0,
+    pro: 1,
+    enterprise: 2,
+};
+function getLicensePath() {
+    const home = process.env.HOME || process.env.USERPROFILE || "~";
+    return path.join(home, ".stackweld", "license.json");
+}
+function hashKey(key) {
+    return createHash("sha256").update(key).digest("hex");
+}
+function validateKeyFormat(key) {
+    // Format: SW-PRO-XXXX-XXXX-XXXX or SW-ENT-XXXX-XXXX-XXXX
+    return /^SW-(PRO|ENT)-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/.test(key);
+}
+function tierFromKey(key) {
+    if (key.startsWith("SW-ENT-"))
+        return "enterprise";
+    if (key.startsWith("SW-PRO-"))
+        return "pro";
+    return "community";
+}
+export function activateLicense(key, email) {
+    if (!validateKeyFormat(key)) {
+        return {
+            success: false,
+            message: "Invalid license key format. Expected: SW-PRO-XXXX-XXXX-XXXX",
+        };
+    }
+    const tier = tierFromKey(key);
+    const licensePath = getLicensePath();
+    const dir = path.dirname(licensePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const license = {
+        keyHash: hashKey(key),
+        tier,
+        email,
+        activatedAt: new Date().toISOString(),
+        validUntil: null,
+    };
+    fs.writeFileSync(licensePath, JSON.stringify(license, null, 2), "utf-8");
+    return {
+        success: true,
+        message: `${tier.charAt(0).toUpperCase() + tier.slice(1)} license activated for ${email}`,
+    };
+}
+export function deactivateLicense() {
+    const licensePath = getLicensePath();
+    if (fs.existsSync(licensePath)) {
+        fs.unlinkSync(licensePath);
+        return { success: true, message: "License deactivated. Reverted to Community tier." };
+    }
+    return { success: false, message: "No active license found." };
+}
+export function getLicenseInfo() {
+    const licensePath = getLicensePath();
+    if (!fs.existsSync(licensePath)) {
+        return { tier: "community", email: null, validUntil: null, active: false };
+    }
+    try {
+        const data = JSON.parse(fs.readFileSync(licensePath, "utf-8"));
+        const expired = data.validUntil ? new Date(data.validUntil) < new Date() : false;
+        return {
+            tier: expired ? "community" : data.tier,
+            email: data.email,
+            validUntil: data.validUntil,
+            active: !expired,
+        };
+    }
+    catch {
+        return { tier: "community", email: null, validUntil: null, active: false };
+    }
+}
+export function checkFeatureAccess(feature) {
+    const gate = PRO_FEATURES.find((f) => f.feature === feature);
+    if (!gate)
+        return { allowed: true, requiredTier: "community", message: "" };
+    const license = getLicenseInfo();
+    const userLevel = TIER_HIERARCHY[license.tier];
+    const requiredLevel = TIER_HIERARCHY[gate.requiredTier];
+    if (userLevel >= requiredLevel) {
+        return { allowed: true, requiredTier: gate.requiredTier, message: "" };
+    }
+    return {
+        allowed: false,
+        requiredTier: gate.requiredTier,
+        message: `"${gate.description}" requires a ${gate.requiredTier} license. Upgrade at https://stackweld.dev/pro`,
+    };
+}
+export function listFeatures() {
+    return PRO_FEATURES;
+}
+export function getFeatureTier(feature) {
+    const gate = PRO_FEATURES.find((f) => f.feature === feature);
+    return gate?.requiredTier ?? "community";
+}
+//# sourceMappingURL=license-manager.js.map

package/dist/engine/stack-engine.d.ts

@@ -1,16 +1,8 @@
-/**
- * Stack Engine — CRUD operations for stack definitions.
- * Handles creation, validation, versioning, and persistence.
- */
 import type { StackDefinition, StackProfile, StackTechnology, StackVersion, ValidationResult } from "../types/index.js";
 import type { RulesEngine } from "./rules-engine.js";
 export declare class StackEngine {
     private rules;
     constructor(rules: RulesEngine);
-    /**
-     * Create a new stack definition.
-     * Validates technologies and auto-resolves dependencies.
-     */
     create(opts: {
         name: string;
         description?: string;
@@ -21,21 +13,9 @@ export declare class StackEngine {
         stack: StackDefinition;
         validation: ValidationResult;
     };
-    /**
-     * Get a stack by ID.
-     */
     get(id: string): StackDefinition | null;
-    /**
-     * List all stacks.
-     */
     list(): StackDefinition[];
-    /**
-     * Delete a stack.
-     */
     delete(id: string): boolean;
-    /**
-     * Update a stack. Auto-increments version and saves snapshot.
-     */
     update(id: string, changes: Partial<Pick<StackDefinition, "name" | "description" | "profile" | "technologies" | "tags">>): {
         stack: StackDefinition;
         validation: ValidationResult;

package/dist/engine/stack-engine.js

@@ -1,7 +1,3 @@
-/**
- * Stack Engine — CRUD operations for stack definitions.
- * Handles creation, validation, versioning, and persistence.
- */
 import { randomUUID } from "node:crypto";
 import { getDatabase } from "../db/database.js";
 export class StackEngine {
@@ -9,13 +5,8 @@ export class StackEngine {
     constructor(rules) {
         this.rules = rules;
     }
-    /**
-     * Create a new stack definition.
-     * Validates technologies and auto-resolves dependencies.
-     */
     create(opts) {
         const validation = this.rules.validate(opts.technologies);
-        // Add auto-resolved dependencies
         const allTechs = [...opts.technologies];
         for (const depId of validation.resolvedDependencies) {
             const tech = this.rules.getTechnology(depId);
@@ -27,7 +18,6 @@ export class StackEngine {
                 });
             }
         }
-        // Apply port assignments to existing techs
         for (const t of allTechs) {
             if (validation.portAssignments[t.technologyId]) {
                 t.port = validation.portAssignments[t.technologyId];
@@ -50,9 +40,6 @@ export class StackEngine {
         }
         return { stack, validation };
     }
-    /**
-     * Get a stack by ID.
-     */
     get(id) {
         const db = getDatabase();
         const row = db.prepare("SELECT * FROM stacks WHERE id = ?").get(id);
@@ -78,25 +65,16 @@ export class StackEngine {
             })),
         };
     }
-    /**
-     * List all stacks.
-     */
     list() {
         const db = getDatabase();
         const rows = db.prepare("SELECT id FROM stacks ORDER BY updated_at DESC").all();
         return rows.map((r) => this.get(r.id)).filter(Boolean);
     }
-    /**
-     * Delete a stack.
-     */
     delete(id) {
         const db = getDatabase();
         const result = db.prepare("DELETE FROM stacks WHERE id = ?").run(id);
         return result.changes > 0;
     }
-    /**
-     * Update a stack. Auto-increments version and saves snapshot.
-     */
     update(id, changes) {
         const existing = this.get(id);
         if (!existing)
@@ -112,7 +90,6 @@ export class StackEngine {
         updated_at = ?, tags = ?
       WHERE id = ?
     `).run(changes.name || existing.name, changes.description ?? existing.description, changes.profile || existing.profile, newVersion, now, JSON.stringify(changes.tags || existing.tags), id);
-        // Replace technologies
         db.prepare("DELETE FROM stack_technologies WHERE stack_id = ?").run(id);
         for (const t of techs) {
             db.prepare(`
@@ -120,7 +97,6 @@ export class StackEngine {
         VALUES (?, ?, ?, ?, ?)
       `).run(id, t.technologyId, t.version, t.port || null, JSON.stringify(t.config || {}));
         }
-        // Save version snapshot
         const updatedStack = this.get(id);
         this.saveVersionSnapshot(updatedStack, `Updated to v${newVersion}`);
         return { stack: updatedStack, validation };

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export type { HealthCheck, HealthReport } from "./engine/health-checker.js";
 export { checkProjectHealth } from "./engine/health-checker.js";
 export type { DeployTarget, InfraOutput } from "./engine/infra-generator.js";
 export { generateInfra } from "./engine/infra-generator.js";
+export type { FeatureGate, LicenseInfo, LicenseTier } from "./engine/license-manager.js";
+export { activateLicense, checkFeatureAccess, deactivateLicense, getLicenseInfo, listFeatures, } from "./engine/license-manager.js";
 export type { MigrationPlan, MigrationStep } from "./engine/migration-planner.js";
 export { planMigration } from "./engine/migration-planner.js";
 export type { PerformanceProfile, TechPerformance, } from "./engine/performance-profiler.js";

package/dist/index.js

@@ -7,6 +7,7 @@ export { estimateCost } from "./engine/cost-estimator.js";
 export { checkDangerous, parseEnvFile, syncEnv } from "./engine/env-analyzer.js";
 export { checkProjectHealth } from "./engine/health-checker.js";
 export { generateInfra } from "./engine/infra-generator.js";
+export { activateLicense, checkFeatureAccess, deactivateLicense, getLicenseInfo, listFeatures, } from "./engine/license-manager.js";
 export { planMigration } from "./engine/migration-planner.js";
 export { profilePerformance } from "./engine/performance-profiler.js";
 export { getPluginDir, getPluginInfo, installPlugin, listPlugins, loadPlugin, loadPluginTechnologies, removePlugin, } from "./engine/plugin-loader.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackweld/core",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Core engine for Stackweld — rules, scaffold orchestrator, runtime manager, tech installer, and SQLite persistence.",
   "license": "MIT",
   "author": "Orlando Fernandez <hello@xplustechnologies.com>",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025-2026 Orlando Fernandez / XPlus Technologies LLC
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.