@signageos/cli 2.6.1 → 2.7.0

package/README.md

@@ -334,6 +334,60 @@ Upload custom script to the signageOS platform.
 | --organization-uid *(required)* | Organization UID             | STDIN          |
 | --script-path *(optional)*      | Path to script file          | ${PWD}         |
 
+### Plugin
+```bash
+sos plugin --help
+```
+
+#### Plugin Generate
+```bash
+sos plugin generate
+```
+Generate a new plugin project with boilerplate code.
+
+| Argument                    | Description                     | Default value  |
+|-----------------------------|---------------------------------|----------------|
+| --name *(required)*         | Name for the plugin             | STDIN          |
+| --target-dir *(optional)*   | Generate plugin to directory    | ${PWD}/${name} |
+
+#### Plugin Upload
+```bash
+sos plugin upload
+```
+Upload plugin to the signageOS platform.
+
+| Argument                        | Description                  | Default value  |
+|---------------------------------|------------------------------|----------------|
+| --organization-uid *(required)* | Organization UID             | STDIN          |
+| --script-path *(optional)*      | Path to script file          | ${PWD}         |
+
+### Runner
+```bash
+sos runner --help
+```
+
+#### Runner Generate
+```bash
+sos runner generate
+```
+Generate a new runner project with boilerplate code.
+
+| Argument                    | Description                     | Default value  |
+|-----------------------------|---------------------------------|----------------|
+| --name *(required)*         | Name for the runner             | STDIN          |
+| --target-dir *(optional)*   | Generate runner to directory    | ${PWD}/${name} |
+
+#### Runner Upload
+```bash
+sos runner upload
+```
+Upload runner to the signageOS platform.
+
+| Argument                        | Description                  | Default value  |
+|---------------------------------|------------------------------|----------------|
+| --organization-uid *(required)* | Organization UID             | STDIN          |
+| --script-path *(optional)*      | Path to script file          | ${PWD}         |
+
 ## Debugging
 
 To enable debugging for the `@signageos/cli:Applet:Upload:appletUploadFacade` module, use:

package/dist/Applet/Build/appletBuildCommand.d.ts

@@ -17,7 +17,7 @@ export declare const OPTION_LIST: readonly [{
  * The build process compiles and bundles the applet code, assets, and dependencies
  * into a zip archive ready for upload to the signageOS platform.
  *
- * @group Development:2
+ * @group Development:12
  *
  * @example
  * ```bash
@@ -32,7 +32,6 @@ export declare const OPTION_LIST: readonly [{
  * ```
  *
  * @throws {Error} When applet path is invalid or build process fails
- *
  * @throws {Error} When organization or applet cannot be found
  * @throws {Error} When package.json is missing or invalid
  *

package/dist/Applet/Build/appletBuildCommand.js

@@ -28,7 +28,7 @@ exports.OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, orga
  * The build process compiles and bundles the applet code, assets, and dependencies
  * into a zip archive ready for upload to the signageOS platform.
  *
- * @group Development:2
+ * @group Development:12
  *
  * @example
  * ```bash
@@ -43,7 +43,6 @@ exports.OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, orga
  * ```
  *
  * @throws {Error} When applet path is invalid or build process fails
- *
  * @throws {Error} When organization or applet cannot be found
  * @throws {Error} When package.json is missing or invalid
  *

package/dist/Applet/Generate/appletGenerateCommand.d.ts

@@ -16,7 +16,7 @@ declare const OPTION_LIST: ({
  * (webpack/rspack), various package managers (npm/pnpm/yarn/bun), and includes
  * git repository initialization.
  *
- * @group Development:1
+ * @group Development:11
  *
  * @example
  * ```bash

package/dist/Applet/Generate/appletGenerateCommand.js

@@ -94,7 +94,7 @@ const DEPENDENCIES = {
         '@signageos/front-applet@latest',
         '@signageos/front-display@latest',
         '@signageos/webpack-plugin@latest',
-        'es-check@9',
+        'es-check@9.4.0',
         /* required for transpilation to ES5 */
         'css-loader@7',
         'style-loader@4',
@@ -116,7 +116,7 @@ const RUNSCRIPTS = {
         prepare: 'npm run clean && npm run build',
         upload: 'sos applet upload',
         clean: 'npx rimraf dist',
-        escheck: 'npx es-check --module es5 dist/**/*.js',
+        escheck: 'npx es-check@9.4.0 --module es5 "./dist/**/*.js"',
         postbuild: 'npm run escheck',
     },
     webpack: {
@@ -145,7 +145,7 @@ const importFileAsString = (relativePath) => {
  * (webpack/rspack), various package managers (npm/pnpm/yarn/bun), and includes
  * git repository initialization.
  *
- * @group Development:1
+ * @group Development:11
  *
  * @example
  * ```bash
@@ -304,7 +304,7 @@ exports.appletGenerate = (0, commandDefinition_1.createCommandDefinition)({
                         prepare: 'pnpm run clean && pnpm run build',
                         upload: 'sos applet upload',
                         clean: 'pnpx rimraf dist',
-                        escheck: 'pnpx es-check --module es5 "./dist/**/*.js"',
+                        escheck: 'pnpx es-check@9.4.0 --module es5 "./dist/**/*.js"',
                         postbuild: 'pnpm run escheck',
                     };
                     break;
@@ -314,7 +314,7 @@ exports.appletGenerate = (0, commandDefinition_1.createCommandDefinition)({
                         prepare: 'yarn run clean && yarn run build',
                         upload: 'sos applet upload',
                         clean: 'npx rimraf dist',
-                        escheck: 'npx es-check --module es5 "./dist/**/*.js"',
+                        escheck: 'npx es-check@9.4.0 --module es5 "./dist/**/*.js"',
                         postbuild: 'npm run escheck',
                     };
                     break;
@@ -324,7 +324,7 @@ exports.appletGenerate = (0, commandDefinition_1.createCommandDefinition)({
                         prepare: 'bun run clean && bun run build',
                         upload: 'sos applet upload',
                         clean: 'bunx rimraf dist',
-                        escheck: 'bunx es-check --module es5 "./dist/**/*.js"',
+                        escheck: 'bunx es-check@9.4.0 --module es5 "./dist/**/*.js"',
                         postbuild: 'bun run escheck',
                     };
                     break;

package/dist/Applet/Start/appletStartCommand.d.ts

@@ -53,7 +53,7 @@ export declare const OPTION_LIST: readonly [{
  * to preview their applets in a browser-based emulator. Supports both local development
  * and device connection for testing on actual signageOS devices.
  *
- * @group Development:3
+ * @group Development:13
  *
  * @example
  * ```bash

package/dist/Applet/Start/appletStartCommand.js

@@ -49,7 +49,7 @@ exports.OPTION_LIST = [
  * to preview their applets in a browser-based emulator. Supports both local development
  * and device connection for testing on actual signageOS devices.
  *
- * @group Development:3
+ * @group Development:13
  *
  * @example
  * ```bash

package/dist/Applet/Test/Upload/appletTestRunCommand.d.ts

@@ -30,7 +30,7 @@ declare const OPTION_LIST: readonly [{
  * triggers test execution and provides real-time feedback on test progress and results.
  * Tests can be run on specific devices or across multiple devices for comprehensive testing.
  *
- * @group Development:2
+ * @group Development:142
  *
  * @example
  * ```bash

package/dist/Applet/Test/Upload/appletTestRunCommand.js

@@ -46,7 +46,7 @@ const OPTION_LIST = [
  * triggers test execution and provides real-time feedback on test progress and results.
  * Tests can be run on specific devices or across multiple devices for comprehensive testing.
  *
- * @group Development:2
+ * @group Development:142
  *
  * @example
  * ```bash

package/dist/Applet/Test/Upload/appletTestUploadCommand.d.ts

@@ -26,7 +26,7 @@ declare const OPTION_LIST: readonly [{
  * the platform for automated testing. Supports incremental uploads with
  * change detection and confirmation prompts.
  *
- * @group Development:1
+ * @group Development:141
  *
  * @example
  * ```bash

package/dist/Applet/Test/Upload/appletTestUploadCommand.js

@@ -44,7 +44,7 @@ const OPTION_LIST = [
  * the platform for automated testing. Supports incremental uploads with
  * change detection and confirmation prompts.
  *
- * @group Development:1
+ * @group Development:141
  *
  * @example
  * ```bash

package/dist/Applet/Test/appletTestCommand.d.ts

@@ -2,7 +2,7 @@
  * Provides commands for testing applets on the signageOS platform, including
  * uploading test configurations and running remote tests on actual devices.
  *
- * @group Development:4
+ * @group Development:14
  *
  * @example
  * ```bash

package/dist/Applet/Test/appletTestCommand.js

@@ -17,7 +17,7 @@ const appletTestUploadCommand_1 = require("./Upload/appletTestUploadCommand");
  * Provides commands for testing applets on the signageOS platform, including
  * uploading test configurations and running remote tests on actual devices.
  *
- * @group Development:4
+ * @group Development:14
  *
  * @example
  * ```bash

package/dist/Applet/Upload/appletUploadCommand.d.ts

@@ -40,7 +40,7 @@ export declare const OPTION_LIST: readonly [{
  * The upload process validates package.json requirements, creates or updates applet versions,
  * and handles file packaging according to .sosignore, .npmignore, and .gitignore rules.
  *
- * @group Development:5
+ * @group Development:15
  *
  * @example
  * ```bash

package/dist/Applet/Upload/appletUploadCommand.js

@@ -61,7 +61,7 @@ exports.OPTION_LIST = [
  * The upload process validates package.json requirements, creates or updates applet versions,
  * and handles file packaging according to .sosignore, .npmignore, and .gitignore rules.
  *
- * @group Development:5
+ * @group Development:15
  *
  * @example
  * ```bash

package/dist/Applet/appletCommand.d.ts

@@ -2,7 +2,7 @@
  * Provides comprehensive commands for the complete applet development lifecycle including
  * project generation, development, building, testing, uploading, and deployment to signageOS devices.
  *
- * @group Development:2
+ * @group Development:100
  *
  * @subcommands
  * - `generate` - Create a new applet project with boilerplate code

package/dist/Applet/appletCommand.js

@@ -20,7 +20,7 @@ const appletBuildCommand_1 = require("./Build/appletBuildCommand");
  * Provides comprehensive commands for the complete applet development lifecycle including
  * project generation, development, building, testing, uploading, and deployment to signageOS devices.
  *
- * @group Development:2
+ * @group Development:100
  *
  * @subcommands
  * - `generate` - Create a new applet project with boilerplate code

package/dist/Applet/appletFacade.d.ts

@@ -14,5 +14,5 @@ export declare const APPLET_UID_OPTION: {
 };
 export declare function getApplet(directoryPath: string): Promise<IApplet>;
 export declare function getAppletVersion(directoryPath: string): Promise<string>;
-export declare function getAppletUid(restApi: RestApi, options: CommandLineOptions<[typeof APPLET_UID_OPTION]>): Promise<string>;
-export declare function getAppletVersionFromApi(restApi: RestApi, appletUid: string): Promise<string>;
+export declare function getAppletUid(restApi: RestApi, options: CommandLineOptions<[typeof APPLET_UID_OPTION]>, skipConfirmation?: boolean): Promise<string>;
+export declare function getAppletVersionFromApi(restApi: RestApi, appletUid: string, skipConfirmation?: boolean): Promise<string>;

package/dist/Applet/appletFacade.js

@@ -89,8 +89,8 @@ function getAppletVersion(directoryPath) {
         return applet.version;
     });
 }
-function getAppletUid(restApi, options) {
-    return __awaiter(this, void 0, void 0, function* () {
+function getAppletUid(restApi_1, options_1) {
+    return __awaiter(this, arguments, void 0, function* (restApi, options, skipConfirmation = false) {
         var _a;
         const currentDirectory = process.cwd();
         const currentApplet = yield getApplet(currentDirectory);
@@ -102,16 +102,21 @@ function getAppletUid(restApi, options) {
                 appletUid = undefined;
             }
             else if (candidatesOfApplets.length > 1) {
-                const response = yield (0, prompts_1.default)({
-                    type: 'autocomplete',
-                    name: 'appletUid',
-                    message: `Select applet to use`,
-                    choices: candidatesOfApplets.map((applet) => ({
-                        title: `${applet.name} (${applet.uid})`,
-                        value: applet.uid,
-                    })),
-                });
-                appletUid = response.appletUid;
+                if (skipConfirmation) {
+                    throw new appletErrors_1.AppletDoesNotExistError(`Multiple applets found with name "${currentApplet.name}". Please specify --applet-uid argument to avoid ambiguity.`);
+                }
+                else {
+                    const response = yield (0, prompts_1.default)({
+                        type: 'autocomplete',
+                        name: 'appletUid',
+                        message: `Select applet to use`,
+                        choices: candidatesOfApplets.map((applet) => ({
+                            title: `${applet.name} (${applet.uid})`,
+                            value: applet.uid,
+                        })),
+                    });
+                    appletUid = response.appletUid;
+                }
             }
             else {
                 appletUid = (_a = candidatesOfApplets[0]) === null || _a === void 0 ? void 0 : _a.uid;
@@ -123,14 +128,17 @@ function getAppletUid(restApi, options) {
         return appletUid;
     });
 }
-function getAppletVersionFromApi(restApi, appletUid) {
-    return __awaiter(this, void 0, void 0, function* () {
+function getAppletVersionFromApi(restApi_1, appletUid_1) {
+    return __awaiter(this, arguments, void 0, function* (restApi, appletUid, skipConfirmation = false) {
         var _a;
         let appletVersion;
         const appletVersions = yield restApi.applet.version.list(appletUid);
         if (appletVersions.length === 1 && ((_a = appletVersions[0]) === null || _a === void 0 ? void 0 : _a.version)) {
             appletVersion = appletVersions[0].version;
         }
+        else if (skipConfirmation) {
+            throw new Error('Multiple applet versions found. Please specify the exact version or use interactive mode to select.');
+        }
         else {
             const response = yield (0, prompts_1.default)({
                 type: 'autocomplete',

package/dist/Auth/loginCommand.d.ts

@@ -7,20 +7,14 @@ declare const OPTION_LIST: readonly [{
 /**
  * To explicitly enable auth0 authentication add flag --auth0-enabled to command line options
  * { _unknown: [ '--auth0-enabled' ], command: [ 'login' ] }
- *
- * To explicitly enable legacy authentication add flag --legacy-enabled to command line options
- * { _unknown: [ '--legacy-enabled' ], command: [ 'login' ] }
- *
- * Only one from auth0 and legacy authentication can be active at the moment
  */
-export declare const getIsAuth0OrLegacyEnabled: (options: any) => {
+export declare const getIsAuth0Enabled: (options: any) => {
     isAuth0Enabled?: boolean;
-    isLegacyEnabled?: boolean;
 };
 /**
  * Handles user authentication using username/email and password credentials.
- * Supports both Auth0 and legacy authentication methods. Stores credentials
- * securely in the ~/.sosrc configuration file for subsequent CLI operations.
+ * Supports Auth0 authentication method. Stores credentials securely in the
+ * ~/.sosrc configuration file for subsequent CLI operations.
  *
  * @group Authentication:1
  *
@@ -34,7 +28,6 @@ export declare const getIsAuth0OrLegacyEnabled: (options: any) => {
  * ```
  *
  * @throws {Error} When username is missing and not provided interactively
- * @throws {Error} When both Auth0 and legacy authentication flags are specified
  *
  * @since 0.3.0
  */

package/dist/Auth/loginCommand.js

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.login = exports.getIsAuth0OrLegacyEnabled = void 0;
+exports.login = exports.getIsAuth0Enabled = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const debug_1 = __importDefault(require("debug"));
@@ -62,31 +62,20 @@ const OPTION_LIST = [{ name: 'username', type: String, description: `Username or
 /**
  * To explicitly enable auth0 authentication add flag --auth0-enabled to command line options
  * { _unknown: [ '--auth0-enabled' ], command: [ 'login' ] }
- *
- * To explicitly enable legacy authentication add flag --legacy-enabled to command line options
- * { _unknown: [ '--legacy-enabled' ], command: [ 'login' ] }
- *
- * Only one from auth0 and legacy authentication can be active at the moment
  */
-const getIsAuth0OrLegacyEnabled = (options) => {
-    var _a, _b;
+const getIsAuth0Enabled = (options) => {
+    var _a;
     const queryParams = {};
     if ((_a = options._unknown) === null || _a === void 0 ? void 0 : _a.includes('--auth0-enabled')) {
         queryParams.isAuth0Enabled = true;
     }
-    if ((_b = options._unknown) === null || _b === void 0 ? void 0 : _b.includes('--legacy-enabled')) {
-        queryParams.isLegacyEnabled = true;
-    }
-    if (queryParams.isAuth0Enabled !== undefined && queryParams.isLegacyEnabled !== undefined) {
-        throw new Error('Only one override from auth0 and legacy authentication options can be active at the moment.');
-    }
     return queryParams;
 };
-exports.getIsAuth0OrLegacyEnabled = getIsAuth0OrLegacyEnabled;
+exports.getIsAuth0Enabled = getIsAuth0Enabled;
 /**
  * Handles user authentication using username/email and password credentials.
- * Supports both Auth0 and legacy authentication methods. Stores credentials
- * securely in the ~/.sosrc configuration file for subsequent CLI operations.
+ * Supports Auth0 authentication method. Stores credentials securely in the
+ * ~/.sosrc configuration file for subsequent CLI operations.
  *
  * @group Authentication:1
  *
@@ -100,7 +89,6 @@ exports.getIsAuth0OrLegacyEnabled = getIsAuth0OrLegacyEnabled;
  * ```
  *
  * @throws {Error} When username is missing and not provided interactively
- * @throws {Error} When both Auth0 and legacy authentication flags are specified
  *
  * @since 0.3.0
  */
@@ -133,7 +121,7 @@ exports.login = (0, commandDefinition_1.createCommandDefinition)({
                 name: 'password',
                 message: `Type your password used for ${hostToDisplay}`,
             });
-            const authQueryParams = (0, exports.getIsAuth0OrLegacyEnabled)(options);
+            const authQueryParams = (0, exports.getIsAuth0Enabled)(options);
             const { id: tokenId, securityToken: apiSecurityToken, name, } = yield getOrCreateApiSecurityToken(Object.assign({ identification,
                 password,
                 apiUrl }, authQueryParams));
@@ -147,7 +135,7 @@ exports.login = (0, commandDefinition_1.createCommandDefinition)({
     },
 });
 function getOrCreateApiSecurityToken(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ identification, password, apiUrl, isAuth0Enabled, isLegacyEnabled, }) {
+    return __awaiter(this, arguments, void 0, function* ({ identification, password, apiUrl, isAuth0Enabled, }) {
         var _b;
         const ACCOUNT_SECURITY_TOKEN_RESOURCE = 'account/security-token';
         const options = {
@@ -156,8 +144,8 @@ function getOrCreateApiSecurityToken(_a) {
             version: apiVersions_1.ApiVersions.V1,
         };
         const tokenName = generateTokenName();
-        const requestBody = Object.assign(Object.assign({ identification,
-            password, name: tokenName }, (isAuth0Enabled !== undefined ? { isAuth0AuthenticationEnabled: isAuth0Enabled } : {})), (isLegacyEnabled !== undefined ? { isLegacyAuthenticationEnabled: isLegacyEnabled } : {}));
+        const requestBody = Object.assign({ identification,
+            password, name: tokenName }, (isAuth0Enabled !== undefined ? { isAuth0AuthenticationEnabled: isAuth0Enabled } : {}));
         const response = yield (0, helper_1.postResource)(options, ACCOUNT_SECURITY_TOKEN_RESOURCE, null, requestBody);
         const responseBody = JSON.parse(yield response.text(), helper_1.deserializeJSON);
         // Don't log sensitive response data

package/dist/Command/Autocomplete/Install/installAutocompleteCommand.d.ts

@@ -6,7 +6,7 @@ export declare const setRootCommand: (rootCommand: ICommand<string, OptionList>)
  * This command adds auto-completion scripts and configuration to the user's shell
  * profile, allowing tab completion for commands and sub-commands.
  *
- * @group Tools:1
+ * @group Tools:11
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/Install/installAutocompleteCommand.js

@@ -25,7 +25,7 @@ exports.setRootCommand = setRootCommand;
  * This command adds auto-completion scripts and configuration to the user's shell
  * profile, allowing tab completion for commands and sub-commands.
  *
- * @group Tools:1
+ * @group Tools:11
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/Install/installAutocompleteCommand.ts

@@ -16,7 +16,7 @@ export const setRootCommand = (rootCommand: ICommand<string, OptionList>): void
  * This command adds auto-completion scripts and configuration to the user's shell
  * profile, allowing tab completion for commands and sub-commands.
  *
- * @group Tools:1
+ * @group Tools:11
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/Uninstall/uninstallAutocompleteCommand.d.ts

@@ -4,7 +4,7 @@ export declare const OPTION_LIST: readonly [];
  * This command reverses the changes made by the install command, removing auto-completion
  * scripts and configuration entries from shell profile files.
  *
- * @group Tools:2
+ * @group Tools:12
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/Uninstall/uninstallAutocompleteCommand.js

@@ -52,7 +52,7 @@ exports.OPTION_LIST = [];
  * This command reverses the changes made by the install command, removing auto-completion
  * scripts and configuration entries from shell profile files.
  *
- * @group Tools:2
+ * @group Tools:12
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/autocompleteCommand.d.ts

@@ -6,7 +6,7 @@ export declare const initializeAutocomplete: (rootCommand: ICommand<string, Opti
  * Auto-completion enhances developer productivity by providing intelligent command and
  * sub-command suggestions in supported shells (bash, zsh, fish).
  *
- * @group Tools:7
+ * @group Tools:300
  *
  * @example
  * ```bash

package/dist/Command/Autocomplete/autocompleteCommand.js

@@ -24,7 +24,7 @@ exports.initializeAutocomplete = initializeAutocomplete;
  * Auto-completion enhances developer productivity by providing intelligent command and
  * sub-command suggestions in supported shells (bash, zsh, fish).
  *
- * @group Tools:7
+ * @group Tools:300
  *
  * @example
  * ```bash

package/dist/Command/commandProcessor.d.ts

@@ -1,2 +1,3 @@
 import { ICommand, ICommandOption, OptionList } from './commandDefinition';
+export declare function preprocessArgv(argv: string[]): string[];
 export declare function processCommand(currentCommand: ICommand<string, OptionList>, parentOptionList?: ICommandOption[], commandIndex?: number): Promise<void>;

package/dist/Command/commandProcessor.js

@@ -12,6 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessArgv = preprocessArgv;
 exports.processCommand = processCommand;
 const debug_1 = __importDefault(require("debug"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -20,10 +21,35 @@ const command_line_args_1 = __importDefault(require("command-line-args"));
 const packageVersion_1 = require("../Cli/packageVersion");
 const log_1 = require("@signageos/sdk/dist/Console/log");
 const Debug = (0, debug_1.default)('@signageos/cli:Command:processor');
+// Preprocess argv to detect and handle multi-character single-dash options
+function preprocessArgv(argv) {
+    // Common multi-character options that users might accidentally use with single dash
+    const commonMultiCharOptions = ['yes', 'help', 'version', 'force', 'verbose'];
+    return argv.map((arg) => {
+        if (arg.startsWith('-') && !arg.startsWith('--') && arg.length > 2) {
+            const optionName = arg.substring(1);
+            // Throw error for common mistakes to educate users about correct syntax
+            if (commonMultiCharOptions.includes(optionName)) {
+                throw new Error(`Invalid option '${arg}'. Did you mean '--${optionName}'? Use double dashes for multi-character options.`);
+            }
+            // Convert multi-character options to double-dash to avoid cryptic errors
+            return '--' + optionName;
+        }
+        return arg;
+    });
+}
 function processCommand(currentCommand_1) {
     return __awaiter(this, arguments, void 0, function* (currentCommand, parentOptionList = [], commandIndex = 0) {
         const nestedOptionList = [...parentOptionList, ...currentCommand.optionList];
+        // Preprocess argv to handle multi-character single-dash options that should be treated as unknown
+        // rather than being split into individual characters
+        const preprocessedArgv = preprocessArgv(process.argv);
+        const originalArgv = process.argv;
+        process.argv = preprocessedArgv;
+        // Parse command line options
         const currentOptions = (0, command_line_args_1.default)(nestedOptionList, { partial: true });
+        // Restore original argv
+        process.argv = originalArgv;
         Debug('process', currentOptions);
         const subCommandName = currentOptions.command[commandIndex];
         const subCommand = currentCommand.commands.find((command) => command.name === subCommandName);
@@ -31,6 +57,58 @@ function processCommand(currentCommand_1) {
             yield processCommand(subCommand, nestedOptionList, commandIndex + 1);
         }
         else {
+            // Only validate unknown options when we're at a leaf command (no subcommands to process)
+            // Validate unknown options - but handle the case where single-dash multi-char options
+            // are split into individual characters by command-line-args
+            if (currentOptions._unknown && currentOptions._unknown.length > 0) {
+                const unknownOptions = currentOptions._unknown.filter((opt) => opt.startsWith('-'));
+                if (unknownOptions.length > 0) {
+                    // Get the remaining args after the commands (skip the command path)
+                    const originalArgs = process.argv.slice(2);
+                    const commandArgs = currentOptions.command || [];
+                    const optionArgs = originalArgs.slice(commandArgs.length);
+                    Debug('originalArgs', originalArgs);
+                    Debug('commandArgs', commandArgs);
+                    Debug('optionArgs', optionArgs);
+                    const realUnknownOptions = [];
+                    // Find actual unknown options in the remaining arguments
+                    for (const arg of optionArgs) {
+                        if (arg.startsWith('-') && !arg.startsWith('--')) {
+                            // This is a single-dash option, check if it's known
+                            const optionName = arg.substring(1);
+                            const knownOption = nestedOptionList.find((opt) => opt.alias === optionName || opt.name === optionName);
+                            if (!knownOption && optionName.length > 1) {
+                                // This is an unknown multi-character single-dash option
+                                realUnknownOptions.push(arg);
+                            }
+                        }
+                        else if (arg.startsWith('--')) {
+                            // This is a double-dash option, check if it's known
+                            const optionName = arg.substring(2);
+                            const knownOption = nestedOptionList.find((opt) => opt.name === optionName);
+                            if (!knownOption) {
+                                realUnknownOptions.push(arg);
+                            }
+                        }
+                    }
+                    // If we found actual unknown options, use those instead
+                    if (realUnknownOptions.length > 0) {
+                        throw new Error(`Unknown option(s): ${realUnknownOptions.join(', ')}`);
+                    }
+                    else if (unknownOptions.length > 0) {
+                        // Fall back to the parsed unknown options if we couldn't determine the real ones
+                        throw new Error(`Unknown option(s): ${unknownOptions.join(', ')}`);
+                    }
+                }
+            }
+            // Check if there was an unknown subcommand provided
+            if (subCommandName && currentCommand.commands.length > 0) {
+                throw new Error(`Unknown command: '${subCommandName}'`);
+            }
+            // Check if there are extra arguments when no subcommands are expected
+            if (subCommandName && currentCommand.commands.length === 0) {
+                throw new Error(`Unknown argument: '${subCommandName}'. This command does not accept subcommands.`);
+            }
             if (currentOptions.help) {
                 printUsage(currentCommand, nestedOptionList);
             }