@signageos/cli 2.4.1 → 2.5.0

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

@@ -1,4 +1,21 @@
 export declare const OPTION_LIST: readonly [];
+/**
+ * Removes the signageOS CLI auto-completion functionality from the user's shell configuration.
+ * This command reverses the changes made by the install command, removing auto-completion
+ * scripts and configuration entries from shell profile files.
+ *
+ * @group Tools:2
+ *
+ * @example
+ * ```bash
+ * # Uninstall auto-completion
+ * sos autocomplete uninstall
+ * ```
+ *
+ * @see {@link ../install/ Install auto-completion command}
+ *
+ * @since 2.4.0
+ */
 export declare const uninstallAutocomplete: {
     name: "uninstall";
     description: string;

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

@@ -47,6 +47,23 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const commandDefinition_1 = require("../../commandDefinition");
 exports.OPTION_LIST = [];
+/**
+ * Removes the signageOS CLI auto-completion functionality from the user's shell configuration.
+ * This command reverses the changes made by the install command, removing auto-completion
+ * scripts and configuration entries from shell profile files.
+ *
+ * @group Tools:2
+ *
+ * @example
+ * ```bash
+ * # Uninstall auto-completion
+ * sos autocomplete uninstall
+ * ```
+ *
+ * @see {@link ../install/ Install auto-completion command}
+ *
+ * @since 2.4.0
+ */
 exports.uninstallAutocomplete = (0, commandDefinition_1.createCommandDefinition)({
     name: 'uninstall',
     description: 'Uninstall command auto-completion for bash/zsh shells',
@@ -66,11 +83,11 @@ exports.uninstallAutocomplete = (0, commandDefinition_1.createCommandDefinition)
                 try {
                     yield fs.promises.access(completionFilePath);
                     yield fs.promises.unlink(completionFilePath);
-                    console.log(`✅ Removed completion script: ${completionFilePath}`);
+                    console.info(`✅ Removed completion script: ${completionFilePath}`);
                 }
                 catch (error) {
                     if (error.code === 'ENOENT') {
-                        console.log(`ℹ️ Completion script not found at: ${completionFilePath}`);
+                        console.info(`ℹ️ Completion script not found at: ${completionFilePath}`);
                     }
                     else {
                         throw error;
@@ -95,7 +112,7 @@ exports.uninstallAutocomplete = (0, commandDefinition_1.createCommandDefinition)
                             }
                             if (content !== originalContent) {
                                 fs.writeFileSync(configFilePath, content, 'utf8');
-                                console.log(`✅ Removed source line from ${configFile}`);
+                                console.info(`✅ Removed source line from ${configFile}`);
                                 configModified = true;
                             }
                         }
@@ -108,8 +125,8 @@ exports.uninstallAutocomplete = (0, commandDefinition_1.createCommandDefinition)
                 if (!configModified) {
                     console.info(`ℹ️ No shell configuration files were modified`);
                 }
-                console.log('\nAuto-completion for signageOS CLI has been uninstalled.');
-                console.log('You may need to restart your terminal or run "source ~/.bashrc" (or equivalent) for changes to take effect.');
+                console.info('\nAuto-completion for signageOS CLI has been uninstalled.');
+                console.info('You may need to restart your terminal or run "source ~/.bashrc" (or equivalent) for changes to take effect.');
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);

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

@@ -1,6 +1,24 @@
 import { ICommand, OptionList } from '../commandDefinition';
 export declare const OPTION_LIST: readonly [];
 export declare const initializeAutocomplete: (rootCommand: ICommand<string, OptionList>) => void;
+/**
+ * Provides commands for installing and managing shell auto-completion for the signageOS CLI.
+ * Auto-completion enhances developer productivity by providing intelligent command and
+ * sub-command suggestions in supported shells (bash, zsh, fish).
+ *
+ * @group Tools:7
+ *
+ * @example
+ * ```bash
+ * # Install auto-completion for current shell
+ * sos autocomplete install
+ *
+ * # Uninstall auto-completion
+ * sos autocomplete uninstall
+ * ```
+ *
+ * @since 2.4.0
+ */
 export declare const autocomplete: {
     name: "autocomplete";
     description: string;

package/dist/Command/Autocomplete/autocompleteCommand.js

@@ -19,9 +19,27 @@ const initializeAutocomplete = (rootCommand) => {
     (0, installAutocompleteCommand_1.setRootCommand)(rootCommand);
 };
 exports.initializeAutocomplete = initializeAutocomplete;
+/**
+ * Provides commands for installing and managing shell auto-completion for the signageOS CLI.
+ * Auto-completion enhances developer productivity by providing intelligent command and
+ * sub-command suggestions in supported shells (bash, zsh, fish).
+ *
+ * @group Tools:7
+ *
+ * @example
+ * ```bash
+ * # Install auto-completion for current shell
+ * sos autocomplete install
+ *
+ * # Uninstall auto-completion
+ * sos autocomplete uninstall
+ * ```
+ *
+ * @since 2.4.0
+ */
 exports.autocomplete = (0, commandDefinition_1.createCommandDefinition)({
     name: 'autocomplete',
-    description: 'Commands for managing CLI auto-completion',
+    description: 'CLI auto-completion management',
     optionList: exports.OPTION_LIST,
     commands: [installAutocompleteCommand_1.installAutocomplete, uninstallAutocompleteCommand_1.uninstallAutocomplete],
     run() {

package/dist/Command/autoComplete.js

@@ -82,7 +82,7 @@ function generateCompletionScript(rootCommand) {
     }
     // Replace placeholders in the shell script
     script = script.replace(/\${TOPLEVEL_COMMANDS}/g, topLevelCommands);
-    script = script.replace(/    # COMMAND_SCHEMA_CASES will be replaced with actual cases during generation/g, commandCases);
+    script = script.replace(/ {4}# COMMAND_SCHEMA_CASES will be replaced with actual cases during generation/g, commandCases);
     return script;
 }
 function installAutoCompletion(rootCommand) {
@@ -176,7 +176,7 @@ function displayInstallationMessage(completionFilePath, config) {
     message.push('\nUsage examples:');
     message.push('    sos [TAB]          # Show all top-level commands');
     message.push('    sos applet [TAB]   # Show all applet subcommands');
-    console.log(message.join('\n'));
+    console.info(message.join('\n'));
 }
 // Create a standalone completion setup command
 function setupCompletion(rootCommand) {

package/dist/Command/globalArgs.d.ts

@@ -1,2 +1,35 @@
+/**
+ * Extract global API URL option from command line arguments.
+ * Parses the global --api-url option that can be used to override the default
+ * signageOS REST API endpoint for all CLI operations. This is useful for testing
+ * against different environments or custom API deployments.
+ *
+ * @returns The API URL if specified, undefined otherwise
+ *
+ * @example
+ * ```bash
+ * # Use custom API URL
+ * sos --api-url https://api.custom.signageos.io applet list
+ * ```
+ */
 export declare function getGlobalApiUrl(): string | undefined;
+/**
+ * Extract global profile option from command line arguments.
+ * Parses the global --profile option that specifies which authentication profile
+ * to use for CLI operations. Profiles allow management of multiple signageOS
+ * environments or accounts from the same machine.
+ *
+ * @returns The profile name if specified, falls back to default profile
+ *
+ * @example
+ * ```bash
+ * # Use specific profile
+ * sos --profile production applet list
+ *
+ * # Use staging profile
+ * sos --profile staging device connect
+ * ```
+ *
+ * @since 1.0.0
+ */
 export declare function getGlobalProfile(): string;

package/dist/Command/globalArgs.js

@@ -7,10 +7,43 @@ exports.getGlobalApiUrl = getGlobalApiUrl;
 exports.getGlobalProfile = getGlobalProfile;
 const command_line_args_1 = __importDefault(require("command-line-args"));
 const generalCommand_1 = require("../generalCommand");
+/**
+ * Extract global API URL option from command line arguments.
+ * Parses the global --api-url option that can be used to override the default
+ * signageOS REST API endpoint for all CLI operations. This is useful for testing
+ * against different environments or custom API deployments.
+ *
+ * @returns The API URL if specified, undefined otherwise
+ *
+ * @example
+ * ```bash
+ * # Use custom API URL
+ * sos --api-url https://api.custom.signageos.io applet list
+ * ```
+ */
 function getGlobalApiUrl() {
     const options = (0, command_line_args_1.default)([generalCommand_1.API_URL_OPTION], { partial: true });
     return options[generalCommand_1.API_URL_OPTION.name];
 }
+/**
+ * Extract global profile option from command line arguments.
+ * Parses the global --profile option that specifies which authentication profile
+ * to use for CLI operations. Profiles allow management of multiple signageOS
+ * environments or accounts from the same machine.
+ *
+ * @returns The profile name if specified, falls back to default profile
+ *
+ * @example
+ * ```bash
+ * # Use specific profile
+ * sos --profile production applet list
+ *
+ * # Use staging profile
+ * sos --profile staging device connect
+ * ```
+ *
+ * @since 1.0.0
+ */
 function getGlobalProfile() {
     const options = (0, command_line_args_1.default)([generalCommand_1.PROFILE_OPTION], { partial: true });
     return options[generalCommand_1.PROFILE_OPTION.name];

package/dist/CustomScript/Generate/customScriptGenerateCommand.d.ts

@@ -1,3 +1,22 @@
+/**
+ * Creates a new custom script project with boilerplate code and configuration files.
+ * This command sets up a complete development environment for custom script development,
+ * including necessary dependencies and project structure.
+ *
+ * @group Development:1
+ *
+ * @example
+ * ```bash
+ * # Generate custom script project
+ * sos custom-script generate
+ * ```
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @see {@link ../upload/ Upload custom script command}
+ *
+ * @since 2.2.0
+ */
 export declare const customScriptGenerate: {
     name: "generate";
     description: string;

package/dist/CustomScript/Generate/customScriptGenerateCommand.js

@@ -19,9 +19,28 @@ const commandDefinition_1 = require("../../Command/commandDefinition");
 const customScriptFacade_1 = require("../customScriptFacade");
 const customScriptGenerateFacade_1 = require("./customScriptGenerateFacade");
 const git_1 = require("../../Lib/git");
+/**
+ * Creates a new custom script project with boilerplate code and configuration files.
+ * This command sets up a complete development environment for custom script development,
+ * including necessary dependencies and project structure.
+ *
+ * @group Development:1
+ *
+ * @example
+ * ```bash
+ * # Generate custom script project
+ * sos custom-script generate
+ * ```
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @see {@link ../upload/ Upload custom script command}
+ *
+ * @since 2.2.0
+ */
 exports.customScriptGenerate = (0, commandDefinition_1.createCommandDefinition)({
     name: 'generate',
-    description: 'Generates a local repository for developing a Custom Script',
+    description: 'Generate a local repository for developing a Custom Script',
     optionList: [],
     commands: [],
     run() {

package/dist/CustomScript/Upload/customScriptUploadCommand.d.ts

@@ -2,19 +2,49 @@ import { CommandLineOptions } from '../../Command/commandDefinition';
 export declare const OPTION_LIST: readonly [{
     readonly name: "no-default-organization";
     readonly type: BooleanConstructor;
-    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
 }, {
     readonly name: "organization-uid";
     readonly type: StringConstructor;
     readonly description: "Organization UID";
 }];
+/**
+ * Uploads custom script code and configuration to the signageOS platform based on
+ * the .sosconfig.json configuration file. Custom Scripts enable advanced device
+ * functionality beyond standard applets, including system-level operations and
+ * device-specific configurations for multiple platforms.
+ *
+ * @group Development:2
+ *
+ * @example
+ * ```bash
+ * # Upload custom script from current directory
+ * sos custom-script upload
+ *
+ * # Upload with specific organization
+ * sos custom-script upload --organization-uid abc123def456
+ * ```
+ *
+ * @throws {Error} When .sosconfig.json is missing or invalid
+ * @throws {Error} When script platform configuration is missing
+ * @throws {Error} When organization access is denied
+ * @throws {Error} When script upload fails
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @see {@link ../generate/ Generate custom script project}
+ *
+ * @see {@link ../ Custom Script management commands}
+ *
+ * @since 1.8.0
+ */
 export declare const customScriptUpload: {
     name: "upload";
     description: string;
     optionList: readonly [{
         readonly name: "no-default-organization";
         readonly type: BooleanConstructor;
-        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
     }, {
         readonly name: "organization-uid";
         readonly type: StringConstructor;

package/dist/CustomScript/Upload/customScriptUploadCommand.js

@@ -23,9 +23,39 @@ const organizationFacade_1 = require("../../Organization/organizationFacade");
 const customScriptFacade_1 = require("../customScriptFacade");
 const Debug = (0, debug_1.default)('@signageos/cli:CustomScript:Upload:Command');
 exports.OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organizationFacade_1.ORGANIZATION_UID_OPTION];
+/**
+ * Uploads custom script code and configuration to the signageOS platform based on
+ * the .sosconfig.json configuration file. Custom Scripts enable advanced device
+ * functionality beyond standard applets, including system-level operations and
+ * device-specific configurations for multiple platforms.
+ *
+ * @group Development:2
+ *
+ * @example
+ * ```bash
+ * # Upload custom script from current directory
+ * sos custom-script upload
+ *
+ * # Upload with specific organization
+ * sos custom-script upload --organization-uid abc123def456
+ * ```
+ *
+ * @throws {Error} When .sosconfig.json is missing or invalid
+ * @throws {Error} When script platform configuration is missing
+ * @throws {Error} When organization access is denied
+ * @throws {Error} When script upload fails
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @see {@link ../generate/ Generate custom script project}
+ *
+ * @see {@link ../ Custom Script management commands}
+ *
+ * @since 1.8.0
+ */
 exports.customScriptUpload = (0, commandDefinition_1.createCommandDefinition)({
     name: 'upload',
-    description: 'Uploads current custom script version',
+    description: 'Upload custom script to the signageOS platform',
     optionList: exports.OPTION_LIST,
     commands: [],
     run(options) {

package/dist/CustomScript/customScriptCommand.d.ts

@@ -1,3 +1,23 @@
+/**
+ * Provides commands for developing and deploying custom scripts to signageOS devices.
+ * Custom Scripts enable advanced device functionality beyond standard applets,
+ * including system-level operations and device-specific configurations.
+ *
+ * @group Development:5
+ *
+ * @example
+ * ```bash
+ * # Generate new custom script project
+ * sos custom-script generate
+ *
+ * # Upload custom script to platform
+ * sos custom-script upload
+ * ```
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @since 1.8.0
+ */
 export declare const customScript: {
     name: "custom-script";
     description: string;
@@ -8,7 +28,7 @@ export declare const customScript: {
         optionList: readonly [{
             readonly name: "no-default-organization";
             readonly type: BooleanConstructor;
-            readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+            readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
         }, {
             readonly name: "organization-uid";
             readonly type: StringConstructor;

package/dist/CustomScript/customScriptCommand.js

@@ -13,6 +13,26 @@ exports.customScript = void 0;
 const commandDefinition_1 = require("../Command/commandDefinition");
 const customScriptUploadCommand_1 = require("./Upload/customScriptUploadCommand");
 const customScriptGenerateCommand_1 = require("./Generate/customScriptGenerateCommand");
+/**
+ * Provides commands for developing and deploying custom scripts to signageOS devices.
+ * Custom Scripts enable advanced device functionality beyond standard applets,
+ * including system-level operations and device-specific configurations.
+ *
+ * @group Development:5
+ *
+ * @example
+ * ```bash
+ * # Generate new custom script project
+ * sos custom-script generate
+ *
+ * # Upload custom script to platform
+ * sos custom-script upload
+ * ```
+ *
+ * @see {@link https://developers.signageos.io/docs/custom-scripts/ Custom Scripts Documentation}
+ *
+ * @since 1.8.0
+ */
 exports.customScript = (0, commandDefinition_1.createCommandDefinition)({
     name: 'custom-script',
     description: 'Custom Script management',

package/dist/Device/Connect/connectCommand.d.ts

@@ -7,7 +7,7 @@ export declare const USE_FORWARD_SERVER_OPTION: {
 declare const OPTION_LIST: readonly [{
     readonly name: "no-default-organization";
     readonly type: BooleanConstructor;
-    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
 }, {
     readonly name: "organization-uid";
     readonly type: StringConstructor;
@@ -56,13 +56,62 @@ declare const OPTION_LIST: readonly [{
     readonly type: StringConstructor;
     readonly description: "Path to the applet file or the project folder depending on the entry file. Relative to the command or absolute.";
 }];
+/**
+ * Establishes a connection between a signageOS device and the local development environment,
+ * allowing real-time testing and debugging of applets during development. Supports both
+ * local network (LAN) and forward server connections for different network configurations.
+ *
+ * The command sets up a development server and configures the device to load the applet
+ * from the local machine, enabling hot reload and live debugging capabilities.
+ *
+ * @group Management:1
+ *
+ * @example
+ * ```bash
+ * # Connect device with basic configuration
+ * sos device connect --device-uid device123 --applet-uid my-applet
+ *
+ * # Connect with custom server port
+ * sos device connect --device-uid device123 --server-port 8080
+ *
+ * # Connect using forward server (for remote devices)
+ * sos device connect --device-uid device123 --use-forward-server
+ *
+ * # Connect with hot reload enabled
+ * sos device connect --device-uid device123 --hot-reload
+ *
+ * # Connect with custom organization
+ * sos device connect --device-uid device123 --organization-uid org456
+ *
+ * # Connect with custom public URL
+ * sos device connect --device-uid device123 --server-public-url https://my-domain.com
+ *
+ * # Connect and run in background
+ * sos device connect --device-uid device123 --detach
+ *
+ * # Force connection (terminate existing servers)
+ * sos device connect --device-uid device123 --force
+ * ```
+ *
+ * @throws {Error} When device or applet cannot be found or accessed
+ *
+ * @throws {Error} When network connection to device fails
+ *
+ * @throws {Error} When development server cannot be started
+ *
+ * @throws {Error} When hot reload configuration is invalid
+ *
+ * @see {@link https://developers.signageos.io/docs/applets/connect-to-device-cli/ Device Connection and Development Documentation}
+ *
+ * @since 0.9.0
+ */
 export declare const connect: {
     name: "connect";
     description: string;
     optionList: readonly [{
         readonly name: "no-default-organization";
         readonly type: BooleanConstructor;
-        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
     }, {
         readonly name: "organization-uid";
         readonly type: StringConstructor;

package/dist/Device/Connect/connectCommand.js

@@ -45,9 +45,58 @@ const OPTION_LIST = [
     appletServerHelper_1.HOT_RELOAD_OPTION,
     appletUploadCommandHelper_1.APPLET_PATH_OPTION,
 ];
+/**
+ * Establishes a connection between a signageOS device and the local development environment,
+ * allowing real-time testing and debugging of applets during development. Supports both
+ * local network (LAN) and forward server connections for different network configurations.
+ *
+ * The command sets up a development server and configures the device to load the applet
+ * from the local machine, enabling hot reload and live debugging capabilities.
+ *
+ * @group Management:1
+ *
+ * @example
+ * ```bash
+ * # Connect device with basic configuration
+ * sos device connect --device-uid device123 --applet-uid my-applet
+ *
+ * # Connect with custom server port
+ * sos device connect --device-uid device123 --server-port 8080
+ *
+ * # Connect using forward server (for remote devices)
+ * sos device connect --device-uid device123 --use-forward-server
+ *
+ * # Connect with hot reload enabled
+ * sos device connect --device-uid device123 --hot-reload
+ *
+ * # Connect with custom organization
+ * sos device connect --device-uid device123 --organization-uid org456
+ *
+ * # Connect with custom public URL
+ * sos device connect --device-uid device123 --server-public-url https://my-domain.com
+ *
+ * # Connect and run in background
+ * sos device connect --device-uid device123 --detach
+ *
+ * # Force connection (terminate existing servers)
+ * sos device connect --device-uid device123 --force
+ * ```
+ *
+ * @throws {Error} When device or applet cannot be found or accessed
+ *
+ * @throws {Error} When network connection to device fails
+ *
+ * @throws {Error} When development server cannot be started
+ *
+ * @throws {Error} When hot reload configuration is invalid
+ *
+ * @see {@link https://developers.signageos.io/docs/applets/connect-to-device-cli/ Device Connection and Development Documentation}
+ *
+ * @since 0.9.0
+ */
 exports.connect = (0, commandDefinition_1.createCommandDefinition)({
     name: 'connect',
-    description: 'Set ip for device',
+    description: 'Connect device to local development server',
     optionList: OPTION_LIST,
     commands: [],
     run: function (options) {

package/dist/Device/Content/setContentCommand.d.ts

@@ -2,7 +2,7 @@ import { CommandLineOptions } from '../../Command/commandDefinition';
 declare const OPTION_LIST: readonly [{
     readonly name: "no-default-organization";
     readonly type: BooleanConstructor;
-    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+    readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
 }, {
     readonly name: "organization-uid";
     readonly type: StringConstructor;
@@ -16,13 +16,39 @@ declare const OPTION_LIST: readonly [{
     readonly type: StringConstructor;
     readonly description: "Device UID";
 }];
+/**
+ * Deploys an applet to a specific device by creating a timing configuration
+ * that activates the specified applet version on the target device. This command
+ * establishes the applet-to-device relationship for production deployment.
+ *
+ * @group Management:3
+ *
+ * @example
+ * ```bash
+ * # Deploy applet to device
+ * sos device set-content --device-uid device123 --applet-uid my-applet
+ *
+ * # Deploy with organization override
+ * sos device set-content --device-uid device123 --applet-uid my-applet --organization-uid org456
+ * ```
+ *
+ * @throws {Error} When device or applet cannot be found or accessed
+ *
+ * @throws {Error} When timing configuration creation fails
+ *
+ * @throws {Error} When organization access is denied
+ *
+ * @throws {Error} When applet version cannot be determined
+ *
+ * @since 0.9.0
+ */
 export declare const setContent: {
     name: "set-content";
     description: string;
     optionList: readonly [{
         readonly name: "no-default-organization";
         readonly type: BooleanConstructor;
-        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc which were set using command sos organization set-default";
+        readonly description: "Prevent using the defaultOrganizationUid from ~/.sosrc";
     }, {
         readonly name: "organization-uid";
         readonly type: StringConstructor;

package/dist/Device/Content/setContentCommand.js

@@ -21,9 +21,35 @@ const helper_1 = require("../../helper");
 const organizationFacade_1 = require("../../Organization/organizationFacade");
 const deviceFacade_1 = require("../deviceFacade");
 const OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organizationFacade_1.ORGANIZATION_UID_OPTION, appletFacade_1.APPLET_UID_OPTION, deviceFacade_1.DEVICE_UID_OPTION];
+/**
+ * Deploys an applet to a specific device by creating a timing configuration
+ * that activates the specified applet version on the target device. This command
+ * establishes the applet-to-device relationship for production deployment.
+ *
+ * @group Management:3
+ *
+ * @example
+ * ```bash
+ * # Deploy applet to device
+ * sos device set-content --device-uid device123 --applet-uid my-applet
+ *
+ * # Deploy with organization override
+ * sos device set-content --device-uid device123 --applet-uid my-applet --organization-uid org456
+ * ```
+ *
+ * @throws {Error} When device or applet cannot be found or accessed
+ *
+ * @throws {Error} When timing configuration creation fails
+ *
+ * @throws {Error} When organization access is denied
+ *
+ * @throws {Error} When applet version cannot be determined
+ *
+ * @since 0.9.0
+ */
 exports.setContent = (0, commandDefinition_1.createCommandDefinition)({
     name: 'set-content',
-    description: 'Set content for device',
+    description: 'Deploy applet to device',
     optionList: OPTION_LIST,
     commands: [],
     run(options) {