@superdesign/cli 0.1.0

package/bin/superdesign.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+import('../dist/index.js')
+  .then(({ run }) => {
+    run();
+  })
+  .catch(err => {
+    console.error('Failed to start CLI:', err);
+    process.exit(1);
+  });

package/dist/api/auth.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CLI Authentication API endpoints
+ */
+export interface CreateSessionRequest {
+    cliVersion?: string;
+    os?: string;
+    hostname?: string;
+}
+export interface CreateSessionResponse {
+    sessionCode: string;
+    pollToken: string;
+    authUrl: string;
+    expiresAt: string;
+}
+export type SessionStatus = 'pending' | 'approved' | 'expired' | 'claimed';
+export interface PollSessionResponse {
+    status: SessionStatus;
+    apiKey?: string;
+    teamId?: string;
+    teamName?: string;
+}
+export interface ClaimSessionResponse {
+    success: boolean;
+}
+/**
+ * Create a new CLI auth session
+ */
+export declare function createSession(data: CreateSessionRequest): Promise<CreateSessionResponse>;
+/**
+ * Poll session status
+ */
+export declare function pollSession(pollToken: string): Promise<PollSessionResponse>;
+/**
+ * Claim session (mark as received by CLI)
+ */
+export declare function claimSession(pollToken: string): Promise<ClaimSessionResponse>;

package/dist/api/client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * API Client for SuperDesign Backend
+ */
+import { type AxiosInstance } from 'axios';
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export declare class ApiClientError extends Error {
+    code: string;
+    status?: number | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, status?: number | undefined, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Create an API client instance
+ * @param requireAuth If true, requires authentication and adds API key header
+ */
+export declare function createApiClient(requireAuth?: boolean): AxiosInstance;
+/**
+ * Create a public API client (no auth required)
+ */
+export declare function createPublicApiClient(): AxiosInstance;
+/**
+ * Get an authenticated API client
+ */
+export declare function getApiClient(): AxiosInstance;

package/dist/api/drafts.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Drafts API endpoints
+ */
+export interface CreateDraftRequest {
+    title: string;
+    prompt: string;
+    deviceMode?: 'mobile' | 'tablet' | 'desktop';
+}
+export interface IterateDraftRequest {
+    prompt: string;
+    mode: 'replace' | 'branch';
+    count?: 1 | 2 | 3 | 4;
+}
+export interface PlanFlowRequest {
+    sourceNodeId: string;
+    flowContext?: string;
+}
+export interface FlowPage {
+    title: string;
+    prompt: string;
+}
+export interface ExecuteFlowRequest {
+    sourceNodeId: string;
+    flowContext?: string;
+    pages: FlowPage[];
+}
+export interface JobCreatedResponse {
+    jobId: string;
+    status: 'processing';
+}
+/**
+ * Create a draft using AI generation (async)
+ */
+export declare function createDraft(projectId: string, data: CreateDraftRequest): Promise<JobCreatedResponse>;
+/**
+ * Iterate on a draft using AI (async)
+ */
+export declare function iterateDraft(draftId: string, data: IterateDraftRequest): Promise<JobCreatedResponse>;
+/**
+ * Plan flow pages using AI (async)
+ */
+export declare function planFlowPages(draftId: string, data: PlanFlowRequest): Promise<JobCreatedResponse>;
+/**
+ * Execute flow pages generation (async)
+ */
+export declare function executeFlowPages(draftId: string, data: ExecuteFlowRequest): Promise<JobCreatedResponse>;

package/dist/api/jobs.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Jobs API endpoints
+ */
+export interface DraftResultInfo {
+    draftId: string;
+    nodeId: string;
+    title: string;
+    nodeUrl: string;
+    previewUrl: string;
+}
+export interface IndexedDraftResultInfo extends DraftResultInfo {
+    index: number;
+}
+export interface PageSuggestion {
+    title: string;
+    prompt: string;
+}
+export interface CreateDraftJobResult {
+    draftId: string;
+    nodeId: string;
+    title: string;
+    projectUrl: string;
+    nodeUrl: string;
+    previewUrl: string;
+}
+export interface IterateDraftJobResult {
+    drafts: DraftResultInfo[];
+    projectUrl: string;
+}
+export interface PlanFlowJobResult {
+    pages: PageSuggestion[];
+}
+export interface ExecuteFlowJobResult {
+    drafts: IndexedDraftResultInfo[];
+    projectUrl: string;
+}
+export interface JobProcessingResponse {
+    jobId: string;
+    status: 'processing';
+    createdAt: string;
+}
+export interface JobCompletedResponse<T = Record<string, unknown>> {
+    jobId: string;
+    status: 'completed';
+    result: T;
+    creditsConsumed: number;
+    completedAt: string;
+}
+export interface JobFailedResponse {
+    jobId: string;
+    status: 'failed';
+    error: {
+        code: string;
+        message: string;
+    };
+}
+export type JobStatusResponse<T = Record<string, unknown>> = JobProcessingResponse | JobCompletedResponse<T> | JobFailedResponse;
+/**
+ * Get job status
+ */
+export declare function getJobStatus<T = Record<string, unknown>>(jobId: string): Promise<JobStatusResponse<T>>;
+/**
+ * Check if job is done (completed or failed)
+ */
+export declare function isJobDone<T>(response: JobStatusResponse<T>): boolean;
+/**
+ * Check if job completed successfully
+ */
+export declare function isJobCompleted<T>(response: JobStatusResponse<T>): response is JobCompletedResponse<T>;
+/**
+ * Check if job failed
+ */
+export declare function isJobFailed<T>(response: JobStatusResponse<T>): response is JobFailedResponse;

package/dist/api/projects.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Projects API endpoints
+ */
+export interface CreateProjectRequest {
+    title: string;
+}
+export interface CreateProjectResponse {
+    projectId: string;
+    title: string;
+    shareToken?: string;
+    projectUrl: string;
+}
+export interface AddDraftRequest {
+    title: string;
+    html: string;
+    deviceMode?: 'mobile' | 'tablet' | 'desktop';
+}
+export interface AddDraftResponse {
+    draftId: string;
+    nodeId: string;
+    title: string;
+    projectUrl: string;
+    nodeUrl: string;
+    previewUrl: string;
+}
+/**
+ * Create a new project
+ */
+export declare function createProject(data: CreateProjectRequest): Promise<CreateProjectResponse>;
+/**
+ * Add a draft with HTML content to a project (synchronous, no AI)
+ */
+export declare function addDraft(projectId: string, data: AddDraftRequest): Promise<AddDraftResponse>;

package/dist/commands/create-design-draft.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create Design Draft command - AI-generated draft
+ */
+import { Command } from 'commander';
+export declare function createCreateDesignDraftCommand(): Command;

package/dist/commands/create-project.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create Project command
+ */
+import { Command } from 'commander';
+export declare function createCreateProjectCommand(): Command;

package/dist/commands/execute-flow-pages.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Execute Flow Pages command - Generate flow pages with AI
+ */
+import { Command } from 'commander';
+export declare function createExecuteFlowPagesCommand(): Command;

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Init command - Install skill files for Claude Code
+ * Automatically triggers login if not authenticated
+ */
+import { Command } from 'commander';
+export declare function createInitCommand(): Command;

package/dist/commands/iterate-design-draft.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Iterate Design Draft command - AI iteration on existing draft
+ */
+import { Command } from 'commander';
+export declare function createIterateDesignDraftCommand(): Command;

package/dist/commands/login.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Login command - Device auth flow
+ */
+import { Command } from 'commander';
+export declare function createLoginCommand(): Command;

package/dist/commands/logout.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logout command - Clear stored credentials
+ */
+import { Command } from 'commander';
+export declare function createLogoutCommand(): Command;

package/dist/commands/plan-flow-pages.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Plan Flow Pages command - AI planning for flow pages
+ */
+import { Command } from 'commander';
+export declare function createPlanFlowPagesCommand(): Command;

package/dist/config/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CLI Configuration Constants
+ */
+/** Default API base URL */
+export declare const DEFAULT_API_URL = "https://api.superdesign.dev/v1";
+/** Default frontend URL for auth redirect */
+export declare const DEFAULT_FRONTEND_URL = "https://app.superdesign.dev";
+/** Polling configuration */
+export declare const POLL_INTERVAL_MS = 2000;
+export declare const POLL_TIMEOUT_MS: number;
+/** Auth polling configuration */
+export declare const AUTH_POLL_INTERVAL_MS = 2000;
+export declare const AUTH_POLL_TIMEOUT_MS: number;
+/** CLI version - should match package.json */
+export declare const CLI_VERSION = "0.1.0";
+/** Config directory name */
+export declare const CONFIG_DIR_NAME = ".superdesign";
+/** Config file name */
+export declare const CONFIG_FILE_NAME = "config.json";
+/** Exit codes */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly AUTH_REQUIRED: 2;
+    readonly AUTH_FAILED: 3;
+    readonly API_ERROR: 4;
+    readonly VALIDATION_ERROR: 5;
+    readonly TIMEOUT: 6;
+};
+/** Skill files directory relative to project root */
+export declare const SKILLS_DIR = ".claude/skills/superdesign";
+/** SKILL.md file name */
+export declare const SKILL_FILE_NAME = "SKILL.md";

package/dist/config/manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI Configuration structure
+ */
+export interface CliConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    teamId?: string;
+    teamName?: string;
+}
+/**
+ * Get the config directory path
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the config file path
+ */
+export declare function getConfigPath(): string;
+/**
+ * Load configuration from disk
+ */
+export declare function loadConfig(): CliConfig;
+/**
+ * Save configuration to disk
+ */
+export declare function saveConfig(config: CliConfig): void;
+/**
+ * Update specific config values (merge with existing)
+ */
+export declare function updateConfig(updates: Partial<CliConfig>): CliConfig;
+/**
+ * Clear all configuration
+ */
+export declare function clearConfig(): void;
+/**
+ * Check if user is authenticated
+ */
+export declare function isAuthenticated(): boolean;
+/**
+ * Get API key or throw if not authenticated
+ */
+export declare function getApiKey(): string;
+/**
+ * Get the API URL (from config or default)
+ */
+export declare function getApiUrl(): string;