mobilestacks 0.1.7 → 0.1.8

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const config_loading_1 = require("../config/config-loading");
+const runtime_environment_1 = require("../core/runtime-environment");
+const tasks_definitions_1 = require("../core/tasks-definitions");
+const init_1 = require("./init");
+const inquirer_1 = __importDefault(require("inquirer"));
+// Import all user tasks
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// Auto-load all tasks in src/tasks
+const tasksDir = path_1.default.join(__dirname, '../tasks');
+fs_1.default.readdirSync(tasksDir)
+    .filter(f => (f.endsWith('.ts') || f.endsWith('.js')) && !f.endsWith('.d.ts') && !f.includes('.test.'))
+    .forEach(f => {
+    require(path_1.default.join(tasksDir, f));
+});
+const program = new commander_1.Command();
+program
+    .name('mobilestacks')
+    .description('Professional Task Runner for Stacks')
+    .version('0.1.0');
+// Init command for project scaffolding
+program
+    .command('init')
+    .description('Scaffold a new mobilestacks project and config')
+    .action(async () => {
+    await (0, init_1.runInit)();
+    process.exit(0);
+});
+// List all tasks if no command is given
+program.action(() => {
+    console.log(chalk_1.default.bold.blue('\nMobilestacks - Professional Task Runner for Stacks\n'));
+    console.log(chalk_1.default.white('USAGE: ') + chalk_1.default.green('mobilestacks <task> [options]\n'));
+    console.log(chalk_1.default.bold('Available tasks:'));
+    tasks_definitions_1.TaskDefinitions.getInstance().getAllTasks().forEach(task => {
+        const params = task.params.map(p => chalk_1.default.yellow(`--${p.name}`)).join(' ');
+        console.log('  ' + chalk_1.default.cyan(task.name) + ' ' + params);
+        console.log('    ' + chalk_1.default.gray(task.description));
+    });
+    console.log('\n' + chalk_1.default.white('Use ') + chalk_1.default.green('mobilestacks <task> --help') + chalk_1.default.white(' for more info on a task.'));
+    console.log(chalk_1.default.white('\nExample:'));
+    console.log('  ' + chalk_1.default.green('mobilestacks deploy-contract --contractName my-contract --file ./contracts/my-contract.clar --network testnet'));
+    console.log(chalk_1.default.white('\nDocs: ') + chalk_1.default.underline('https://github.com/your-org/mobilestacks#readme'));
+    program.help({ error: false });
+});
+// Dynamically add all registered tasks
+tasks_definitions_1.TaskDefinitions.getInstance().getAllTasks().forEach(task => {
+    const cmd = program.command(task.name)
+        .description(task.description);
+    task.params.forEach(param => {
+        const optStr = `--${param.name} <value>`;
+        if (param.required !== false) {
+            cmd.option(optStr, param.description);
+        }
+        else {
+            cmd.option(optStr, param.description, param.defaultValue);
+        }
+    });
+    cmd.action(async (opts) => {
+        try {
+            // Prompt for missing required params
+            const missing = task.params.filter(p => p.required !== false && !opts[p.name]);
+            if (missing.length > 0) {
+                const answers = await inquirer_1.default.prompt(missing.map(p => ({
+                    type: p.type === 'boolean' ? 'confirm' : 'input',
+                    name: p.name,
+                    message: p.description,
+                    default: p.defaultValue
+                })));
+                Object.assign(opts, answers);
+            }
+            // Type conversion
+            task.params.forEach(p => {
+                if (opts[p.name] && p.type === 'number')
+                    opts[p.name] = Number(opts[p.name]);
+                if (opts[p.name] && p.type === 'boolean')
+                    opts[p.name] = Boolean(opts[p.name]);
+            });
+            const config = (0, config_loading_1.loadConfig)();
+            const env = new runtime_environment_1.RuntimeEnvironment(config);
+            const result = await task.action(opts, env);
+            if (typeof result === 'object') {
+                console.log(chalk_1.default.greenBright('Success!'));
+                console.dir(result, { depth: null, colors: true });
+            }
+            else {
+                console.log(chalk_1.default.greenBright(result));
+            }
+        }
+        catch (err) {
+            const error = err;
+            console.error(chalk_1.default.redBright('Task failed:'), error.message || error);
+            if (error && typeof error === 'object' && 'stack' in error && error.stack) {
+                console.error(chalk_1.default.gray(error.stack));
+            }
+            process.exit(1);
+        }
+    });
+});
+program.parse(process.argv);

package/dist/cli/init.d.ts

@@ -0,0 +1,2 @@
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAIA,wBAAsB,OAAO,kBAoF5B"}

package/dist/cli/init.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+async function runInit() {
+    console.log('Welcome to mobilestacks project initialization!');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Project name:',
+            default: path_1.default.basename(process.cwd()),
+        },
+        {
+            type: 'input',
+            name: 'mainnetUrl',
+            message: 'Stacks mainnet node URL:',
+            default: 'https://api.mainnet.hiro.so',
+        },
+        {
+            type: 'input',
+            name: 'testnetUrl',
+            message: 'Stacks testnet node URL:',
+            default: 'https://api.testnet.hiro.so',
+        },
+        {
+            type: 'input',
+            name: 'derivationPath',
+            message: "Derivation path (default: m/44'/5757'/0'/0/0):",
+            default: "m/44'/5757'/0'/0/0",
+        },
+    ]);
+    // ── Config file: references env vars, never embeds secrets ──
+    const config = `import 'dotenv/config';
+
+export default {
+  networks: {
+    mainnet: { url: process.env.STACKS_MAINNET_URL || ${JSON.stringify(answers.mainnetUrl)}, name: 'mainnet' },
+    testnet: { url: process.env.STACKS_TESTNET_URL || ${JSON.stringify(answers.testnetUrl)}, name: 'testnet' },
+  },
+  defaultNetwork: 'testnet',
+  wallet: {
+    // Secrets are read from environment variables — never hard-code them here.
+    privateKey: process.env.MOBILESTACKS_PRIVATE_KEY || '',
+    seedPhrase: process.env.MOBILESTACKS_SEED_PHRASE || '',
+    derivationPath: ${JSON.stringify(answers.derivationPath)},
+  },
+};
+`;
+    fs_1.default.writeFileSync(path_1.default.join(process.cwd(), 'mobilestacks.config.ts'), config);
+    // ── .env file (if it doesn't exist yet) ──
+    const envPath = path_1.default.join(process.cwd(), '.env');
+    if (!fs_1.default.existsSync(envPath)) {
+        const envContent = `# Mobilestacks secrets — NEVER commit this file!\nMOBILESTACKS_PRIVATE_KEY=\nMOBILESTACKS_SEED_PHRASE=\nSTACKS_MAINNET_URL=${answers.mainnetUrl}\nSTACKS_TESTNET_URL=${answers.testnetUrl}\n`;
+        fs_1.default.writeFileSync(envPath, envContent, { mode: 0o600 }); // owner-only permissions
+    }
+    // ── Scaffold example contract ──
+    const contractsDir = path_1.default.join(process.cwd(), 'contracts');
+    if (!fs_1.default.existsSync(contractsDir))
+        fs_1.default.mkdirSync(contractsDir);
+    fs_1.default.writeFileSync(path_1.default.join(contractsDir, 'sample-contract.clar'), '(define-public (hello-world)\n  (ok "Hello, Stacks!"))\n');
+    // ── Scaffold example user task ──
+    const tasksDir = path_1.default.join(process.cwd(), 'src', 'tasks');
+    if (!fs_1.default.existsSync(tasksDir))
+        fs_1.default.mkdirSync(tasksDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(tasksDir, 'example-task.ts'), "import { task } from 'mobilestacks';\n\ntask('example', 'An example user task for onboarding')\n  .addParam('name', 'Your name', { type: 'string', required: false, defaultValue: 'World' })\n  .setAction(async (args: Record<string, string>) => {\n    return `Hello, ${args.name}! Welcome to mobilestacks.`;\n  });\n");
+    // ── Security notice ──
+    console.log('\n✅ Created:');
+    console.log('   • mobilestacks.config.ts  (reads secrets from env vars)');
+    console.log('   • .env                    (store your secrets here)');
+    console.log('   • contracts/sample-contract.clar');
+    console.log('   • src/tasks/example-task.ts');
+    console.log('\n⚠️  SECURITY WARNING:');
+    console.log('   Your wallet secrets belong in the .env file, NOT in source code.');
+    console.log('   • .env is already listed in .gitignore — never remove that entry.');
+    console.log('   • Set MOBILESTACKS_PRIVATE_KEY or MOBILESTACKS_SEED_PHRASE in .env');
+    console.log('   • See .env.example for the full list of supported variables.\n');
+}

package/dist/config/config-loading.d.ts

@@ -0,0 +1,3 @@
+import { MobilestacksConfig } from '../types/config';
+export declare function loadConfig(configPath?: string, cliOverrides?: Record<string, unknown>): MobilestacksConfig;
+//# sourceMappingURL=config-loading.d.ts.map

package/dist/config/config-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loading.d.ts","sourceRoot":"","sources":["../../src/config/config-loading.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK/E,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,kBAAkB,CAyB9G"}

package/dist/config/config-loading.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const config_1 = require("../types/config");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const env_1 = require("../core/env");
+function loadConfig(configPath, cliOverrides = {}) {
+    const configFile = configPath || path_1.default.resolve(process.cwd(), 'mobilestacks.config.ts');
+    if (!fs_1.default.existsSync(configFile)) {
+        throw new Error(`Config file not found: ${configFile}`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    require('ts-node').register();
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const userConfig = require(configFile);
+    let config = userConfig.default || userConfig;
+    // .env override
+    if (env_1.env.privateKey)
+        config.wallet.privateKey = env_1.env.privateKey;
+    if (env_1.env.mainnetUrl)
+        config.networks.mainnet.url = env_1.env.mainnetUrl;
+    if (env_1.env.testnetUrl)
+        config.networks.testnet.url = env_1.env.testnetUrl;
+    // CLI overrides
+    config = { ...config, ...cliOverrides };
+    const parsed = config_1.MobilestacksConfigSchema.safeParse(config);
+    if (!parsed.success) {
+        throw new Error('Invalid mobilestacks.config.ts: ' + JSON.stringify(parsed.error.format(), null, 2));
+    }
+    return parsed.data;
+}

package/dist/core/dsl.d.ts

@@ -0,0 +1,30 @@
+import { TaskDefinition, TaskParamType } from './tasks-definitions';
+import { ZodSchema } from 'zod';
+import { RuntimeEnvironment } from './runtime-environment';
+import { extendEnvironment } from './extender';
+declare function task(name: string, description: string): {
+    addParam(paramName: string, paramDesc: string, options?: {
+        type?: TaskParamType;
+        required?: boolean;
+        defaultValue?: unknown;
+        schema?: ZodSchema;
+    }): /*elided*/ any;
+    setAction(action: (args: Record<string, unknown>, env: RuntimeEnvironment) => Promise<unknown>): TaskDefinition;
+};
+declare function subtask(name: string, description: string, parentTaskName?: string): {
+    addParam(paramName: string, paramDesc: string, options?: {
+        type?: TaskParamType;
+        required?: boolean;
+        defaultValue?: unknown;
+        schema?: ZodSchema;
+    }): /*elided*/ any;
+    setAction(action: (args: Record<string, unknown>, env: RuntimeEnvironment) => Promise<unknown>): TaskDefinition;
+};
+export type WorkflowStep = {
+    taskName: string;
+    args?: Record<string, unknown>;
+};
+export type Workflow = WorkflowStep[];
+export declare function runWorkflow(workflow: Workflow, env: RuntimeEnvironment): Promise<void>;
+export { task, subtask, extendEnvironment };
+//# sourceMappingURL=dsl.d.ts.map

package/dist/core/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../src/core/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,cAAc,EAAa,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;wBAI9B,MAAM,aACN,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE;sBAYlF,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC;EAuBjG;AAED,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;wBAvC1D,MAAM,aACN,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE;sBAYlF,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC;EAkCjG;AAGD,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEtC,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,kBAAkB,iBAO5E;AAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/core/dsl.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extendEnvironment = void 0;
+exports.runWorkflow = runWorkflow;
+exports.task = task;
+exports.subtask = subtask;
+const tasks_definitions_1 = require("./tasks-definitions");
+const extender_1 = require("./extender");
+Object.defineProperty(exports, "extendEnvironment", { enumerable: true, get: function () { return extender_1.extendEnvironment; } });
+function task(name, description) {
+    const params = [];
+    return {
+        addParam(paramName, paramDesc, options) {
+            params.push({
+                name: paramName,
+                description: paramDesc,
+                type: options?.type || 'string',
+                required: options?.required !== false, // default true
+                defaultValue: options?.defaultValue,
+                schema: options?.schema,
+            });
+            return this;
+        },
+        setAction(action) {
+            const def = {
+                name,
+                description,
+                params,
+                action: async (args, env) => {
+                    // Validate args against schemas if present
+                    for (const param of params) {
+                        if (param.schema && args[param.name] !== undefined) {
+                            try {
+                                param.schema.parse(args[param.name]);
+                            }
+                            catch (error) {
+                                throw new Error(`Invalid value for parameter '${param.name}': ${error}`);
+                            }
+                        }
+                    }
+                    return action(args, env);
+                },
+            };
+            tasks_definitions_1.TaskDefinitions.getInstance().addTask(def);
+            return def;
+        },
+    };
+}
+function subtask(name, description, parentTaskName) {
+    // Register as a subtask with a parent if provided
+    const sub = task(name, description);
+    if (parentTaskName) {
+        // Attach parent info for future use (e.g., dependency graph, CLI grouping)
+        const def = tasks_definitions_1.TaskDefinitions.getInstance().getTask(name);
+        if (def)
+            def.parent = parentTaskName;
+    }
+    return sub;
+}
+async function runWorkflow(workflow, env) {
+    for (const step of workflow) {
+        const def = tasks_definitions_1.TaskDefinitions.getInstance().getTask(step.taskName);
+        if (!def)
+            throw new Error(`Task not found: ${step.taskName}`);
+        // eslint-disable-next-line no-await-in-loop
+        await def.action(step.args || {}, env);
+    }
+}

package/dist/core/dsl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dsl.test.d.ts.map

package/dist/core/dsl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.test.d.ts","sourceRoot":"","sources":["../../src/core/dsl.test.ts"],"names":[],"mappings":""}

package/dist/core/dsl.test.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const dsl_1 = require("./dsl");
+const tasks_definitions_1 = require("./tasks-definitions");
+const zod_1 = require("zod");
+const extender_1 = require("./extender");
+(0, vitest_1.describe)('DSL', () => {
+    (0, vitest_1.beforeEach)(() => {
+        // Clear tasks before each test
+        tasks_definitions_1.TaskDefinitions.getInstance()._tasks = [];
+    });
+    (0, vitest_1.it)('should register a task with generic parameters', () => {
+        (0, dsl_1.task)('test-task', 'A test task')
+            .addParam('p1', 'param 1')
+            .setAction(async () => { return 'done'; });
+        const def = tasks_definitions_1.TaskDefinitions.getInstance().getTask('test-task');
+        (0, vitest_1.expect)(def).toBeDefined();
+        (0, vitest_1.expect)(def?.name).toBe('test-task');
+        (0, vitest_1.expect)(def?.params.length).toBe(1);
+    });
+    (0, vitest_1.it)('should validate Zod schema', async () => {
+        (0, dsl_1.task)('zod-task', 'Task with validation')
+            .addParam('age', 'Age param', { schema: zod_1.z.number().min(18) })
+            .setAction(async (args) => {
+            return args.age;
+        });
+        const def = tasks_definitions_1.TaskDefinitions.getInstance().getTask('zod-task');
+        (0, vitest_1.expect)(def).toBeDefined();
+        // Mock environment
+        const env = {};
+        // Valid call
+        const result = await def?.action({ age: 20 }, env);
+        (0, vitest_1.expect)(result).toBe(20);
+        // Invalid call
+        await (0, vitest_1.expect)(def?.action({ age: 10 }, env)).rejects.toThrow('Invalid value for parameter \'age\'');
+    });
+    (0, vitest_1.it)('should support environment extensions', () => {
+        // Clear extensions
+        extender_1.Extender.getInstance()._extensions = [];
+        (0, extender_1.extendEnvironment)((env) => {
+            env['foo'] = 'bar';
+        });
+        const extensions = extender_1.Extender.getInstance().getExtensions();
+        (0, vitest_1.expect)(extensions.length).toBe(1);
+        const mockEnv = {};
+        extensions[0](mockEnv);
+        (0, vitest_1.expect)(mockEnv['foo']).toBe('bar');
+    });
+});

package/dist/core/env.d.ts

@@ -0,0 +1,6 @@
+export declare const env: {
+    privateKey: string | undefined;
+    mainnetUrl: string | undefined;
+    testnetUrl: string | undefined;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,GAAG;;;;CAIf,CAAC"}

package/dist/core/env.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.env = void 0;
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+exports.env = {
+    privateKey: process.env.STACKS_PRIVATE_KEY,
+    mainnetUrl: process.env.STACKS_MAINNET_URL,
+    testnetUrl: process.env.STACKS_TESTNET_URL,
+};

package/dist/core/extender.d.ts

@@ -0,0 +1,12 @@
+import { RuntimeEnvironment } from './runtime-environment';
+export type ExtensionFunc = (env: RuntimeEnvironment) => void;
+export declare class Extender {
+    private static _instance;
+    private _extensions;
+    private constructor();
+    static getInstance(): Extender;
+    addExtension(func: ExtensionFunc): void;
+    getExtensions(): ExtensionFunc[];
+}
+export declare function extendEnvironment(func: ExtensionFunc): void;
+//# sourceMappingURL=extender.d.ts.map

package/dist/core/extender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extender.d.ts","sourceRoot":"","sources":["../../src/core/extender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAE9D,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAW;IACnC,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO;WAEO,WAAW,IAAI,QAAQ;IAO9B,YAAY,CAAC,IAAI,EAAE,aAAa;IAIhC,aAAa,IAAI,aAAa,EAAE;CAGxC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,QAEpD"}

package/dist/core/extender.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Extender = void 0;
+exports.extendEnvironment = extendEnvironment;
+class Extender {
+    constructor() {
+        this._extensions = [];
+    }
+    static getInstance() {
+        if (!Extender._instance) {
+            Extender._instance = new Extender();
+        }
+        return Extender._instance;
+    }
+    addExtension(func) {
+        this._extensions.push(func);
+    }
+    getExtensions() {
+        return this._extensions;
+    }
+}
+exports.Extender = Extender;
+function extendEnvironment(func) {
+    Extender.getInstance().addExtension(func);
+}

package/dist/core/runtime-environment.d.ts

@@ -0,0 +1,16 @@
+import 'dotenv/config';
+import { MobilestacksConfig } from '../types/config';
+import { StacksNetwork } from '@stacks/network';
+export declare class RuntimeEnvironment {
+    config: MobilestacksConfig;
+    network: StacksNetwork;
+    wallet: {
+        privateKey: string;
+        address: string;
+        accountIndex?: number;
+    };
+    stacks: Record<string, unknown>;
+    [key: string]: unknown;
+    constructor(config: MobilestacksConfig);
+}
+//# sourceMappingURL=runtime-environment.d.ts.map

package/dist/core/runtime-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-environment.d.ts","sourceRoot":"","sources":["../../src/core/runtime-environment.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAiB,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAG/D,qBAAa,kBAAkB;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;gBAEX,MAAM,EAAE,kBAAkB;CAkEvC"}

package/dist/core/runtime-environment.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuntimeEnvironment = void 0;
+require("dotenv/config");
+const transactions_1 = require("@stacks/transactions");
+const wallet_sdk_1 = require("@stacks/wallet-sdk");
+const network_1 = require("@stacks/network");
+const extender_1 = require("./extender");
+class RuntimeEnvironment {
+    constructor(config) {
+        this.config = config;
+        const networkName = config.defaultNetwork;
+        const networkConfig = config.networks[networkName];
+        if (!networkConfig) {
+            throw new Error(`Network config not found for: ${networkName}`);
+        }
+        // Instantiate proper StacksNetwork
+        if (networkName === 'mainnet' || networkName === 'testnet') {
+            this.network = (0, network_1.createNetwork)({
+                network: networkName,
+                client: { baseUrl: networkConfig.url }
+            });
+        }
+        else {
+            // Default to testnet structure for custom networks
+            this.network = (0, network_1.createNetwork)({
+                network: 'testnet',
+                client: { baseUrl: networkConfig.url }
+            });
+        }
+        // ── Resolve wallet secrets (env vars take priority over config) ──
+        const privateKey = process.env.MOBILESTACKS_PRIVATE_KEY ||
+            process.env.STACKS_PRIVATE_KEY ||
+            config.wallet.privateKey ||
+            '';
+        const seedPhrase = process.env.MOBILESTACKS_SEED_PHRASE ||
+            process.env.STACKS_SEED_PHRASE ||
+            config.wallet.seedPhrase ||
+            '';
+        if (privateKey) {
+            const address = (0, transactions_1.getAddressFromPrivateKey)(privateKey, networkName === 'mainnet' ? 'mainnet' : 'testnet');
+            this.wallet = { privateKey, address };
+        }
+        else if (seedPhrase) {
+            const derivPath = config.wallet.derivationPath || "m/44'/5757'/0'/0/0";
+            (0, wallet_sdk_1.generateWallet)({ secretKey: seedPhrase, password: '' }).then(wallet => {
+                const index = parseInt(derivPath.split('/').pop() || '0', 10);
+                const account = wallet.accounts[index] || wallet.accounts[0];
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { getStxAddress } = require('@stacks/wallet-sdk/dist/models/account');
+                const address = getStxAddress(account, this.network.transactionVersion);
+                this.wallet = {
+                    privateKey: account.stxPrivateKey,
+                    address,
+                    accountIndex: account.index,
+                };
+            }).catch(() => {
+                throw new Error('Failed to generate wallet from seed phrase');
+            });
+        }
+        else {
+            // No secrets anywhere — warn but don't crash (devnet may not need a wallet)
+            console.warn('⚠️  No wallet secret found. Set MOBILESTACKS_PRIVATE_KEY or MOBILESTACKS_SEED_PHRASE in your .env file.');
+        }
+        this.stacks = {};
+        // Apply extensions
+        for (const extension of extender_1.Extender.getInstance().getExtensions()) {
+            extension(this);
+        }
+    }
+}
+exports.RuntimeEnvironment = RuntimeEnvironment;

package/dist/core/simnet.d.ts

@@ -0,0 +1,17 @@
+import { initSimnet } from '@hirosystems/clarinet-sdk';
+import { ClarityValue } from '@stacks/transactions';
+type SimnetInstance = Awaited<ReturnType<typeof initSimnet>>;
+export declare class Simnet {
+    private static _instance;
+    simnet: SimnetInstance;
+    accounts: Map<string, string>;
+    private constructor();
+    static init(): Promise<Simnet>;
+    getDeployer(): string;
+    getAccount(name: string): string;
+    callPublic(contract: string, func: string, args: ClarityValue[], sender: string): import("@hirosystems/clarinet-sdk").ParsedTransactionResult;
+    callReadOnly(contract: string, func: string, args: ClarityValue[], sender: string): import("@hirosystems/clarinet-sdk").ParsedTransactionResult;
+    mineBlock(txs: Parameters<SimnetInstance['mineBlock']>[0]): Promise<import("@hirosystems/clarinet-sdk").ParsedTransactionResult[]>;
+}
+export {};
+//# sourceMappingURL=simnet.d.ts.map

package/dist/core/simnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simnet.d.ts","sourceRoot":"","sources":["../../src/core/simnet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAE7D,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAS;IAC1B,MAAM,EAAG,cAAc,CAAC;IACxB,QAAQ,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,OAAO;WAEa,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBpC,WAAW,IAAI,MAAM;IAMrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMhC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM;IAI/E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM;IAI3E,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAGvE"}

package/dist/core/simnet.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Simnet = void 0;
+const clarinet_sdk_1 = require("@hirosystems/clarinet-sdk");
+class Simnet {
+    constructor() { }
+    static async init() {
+        if (!Simnet._instance) {
+            Simnet._instance = new Simnet();
+            // Initialize SDK - auto-detects Clarinet.toml from CWD
+            try {
+                console.log('Initializing Simnet...');
+                Simnet._instance.simnet = await (0, clarinet_sdk_1.initSimnet)();
+                // Get accounts
+                Simnet._instance.accounts = Simnet._instance.simnet.getAccounts();
+            }
+            catch (error) {
+                console.error('Failed to initialize Simnet:', error);
+                throw error;
+            }
+        }
+        return Simnet._instance;
+    }
+    getDeployer() {
+        const deployer = this.accounts.get('deployer');
+        if (!deployer)
+            throw new Error('Deployer account not found');
+        return deployer;
+    }
+    getAccount(name) {
+        const acc = this.accounts.get(name);
+        if (!acc)
+            throw new Error(`Account ${name} not found`);
+        return acc;
+    }
+    callPublic(contract, func, args, sender) {
+        return this.simnet.callPublicFn(contract, func, args, sender);
+    }
+    callReadOnly(contract, func, args, sender) {
+        return this.simnet.callReadOnlyFn(contract, func, args, sender);
+    }
+    async mineBlock(txs) {
+        return this.simnet.mineBlock(txs);
+    }
+}
+exports.Simnet = Simnet;