meld-cli/utils/clip.js

51 lines
1.3 KiB
JavaScript

/**
* @file clip.js
* @module utils/clip
* @description
* Utilities for managing clips in a Meld session via CLI.
* Provides commands to save clips and display help information.
* Integrates with cli-meow-help for command-line help.
*/
import meowHelp from 'cli-meow-help'
/**
* Contains the help information for the clip command group.
*
* @type {object}
* @property {string} name - The name of the CLI command.
* @property {string} desc - Description of the command's purpose.
* @property {object} commands - The available subcommands.
* @property {object} flags - The available flags for the command.
* @property {boolean} defaults - Indicates if default values are shown.
*/
const clipHelp = meowHelp({
name: 'meld-cli clip',
desc: 'Manage clips in Meld',
commands: {
save: {
desc: 'Save a clip'
}
},
flags: {
help: {
type: 'boolean',
shortFlag: 'h',
desc: 'Display help information'
}
},
defaults: false
})
/**
* Save a clip.
* @param {Object} channel - The channel object containing Meld session data.
* @returns {Promise<string>} Resolves with a success message or rejects with an error.
*/
async function clipSave (channel) {
await channel.objects.meld.sendCommand('meld.recordClip')
return 'Clip saved successfully.'
}
export { clipHelp, clipSave }