@apimatic/cli 1.5.0 → 2.0.0-beta.1

package/lib/commands/sdk/publish.js

@@ -1,86 +1,92 @@
 import { Command, Flags } from '@oclif/core';
 import { DirectoryPath } from '../../types/file/directoryPath.js';
 import { FlagsProvider } from '../../types/flags-provider.js';
-import { CodeGenerationVersion, CodegenOption, Language, Stability } from '../../types/sdk/generate.js';
+import { CodeGenerationVersion, Language, Stability } from '../../types/sdk/generate.js';
+import { StabilityChoice } from '../../types/sdk/stability-choice.js';
+import { ProjectContext } from '../../types/project-context.js';
 import { format, intro, outro } from '../../prompts/format.js';
 import { PublishType } from '../../types/publish-api/publishing-profile-item.js';
 import { TelemetryService } from '../../infrastructure/services/telemetry-service.js';
 import { SdkPublishValidationFailedEvent } from '../../types/events/sdk-publish-validation-failed.js';
 import { SdkPublishInteractiveAction } from '../../actions/sdk/publish/interactive.js';
 import { SdkPublishNonInteractiveAction } from '../../actions/sdk/publish/non-interactive.js';
-class SdkPublish extends Command {
-    constructor() {
-        super(...arguments);
-        this.getConfigDir = () => {
-            return new DirectoryPath(this.config.configDir);
-        };
-    }
+export default class SdkPublish extends Command {
+    static summary = 'Generate and publish an SDK to a package registry and/or source repository';
+    static description = `Generate and publish an SDK using a publishing profile configured in the APIMatic App. Requires an input directory containing the API specification. Run without flags for a step-by-step interactive experience, or pass all required flags for CI/CD automation.`;
+    static cmdTxt = format.cmd('apimatic', 'sdk', 'publish');
+    static flags = {
+        'profile-id': Flags.string({
+            char: 'p',
+            description: 'Id of the publishing profile to use.'
+        }),
+        version: Flags.string({
+            char: 'v',
+            description: 'Semantic version of the SDK to publish (e.g. 1.0.0).'
+        }),
+        ...FlagsProvider.destination('sdk', 'sdk'),
+        language: Flags.string({
+            char: 'l',
+            description: 'Language of the SDK to generate and publish.',
+            options: Object.values(Language).map((l) => l.valueOf())
+        }),
+        ...FlagsProvider.force,
+        ...FlagsProvider.input,
+        'publish-type': Flags.string({
+            description: "One or more publishing targets: 'package' for a package registry, 'sourcecode' for a git repository.",
+            options: [PublishType.PackagePublishing, PublishType.SourceCodePublishing],
+            multiple: true,
+            multipleNonGreedy: true
+        }),
+        'dry-run': Flags.boolean({
+            default: false,
+            description: 'Generate the SDK locally for review without publishing.'
+        }),
+        'codegen-version': Flags.string({
+            description: 'Version of the code generator to use',
+            options: Object.values(CodeGenerationVersion).map((v) => v.valueOf()),
+            default: CodeGenerationVersion.V4
+        }),
+        stability: Flags.string({
+            description: 'Stability level of the generated SDK. Defaults to the level the language offers.',
+            options: Object.values(Stability).map((s) => s.valueOf())
+        })
+    };
+    static examples = [
+        `${SdkPublish.cmdTxt}`,
+        `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'a1b2c3d4e5f6a1b2c3d4e5f6')} ${format.flag('language', 'typescript')} ${format.flag('version', '1.0.0')} ${format.flag('publish-type', PublishType.PackagePublishing)} ${format.flag('publish-type', PublishType.SourceCodePublishing)}`,
+        `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'b2c3d4e5f6a1b2c3d4e5f6a1')} ${format.flag('language', 'csharp')} ${format.flag('version', '2.0.0')} ${format.flag('publish-type', PublishType.SourceCodePublishing)}`,
+        `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'c3d4e5f6a1b2c3d4e5f6a1b2')} ${format.flag('language', 'python')} ${format.flag('version', '1.0.0')} ${format.flag('publish-type', PublishType.PackagePublishing)} ${format.flag('dry-run')}`
+    ];
     async run() {
-        var _a;
-        const { flags: { 'profile-id': profileId, version, destination, language, force, input, 'publish-type': publishType, 'dry-run': dryRun, 'codegen-version': codegenVersion, stability, 'update-plugin-config': updatePluginConfig }, metadata } = await this.parse(SdkPublish);
+        const { flags: { 'profile-id': profileId, version, destination, language, force, input, 'publish-type': publishType, 'dry-run': dryRun, stability, 'codegen-version': codegenVersion } } = await this.parse(SdkPublish);
         const publishTypes = [...new Set(publishType)];
         const interactive = this.argv.length === 0;
         const commandMetadata = {
             commandName: SdkPublish.id,
             shell: this.config.shell
         };
-        const workingDirectory = DirectoryPath.createInput(input);
-        const buildDirectory = input ? new DirectoryPath(input, 'src') : workingDirectory.join('src');
-        const sdkDirectory = destination ? new DirectoryPath(destination) : workingDirectory.join('sdk');
+        const project = ProjectContext.at(input);
         const configDir = this.getConfigDir();
         const telemetryService = new TelemetryService(configDir);
         const onPublishSdkError = interactive
             ? (errorMessage) => telemetryService.trackEvent(new SdkPublishValidationFailedEvent(errorMessage, SdkPublish.id, { interactive: true }), commandMetadata.shell)
-            : (errorMessage) => telemetryService.trackEvent(new SdkPublishValidationFailedEvent(errorMessage, SdkPublish.id, Object.assign(Object.assign({ 'profile-id': profileId, version,
-                language }, (force && { force })), { 'publish-type': publishTypes, 'codegen-version': codegenVersion, stability })), commandMetadata.shell);
+            : (errorMessage) => telemetryService.trackEvent(new SdkPublishValidationFailedEvent(errorMessage, SdkPublish.id, {
+                'profile-id': profileId,
+                version,
+                language,
+                ...(force && { force }),
+                'publish-type': publishTypes,
+                stability,
+                'codegen-version': codegenVersion
+            }), commandMetadata.shell);
         intro('Publish SDK');
         const result = interactive
-            ? await new SdkPublishInteractiveAction(configDir, commandMetadata).execute(workingDirectory, onPublishSdkError)
-            : await new SdkPublishNonInteractiveAction(configDir, commandMetadata).execute(buildDirectory, sdkDirectory, language, publishTypes, force, dryRun, CodegenOption.create(codegenVersion, stability), ((_a = metadata.flags.stability) === null || _a === void 0 ? void 0 : _a.setFromDefault) !== true, updatePluginConfig, onPublishSdkError, profileId, version);
+            ? await new SdkPublishInteractiveAction(configDir, commandMetadata).execute(DirectoryPath.createInput(input), onPublishSdkError)
+            : await new SdkPublishNonInteractiveAction(configDir, commandMetadata).execute(project, project.sdkDirectory(destination), language, publishTypes, force, dryRun, StabilityChoice.for(language, stability), onPublishSdkError, profileId, version);
         outro(result);
     }
+    getConfigDir = () => {
+        return new DirectoryPath(this.config.configDir);
+    };
 }
-SdkPublish.summary = 'Generate and publish an SDK to a package registry and/or source repository';
-SdkPublish.description = `Generate and publish an SDK using a publishing profile configured in the APIMatic App. Requires an input directory containing the API specification. Run without flags for a step-by-step interactive experience, or pass all required flags for CI/CD automation.`;
-SdkPublish.cmdTxt = format.cmd('apimatic', 'sdk', 'publish');
-SdkPublish.flags = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ 'profile-id': Flags.string({
-        char: 'p',
-        description: 'Id of the publishing profile to use.'
-    }), version: Flags.string({
-        char: 'v',
-        description: 'Semantic version of the SDK to publish (e.g. 1.0.0).'
-    }) }, FlagsProvider.destination('sdk', 'sdk')), { language: Flags.string({
-        char: 'l',
-        description: 'Language of the SDK to generate and publish.',
-        options: Object.values(Language)
-            .filter((l) => l !== Language.GO)
-            .map((l) => l.valueOf())
-    }) }), FlagsProvider.force), FlagsProvider.input), { 'publish-type': Flags.string({
-        description: "One or more publishing targets: 'package' for a package registry, 'sourcecode' for a git repository.",
-        options: [PublishType.PackagePublishing, PublishType.SourceCodePublishing],
-        multiple: true,
-        multipleNonGreedy: true
-    }), 'dry-run': Flags.boolean({
-        default: false,
-        description: 'Generate the SDK locally for review without publishing.'
-    }), 'codegen-version': Flags.string({
-        description: 'Version of the code generator to use',
-        options: Object.values(CodeGenerationVersion).map((v) => v.valueOf()),
-        default: CodeGenerationVersion.V3
-    }), 'stability': Flags.string({
-        description: 'Stability level of the generated SDK',
-        options: Object.values(Stability).map((s) => s.valueOf()),
-        default: Stability.STABLE
-    }), 'update-plugin-config': Flags.boolean({
-        default: false,
-        description: "Record the published SDK in 'plugin-config.json', creating the file if it does not exist. Interactive runs are asked instead."
-    }) });
-SdkPublish.examples = [
-    `${SdkPublish.cmdTxt}`,
-    `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'a1b2c3d4e5f6a1b2c3d4e5f6')} ${format.flag('language', 'typescript')} ${format.flag('version', '1.0.0')} ${format.flag('publish-type', PublishType.PackagePublishing)} ${format.flag('publish-type', PublishType.SourceCodePublishing)}`,
-    `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'b2c3d4e5f6a1b2c3d4e5f6a1')} ${format.flag('language', 'java')} ${format.flag('version', '2.0.0')} ${format.flag('publish-type', PublishType.SourceCodePublishing)}`,
-    `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'c3d4e5f6a1b2c3d4e5f6a1b2')} ${format.flag('language', 'python')} ${format.flag('version', '1.0.0')} ${format.flag('publish-type', PublishType.PackagePublishing)} ${format.flag('dry-run')}`,
-    `${SdkPublish.cmdTxt} ${format.flag('profile-id', 'd4e5f6a1b2c3d4e5f6a1b2c3')} ${format.flag('language', 'csharp')} ${format.flag('version', '1.0.0')} ${format.flag('publish-type', PublishType.PackagePublishing)} ${format.flag('codegen-version', 'v4')} ${format.flag('stability', 'beta')}`
-];
-export default SdkPublish;
 //# sourceMappingURL=publish.js.map

package/lib/commands/sdk/publish.js.map

@@ -1 +1 @@
-{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/commands/sdk/publish.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/commands/sdk/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,+BAA+B,EAAE,MAAM,qDAAqD,CAAC;AACtG,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAE9F,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAU,OAAO,GAAG,4EAA4E,CAAC;IAEvG,MAAM,CAAU,WAAW,GAAG,oQAAoQ,CAAC;IAEnS,MAAM,CAAU,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAElE,MAAM,CAAC,KAAK,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sCAAsC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sDAAsD;SACpE,CAAC;QACF,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QAC1C,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,8CAA8C;YAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACzD,CAAC;QACF,GAAG,aAAa,CAAC,KAAK;QACtB,GAAG,aAAa,CAAC,KAAK;QACtB,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC;YAC3B,WAAW,EACT,sGAAsG;YACxG,OAAO,EAAE,CAAC,WAAW,CAAC,iBAAiB,EAAE,WAAW,CAAC,oBAAoB,CAAC;YAC1E,QAAQ,EAAE,IAAI;YACd,iBAAiB,EAAE,IAAI;SACxB,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,yDAAyD;SACvE,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC9B,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,OAAO,EAAE,qBAAqB,CAAC,EAAE;SAClC,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,kFAAkF;YAC/F,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC1D,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,QAAQ,GAAG;QAChB,GAAG,UAAU,CAAC,MAAM,EAAE;QACtB,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,IAAI,MAAM,CAAC,IAAI,CAC1F,UAAU,EACV,YAAY,CACb,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,IAAI,CAC/G,cAAc,EACd,WAAW,CAAC,oBAAoB,CACjC,EAAE;QACH,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,IAAI,MAAM,CAAC,IAAI,CAC1F,UAAU,EACV,QAAQ,CACT,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,oBAAoB,CAAC,EAAE;QACvG,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,0BAA0B,CAAC,IAAI,MAAM,CAAC,IAAI,CAC1F,UAAU,EACV,QAAQ,CACT,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,IAAI,CAC/G,SAAS,CACV,EAAE;KACJ,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EACJ,KAAK,EAAE,EACL,YAAY,EAAE,SAAS,EACvB,OAAO,EACP,WAAW,EACX,QAAQ,EACR,KAAK,EACL,KAAK,EACL,cAAc,EAAE,WAAW,EAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EACT,iBAAiB,EAAE,cAAc,EAClC,EACF,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAEjC,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAkB,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;QAC3C,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,UAAU,CAAC,EAAE;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,iBAAiB,GAAG,WAAW;YACnC,CAAC,CAAC,CAAC,YAAoB,EAAE,EAAE,CACvB,gBAAgB,CAAC,UAAU,CACzB,IAAI,+BAA+B,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EACvF,eAAe,CAAC,KAAK,CACtB;YACL,CAAC,CAAC,CAAC,YAAoB,EAAE,EAAE,CACvB,gBAAgB,CAAC,UAAU,CACzB,IAAI,+BAA+B,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE;gBAC/D,YAAY,EAAE,SAAS;gBACvB,OAAO;gBACP,QAAQ;gBACR,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;gBACvB,cAAc,EAAE,YAAY;gBAC5B,SAAS;gBACT,iBAAiB,EAAE,cAAc;aAClC,CAAC,EACF,eAAe,CAAC,KAAK,CACtB,CAAC;QAER,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,WAAW;YACxB,CAAC,CAAC,MAAM,IAAI,2BAA2B,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,OAAO,CACvE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,EAChC,iBAAiB,CAClB;YACH,CAAC,CAAC,MAAM,IAAI,8BAA8B,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,OAAO,CAC1E,OAAO,EACP,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,EACjC,QAAoB,EACpB,YAAY,EACZ,KAAK,EACL,MAAM,EACN,eAAe,CAAC,GAAG,CAAC,QAAoB,EAAE,SAAS,CAAC,EACpD,iBAAiB,EACjB,SAAS,EACT,OAAO,CACR,CAAC;QACN,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEgB,YAAY,GAAG,GAAG,EAAE;QACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC;CACH"}

package/lib/hooks/node-version.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from '@oclif/core';
+declare const hook: Hook.Init;
+export default hook;

package/lib/hooks/node-version.js

@@ -0,0 +1,12 @@
+import semver from 'semver';
+// npm and pnpm only warn when the installed Node falls outside `engines.node`, so without
+// this the install succeeds and the failure surfaces later as an unrelated-looking crash.
+const hook = async function () {
+    const supported = this.config.pjson.engines?.node;
+    if (supported !== undefined && !semver.satisfies(process.versions.node, supported)) {
+        this.error(`The APIMatic CLI needs Node ${supported}; this is Node ${process.versions.node}. ` +
+            'Upgrade Node from https://nodejs.org/en/download and reinstall the CLI.', { exit: 1 });
+    }
+};
+export default hook;
+//# sourceMappingURL=node-version.js.map

package/lib/hooks/node-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.js","sourceRoot":"","sources":["../../src/hooks/node-version.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,0FAA0F;AAC1F,0FAA0F;AAC1F,MAAM,IAAI,GAAc,KAAK;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;QACnF,IAAI,CAAC,KAAK,CACR,+BAA+B,SAAS,kBAAkB,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI;YACjF,yEAAyE,EAC3E,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/lib/hooks/not-found.js

@@ -3,7 +3,6 @@ import { toConfiguredId } from "@oclif/core";
 import { cyan, yellow } from "ansis";
 import utils from "./utils.js";
 const hook = async function (opts) {
-    var _a;
     const hiddenCommandIds = new Set(opts.config.commands.filter((c) => c.hidden).map((c) => c.id));
     const commandIDs = [...opts.config.commandIDs, ...opts.config.commands.flatMap((c) => c.aliases)].filter((c) => !hiddenCommandIds.has(c));
     if (commandIDs.length === 0)
@@ -32,12 +31,12 @@ const hook = async function (opts) {
     try {
         response = await utils.getConfirmation(readableSuggestion);
     }
-    catch (_b) {
+    catch {
         response = false;
     }
     if (response) {
         const confirmedSuggestion = suggestion;
-        let argv = (_a = opts.argv) !== null && _a !== void 0 ? _a : [];
+        let argv = opts.argv ?? [];
         if (confirmedSuggestion.startsWith("help:")) {
             argv = confirmedSuggestion.split(":").slice(1);
             suggestion = "help";

package/lib/hooks/not-found.js.map

@@ -1 +1 @@
-{"version":3,"file":"not-found.js","sourceRoot":"","sources":["../../src/hooks/not-found.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,EAAQ,cAAc,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,IAAI,GAAyB,KAAK,WAAW,IAAI;;IACrD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhG,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CACtG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAChC,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEpC,IAAI,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,GAAG,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,UAAyB,CAAC;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7B,UAAU,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvF,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC;IAEzE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oCAAoC,EAAE;YACxE,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,kBAAmB,CAAC,CAAC;IAC9D,CAAC;IAAC,WAAM,CAAC;QACP,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,mBAAmB,GAAG,UAAW,CAAC;QACxC,IAAI,IAAI,GAAG,MAAA,IAAI,CAAC,IAAI,mCAAI,EAAE,CAAC;QAE3B,IAAI,mBAAmB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/C,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oCAAoC,EAAE;QACxE,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;AAEL,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"not-found.js","sourceRoot":"","sources":["../../src/hooks/not-found.ts"],"names":[],"mappings":"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"}

package/lib/hooks/utils.d.ts

@@ -1,5 +1,7 @@
+declare const getConfirmation: (suggestion: string) => Promise<boolean>;
+declare const closest: (target: string, possibilities: string[]) => string | null;
 declare const _default: {
-    closest: (target: string, possibilities: string[]) => string | null;
-    getConfirmation: (suggestion: string) => Promise<boolean>;
+    closest: typeof closest;
+    getConfirmation: typeof getConfirmation;
 };
 export default _default;

package/lib/hooks/utils.js

@@ -25,9 +25,9 @@ const getConfirmation = async (suggestion) => {
         };
         const timeout = setTimeout(() => {
             finish(false);
-        }, 10000);
+        }, 10_000);
         rl.question(question, (answer) => {
-            const a = (answer !== null && answer !== void 0 ? answer : '').trim().toLowerCase();
+            const a = (answer ?? '').trim().toLowerCase();
             finish(a === '' || a === 'y' || a === 'yes');
         });
     });

package/lib/hooks/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/hooks/utils.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,eAAe,GAAG,KAAK,EAAE,UAAkB,EAAoB,EAAE;IACrE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;IAEnF,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,MAAe,EAAE,EAAE;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,KAAM,CAAC,CAAC;QAEX,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,aAAuB,EAAiB,EAAE;IACzE,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,YAAY,GAAG,QAAQ,CAAC;IAE5B,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,YAAY,GAAG,QAAQ,CAAC;YACxB,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,eAAe;IACb,OAAO;IACP,eAAe;CAChB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/hooks/utils.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,eAAe,GAAG,KAAK,EAAE,UAAkB,EAAoB,EAAE;IACrE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;IAEnF,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,MAAe,EAAE,EAAE;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,aAAuB,EAAiB,EAAE;IACzE,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,YAAY,GAAG,QAAQ,CAAC;IAE5B,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,YAAY,GAAG,QAAQ,CAAC;YACxB,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,eAAe;IACb,OAAO;IACP,eAAe;CAChB,CAAC"}

package/lib/infrastructure/env-info.d.ts

@@ -1,3 +1,4 @@
+import { DirectoryPath } from '../types/file/directoryPath.js';
 declare class EnvInfo {
     private static cachedCliVersion;
     private static cachedUserAgent;
@@ -6,6 +7,8 @@ declare class EnvInfo {
     private static cachedPublishingBaseUrl;
     getUserAgent(shell: string): string;
     getCLIVersion(): string;
+    /** Where the CLI is installed: the directory holding its `package.json` and what it ships. */
+    packageRoot(): DirectoryPath;
     getBaseUrl(): string | undefined;
     getAuthBaseUrl(): string | undefined;
     getPublishingBaseUrl(): string | undefined;

package/lib/infrastructure/env-info.js

@@ -2,7 +2,13 @@ import os from 'os';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import fs from 'fs-extra';
+import { DirectoryPath } from '../types/file/directoryPath.js';
 class EnvInfo {
+    static cachedCliVersion = null;
+    static cachedUserAgent = null;
+    static cachedBaseUrl;
+    static cachedAuthBaseUrl;
+    static cachedPublishingBaseUrl;
     getUserAgent(shell) {
         if (!EnvInfo.cachedUserAgent) {
             const osInfo = `${os.platform()} ${os.release()}`;
@@ -17,19 +23,22 @@ class EnvInfo {
             return EnvInfo.cachedCliVersion;
         }
         try {
-            const __filename = fileURLToPath(import.meta.url);
-            const __dirname = dirname(__filename);
-            const pkgPath = join(__dirname, '../../package.json');
+            const pkgPath = join(this.packageRoot().toString(), 'package.json');
             const pkgJson = fs.readFileSync(pkgPath, 'utf-8');
             const pkg = JSON.parse(pkgJson);
             const version = pkg.version || 'unknown';
             EnvInfo.cachedCliVersion = version;
             return version;
         }
-        catch (_a) {
+        catch {
             return 'unknown';
         }
     }
+    /** Where the CLI is installed: the directory holding its `package.json` and what it ships. */
+    packageRoot() {
+        // This file sits two levels down, in `lib/infrastructure/` or, under tsx, `src/infrastructure/`.
+        return new DirectoryPath(join(dirname(fileURLToPath(import.meta.url)), '..', '..'));
+    }
     getBaseUrl() {
         if (EnvInfo.cachedBaseUrl) {
             return EnvInfo.cachedBaseUrl;
@@ -63,7 +72,5 @@ class EnvInfo {
         return EnvInfo.cachedPublishingBaseUrl;
     }
 }
-EnvInfo.cachedCliVersion = null;
-EnvInfo.cachedUserAgent = null;
 export const envInfo = new EnvInfo();
 //# sourceMappingURL=env-info.js.map

package/lib/infrastructure/env-info.js.map

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

package/lib/infrastructure/file-service.d.ts

@@ -1,34 +1,61 @@
-import fs from "fs";
-import { FilePath } from "../types/file/filePath.js";
-import { DirectoryPath } from "../types/file/directoryPath.js";
-import { Directory } from "../types/file/directory.js";
-import { FileName } from "../types/file/fileName.js";
+import fs from 'node:fs';
+import { FilePath } from '../types/file/filePath.js';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { Directory } from '../types/file/directory.js';
+import { FileName } from '../types/file/fileName.js';
 export declare class FileService {
     fileExists(file: FilePath): Promise<boolean>;
     fileExistsSync(file: FilePath): boolean;
     directoryExists(dir: DirectoryPath): Promise<boolean>;
     directoryExistsSync(dir: DirectoryPath): boolean;
+    /**
+     * Hidden entries do not count: scaffolding into a directory that holds only a `.git` is
+     * the normal way to start a project, so the prompts say "apart from hidden files".
+     */
     directoryEmpty(dir: DirectoryPath): Promise<boolean>;
     cleanDirectory(dir: DirectoryPath): Promise<void>;
     cleanDirectoryExcluding(dir: DirectoryPath, excludeNames: FileName[]): Promise<void>;
     createDirectoryIfNotExists(dir: DirectoryPath): Promise<void>;
+    /**
+     * The whole tree beneath `directoryPath`. A link to nothing is left out rather than failing
+     * the walk, which is what a glob over the same tree would do with it. Any other failure
+     * still throws: a file that cannot be examined is a file the caller would otherwise never
+     * hear about, and a missing specification is worse than a failed build.
+     */
     getDirectory(directoryPath: DirectoryPath): Promise<Directory>;
+    /**
+     * The names of the files directly inside `dir`. `getDirectory` walks the whole tree and
+     * stats every entry, which is wasted work when only the top level is wanted, and throws on
+     * an entry it cannot stat -- out of callers that have no way to report it.
+     */
+    getFileNames(dir: DirectoryPath): Promise<FileName[]>;
     getSubDirectoriesPaths(dir: DirectoryPath): Promise<DirectoryPath[]>;
+    spelledOnDisk(root: DirectoryPath, file: FilePath): Promise<FilePath | null>;
+    private listEntries;
     copyDirectoryContents(source: DirectoryPath, destination: DirectoryPath): Promise<void>;
+    moveDirectoryContents(source: DirectoryPath, destination: DirectoryPath): Promise<void>;
+    private forEachEntry;
     copyDirectoryExcluding(source: DirectoryPath, destination: DirectoryPath, excludeNames: FileName[]): Promise<void>;
     deleteFile(filePath: FilePath): Promise<void>;
     deleteDirectory(dirPath: DirectoryPath): Promise<void>;
     pollDeleteDirectory(dirPath: DirectoryPath, onDeleteFailurePersists: () => void): Promise<void>;
-    getRelativePath(filePath: FilePath, basePath: DirectoryPath): string;
     getStream(filePath: FilePath): Promise<fs.ReadStream>;
     getContents(filePath: FilePath): Promise<string>;
     writeFile(filePath: FilePath, stream: NodeJS.ReadableStream): Promise<void>;
     ensurePathExists(filePath: FilePath): Promise<void>;
     writeContents(filePath: FilePath, contents: string): Promise<void>;
+    /**
+     * Writes beside the target and renames over it, so a fault mid-write leaves the target as it
+     * was rather than half-written. The temporary file goes on a failure for the same reason: a
+     * write that did not happen must leave nothing behind.
+     */
+    replaceContents(filePath: FilePath, contents: string): Promise<void>;
+    /** Renamed over, so a watcher never reads it half-written, and skipped when unchanged, so nothing reloads. */
+    replaceContentsIfChanged(filePath: FilePath, contents: string): Promise<boolean>;
     copy(source: FilePath, destination: FilePath): Promise<void>;
+    /** Skipped when the destination has the source's size and time, to the millisecond a copy keeps. */
+    copyIfChanged(source: FilePath, destination: FilePath): Promise<boolean>;
     copyToDir(source: FilePath, destination: DirectoryPath): Promise<void>;
-    readFile(filePath: FilePath): Promise<string>;
     isZipFile(filePath: FilePath): Promise<boolean>;
-    hasContent(file: FilePath, content: string): Promise<boolean>;
     getAvailableDirectoryPath(currentPath: DirectoryPath): Promise<DirectoryPath>;
 }