@supernovaio/cli-next 2.0.1

package/README.md

@@ -0,0 +1,201 @@
+<img src="https://github.com/Supernova-Studio/cli/blob/main/docs/images/cli.png?raw=true" alt="Supernova CLI" style="max-width:100%; margin-bottom: 20px;" />
+
+# Supernova CLI [![All passing](https://img.shields.io/badge/Test-passing-success)]() [![CLI Status](https://img.shields.io/badge/CLI%20Status-Beta-blue)]() [![Version 0.9.13](https://img.shields.io/badge/Version-0.9.13-success)]()
+
+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.
+
+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!
+
+### Installing CLI globally
+
+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:
+
+```
+npm install -g @supernovaio/cli
+yarn global add @supernovaio/cli
+```
+
+You can now test that everything was properly set up by running the `supernova` command:
+
+```
+~ % supernova --version
+> @supernovaio/cli/1.x.x ...
+```
+
+`Node 21` or newer environment is required to run the Supernova CLI.
+
+### Updating CLI globally
+
+You can update globally installed CLI by running npm update command on the package:
+
+```
+npm update -g @supernovaio/cli
+yarn global upgrade @supernovaio/cli
+```
+
+This will upgrade the CLI to the latest version and make it immediately last default used version.
+
+## Login Command
+
+The login command is a crucial part of the Supernova CLI, as it establishes authentication required before using any other commands. This section explains how the login process works and how to use it effectively.
+### Overview
+The login command authenticates you with Supernova services using a secure OAuth flow with PKCE (Proof Key for Code Exchange). This authentication method is secure and follows modern best practices for CLI authorization.
+``` bash
+supernova login
+```
+### How It Works
+The login process follows these steps:
+1. **Initiate Authentication**: The CLI generates a secure code challenge using PKCE.
+2. **Browser Authentication**: Your default browser will open automatically to Supernova's authentication page.
+3. **Authorization**: Complete the authentication in your browser.
+4. **Token Storage**: Once authenticated, the CLI securely stores your tokens for future use.
+5. **Completion**: You'll see a confirmation message when successfully logged in.
+
+### Command Options
+
+| Flag | Description |
+| --- | --- |
+| `--environment` | Specify the environment (production by default) |
+### Token Storage
+Your authentication tokens are securely stored using one of the following methods:
+1. **System Keychain** (Primary method): The CLI uses your operating system's secure credential store.
+2. **Local File** (Fallback): If keychain access fails, tokens are stored in . `~/.supernova/tokens.json`
+3. **Environment Variable**: You can bypass the login process by setting the environment variable. `SUPERNOVA_TOKEN`
+
+### Automatic Token Refresh
+The CLI automatically handles token refreshing:
+- Tokens nearing expiration (within 5 minutes) are automatically refreshed.
+- If a refresh token fails, you'll be prompted to log in again.
+
+### Usage Examples
+Standard login to production environment:
+``` bash
+supernova login
+```
+Login to a specific environment:
+``` bash
+supernova login --environment=staging
+```
+### Troubleshooting
+If your browser doesn't open automatically, the CLI will display a URL that you can manually copy and paste into your browser to complete the authentication process.
+If you encounter authentication issues, you can try:
+1. Running the login command again
+2. Checking your internet connection
+3. Ensuring you have the correct permissions in Supernova
+
+### Important Notes
+- You must complete the authentication process within 5 minutes (300 seconds)
+- All other CLI commands will verify authentication before execution
+- To log out, you can use the `logout` command (which removes stored tokens)
+
+## Configuration File
+The Supernova CLI supports configuration files to streamline your workflow by persisting command options and preferences.
+
+### Overview
+When working with Supernova CLI, you can use a configuration file named located in your current working directory. This file stores your command-specific options, eliminating the need to repeatedly provide the same flags and parameters in subsequent commands. `.supernova.json`
+
+### File Structure
+The configuration file uses a simple JSON structure:
+``` json
+{
+  "commands": {
+    "command-name": {
+      "option1": "value1",
+      "option2": "value2"
+    }
+  },
+  "global": {}
+}
+```
+
+The file consists of two main sections:
+- **commands**: Contains configurations for specific CLI commands, organized by command ID
+- **global**: Reserved for future global settings that apply across all commands 
+
+### How Configuration Works
+The configuration system operates through the following mechanisms:
+1. **Automatic Loading**: When you run a command, the CLI checks for a file in your current directory `.supernova.json`
+2. **Command Options**: Any options defined in the configuration file for the current command are automatically applied
+3. **Override Precedence**: Command-line flags take precedence over configuration file values
+4. **Automatic Saving**: After a successful command execution, the CLI saves the used options back to the configuration file
+
+### Example Configuration
+Here's an example of a configuration file for token synchronization:
+``` json
+{
+  "commands": {
+    "login": {
+      "environment": "production"
+    },
+    "figma-tokens-sync": {
+      "mode": "single-file",
+      "dryRun": false
+    }
+  },
+  "global": {}
+}
+```
+
+### Benefits
+Using the configuration file offers several advantages:
+- **Simplifies Command Usage**: No need to repeatedly type the same options
+- **Improves Workflow Efficiency**: Saves time and reduces errors when executing commands
+- **Enhances Team Collaboration**: Share consistent settings across your team by committing the configuration file to version control
+- **Supports CI/CD Integration**: Makes it easier to integrate CLI commands into automated pipelines
+
+### Command-Specific Configuration
+Each command can store its specific configuration options. For example:
+1. **Login Command**: Stores the target environment
+``` json
+   "login": {
+     "environment": "production"
+   }
+```
+1. **Import Storybook Command**: Stores paths and IDs needed for importing
+``` json
+   "import-storybook": {
+     "environment": "production",
+     "dir": "./storybook-static",
+     "designSystemId": "37355",
+     "versionId": "37352"
+   }
+```
+### Managing Configuration
+The CLI handles configuration automatically:
+- **Required Flags**: If a required flag has a value in the configuration file, it becomes optional in the command line
+- **Updating Values**: When you provide a flag in the command line, its value is saved back to the configuration file for future use
+- **Feedback**: The CLI will inform you when configuration is loaded and saved
+
+### Best Practices
+- **Version Control**: Consider adding the file to version control if you want to share settings with your team `.supernova.json`
+- **Sensitive Information**: Avoid storing sensitive information in the configuration file as it might be committed to version control
+
+### Troubleshooting
+If you encounter issues with your configuration:
+1. **Check File Format**: Ensure the JSON is valid and properly formatted
+2. **Check Permissions**: Ensure the CLI has write permissions in the current directory
+3. **Reset Configuration**: Simply delete the file to start fresh `.supernova.json`
+
+By leveraging the configuration file, you can significantly streamline your workflow when working with the Supernova CLI.
+
+
+## Next Steps
+After successfully logging in, you can use other Supernova CLI commands. 
+See the additional use cases section for more information about available commands.
+
+
+### Use cases
+
+Following is the list of use cases for Supernova CLI. We will be adding more over time, stay tuned!
+
+- [Host private storybook](./docs/storybook-hosting.md)
+- [Synchronize Figma Token Plugin data](./docs/figma-tokens-sync.md)
+- [List workspaces, design systems, brands and themes](./docs/list-workspaces.md)
+
+## Contributions
+
+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. 
+
+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.
+
+Supernova Engineering Team

package/bin/dev

@@ -0,0 +1,7 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+process.env.NODE_ENV = 'development'
+
+await execute({development: true, dir: import.meta.url})

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/run

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+import {execute, handle} from '@oclif/core'
+import * as Sentry from '@sentry/node'
+import {nodeProfilingIntegration} from '@sentry/profiling-node'
+import dotenv from 'dotenv'
+
+// Load environment variables from .env file
+dotenv.config()
+
+const SENSITIVE_KEYS = new Set(['password', 'secret', 'token'])
+
+const sanitizeEvent = (event) => {
+  if (event.request?.data) {
+    event.request.data = maskValues(event.request.data)
+  }
+
+  return event
+}
+
+const sanitizeBreadcrumb = (breadcrumb) => {
+  if (breadcrumb.data) {
+    breadcrumb.data = maskValues(breadcrumb.data)
+  }
+
+  return breadcrumb
+}
+
+// eslint-disable-next-line unicorn/no-array-reduce
+const maskValues = (obj) =>
+  Object.keys(obj).reduce((acc, key) => {
+    acc[key] = SENSITIVE_KEYS.has(key) ? '[REDACTED]' : obj[key]
+    return acc
+  }, {})
+
+Sentry.init({
+  beforeBreadcrumb(breadcrumb) {
+    return sanitizeBreadcrumb(breadcrumb)
+  },
+  beforeSend(event) {
+    return sanitizeEvent(event)
+  },
+  beforeSendTransaction(transaction) {
+    return sanitizeEvent(transaction)
+  },
+  debug: false,
+  dsn: 'https://9d6591df6378a22920996bd4d12722e3@o337704.ingest.us.sentry.io/4508840260730880',
+  ignoreErrors: ['NotAuthorizedError'],
+  integrations: [nodeProfilingIntegration()],
+  profilesSampleRate: 1,
+  tracesSampleRate: 1,
+})
+
+await Sentry.startSpan({name: 'cli', forceTransaction: true}, () =>
+  execute({dir: import.meta.url}).catch((err) => handle(err)),
+)
+await Sentry.flush(1000)

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/dist/commands/describe-design-system.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { Environment, SentryCommand } from "../types/index.js";
+declare const DescribeDesignSystemConfigSchema: z.ZodEffects<z.ZodObject<{
+    apiKey: z.ZodString;
+    designSystemId: z.ZodString;
+    environment: z.ZodNativeEnum<typeof Environment>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    designSystemId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}, {
+    designSystemId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}>, {
+    environment: Environment;
+    designSystemId: string;
+    apiKey: string;
+    proxyUrl?: string | undefined;
+}, {
+    designSystemId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}>;
+type DescribeDesignSystemConfig = z.infer<typeof DescribeDesignSystemConfigSchema>;
+export declare class DescribeDesignSystem extends SentryCommand<DescribeDesignSystemConfig> {
+    static aliases: ["describe-design-system"];
+    static description: string;
+    static examples: string[];
+    static flags: {
+        apiKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        designSystemId: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        proxyUrl: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    get commandId(): string;
+    get configSchema(): z.ZodType<DescribeDesignSystemConfig>;
+    run(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=describe-design-system.d.ts.map

package/dist/commands/describe-design-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-design-system.d.ts","sourceRoot":"","sources":["../../src/commands/describe-design-system.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAS,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAYrE,QAAA,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;EAUjC,CAAA;AAEL,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAGlF,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,0BAA0B,CAAC;IAKjF,OAAgB,OAAO,EAAE,CAAC,wBAAwB,CAAC,CAAA;IAEnD,OAAgB,WAAW,SAA8D;IAEzF,OAAgB,QAAQ,WAEvB;IAED,OAAgB,KAAK;;;;;MASpB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,YAAY,IAAI,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAExD;IAMK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB3B"}

package/dist/commands/describe-design-system.js

@@ -0,0 +1,75 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Flags } from "@oclif/core";
+import { SentryTraced } from "@sentry/nestjs";
+import { z } from "zod";
+import { Environment, flags, SentryCommand } from "../types/index.js";
+import { getWritableVersion } from "../utils/sdk.js";
+const DescribeDesignSystemConfigSchema = z
+    .object({
+    apiKey: z.string(),
+    designSystemId: z.string(),
+    environment: z.nativeEnum(Environment),
+    proxyUrl: z.string().url().optional(),
+})
+    .transform(data => ({
+    ...data,
+    environment: data.environment ?? Environment.production,
+}));
+export class DescribeDesignSystem extends SentryCommand {
+    static aliases;
+    static description = "Describe structure of single design system by provided ID";
+    static examples = [
+        `$ @supernovaio/cli describe-design-system --apiKey="{xxx-xxx-xxx}" --designSystemId="{1234}"`,
+    ];
+    static flags = {
+        ...flags,
+        apiKey: Flags.string({ description: "API key to use for accessing Supernova instance", required: true }),
+        designSystemId: Flags.string({ description: "Design System to describe structure of", required: true }),
+        proxyUrl: Flags.string({
+            description: "When set, CLI will use provided proxy URL for all requests",
+            hidden: true,
+            required: false,
+        }),
+    };
+    get commandId() {
+        return DescribeDesignSystem.id;
+    }
+    get configSchema() {
+        return DescribeDesignSystemConfigSchema;
+    }
+    async run() {
+        const { flags } = await this.parse(DescribeDesignSystem);
+        const { designSystem, id, instance } = await getWritableVersion(flags);
+        const brands = await instance.brands.getBrands(id);
+        const themes = await instance.tokens.getTokenThemes(id);
+        this.log(`\n↳ Design system "${designSystem.name}", id: ${designSystem.id}`.cyan);
+        for (const brand of brands) {
+            this.log(`  ↳ Brand: "${brand.name}", id: ${brand.id}`);
+            const brandThemes = themes.filter(t => t.brandId === brand.id);
+            if (brandThemes.length > 0) {
+                for (const theme of brandThemes) {
+                    this.log(`    ↳ Theme: "${theme.name}", id: ${theme.id}`);
+                }
+            }
+            else {
+                this.log(`    ↳ No themes defined in this brand`.gray);
+            }
+        }
+        this.log("\nDone".green);
+    }
+}
+__decorate([
+    SentryTraced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DescribeDesignSystem.prototype, "run", null);
+//# sourceMappingURL=describe-design-system.js.map

package/dist/commands/describe-design-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-design-system.js","sourceRoot":"","sources":["../../src/commands/describe-design-system.ts"],"names":[],"mappings":"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","sourcesContent":["//\n//  describe-design-system.ts\n//  Supernova CLI\n//\n//  Created by Jiri Trecak.\n//  Copyright © Supernova.io. All rights reserved.\n//\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Imports\n\nimport { Flags } from \"@oclif/core\"\nimport { SentryTraced } from \"@sentry/nestjs\"\nimport { z } from \"zod\"\n\nimport { Environment, flags, SentryCommand } from \"../types/index.js\"\nimport { getWritableVersion } from \"../utils/sdk.js\"\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Definition\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Configuration\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Tool implementation\n\nconst DescribeDesignSystemConfigSchema = z\n  .object({\n    apiKey: z.string(),\n    designSystemId: z.string(),\n    environment: z.nativeEnum(Environment),\n    proxyUrl: z.string().url().optional(),\n  })\n  .transform(data => ({\n    ...data,\n    environment: data.environment ?? Environment.production,\n  }))\n\ntype DescribeDesignSystemConfig = z.infer<typeof DescribeDesignSystemConfigSchema>\n\n/** Command that describes the structure of provided design system */\nexport class DescribeDesignSystem extends SentryCommand<DescribeDesignSystemConfig> {\n  // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n  // MARK: - Command configuration\n\n  // How this command can be run\n  static override aliases: [\"describe-design-system\"]\n  // Command help description\n  static override description = \"Describe structure of single design system by provided ID\"\n  // Examples how to use the command\n  static override examples = [\n    `$ @supernovaio/cli describe-design-system --apiKey=\"{xxx-xxx-xxx}\" --designSystemId=\"{1234}\"`,\n  ]\n  // Static flags to enable / disable features\n  static override flags = {\n    ...flags,\n    apiKey: Flags.string({ description: \"API key to use for accessing Supernova instance\", required: true }),\n    designSystemId: Flags.string({ description: \"Design System to describe structure of\", required: true }),\n    proxyUrl: Flags.string({\n      description: \"When set, CLI will use provided proxy URL for all requests\",\n      hidden: true,\n      required: false,\n    }),\n  }\n\n  get commandId(): string {\n    return DescribeDesignSystem.id\n  }\n\n  get configSchema(): z.ZodType<DescribeDesignSystemConfig> {\n    return DescribeDesignSystemConfigSchema\n  }\n\n  // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n  // MARK: - Command runtime\n\n  @SentryTraced()\n  async run(): Promise<void> {\n    const { flags } = await this.parse(DescribeDesignSystem)\n\n    // Get workspace -> design system –> version\n    const { designSystem, id, instance } = await getWritableVersion(flags)\n\n    // Get brands and themes\n    const brands = await instance.brands.getBrands(id)\n    const themes = await instance.tokens.getTokenThemes(id)\n\n    this.log(`\\n↳ Design system \"${designSystem.name}\", id: ${designSystem.id}`.cyan)\n    for (const brand of brands) {\n      this.log(`  ↳ Brand: \"${brand.name}\", id: ${brand.id}`)\n      const brandThemes = themes.filter(t => t.brandId === brand.id)\n      if (brandThemes.length > 0) {\n        for (const theme of brandThemes) {\n          this.log(`    ↳ Theme: \"${theme.name}\", id: ${theme.id}`)\n        }\n      } else {\n        this.log(`    ↳ No themes defined in this brand`.gray)\n      }\n    }\n\n    this.log(\"\\nDone\".green)\n  }\n}\n"]}

package/dist/commands/describe-workspaces.d.ts

@@ -0,0 +1,54 @@
+import * as sdkTypes from "@supernovaio/sdk";
+import { z, ZodType } from "zod";
+import { Environment, SentryCommand } from "../types/index.js";
+interface DescribeWorkspacesFlags {
+    apiKey: string;
+    environment: string;
+    proxyUrl?: string;
+}
+declare const DescribeWorkspaceConfigSchema: z.ZodEffects<z.ZodObject<{
+    apiKey: z.ZodString;
+    environment: z.ZodNativeEnum<typeof Environment>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspaceId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}, {
+    workspaceId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}>, {
+    environment: Environment;
+    workspaceId: string;
+    apiKey: string;
+    proxyUrl?: string | undefined;
+}, {
+    workspaceId: string;
+    apiKey: string;
+    environment: Environment;
+    proxyUrl?: string | undefined;
+}>;
+type DescribeWorkspaceConfig = z.infer<typeof DescribeWorkspaceConfigSchema>;
+export declare class DescribeWorkspaces extends SentryCommand<DescribeWorkspaceConfig> {
+    static aliases: ["describe-workspaces"];
+    static description: string;
+    static examples: string[];
+    static flags: {
+        apiKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        proxyUrl: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    get commandId(): string;
+    get configSchema(): ZodType<DescribeWorkspaceConfig>;
+    getWorkspaces(flags: DescribeWorkspacesFlags): Promise<{
+        instance: sdkTypes.Supernova;
+        workspaces: Array<sdkTypes.Workspace>;
+    }>;
+    run(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=describe-workspaces.d.ts.map

package/dist/commands/describe-workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-workspaces.d.ts","sourceRoot":"","sources":["../../src/commands/describe-workspaces.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAA;AAE5C,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAEhC,OAAO,EAAE,WAAW,EAAS,aAAa,EAAE,MAAM,mBAAmB,CAAA;AASrE,UAAU,uBAAuB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAKD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;EAU9B,CAAA;AAEL,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAM5E,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IAK5E,MAAM,CAAC,OAAO,EAAE,CAAC,qBAAqB,CAAC,CAAA;IAEvC,MAAM,CAAC,WAAW,SAC0G;IAE5H,MAAM,CAAC,QAAQ,WAAsE;IAErF,MAAM,CAAC,KAAK;;;;MAQX;IAKD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAEnD;IAGK,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC;QAC3D,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAA;QAC5B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;KACtC,CAAC;IAqBI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C3B"}

package/dist/commands/describe-workspaces.js

@@ -0,0 +1,111 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Flags } from "@oclif/core";
+import { SentryTraced } from "@sentry/nestjs";
+import { createRequire } from "node:module";
+import { z } from "zod";
+import { Environment, flags, SentryCommand } from "../types/index.js";
+import { environmentAPI } from "../utils/network.js";
+const require = createRequire(import.meta.url);
+const sdkProvider = require("@supernovaio/sdk");
+const DescribeWorkspaceConfigSchema = z
+    .object({
+    apiKey: z.string(),
+    environment: z.nativeEnum(Environment),
+    proxyUrl: z.string().url().optional(),
+    workspaceId: z.string(),
+})
+    .transform(data => ({
+    ...data,
+    environment: data.environment ?? Environment.production,
+}));
+export class DescribeWorkspaces extends SentryCommand {
+    static aliases;
+    static description = "Describe structure of all workspaces and design systems available under those workspaces available for specified API key";
+    static examples = [`$ @supernovaio/cli describe-workspaces --apiKey="{xxx-xxx-xxx}"`];
+    static flags = {
+        ...flags,
+        apiKey: Flags.string({ description: "API key to use for accessing Supernova instance", required: true }),
+        proxyUrl: Flags.string({
+            description: "When set, CLI will use provided proxy URL for all requests",
+            hidden: true,
+            required: false,
+        }),
+    };
+    get commandId() {
+        return DescribeWorkspaces.id;
+    }
+    get configSchema() {
+        return DescribeWorkspaceConfigSchema;
+    }
+    async getWorkspaces(flags) {
+        if (!flags.apiKey || flags.apiKey.length === 0) {
+            throw new Error(`API key must not be empty`);
+        }
+        const apiUrl = environmentAPI(flags.environment, "v2");
+        const sdkInstance = new sdkProvider.Supernova(flags.apiKey, {
+            apiUrl,
+            bypassEnvFetch: true,
+            proxyUrl: flags.proxyUrl,
+        });
+        const user = await sdkInstance.me.me();
+        const workspaces = await sdkInstance.workspaces.workspaces(user.id);
+        return {
+            instance: sdkInstance,
+            workspaces,
+        };
+    }
+    async run() {
+        const { flags } = await this.parse(DescribeWorkspaces);
+        const { instance, workspaces } = await this.getWorkspaces(flags);
+        this.log(`\n`);
+        for (const workspace of workspaces) {
+            const designSystems = await instance.designSystems.designSystems(workspace.id);
+            this.log(`↳ Workspace "${workspace.profile.name}", id: ${workspace.id}`.magenta);
+            for (const designSystem of designSystems) {
+                this.log(`  ↳ Design system "${designSystem.name}", id: ${designSystem.id}`.cyan);
+                const version = await instance.versions.getActiveVersion(designSystem.id);
+                if (!version) {
+                    this.log(`Design system  ${designSystem.id} active version not found or not available under provided API key`);
+                    continue;
+                }
+                const id = { designSystemId: designSystem.id, versionId: version.id };
+                const brands = await instance.brands.getBrands(id);
+                const themes = await instance.tokens.getTokenThemes(id);
+                for (const brand of brands) {
+                    this.log(`    ↳ Brand: "${brand.name}", id: ${brand.id}`);
+                    const brandThemes = themes.filter(t => t.brandId === brand.id);
+                    if (brandThemes.length > 0) {
+                        for (const theme of brandThemes) {
+                            this.log(`      ↳ Theme: "${theme.name}", id: ${theme.id}`.gray);
+                        }
+                    }
+                    else {
+                        this.log(`      ↳ No themes defined in this brand`.gray);
+                    }
+                }
+            }
+        }
+        this.log("\nDone".green);
+    }
+}
+__decorate([
+    SentryTraced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DescribeWorkspaces.prototype, "getWorkspaces", null);
+__decorate([
+    SentryTraced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], DescribeWorkspaces.prototype, "run", null);
+//# sourceMappingURL=describe-workspaces.js.map

package/dist/commands/describe-workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-workspaces.js","sourceRoot":"","sources":["../../src/commands/describe-workspaces.ts"],"names":[],"mappings":"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","sourcesContent":["//\n//  describe-workspaces.ts\n//  Supernova CLI\n//\n//  Created by Jiri Trecak.\n//  Copyright © Supernova.io. All rights reserved.\n//\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Imports\n\nimport { Flags } from \"@oclif/core\"\nimport { SentryTraced } from \"@sentry/nestjs\"\nimport * as sdkTypes from \"@supernovaio/sdk\"\nimport { createRequire } from \"node:module\"\nimport { z, ZodType } from \"zod\"\n\nimport { Environment, flags, SentryCommand } from \"../types/index.js\"\nimport { environmentAPI } from \"../utils/network.js\"\n\nconst require = createRequire(import.meta.url)\nconst sdkProvider = require(\"@supernovaio/sdk\") as typeof sdkTypes\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Definition\n\ninterface DescribeWorkspacesFlags {\n  apiKey: string\n  environment: string\n  proxyUrl?: string\n}\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Configuration\n\nconst DescribeWorkspaceConfigSchema = z\n  .object({\n    apiKey: z.string(),\n    environment: z.nativeEnum(Environment),\n    proxyUrl: z.string().url().optional(),\n    workspaceId: z.string(),\n  })\n  .transform(data => ({\n    ...data,\n    environment: data.environment ?? Environment.production,\n  }))\n\ntype DescribeWorkspaceConfig = z.infer<typeof DescribeWorkspaceConfigSchema>\n\n// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n// MARK: - Tool implementation\n\n/** Command that describes the structure of provided design system */\nexport class DescribeWorkspaces extends SentryCommand<DescribeWorkspaceConfig> {\n  // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n  // MARK: - Command configuration\n\n  // How this command can be run\n  static aliases: [\"describe-workspaces\"]\n  // Command help description\n  static description =\n    \"Describe structure of all workspaces and design systems available under those workspaces available for specified API key\"\n  // Examples how to use the command\n  static examples = [`$ @supernovaio/cli describe-workspaces --apiKey=\"{xxx-xxx-xxx}\"`]\n  // Static flags to enable / disable features\n  static flags = {\n    ...flags,\n    apiKey: Flags.string({ description: \"API key to use for accessing Supernova instance\", required: true }),\n    proxyUrl: Flags.string({\n      description: \"When set, CLI will use provided proxy URL for all requests\",\n      hidden: true,\n      required: false,\n    }),\n  }\n\n  // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---\n  // MARK: - Command runtime\n\n  get commandId(): string {\n    return DescribeWorkspaces.id\n  }\n\n  get configSchema(): ZodType<DescribeWorkspaceConfig> {\n    return DescribeWorkspaceConfigSchema\n  }\n\n  @SentryTraced()\n  async getWorkspaces(flags: DescribeWorkspacesFlags): Promise<{\n    instance: sdkTypes.Supernova\n    workspaces: Array<sdkTypes.Workspace>\n  }> {\n    if (!flags.apiKey || flags.apiKey.length === 0) {\n      throw new Error(`API key must not be empty`)\n    }\n\n    // Create instance for prod / dev\n    const apiUrl = environmentAPI(flags.environment as Environment, \"v2\")\n    const sdkInstance = new sdkProvider.Supernova(flags.apiKey, {\n      apiUrl,\n      bypassEnvFetch: true,\n      proxyUrl: flags.proxyUrl,\n    })\n    const user = await sdkInstance.me.me()\n    const workspaces = await sdkInstance.workspaces.workspaces(user.id)\n    return {\n      instance: sdkInstance,\n      workspaces,\n    }\n  }\n\n  @SentryTraced()\n  async run(): Promise<void> {\n    const { flags } = await this.parse(DescribeWorkspaces)\n\n    // Get workspaces\n    const { instance, workspaces } = await this.getWorkspaces(flags)\n    this.log(`\\n`)\n\n    for (const workspace of workspaces) {\n      // Get design systems and log\n      // eslint-disable-next-line no-await-in-loop\n      const designSystems = await instance.designSystems.designSystems(workspace.id)\n      this.log(`↳ Workspace \"${workspace.profile.name}\", id: ${workspace.id}`.magenta)\n      for (const designSystem of designSystems) {\n        this.log(`  ↳ Design system \"${designSystem.name}\", id: ${designSystem.id}`.cyan)\n        // eslint-disable-next-line no-await-in-loop\n        const version = await instance.versions.getActiveVersion(designSystem.id)\n        if (!version) {\n          this.log(`Design system  ${designSystem.id} active version not found or not available under provided API key`)\n          continue\n        }\n\n        const id: sdkTypes.RemoteVersionIdentifier = { designSystemId: designSystem.id, versionId: version.id }\n        // eslint-disable-next-line no-await-in-loop\n        const brands = await instance.brands.getBrands(id)\n        // eslint-disable-next-line no-await-in-loop\n        const themes = await instance.tokens.getTokenThemes(id)\n        for (const brand of brands) {\n          this.log(`    ↳ Brand: \"${brand.name}\", id: ${brand.id}`)\n          const brandThemes = themes.filter(t => t.brandId === brand.id)\n          if (brandThemes.length > 0) {\n            for (const theme of brandThemes) {\n              this.log(`      ↳ Theme: \"${theme.name}\", id: ${theme.id}`.gray)\n            }\n          } else {\n            this.log(`      ↳ No themes defined in this brand`.gray)\n          }\n        }\n      }\n    }\n\n    this.log(\"\\nDone\".green)\n  }\n}\n"]}

package/dist/commands/import-components.d.ts

@@ -0,0 +1,50 @@
+import { z, ZodType } from "zod";
+import { Environment, SentryCommand } from "../types/index.js";
+declare const ImportComponentsConfigSchema: z.ZodEffects<z.ZodObject<{
+    designSystemId: z.ZodString;
+    environment: z.ZodNativeEnum<typeof Environment>;
+    importFrom: z.ZodString;
+    rootDir: z.ZodString;
+    versionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    designSystemId: string;
+    environment: Environment;
+    importFrom: string;
+    rootDir: string;
+    versionId: string;
+}, {
+    designSystemId: string;
+    environment: Environment;
+    importFrom: string;
+    rootDir: string;
+    versionId: string;
+}>, {
+    environment: Environment;
+    rootDir: string;
+    designSystemId: string;
+    importFrom: string;
+    versionId: string;
+}, {
+    designSystemId: string;
+    environment: Environment;
+    importFrom: string;
+    rootDir: string;
+    versionId: string;
+}>;
+type ImportComponentsConfig = z.infer<typeof ImportComponentsConfigSchema>;
+export default class ImportComponents extends SentryCommand<ImportComponentsConfig> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        designSystemId: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        importFrom: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rootDir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        versionId: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    get commandId(): string;
+    get configSchema(): ZodType<ImportComponentsConfig>;
+    run(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=import-components.d.ts.map