sitevision-cli 0.0.0

package/dist/utils/project-detection.js

@@ -0,0 +1,287 @@
+import fs from 'fs';
+import path from 'path';
+// =============================================================================
+// PATH UTILITIES
+// =============================================================================
+/**
+ * Get standard project paths for a given root directory
+ */
+export function getProjectPaths(root, manifestPath, devPropertiesPath) {
+    return {
+        root,
+        src: path.join(root, 'src'),
+        static: path.join(root, 'static'),
+        build: path.join(root, 'build'),
+        dist: path.join(root, 'dist'),
+        manifest: manifestPath,
+        devProperties: devPropertiesPath,
+        packageJson: path.join(root, 'package.json'),
+        nodeModules: path.join(root, 'node_modules'),
+    };
+}
+/**
+ * Find the dev properties file path (supports both naming conventions)
+ */
+export function findDevPropertiesPath(root) {
+    const paths = [
+        path.join(root, '.dev_properties.json'),
+        path.join(root, '.dev-properties.json'),
+    ];
+    for (const p of paths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Get the default dev properties path (for creating new files)
+ */
+export function getDefaultDevPropertiesPath(root) {
+    return path.join(root, '.dev_properties.json');
+}
+/**
+ * Get app ID configuration from environment or defaults
+ */
+function getAppIdConfig() {
+    return {
+        prefix: process.env['SITEVISION_APP_ID_PREFIX'] || '',
+        suffix: process.env['SITEVISION_APP_ID_SUFFIX'] || '',
+    };
+}
+/**
+ * Get the full app ID including any prefix/suffix from environment
+ *
+ * This combines: prefix + baseId + suffix
+ * Used for generating zip filenames and deployment identifiers
+ */
+export function getFullAppId(baseId) {
+    const config = getAppIdConfig();
+    return `${config.prefix}${baseId}${config.suffix}`;
+}
+/**
+ * Get the zip filename for an app
+ */
+export function getZipFilename(manifest) {
+    return `${getFullAppId(manifest.id)}.zip`;
+}
+/**
+ * Get the signed zip filename for an app
+ */
+export function getSignedZipFilename(manifest) {
+    return `${getFullAppId(manifest.id)}-signed.zip`;
+}
+/**
+ * Get the full path to the zip file in dist/
+ */
+export function getZipPath(projectRoot, manifest) {
+    return path.join(projectRoot, 'dist', getZipFilename(manifest));
+}
+/**
+ * Get the full path to the signed zip file in dist/
+ */
+export function getSignedZipPath(projectRoot, manifest) {
+    return path.join(projectRoot, 'dist', getSignedZipFilename(manifest));
+}
+// =============================================================================
+// API ENDPOINT UTILITIES
+// =============================================================================
+/**
+ * Get API endpoints for the given app type
+ */
+export function getApiEndpoints(appType) {
+    switch (appType) {
+        case 'web':
+            return {
+                addon: 'custommodule',
+                import: 'webAppImport',
+            };
+        case 'widget':
+            return {
+                addon: 'widgetcustommodule',
+                import: 'webAppImport',
+            };
+        case 'rest':
+            return {
+                addon: 'headlesscustommodule',
+                import: 'restAppImport',
+            };
+    }
+}
+/**
+ * Build the base URL for API requests
+ */
+export function buildApiBaseUrl(domain, siteName, useHTTP = false) {
+    const protocol = useHTTP ? 'http' : 'https';
+    return `${protocol}://${domain}/rest-api/1/0/${encodeURIComponent(siteName)}`;
+}
+/**
+ * Build the addon endpoint URL
+ */
+export function buildAddonEndpointUrl(domain, siteName, appType, useHTTP = false) {
+    const baseUrl = buildApiBaseUrl(domain, siteName, useHTTP);
+    const endpoints = getApiEndpoints(appType);
+    return `${baseUrl}/Addon%20Repository/${endpoints.addon}`;
+}
+/**
+ * Build the import endpoint URL
+ */
+export function buildImportEndpointUrl(domain, siteName, addonName, appType, useHTTP = false) {
+    const baseUrl = buildApiBaseUrl(domain, siteName, useHTTP);
+    const endpoints = getApiEndpoints(appType);
+    return `${baseUrl}/Addon%20Repository/${encodeURIComponent(addonName)}/${endpoints.import}`;
+}
+// =============================================================================
+// PROJECT DETECTION
+// =============================================================================
+/**
+ * Detect if the current directory is a Sitevision project
+ */
+export function detectProject(cwd = process.cwd()) {
+    try {
+        // Look for manifest.json in multiple locations (current, static/, src/)
+        const manifestPaths = [
+            path.join(cwd, 'manifest.json'),
+            path.join(cwd, 'static', 'manifest.json'),
+            path.join(cwd, 'src', 'manifest.json'),
+        ];
+        let manifestPath = null;
+        let manifest = null;
+        for (const p of manifestPaths) {
+            if (fs.existsSync(p)) {
+                manifestPath = p;
+                manifest = JSON.parse(fs.readFileSync(p, 'utf-8'));
+                break;
+            }
+        }
+        if (!manifest || !manifestPath) {
+            return null;
+        }
+        // Check for package.json
+        const packageJsonPath = path.join(cwd, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            return null;
+        }
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        // Check if sitevision-scripts is installed
+        const hasSitevisionScripts = Boolean(packageJson.dependencies?.['@sitevision/scripts'] ||
+            packageJson.devDependencies?.['@sitevision/scripts']);
+        // Check for node_modules
+        const nodeModulesPath = path.join(cwd, 'node_modules');
+        const hasNodeModules = fs.existsSync(nodeModulesPath);
+        // Check for dev properties
+        const devPropertiesPath = findDevPropertiesPath(cwd);
+        let devProperties;
+        let hasDevProperties = false;
+        if (devPropertiesPath) {
+            hasDevProperties = true;
+            try {
+                devProperties = JSON.parse(fs.readFileSync(devPropertiesPath, 'utf-8'));
+            }
+            catch {
+                // Invalid dev properties file
+            }
+        }
+        // Check if signing properties are configured (only username is stored, password is entered at runtime)
+        const hasSigningProperties = Boolean(devProperties?.signingUsername);
+        // Build paths object
+        const paths = getProjectPaths(cwd, manifestPath, devPropertiesPath);
+        return {
+            root: cwd,
+            manifest,
+            hasDevProperties,
+            hasSigningProperties,
+            devProperties,
+            packageJson,
+            hasSitevisionScripts,
+            hasNodeModules,
+            paths,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate that we're in a Sitevision project directory
+ */
+export function requireProject(cwd) {
+    const project = detectProject(cwd);
+    if (!project) {
+        throw new Error('Not a Sitevision project. Run this command inside a Sitevision app directory.');
+    }
+    return project;
+}
+/**
+ * Get the app type (web, widget, rest)
+ */
+export function getAppType(manifest) {
+    const type = manifest.type.toLowerCase();
+    if (type.startsWith('web')) {
+        return 'web';
+    }
+    if (type.startsWith('widget')) {
+        return 'widget';
+    }
+    if (type.startsWith('rest')) {
+        return 'rest';
+    }
+    throw new Error(`Unknown app type: ${manifest.type}`);
+}
+/**
+ * Check if the app uses webpack bundling
+ */
+export function isBundledApp(manifest) {
+    return manifest.bundled === true;
+}
+/**
+ * Read and parse the dev properties file
+ */
+export function readDevProperties(projectRoot) {
+    const devPropertiesPath = findDevPropertiesPath(projectRoot);
+    if (!devPropertiesPath) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(devPropertiesPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write dev properties to file
+ */
+export function writeDevProperties(projectRoot, properties) {
+    const devPropertiesPath = findDevPropertiesPath(projectRoot) || getDefaultDevPropertiesPath(projectRoot);
+    fs.writeFileSync(devPropertiesPath, JSON.stringify(properties, null, 2));
+}
+/**
+ * Ensure the dist directory exists
+ */
+export function ensureDistDir(projectRoot) {
+    const distPath = path.join(projectRoot, 'dist');
+    if (!fs.existsSync(distPath)) {
+        fs.mkdirSync(distPath, { recursive: true });
+    }
+    return distPath;
+}
+/**
+ * Ensure the build directory exists
+ */
+export function ensureBuildDir(projectRoot) {
+    const buildPath = path.join(projectRoot, 'build');
+    if (!fs.existsSync(buildPath)) {
+        fs.mkdirSync(buildPath, { recursive: true });
+    }
+    return buildPath;
+}
+/**
+ * Clean the build directory
+ */
+export function cleanBuildDir(projectRoot) {
+    const buildPath = path.join(projectRoot, 'build');
+    if (fs.existsSync(buildPath)) {
+        fs.rmSync(buildPath, { recursive: true, force: true });
+    }
+}

package/dist/utils/sitevision-api.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Sitevision API Client
+ *
+ * Handles all API interactions with Sitevision servers:
+ * - Signing apps via developer.sitevision.se
+ * - Deploying to development environments
+ * - Deploying to production environments
+ * - Creating addons
+ * - Activating production apps
+ */
+import type { SigningCredentials, DeployConfig, ProductionDeployConfig, SigningResponse, DeployResponse, CreateAddonResponse, ActivationResponse, SimpleAppType } from '../types/index.js';
+/**
+ * Create Basic Auth header value
+ */
+declare function createBasicAuth(username: string, password: string): string;
+/**
+ * Sign an app via developer.sitevision.se
+ *
+ * @param zipPath - Path to the unsigned zip file
+ * @param credentials - Signing credentials
+ * @param outputPath - Path to write the signed zip file
+ */
+export declare function signApp(zipPath: string, credentials: SigningCredentials, outputPath: string): Promise<SigningResponse>;
+/**
+ * Deploy an app to a development environment
+ *
+ * @param zipPath - Path to the zip file (signed or unsigned)
+ * @param config - Deployment configuration
+ * @param appType - The app type (web, widget, rest)
+ * @param force - Whether to force deploy (overwrite existing)
+ */
+export declare function deployApp(zipPath: string, config: DeployConfig, appType: SimpleAppType, force?: boolean): Promise<DeployResponse>;
+/**
+ * Deploy an app to production
+ *
+ * @param signedZipPath - Path to the SIGNED zip file (required for production)
+ * @param config - Production deployment configuration
+ * @param appType - The app type (web, widget, rest)
+ */
+export declare function deployProduction(signedZipPath: string, config: ProductionDeployConfig, appType: SimpleAppType): Promise<DeployResponse>;
+/**
+ * Create a new addon on a Sitevision site
+ *
+ * @param config - Deployment configuration
+ * @param appType - The app type (web, widget, rest)
+ */
+export declare function createAddon(config: DeployConfig, appType: SimpleAppType): Promise<CreateAddonResponse>;
+/**
+ * Activate a deployed production app
+ *
+ * @param executableId - The executable ID returned from deployment
+ * @param config - Deployment configuration
+ * @param appType - The app type (web, widget, rest)
+ */
+export declare function activateApp(executableId: string, config: DeployConfig, _appType: SimpleAppType): Promise<ActivationResponse>;
+export { createBasicAuth };