@mimicprotocol/cli 0.0.1-rc.35 → 0.0.1-rc.37

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mimicprotocol/cli
 
+## 0.0.1-rc.37
+
+### Patch Changes
+
+- ed2d252: Refactor credentials commands
+- 94ef728: add custom storage
+- 7d2279d: Refactor codegen, compile, build, deploy and test commands and their parameters
+
+## 0.0.1-rc.36
+
+### Patch Changes
+
+- 6a4fb70: rename to use functions
+
 ## 0.0.1-rc.35
 
 ### Patch Changes

package/README.md

@@ -27,12 +27,12 @@
 
 The `mimic` CLI is a command-line interface to:
 
-- Initialize a Mimic-compatible task project
-- Generate types from your task manifest and ABIs
-- Compile your AssemblyScript tasks to WebAssembly
-- Test your tasks
-- Deploy compiled tasks to IPFS and the Mimic Registry
-- Link tasks to a project in the Mimic explorer
+- Initialize a Mimic-compatible function project
+- Generate types from your function manifest and ABIs
+- Compile your AssemblyScript functions to WebAssembly
+- Test your functions
+- Deploy compiled functions to IPFS and the Mimic Registry
+- Link functions to a project in the Mimic explorer
 
 ## Setup
 
@@ -64,15 +64,15 @@ COMMANDS
   logout   Remove stored credentials for a profile
   profiles List all configured authentication profiles
   codegen  Generates typed interfaces for declared inputs and ABIs from your manifest.yaml file
-  compile  Compiles task
-  test     Tests your tasks
-  deploy   Uploads your compiled task artifacts to IPFS and registers it into the Mimic Registry
+  compile  Compiles the function
+  test     Tests your functions
+  deploy   Uploads your compiled function artifacts to IPFS and registers it into the Mimic Registry
   init     Initializes a new Mimic-compatible project structure in the specified directory
 ```
 
 ### Authentication
 
-Before deploying tasks, you need to authenticate with your Mimic API key:
+Before deploying functions, you need to authenticate with your Mimic API key:
 
 ```bash
 # Interactive login (recommended)

package/dist/commands/authenticate.js

@@ -1,46 +1,94 @@
 "use strict";
+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 core_1 = require("@oclif/core");
+const fs = __importStar(require("fs"));
 const CredentialsManager_1 = require("../lib/CredentialsManager");
 const log_1 = __importDefault(require("../log"));
 class Authenticate extends core_1.Command {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     run() {
         throw new Error('Method not implemented.');
     }
-    authenticate(flags) {
-        let apiKey = flags['api-key'];
-        if (!apiKey) {
-            try {
-                const credentials = CredentialsManager_1.CredentialsManager.getDefault().getCredentials(flags.profile);
-                apiKey = credentials.apiKey;
+    static authenticate(cmd, flags) {
+        const apiKey = flags['api-key'];
+        const profileName = flags.profile || CredentialsManager_1.CredentialsManager.getDefaultProfileName();
+        const credentialsManager = CredentialsManager_1.CredentialsManager.getDefault();
+        if (apiKey)
+            return { apiKey };
+        try {
+            const credentialsDir = credentialsManager.getBaseDir();
+            const credentialsPath = credentialsManager.getCredentialsPath();
+            if (!fs.existsSync(credentialsDir)) {
+                throw new Error(`No credentials directory found at ${credentialsDir}. Run 'mimic login' to authenticate.`);
+            }
+            if (!fs.existsSync(credentialsPath)) {
+                throw new Error(`No credentials file found. Run 'mimic login' to authenticate.`);
+            }
+            const profiles = credentialsManager.readCredentials();
+            if (!profiles[profileName]) {
+                const availableProfiles = Object.keys(profiles);
+                const suggestion = availableProfiles.length > 0
+                    ? `Available profiles: ${availableProfiles.join(', ')}`
+                    : `No profiles found. Run 'mimic login' to create one.`;
+                throw new Error(`Profile '${profileName}' not found. ${suggestion}`);
             }
-            catch (error) {
-                if (error instanceof Error) {
-                    this.error(error.message, {
-                        code: 'AuthenticationRequired',
-                        suggestions: [
-                            `Run ${log_1.default.highlightText('mimic login')} to authenticate`,
-                            `Run ${log_1.default.highlightText(`mimic login --profile ${flags.profile ?? '<profile>'}`)} to create this profile`,
-                            `Or use ${log_1.default.highlightText('--api-key')} flag to provide API key directly`,
-                        ].filter(Boolean),
-                    });
-                }
-                throw error;
+            const credentials = profiles[profileName];
+            if (!credentials.apiKey || credentials.apiKey.trim() === '') {
+                throw new Error(`Profile '${profileName}' has no API key. Run 'mimic login --profile ${profileName}' to update credentials.`);
+            }
+            return { apiKey: credentials.apiKey };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                cmd.error(`Authentication required: ${error.message}`, {
+                    code: 'AuthenticationRequired',
+                    suggestions: [
+                        `Run ${log_1.default.highlightText('mimic login')} to authenticate`,
+                        `Run ${log_1.default.highlightText(`mimic login --profile ${flags.profile ?? '<profile>'}`)} to create this profile`,
+                        `Or use ${log_1.default.highlightText('--api-key')} flag to provide API key directly`,
+                    ].filter(Boolean),
+                });
             }
+            throw error;
         }
-        return { apiKey };
     }
 }
-Authenticate.description = 'Authenticate with Mimic by storing your API key locally';
-Authenticate.examples = [
-    '<%= config.bin %> <%= command.id %>',
-    '<%= config.bin %> <%= command.id %> --profile staging',
-    '<%= config.bin %> <%= command.id %> --profile production --api-key YOUR_API_KEY',
-];
+Authenticate.hidden = true;
 Authenticate.flags = {
     profile: core_1.Flags.string({
         char: 'p',

package/dist/commands/build.js

@@ -6,31 +6,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const codegen_1 = __importDefault(require("./codegen"));
 const compile_1 = __importDefault(require("./compile"));
+const functions_1 = __importDefault(require("./functions"));
 class Build extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Build);
-        const { manifest, task, output, types, clean } = flags;
-        const codegenArgs = ['--manifest', manifest, '--output', types];
-        if (clean)
-            codegenArgs.push('--clean');
-        await codegen_1.default.run(codegenArgs);
-        const compileArgs = ['--task', task, '--manifest', manifest, '--output', output];
-        await compile_1.default.run(compileArgs);
+        await functions_1.default.runFunctions(this, flags, Build.build, 'build');
+    }
+    static async build(cmd, flags) {
+        await codegen_1.default.codegen(cmd, flags);
+        await compile_1.default.compile(cmd, flags);
     }
 }
-Build.description = 'Runs code generation and then compiles the task';
+Build.description = 'Runs code generation and then compiles the function';
 Build.examples = [
-    '<%= config.bin %> <%= command.id %> --manifest ./manifest.yaml --task src/task.ts --output ./build --types ./src/types',
+    '<%= config.bin %> <%= command.id %> --manifest ./manifest.yaml --function src/function.ts --build-directory ./build --types-directory ./src/types',
 ];
 Build.flags = {
-    manifest: core_1.Flags.string({ char: 'm', description: 'manifest to use', default: 'manifest.yaml' }),
-    task: core_1.Flags.string({ char: 't', description: 'task to compile', default: 'src/task.ts' }),
-    output: core_1.Flags.string({ char: 'o', description: 'output directory for build artifacts', default: './build' }),
-    types: core_1.Flags.string({ char: 'y', description: 'output directory for generated types', default: './src/types' }),
-    clean: core_1.Flags.boolean({
-        char: 'c',
-        description: 'remove existing generated types before generating new files',
-        default: false,
-    }),
+    ...functions_1.default.flags,
+    ...codegen_1.default.flags,
+    ...compile_1.default.flags,
 };
 exports.default = Build;

package/dist/commands/codegen.js

@@ -42,42 +42,70 @@ const fs = __importStar(require("fs"));
 const path_1 = require("path");
 const lib_1 = require("../lib");
 const log_1 = __importDefault(require("../log"));
+const functions_1 = __importStar(require("./functions"));
 class Codegen extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Codegen);
-        const { manifest: manifestDir, output: outputDir, clean } = flags;
-        const manifest = lib_1.ManifestHandler.load(this, manifestDir);
+        await functions_1.default.runFunctions(this, flags, Codegen.codegen, 'code generation');
+    }
+    static async codegen(cmd, flags) {
+        const { manifest: manifestDir, 'types-directory': typesDir, clean } = flags;
+        const manifest = lib_1.ManifestHandler.load(cmd, manifestDir);
         if (clean) {
             const shouldDelete = await (0, prompts_1.confirm)({
-                message: `Are you sure you want to ${log_1.default.warnText('delete')} all the contents in ${log_1.default.highlightText(outputDir)}. This action is ${log_1.default.warnText('irreversible')}`,
+                message: `Are you sure you want to ${log_1.default.warnText('delete')} all the contents in ${log_1.default.highlightText(typesDir)}. This action is ${log_1.default.warnText('irreversible')}`,
                 default: false,
             });
             if (!shouldDelete) {
                 console.log('You can remove the --clean flag from your command');
                 console.log('Stopping initialization...');
-                this.exit(0);
+                cmd.exit(0);
             }
-            log_1.default.startAction(`Deleting contents of ${outputDir}`);
-            if (fs.existsSync(outputDir))
-                fs.rmSync(outputDir, { recursive: true, force: true });
+            log_1.default.startAction(`Deleting contents of ${typesDir}`);
+            if (fs.existsSync(typesDir))
+                fs.rmSync(typesDir, { recursive: true, force: true });
         }
         log_1.default.startAction('Generating code');
         if (Object.keys(manifest.inputs).length == 0 && Object.keys(manifest.abis).length == 0) {
             log_1.default.stopAction();
             return;
         }
-        if (!fs.existsSync(outputDir))
-            fs.mkdirSync(outputDir, { recursive: true });
-        generateAbisCode(manifest, outputDir, manifestDir);
-        generateInputsCode(manifest, outputDir);
+        if (!fs.existsSync(typesDir))
+            fs.mkdirSync(typesDir, { recursive: true });
+        Codegen.generateAbisCode(manifest, typesDir, manifestDir);
+        Codegen.generateInputsCode(manifest, typesDir);
         log_1.default.stopAction();
     }
+    static generateAbisCode(manifest, typesDir, manifestDir) {
+        for (const [contractName, path] of Object.entries(manifest.abis)) {
+            const abi = JSON.parse(fs.readFileSync((0, path_1.join)(manifestDir, '../', path), 'utf-8'));
+            const abiInterface = lib_1.AbisInterfaceGenerator.generate(abi, contractName);
+            if (abiInterface.length > 0)
+                fs.writeFileSync(`${typesDir}/${contractName}.ts`, abiInterface);
+        }
+    }
+    static generateInputsCode(manifest, typesDir) {
+        const inputsInterface = lib_1.InputsInterfaceGenerator.generate(manifest.inputs);
+        if (inputsInterface.length > 0)
+            fs.writeFileSync(`${typesDir}/index.ts`, inputsInterface);
+    }
 }
 Codegen.description = 'Generates typed interfaces for declared inputs and ABIs from your manifest.yaml file';
-Codegen.examples = ['<%= config.bin %> <%= command.id %> --manifest ./manifest.yaml --output ./types'];
+Codegen.examples = [
+    '<%= config.bin %> <%= command.id %> --manifest ./manifest.yaml --types-directory ./types',
+];
 Codegen.flags = {
-    manifest: core_1.Flags.string({ char: 'm', description: 'Specify a custom manifest file path', default: 'manifest.yaml' }),
-    output: core_1.Flags.string({ char: 'o', description: 'Ouput directory for generated types', default: './src/types' }),
+    ...functions_1.default.flags,
+    manifest: core_1.Flags.string({
+        char: 'm',
+        description: 'Specify a custom manifest file path',
+        default: functions_1.DefaultFunctionConfig.manifest,
+    }),
+    'types-directory': core_1.Flags.string({
+        char: 't',
+        description: 'Output directory for generated types',
+        default: functions_1.DefaultFunctionConfig['types-directory'],
+    }),
     clean: core_1.Flags.boolean({
         char: 'c',
         description: 'Remove existing generated types before generating new files',
@@ -85,16 +113,3 @@ Codegen.flags = {
     }),
 };
 exports.default = Codegen;
-function generateAbisCode(manifest, outputDir, manifestDir) {
-    for (const [contractName, path] of Object.entries(manifest.abis)) {
-        const abi = JSON.parse(fs.readFileSync((0, path_1.join)(manifestDir, '../', path), 'utf-8'));
-        const abiInterface = lib_1.AbisInterfaceGenerator.generate(abi, contractName);
-        if (abiInterface.length > 0)
-            fs.writeFileSync(`${outputDir}/${contractName}.ts`, abiInterface);
-    }
-}
-function generateInputsCode(manifest, outputDir) {
-    const inputsInterface = lib_1.InputsInterfaceGenerator.generate(manifest.inputs);
-    if (inputsInterface.length > 0)
-        fs.writeFileSync(`${outputDir}/index.ts`, inputsInterface);
-}

package/dist/commands/compile.js

@@ -42,23 +42,26 @@ const path = __importStar(require("path"));
 const ManifestHandler_1 = __importDefault(require("../lib/ManifestHandler"));
 const packageManager_1 = require("../lib/packageManager");
 const log_1 = __importDefault(require("../log"));
+const functions_1 = __importStar(require("./functions"));
 class Compile extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Compile);
-        const { task: taskFile, output: outputDir, manifest: manifestDir } = flags;
-        const absTaskFile = path.resolve(taskFile);
-        const absOutputDir = path.resolve(outputDir);
-        if (!fs.existsSync(absOutputDir))
-            fs.mkdirSync(absOutputDir, { recursive: true });
+        await functions_1.default.runFunctions(this, flags, Compile.compile, 'compilation');
+    }
+    static async compile(cmd, { function: functionDir, 'build-directory': buildDir, manifest: manifestDir }) {
+        const absFunctionFile = path.resolve(functionDir);
+        const absBuildDir = path.resolve(buildDir);
+        if (!fs.existsSync(absBuildDir))
+            fs.mkdirSync(absBuildDir, { recursive: true });
         log_1.default.startAction('Verifying Manifest');
-        const manifest = ManifestHandler_1.default.load(this, manifestDir);
+        const manifest = ManifestHandler_1.default.load(cmd, manifestDir);
         log_1.default.startAction('Compiling');
         const ascArgs = [
-            absTaskFile,
+            absFunctionFile,
             '--target',
             'release',
             '--outFile',
-            path.join(absOutputDir, 'task.wasm'),
+            path.join(absBuildDir, 'function.wasm'),
             '--optimize',
             '--exportRuntime',
             '--transform',
@@ -66,22 +69,29 @@ class Compile extends core_1.Command {
         ];
         const result = (0, packageManager_1.execBinCommand)('asc', ascArgs, process.cwd());
         if (result.status !== 0) {
-            this.error('AssemblyScript compilation failed', {
+            cmd.error('AssemblyScript compilation failed', {
                 code: 'BuildError',
                 suggestions: ['Check the AssemblyScript file'],
             });
         }
         log_1.default.startAction('Saving files');
-        fs.writeFileSync(path.join(outputDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+        fs.writeFileSync(path.join(absBuildDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
         log_1.default.stopAction();
-        console.log(`Build complete! Artifacts in ${outputDir}/`);
+        console.log(`Build complete! Artifacts in ${absBuildDir}/`);
     }
 }
-Compile.description = 'Compiles task';
-Compile.examples = ['<%= config.bin %> <%= command.id %> --task src/task.ts --output ./output'];
+Compile.description = 'Compiles function';
+Compile.examples = [
+    '<%= config.bin %> <%= command.id %> --function src/function.ts --build-directory ./build',
+];
 Compile.flags = {
-    task: core_1.Flags.string({ char: 't', description: 'task to compile', default: 'src/task.ts' }),
-    manifest: core_1.Flags.string({ char: 'm', description: 'manifest to validate', default: 'manifest.yaml' }),
-    output: core_1.Flags.string({ char: 'o', description: 'output directory', default: './build' }),
+    ...functions_1.default.flags,
+    function: core_1.Flags.string({ char: 'f', description: 'Function to compile', default: functions_1.DefaultFunctionConfig.function }),
+    manifest: core_1.Flags.string({ char: 'm', description: 'Manifest to validate', default: functions_1.DefaultFunctionConfig.manifest }),
+    'build-directory': core_1.Flags.string({
+        char: 'b',
+        description: 'Output directory for compilation',
+        default: functions_1.DefaultFunctionConfig['build-directory'],
+    }),
 };
 exports.default = Compile;

package/dist/commands/deploy.js

@@ -42,53 +42,48 @@ const form_data_1 = __importDefault(require("form-data"));
 const fs = __importStar(require("fs"));
 const path_1 = require("path");
 const errors_1 = require("../errors");
-const packageManager_1 = require("../lib/packageManager");
 const log_1 = __importDefault(require("../log"));
 const authenticate_1 = __importDefault(require("./authenticate"));
+const build_1 = __importDefault(require("./build"));
+const functions_1 = __importDefault(require("./functions"));
 const MIMIC_REGISTRY_DEFAULT = 'https://api-protocol.mimic.fi';
-class Deploy extends authenticate_1.default {
+class Deploy extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Deploy);
-        const { input: inputDir, output: outputDir, 'skip-compile': skipCompile, url: registryUrl } = flags;
-        const fullInputDir = (0, path_1.resolve)(inputDir);
-        const fullOutputDir = (0, path_1.resolve)(outputDir);
-        let credentials = this.authenticate(flags);
-        if (!skipCompile) {
-            const codegen = (0, packageManager_1.execBinCommand)('mimic', ['codegen'], process.cwd());
-            if (codegen.status !== 0)
-                this.error('Code generation failed', { code: 'CodegenError', suggestions: ['Fix manifest and ABI files'] });
-            const compile = (0, packageManager_1.execBinCommand)('mimic', ['compile', '--output', fullInputDir], process.cwd());
-            if (compile.status !== 0)
-                this.error('Compilation failed', { code: 'BuildError', suggestions: ['Check the task source code'] });
-        }
+        await functions_1.default.runFunctions(this, flags, Deploy.deploy, 'deployment');
+    }
+    static async deploy(cmd, flags) {
+        const { 'build-directory': buildDir, 'skip-build': skipBuild, url: registryUrl } = flags;
+        const absBuildDir = (0, path_1.resolve)(buildDir);
+        let credentials = authenticate_1.default.authenticate(cmd, flags);
+        if (!skipBuild)
+            await build_1.default.build(cmd, flags);
         log_1.default.startAction('Validating');
-        if (!fs.existsSync(fullInputDir))
-            this.error(`Directory ${log_1.default.highlightText(fullInputDir)} does not exist`, {
+        if (!fs.existsSync(absBuildDir) && skipBuild)
+            cmd.error(`Directory ${log_1.default.highlightText(absBuildDir)} does not exist`, {
                 code: 'Directory Not Found',
-                suggestions: ['Use the --input flag to specify the correct path'],
+                suggestions: ['Use the --build-directory flag to specify the correct path'],
             });
-        const neededFiles = ['manifest.json', 'task.wasm'].map((file) => (0, path_1.join)(fullInputDir, file));
+        const neededFiles = ['manifest.json', 'function.wasm'].map((file) => (0, path_1.join)(absBuildDir, file));
         for (const file of neededFiles) {
             if (!fs.existsSync(file))
-                this.error(`Could not find ${file}`, {
+                cmd.error(`Could not find ${file}`, {
                     code: 'File Not Found',
                     suggestions: [`Use ${log_1.default.highlightText('mimic compile')} to generate the needed files`],
                 });
         }
         log_1.default.startAction('Uploading to Mimic Registry');
-        const CID = await this.uploadToRegistry(neededFiles, credentials, registryUrl);
+        const CID = await Deploy.uploadToRegistry(cmd, neededFiles, credentials, registryUrl);
         console.log(`IPFS CID: ${log_1.default.highlightText(CID)}`);
         log_1.default.stopAction();
-        if (!fs.existsSync(fullOutputDir))
-            fs.mkdirSync(fullOutputDir, { recursive: true });
-        fs.writeFileSync((0, path_1.join)(fullOutputDir, 'CID.json'), JSON.stringify({ CID }, null, 2));
-        console.log(`CID saved at ${log_1.default.highlightText(fullOutputDir)}`);
-        console.log(`Task deployed!`);
+        fs.writeFileSync((0, path_1.join)(absBuildDir, 'CID.json'), JSON.stringify({ CID }, null, 2));
+        console.log(`CID saved at ${log_1.default.highlightText(absBuildDir)}`);
+        console.log(`Function deployed!`);
     }
-    async uploadToRegistry(files, credentials, registryUrl) {
+    static async uploadToRegistry(cmd, files, credentials, registryUrl) {
         try {
-            const form = filesToForm(files);
-            const { data } = await axios_1.default.post(`${registryUrl}/tasks`, form, {
+            const form = this.filesToForm(files);
+            const { data } = await axios_1.default.post(`${registryUrl}/functions`, form, {
                 headers: {
                     'x-api-key': credentials.apiKey,
                     'Content-Type': `multipart/form-data; boundary=${form.getBoundary()}`,
@@ -97,43 +92,48 @@ class Deploy extends authenticate_1.default {
             return data.CID;
         }
         catch (err) {
-            this.handleError(err, 'Failed to upload to registry');
+            this.handleError(cmd, err, 'Failed to upload to registry');
         }
     }
-    handleError(err, message) {
+    static handleError(cmd, err, message) {
         if (!(err instanceof axios_1.AxiosError))
-            this.error(err);
+            cmd.error(err);
         const statusCode = err.response?.status;
         if (statusCode === 400) {
             const errMessage = err.response?.data?.content?.message || message;
-            this.error(errMessage, { code: 'Bad Request', suggestions: ['Review the uploaded files'] });
+            cmd.error(errMessage, { code: 'Bad Request', suggestions: ['Review the uploaded files'] });
         }
         if (statusCode === 401)
-            this.error(message, { code: 'Unauthorized', suggestions: ['Review your key'] });
+            cmd.error(message, { code: 'Unauthorized', suggestions: ['Review your key'] });
         if (statusCode === 403)
-            this.error(message, { code: 'Invalid api key', suggestions: ['Review your key'] });
-        this.error(`${message} - ${err.message}`, { code: `${statusCode} Error`, suggestions: errors_1.GENERIC_SUGGESTION });
+            cmd.error(message, { code: 'Invalid api key', suggestions: ['Review your key'] });
+        cmd.error(`${message} - ${err.message}`, { code: `${statusCode} Error`, suggestions: errors_1.GENERIC_SUGGESTION });
+    }
+    static filesToForm(files) {
+        return files.reduce((form, file) => {
+            const fileStream = fs.createReadStream(file);
+            const filename = file.split('/').pop();
+            form.append('file', fileStream, { filename });
+            return form;
+        }, new form_data_1.default());
     }
 }
-Deploy.description = 'Uploads your compiled task artifacts to IPFS and registers it into the Mimic Registry';
+Deploy.description = 'Uploads your compiled function artifacts to IPFS and registers it into the Mimic Registry';
 Deploy.examples = [
-    '<%= config.bin %> <%= command.id %> --input ./dist --output ./dist',
+    '<%= config.bin %> <%= command.id %> --build-directory ./build',
     '<%= config.bin %> <%= command.id %> --profile staging',
-    '<%= config.bin %> <%= command.id %> --api-key MY_KEY --input ./dist --output ./dist',
+    '<%= config.bin %> <%= command.id %> --api-key MY_KEY --build-directory ./build',
 ];
 Deploy.flags = {
+    ...functions_1.default.flags,
     ...authenticate_1.default.flags,
-    input: core_1.Flags.string({ char: 'i', description: 'Directory containing the compiled artifacts', default: './build' }),
-    output: core_1.Flags.string({ char: 'o', description: 'Output directory for deployment CID', default: './build' }),
+    ...build_1.default.flags,
+    'build-directory': core_1.Flags.string({
+        char: 'b',
+        description: 'Output directory for compilation, or input directory for deployment when --skip-build is used',
+        default: './build',
+    }),
     url: core_1.Flags.string({ char: 'u', description: `Mimic Registry base URL`, default: MIMIC_REGISTRY_DEFAULT }),
-    'skip-compile': core_1.Flags.boolean({ description: 'Skip codegen and compile steps before uploading', default: false }),
+    'skip-build': core_1.Flags.boolean({ description: 'Skip codegen and compile steps before uploading', default: false }),
 };
 exports.default = Deploy;
-const filesToForm = (files) => {
-    return files.reduce((form, file) => {
-        const fileStream = fs.createReadStream(file);
-        const filename = file.split('/').pop();
-        form.append('file', fileStream, { filename });
-        return form;
-    }, new form_data_1.default());
-};

package/dist/commands/functions.js

@@ -0,0 +1,141 @@
+"use strict";
+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 });
+exports.DefaultFunctionConfig = exports.MimicConfigSchema = exports.FunctionConfigSchema = void 0;
+const core_1 = require("@oclif/core");
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const zod_1 = require("zod");
+const log_1 = __importDefault(require("../log"));
+exports.FunctionConfigSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1, 'Function name is required'),
+    manifest: zod_1.z.string().min(1, 'Manifest path is required'),
+    function: zod_1.z.string().min(1, 'Function path is required'),
+    'build-directory': zod_1.z.string().min(1, 'Build directory is required'),
+    'types-directory': zod_1.z.string().min(1, 'Types directory is required'),
+});
+exports.MimicConfigSchema = zod_1.z.object({
+    functions: zod_1.z.array(exports.FunctionConfigSchema).min(1, 'At least one function is required'),
+});
+exports.DefaultFunctionConfig = {
+    name: '',
+    manifest: 'manifest.yaml',
+    function: 'src/function.ts',
+    'build-directory': './build',
+    'types-directory': './src/types',
+};
+const MIMIC_CONFIG_FILE = 'mimic.yaml';
+class Functions extends core_1.Command {
+    run() {
+        throw new Error('Method not implemented.');
+    }
+    static async runFunctions(cmd, flags, cmdLogic, cmdActions) {
+        const functions = Functions.filterFunctions(cmd, flags);
+        for (const func of functions) {
+            log_1.default.startAction(`\nStarting ${cmdActions} for function ${func.name ? func.name : func.function}`);
+            await cmdLogic(cmd, { ...flags, ...func });
+        }
+    }
+    static filterFunctions(cmd, flags) {
+        if (flags['no-config']) {
+            return [{ ...exports.DefaultFunctionConfig, ...flags }];
+        }
+        if (!fs.existsSync(flags['config-file'])) {
+            if (flags['config-file'] !== MIMIC_CONFIG_FILE) {
+                cmd.error(`Could not find ${flags['config-file']}`, { code: 'ConfigNotFound' });
+            }
+            // If doesn't exist return the default with the flags the user added
+            return [{ ...exports.DefaultFunctionConfig, ...flags }];
+        }
+        const fileContents = fs.readFileSync(flags['config-file'], 'utf8');
+        const rawConfig = yaml.load(fileContents);
+        if (!rawConfig || (typeof rawConfig === 'object' && Object.keys(rawConfig).length === 0)) {
+            cmd.error(`Invalid ${MIMIC_CONFIG_FILE} configuration: file is empty.`);
+        }
+        try {
+            let { functions } = exports.MimicConfigSchema.parse(rawConfig);
+            if (flags.include && flags.include.length > 0) {
+                Functions.checkMissingFunctions(cmd, functions, flags.include);
+                functions = functions.filter((fn) => flags.include.includes(fn.name));
+            }
+            if (flags.exclude && flags.exclude.length > 0) {
+                Functions.checkMissingFunctions(cmd, functions, flags.exclude);
+                functions = functions.filter((fn) => !flags.exclude.includes(fn.name));
+            }
+            return functions;
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const errors = error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join('\n');
+                cmd.error(`Invalid ${MIMIC_CONFIG_FILE} configuration:\n${errors}`, { code: 'InvalidConfig' });
+            }
+            throw error;
+        }
+    }
+    static checkMissingFunctions(cmd, functions, filteredFunctionNames) {
+        const functionNames = new Set(functions.map((fn) => fn.name));
+        const missingFunctions = filteredFunctionNames.filter((name) => !functionNames.has(name));
+        if (missingFunctions.length > 0) {
+            cmd.warn(`Functions not found in ${MIMIC_CONFIG_FILE}: ${missingFunctions.join(', ')}`);
+        }
+    }
+}
+Functions.hidden = true;
+Functions.flags = {
+    'config-file': core_1.Flags.string({
+        description: `Path to the ${MIMIC_CONFIG_FILE} file, this overrides other parameters like build-directory and function`,
+        default: MIMIC_CONFIG_FILE,
+    }),
+    'no-config': core_1.Flags.boolean({
+        description: `Do not read ${MIMIC_CONFIG_FILE}; use defaults and explicit flags instead`,
+        default: false,
+    }),
+    include: core_1.Flags.string({
+        description: `When ${MIMIC_CONFIG_FILE} exists, only run tasks with these names (space-separated)`,
+        multiple: true,
+        exclusive: ['exclude'],
+        char: 'i',
+    }),
+    exclude: core_1.Flags.string({
+        description: `When ${MIMIC_CONFIG_FILE} exists, exclude tasks with these names (space-separated)`,
+        multiple: true,
+        exclusive: ['include'],
+        char: 'e',
+    }),
+};
+exports.default = Functions;

package/dist/commands/init.js

@@ -46,32 +46,34 @@ const log_1 = __importDefault(require("../log"));
 class Init extends core_1.Command {
     async run() {
         const { args, flags } = await this.parse(Init);
-        const { directory } = args;
-        const { force } = flags;
-        const fullDirectory = path.resolve(directory);
-        if (force && fs.existsSync(fullDirectory) && fs.readdirSync(fullDirectory).length > 0) {
+        await Init.init(this, { ...flags, ...args });
+    }
+    static async init(cmd, flags) {
+        const { directory, force } = flags;
+        const absDir = path.resolve(directory);
+        if (force && fs.existsSync(absDir) && fs.readdirSync(absDir).length > 0) {
             const shouldDelete = process.env.NODE_ENV === 'test'
                 ? true
                 : await (0, prompts_1.confirm)({
-                    message: `Are you sure you want to ${log_1.default.warnText('delete')} all the contents in ${log_1.default.highlightText(fullDirectory)}. This action is ${log_1.default.warnText('irreversible')}`,
+                    message: `Are you sure you want to ${log_1.default.warnText('delete')} all the contents in ${log_1.default.highlightText(absDir)}. This action is ${log_1.default.warnText('irreversible')}`,
                     default: false,
                 });
             if (!shouldDelete) {
                 console.log('You can remove the --force flag from your command');
                 console.log('Stopping initialization...');
-                this.exit(0);
+                cmd.exit(0);
             }
-            log_1.default.startAction(`Deleting contents of ${fullDirectory}`);
+            log_1.default.startAction(`Deleting contents of ${absDir}`);
             // Delete files individually instead of removing the entire directory to preserve
             // the directory reference. This prevents issues when the directory is the current
             // working directory, as removing it would cause the reference to be lost.
-            for (const file of fs.readdirSync(fullDirectory)) {
-                fs.rmSync(path.join(fullDirectory, file), { recursive: true, force: true });
+            for (const file of fs.readdirSync(absDir)) {
+                fs.rmSync(path.join(absDir, file), { recursive: true, force: true });
             }
         }
         log_1.default.startAction('Creating files');
-        if (fs.existsSync(fullDirectory) && fs.readdirSync(fullDirectory).length > 0) {
-            this.error(`Directory ${log_1.default.highlightText(fullDirectory)} is not empty`, {
+        if (fs.existsSync(absDir) && fs.readdirSync(absDir).length > 0) {
+            cmd.error(`Directory ${log_1.default.highlightText(absDir)} is not empty`, {
                 code: 'DirectoryNotEmpty',
                 suggestions: [
                     'You can specify the directory as a positional argument',
@@ -79,32 +81,32 @@ class Init extends core_1.Command {
                 ],
             });
         }
-        if (!fs.existsSync(fullDirectory)) {
-            fs.mkdirSync(fullDirectory, { recursive: true });
+        if (!fs.existsSync(absDir)) {
+            fs.mkdirSync(absDir, { recursive: true });
         }
         try {
-            await (0, simple_git_1.default)().clone('https://github.com/mimic-protocol/init-template.git', fullDirectory);
-            const gitDir = path.join(fullDirectory, '.git');
+            await (0, simple_git_1.default)().clone('https://github.com/mimic-protocol/init-template.git', absDir);
+            const gitDir = path.join(absDir, '.git');
             if (fs.existsSync(gitDir))
                 fs.rmSync(gitDir, { recursive: true, force: true });
         }
         catch (error) {
-            this.error(`Failed to clone template repository. Details: ${error}`);
+            cmd.error(`Failed to clone template repository. Details: ${error}`);
         }
-        this.installDependencies(fullDirectory);
-        this.runCodegen(fullDirectory);
+        Init.installDependencies(absDir);
+        Init.runCodegen(absDir);
         log_1.default.stopAction();
         console.log('New project initialized!');
     }
-    installDependencies(fullDirectory) {
+    static installDependencies(absDir) {
         if (process.env.NODE_ENV === 'test')
             return;
-        (0, packageManager_1.installDependencies)(fullDirectory);
+        (0, packageManager_1.installDependencies)(absDir);
     }
-    runCodegen(fullDirectory) {
+    static runCodegen(absDir) {
         if (process.env.NODE_ENV === 'test')
             return;
-        (0, packageManager_1.execBinCommand)('mimic', ['codegen'], fullDirectory);
+        (0, packageManager_1.execBinCommand)('mimic', ['codegen'], absDir);
     }
 }
 Init.description = 'Initializes a new Mimic-compatible project structure in the specified directory';

package/dist/commands/login.js

@@ -8,9 +8,12 @@ const core_1 = require("@oclif/core");
 const CredentialsManager_1 = require("../lib/CredentialsManager");
 const log_1 = __importDefault(require("../log"));
 const authenticate_1 = __importDefault(require("./authenticate"));
-class Login extends authenticate_1.default {
+class Login extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Login);
+        await Login.login(this, flags);
+    }
+    static async login(cmd, flags) {
         const { profile: profileInput, 'api-key': apiKeyFlag } = flags;
         let apiKey;
         let profileName = profileInput;
@@ -47,14 +50,14 @@ class Login extends authenticate_1.default {
             catch (error) {
                 if (error instanceof Error && error.message.includes('User force closed')) {
                     console.log('\nLogin cancelled');
-                    this.exit(0);
+                    cmd.exit(0);
                 }
                 throw error;
             }
         }
-        this.saveAndConfirm(profileName || CredentialsManager_1.CredentialsManager.getDefaultProfileName(), apiKey, flags['force-login']);
+        Login.saveAndConfirm(cmd, profileName || CredentialsManager_1.CredentialsManager.getDefaultProfileName(), apiKey, flags['force-login']);
     }
-    async saveAndConfirm(profileName, apiKey, forceLogin) {
+    static async saveAndConfirm(cmd, profileName, apiKey, forceLogin) {
         try {
             const credentialsManager = CredentialsManager_1.CredentialsManager.getDefault();
             if (credentialsManager.profileExists(profileName) && !forceLogin) {
@@ -73,14 +76,14 @@ class Login extends authenticate_1.default {
             console.log(`✓ Credentials saved for profile ${log_1.default.highlightText(profileName)}`);
             console.log(`  Location: ${log_1.default.highlightText('~/.mimic/credentials')}`);
             console.log();
-            console.log(`You can now deploy tasks using: ${log_1.default.highlightText('mimic deploy')}`);
+            console.log(`You can now deploy functions using: ${log_1.default.highlightText('mimic deploy')}`);
             if (profileName !== CredentialsManager_1.CredentialsManager.getDefaultProfileName()) {
                 console.log(`Or with your profile: ${log_1.default.highlightText(`mimic deploy --profile ${profileName}`)}`);
             }
         }
         catch (error) {
             if (error instanceof Error)
-                this.error(`Failed to save credentials: ${error.message}`);
+                cmd.error(`Failed to save credentials: ${error.message}`);
             throw error;
         }
     }

package/dist/commands/logout.js

@@ -10,10 +10,13 @@ const log_1 = __importDefault(require("../log"));
 class Logout extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Logout);
+        await Logout.logout(this, flags);
+    }
+    static async logout(cmd, flags) {
         const { profile: profileName, force } = flags;
         const profiles = CredentialsManager_1.CredentialsManager.getDefault().getProfiles();
         if (!profiles.includes(profileName)) {
-            this.error(`Profile '${profileName}' does not exist`, {
+            cmd.error(`Profile '${profileName}' does not exist`, {
                 code: 'ProfileNotFound',
                 suggestions: profiles.length > 0
                     ? [`Available profiles: ${profiles.join(', ')}`]
@@ -27,7 +30,7 @@ class Logout extends core_1.Command {
             });
             if (!shouldRemove) {
                 console.log('Logout cancelled');
-                this.exit(0);
+                cmd.exit(0);
             }
         }
         log_1.default.startAction(`Removing credentials for profile ${profileName}`);

package/dist/commands/profiles.js

@@ -8,6 +8,9 @@ const CredentialsManager_1 = require("../lib/CredentialsManager");
 const log_1 = __importDefault(require("../log"));
 class Profiles extends core_1.Command {
     async run() {
+        await Profiles.profiles();
+    }
+    static async profiles() {
         const profiles = CredentialsManager_1.CredentialsManager.getDefault().getProfiles();
         if (profiles.length === 0) {
             console.log('No profiles found.');

package/dist/commands/test.js

@@ -32,32 +32,46 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const path = __importStar(require("path"));
 const packageManager_1 = require("../lib/packageManager");
+const build_1 = __importDefault(require("./build"));
+const functions_1 = __importDefault(require("./functions"));
 class Test extends core_1.Command {
     async run() {
         const { flags } = await this.parse(Test);
-        const { directory, 'skip-compile': skipCompile } = flags;
-        const baseDir = path.resolve(directory);
-        const testPath = path.join(baseDir, 'tests');
-        if (!skipCompile) {
-            const cg = (0, packageManager_1.execBinCommand)('mimic', ['codegen'], baseDir);
-            if (cg.status !== 0)
-                this.exit(cg.status ?? 1);
-            const cp = (0, packageManager_1.execBinCommand)('mimic', ['compile'], baseDir);
-            if (cp.status !== 0)
-                this.exit(cp.status ?? 1);
-        }
+        await Test.test(this, flags);
+    }
+    static async test(cmd, flags) {
+        const { directory, 'skip-build': skipBuild } = flags;
+        const baseDir = path.resolve('./');
+        const testPath = path.join(baseDir, directory);
+        if (!skipBuild)
+            await functions_1.default.runFunctions(cmd, flags, build_1.default.build, 'building');
         const result = (0, packageManager_1.execBinCommand)('tsx', ['./node_modules/mocha/bin/mocha.js', `${testPath}/**/*.spec.ts`], baseDir);
-        this.exit(result.status ?? 1);
+        cmd.exit(result.status ?? 1);
     }
 }
-Test.description = 'Runs task tests';
-Test.examples = ['<%= config.bin %> <%= command.id %> --directory ./'];
+Test.description = 'Runs function tests';
+Test.examples = ['<%= config.bin %> <%= command.id %> --directory ./tests'];
 Test.flags = {
-    directory: core_1.Flags.string({ char: 'd', description: 'task directory', default: './' }),
-    'skip-compile': core_1.Flags.boolean({ description: 'skip codegen and compile steps' }),
+    ...{
+        ...functions_1.default.flags,
+        include: {
+            ...functions_1.default.flags.include,
+            description: functions_1.default.flags.include.description + '. Only for building, it does not affect testing',
+        },
+        exclude: {
+            ...functions_1.default.flags.exclude,
+            description: functions_1.default.flags.exclude.description + '. Only for building, it does not affect testing',
+        },
+    },
+    ...build_1.default.flags,
+    directory: core_1.Flags.string({ char: 'd', description: 'Path to the testing directory', default: './tests' }),
+    'skip-build': core_1.Flags.boolean({ description: 'Skip build before testing', default: false }),
 };
 exports.default = Test;

package/dist/lib/CredentialsManager.js

@@ -129,39 +129,6 @@ class CredentialsManager {
         profiles[profileName] = { apiKey };
         this.writeCredentials(profiles);
     }
-    getProfile(profileName = DEFAULT_PROFILE) {
-        const credentialsDir = this.getBaseDir();
-        const credentialsPath = this.getCredentialsPath();
-        if (!fs.existsSync(credentialsDir)) {
-            throw new Error(`No credentials directory found at ${credentialsDir}. Run 'mimic login' to authenticate.`);
-        }
-        if (!fs.existsSync(credentialsPath)) {
-            throw new Error(`No credentials file found. Run 'mimic login' to authenticate.`);
-        }
-        const profiles = this.readCredentials();
-        if (!profiles[profileName]) {
-            const availableProfiles = Object.keys(profiles);
-            const suggestion = availableProfiles.length > 0
-                ? `Available profiles: ${availableProfiles.join(', ')}`
-                : `No profiles found. Run 'mimic login' to create one.`;
-            throw new Error(`Profile '${profileName}' not found. ${suggestion}`);
-        }
-        const credentials = profiles[profileName];
-        if (!credentials.apiKey || credentials.apiKey.trim() === '') {
-            throw new Error(`Profile '${profileName}' has no API key. Run 'mimic login --profile ${profileName}' to update credentials.`);
-        }
-        return credentials;
-    }
-    getCredentials(profileName = DEFAULT_PROFILE) {
-        try {
-            return this.getProfile(profileName);
-        }
-        catch (error) {
-            if (error instanceof Error)
-                throw new Error(`Authentication required: ${error.message}`);
-            throw error;
-        }
-    }
     getProfiles() {
         const profiles = this.readCredentials();
         return Object.keys(profiles);

package/dist/lib/InputsInterfaceGenerator.js

@@ -17,7 +17,7 @@ exports.default = {
             `  ${inputsMapping}`,
             '}',
             '',
-            '// The class name is intentionally lowercase and plural to resemble a namespace when used in a task.',
+            '// The class name is intentionally lowercase and plural to resemble a namespace when used in a function.',
             'export class inputs {',
             `  ${inputsClass}`,
             '}',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mimicprotocol/cli",
-  "version": "0.0.1-rc.35",
+  "version": "0.0.1-rc.37",
   "license": "GPL-3.0",
   "private": false,
   "type": "commonjs",