@equinor/fusion-framework-cli 10.7.4 → 11.0.0-next.0

package/dist/esm/bin/pack.js

@@ -0,0 +1,70 @@
+import AdmZip from 'adm-zip';
+import { dirname, resolve } from 'node:path';
+import { mkdir, stat } from 'node:fs/promises';
+import { formatByteSize, formatPath, chalk } from './utils';
+import { fileExistsSync } from '../lib/utils';
+/* Files to add to zip package */
+const addFiles = ['package.json', 'LICENSE.md', 'README.md', 'CHANGELOG.md'];
+/**
+ * Packages an application build directory and additional files into a zip archive.
+ *
+ * This function validates the build directory, adds build output and standard files (e.g., package.json, README.md),
+ * and optionally writes the archive to disk. It supports adding extra content and provides detailed logging.
+ *
+ * @param pkg - The resolved package info from package.json.
+ * @param options - Packaging options including build directory, archive path, logger, and extra content.
+ * @returns The AdmZip instance representing the created archive.
+ * @throws If the build directory does not exist or writing the archive fails.
+ * @public
+ */
+export const pack = async (pkg, options) => {
+    const { archive, log } = options ?? {};
+    // Resolve the path to the package root and build directory
+    const pkgPath = dirname(pkg.path);
+    const buildDir = options?.buildDir ?? 'dist';
+    const buildDirPath = resolve(pkgPath, buildDir);
+    // Ensure the build directory exists and is a directory
+    if (!(await stat(buildDirPath)).isDirectory()) {
+        throw new Error(`Build directory ${buildDir} does not exist`);
+    }
+    log?.log(chalk.bold('Starting to pack bundle'));
+    // Create a new zip archive
+    const bundle = new AdmZip();
+    // Add the build directory to the archive under its own folder
+    bundle.addLocalFolder(buildDirPath, buildDir);
+    // Add any additional content provided in options
+    if (options?.content) {
+        for (const [name, data] of Object.entries(options.content)) {
+            bundle.addFile(name, Buffer.from(data));
+            log?.info('📄', formatPath(name, { relative: true }));
+        }
+    }
+    log?.info('📂', formatPath(buildDirPath, { relative: true }));
+    // Add standard files and any files listed in package.json 'files' array
+    for (const file of addFiles.concat(pkg.packageJson.files ?? [])) {
+        const filePath = resolve(pkgPath, file);
+        const fileDir = dirname(filePath.replace(pkgPath, ''));
+        if (fileExistsSync(filePath)) {
+            bundle.addLocalFile(filePath, fileDir);
+            log?.info('📄', formatPath(filePath, { relative: true }));
+        }
+        else {
+            log?.warn(chalk.dim('📄', formatPath(filePath, { relative: true })));
+        }
+    }
+    // If an archive path is provided, write the zip file to disk
+    if (archive) {
+        // Ensure the output directory exists
+        if (!fileExistsSync(dirname(archive))) {
+            await mkdir(dirname(archive), { recursive: true });
+        }
+        log?.start('compressing content');
+        await bundle.writeZipPromise(archive);
+        log?.succeed('📚', formatPath(archive, { relative: true }), formatByteSize(archive));
+    }
+    // Return the AdmZip instance for further use or testing
+    return bundle;
+};
+// Export as default for compatibility with import patterns
+export default pack;
+//# sourceMappingURL=pack.js.map

package/dist/esm/bin/pack.js.map

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

package/dist/esm/bin/portal-build.js

@@ -0,0 +1,40 @@
+import { build as viteBuild } from 'vite';
+import { chalk } from './utils';
+import { loadViteConfig } from './helpers/load-vite-config.js';
+import { loadPortalManifest } from './portal-manifest.js';
+/**
+ * Builds a portal application using Vite.
+ *
+ * This function loads the portal manifest, applies Vite configuration, and runs the Vite build process.
+ * It provides detailed logging for each step and returns the package info, manifest, and output directory.
+ *
+ * @param opt - Build options including environment, manifest path, and logger.
+ * @returns An object containing the package info, manifest, and output directory.
+ * @throws If the build process fails or configuration is invalid.
+ * @public
+ */
+export const buildPortal = async (opt) => {
+    const { log } = opt ?? {};
+    // Log the start of the portal build process
+    log?.log(chalk.bold('Starting to build portal'));
+    // Load the portal manifest, package info, and environment variables
+    const { manifest, pkg, env } = await loadPortalManifest({ log, manifest: opt?.manifest });
+    log?.start('loading vite config...');
+    // Load local Vite configuration for the build
+    const viteConfig = await loadViteConfig(env, pkg);
+    log?.succeed('vite config applied');
+    log?.debug('vite config:', viteConfig);
+    log?.start('🤞🏻', 'building portal...');
+    // Capture native console output during the build
+    log?.startNativeConsoleCapture();
+    await viteBuild(viteConfig);
+    log?.stopNativeConsoleCapture();
+    log?.succeed('build completed 😘');
+    // Output directory for the built portal
+    const outDir = viteConfig.build.outDir;
+    // Return the package info, manifest, and output directory for further use
+    return { pkg, manifest, outDir };
+};
+// Export as default for compatibility with import patterns
+export default buildPortal;
+//# sourceMappingURL=portal-build.js.map

package/dist/esm/bin/portal-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-build.js","sourceRoot":"","sources":["../../../src/bin/portal-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,EAAsB,KAAK,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAoB1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAA6B,EAAE,EAAE;IACjE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,EAAE,CAAC;IAE1B,4CAA4C;IAC5C,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAEjD,oEAAoE;IACpE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE1F,GAAG,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACrC,8CAA8C;IAC9C,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClD,GAAG,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAEvC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACzC,iDAAiD;IACjD,GAAG,EAAE,yBAAyB,EAAE,CAAC;IACjC,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAC5B,GAAG,EAAE,wBAAwB,EAAE,CAAC;IAChC,GAAG,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEnC,wCAAwC;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;IAEvC,0EAA0E;IAC1E,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF,2DAA2D;AAC3D,eAAe,WAAW,CAAC"}

package/dist/esm/bin/portal-dev.js

@@ -0,0 +1,69 @@
+import { resolve } from 'node:path';
+import { createDevServer } from './utils';
+import { resolveProjectPackage } from './helpers/resolve-project-package.js';
+/**
+ * Starts the portal development server for local development and testing.
+ *
+ * This function sets up the runtime environment, resolves the portal manifest and config,
+ * and launches a development server using the resolved configuration. It provides detailed
+ * logging for each step and returns the dev server instance for further use.
+ *
+ * @param options - Settings for environment, manifest path, config path, logger, and server options.
+ * @returns The dev server instance after it has started.
+ * @public
+ */
+export const startPortalDevServer = async (options) => {
+    const { log } = options ?? {};
+    // The portalId is currently hardcoded, but could be made configurable in the future
+    const portalId = '@equinor/fusion-framework-dev-portal';
+    // Resolve the application's package.json for root and metadata
+    const pkg = await resolveProjectPackage(log);
+    // Setup the runtime environment for the dev server
+    const env = {
+        root: pkg.root,
+        environment: 'local', // Always use 'local' for dev server
+        ...options?.env, // Allow overrides from options
+        mode: 'development', // Force development mode
+        command: 'serve', // Command is always 'serve' for dev
+    };
+    // @todo - replace with resolvePortalManifest
+    // Dummy implementation for resolving the portal manifest
+    const resolvePortalManifest = async (...args) => {
+        // Returns a dummy manifest for development; replace with real logic as needed
+        return {
+            id: 'dev-portal-dummy',
+            build: {
+                entrypoint: resolve(env.root || '', 'src/index.ts'),
+                // if this is portal - portal-template-manifest
+                template: {},
+            },
+        };
+    };
+    const portalManifest = await resolvePortalManifest();
+    // Dummy implementation for resolving the portal config
+    const resolvePortalConfig = async (...args) => ({ foo: 'bar' });
+    // Resolve the portal config (replace with real logic as needed)
+    const portalConfig = await resolvePortalConfig(env, { log, config: options?.config });
+    log?.start('Starting app development server...');
+    // Create the dev server configuration, including portal and server settings
+    const devServer = await createDevServer(env, {
+        template: {
+            portal: {
+                id: portalManifest.id,
+            },
+        },
+        portal: {
+            manifest: portalManifest,
+            config: portalConfig,
+        },
+        server: {
+            port: options?.server?.port,
+        },
+    });
+    await devServer.listen();
+    // Log the resolved local URL for the dev server
+    log?.succeed(`Started app development server on ${devServer.resolvedUrls?.local?.[0]}`);
+    // Return the dev server instance for further use
+    return devServer;
+};
+//# sourceMappingURL=portal-dev.js.map

package/dist/esm/bin/portal-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-dev.js","sourceRoot":"","sources":["../../../src/bin/portal-dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAsB,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,OAuB1C,EAAE,EAAE;IACH,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE9B,oFAAoF;IACpF,MAAM,QAAQ,GAAG,sCAAsC,CAAC;IAExD,+DAA+D;IAC/D,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE7C,mDAAmD;IACnD,MAAM,GAAG,GAAe;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,OAAO,EAAE,oCAAoC;QAC1D,GAAG,OAAO,EAAE,GAAG,EAAE,+BAA+B;QAChD,IAAI,EAAE,aAAa,EAAE,yBAAyB;QAC9C,OAAO,EAAE,OAAO,EAAE,oCAAoC;KACvD,CAAC;IAEF,6CAA6C;IAC7C,yDAAyD;IACzD,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;QACzD,8EAA8E;QAC9E,OAAO;YACL,EAAE,EAAE,kBAAkB;YACtB,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,cAAc,CAAC;gBACnD,+CAA+C;gBAC/C,QAAQ,EAAE,EAAE;aACb;SACF,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAErD,uDAAuD;IACvD,MAAM,mBAAmB,GAAG,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAE3E,gEAAgE;IAChE,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtF,GAAG,EAAE,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEjD,4EAA4E;IAC5E,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE;QAC3C,QAAQ,EAAE;YACR,MAAM,EAAE;gBACN,EAAE,EAAE,cAAc,CAAC,EAAE;aACtB;SACF;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,YAAY;SACrB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI;SAC5B;KACF,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;IAEzB,gDAAgD;IAChD,GAAG,EAAE,OAAO,CAAC,qCAAqC,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAExF,iDAAiD;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/bin/portal-manifest.js

@@ -0,0 +1,38 @@
+import { resolvePortalManifest } from './helpers/resolve-portal-manifest.js';
+import { resolveProjectPackage } from './helpers/resolve-project-package.js';
+/**
+ * Loads and resolves the portal manifest based on the provided options.
+ *
+ * This function resolves the app package, sets up the runtime environment, and loads the portal manifest.
+ * Logging is supported for debugging and progress tracking. Returns the manifest, package, and environment.
+ *
+ * @param options - The options for resolving the portal manifest.
+ * @returns An object containing the resolved manifest, package, and runtime environment.
+ * @throws Will throw an error if resolving the application package or manifest fails.
+ * @public
+ */
+export const loadPortalManifest = async (options) => {
+    const { log } = options ?? {};
+    // Resolve the application's package.json for root and metadata
+    const pkg = await resolveProjectPackage(log);
+    log?.debug('package', pkg);
+    // Setup the runtime environment for manifest resolution
+    const env = {
+        command: 'build',
+        mode: process.env.NODE_ENV ?? 'production',
+        root: pkg.root,
+        ...options?.env, // Allow overrides from options
+    };
+    log?.debug('env:', env);
+    // Resolve the portal manifest using the environment and manifest path
+    const manifest = await resolvePortalManifest(env, pkg, {
+        log,
+        manifestPath: options?.manifest,
+    });
+    log?.debug('manifest:', manifest);
+    // Return the resolved manifest, package, and environment for further use
+    return { manifest, pkg, env };
+};
+// Export as default for compatibility with import patterns
+export default loadPortalManifest;
+//# sourceMappingURL=portal-manifest.js.map

package/dist/esm/bin/portal-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-manifest.js","sourceRoot":"","sources":["../../../src/bin/portal-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AA0B7E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OAAqC,EAAE,EAAE;IAChF,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE9B,+DAA+D;IAC/D,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE7C,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC3B,wDAAwD;IACxD,MAAM,GAAG,GAAe;QACtB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY;QAC1C,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,OAAO,EAAE,GAAG,EAAE,+BAA+B;KACjD,CAAC;IAEF,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,sEAAsE;IACtE,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE;QACrD,GAAG;QACH,YAAY,EAAE,OAAO,EAAE,QAAQ;KAChC,CAAC,CAAC;IAEH,GAAG,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAElC,yEAAyE;IACzE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,2DAA2D;AAC3D,eAAe,kBAAkB,CAAC"}

package/dist/esm/bin/portal-pack.js

@@ -0,0 +1,60 @@
+import { loadPortalSchema } from '../lib/portal';
+import { pack } from './pack';
+import { buildPortal } from './portal-build';
+/**
+ * Bundles the portal into an archive for distribution or deployment.
+ *
+ * This function builds the portal, validates the manifest, loads the schema, and creates an archive containing
+ * the portal manifest, schema, and metadata. Handles errors and logs progress for maintainability and debugging.
+ *
+ * @param options - Options for logger, manifest path, schema path, and archive name.
+ * @returns An object containing the archive path, portal manifest, and schema.
+ * @throws If the manifest build config is missing or packaging fails.
+ * @public
+ */
+export const bundlePortal = async (options) => {
+    const { log, manifest } = options;
+    // Setup a default runtime environment for the build
+    const env = {
+        command: 'build',
+        mode: process.env.NODE_ENV ?? 'production',
+        environment: null,
+        root: process.cwd(),
+    };
+    // Build the portal and retrieve the manifest and package info
+    const { pkg, manifest: portalManifest } = await buildPortal({
+        log,
+        manifest,
+    });
+    // Ensure the manifest contains build configuration
+    if (!portalManifest.build) {
+        throw new Error('Manifest build config not found');
+    }
+    // Load the portal schema for validation and inclusion in the archive
+    const schemaResult = await loadPortalSchema(env, { file: options?.schema });
+    log?.debug('Schema:', schemaResult);
+    // Create the archive with the portal manifest, schema, and metadata
+    const result = await pack(pkg, {
+        log,
+        archive: options?.archive,
+        content: {
+            'portal-template-manifest.json': JSON.stringify(portalManifest.build, null, 2),
+            'portal.schema.json': JSON.stringify(schemaResult.schema, null, 2),
+            'metadata.json': JSON.stringify({
+                name: portalManifest.name,
+                version: portalManifest.build.version,
+            }),
+        },
+    }).catch((error) => {
+        // Log and exit if packaging fails
+        log?.error('Failed to create package:', error);
+        process.exit(1);
+    });
+    // Return the archive path, manifest, and schema for further use
+    return {
+        archive: result,
+        manifest: portalManifest,
+        schema: schemaResult.schema,
+    };
+};
+//# sourceMappingURL=portal-pack.js.map

package/dist/esm/bin/portal-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-pack.js","sourceRoot":"","sources":["../../../src/bin/portal-pack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwB7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAA4B,EAAE,EAAE;IACjE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAElC,oDAAoD;IACpD,MAAM,GAAG,GAAe;QACtB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY;QAC1C,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE;KACpB,CAAC;IAEF,8DAA8D;IAC9D,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,WAAW,CAAC;QAC1D,GAAG;QACH,QAAQ;KACT,CAAC,CAAC;IAEH,mDAAmD;IACnD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,qEAAqE;IACrE,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5E,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpC,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE;QAC7B,GAAG;QACH,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,OAAO,EAAE;YACP,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC9B,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO;aACtC,CAAC;SACH;KACF,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,kCAAkC;QAClC,GAAG,EAAE,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,gEAAgE;IAChE,OAAO;QACL,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,YAAY,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/bin/portal-tag.js

@@ -0,0 +1,96 @@
+import { HttpJsonResponseError } from '@equinor/fusion-framework-module-http/errors';
+import { chalk, formatPath } from './utils';
+/**
+ * Allowed tags for portal versions in the portal service.
+ *
+ * - `latest`: Marks the most recent stable version of the portal template.
+ * - `preview`: Marks a pre-release or preview version for testing or review.
+ *
+ * Used by {@link tagPortal} to validate and apply version tags.
+ *
+ * @public
+ */
+export var AllowedTags;
+(function (AllowedTags) {
+    AllowedTags["Latest"] = "latest";
+    AllowedTags["Preview"] = "preview";
+})(AllowedTags || (AllowedTags = {}));
+/**
+ * Tags a portal template version in the portal service with a specified tag (e.g., 'latest' or 'preview').
+ *
+ * This function validates input, creates a client for the portal service, and sends a tag request.
+ * It provides detailed logging and error handling for common failure scenarios.
+ *
+ * @param options - Tag, portal name, version, framework instance, and logger.
+ * @returns The result of the tag operation from the portal service.
+ * @throws If the tag, name, or version is invalid, or if the tag operation fails.
+ * @public
+ */
+export const tagPortal = async (options) => {
+    const { tag, name, version, framework, log } = options;
+    // Validate tag value
+    if (!['latest', 'preview'].includes(tag)) {
+        log?.fail('🤪', 'Invalid tag. Use "latest" or "preview".');
+        process.exit(1);
+    }
+    // Validate portal name
+    if (!name) {
+        log?.fail('🤪', 'Application name is required.');
+        process.exit(1);
+    }
+    // Validate version
+    if (!version) {
+        log?.fail('🤪', 'Version is required.');
+        process.exit(1);
+    }
+    // Log the tagging action for traceability
+    log?.info('Tagging application:', chalk.greenBright(`${name}@${tag}`, version));
+    // Create a client for the 'portal-config' service
+    const client = await framework.serviceDiscovery.createClient('portal-config');
+    // Subscribe to outgoing requests for logging and debugging
+    client.request$.subscribe((request) => {
+        log?.debug('Request:', request);
+        log?.info('🌎', 'Executing request to:', formatPath(request.uri));
+    });
+    log?.start('Tagging portal template...');
+    try {
+        // Send a PUT request to tag the portal template version
+        const response = await client.json(`/templates/${name}/tags/${tag}`, {
+            method: 'PUT',
+            body: { version },
+        });
+        log?.debug('Response:', response);
+        log?.succeed('Tagged portal template successfully');
+        log?.info('🚀', JSON.stringify(response));
+    }
+    catch (error) {
+        // Handle known HTTP errors with specific log messages
+        if (error instanceof HttpJsonResponseError) {
+            const { data, response } = error;
+            log?.debug('Error:', data);
+            if (data) {
+                log?.warn(chalk.red(`🤯 error: ${data.code}\n`), chalk.yellowBright(data.message), '\n');
+            }
+            switch (response?.status) {
+                case 410:
+                    log?.fail(`🤬 - ${response?.status} -`, `${name} is deleted. Please check the name and try again.`);
+                    break;
+                case 404:
+                    log?.fail(`🤬 - ${response?.status} -`, `${name} not found. Please check the name and try again.`);
+                    break;
+                case 403:
+                case 401:
+                    log?.fail(`🤬 - ${response?.status} -`, 'You are not authorized to tag. Please check your permissions.');
+                    break;
+                default:
+                    log?.fail(`🤬 - ${response?.status} -`, 'Failed to tag', `Error: ${error.message}`);
+                    break;
+            }
+        }
+        // Rethrow error for upstream handling
+        throw error;
+    }
+};
+// Export as default for compatibility with import patterns
+export default tagPortal;
+//# sourceMappingURL=portal-tag.js.map

package/dist/esm/bin/portal-tag.js.map

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

package/dist/esm/bin/portal-upload.js

@@ -0,0 +1,99 @@
+import AdmZip from 'adm-zip';
+import { chalk } from './utils';
+import { loadMetadata } from './helpers/load-bundle-metadata';
+/**
+ * Uploads a portal bundle to the portal service for publishing or updating a portal template.
+ *
+ * This function loads the bundle, resolves the portal name (from argument or metadata),
+ * reads the bundle content, and uploads it to the portal service. Handles and logs errors
+ * for common failure scenarios, including HTTP status codes and bundle reading issues.
+ *
+ * @param opt - Options for bundle file, portal name, framework, and logger.
+ * @returns A promise that resolves when the upload is complete.
+ * @throws If bundle reading or upload fails, or if the portal service returns an error status.
+ * @public
+ */
+export const uploadPortalBundle = async (opt) => {
+    const { log, framework } = opt;
+    // Load the bundle from file or use the provided AdmZip instance
+    const bundle = typeof opt.fileOrBundle === 'string' ? new AdmZip(opt.fileOrBundle) : opt.fileOrBundle;
+    // Resolve the portal name from argument or bundle metadata
+    const { name } = opt.name
+        ? { name: opt.name }
+        : await loadMetadata(bundle).catch((error) => {
+            log?.error('Failed to resolve manifest:', error);
+            process.exit(1);
+        });
+    // Read the bundle content as a buffer
+    const content = await bundle.toBufferPromise().catch((error) => {
+        log?.error('Failed to read bundle content:', error);
+        process.exit(1);
+    });
+    try {
+        // Create a client for the 'portal-config' service
+        const appClient = await framework.serviceDiscovery.createClient('portal-config');
+        // Subscribe to outgoing requests for logging and debugging
+        appClient.request$.subscribe((request) => {
+            log?.info('🌎', 'Executing request to:', request.uri);
+            log?.debug('Request:', request);
+        });
+        // Upload the bundle as a zip file to the portal service
+        const response = await appClient.fetch(`/bundles/templates/${name}`, {
+            method: 'POST',
+            body: new Blob([content], {
+                type: 'application/zip',
+            }),
+            headers: {
+                'Content-Type': 'application/zip',
+            },
+        });
+        // Handle non-OK responses with detailed error logging
+        if (!response.ok) {
+            try {
+                const { error } = await response.json();
+                log?.debug('Error:', error);
+                if (error.message) {
+                    log?.warn(chalk.red(`🤯 error: ${error.code}\n`), chalk.yellowBright(error.message), '\n');
+                }
+            }
+            catch (e) {
+                log?.debug('Error:', response.statusText);
+            }
+            // Handle specific HTTP status codes for user-friendly error messages
+            if (response.status === 409) {
+                log?.fail(`🤬 - ${response.status} - `, 'Version is already published, please generate a new release');
+                process.exit(1);
+            }
+            if (response.status === 410) {
+                log?.fail(`🤬 - ${response.status} - `, `${name} is removed from Fusion`);
+                process.exit(1);
+            }
+            if (response.status === 404) {
+                log?.fail(`🤬 - ${response.status} - `, `${name} not found`);
+                process.exit(1);
+            }
+            if (response.status === 401 || response.status === 403) {
+                log?.fail(`🤬 - ${response.status} - `, `This is not allowed for your role on ${name}`);
+                process.exit(1);
+            }
+            if (response.status === 500) {
+                log?.fail(`🤬 - ${response.status} - `, 'Internal server error, please try again later or contact support');
+                process.exit(1);
+            }
+            // Throw for any other error status
+            throw new Error(`Failed to upload bundle. HTTP status ${response.status}, ${response.statusText}`);
+        }
+        // Log and return the successful response
+        log?.succeed('Successfully uploaded application bundle');
+        log?.debug('Response:', response);
+    }
+    catch (error) {
+        // Log and exit on any error during upload
+        log?.fail('🙅‍♂️', 'Failed to upload application bundle');
+        log?.error(error);
+        process.exit(1);
+    }
+};
+// Export as default for compatibility with import patterns
+export default uploadPortalBundle;
+//# sourceMappingURL=portal-upload.js.map

package/dist/esm/bin/portal-upload.js.map

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

package/dist/esm/bin/utils/ConsoleLogger.js

@@ -0,0 +1,112 @@
+// ConsoleLogger provides a unified interface for logging and spinner-based feedback in CLI tools.
+// It wraps a Spinner instance and exposes methods for different log levels and progress reporting.
+import { Spinner } from './spinner.js';
+/**
+ * ConsoleLogger is a utility class for logging progress, status, and debug information in CLI applications.
+ * It uses a spinner for visual feedback and supports debug mode for verbose output.
+ *
+ * @remarks
+ * This class is designed for CLI tools that require both spinner-based progress indication and
+ * structured logging at various levels (info, warn, error, debug).
+ *
+ * @example
+ * ```ts
+ * const logger = new ConsoleLogger('My CLI', { debug: true });
+ * logger.start('Starting task...');
+ * logger.succeed('Task complete!');
+ * logger.debug('Debug info');
+ * ```
+ */
+export class ConsoleLogger {
+    /**
+     * The spinner instance used for progress and status messages.
+     */
+    spinner;
+    /**
+     * Indicates if debug mode is enabled for verbose output.
+     */
+    debugMode;
+    /**
+     * Creates a new ConsoleLogger.
+     * @param title - Prefix for spinner/log messages.
+     * @param options - Optional debug flag.
+     */
+    constructor(title, options) {
+        this.spinner = new Spinner({ prefixText: title });
+        this.debugMode = options?.debug ?? false;
+    }
+    /**
+     * Start the spinner with a message.
+     * @param args - Message parts to display.
+     */
+    start(...args) {
+        this.spinner.start(...args);
+    }
+    /**
+     * Mark spinner as succeeded with a message.
+     * @param args - Message parts to display.
+     */
+    succeed(...args) {
+        this.spinner.succeed(...args);
+    }
+    /**
+     * Mark spinner as failed with a message.
+     * @param args - Message parts to display.
+     */
+    fail(...args) {
+        this.spinner.fail(...args);
+    }
+    /**
+     * Log an error message to the console.
+     * @param args - Error message parts.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: same as original
+    error(...args) {
+        console.log(...args);
+    }
+    /**
+     * Log a warning message.
+     * @param args - Warning message parts.
+     */
+    warn(...args) {
+        this.spinner.warn(...args);
+    }
+    /**
+     * Log an informational message.
+     * @param args - Info message parts.
+     */
+    info(...args) {
+        this.spinner.info(...args);
+    }
+    /**
+     * Alias for info.
+     * @param args - Info message parts.
+     */
+    log(...args) {
+        this.spinner.info(...args);
+    }
+    /**
+     * Log debug messages if debugMode is enabled.
+     * @param args - Debug message parts.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: same as original
+    debug(...args) {
+        if (this.debugMode) {
+            console.debug(...args);
+        }
+    }
+    /**
+     * Attach spinner to native console output.
+     */
+    startNativeConsoleCapture() {
+        this.spinner.attachConsole = true;
+    }
+    /**
+     * Detach spinner from native console output.
+     */
+    stopNativeConsoleCapture() {
+        this.spinner.attachConsole = false;
+    }
+}
+export default ConsoleLogger;
+//# sourceMappingURL=ConsoleLogger.js.map

package/dist/esm/bin/utils/ConsoleLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.js","sourceRoot":"","sources":["../../../../src/bin/utils/ConsoleLogger.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mGAAmG;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAa;IACxB;;OAEG;IACa,OAAO,CAAU;IACjC;;OAEG;IACa,SAAS,CAAU;IAEnC;;;;OAIG;IACH,YAAY,KAAa,EAAE,OAA6B;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC;IAC3C,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,GAAG,IAAc;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD;;;OAGG;IACH,OAAO,CAAC,GAAG,IAAc;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;IACD;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAc;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD;;;OAGG;IACH,+DAA+D;IAC/D,KAAK,CAAC,GAAG,IAAW;QAClB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IACD;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAc;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAc;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD;;;OAGG;IACH,GAAG,CAAC,GAAG,IAAc;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD;;;OAGG;IACH,+DAA+D;IAC/D,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD;;OAEG;IACH,yBAAyB;QACvB,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IACpC,CAAC;IACD;;OAEG;IACH,wBAAwB;QACtB,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC;IACrC,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}