@_linked/cli 1.38.0 → 1.39.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.39.0
+
+### Minor Changes
+
+- [#199](https://github.com/linked-fw/cli/pull/199) [`dfdb1c5`](https://github.com/linked-fw/cli/commit/dfdb1c50547bab428540db149afb4b106c9f0c5c) Thanks [@flyon](https://github.com/flyon)! - `create-package` chooses where a package lives inside an app: `packages/` (part of the app's repository: a workspace member, added to its dependencies and installed at the app root) or `packages-local/` (its own git repository, under `linked localize`'s name for it, with `git init`, a first commit, an optional `--remote` and `--push`, then installed, built, linked and recorded by `linked localize --adopt`). Choose with `--location`, `--remote` and `--push`; with none of them you are asked, on a terminal only. An existing target folder is refused. Outside an app nothing changes.
+
+  `linked localize --adopt` links a checkout already in `packages-local/` without cloning it, and `build-all` builds packages recorded in `local-packages.json` even when the app does not declare them yet. Needs `@_linked/localize` 0.2.0.
+
 ## 1.38.0
 
 ### Minor Changes

package/lib/esm/cli-methods.d.ts

@@ -1,3 +1,4 @@
+import type { CreatePackageOptions } from './utils/createPackageLocation.js';
 import type { PackageDetails } from './interfaces.js';
 /**
  * Dynamically import the app's backend storage configuration. Tries the
@@ -130,7 +131,7 @@ export declare const startServer: (initOnly?: boolean, ServerClass?: any) => Pro
  */
 export declare const buildBackend: () => Promise<boolean>;
 export declare const upgradePackages: () => Promise<void>;
-export declare const createPackage: (name: any, uriBase?: any, basePath?: string) => Promise<void>;
+export declare const createPackage: (name: any, uriBase?: any, basePath?: string, options?: CreatePackageOptions) => Promise<void>;
 export declare const register: (registryURL: any) => Promise<void>;
 export declare const buildPackage: (target: any, target2: any, packagePath?: string, logResults?: boolean) => Promise<boolean>;
 type BuildStep = {

package/lib/esm/cli-methods.d.ts.map

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

package/lib/esm/cli-methods.js

@@ -17,12 +17,13 @@ import { createInterface } from 'readline';
 import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isInternalLinkedImport, needsRebuilding, } from './utils.js';
 import { renameShippedDotfiles } from './utils/shippedDotfiles.js';
 import { planPackageSetup } from './utils/packageSetup.js';
+import { bareName, CreatePackageError, decideCreatePackageTarget, ensureRelinkPostinstall, ensureWorkspaceGlob, findLinkedAppRoot, RELINK_COMMAND, repositoryUrlFor, } from './utils/createPackageLocation.js';
 import { detectPackageManager, execBinCommand, runScriptCommand, } from './utils/packageManager.js';
 import { rewriteExtensionlessImports } from './utils/esmSpecifiers.js';
 import { checkShapeNames } from './utils/shapeNames.js';
 import { checkShapeReferences, inspectShapeReferences, } from './utils/shapeReferences.js';
 import { checkShapesIndex, checkShapesSideEffects } from './utils/shapesIndex.js';
-import { spawn as spawnChild } from 'child_process';
+import { spawn as spawnChild, spawnSync } from 'child_process';
 import { findNearestPackageJson } from 'find-nearest-package-json';
 import { statSync } from 'fs';
 // import pkg from 'lincd/utils/LinkedFileStorage';
@@ -1833,45 +1834,64 @@ export const upgradePackages = () => __awaiter(void 0, void 0, void 0, function*
     // })
     // });
 });
-export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0, [name_1, uriBase_1, ...args_1], void 0, function* (name, uriBase, basePath = process.cwd()) {
+export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0, [name_1, uriBase_1, ...args_1], void 0, function* (name, uriBase, basePath = process.cwd(), options = {}) {
     if (!name) {
         console.warn('Please provide a name as the first argument');
         return;
     }
-    //if ran with npx, basePath will be the root directory of the repository, even if we're executing from a sub folder (the root directory is where node_modules lives and package.json with workspaces)
-    //so we manually find a packages folder, if it exists we go into that.
-    if (fs.existsSync(path.join(basePath, 'packages'))) {
-        basePath = path.join(basePath, 'packages');
+    const appRoot = findLinkedAppRoot(basePath);
+    const decided = decideCreatePackageTarget({
+        appRoot,
+        options,
+        isTTY: !!(process.stdin.isTTY && process.stdout.isTTY),
+    });
+    if (decided.kind === 'refuse')
+        throw new CreatePackageError(decided.message);
+    const decision = decided.kind === 'ask' ? yield askPackageLocation(name) : decided;
+    //let's remove scope for variable names
+    const cleanPackageName = bareName(name);
+    let targetFolder;
+    if (decision.kind === 'outside') {
+        //if ran with npx, basePath will be the root directory of the repository, even if we're executing from a sub folder (the root directory is where node_modules lives and package.json with workspaces)
+        //so we manually find a packages folder, if it exists we go into that.
+        if (fs.existsSync(path.join(basePath, 'packages'))) {
+            basePath = path.join(basePath, 'packages');
+        }
+        //for lincd.org currently packages are stored in the modules folder
+        else if (fs.existsSync(path.join(basePath, 'modules'))) {
+            basePath = path.join(basePath, 'modules');
+        }
+        targetFolder = path.join(basePath, cleanPackageName);
     }
-    //for lincd.org currently packages are stored in the modules folder
-    else if (fs.existsSync(path.join(basePath, 'modules'))) {
-        basePath = path.join(basePath, 'modules');
+    else if (decision.location === 'packages') {
+        targetFolder = path.join(appRoot, 'packages', cleanPackageName);
+    }
+    else {
+        // localize's own naming, so `linked localize` and this command can never
+        // disagree about where a package lives.
+        const { checkoutNameFor, DEFAULT_DIR } = yield import('@_linked/localize');
+        targetFolder = path.join(appRoot, DEFAULT_DIR, checkoutNameFor(name));
+    }
+    if (fs.existsSync(targetFolder)) {
+        throw new CreatePackageError(`${targetFolder} already exists. Refusing to write a new package over it.`);
     }
-    //let's remove scope for variable names
-    let [packageName, scope, cleanPackageName] = name.match(/(@[\w\-]+\/)?([\w\-]+)/);
-    let targetFolder = ensureFolderExists(basePath, cleanPackageName);
     if (!uriBase) {
         uriBase = defaultOntologyNamespace(name);
     }
     setVariable('uri_base', asNamespace(uriBase));
-    //find @scope and the next part between 2 slashes after
-    //so @dacore/some-mod/lib/file.js
-    // --> match[0] = @dacore/some-mod
-    // --> match[1] = @dacore
-    // --> match[2] = some-mod
-    //but save full scoped package name under ${package_name}
+    //save the full scoped package name under ${package_name}
     setVariable('package_name', name);
     //extra variable for clarity (will be same as 'name')
     setVariable('output_file_name', name);
-    let { hyphenName, camelCaseName, underscoreName } = setNameVariables(cleanPackageName);
+    const { hyphenName } = setNameVariables(cleanPackageName);
     log("Creating new linked package '" + name + "'");
+    fs.mkdirSync(targetFolder, { recursive: true });
     fs.copySync(path.join(getScriptDir(), '..', '..', 'defaults', 'package'), targetFolder);
     renameShippedDotfiles(targetFolder);
     //replace variables in some of the copied files
     yield Promise.all([
         'src/index.ts',
         'package.json',
-        'Gruntfile.js',
         'src/package.ts',
         'src/ontologies/example-ontology.ts',
         'src/ontologies/example-ontology.register.ts',
@@ -1898,37 +1918,189 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
         console.log('rename ', path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
         fs.renameSync(path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
     });
-    // npm is the default for a new package. yarn is only consulted when the new
-    // package lands inside an existing yarn project (a yarn-3 monorepo),
-    // where adding an npm lockfile would break the workspace.
-    const insideYarnProject = detectPackageManager(path.dirname(path.resolve(targetFolder))) === 'yarn';
-    let version = insideYarnProject
-        ? (yield execPromise('yarn --version').catch(() => {
-            console.log('yarn probably not working');
-            return '';
-        }))
-        : '';
-    const setup = planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'), process.execPath, insideYarnProject);
-    if (setup.yarnrc) {
-        fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
-    }
-    const installed = yield execp(setup.installCommand, true, false, {
-        cwd: targetFolder,
-    })
-        .then(() => true)
-        .catch(() => {
-        console.warn(`Could not install dependencies (${setup.installCommand})`);
-        process.exitCode = 1;
-        return false;
+    if (decision.kind === 'outside') {
+        yield installStandalonePackage(targetFolder);
+    }
+    else if (decision.location === 'packages') {
+        yield installWorkspacePackage(name, targetFolder, appRoot);
+    }
+    else {
+        yield installOwnRepoPackage(name, targetFolder, appRoot, decision);
+    }
+});
+/**
+ * Ask where a new package goes — only ever on a terminal, and only when no
+ * flag said so already.
+ */
+function askPackageLocation(name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log(`\nWhere should ${chalk.magenta(name)} live?\n` +
+            `  1) packages/        part of this app's repository\n` +
+            `  2) packages-local/  its own git repository, linked into this app\n`);
+        let answer = '';
+        while (answer !== '1' && answer !== '2') {
+            answer = yield promptUser('Choose 1 or 2: ');
+        }
+        if (answer === '1')
+            return { kind: 'resolved', location: 'packages', push: false };
+        const remote = yield promptUser('Remote git URL for its repository (optional, Enter to skip): ');
+        const push = !!remote &&
+            /^y(es)?$/i.test(yield promptUser(`Push the first commit to ${remote}? (y/N): `));
+        return Object.assign(Object.assign({ kind: 'resolved', location: 'packages-local' }, (remote ? { remote } : {})), { push });
+    });
+}
+/** The install + first build plan for a package, given where it installs from. */
+function packageSetupFor(installRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // npm is the default for a new package. yarn is only consulted when the new
+        // package lands inside an existing yarn project (a yarn-3 monorepo),
+        // where adding an npm lockfile would break the workspace.
+        const insideYarnProject = detectPackageManager(installRoot) === 'yarn';
+        let version = insideYarnProject
+            ? (yield execPromise('yarn --version').catch(() => {
+                console.log('yarn probably not working');
+                return '';
+            }))
+            : '';
+        return planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'), process.execPath, insideYarnProject);
     });
-    if (installed) {
-        yield execp(setup.buildCommand, true, false, { cwd: targetFolder }).catch(() => {
-            console.warn('Dependencies installed, but the initial build failed');
+}
+/**
+ * Install `cwd` with `setup`, then build `targetFolder`. Failures set the exit
+ * code; `installFailedHint` says what was already changed when the install fails.
+ */
+function installThenBuild(setup_1, cwd_1, targetFolder_1) {
+    return __awaiter(this, arguments, void 0, function* (setup, cwd, targetFolder, installFailedHint = '') {
+        const installed = yield execp(setup.installCommand, true, false, { cwd })
+            .then(() => true)
+            .catch(() => {
+            console.warn(`Could not install dependencies (${setup.installCommand})` +
+                (installFailedHint ? `. ${installFailedHint}` : ''));
             process.exitCode = 1;
+            return false;
         });
+        if (installed) {
+            yield execp(setup.buildCommand, true, false, { cwd: targetFolder }).catch(() => {
+                console.warn('Dependencies installed, but the initial build failed');
+                process.exitCode = 1;
+            });
+        }
+    });
+}
+/** Outside an app: install inside the package itself, as this command always has. */
+function installStandalonePackage(targetFolder) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const setup = yield packageSetupFor(path.dirname(path.resolve(targetFolder)));
+        if (setup.yarnrc) {
+            fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
+        }
+        yield installThenBuild(setup, targetFolder, targetFolder);
+        log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'build'))} from this directory to build once`, `Or ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} to continuously rebuild on file changes`);
+    });
+}
+/**
+ * packages/: a workspace member of the app's own repository. The app's
+ * workspaces must cover it and its dependencies declare it — npm links a
+ * workspace member by name, and `build-all` builds what the app depends on —
+ * and the install runs at the app root, where the workspace is.
+ */
+function installWorkspacePackage(name, targetFolder, appRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const appPkgPath = path.join(appRoot, 'package.json');
+        const appPkg = fs.readJsonSync(appPkgPath);
+        const workspaces = ensureWorkspaceGlob(appPkg);
+        if (workspaces.warning)
+            console.warn(chalk.yellow(workspaces.warning));
+        const version = fs.readJsonSync(path.join(targetFolder, 'package.json')).version;
+        appPkg.dependencies = Object.assign(Object.assign({}, appPkg.dependencies), { [name]: `^${version}` });
+        fs.writeJsonSync(appPkgPath, appPkg, { spaces: 2 });
+        log(`Added ${name}@^${version} to ${path.relative(process.cwd(), appPkgPath) || 'package.json'}` +
+            (workspaces.changed ? ' and packages/* to its workspaces' : ''));
+        const setup = yield packageSetupFor(appRoot);
+        yield installThenBuild(setup, appRoot, targetFolder, `The app's package.json already declares ${name}; run the install again at the app root once it is fixed.`);
+        log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}, part of this app's repository`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} in it to continuously rebuild on file changes`);
+    });
+}
+/**
+ * packages-local/: a repository of its own. Its git history starts here, and
+ * localize's `adopt` installs, builds, links and records it. The app's
+ * dependencies are NOT touched: until the package is published a version range
+ * fails `npm install` (E404 once a lockfile exists), and a `file:` path would
+ * install cleanly for a teammate without the checkout and fail at runtime.
+ */
+function installOwnRepoPackage(name, targetFolder, appRoot, decision) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { remote, push } = decision;
+        const rel = path.relative(appRoot, targetFolder);
+        const pkgPath = path.join(targetFolder, 'package.json');
+        const fail = (message) => {
+            console.warn(chalk.yellow(message));
+            process.exitCode = 1;
+        };
+        if (!git(['init', '--quiet'], targetFolder)) {
+            return fail(`git init failed in ${rel}; the package is scaffolded but not linked.`);
+        }
+        if (remote) {
+            if (!git(['remote', 'add', 'origin', remote], targetFolder)) {
+                return fail(`git remote add origin ${remote} failed in ${rel}; nothing was linked.`);
+            }
+            const pkg = fs.readJsonSync(pkgPath);
+            pkg.repository = { type: 'git', url: repositoryUrlFor(remote) };
+            fs.writeJsonSync(pkgPath, pkg, { spaces: 2 });
+        }
+        // Before adopt, never during it: adopt asserts the app's package.json did not
+        // change while it ran.
+        const appPkgPath = path.join(appRoot, 'package.json');
+        const appPkg = fs.readJsonSync(appPkgPath);
+        if (ensureRelinkPostinstall(appPkg)) {
+            fs.writeJsonSync(appPkgPath, appPkg, { spaces: 2 });
+            log(`Added \`${RELINK_COMMAND}\` to the app's postinstall, so npm install keeps the link`);
+        }
+        const { adoptPackage } = yield import('./commands/localize.js');
+        const { EXIT_WARNED } = yield import('@_linked/localize');
+        // Only the build command matters here: adopt always installs with npm, so
+        // the package-manager half of the plan does not apply.
+        const { buildCommand } = planPackageSetup('', path.join(getScriptDir(), 'launch.js'), process.execPath);
+        const code = yield adoptPackage(name, { appRoot, build: buildCommand });
+        if (code === EXIT_WARNED) {
+            fail('The package is linked, but its initial build failed');
+        }
+        else if (code !== 0) {
+            return fail(`Linking ${name} failed (localize exit ${code}). ${rel} is scaffolded with an uncommitted ` +
+                `git init, and the app's postinstall relinks localized packages. Fix the cause and retry ` +
+                `with: linked localize ${name} --adopt`);
+        }
+        const committed = git(['add', '-A'], targetFolder) &&
+            git(['commit', '--quiet', '-m', `feat: scaffold ${name}`], targetFolder);
+        if (!committed) {
+            fail(`Could not make the first commit in ${rel} (is git's user.name/user.email set?). ` +
+                `The package is linked; commit it yourself.`);
+        }
+        let pushed = false;
+        if (push && committed) {
+            pushed = git(['push', '--quiet', '-u', 'origin', 'HEAD'], targetFolder);
+            if (!pushed)
+                fail(`Could not push to ${remote}. Push it yourself: git push -u origin HEAD`);
+        }
+        const version = fs.readJsonSync(pkgPath).version;
+        log(`Prepared ${name} in ${chalk.magenta(rel)}, in its own git repository` +
+            (remote ? ` (origin ${remote}${pushed ? ', pushed' : ''})` : ' (no remote yet)'), `It is linked into node_modules and recorded in local-packages.json.`, `It is not in the app's dependencies: until it is published a version range would fail npm install.`, `  After publishing: ${chalk.blueBright(`npm install ${name}@^${version}`)}`);
+        if (!remote) {
+            log(`To add a remote later: ${chalk.blueBright('git remote add origin <url>')} in ${rel}, ` +
+                `then ${chalk.blueBright(`linked localize ${name} --adopt`)} to record it.`);
+        }
+    });
+}
+/** Run git with arguments (no shell, so a URL is never re-parsed). Echoes failures. */
+function git(args, cwd) {
+    var _a;
+    const r = spawnSync('git', args, { cwd, encoding: 'utf8' });
+    if (r.status !== 0) {
+        console.warn((r.stderr || r.stdout || String((_a = r.error) !== null && _a !== void 0 ? _a : '')).trim());
+        return false;
     }
-    log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'build'))} from this directory to build once`, `Or ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} to continuously rebuild on file changes`);
-});
+    return true;
+}
 var getNextVersion = function (version) {
     let parts = version.split('.');
     return parts[0] + '.' + parts[1] + '.' + (parseInt(parts[2]) + 1).toString();