sitevision-cli 1.0.0-beta.32 → 1.0.0-beta.33

package/dist/types/index.d.ts

@@ -1,295 +0,0 @@
-/**
- * Sitevision CLI - Shared Type Definitions
- *
- * This file contains all shared types used across the CLI.
- */
-/**
- * App types supported by Sitevision
- */
-export type AppType = 'WebApp' | 'Widget' | 'RESTApp' | 'MCPServer';
-/**
- * Simplified app type for internal use
- */
-export type SimpleAppType = 'web' | 'widget' | 'rest' | 'mcp';
-/**
- * A manifest text field that may be a plain string or a localized object keyed
- * by language code, e.g. `{sv: 'Namn', en: 'Name'}`. Sitevision allows either
- * form for human-facing fields like `name` and `description`.
- */
-export type LocalizedString = string | Record<string, string>;
-/**
- * Sitevision app manifest (manifest.json)
- */
-export interface SitevisionManifest {
-    id: string;
-    name: LocalizedString;
-    version: string;
-    type: AppType;
-    bundled?: boolean;
-    description?: LocalizedString;
-    author?: string;
-    helpUrl?: string;
-    license?: string;
-    categories?: string[];
-}
-/**
- * Development properties.
- *
- * Persisted fields live in .dev_properties.json. `password` is runtime-only:
- * resolved from the OS keychain (or a legacy plaintext file during migration)
- * and never written back to disk.
- */
-export interface DevProperties {
-    domain: string;
-    siteName: string;
-    addonName: string;
-    username: string;
-    password?: string;
-    useHTTPForDevDeploy?: boolean;
-    signingUsername?: string;
-    certificateName?: string;
-    authMethod?: 'basic' | 'oauth2' | 'cookie';
-    oauth2?: OAuth2Config;
-    sessionLoginUrl?: string;
-    baseEnvironment?: string;
-    production?: boolean;
-    environments?: Record<string, EnvironmentOverride>;
-    accessToken?: string;
-    sessionCookie?: string;
-    environmentName?: string;
-    productionEnvironment?: boolean;
-}
-/** Fields an environment may override; everything else comes from the base. */
-export type EnvironmentOverride = Partial<Pick<DevProperties, 'domain' | 'siteName' | 'addonName' | 'username' | 'authMethod' | 'oauth2' | 'sessionLoginUrl' | 'useHTTPForDevDeploy'>> & {
-    production?: boolean;
-};
-/**
- * OAuth2 provider config for bearer-token deploys.
- *
- * Deliberately secret-free: the client secret and refresh token live in the OS
- * keychain, so nothing here is unsafe to write to .dev_properties.json.
- */
-export interface OAuth2Config {
-    authorizationEndpoint: string;
-    tokenEndpoint: string;
-    clientId: string;
-    scopes?: string[];
-    redirectPort?: number;
-}
-/**
- * Signing credentials (password is runtime-only, not persisted)
- */
-export interface SigningCredentials {
-    username: string;
-    password: string;
-    certificateName?: string;
-}
-/**
- * Deployment configuration
- */
-export interface DeployConfig {
-    domain: string;
-    siteName: string;
-    addonName: string;
-    username: string;
-    password?: string;
-    accessToken?: string;
-    sessionCookie?: string;
-    useHTTP?: boolean;
-}
-/**
- * Production deployment configuration
- */
-export interface ProductionDeployConfig extends DeployConfig {
-    activate?: boolean;
-}
-/**
- * Package.json sitevision_scripts_properties section
- */
-export interface SitevisionScriptsProperties {
-    transpile?: boolean;
-    transpilePackages?: string[];
-    babel?: Record<string, unknown>;
-}
-/**
- * Full project information detected from the filesystem
- */
-export interface ProjectInfo {
-    root: string;
-    manifest: SitevisionManifest;
-    hasDevProperties: boolean;
-    hasSigningProperties: boolean;
-    hasLegacyPassword: boolean;
-    devProperties?: DevProperties;
-    inheritedKeys: string[];
-    packageJson: PackageJson;
-    hasSitevisionScripts: boolean;
-    hasNodeModules: boolean;
-    paths: ProjectPaths;
-}
-/**
- * Standard project paths
- */
-export interface ProjectPaths {
-    root: string;
-    src: string;
-    static: string;
-    build: string;
-    dist: string;
-    manifest: string;
-    devProperties: string | null;
-    packageJson: string;
-    nodeModules: string;
-}
-/**
- * Partial package.json with fields we care about
- */
-export interface PackageJson {
-    name?: string;
-    version?: string;
-    scripts?: Record<string, string>;
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    sitevision_scripts_properties?: SitevisionScriptsProperties;
-    developmentDomain?: string;
-    productionDomain?: string;
-    addonName?: string;
-    siteName?: string;
-}
-/**
- * REST API endpoints by app type
- */
-export interface ApiEndpoints {
-    addon: string;
-    import: string;
-}
-/**
- * API response from app signing
- */
-export interface SigningResponse {
-    success: boolean;
-    signedFilePath?: string;
-    error?: string;
-}
-/**
- * API response from deployment
- */
-export interface DeployResponse {
-    success: boolean;
-    executableId?: string;
-    message?: string;
-    error?: string;
-    authExpired?: boolean;
-    contextNodeMissing?: boolean;
-}
-/**
- * API response from addon creation
- */
-export interface CreateAddonResponse {
-    success: boolean;
-    addonId?: string;
-    error?: string;
-    authExpired?: boolean;
-}
-/**
- * API response from activation
- */
-export interface ActivationResponse {
-    success: boolean;
-    error?: string;
-    authExpired?: boolean;
-}
-/**
- * Build mode
- */
-export type BuildMode = 'development' | 'production';
-/**
- * Build options for webpack
- */
-export interface BuildOptions {
-    mode: BuildMode;
-    watch?: boolean;
-    cssPrefix?: string;
-    restApp?: boolean;
-}
-/**
- * Build result
- */
-export interface BuildResult {
-    success: boolean;
-    outputPath?: string;
-    errors?: string[];
-    warnings?: string[];
-    stats?: {
-        time: number;
-        hash: string;
-        assets: string[];
-    };
-}
-/**
- * Watch callback for webpack watch mode
- */
-export type WatchCallback = (result: BuildResult) => void;
-/**
- * Command execution context
- */
-export interface CommandContext {
-    project: ProjectInfo;
-    flags: Record<string, unknown>;
-    args: string[];
-}
-/**
- * Command definition
- */
-export interface Command {
-    name: string;
-    description: string;
-    requiresProject: boolean;
-    flags?: Record<string, CommandFlag>;
-    execute: (context: CommandContext) => Promise<void>;
-}
-/**
- * Command flag definition
- */
-export interface CommandFlag {
-    type: 'string' | 'boolean';
-    description: string;
-    alias?: string;
-    default?: unknown;
-}
-/**
- * Process output types
- */
-export interface ProcessOutput {
-    type: 'stdout' | 'stderr';
-    data: string;
-}
-/**
- * Process execution result
- */
-export interface ProcessResult {
-    exitCode: number;
-    output: ProcessOutput[];
-}
-/**
- * HTTP request options
- */
-export interface HttpRequestOptions {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
-    headers?: Record<string, string>;
-    body?: unknown;
-    auth?: {
-        username: string;
-        password: string;
-    };
-}
-/**
- * Generic result type for operations that can fail
- */
-export type Result<T, E = Error> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: E;
-};

package/dist/utils/branding.d.ts

@@ -1,28 +0,0 @@
-/**
- * Shared CLI branding — the logo art and author line. Used both by the Ink
- * first-run welcome screen and the non-interactive "what's new" update banner,
- * so the two stay identical.
- */
-export declare const LOGO: string[];
-export declare const AUTHOR = "Rasmus S\u00F6derstr\u00F6m";
-/**
- * Big block-shadow "Sitevision CLI" wordmark, used by the animated startup
- * intro (see components/AnimatedLogo). It's ~120 columns wide, so callers
- * should only render it when the terminal is at least that wide — otherwise it
- * wraps and looks broken.
- */
-export declare const BIG_LOGO: string[];
-/** Display width of the widest BIG_LOGO line. */
-export declare const BIG_LOGO_WIDTH: number;
-/**
- * Compact "Sitevision CLI" wordmark, animated on terminals too narrow for
- * BIG_LOGO. ~72 columns wide.
- */
-export declare const SMALL_LOGO: string[];
-/** Display width of the widest SMALL_LOGO line. */
-export declare const SMALL_LOGO_WIDTH: number;
-/**
- * Print the logo + author line straight to stdout (non-interactive), mirroring
- * how the masthead is printed. Used for the update banner.
- */
-export declare function printBranding(): void;

package/dist/utils/config.d.ts

@@ -1,27 +0,0 @@
-import { type Language } from './i18n.js';
-/** User-facing preferences editable from the shell's Settings screen. */
-export interface Settings {
-    language: Language;
-    introAnimation: boolean;
-}
-export declare function getSettings(): Settings;
-export declare function setSettings(patch: Partial<Settings>): void;
-/** Path of the config file, for display. */
-export declare function settingsFile(): string;
-/**
- * True until the user has completed the first-run welcome at least once.
- */
-export declare function isFirstRun(): boolean;
-/**
- * Persist that the first-run welcome has been seen.
- */
-export declare function markFirstRunComplete(): void;
-/**
- * The CLI version that was last run, or undefined if never recorded (a fresh
- * install, or a user who completed first-run before version tracking existed).
- */
-export declare function getLastSeenVersion(): string | undefined;
-/**
- * Persist the CLI version that just ran, so the next run can detect an upgrade.
- */
-export declare function setLastSeenVersion(version: string): void;

package/dist/utils/create-app.d.ts

@@ -1,53 +0,0 @@
-import { type Task } from './tasks.js';
-export declare const CREATE_COMMAND: string[];
-export interface PromptQuestion {
-    name: string;
-    type: string;
-    message: string;
-    choices: string[];
-    default?: unknown;
-    error?: string;
-}
-export type PromptReply = {
-    value: unknown;
-} | {
-    skip: true;
-};
-export type Ask = (question: PromptQuestion) => Promise<PromptReply | null>;
-/** A folder name that is also a usable package name and manifest id. */
-export declare const validAppName: (name: string) => boolean;
-/** The closest conventional name: "Min nya app!" and "MinNyaApp" become "min-nya-app". */
-export declare function suggestAppName(name: string): string;
-/** What is wrong with a typed app name, said so the fix is obvious. */
-export declare function appNameProblem(typed: string): string | undefined;
-/** A valid name that could be better; the user may keep it. */
-export declare function appNameAdvice(typed: string): string | undefined;
-export declare const isEmptyOrMissing: (dir: string) => boolean;
-/** Listen for the stub's questions. `null` from `ask` means the user cancelled. */
-export declare function servePrompts(ask: Ask, onCancel: () => void): Promise<{
-    socketPath: string;
-    connected: () => boolean;
-    close: () => void;
-}>;
-export type CreateOutcome = 'created' | 'unmanaged' | 'failed' | 'stopped';
-/**
- * Run the scaffolder for `name` inside `parentDir`. "unmanaged" means it never
- * asked svc anything and left no app: the prompt bridge did not take.
- */
-export declare function startCreateApp(options: {
-    name: string;
-    parentDir: string;
-    ask: Ask;
-    command?: string[];
-}): {
-    task: Task;
-    done: Promise<CreateOutcome>;
-};
-/** Run the scaffolder on the real terminal; resolves when it exits. */
-export declare function createAppInTerminal(name: string, parentDir: string): Promise<boolean>;
-/**
- * Replace the template's placeholders with what is known, and fold the config
- * the tool wrote into svc's layout: no plaintext password, and nothing in the
- * app's .dev_properties.json that the workspace already provides.
- */
-export declare function seedNewApp(appDir: string, workspaceRoot?: string): void;

package/dist/utils/environments.d.ts

@@ -1,20 +0,0 @@
-import type { DevProperties, EnvironmentOverride, ProjectInfo } from '../types/index.js';
-/** Name of the environment the top-level dev properties describe. */
-export declare function baseEnvironment(dev?: Partial<DevProperties>): string;
-export declare function environmentNames(dev?: Partial<DevProperties>): string[];
-export declare function isProductionEnvironment(name: string, dev?: Partial<DevProperties>): boolean;
-/** Badge colour: dev green, production red, anything else yellow. */
-export declare function environmentColor(name: string, dev?: Partial<DevProperties>): 'green' | 'yellow' | 'red';
-/**
- * The effective dev properties for one environment: the base with that
- * environment's overrides applied and credentials resolved for its
- * domain/username. The base ("dev") is returned as-is.
- */
-export declare function resolveEnvironment(dev: DevProperties, name: string): DevProperties;
-/** A project view whose dev properties are resolved for `name`. */
-export declare function environmentProject(project: ProjectInfo, name: string): ProjectInfo;
-/**
- * Write one environment's override into the base: keep only the keys whose
- * value differs from the base, so the file stays minimal.
- */
-export declare function withEnvironmentOverride(base: DevProperties, name: string, values: EnvironmentOverride): DevProperties;

package/dist/utils/i18n.d.ts

@@ -1,12 +0,0 @@
-/**
- * UI language. English strings are the keys; `t()` returns them untouched in
- * English and looks them up in the Swedish table otherwise, falling back to
- * English for anything untranslated. `{name}` placeholders are filled from
- * the vars argument.
- */
-export type Language = 'en' | 'sv';
-export declare const LANGUAGES: Language[];
-export declare const LANGUAGE_NAMES: Record<Language, string>;
-export declare function getLanguage(): Language;
-export declare function setLanguage(language: Language): void;
-export declare function t(text: string, vars?: Record<string, string | number>): string;

package/dist/utils/jsonc.d.ts

@@ -1,19 +0,0 @@
-/**
- * JSONC helpers.
- *
- * Sitevision's own manifest documentation shows manifest.json with line and
- * block comments (e.g. `"name": { // Multilingual-manifest requires SV 10.1`),
- * so real-world manifests copied from the docs contain them. Strict JSON.parse
- * rejects those, so we strip comments before parsing.
- */
-/**
- * Remove line comments (//...) and block comments from a JSON string, leaving
- * everything inside string literals untouched (so values like
- * `"https://example.com"` survive).
- */
-export declare function stripJsonComments(input: string): string;
-/**
- * Parse a JSON string that may contain comments (JSONC). Throws the underlying
- * SyntaxError if the content is invalid even after comments are removed.
- */
-export declare function parseJsonc<T>(input: string): T;

package/dist/utils/keychain.d.ts

@@ -1,15 +0,0 @@
-export declare function getDeployPassword(domain: string, username: string): string | null;
-export declare function setDeployPassword(domain: string, username: string, password: string): boolean;
-export declare function deleteDeployPassword(domain: string, username: string): void;
-export declare function getSigningPassword(username: string): string | null;
-export declare function setSigningPassword(username: string, password: string): boolean;
-export declare function deleteSigningPassword(username: string): void;
-export declare function getOAuth2RefreshToken(domain: string, clientId: string): string | null;
-export declare function setOAuth2RefreshToken(domain: string, clientId: string, token: string): boolean;
-export declare function deleteOAuth2RefreshToken(domain: string, clientId: string): void;
-export declare function getOAuth2ClientSecret(domain: string, clientId: string): string | null;
-export declare function setOAuth2ClientSecret(domain: string, clientId: string, secret: string): boolean;
-export declare function deleteOAuth2ClientSecret(domain: string, clientId: string): void;
-export declare function getSessionCookie(domain: string, username: string): string | null;
-export declare function setSessionCookie(domain: string, username: string, cookie: string): boolean;
-export declare function deleteSessionCookie(domain: string, username: string): void;

package/dist/utils/oauth2-auth.d.ts

@@ -1,64 +0,0 @@
-import type { DevProperties } from '../types/index.js';
-/** Default loopback port. Fixed so a single redirect URI can be whitelisted. */
-export declare const DEFAULT_REDIRECT_PORT = 8137;
-export declare const DEFAULT_SCOPES: string[];
-/** RFC 7636 S256 pair. Exported for testing the challenge derivation. */
-export declare function createPkcePair(): {
-    verifier: string;
-    challenge: string;
-};
-export interface DiscoveredOAuth2 {
-    authorizationEndpoint: string;
-    tokenEndpoint: string;
-    scopesSupported?: string[];
-}
-/**
- * Fetch the site's OpenID configuration (unauthenticated) to auto-fill the
- * authorization/token endpoints. Returns null if it isn't published (provider
- * not enabled) or the response isn't a valid config, so callers fall back to
- * manual entry.
- */
-export declare function discoverOAuth2Config(domain: string, useHTTP?: boolean): Promise<DiscoveredOAuth2 | null>;
-export declare function openBrowser(url: string): void;
-/**
- * Serve the loopback redirect once. Returns the awaited code and a `close()`
- * that shuts the server down (freeing the port) if the login is cancelled — so
- * a retry doesn't hit an EADDRINUSE on the fixed redirect port.
- */
-interface LoopbackResult {
-    code?: string;
-    error?: string;
-}
-/**
- * Turn a redirect's query params into a result, prioritizing the provider's own
- * error (the most useful reason) over a generic "no code". Exported for testing.
- */
-export declare function classifyRedirect(params: {
-    expectedState: string;
-    state: string | null;
-    error: string | null;
-    errorDescription: string | null;
-    code: string | null;
-}): LoopbackResult;
-/**
- * Start an interactive OAuth2 login. Returns the authorize URL to open and a
- * `complete()` that awaits the loopback redirect, exchanges the code, stores the
- * refresh token, and resolves the access token. UI-agnostic, so an Ink screen
- * can drive it without owning the terminal.
- */
-export declare function beginOAuth2Login(dev: DevProperties): {
-    authUrl: string;
-    complete: () => Promise<{
-        token?: string;
-        error?: string;
-    }>;
-    cancel: () => void;
-} | null;
-/**
- * Silently resolve an access token by refreshing the keychain refresh token.
- * Returns null when there's no refresh token or it's expired/revoked (in which
- * case the stale token is dropped). Interactive login lives in `beginOAuth2Login`,
- * driven by the Ink login screen — the access token is never persisted.
- */
-export declare function resolveOAuth2AccessToken(dev: DevProperties): Promise<string | null>;
-export {};

package/dist/utils/password-prompt.d.ts

@@ -1,14 +0,0 @@
-/**
- * Prompt for a yes/no answer. Returns true for y/Y.
- * Pressing Enter (empty answer) returns `defaultYes` (default: false).
- */
-export declare function promptYesNo(prompt: string, defaultYes?: boolean): Promise<boolean>;
-/**
- * Wait for the user to press Enter (or Ctrl+C). Used to hand control to an
- * external browser and resume once the user says they're done.
- */
-export declare function promptEnter(prompt: string): Promise<void>;
-/**
- * Prompt for password input with masked display
- */
-export declare function promptPassword(prompt: string): Promise<string>;

package/dist/utils/process-runner.d.ts

@@ -1,32 +0,0 @@
-import { type ChildProcess, type SpawnOptions } from 'child_process';
-import { EventEmitter } from 'events';
-export interface ProcessOutput {
-    type: 'stdout' | 'stderr';
-    data: string;
-}
-export interface ProcessResult {
-    exitCode: number;
-    output: ProcessOutput[];
-}
-/**
- * Spawn a child in its own process group, so stopping it also stops whatever it
- * starts (npm, webpack workers), and track it so the CLI can kill leftovers on
- * exit.
- */
-export declare function spawnChild(command: string, args: string[], options?: SpawnOptions): ChildProcess;
-/** Stop a child and everything it started. */
-export declare function killChild(child: ChildProcess): void;
-/** Kill every child still running; returns how many were signalled. */
-export declare function killAllChildren(): number;
-export declare class ProcessRunner extends EventEmitter {
-    private process;
-    private readonly output;
-    private readonly command;
-    private readonly args;
-    private readonly cwd?;
-    private readonly env?;
-    constructor(command: string, args?: string[], cwd?: string, env?: NodeJS.ProcessEnv);
-    run(): Promise<ProcessResult>;
-    kill(): void;
-    getOutput(): ProcessOutput[];
-}