@sonisoft/now-sdk-ext-core 1.0.0-alpha.32 → 2.0.0-alpha.0

package/dist/sn/application/AppRepoApplication.js

@@ -0,0 +1,167 @@
+import { Logger } from "../../util/Logger.js";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+import { ProgressWorker } from "../ProgressWorker.js";
+/**
+ * AppRepoApplication class for managing application repository operations
+ * Provides methods to install applications from and publish applications to
+ * a company's ServiceNow application repository using the CI/CD API
+ */
+export class AppRepoApplication {
+    APP_REPO_INSTALL_API_URL = "/api/sn_cicd/app_repo/install";
+    APP_REPO_PUBLISH_API_URL = "/api/sn_cicd/app_repo/publish";
+    PROGRESS_API_URL = "/api/sn_cicd/progress/{progressId}";
+    DEFAULT_TIMEOUT = 1000 * 60 * 30; // 30 minutes
+    DEFAULT_POLL_INTERVAL = 5000; // 5 seconds
+    _logger = new Logger("AppRepoApplication");
+    _req;
+    _instance;
+    constructor(instance) {
+        this._instance = instance;
+        this._req = new ServiceNowRequest(instance);
+    }
+    /**
+     * Installs an application from the application repository
+     * @param request AppRepoInstallRequest containing installation parameters
+     * @returns Promise<AppRepoInstallResponse> Installation response with progress information
+     */
+    async installFromAppRepo(request) {
+        const queryParams = {
+            scope: request.scope,
+            sys_id: request.sys_id
+        };
+        // Add optional parameters
+        if (request.version !== undefined) {
+            queryParams.version = request.version;
+        }
+        if (request.auto_upgrade_base_app !== undefined) {
+            queryParams.auto_upgrade_base_app = request.auto_upgrade_base_app;
+        }
+        if (request.base_app_version !== undefined) {
+            queryParams.base_app_version = request.base_app_version;
+        }
+        const httpRequest = {
+            path: this.APP_REPO_INSTALL_API_URL,
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+            },
+            query: queryParams,
+            body: null
+        };
+        this._logger.info(`Installing application from app repo: ${request.scope} (${request.sys_id})`);
+        const resp = await this._req.post(httpRequest);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result) {
+            this._logger.info(`App repo install initiated successfully for ${request.scope}`);
+            return resp.bodyObject.result;
+        }
+        throw new Error(`Failed to install application from app repo. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Installs an application from the app repository and waits for completion
+     * @param request AppRepoInstallRequest containing installation parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @param timeoutMs Timeout in milliseconds (default: 30 minutes)
+     * @returns Promise<AppRepoOperationResult> Final operation result
+     */
+    async installFromAppRepoAndWait(request, pollIntervalMs = this.DEFAULT_POLL_INTERVAL, timeoutMs = this.DEFAULT_TIMEOUT) {
+        const installResponse = await this.installFromAppRepo(request);
+        if (!installResponse.links?.progress?.id) {
+            throw new Error('No progress ID returned from install operation');
+        }
+        return await this.waitForCompletion(installResponse.links.progress.id, pollIntervalMs, timeoutMs);
+    }
+    /**
+     * Publishes an application to the application repository
+     * @param request AppRepoPublishRequest containing publish parameters
+     * @returns Promise<AppRepoPublishResponse> Publish response with progress information
+     */
+    async publishToAppRepo(request) {
+        const queryParams = {
+            scope: request.scope,
+            sys_id: request.sys_id
+        };
+        // Add optional parameters
+        if (request.version !== undefined) {
+            queryParams.version = request.version;
+        }
+        if (request.dev_notes !== undefined) {
+            queryParams.dev_notes = request.dev_notes;
+        }
+        const httpRequest = {
+            path: this.APP_REPO_PUBLISH_API_URL,
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+            },
+            query: queryParams,
+            body: null
+        };
+        this._logger.info(`Publishing application to app repo: ${request.scope} (${request.sys_id})`);
+        const resp = await this._req.post(httpRequest);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result) {
+            this._logger.info(`App repo publish initiated successfully for ${request.scope}`);
+            return resp.bodyObject.result;
+        }
+        throw new Error(`Failed to publish application to app repo. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Publishes an application to the app repository and waits for completion
+     * @param request AppRepoPublishRequest containing publish parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @param timeoutMs Timeout in milliseconds (default: 30 minutes)
+     * @returns Promise<AppRepoOperationResult> Final operation result
+     */
+    async publishToAppRepoAndWait(request, pollIntervalMs = this.DEFAULT_POLL_INTERVAL, timeoutMs = this.DEFAULT_TIMEOUT) {
+        const publishResponse = await this.publishToAppRepo(request);
+        if (!publishResponse.links?.progress?.id) {
+            throw new Error('No progress ID returned from publish operation');
+        }
+        return await this.waitForCompletion(publishResponse.links.progress.id, pollIntervalMs, timeoutMs);
+    }
+    /**
+     * Gets the current progress of an app repo operation
+     * @param progressId Progress ID from the operation response
+     * @returns Promise<ProgressResult> Current progress information
+     */
+    async getProgress(progressId) {
+        const progressWorker = new ProgressWorker(this._instance);
+        return await progressWorker.getProgress(progressId);
+    }
+    /**
+     * Waits for an app repo operation to complete
+     * @param progressId Progress ID to monitor
+     * @param pollIntervalMs Polling interval in milliseconds
+     * @param timeoutMs Timeout in milliseconds
+     * @returns Promise<AppRepoOperationResult> Final operation result
+     */
+    async waitForCompletion(progressId, pollIntervalMs, timeoutMs) {
+        const startTime = Date.now();
+        let progress = await this.getProgress(progressId);
+        this._logger.info(`Waiting for operation completion. Progress: ${progress.percent_complete}%`);
+        while (progress.percent_complete < 100 && (Date.now() - startTime) < timeoutMs) {
+            await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+            progress = await this.getProgress(progressId);
+            this._logger.info(`Operation progress: ${progress.percent_complete}% - ${progress.status_label}`);
+        }
+        if (progress.percent_complete < 100) {
+            throw new Error(`Operation timed out after ${timeoutMs}ms`);
+        }
+        if (progress.error) {
+            throw new Error(`Operation failed: ${progress.error}`);
+        }
+        if (progress.status === "3") { // FAILED status
+            throw new Error(`Operation failed: ${progress.status_label} - ${progress.status_message}`);
+        }
+        return {
+            success: progress.status === "2", // SUCCESSFUL status
+            status: progress.status,
+            status_label: progress.status_label,
+            status_message: progress.status_message,
+            status_detail: progress.status_detail,
+            error: progress.error,
+            percent_complete: progress.percent_complete,
+            links: progress.links
+        };
+    }
+}
+//# sourceMappingURL=AppRepoApplication.js.map

package/dist/sn/application/AppRepoApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRepoApplication.js","sourceRoot":"","sources":["../../../src/sn/application/AppRepoApplication.ts"],"names":[],"mappings":"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"}

package/dist/sn/application/ApplicationDetailModel.d.ts

@@ -0,0 +1,71 @@
+export declare class ApplicationDetailModelResponse {
+    result: ApplicationInstanceDetailModel;
+}
+export declare class ApplicationInstanceDetailModel {
+    app_info_on_instance: ApplicationDetailModel;
+}
+export declare class ApplicationDetailModel {
+    logo: string;
+    short_description: string;
+    needs_app_engine_licensing: boolean;
+    custom_table_count: string;
+    name: string;
+    vendor: string;
+    vendor_prefix: string;
+    link: string;
+    scope: string;
+    compatibilities: string;
+    active: boolean;
+    price_type: string;
+    lob: string[];
+    source: string;
+    shared_internally: boolean;
+    indicators: string[];
+    display_message: string;
+    upload_info: string;
+    products: string[];
+    install_date: string;
+    update_date: string;
+    version: string;
+    version_display: string;
+    assigned_version: string;
+    latest_version: string;
+    latest_version_display: string;
+    demo_data: string;
+    sys_id: string;
+    sys_updated_on: string;
+    sys_created_on: string;
+    can_edit_in_studio: boolean;
+    can_open_in_studio: boolean;
+    is_customized_app: boolean;
+    can_install_or_upgrade_customization: boolean;
+    customized_version_info: unknown;
+    is_store_app: boolean;
+    store_link: string;
+    isSubscriptionApplicable: boolean;
+    publish_date_display: string;
+    isAppstorePlugin: boolean;
+    uninstall_blocked: boolean;
+    sys_code: string;
+    can_install_or_upgrade: boolean;
+    isInstalled: boolean;
+    isInstalledAndUpdateAvailable: boolean;
+    isCustomizationUpdateAvailable: boolean;
+    installed_as_dependency: boolean;
+    app_schedule_details: unknown;
+    dependencies: unknown;
+    contains_plugins: boolean;
+    optional_apps_available: boolean;
+    install_tracker_id: string;
+    versions: unknown[];
+    new_guided_setup_id: string;
+    upgradeHistoryId: string;
+    upgradeDetailsInfo: unknown;
+    installationInfo: unknown;
+    installedFilesQuery: unknown;
+    customizedFilesQuery: unknown;
+    userDateFormat: string;
+    time_taken: number;
+    sys_created_on_display: string;
+    sys_updated_on_display: string;
+}

package/dist/sn/application/ApplicationDetailModel.js

@@ -0,0 +1,72 @@
+export class ApplicationDetailModelResponse {
+    result;
+}
+export class ApplicationInstanceDetailModel {
+    app_info_on_instance;
+}
+export class ApplicationDetailModel {
+    logo;
+    short_description;
+    needs_app_engine_licensing;
+    custom_table_count;
+    name;
+    vendor;
+    vendor_prefix;
+    link;
+    scope;
+    compatibilities;
+    active;
+    price_type;
+    lob;
+    source;
+    shared_internally;
+    indicators;
+    display_message;
+    upload_info;
+    products;
+    install_date;
+    update_date;
+    version;
+    version_display;
+    assigned_version;
+    latest_version;
+    latest_version_display;
+    demo_data;
+    sys_id;
+    sys_updated_on;
+    sys_created_on;
+    can_edit_in_studio;
+    can_open_in_studio;
+    is_customized_app;
+    can_install_or_upgrade_customization;
+    customized_version_info;
+    is_store_app;
+    store_link;
+    isSubscriptionApplicable;
+    publish_date_display;
+    isAppstorePlugin;
+    uninstall_blocked;
+    sys_code;
+    can_install_or_upgrade;
+    isInstalled;
+    isInstalledAndUpdateAvailable;
+    isCustomizationUpdateAvailable;
+    installed_as_dependency;
+    app_schedule_details;
+    dependencies;
+    contains_plugins;
+    optional_apps_available;
+    install_tracker_id;
+    versions;
+    new_guided_setup_id;
+    upgradeHistoryId;
+    upgradeDetailsInfo;
+    installationInfo;
+    installedFilesQuery;
+    customizedFilesQuery;
+    userDateFormat;
+    time_taken;
+    sys_created_on_display;
+    sys_updated_on_display;
+}
+//# sourceMappingURL=ApplicationDetailModel.js.map

package/dist/sn/application/ApplicationDetailModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationDetailModel.js","sourceRoot":"","sources":["../../../src/sn/application/ApplicationDetailModel.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,8BAA8B;IACvC,MAAM,CAAgC;CACzC;AAED,MAAM,OAAO,8BAA8B;IACvC,oBAAoB,CAAwB;CAC/C;AAGD,MAAM,OAAO,sBAAsB;IAE/B,IAAI,CAAQ;IACZ,iBAAiB,CAAQ;IACzB,0BAA0B,CAAS;IACnC,kBAAkB,CAAQ;IAC1B,IAAI,CAAQ;IACZ,MAAM,CAAQ;IACd,aAAa,CAAQ;IACrB,IAAI,CAAQ;IACZ,KAAK,CAAQ;IACb,eAAe,CAAQ;IACvB,MAAM,CAAS;IACf,UAAU,CAAQ;IAClB,GAAG,CAAU;IACb,MAAM,CAAQ;IAEd,iBAAiB,CAAS;IAC1B,UAAU,CAAU;IACpB,eAAe,CAAQ;IACvB,WAAW,CAAQ;IACnB,QAAQ,CAAU;IAClB,YAAY,CAAQ;IACpB,WAAW,CAAQ;IACnB,OAAO,CAAQ;IACf,eAAe,CAAQ;IACvB,gBAAgB,CAAQ;IACxB,cAAc,CAAQ;IACtB,sBAAsB,CAAQ;IAC9B,SAAS,CAAQ;IACjB,MAAM,CAAQ;IACd,cAAc,CAAQ;IACtB,cAAc,CAAQ;IAEtB,kBAAkB,CAAS;IAC3B,kBAAkB,CAAS;IAC3B,iBAAiB,CAAS;IAC1B,oCAAoC,CAAS;IAC7C,uBAAuB,CAAS;IAChC,YAAY,CAAS;IACrB,UAAU,CAAQ;IAElB,wBAAwB,CAAS;IACjC,oBAAoB,CAAQ;IAC5B,gBAAgB,CAAS;IACzB,iBAAiB,CAAS;IAC1B,QAAQ,CAAQ;IAChB,sBAAsB,CAAS;IAC/B,WAAW,CAAS;IAEpB,6BAA6B,CAAS;IACtC,8BAA8B,CAAS;IACvC,uBAAuB,CAAS;IAChC,oBAAoB,CAAS;IAC7B,YAAY,CAAS;IACrB,gBAAgB,CAAS;IACzB,uBAAuB,CAAS;IAChC,kBAAkB,CAAQ;IAC1B,QAAQ,CAAW;IACnB,mBAAmB,CAAQ;IAC3B,gBAAgB,CAAQ;IACxB,kBAAkB,CAAS;IAC3B,gBAAgB,CAAS;IACzB,mBAAmB,CAAS;IAC5B,oBAAoB,CAAS;IAC7B,cAAc,CAAQ;IACtB,UAAU,CAAQ;IAElB,sBAAsB,CAAQ;IAC9B,sBAAsB,CAAQ;CAgIjC"}

package/dist/sn/application/ApplicationManager.d.ts

@@ -0,0 +1,117 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { Logger } from "../../util/Logger.js";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+import { ApplicationDetailModel } from "./ApplicationDetailModel.js";
+import { BatchInstallation } from "./BatchInstallation.js";
+import { BatchDefinition } from "./BatchDefinition.js";
+export declare class ApplicationManager {
+    BATCH_API_URL: string;
+    APP_DETAILS_API_URL: string;
+    APP_UPDATES_LIST_API_URL: string;
+    BATCH_INSTALL_TIMEOUT: number;
+    _logger: Logger;
+    _req: ServiceNowRequest;
+    constructor(instance: ServiceNowInstance);
+    private _instance;
+    installBatch(batchDefinitionPath: string): Promise<boolean>;
+    private getInstallableApplicationPackages;
+    getApplicationDetails(appID: string): Promise<ApplicationDetailModel>;
+    private waitForBatchInstallCompletion;
+    private executeBatchInstallRequest;
+    private getBatchProgress;
+    /**
+     * Validates a batch definition file against currently installed applications
+     * @param batchDefinitionPath Path to the batch definition JSON file
+     * @returns Promise<BatchValidationResult> Validation results for all applications in the batch
+     */
+    validateBatchDefinition(batchDefinitionPath: string): Promise<BatchValidationResult>;
+    /**
+     * Validates a BatchInstallation object against currently installed applications
+     * @param batchInstall BatchInstallation object to validate
+     * @returns Promise<BatchValidationResult> Validation results for all applications in the batch
+     */
+    validateBatchInstallation(batchInstall: BatchInstallation): Promise<BatchValidationResult>;
+    /**
+     * Validates a single application from a batch definition
+     * @param pkg BatchDefinition to validate
+     * @returns Promise<ApplicationValidationResult> Validation result for the application
+     */
+    validateApplication(pkg: BatchDefinition): Promise<ApplicationValidationResult>;
+    /**
+     * Checks which applications from a batch definition are currently installed
+     * @param batchDefinitionPath Path to the batch definition JSON file
+     * @returns Promise<ApplicationValidationResult[]> Array of validation results
+     */
+    checkInstalledApplications(batchDefinitionPath: string): Promise<ApplicationValidationResult[]>;
+    /**
+     * Gets applications that need installation or upgrade from a batch definition
+     * @param batchDefinitionPath Path to the batch definition JSON file
+     * @returns Promise<ApplicationValidationResult[]> Array of applications needing action
+     */
+    getApplicationsNeedingAction(batchDefinitionPath: string): Promise<ApplicationValidationResult[]>;
+    /**
+     * Compares two version strings
+     * @param version1 First version string (e.g., "1.2.3")
+     * @param version2 Second version string (e.g., "1.2.4")
+     * @returns -1 if version1 < version2, 0 if equal, 1 if version1 > version2
+     */
+    private compareVersions;
+}
+export declare class BatchInstallResultResponse {
+    result: BatchInstallResult;
+}
+export interface BatchInstallResultLinks {
+    progress?: {
+        id: string;
+        url: string;
+    };
+}
+export declare class BatchInstallResult {
+    links: BatchInstallResultLinks;
+}
+/**
+ * Represents the validation result for a single application in a batch definition
+ */
+export interface ApplicationValidationResult {
+    /** Application sys_id from batch definition */
+    id: string;
+    /** Application name */
+    name?: string;
+    /** Requested version from batch definition */
+    requested_version: string;
+    /** Currently installed version (if any) */
+    installed_version?: string;
+    /** Whether the application is currently installed */
+    isInstalled: boolean;
+    /** Whether the installed version matches the requested version */
+    isVersionMatch: boolean;
+    /** Whether an update is available */
+    isUpdateAvailable: boolean;
+    /** Whether the application needs to be installed or upgraded */
+    needsAction: boolean;
+    /** Validation status: 'valid', 'mismatch', 'not_installed', 'update_needed', 'error' */
+    validationStatus: 'valid' | 'mismatch' | 'not_installed' | 'update_needed' | 'error';
+    /** Any error message if validation failed */
+    error?: string;
+    /** Full application details if available */
+    appDetails?: ApplicationDetailModel;
+}
+/**
+ * Represents the validation result for an entire batch definition
+ */
+export interface BatchValidationResult {
+    /** Array of validation results for each application */
+    applications: ApplicationValidationResult[];
+    /** Total number of applications in batch */
+    totalApplications: number;
+    /** Number of applications already installed with correct version */
+    alreadyValid: number;
+    /** Number of applications that need installation */
+    needsInstallation: number;
+    /** Number of applications that need upgrade */
+    needsUpgrade: number;
+    /** Number of applications with errors during validation */
+    errors: number;
+    /** Overall validation passed (all apps either valid or can be installed/upgraded) */
+    isValid: boolean;
+}