@signageos/cli 2.4.0 → 2.5.0

package/docs/organization/index.md

@@ -0,0 +1,105 @@
+---
+id: organization-index
+title: organization
+sidebar_position: 60
+---
+# organization
+
+Organization management operations
+
+
+## Description
+
+Provides commands to manage signageOS organizations including listing available organizations,
+retrieving organization details, and setting default organization for CLI operations.
+
+## Usage
+
+```bash
+sos organization <subcommand> [options]
+```
+
+## Subcommands
+
+### list
+
+List organizations for logged account
+
+```bash
+sos organization list [options]
+```
+
+[→ See detailed documentation](list/)
+
+### get
+
+Get detailed information about a specific organization
+
+```bash
+sos organization get [options]
+```
+
+[→ See detailed documentation](get/)
+
+### set-default
+
+Set a default organization for CLI operations
+
+```bash
+sos organization set-default [options]
+```
+
+[→ See detailed documentation](set-default/)
+
+
+## Examples
+
+```bash
+# List all organizations
+sos organization list
+
+# Get specific organization details
+sos organization get --organization-uid abc123
+
+# Set default organization
+sos organization set-default
+```
+
+## Since
+
+0.3.0
+
+## Global Options
+
+All commands support the following global options:
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--help` | `-h` | Display help information for any command |
+| `--version` | `-v` | Display the installed version of the CLI |
+| `--api-url` | `-u` | Override the API URL for REST requests |
+| `--profile` | | Use a specific profile from ~/.sosrc config |
+
+### Examples
+
+```bash
+# Show version
+sos --version
+
+# Get help for any command
+sos applet --help
+sos applet upload --help
+
+# Use custom API endpoint
+sos --api-url https://api.example.com applet upload
+
+# Use specific profile
+sos --profile production organization list
+```
+
+
+## Related Commands
+
+- [`sos organization list`](list/) - List organizations for logged account
+- [`sos organization get`](get/) - Get detailed information about a specific organization
+- [`sos organization set-default`](set-default/) - Set a default organization for CLI operations

package/docs/organization/list/index.md

@@ -0,0 +1,65 @@
+---
+id: organization-list-index
+title: list
+sidebar_position: 61
+---
+# list
+
+List organizations for logged account
+
+
+## Description
+
+Retrieves and displays all organizations that the currently authenticated
+account has access to. This command helps users understand which organizations
+they can work with and select appropriate targets for other CLI operations.
+
+## Usage
+
+```bash
+sos organization list [options]
+```
+
+## Examples
+
+```bash
+# List all accessible organizations
+sos organization list
+```
+
+## Since
+
+0.3.0
+
+## Global Options
+
+All commands support the following global options:
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--help` | `-h` | Display help information for any command |
+| `--version` | `-v` | Display the installed version of the CLI |
+| `--api-url` | `-u` | Override the API URL for REST requests |
+| `--profile` | | Use a specific profile from ~/.sosrc config |
+
+### Examples
+
+```bash
+# Show version
+sos --version
+
+# Get help for any command
+sos applet --help
+sos applet upload --help
+
+# Use custom API endpoint
+sos --api-url https://api.example.com applet upload
+
+# Use specific profile
+sos --profile production organization list
+```
+
+
+## See Also
+
+- [Get detailed organization information](../get/)

package/docs/organization/set-default/index.md

@@ -0,0 +1,74 @@
+---
+id: organization-set-default-index
+title: set-default
+sidebar_position: 63
+---
+# set-default
+
+Set a default organization for CLI operations
+
+
+## Description
+
+Sets a default organization that will be used automatically in subsequent CLI commands
+that require an organization context. This eliminates the need to specify the organization
+UID for each command. The default organization is stored in the ~/.sosrc configuration file.
+
+:::tip Remarks
+The default organization can be overridden using the SOS_ORGANIZATION_UID environment variable
+or by using the --organization-uid flag in individual commands.
+:::
+
+## Usage
+
+```bash
+sos organization set-default [options]
+```
+
+## Options
+
+| Option               | Description               |
+| -------------------- | ------------------------- |
+| `--organization-uid` | Organization UID (string) |
+
+## Examples
+
+```bash
+# Interactive selection of default organization
+sos organization set-default
+
+# Set specific organization as default
+sos organization set-default --organization-uid abc123
+```
+
+## Since
+
+1.0.0
+
+## Global Options
+
+All commands support the following global options:
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--help` | `-h` | Display help information for any command |
+| `--version` | `-v` | Display the installed version of the CLI |
+| `--api-url` | `-u` | Override the API URL for REST requests |
+| `--profile` | | Use a specific profile from ~/.sosrc config |
+
+### Examples
+
+```bash
+# Show version
+sos --version
+
+# Get help for any command
+sos applet --help
+sos applet upload --help
+
+# Use custom API endpoint
+sos --api-url https://api.example.com applet upload
+
+# Use specific profile
+sos --profile production organization list
+```

package/docs/timing/index.md

@@ -0,0 +1,78 @@
+---
+id: timing-index
+title: timing
+sidebar_position: 40
+---
+# timing
+
+Timing management
+
+
+## Description
+
+Provides commands for managing timing configurations that control when and how
+applets are displayed on signageOS devices. Timing configurations define the
+relationship between devices, applets, and scheduling parameters.
+
+## Usage
+
+```bash
+sos timing <subcommand> [options]
+```
+
+## Subcommands
+
+### list
+
+List timing configurations assigned to a device
+
+```bash
+sos timing list [options]
+```
+
+[→ See detailed documentation](list/)
+
+
+## Examples
+
+```bash
+# List timing configurations
+sos timing list
+```
+
+## Since
+
+0.3.0
+
+## Global Options
+
+All commands support the following global options:
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--help` | `-h` | Display help information for any command |
+| `--version` | `-v` | Display the installed version of the CLI |
+| `--api-url` | `-u` | Override the API URL for REST requests |
+| `--profile` | | Use a specific profile from ~/.sosrc config |
+
+### Examples
+
+```bash
+# Show version
+sos --version
+
+# Get help for any command
+sos applet --help
+sos applet upload --help
+
+# Use custom API endpoint
+sos --api-url https://api.example.com applet upload
+
+# Use specific profile
+sos --profile production organization list
+```
+
+
+## Related Commands
+
+- [`sos timing list`](list/) - List timing configurations assigned to a device

package/docs/timing/list/index.md

@@ -0,0 +1,71 @@
+---
+id: timing-list-index
+title: list
+sidebar_position: 41
+---
+# list
+
+List timing configurations assigned to a device
+
+
+## Description
+
+Retrieves and displays all timing configurations that are currently assigned
+to a specific device. Timing configurations define when and how content
+(applets) should be displayed on devices, including scheduling and duration settings.
+
+## Usage
+
+```bash
+sos timing list [options]
+```
+
+## Options
+
+| Option                      | Description                                                      |
+| --------------------------- | ---------------------------------------------------------------- |
+| `--no-default-organization` | Prevent using the defaultOrganizationUid from ~/.sosrc (boolean) |
+| `--organization-uid`        | Organization UID (string)                                        |
+| `--device-uid`              | Device UID (string)                                              |
+
+## Examples
+
+```bash
+# List timings for a specific device
+sos timing list --device-uid device123
+
+# List timings with organization override
+sos timing list --device-uid device123 --organization-uid org456
+```
+
+## Since
+
+0.3.0
+
+## Global Options
+
+All commands support the following global options:
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--help` | `-h` | Display help information for any command |
+| `--version` | `-v` | Display the installed version of the CLI |
+| `--api-url` | `-u` | Override the API URL for REST requests |
+| `--profile` | | Use a specific profile from ~/.sosrc config |
+
+### Examples
+
+```bash
+# Show version
+sos --version
+
+# Get help for any command
+sos applet --help
+sos applet upload --help
+
+# Use custom API endpoint
+sos --api-url https://api.example.com applet upload
+
+# Use specific profile
+sos --profile production organization list
+```

package/package.json

@@ -1,35 +1,41 @@
 {
   "name": "@signageos/cli",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "main": "./dist/index.js",
+  "author": "signageOS.io <dev@signageos.io>",
   "files": [
     ".env",
     "dist",
     "README.md",
-    "package.json"
+    "package.json",
+    "docs"
   ],
   "repository": {
     "url": "https://github.com/signageos/cli",
     "type": "git"
   },
   "scripts": {
-    "build": "npx check-engine@latest && tsc && npm run build:templates",
-    "build:templates": "node tools/include-templates.js",
-    "lint": "eslint --config ./eslint.config.mjs --ext .ts,.tsx,.js ./src/",
-    "lint:fix": "eslint --config ./eslint.config.mjs --fix --ext .ts,.tsx,.js ./src/",
-    "lint:prettier": "prettier  \"(src|tests|tools)/**/*.+(ts|tsx|json|js)\" --check",
-    "lint:prettier:fix": "prettier  \"(src|tests|tools)/**/*.+(ts|tsx|json|js)\" --write",
     "clean": "rm -rf dist/*",
-    "clean-build": "npm run clean && npm run build && chmod +x dist/index.js",
+    "build": "npx check-engine@latest && tsc && npm run build:templates && npm run docs",
+    "build:templates": "node tools/include-templates.mjs",
+    "clean-build": "npm run clean && npm run build",
+    "watch": "tsc --watch",
+    "check-types": "tsc --noEmit",
     "test": "env NODE_ENV=test mocha",
-    "test:windows": "cross-env NODE_ENV=test mocha",
     "test:coverage": "c8 npm run test",
-    "watch": "tsc --watch",
-    "check": "npm run depcheck && npx --userconfig ./.npmrc @signageos/lib-ci check-deps && npm run check-circular-deps",
+    "test:windows": "cross-env NODE_ENV=test mocha",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "lint:prettier": "prettier  \"(src|tests|tools)/**/*.+(ts|tsx|json|js)\" --check",
+    "lint:prettier:fix": "prettier  \"(src|tests|tools)/**/*.+(ts|tsx|json|js)\" --write",
+    "test:node-versions": "./tests/integration/test-node-versions.sh",
+    "test:integration:node-versions": "env NODE_ENV=test mocha --config .mocharc.node-versions.json",
+    "check": "npm run depcheck && npx --userconfig ./.npmrc @signageos/lib-ci check-deps && npm run check-circular-deps && npm run check-types",
     "check-circular-deps": "npx madge@5 --circular --extensions ts ./src/",
     "depcheck": "depcheck --config .depcheckrc.json",
-    "typecheck": "tsc --noEmit",
-    "prettier:format": "prettier \"(src|tests|tools)/**/*.+(ts|js)\" --write",
+    "docs": "npm run docs:generate && npm run docs:validate",
+    "docs:generate": "tsx tools/docs/generate.ts --action=generate --filePath=src/index.ts",
+    "docs:validate": "tsx tools/docs/validate/validate-docs-links.ts",
     "postinstall": "node -e \"try{require('./postinstall.js')}catch(e){}\""
   },
   "license": "MIT",
@@ -42,7 +48,7 @@
   },
   "devDependencies": {
     "@istanbuljs/nyc-config-typescript": "1.0.2",
-    "@signageos/codestyle": "1.0.0",
+    "@signageos/codestyle": "2.0.3",
     "@types/archiver": "6.0.3",
     "@types/child-process-promise": "2.2.6",
     "@types/cli-progress": "3.11.6",
@@ -55,7 +61,6 @@
     "@types/mime": "3.0.4",
     "@types/mocha": "10.0.10",
     "@types/node": "22.15.3",
-    "@types/node-fetch": "2.6.12",
     "@types/prompts": "2.4.9",
     "@types/semver": "7.7.0",
     "@types/sinon": "17.0.4",
@@ -65,16 +70,21 @@
     "cross-env": "7.0.3",
     "depcheck": "1.4.7",
     "mocha": "11.2.2",
-    "rewiremock": "3.14.5",
+    "rewiremock": "3.14.6",
     "should": "13.2.3",
     "sinon": "20.0.0",
     "ts-node": "10.9.2",
+    "tsx": "4.20.3",
     "typescript": "5.8.3",
     "unzipper": "0.12.3"
   },
+  "overrides": {
+    "cross-spawn": "^7.0.6",
+    "http-cache-semantics": "^4.2.0"
+  },
   "dependencies": {
     "@signageos/file": "1.0.1",
-    "@signageos/sdk": "1.27.5",
+    "@signageos/sdk": "1.28.1",
     "archiver": "7.0.1",
     "chalk": "2.4.2",
     "child-process-promise": "2.2.1",
@@ -87,8 +97,8 @@
     "express": "5.1.0",
     "fs-extra": "11.3.0",
     "internal-ip": "8.0.0",
+    "markdown-table": "3.0.4",
     "mime": "2.4.4",
-    "node-fetch": "3.3.2",
     "prompts": "2.4.2",
     "semver": "7.7.1",
     "serve-static": "2.2.0",