ic-mops 0.22.0 → 0.24.0

package/declarations/main/main.did

@@ -1,5 +1,3 @@
-type Version = text;
-type Ver = text;
 type User__1 = 
  record {
    displayName: text;
@@ -48,7 +46,7 @@ type Result_6 =
 type Result_5 = 
  variant {
    err: Err;
-   ok: Ver;
+   ok: PackageVersion;
  };
 type Result_4 = 
  variant {
@@ -78,6 +76,7 @@ type Result =
 type PublishingId = text;
 type PublishingErr = text;
 type PageCount = nat;
+type PackageVersion = text;
 type PackageSummary__1 = 
  record {
    config: PackageConfigV2__1;
@@ -186,20 +185,21 @@ service : {
   getAirdropAmount: () -> (nat) query;
   getAirdropAmountAll: () -> (nat) query;
   getApiVersion: () -> (Text) query;
-  getDefaultPackages: (text) -> (vec record {
-                                       PackageName__1;
-                                       Version;
-                                     }) query;
+  getDefaultPackages: (text) ->
+   (vec record {
+          PackageName__1;
+          PackageVersion;
+        }) query;
   getDownloadTrendByPackageId: (PackageId) ->
    (vec DownloadsSnapshot__1) query;
   getDownloadTrendByPackageName: (PackageName__1) ->
    (vec DownloadsSnapshot__1) query;
-  getFileIds: (PackageName__1, Ver) -> (Result_6) query;
+  getFileIds: (PackageName__1, PackageVersion) -> (Result_6) query;
   getHighestVersion: (PackageName__1) -> (Result_5) query;
   getMostDownloadedPackages: () -> (vec PackageSummary) query;
   getMostDownloadedPackagesIn7Days: () -> (vec PackageSummary) query;
   getNewPackages: () -> (vec PackageSummary) query;
-  getPackageDetails: (PackageName__1, Ver) -> (Result_4) query;
+  getPackageDetails: (PackageName__1, PackageVersion) -> (Result_4) query;
   getPackagesByCategory: () -> (vec record {
                                       text;
                                       vec PackageSummary;
@@ -212,7 +212,7 @@ service : {
   getTotalDownloads: () -> (nat) query;
   getTotalPackages: () -> (nat) query;
   getUser: (principal) -> (opt User__1) query;
-  notifyInstall: (PackageName__1, Ver) -> () oneway;
+  notifyInstall: (PackageName__1, PackageVersion) -> () oneway;
   search: (Text, opt nat, opt nat) -> (vec PackageSummary, PageCount) query;
   setUserProp: (text, text) -> (Result_3);
   startFileUpload: (PublishingId, Text, nat, blob) -> (Result_2);

package/declarations/main/main.did.d.ts

@@ -94,6 +94,7 @@ export interface PackageSummary__1 {
   'config' : PackageConfigV2__1,
   'publication' : PackagePublication,
 }
+export type PackageVersion = string;
 export type PageCount = bigint;
 export type PublishingErr = string;
 export type PublishingId = string;
@@ -107,7 +108,7 @@ export type Result_3 = { 'ok' : null } |
   { 'err' : string };
 export type Result_4 = { 'ok' : PackageDetails } |
   { 'err' : Err };
-export type Result_5 = { 'ok' : Ver } |
+export type Result_5 = { 'ok' : PackageVersion } |
   { 'err' : Err };
 export type Result_6 = { 'ok' : Array<FileId> } |
   { 'err' : Err };
@@ -144,8 +145,6 @@ export interface User__1 {
   'githubVerified' : boolean,
   'github' : string,
 }
-export type Ver = string;
-export type Version = string;
 export interface _SERVICE {
   'claimAirdrop' : ActorMethod<[Principal], string>,
   'finishPublish' : ActorMethod<[PublishingId], Result>,
@@ -154,7 +153,7 @@ export interface _SERVICE {
   'getApiVersion' : ActorMethod<[], Text>,
   'getDefaultPackages' : ActorMethod<
     [string],
-    Array<[PackageName__1, Version]>
+    Array<[PackageName__1, PackageVersion]>
   >,
   'getDownloadTrendByPackageId' : ActorMethod<
     [PackageId],
@@ -164,12 +163,12 @@ export interface _SERVICE {
     [PackageName__1],
     Array<DownloadsSnapshot__1>
   >,
-  'getFileIds' : ActorMethod<[PackageName__1, Ver], Result_6>,
+  'getFileIds' : ActorMethod<[PackageName__1, PackageVersion], Result_6>,
   'getHighestVersion' : ActorMethod<[PackageName__1], Result_5>,
   'getMostDownloadedPackages' : ActorMethod<[], Array<PackageSummary>>,
   'getMostDownloadedPackagesIn7Days' : ActorMethod<[], Array<PackageSummary>>,
   'getNewPackages' : ActorMethod<[], Array<PackageSummary>>,
-  'getPackageDetails' : ActorMethod<[PackageName__1, Ver], Result_4>,
+  'getPackageDetails' : ActorMethod<[PackageName__1, PackageVersion], Result_4>,
   'getPackagesByCategory' : ActorMethod<
     [],
     Array<[string, Array<PackageSummary>]>
@@ -179,7 +178,7 @@ export interface _SERVICE {
   'getTotalDownloads' : ActorMethod<[], bigint>,
   'getTotalPackages' : ActorMethod<[], bigint>,
   'getUser' : ActorMethod<[Principal], [] | [User__1]>,
-  'notifyInstall' : ActorMethod<[PackageName__1, Ver], undefined>,
+  'notifyInstall' : ActorMethod<[PackageName__1, PackageVersion], undefined>,
   'search' : ActorMethod<
     [Text, [] | [bigint], [] | [bigint]],
     [Array<PackageSummary>, PageCount]

package/declarations/main/main.did.js

@@ -4,7 +4,7 @@ export const idlFactory = ({ IDL }) => {
   const Result = IDL.Variant({ 'ok' : IDL.Null, 'err' : Err });
   const Text = IDL.Text;
   const PackageName__1 = IDL.Text;
-  const Version = IDL.Text;
+  const PackageVersion = IDL.Text;
   const PackageId = IDL.Text;
   const Time = IDL.Int;
   const DownloadsSnapshot__1 = IDL.Record({
@@ -12,10 +12,9 @@ export const idlFactory = ({ IDL }) => {
     'endTime' : Time,
     'downloads' : IDL.Nat,
   });
-  const Ver = IDL.Text;
   const FileId = IDL.Text;
   const Result_6 = IDL.Variant({ 'ok' : IDL.Vec(FileId), 'err' : Err });
-  const Result_5 = IDL.Variant({ 'ok' : Ver, 'err' : Err });
+  const Result_5 = IDL.Variant({ 'ok' : PackageVersion, 'err' : Err });
   const User = IDL.Record({
     'id' : IDL.Principal,
     'emailVerified' : IDL.Bool,
@@ -145,7 +144,7 @@ export const idlFactory = ({ IDL }) => {
     'getApiVersion' : IDL.Func([], [Text], ['query']),
     'getDefaultPackages' : IDL.Func(
         [IDL.Text],
-        [IDL.Vec(IDL.Tuple(PackageName__1, Version))],
+        [IDL.Vec(IDL.Tuple(PackageName__1, PackageVersion))],
         ['query'],
       ),
     'getDownloadTrendByPackageId' : IDL.Func(
@@ -158,7 +157,11 @@ export const idlFactory = ({ IDL }) => {
         [IDL.Vec(DownloadsSnapshot__1)],
         ['query'],
       ),
-    'getFileIds' : IDL.Func([PackageName__1, Ver], [Result_6], ['query']),
+    'getFileIds' : IDL.Func(
+        [PackageName__1, PackageVersion],
+        [Result_6],
+        ['query'],
+      ),
     'getHighestVersion' : IDL.Func([PackageName__1], [Result_5], ['query']),
     'getMostDownloadedPackages' : IDL.Func(
         [],
@@ -172,7 +175,7 @@ export const idlFactory = ({ IDL }) => {
       ),
     'getNewPackages' : IDL.Func([], [IDL.Vec(PackageSummary)], ['query']),
     'getPackageDetails' : IDL.Func(
-        [PackageName__1, Ver],
+        [PackageName__1, PackageVersion],
         [Result_4],
         ['query'],
       ),
@@ -194,7 +197,11 @@ export const idlFactory = ({ IDL }) => {
     'getTotalDownloads' : IDL.Func([], [IDL.Nat], ['query']),
     'getTotalPackages' : IDL.Func([], [IDL.Nat], ['query']),
     'getUser' : IDL.Func([IDL.Principal], [IDL.Opt(User__1)], ['query']),
-    'notifyInstall' : IDL.Func([PackageName__1, Ver], [], ['oneway']),
+    'notifyInstall' : IDL.Func(
+        [PackageName__1, PackageVersion],
+        [],
+        ['oneway'],
+      ),
     'search' : IDL.Func(
         [Text, IDL.Opt(IDL.Nat), IDL.Opt(IDL.Nat)],
         [IDL.Vec(PackageSummary), PageCount],

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import fs from 'node:fs';
-import { program } from 'commander';
+import { program, Argument } from 'commander';
 import chalk from 'chalk';
 import { Principal } from '@dfinity/principal';
 import { init } from './commands/init.js';
@@ -19,6 +19,7 @@ import { selfUpdate } from './commands/self-update.js';
 import { remove } from './commands/remove.js';
 import { getUserProp, setUserProp } from './commands/user.js';
 import { bump } from './commands/bump.js';
+import { sync } from './commands/sync.js';
 // import {docs} from './commands/docs.js';
 program.name('mops');
 // --version
@@ -26,10 +27,11 @@ let packageJson = JSON.parse(fs.readFileSync(new URL('package.json', import.meta
 program.version(`CLI ${packageJson.version}\nAPI ${apiVersion}`, '-v --version');
 // init
 program
-    .command('init [name]')
-    .description('Create mops.toml')
-    .action(async (name) => {
-    await init(name);
+    .command('init')
+    .description('Initialize a new project or package in the current directory')
+    .option('-y, --yes', 'Accept all defaults')
+    .action(async (options) => {
+    await init(options);
 });
 // add
 program
@@ -98,7 +100,7 @@ program
 program
     .command('set-network <network>')
     .alias('sn')
-    .description('Set network local|dev|ic')
+    .description('Set network local|staging|ic')
     .action(async (network) => {
     await setNetwork(network);
     console.log(`Selected '${network}' network`);
@@ -148,8 +150,9 @@ program
 });
 // cache
 program
-    .command('cache [sub-command]')
+    .command('cache')
     .description('Manage cache')
+    .addArgument(new Argument('<sub>').choices(['size', 'clean']))
     .action(async (sub) => {
     if (sub == 'clean') {
         await cleanCache();
@@ -159,9 +162,6 @@ program
         let size = await cacheSize();
         console.log('Cache size is ' + size);
     }
-    else {
-        console.log('Unknown sub command. Available sub commands: clean, size');
-    }
 });
 // test
 program
@@ -213,7 +213,10 @@ program
 });
 // user
 program
-    .command('user set|get <prop> [value]')
+    .command('user')
+    .addArgument(new Argument('<sub>').choices(['set', 'get']))
+    .addArgument(new Argument('<prop>').choices(['name', 'site', 'email', 'github', 'twitter']))
+    .addArgument(new Argument('[value]'))
     .description('User settings')
     .action(async (sub, prop, value) => {
     if (sub == 'get') {
@@ -226,9 +229,6 @@ program
         }
         await setUserProp(prop, value);
     }
-    else {
-        console.log('Unknown sub command. Available sub commands: set, get');
-    }
 });
 // airdrop
 program
@@ -268,4 +268,11 @@ program
     .action(async (part) => {
     bump(part);
 });
+// sync
+program
+    .command('sync')
+    .description('Add missing packages and remove unused packages')
+    .action(async () => {
+    await sync();
+});
 program.parse();

package/dist/commands/init.d.ts

@@ -1 +1,3 @@
-export declare function init(name?: string): Promise<void>;
+export declare function init({ yes }?: {
+    yes?: boolean | undefined;
+}): Promise<void>;

package/dist/commands/init.js

@@ -1,59 +1,169 @@
 import { execSync } from 'node:child_process';
 import path from 'node:path';
-import fs from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import chalk from 'chalk';
-import { checkApiCompatibility, mainActor, readDfxJson, writeConfig } from '../mops.js';
+import prompts from 'prompts';
+import { checkApiCompatibility, mainActor, writeConfig } from '../mops.js';
 import { installAll } from './install-all.js';
 import { readVesselConfig } from '../vessel.js';
-export async function init(name = '') {
+import { template } from './template.js';
+export async function init({ yes = false } = {}) {
     let configFile = path.join(process.cwd(), 'mops.toml');
-    let exists = fs.existsSync(configFile);
+    let exists = existsSync(configFile);
     if (exists) {
         console.log(chalk.yellow('mops.toml already exists'));
         return;
     }
     console.log('Initializing...');
     let config = {};
+    if (yes) {
+        await applyInit({
+            type: 'project',
+            config,
+            setupWorkflow: true,
+            addTest: false,
+            copyrightOwner: '',
+        });
+        return;
+    }
+    // migrate from vessel
+    let vesselFile = path.join(process.cwd(), 'vessel.dhall');
     let vesselConfig = { dependencies: [], 'dev-dependencies': [] };
-    let deps = {};
-    const vesselFile = path.join(process.cwd(), 'vessel.dhall');
-    if (fs.existsSync(vesselFile)) {
+    if (existsSync(vesselFile)) {
         console.log('Reading vessel.dhall file');
-        const res = await readVesselConfig(process.cwd(), { cache: false });
+        let res = await readVesselConfig(process.cwd(), { cache: false });
         if (res) {
             vesselConfig = { ...res };
         }
     }
     if (vesselConfig.dependencies) {
+        let deps = {};
         deps = {};
         for (const dep of (vesselConfig.dependencies || [])) {
             deps[dep.name] = dep;
         }
+        if (Object.keys(deps).length) {
+            config.dependencies = deps;
+        }
     }
-    // lib mode
-    if (name) {
+    let promptsConfig = {
+        onCancel() {
+            console.log('aborted');
+            process.exit(0);
+        }
+    };
+    // type
+    let { type } = await prompts({
+        type: 'select',
+        name: 'type',
+        message: 'Select type:',
+        choices: [
+            { title: `Project ${chalk.dim('(I just want to use mops packages in my project)')}`, value: 'project' },
+            { title: `Package ${chalk.dim('(I plan to publish this package on mops)')}`, value: 'package' },
+        ],
+    }, promptsConfig);
+    let addTest = false;
+    let copyrightOwner = '';
+    // package details
+    if (type === 'package') {
+        let res = await prompts([
+            {
+                type: 'text',
+                name: 'name',
+                message: 'Enter package name:',
+                initial: '',
+            },
+            {
+                type: 'text',
+                name: 'description',
+                message: 'Enter package description:',
+                initial: '',
+            },
+            {
+                type: 'text',
+                name: 'repository',
+                message: 'Enter package repository url:',
+                initial: '',
+            },
+            {
+                type: 'text',
+                name: 'keywords',
+                message: 'Enter keywords separated by spaces:',
+                initial: '',
+            },
+            {
+                type: 'select',
+                name: 'license',
+                message: 'Choose a license:',
+                choices: [
+                    { title: 'MIT', value: 'MIT' },
+                    { title: 'Apache-2.0', value: 'Apache-2.0' },
+                ],
+                initial: 0,
+            },
+            {
+                type: 'text',
+                name: 'copyrightOwner',
+                message: 'Enter license copyright owner:',
+                initial: '',
+            },
+            {
+                type: 'confirm',
+                name: 'addTest',
+                message: `Add example test file? ${chalk.dim('(test/lib.test.mo)')}`,
+                initial: true,
+            },
+        ], promptsConfig);
         config.package = {
-            name,
-            version: '0.1.0',
-            description: '',
-            repository: '',
+            name: (res.name || '').trim(),
+            version: '1.0.0',
+            description: (res.description || '').trim(),
+            repository: (res.repository || '').trim(),
+            keywords: [...new Set(res.keywords.split(' ').filter(Boolean))],
+            license: (res.license || '').trim(),
         };
-        if (deps) {
-            config.dependencies = deps;
-        }
-        writeConfig(config, configFile);
-        if (Object.keys(config.dependencies || {}).length) {
-            await installAll({ verbose: true });
+        addTest = res.addTest;
+        copyrightOwner = res.copyrightOwner;
+    }
+    // GitHub workflow
+    let { setupWorkflow } = await prompts({
+        type: 'confirm',
+        name: 'setupWorkflow',
+        message: `Setup GitHub workflow? ${chalk.dim('(run `mops test` on push)')}`,
+        initial: true,
+    }, promptsConfig);
+    await applyInit({
+        type,
+        config,
+        setupWorkflow,
+        addTest,
+        copyrightOwner,
+    });
+}
+async function applyInit({ type, config, setupWorkflow, addTest, copyrightOwner }) {
+    // set packtool in dfx.json
+    let dfxJson = path.resolve(process.cwd(), 'dfx.json');
+    let dfxJsonData;
+    if (existsSync(dfxJson)) {
+        let dfxJsonText = readFileSync(dfxJson).toString();
+        dfxJsonData = JSON.parse(dfxJsonText);
+        console.log('Setting packtool in dfx.json...');
+        dfxJsonData.defaults = dfxJsonData.defaults || {};
+        dfxJsonData.defaults.build = dfxJsonData.defaults.build || {};
+        if (dfxJsonData.defaults.build.packtool !== 'mops sources') {
+            dfxJsonData.defaults.build.packtool = 'mops sources';
+            let indent = dfxJsonText.match(/([ \t]+)"/)?.[1] || '  ';
+            writeFileSync(path.join(process.cwd(), 'dfx.json'), JSON.stringify(dfxJsonData, null, indent));
+            console.log(chalk.green('packtool set to "mops sources"'));
         }
     }
-    // project mode
-    if (!name) {
+    // get default packages
+    if (type === 'project') {
         let compatible = await checkApiCompatibility();
         if (!compatible) {
             return;
         }
-        let dfxJson = readDfxJson();
-        let dfxVersion = dfxJson?.dfx || '';
+        let dfxVersion = dfxJsonData?.dfx || '';
         if (!dfxVersion) {
             try {
                 let res = execSync('dfx --version').toString();
@@ -64,19 +174,54 @@ export async function init(name = '') {
             }
             catch { }
         }
+        console.log(`Fetching default packages for dfx ${dfxVersion}...`);
         let actor = await mainActor();
         let defaultPackages = await actor.getDefaultPackages(dfxVersion);
         if (!config.dependencies) {
             config.dependencies = {};
         }
-        if (deps) {
-            config.dependencies = deps;
-        }
         for (let [name, version] of defaultPackages) {
             config.dependencies[name] = { name, version };
         }
-        writeConfig(config, configFile);
+    }
+    // save config
+    let configFile = path.join(process.cwd(), 'mops.toml');
+    writeConfig(config, configFile);
+    console.log(chalk.green('Created'), 'mops.toml');
+    // add src/lib.mo
+    if (type === 'package' && !existsSync(path.join(process.cwd(), 'src'))) {
+        await template('lib.mo');
+    }
+    // add src/lib.test.mo
+    if (addTest && !existsSync(path.join(process.cwd(), 'test'))) {
+        await template('lib.test.mo');
+    }
+    // add license
+    if (config.package?.license) {
+        await template(`license:${config.package.license}`, { copyrightOwner });
+    }
+    // add readme
+    if (type === 'package') {
+        await template('readme');
+    }
+    // add GitHub workflow
+    if (setupWorkflow) {
+        await template('github-workflow:mops-test');
+    }
+    // add .mops to .gitignore
+    {
+        let gitignore = path.join(process.cwd(), '.gitignore');
+        let gitignoreData = existsSync(gitignore) ? readFileSync(gitignore).toString() : '';
+        let lf = gitignoreData.endsWith('\n') ? '\n' : '';
+        if (!gitignoreData.includes('.mops')) {
+            writeFileSync(gitignore, `${gitignoreData}\n.mops${lf}`.trimStart());
+            console.log(chalk.green('Added'), '.mops to .gitignore');
+        }
+    }
+    // install deps
+    if (Object.keys(config.dependencies || {}).length) {
+        console.log('Installing dependencies...');
         await installAll({ verbose: true });
     }
-    console.log(chalk.green('mops.toml has been created'));
+    console.log(chalk.green('Done!'));
 }

package/dist/commands/remove.js

@@ -67,7 +67,7 @@ export async function remove(name, { dev = false, verbose = false, dryRun = fals
             pkgDir = formatDir(dep.name, dep.version);
         }
         if (pkgDir && fs.existsSync(pkgDir)) {
-            dryRun || deleteSync([`${pkgDir}`]);
+            dryRun || deleteSync([`${pkgDir}`], { force: true });
             verbose && console.log(`Removed local cache ${pkgDir}`);
         }
     }

package/dist/commands/sync.d.ts

@@ -0,0 +1 @@
+export declare function sync(): Promise<void>;

package/dist/commands/sync.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { globSync } from 'glob';
+import chalk from 'chalk';
+import { checkConfigFile, getRootDir, readConfig } from '../mops.js';
+import { add } from './add.js';
+import { remove } from './remove.js';
+let ignore = [
+    '**/node_modules/**',
+    '**/.vessel/**',
+    '**/.git/**',
+    '**/.mops/**',
+    '**/test/**',
+    '**/*.test.mo',
+];
+let mocPath = '';
+function getMocPath() {
+    if (!mocPath) {
+        mocPath = process.env.DFX_MOC_PATH || '';
+    }
+    if (!mocPath) {
+        try {
+            mocPath = execSync('dfx cache show').toString().trim() + '/moc';
+        }
+        catch { }
+    }
+    if (!mocPath) {
+        mocPath = 'moc';
+    }
+    return mocPath;
+}
+async function getUsedPackages() {
+    let rootDir = getRootDir();
+    let files = globSync('**/*.mo', {
+        cwd: rootDir,
+        nocase: true,
+        ignore: ignore,
+    });
+    let packages = new Set;
+    for (let file of files) {
+        let deps = execSync(`${getMocPath()} --print-deps ${path.join(rootDir, file)}`).toString().trim().split('\n');
+        for (let dep of deps) {
+            if (dep.startsWith('mo:') && !dep.startsWith('mo:prim') && !dep.startsWith('mo:⛔')) {
+                packages.add(dep.replace(/^mo:([^/]+).*$/, '$1'));
+            }
+        }
+    }
+    return [...packages];
+}
+async function getMissingPackages() {
+    let config = readConfig();
+    let allDeps = [...Object.keys(config.dependencies || {}), ...Object.keys(config['dev-dependencies'] || {})];
+    let missing = new Set(await getUsedPackages());
+    for (let pkg of allDeps) {
+        missing.delete(pkg);
+    }
+    return [...missing];
+}
+async function getUnusedPackages() {
+    let config = readConfig();
+    let allDeps = new Set([...Object.keys(config.dependencies || {})]);
+    let used = await getUsedPackages();
+    for (let pkg of used) {
+        allDeps.delete(pkg);
+    }
+    return [...allDeps];
+}
+export async function sync() {
+    if (!checkConfigFile()) {
+        return;
+    }
+    let missing = await getMissingPackages();
+    let unused = await getUnusedPackages();
+    missing.length && console.log(`${chalk.yellow('Missing packages:')} ${missing.join(', ')}`);
+    unused.length && console.log(`${chalk.yellow('Unused packages:')} ${unused.join(', ')}`);
+    // add missing packages
+    for (let pkg of missing) {
+        await add(pkg);
+    }
+    // remove unused packages
+    for (let pkg of unused) {
+        await remove(pkg);
+    }
+}

package/dist/commands/template.d.ts

@@ -1 +1 @@
-export declare function template(): Promise<void>;
+export declare function template(templateName?: string, options?: any): Promise<void>;