@supernovaio/cli 0.1.0 → 0.9.0

package/README.md

@@ -1,319 +1,58 @@
-oclif-hello-world
-=================
+<img src="https://github.com/Supernova-Studio/sdk-typescript/blob/main/readme-icon.png?raw=true" alt="Supernova SDK" style="max-width:100%; margin-bottom: 20px;" />
 
-oclif example Hello World CLI
+# Supernova CLI [![All passing](https://img.shields.io/badge/Test-passing-success)]() [![Version 1.0.0](https://img.shields.io/badge/Version-1.0.0-success)]()
 
-[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
-[![Version](https://img.shields.io/npm/v/oclif-hello-world.svg)](https://npmjs.org/package/oclif-hello-world)
-[![CircleCI](https://circleci.com/gh/oclif/hello-world/tree/main.svg?style=shield)](https://circleci.com/gh/oclif/hello-world/tree/main)
-[![Downloads/week](https://img.shields.io/npm/dw/oclif-hello-world.svg)](https://npmjs.org/package/oclif-hello-world)
-[![License](https://img.shields.io/npm/l/oclif-hello-world.svg)](https://github.com/oclif/hello-world/blob/main/package.json)
+The [Supernova](https://supernova.io) CLI enables you to run specific tasks connected with Supernova from your CI/CD pipelines, from your action triggers (GitHub Actions and similar) or from your command line as well. Supernova CLI is powered by a [Supernova SDK](https://github.com/Supernova-Studio/sdk-typescript) that allows access to many more lower-level operations.
 
-<!-- toc -->
-* [Usage](#usage)
-* [Commands](#commands)
-<!-- tocstop -->
-# Usage
-<!-- usage -->
-```sh-session
-$ npm install -g @supernovaio/cli
-$ supernova COMMAND
-running command...
-$ supernova (--version)
-@supernovaio/cli/0.1.0 darwin-x64 node-v12.21.0
-$ supernova --help [COMMAND]
-USAGE
-  $ supernova COMMAND
-...
-```
-<!-- usagestop -->
-# Commands
-<!-- commands -->
-* [`supernova help [COMMAND]`](#supernova-help-command)
-* [`supernova plugins`](#supernova-plugins)
-* [`supernova plugins:install PLUGIN...`](#supernova-pluginsinstall-plugin)
-* [`supernova plugins:inspect PLUGIN...`](#supernova-pluginsinspect-plugin)
-* [`supernova plugins:install PLUGIN...`](#supernova-pluginsinstall-plugin-1)
-* [`supernova plugins:link PLUGIN`](#supernova-pluginslink-plugin)
-* [`supernova plugins:uninstall PLUGIN...`](#supernova-pluginsuninstall-plugin)
-* [`supernova plugins:uninstall PLUGIN...`](#supernova-pluginsuninstall-plugin-1)
-* [`supernova plugins:uninstall PLUGIN...`](#supernova-pluginsuninstall-plugin-2)
-* [`supernova plugins update`](#supernova-plugins-update)
-* [`supernova sync-design-tokens`](#supernova-sync-design-tokens)
-
-## `supernova help [COMMAND]`
-
-Display help for supernova.
-
-```
-USAGE
-  $ supernova help [COMMAND] [-n]
-
-ARGUMENTS
-  COMMAND  Command to show help for.
-
-FLAGS
-  -n, --nested-commands  Include all nested commands in the output.
-
-DESCRIPTION
-  Display help for supernova.
-```
-
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.1.12/src/commands/help.ts)_
-
-## `supernova plugins`
-
-List installed plugins.
-
-```
-USAGE
-  $ supernova plugins [--core]
-
-FLAGS
-  --core  Show core plugins.
-
-DESCRIPTION
-  List installed plugins.
-
-EXAMPLES
-  $ supernova plugins
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.1.0/src/commands/plugins/index.ts)_
-
-## `supernova plugins:install PLUGIN...`
-
-Installs a plugin into the CLI.
-
-```
-USAGE
-  $ supernova plugins:install PLUGIN...
-
-ARGUMENTS
-  PLUGIN  Plugin to install.
-
-FLAGS
-  -f, --force    Run yarn install with force flag.
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Installs a plugin into the CLI.
-
-  Can be installed from npm or a git url.
-
-  Installation of a user-installed plugin will override a core plugin.
-
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
-
-ALIASES
-  $ supernova plugins add
-
-EXAMPLES
-  $ supernova plugins:install myplugin 
-
-  $ supernova plugins:install https://github.com/someuser/someplugin
-
-  $ supernova plugins:install someuser/someplugin
-```
-
-## `supernova plugins:inspect PLUGIN...`
-
-Displays installation properties of a plugin.
-
-```
-USAGE
-  $ supernova plugins:inspect PLUGIN...
-
-ARGUMENTS
-  PLUGIN  [default: .] Plugin to inspect.
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Displays installation properties of a plugin.
-
-EXAMPLES
-  $ supernova plugins:inspect myplugin
-```
-
-## `supernova plugins:install PLUGIN...`
+CLI is separated into different commands that you can use to automate certain aspects of working with Supernova. More command line options are coming as well, stay tuned for those!
 
-Installs a plugin into the CLI.
+## Installing CLI dependency
 
-```
-USAGE
-  $ supernova plugins:install PLUGIN...
-
-ARGUMENTS
-  PLUGIN  Plugin to install.
-
-FLAGS
-  -f, --force    Run yarn install with force flag.
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Installs a plugin into the CLI.
-
-  Can be installed from npm or a git url.
-
-  Installation of a user-installed plugin will override a core plugin.
-
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
-
-ALIASES
-  $ supernova plugins add
-
-EXAMPLES
-  $ supernova plugins:install myplugin 
-
-  $ supernova plugins:install https://github.com/someuser/someplugin
-
-  $ supernova plugins:install someuser/someplugin
-```
-
-## `supernova plugins:link PLUGIN`
-
-Links a plugin into the CLI for development.
-
-```
-USAGE
-  $ supernova plugins:link PLUGIN
-
-ARGUMENTS
-  PATH  [default: .] path to plugin
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Links a plugin into the CLI for development.
-
-  Installation of a linked plugin will override a user-installed or core plugin.
-
-  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
-  command will override the user-installed or core plugin implementation. This is useful for development work.
-
-EXAMPLES
-  $ supernova plugins:link myplugin
-```
-
-## `supernova plugins:uninstall PLUGIN...`
-
-Removes a plugin from the CLI.
+To install, simply run:
 
+```bash
+npm install @supernovaio/supernova-sdk
+yarn add --dev @supernovaio/cli
 ```
-USAGE
-  $ supernova plugins:uninstall PLUGIN...
 
-ARGUMENTS
-  PLUGIN  plugin to uninstall
+In your target environment, or include CLI dependency in your CI/CD pipelines, like this:
 
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ supernova plugins unlink
-  $ supernova plugins remove
+```json
+{
+  "dependencies": {
+      "@supernovaio/cli": "latest"
+  }
+}
 ```
 
-## `supernova plugins:uninstall PLUGIN...`
+### Installing CLI globally
 
-Removes a plugin from the CLI.
+You can also install the CLI as global package, and make the CLI globally available under `> supernova` command to your command line. To install the CLI globally, just run the following command:
 
 ```
-USAGE
-  $ supernova plugins:uninstall PLUGIN...
-
-ARGUMENTS
-  PLUGIN  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ supernova plugins unlink
-  $ supernova plugins remove
-```
-
-## `supernova plugins:uninstall PLUGIN...`
-
-Removes a plugin from the CLI.
-
+npm install -g @supernovaio/cli
+yarn global add @supernovaio/cli
 ```
-USAGE
-  $ supernova plugins:uninstall PLUGIN...
-
-ARGUMENTS
-  PLUGIN  plugin to uninstall
 
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+You can now test that everything was properly set up by running the `supernova` command:
 
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ supernova plugins unlink
-  $ supernova plugins remove
 ```
-
-## `supernova plugins update`
-
-Update installed plugins.
-
+~ % supernova --version
+> @supernovaio/cli/1.x.x ...
 ```
-USAGE
-  $ supernova plugins update [-h] [-v]
 
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+`Node 12.21.0` or newer environment is required to run the Supernova CLI.
 
-DESCRIPTION
-  Update installed plugins.
-```
+## Use cases
 
-## `supernova sync-design-tokens`
+Following is the list of use cases for Supernova CLI. We will be adding more over time, stay tuned!
 
-Supernova CLI description TODO
+- [Synchronize Figma Token Plugin data](./docs/figma-tokens-sync.md)
 
-```
-USAGE
-  $ supernova sync-design-tokens -k <value> -d <value> [-b <value>] [-i <value> | -p <value>] [-r]
+## Contributions
 
-FLAGS
-  -b, --brandName=<value>       Brand to synchronize contents with
-  -d, --designSystemId=<value>  (required) Design System to synchronize contents with
-  -i, --input=<value>           Contents of design tokens plugin definition JSON file
-  -k, --apiKey=<value>          (required) API key to use for accessing Supernova instance
-  -p, --inputPath=<value>       Contents of design tokens plugin definition JSON file
-  -r, --dryRun                  When enabled, CLI will validate entire setup including loading/parsing/merging of tokens
-                                but will stop before writing them to remote source
+If you have additional ideas about how to make this project better, let us know by opening an issue! You can also open pull requests if you've worked on improving something yourself and would like to contribute back to the community. 
 
-DESCRIPTION
-  Supernova CLI description TODO
-
-EXAMPLES
-  $ @supernovaio/cli sync-design-tokens --apiKey="{key}" --workspaceId=123 --designSystemId=456 --brandName="Test" --input "{}"
-```
+We will be reviewing feature-pull-requests on case-by-case basis, but in general, we are super open to your new ideas and we welcome them! And finally, thank you for your support! You are an amazing community.
 
-_See code: [dist/commands/sync-design-tokens.ts](https://github.com/Supernova-Studio/cli/blob/v0.1.0/dist/commands/sync-design-tokens.ts)_
-<!-- commandsstop -->
+Supernova Engineering Team

package/dist/commands/{sync-design-tokens.d.ts → sync-tokens.d.ts}

@@ -1,27 +1,34 @@
 import { Command } from "@oclif/core";
-import { Brand, DesignSystem, DesignSystemVersion, Supernova } from "@supernovaio/supernova-sdk";
+import { DesignSystem, DesignSystemVersion, Supernova } from "@supernovaio/supernova-sdk";
+interface SyncDesignTokensFlags {
+    apiKey: string;
+    designSystemId: string;
+    tokenFilePath?: string;
+    tokenDirPath?: string;
+    configFilePath: string;
+    dev: boolean;
+}
 /** Command that handles synchronization with design tokens plugin */
 export declare class SyncDesignTokens extends Command {
     static description: string;
     static examples: string[];
     static aliases: [
-        "sync-design-tokens"
+        "sync-tokens"
     ];
     static flags: {
         apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string>;
         designSystemId: import("@oclif/core/lib/interfaces").OptionFlag<string>;
-        brandName: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
-        input: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
-        inputPath: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
-        dryRun: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        tokenFilePath: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
+        tokenDirPath: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
+        configFilePath: import("@oclif/core/lib/interfaces").OptionFlag<string>;
         dev: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     static args: never[];
     run(): Promise<void>;
-    getWritableBrand(flags: any): Promise<{
+    getWritableVersion(flags: SyncDesignTokensFlags): Promise<{
         instance: Supernova;
         designSystem: DesignSystem;
         version: DesignSystemVersion;
-        brand: Brand;
     }>;
 }
+export {};

package/dist/commands/sync-tokens.js

@@ -0,0 +1,81 @@
+"use strict";
+//
+//  sync-tokens.ts
+//  Supernova CLI
+//
+//  Created by Jiri Trecak.
+//  Copyright © 2022 Supernova.io. All rights reserved.
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncDesignTokens = void 0;
+// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+// MARK: - Imports
+const core_1 = require("@oclif/core");
+const supernova_sdk_1 = require("@supernovaio/supernova-sdk");
+// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+// MARK: - Configuration
+// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+// MARK: - Tool implementation
+/** Command that handles synchronization with design tokens plugin */
+class SyncDesignTokens extends core_1.Command {
+    // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+    // MARK: - Command runtime
+    async run() {
+        const { args, flags } = await this.parse(SyncDesignTokens);
+        // Get workspace -> design system –> version
+        let connected = await this.getWritableVersion(flags);
+        let dsTool = new supernova_sdk_1.SupernovaToolsDesignTokensPlugin(connected.version);
+        if (flags.tokenDirPath) {
+            await dsTool.synchronizeTokensFromDirectory(flags.tokenDirPath, flags.configFilePath);
+        }
+        else if (flags.tokenFilePath) {
+            await dsTool.synchronizeTokensFromFile(flags.tokenFilePath, flags.configFilePath);
+        }
+        this.log(`Tokens synchronized`);
+    }
+    async getWritableVersion(flags) {
+        if (!flags.apiKey || flags.apiKey.length === 0) {
+            throw new Error(`API key must not be empty`);
+        }
+        if (!flags.designSystemId || flags.designSystemId.length === 0) {
+            throw new Error(`Design System ID must not be empty`);
+        }
+        // Create instance for prod / dev
+        const devAPIhost = "https://dev.api2.supernova.io/api";
+        let sdkInstance = new supernova_sdk_1.Supernova(flags.apiKey, flags.dev ? devAPIhost : null, null);
+        let designSystem = await sdkInstance.designSystem(flags.designSystemId);
+        if (!designSystem) {
+            throw new Error(`Design system ${flags.designSystemId} not found or not available under provided API key`);
+        }
+        let version = await designSystem.activeVersion();
+        if (!version) {
+            throw new Error(`Design system  ${flags.designSystemId} writable version not found or not available under provided API key`);
+        }
+        return {
+            instance: sdkInstance,
+            designSystem: designSystem,
+            version: version
+        };
+    }
+}
+exports.SyncDesignTokens = SyncDesignTokens;
+// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+// MARK: - Command configuration
+// Command help description
+SyncDesignTokens.description = "Synchronize tokens from Figma Tokens plugin to Supernova workspaces";
+// Examples how to use the command
+SyncDesignTokens.examples = [
+    `$ @supernovaio/cli sync-tokens --apiKey="{xxx-xxx-xxx}" --designSystemId={1234} --tokenFilePath "/path/to/tokens.json" --configFilePath "/path/to/config.json"`,
+    `$ @supernovaio/cli sync-tokens --apiKey="{xxx-xxx-xxx}" --designSystemId={1234} --tokenDirPath "/path/to/tokens/" --configFilePath "/path/to/config.json"`,
+];
+// Static flags to enable / disable features
+SyncDesignTokens.flags = {
+    apiKey: core_1.Flags.string({ description: 'API key to use for accessing Supernova instance', required: true }),
+    designSystemId: core_1.Flags.string({ description: 'Design System to synchronize contents with', required: true }),
+    tokenFilePath: core_1.Flags.string({ description: 'Path to JSON file containing token definitions', exactlyOne: ["tokenDirPath", "tokenFilePath"] }),
+    tokenDirPath: core_1.Flags.string({ description: 'Path to directory of JSON files containing token definitions', exactlyOne: ["tokenDirPath", "tokenFilePath"] }),
+    configFilePath: core_1.Flags.string({ description: 'Path to configuration JSON file', required: true, exclusive: [] }),
+    dev: core_1.Flags.boolean({ description: 'When enabled, CLI will target dev server', hidden: true, default: false })
+};
+// Required and optional attributes
+SyncDesignTokens.args = [];

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"0.1.0","commands":{"sync-design-tokens":{"id":"sync-design-tokens","description":"Supernova CLI description TODO","strict":true,"pluginName":"@supernovaio/cli","pluginAlias":"@supernovaio/cli","pluginType":"core","aliases":[],"examples":["$ @supernovaio/cli sync-design-tokens --apiKey=\"{key}\" --workspaceId=123 --designSystemId=456 --brandName=\"Test\" --input \"{}\""],"flags":{"apiKey":{"name":"apiKey","type":"option","char":"k","description":"API key to use for accessing Supernova instance","required":true,"multiple":false},"designSystemId":{"name":"designSystemId","type":"option","char":"d","description":"Design System to synchronize contents with","required":true,"multiple":false},"brandName":{"name":"brandName","type":"option","char":"b","description":"Brand to synchronize contents with","required":false,"multiple":false},"input":{"name":"input","type":"option","char":"i","description":"Contents of design tokens plugin definition JSON file","required":false,"multiple":false,"exclusive":["inputPath"]},"inputPath":{"name":"inputPath","type":"option","char":"p","description":"Contents of design tokens plugin definition JSON file","required":false,"multiple":false,"exclusive":["input"]},"dryRun":{"name":"dryRun","type":"boolean","char":"r","description":"When enabled, CLI will validate entire setup including loading/parsing/merging of tokens but will stop before writing them to remote source","required":false,"allowNo":false},"dev":{"name":"dev","type":"boolean","description":"When enabled, CLI will target dev server","hidden":true,"allowNo":false}},"args":[],"_globalFlags":{}}}}
+{"version":"0.9.0","commands":{"sync-tokens":{"id":"sync-tokens","description":"Synchronize tokens from Figma Tokens plugin to Supernova workspaces","strict":true,"pluginName":"@supernovaio/cli","pluginAlias":"@supernovaio/cli","pluginType":"core","aliases":[],"examples":["$ @supernovaio/cli sync-tokens --apiKey=\"{xxx-xxx-xxx}\" --designSystemId={1234} --tokenFilePath \"/path/to/tokens.json\" --configFilePath \"/path/to/config.json\"","$ @supernovaio/cli sync-tokens --apiKey=\"{xxx-xxx-xxx}\" --designSystemId={1234} --tokenDirPath \"/path/to/tokens/\" --configFilePath \"/path/to/config.json\""],"flags":{"apiKey":{"name":"apiKey","type":"option","description":"API key to use for accessing Supernova instance","required":true,"multiple":false},"designSystemId":{"name":"designSystemId","type":"option","description":"Design System to synchronize contents with","required":true,"multiple":false},"tokenFilePath":{"name":"tokenFilePath","type":"option","description":"Path to JSON file containing token definitions","multiple":false},"tokenDirPath":{"name":"tokenDirPath","type":"option","description":"Path to directory of JSON files containing token definitions","multiple":false},"configFilePath":{"name":"configFilePath","type":"option","description":"Path to configuration JSON file","required":true,"multiple":false,"exclusive":[]},"dev":{"name":"dev","type":"boolean","description":"When enabled, CLI will target dev server","hidden":true,"allowNo":false}},"args":[],"_globalFlags":{}}}}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@supernovaio/cli",
     "description": "Supernova.io Command Line Interface",
-    "version": "0.1.0",
+    "version": "0.9.0",
     "author": "Supernova.io",
     "homepage": "https://supernova.io/",
     "keywords": [
@@ -25,11 +25,13 @@
         "@oclif/core": "^1",
         "@oclif/plugin-help": "^5",
         "@oclif/plugin-plugins": "^2.0.1",
-        "@supernovaio/supernova-sdk": "^1.7.6",
+        "@supernovaio/supernova-sdk": "^1.8.10",
         "chalk": "^5.0.1",
-        "node-fetch": "^3.2.4"
+        "node-fetch": "^3.2.4",
+        "dotenv": "^16.0.0"
     },
     "devDependencies": {
+        "@babel/register": "^7.18.9",
         "@oclif/test": "^2",
         "@types/chai": "^4",
         "@types/mocha": "^9.0.0",
@@ -44,7 +46,10 @@
         "shx": "^0.3.3",
         "ts-node": "^10.2.1",
         "tslib": "^2.3.1",
-        "typescript": "^4.4.3"
+        "typescript": "^4.4.3",
+        "@babel/core": "^7.9.0",
+        "@babel/preset-env": "^7.3.4",
+        "@babel/preset-react": "7.18.6"
     },
     "engines": {
         "node": ">=12.0.0"
@@ -66,8 +71,8 @@
         ],
         "topicSeparator": " ",
         "topics": {
-            "sync-design-tokens": {
-                "description": "Synchronize tokens between design tokens plugin and Supernova design system"
+            "sync-tokens": {
+                "description": "Synchronize tokens from Figma Tokens plugin to Supernova workspaces"
             }
         }
     },
@@ -77,9 +82,8 @@
         "lint": "eslint . --ext .ts --config .eslintrc",
         "postpack": "shx rm -f oclif.manifest.json",
         "posttest": "yarn lint",
-        "prepack": "yarn build && oclif manifest && oclif readme",
-        "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-        "version": "oclif readme && git add README.md",
+        "prepack": "yarn build && oclif manifest",
+        "test": "npm run build && env TS_NODE_PROJECT=\"tsconfig.testing.json\" mocha --require ts-node/register --forbid-only \"test/**/*.test.ts\"",
         "publish-package": "npm run build && npm run prepack && npm publish --access public && npm run postpack"
     },
     "types": "dist/index.d.ts"

package/dist/commands/sync-design-tokens.js

@@ -1,103 +0,0 @@
-"use strict";
-//
-//  CommandSyncDesignTokens.ts
-//  Supernova SDK
-//
-//  Created by Jiri Trecak.
-//  Copyright © 2021 Supernova. All rights reserved.
-//
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SyncDesignTokens = void 0;
-// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
-// MARK: - Imports
-const core_1 = require("@oclif/core");
-const supernova_sdk_1 = require("@supernovaio/supernova-sdk");
-// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
-// MARK: - Configuration
-// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
-// MARK: - Tool implementation
-/** Command that handles synchronization with design tokens plugin */
-class SyncDesignTokens extends core_1.Command {
-    // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
-    // MARK: - Command runtime
-    async run() {
-        const { args, flags } = await this.parse(SyncDesignTokens);
-        // Get workspace -> design system –> version -> brand
-        let connected = await this.getWritableBrand(flags);
-        let dsTool = new supernova_sdk_1.SupernovaToolsDesignTokensPlugin(connected.instance, connected.version, connected.brand);
-        // Load from either flag or raw input, depending on what was set
-        if (flags.input && flags.inputPath) {
-            throw new Error("Unable to use both input and inputPath arguments at the same time. Choose one of them first and then run command again");
-        }
-        if (!flags.input && !flags.inputPath) {
-            throw new Error("Either input or inputPath arguments must be provided and non-empty. Choose one of them first and then run command again");
-        }
-        let nodes;
-        this.log(JSON.stringify(flags, null, 2));
-        if (flags.input) {
-            nodes = await dsTool.loadTokensFromDefinition(flags.input);
-        }
-        else if (flags.inputPath) {
-            nodes = await dsTool.loadTokensFromPath(flags.inputPath);
-        }
-        else {
-            throw new Error("Internal input error");
-        }
-        // Write tokens
-        let merged = await dsTool.mergeWithRemoteSource(nodes.processedNodes, !flags.dryRun);
-        this.log(`Synchronization done | Written or updated ${merged.tokens.length} tokens, ${merged.groups.length} groups`);
-    }
-    async getWritableBrand(flags) {
-        // Create instance for prod / dev
-        let supernova = new supernova_sdk_1.Supernova(flags.apiKey, flags.dev ? "https://dev.api2.supernova.io/api" : null, null);
-        let designSystem = await supernova.designSystem(flags.designSystemId);
-        if (!designSystem) {
-            throw new Error(`Design system ${flags.designSystemId} not found or not available under provided API key`);
-        }
-        let version = await designSystem.activeVersion();
-        if (!version) {
-            throw new Error(`Design system  ${flags.designSystemId} writable version not found or not available under provided API key`);
-        }
-        let brands = await version.brands();
-        let brand = undefined;
-        if (!brands) {
-            throw new Error(`Unable to retrieve brands for design system ${flags.designSystemId} or not available under provided API key`);
-        }
-        if (flags.brandName) {
-            brand = brands.filter(f => f.name.trim() === flags.brandName.trim())[0];
-        }
-        else {
-            brand = brands[0];
-        }
-        if (!brand) {
-            throw new Error(`No usable brand found in design system ${flags.designSystemId}`);
-        }
-        return {
-            instance: supernova,
-            designSystem: designSystem,
-            version: version,
-            brand: brand
-        };
-    }
-}
-exports.SyncDesignTokens = SyncDesignTokens;
-// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
-// MARK: - Command configuration
-// Command help description
-SyncDesignTokens.description = "Supernova CLI description TODO";
-// Examples how to use the command
-SyncDesignTokens.examples = [
-    `$ @supernovaio/cli sync-design-tokens --apiKey="{key}" --workspaceId=123 --designSystemId=456 --brandName="Test" --input "{}"`,
-];
-// Static flags to enable / disable features
-SyncDesignTokens.flags = {
-    apiKey: core_1.Flags.string({ char: 'k', description: 'API key to use for accessing Supernova instance', required: true }),
-    designSystemId: core_1.Flags.string({ char: 'd', description: 'Design System to synchronize contents with', required: true }),
-    brandName: core_1.Flags.string({ char: 'b', description: 'Brand to synchronize contents with', required: false }),
-    input: core_1.Flags.string({ char: 'i', description: 'Contents of design tokens plugin definition JSON file', required: false, exclusive: ['inputPath'] }),
-    inputPath: core_1.Flags.string({ char: 'p', description: 'Contents of design tokens plugin definition JSON file', required: false, exclusive: ['input'] }),
-    dryRun: core_1.Flags.boolean({ char: 'r', description: 'When enabled, CLI will validate entire setup including loading/parsing/merging of tokens but will stop before writing them to remote source', required: false }),
-    dev: core_1.Flags.boolean({ description: 'When enabled, CLI will target dev server', hidden: true })
-};
-// Required and optional attributes
-SyncDesignTokens.args = [];