@factiii/stack 0.1.2

package/dist/scripts/validate-example-values.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Validates that factiii.yml doesn't contain EXAMPLE- placeholder values
+ * This script properly parses YAML and ignores comments
+ * Use this in workflows instead of grep to avoid false positives from documentation
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const configPath = process.argv[2] ?? 'factiii.yml';
+if (!fs.existsSync(configPath)) {
+    console.log(`❌ ${configPath} not found`);
+    process.exit(1);
+}
+try {
+    const content = fs.readFileSync(configPath, 'utf8');
+    const config = js_yaml_1.default.load(content);
+    const exampleValues = [];
+    // Recursively scan parsed YAML object for EXAMPLE- values
+    // This properly ignores comments since we're scanning the parsed structure
+    function scanForExamples(obj, path = '') {
+        if (typeof obj === 'string' && obj.includes('EXAMPLE-')) {
+            exampleValues.push({ path: path || 'root', value: obj });
+        }
+        else if (typeof obj === 'object' && obj !== null) {
+            for (const [key, value] of Object.entries(obj)) {
+                const newPath = path ? `${path}.${key}` : key;
+                scanForExamples(value, newPath);
+            }
+        }
+    }
+    scanForExamples(config);
+    if (exampleValues.length > 0) {
+        console.log('❌ Found EXAMPLE- placeholder values in ' + configPath);
+        console.log('');
+        exampleValues.forEach(({ path, value }) => {
+            console.log(`   ${path}: ${value}`);
+        });
+        console.log('');
+        console.log('💡 Please replace all EXAMPLE- values with your actual configuration.');
+        process.exit(1);
+    }
+    console.log('✅ No EXAMPLE- placeholder values found');
+    process.exit(0);
+}
+catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.log('❌ Failed to parse ' + configPath + ':', errorMessage);
+    process.exit(1);
+}
+//# sourceMappingURL=validate-example-values.js.map

package/dist/scripts/validate-example-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-example-values.js","sourceRoot":"","sources":["../../src/scripts/validate-example-values.ts"],"names":[],"mappings":";;AAEA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,sDAA2B;AAO3B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC;AAEpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,YAAY,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,iBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,aAAa,GAAmB,EAAE,CAAC;IAEzC,0DAA0D;IAC1D,2EAA2E;IAC3E,SAAS,eAAe,CAAC,GAAY,EAAE,OAAe,EAAE;QACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;gBAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9C,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,yCAAyC,GAAG,UAAU,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YACxC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,UAAU,GAAG,GAAG,EAAE,YAAY,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/scripts/validate-factiii-yml.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Validates factiii.yml configuration file
+ */
+export {};
+//# sourceMappingURL=validate-factiii-yml.d.ts.map

package/dist/scripts/validate-factiii-yml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-factiii-yml.d.ts","sourceRoot":"","sources":["../../src/scripts/validate-factiii-yml.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/scripts/validate-factiii-yml.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Validates factiii.yml configuration file
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+try {
+    if (!fs.existsSync('factiii.yml')) {
+        console.log('[ERROR] factiii.yml not found');
+        process.exit(1);
+    }
+    console.log('[OK] factiii.yml exists');
+    const config = js_yaml_1.default.load(fs.readFileSync('factiii.yml', 'utf8'));
+    if (!config?.name) {
+        console.log('[ERROR] factiii.yml missing required field: name');
+        process.exit(1);
+    }
+    if (!config?.environments) {
+        console.log('[ERROR] factiii.yml missing required field: environments');
+        process.exit(1);
+    }
+    console.log('[OK] factiii.yml is valid');
+    const githubOutput = process.env.GITHUB_OUTPUT;
+    if (githubOutput) {
+        fs.appendFileSync(githubOutput, 'repo-name=' + config.name + '\n');
+    }
+}
+catch (e) {
+    const errorMessage = e instanceof Error ? e.message : String(e);
+    console.log('[ERROR] factiii.yml has syntax errors:', errorMessage);
+    process.exit(1);
+}
+//# sourceMappingURL=validate-factiii-yml.js.map

package/dist/scripts/validate-factiii-yml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-factiii-yml.js","sourceRoot":"","sources":["../../src/scripts/validate-factiii-yml.ts"],"names":[],"mappings":";;AAEA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,sDAA2B;AAO3B,IAAI,CAAC;IACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,MAAM,GAAG,iBAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAyB,CAAC;IACzF,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC/C,IAAI,YAAY,EAAE,CAAC;QACjB,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,MAAM,YAAY,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE,YAAY,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/types/cli.d.ts

@@ -0,0 +1,138 @@
+/**
+ * CLI Types
+ *
+ * Types for CLI command options and results.
+ */
+import type { Stage, Fix } from './plugin.js';
+/**
+ * Base options shared by most commands
+ */
+export interface BaseOptions {
+    rootDir?: string;
+}
+/**
+ * Options for the scan command
+ */
+export interface ScanOptions extends BaseOptions {
+    dev?: boolean;
+    staging?: boolean;
+    prod?: boolean;
+    secrets?: boolean;
+    stages?: Stage[];
+    commit?: string;
+    silent?: boolean;
+}
+/**
+ * Problems found during scan, grouped by stage
+ */
+export interface ScanProblems {
+    dev: Fix[];
+    secrets: Fix[];
+    staging: Fix[];
+    prod: Fix[];
+}
+/**
+ * Options for the deploy command
+ */
+export interface DeployOptions extends ScanOptions {
+    environment?: string;
+    branch?: string;
+    token?: string;
+    deploySecrets?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Options for the fix command
+ */
+export interface FixOptions extends ScanOptions {
+    token?: string;
+    continueOnError?: boolean;
+}
+/**
+ * Result of running fixes
+ */
+export interface FixResult {
+    fixed: number;
+    manual: number;
+    failed: number;
+    fixes: {
+        id: string;
+        stage: Stage;
+        status: 'fixed' | 'manual' | 'failed';
+        description?: string;
+        manualFix?: string;
+        error?: string;
+    }[];
+}
+/**
+ * Options for the init command
+ */
+export interface InitOptions extends BaseOptions {
+    force?: boolean;
+}
+/**
+ * Options for the undeploy command
+ */
+export interface UndeployOptions extends BaseOptions {
+    dev?: boolean;
+    staging?: boolean;
+    prod?: boolean;
+    environment?: string;
+}
+/**
+ * Options for the secrets command
+ */
+export interface SecretsOptions extends BaseOptions {
+    value?: string;
+    deploy?: boolean;
+    token?: string;
+    staging?: boolean;
+    prod?: boolean;
+    restart?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Options for the upgrade command
+ */
+export interface UpgradeOptions extends BaseOptions {
+    check?: boolean;
+}
+/**
+ * Options for the validate command (legacy)
+ */
+export interface ValidateOptions {
+    config?: string;
+}
+/**
+ * Options for the check-config command (legacy)
+ */
+export interface CheckConfigOptions {
+    environment?: string;
+}
+/**
+ * Options for generate-workflows command
+ */
+export interface GenerateWorkflowsOptions {
+    output?: string;
+}
+/**
+ * Options for the dev-sync command
+ */
+export interface DevSyncOptions extends BaseOptions {
+    staging?: boolean;
+    prod?: boolean;
+    deploy?: boolean;
+}
+/**
+ * Reachability info for display
+ */
+export interface ReachabilityInfo {
+    reachable: boolean;
+    reason?: string;
+    via?: string;
+}
+/**
+ * Reachability map by stage
+ */
+export type ReachabilityMap = Record<Stage, ReachabilityInfo>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/cli.d.ts.map

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

package/dist/types/cli.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * CLI Types
+ *
+ * Types for CLI command options and results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli.js.map

package/dist/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/types/config.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Configuration Types
+ *
+ * Types for factiii.yml and factiiiAuto.yml configuration files.
+ */
+/**
+ * Server OS types (duplicated here to avoid circular imports)
+ */
+export type ServerOSConfig = 'mac' | 'ubuntu' | 'windows' | 'amazon-linux' | 'alpine';
+/**
+ * Environment configuration (staging, prod, etc.)
+ *
+ * Environments are top-level keys with all their config inline.
+ * Each environment specifies which server OS to use and can have
+ * pipeline-specific or plugin-specific configuration.
+ */
+export interface EnvironmentConfig {
+    server: ServerOSConfig;
+    domain: string;
+    ssh_user?: string;
+    env_file?: string;
+    server_mode?: boolean;
+    pipeline?: string;
+    config?: 'ec2' | 'free-tier' | 'standard' | 'enterprise';
+    access_key_id?: string;
+    region?: string;
+    plugins?: Record<string, Record<string, unknown>>;
+}
+/**
+ * Main factiii.yml configuration
+ *
+ * Environments are stored as top-level keys. Any key that is NOT
+ * in the reserved list (name, config_version, github_repo, etc.)
+ * is treated as an environment configuration.
+ *
+ * Note: This interface uses an index signature to support dynamic environment keys.
+ */
+export interface FactiiiConfig {
+    name: string;
+    config_version?: string;
+    github_repo?: string;
+    ssl_email?: string;
+    pipeline?: string;
+    prisma_schema?: string | null;
+    prisma_version?: string | null;
+    trusted_plugins?: string[];
+    container_exclusions?: string[];
+    ansible?: {
+        vault_path: string;
+        vault_password_file?: string;
+    };
+    [environmentName: string]: any;
+}
+/**
+ * Auto-detected configuration (factiiiAuto.yml)
+ */
+export interface FactiiiAutoConfig {
+    ssh_user?: string;
+    dockerfile?: string;
+    package_manager?: 'npm' | 'yarn' | 'pnpm';
+    node_version?: string;
+    pnpm_version?: string;
+    prisma_schema?: string;
+    prisma_version?: string;
+    aws_cli_installed?: boolean;
+}
+/**
+ * Schema field definition for config validation
+ */
+export interface SchemaFields {
+    required: string[];
+    optional: string[];
+}
+/**
+ * AWS fields schema
+ */
+export interface AWSFieldsSchema {
+    required: string[];
+    optional: string[];
+}
+/**
+ * Environment fields schema
+ */
+export interface EnvironmentFieldsSchema {
+    required: string[];
+    optional: string[];
+}
+/**
+ * Complete schema definition for a config version
+ */
+export interface ConfigVersionSchema {
+    required: string[];
+    optional: string[];
+    awsFields: AWSFieldsSchema;
+    environmentFields: EnvironmentFieldsSchema;
+}
+/**
+ * Schema validation result
+ */
+export interface SchemaValidationResult {
+    valid: boolean;
+    missing: string[];
+    deprecated: string[];
+    newOptional: Array<{
+        path: string;
+        description: string;
+    }>;
+    needsMigration: boolean;
+    configVersion: string;
+    targetVersion: string;
+    error?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Configuration Types
+ *
+ * Types for factiii.yml and factiiiAuto.yml configuration files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type Definitions Index
+ *
+ * Re-exports all types for convenient importing.
+ */
+export * from './config.js';
+export * from './plugin.js';
+export * from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/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,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Type Definitions Index
+ *
+ * Re-exports all types for convenient importing.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config.js"), exports);
+__exportStar(require("./plugin.js"), exports);
+__exportStar(require("./cli.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,8CAA4B;AAC5B,2CAAyB"}