wyvrnpm 1.2.0 → 1.3.2

package/bin/wyvrn.js

@@ -1,158 +1,225 @@
 #!/usr/bin/env node
-
-'use strict';
-
-const yargs = require('yargs');
-const init = require('../src/commands/init');
-const install = require('../src/commands/install');
-const clean = require('../src/commands/clean');
-const publish = require('../src/commands/publish');
-const configure = require('../src/commands/configure');
-
-yargs
-  .option('manifest', {
-    type: 'string',
-    description: 'Path to manifest file',
-    default: './wyvrn.json',
-  })
-  .option('root', {
-    type: 'string',
-    description: 'Root directory',
-    default: './',
-  })
-  .command(
-    'init',
-    'Initialise a new wyvrn.json manifest in the current project',
-    () => {},
-    (argv) => init(argv),
-  )
-  .command(
-    'install',
-    'Resolve and download all dependencies listed in the manifest',
-    (yargs) => {
-      yargs
-        .option('source', {
-          alias: 's',
-          type: 'string',
-          description: 'Base URL of a package source (can be repeated)',
-          array: true,
-        })
-        .option('platform', {
-          type: 'string',
-          description: 'Target platform',
-          choices: ['win_x64', 'win_x86', 'linux_x64', 'linux_x86', 'osx_x64', 'osx_arm64'],
-          default: 'win_x64',
-        })
-        .option('timeout', {
-          type: 'number',
-          description: 'HTTP timeout in seconds',
-          default: 300,
-        });
-    },
-    (argv) => install(argv),
-  )
-  .command(
-    'clean',
-    'Remove downloaded packages and lock file',
-    () => {},
-    (argv) => clean(argv),
-  )
-  .command(
-    'publish',
-    'Package and publish the project to a source (S3 or HTTP server)',
-    (yargs) => {
-      yargs
-        .option('source', {
-          alias: 's',
-          type: 'string',
-          description: 'Publish destination URL/URI or a configured source name (falls back to config)',
-        })
-        .option('profile', {
-          alias: 'p',
-          type: 'string',
-          description: 'AWS SSO profile to use for authentication (S3 only)',
-        })
-        .option('platform', {
-          type: 'string',
-          description: 'Target platform sub-path (e.g. win_x64). Defaults to "common"',
-          choices: ['win_x64', 'win_x86', 'linux_x64', 'linux_x86', 'osx_x64', 'osx_arm64', 'common'],
-          default: 'common',
-        })
-        .option('path', {
-          type: 'string',
-          description: 'Directory to zip and publish (defaults to current directory)',
-          default: '.',
-        })
-        .option('token', {
-          type: 'string',
-          description: 'Bearer token for HTTP server authentication (HTTP only)',
-        });
-    },
-    (argv) => publish(argv),
-  )
-  .command(
-    'configure',
-    'Manage wyvrnpm configuration (sources, authentication)',
-    (yargs) => {
-      yargs
-        .command('list', 'List all configured sources', () => {}, () => configure.list())
-        .command(
-          'add-source',
-          'Add or update an install/publish source',
-          (yargs) => {
-            yargs
-              .option('kind', {
-                type: 'string',
-                description: 'Source kind',
-                choices: ['install', 'publish'],
-                demandOption: true,
-              })
-              .option('name', {
-                type: 'string',
-                description: 'Unique name for this source',
-                demandOption: true,
-              })
-              .option('url', {
-                type: 'string',
-                description: 'Source URL or URI (s3://, https://, UNC path, etc.)',
-                demandOption: true,
-              })
-              .option('profile', {
-                type: 'string',
-                description: 'AWS SSO profile for this source (S3 only)',
-              })
-              .option('token', {
-                type: 'string',
-                description: 'Bearer token for this source (HTTP only)',
-              });
-          },
-          (argv) => configure.addSource(argv),
-        )
-        .command(
-          'remove-source',
-          'Remove a configured source by name',
-          (yargs) => {
-            yargs
-              .option('kind', {
-                type: 'string',
-                description: 'Source kind',
-                choices: ['install', 'publish'],
-                demandOption: true,
-              })
-              .option('name', {
-                type: 'string',
-                description: 'Name of the source to remove',
-                demandOption: true,
-              });
-          },
-          (argv) => configure.removeSource(argv),
-        )
-        .demandCommand(1)
-        .help();
-    },
-    () => {},
-  )
-  .demandCommand(1)
-  .strict()
-  .help()
-  .parse();
+
+'use strict';
+
+const yargs = require('yargs');
+const init = require('../src/commands/init');
+const install = require('../src/commands/install');
+const clean = require('../src/commands/clean');
+const publish = require('../src/commands/publish');
+const configure = require('../src/commands/configure');
+const { link, unlink } = require('../src/commands/link');
+
+yargs
+  .option('manifest', {
+    type: 'string',
+    description: 'Path to manifest file',
+    default: './wyvrn.json',
+  })
+  .option('root', {
+    type: 'string',
+    description: 'Root directory',
+    default: './',
+  })
+  .command(
+    'init',
+    'Initialise a new wyvrn.json manifest in the current project',
+    () => {},
+    (argv) => init(argv),
+  )
+  .command(
+    'install',
+    'Resolve and download all dependencies listed in the manifest',
+    (yargs) => {
+      yargs
+        .option('source', {
+          alias: 's',
+          type: 'string',
+          description: 'Base URL of a package source (can be repeated)',
+          array: true,
+        })
+        .option('platform', {
+          type: 'string',
+          description: 'Target platform',
+          choices: ['win_x64', 'win_x86', 'linux_x64', 'linux_x86', 'osx_x64', 'osx_arm64'],
+          default: 'win_x64',
+        })
+        .option('timeout', {
+          type: 'number',
+          description: 'HTTP timeout in seconds',
+          default: 300,
+        });
+    },
+    (argv) => install(argv),
+  )
+  .command(
+    'clean',
+    'Remove downloaded packages and lock file',
+    () => {},
+    (argv) => clean(argv),
+  )
+  .command(
+    'publish',
+    'Package and publish the project to a source (S3 or HTTP server)',
+    (yargs) => {
+      yargs
+        .option('source', {
+          alias: 's',
+          type: 'string',
+          description: 'Publish destination URL/URI or a configured source name (falls back to config)',
+        })
+        .option('profile', {
+          alias: 'p',
+          type: 'string',
+          description: 'AWS SSO profile to use for authentication (S3 only)',
+        })
+        .option('platform', {
+          type: 'string',
+          description: 'Target platform sub-path (e.g. win_x64). Defaults to "common"',
+          choices: ['win_x64', 'win_x86', 'linux_x64', 'linux_x86', 'osx_x64', 'osx_arm64', 'common'],
+          default: 'common',
+        })
+        .option('path', {
+          type: 'string',
+          description: 'Directory to zip and publish (defaults to current directory)',
+          default: '.',
+        })
+        .option('token', {
+          type: 'string',
+          description: 'Bearer token for HTTP server authentication (HTTP only)',
+        })
+        .option('force', {
+          alias: 'f',
+          type: 'boolean',
+          description: 'Overwrite an existing published version',
+          default: false,
+        });
+    },
+    (argv) => publish(argv),
+  )
+  .command(
+    'configure',
+    'Manage wyvrnpm configuration (sources, authentication)',
+    (yargs) => {
+      yargs
+        .command('list', 'List all configured sources', () => {}, () => configure.list())
+        .command(
+          'add-source',
+          'Add or update an install/publish source',
+          (yargs) => {
+            yargs
+              .option('kind', {
+                type: 'string',
+                description: 'Source kind',
+                choices: ['install', 'publish'],
+                demandOption: true,
+              })
+              .option('name', {
+                type: 'string',
+                description: 'Unique name for this source',
+                demandOption: true,
+              })
+              .option('url', {
+                type: 'string',
+                description: 'Source URL or URI (s3://, https://, UNC path, etc.)',
+                demandOption: true,
+              })
+              .option('profile', {
+                type: 'string',
+                description: 'AWS SSO profile for this source (S3 only)',
+              })
+              .option('token', {
+                type: 'string',
+                description: 'Bearer token for this source (HTTP only)',
+              });
+          },
+          (argv) => configure.addSource(argv),
+        )
+        .command(
+          'remove-source',
+          'Remove a configured source by name',
+          (yargs) => {
+            yargs
+              .option('kind', {
+                type: 'string',
+                description: 'Source kind',
+                choices: ['install', 'publish'],
+                demandOption: true,
+              })
+              .option('name', {
+                type: 'string',
+                description: 'Name of the source to remove',
+                demandOption: true,
+              });
+          },
+          (argv) => configure.removeSource(argv),
+        )
+        .demandCommand(1)
+        .help();
+    },
+    () => {},
+  )
+  .command(
+    'link [name] [path]',
+    'Link a local package for development',
+    (yargs) => {
+      yargs
+        .positional('name', {
+          type: 'string',
+          description: 'Package name to link (omit to register current directory)',
+        })
+        .positional('path', {
+          type: 'string',
+          description: 'Local path to package (optional, uses global registry if omitted)',
+        })
+        .option('list', {
+          type: 'boolean',
+          description: 'List all globally registered packages',
+          default: false,
+        })
+        .option('subdir', {
+          type: 'string',
+          description: 'Subdirectory within the package to link (e.g., "output/install" for CMake packages)',
+        });
+    },
+    (argv) => link(argv),
+  )
+  .command(
+    'unlink <name>',
+    'Remove a linked package',
+    (yargs) => {
+      yargs
+        .positional('name', {
+          type: 'string',
+          description: 'Package name to unlink',
+          demandOption: true,
+        })
+        .option('restore', {
+          type: 'boolean',
+          description: 'Re-download the package from registry after unlinking',
+          default: false,
+        })
+        .option('source', {
+          alias: 's',
+          type: 'string',
+          description: 'Base URL of a package source (for --restore)',
+          array: true,
+        })
+        .option('platform', {
+          type: 'string',
+          description: 'Target platform (for --restore)',
+          choices: ['win_x64', 'win_x86', 'linux_x64', 'linux_x86', 'osx_x64', 'osx_arm64'],
+          default: 'win_x64',
+        })
+        .option('timeout', {
+          type: 'number',
+          description: 'HTTP timeout in seconds (for --restore)',
+          default: 300,
+        });
+    },
+    (argv) => unlink(argv),
+  )
+  .demandCommand(1)
+  .strict()
+  .help()
+  .parse();

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "wyvrnpm",
-  "version": "1.2.0",
-  "description": "A simple, static-hosting-compatible C++ package manager",
-  "keywords": [
-    "c++",
-    "package-manager",
-    "cpp",
-    "dependency-management",
-    "s3",
-    "azure"
-  ],
-  "license": "MIT",
-  "bin": {
-    "wyvrnpm": "bin/wyvrn.js"
-  },
-  "main": "src/index.js",
-  "type": "commonjs",
-  "files": [
-    "bin/",
-    "src/",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test tests/*.test.js"
-  },
-  "dependencies": {
-    "adm-zip": "^0.5.16",
-    "node-stream-zip": "^1.15.0",
-    "yargs": "^17.7.2",
-    "@aws-sdk/client-s3": "^3.0.0",
-    "@aws-sdk/credential-providers": "^3.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "wyvrnpm",
+  "version": "1.3.2",
+  "description": "A simple, static-hosting-compatible C++ package manager",
+  "keywords": [
+    "c++",
+    "package-manager",
+    "cpp",
+    "dependency-management",
+    "s3",
+    "azure"
+  ],
+  "license": "MIT",
+  "bin": {
+    "wyvrnpm": "bin/wyvrn.js"
+  },
+  "main": "src/index.js",
+  "type": "commonjs",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test tests/*.test.js"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "node-stream-zip": "^1.15.0",
+    "yargs": "^17.7.2",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/credential-providers": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/clean.js

@@ -1,40 +1,40 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Removes the wyvrn_internal/ package cache directory and the wyvrn.lock file.
- *
- * @param {object} argv - Parsed yargs arguments.
- * @param {string} argv.root - Project root directory.
- * @param {string} argv.manifest - Path to the manifest file (used to locate wyvrn.lock).
- * @returns {Promise<void>}
- */
-async function clean(argv) {
-  const rootDir = path.resolve(argv.root);
-  const razerDir = path.join(rootDir, 'wyvrn_internal');
-  const lockPath = path.join(path.dirname(path.resolve(argv.manifest)), 'wyvrn.lock');
-
-  let removedAnything = false;
-
-  if (fs.existsSync(razerDir)) {
-    fs.rmSync(razerDir, { recursive: true, force: true });
-    console.log(`[wyvrn] Removed ${razerDir}`);
-    removedAnything = true;
-  } else {
-    console.log(`[wyvrn] Nothing to clean at ${razerDir}`);
-  }
-
-  if (fs.existsSync(lockPath)) {
-    fs.unlinkSync(lockPath);
-    console.log(`[wyvrn] Removed ${lockPath}`);
-    removedAnything = true;
-  }
-
-  if (!removedAnything) {
-    console.log('[wyvrn] Nothing to clean.');
-  }
-}
-
-module.exports = clean;
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Removes the wyvrn_internal/ package cache directory and the wyvrn.lock file.
+ *
+ * @param {object} argv - Parsed yargs arguments.
+ * @param {string} argv.root - Project root directory.
+ * @param {string} argv.manifest - Path to the manifest file (used to locate wyvrn.lock).
+ * @returns {Promise<void>}
+ */
+async function clean(argv) {
+  const rootDir = path.resolve(argv.root);
+  const razerDir = path.join(rootDir, 'wyvrn_internal');
+  const lockPath = path.join(path.dirname(path.resolve(argv.manifest)), 'wyvrn.lock');
+
+  let removedAnything = false;
+
+  if (fs.existsSync(razerDir)) {
+    fs.rmSync(razerDir, { recursive: true, force: true });
+    console.log(`[wyvrn] Removed ${razerDir}`);
+    removedAnything = true;
+  } else {
+    console.log(`[wyvrn] Nothing to clean at ${razerDir}`);
+  }
+
+  if (fs.existsSync(lockPath)) {
+    fs.unlinkSync(lockPath);
+    console.log(`[wyvrn] Removed ${lockPath}`);
+    removedAnything = true;
+  }
+
+  if (!removedAnything) {
+    console.log('[wyvrn] Nothing to clean.');
+  }
+}
+
+module.exports = clean;