@equinor/fusion-framework-cli 10.7.5-apploader-be21a6b60eb13eee8bf869e75002d8634e9c50a9 → 11.0.0-next.1

package/dist/esm/lib/framework.node.js

@@ -0,0 +1,104 @@
+import { ModulesConfigurator } from '@equinor/fusion-framework-module';
+import { enableAuthModule } from '@equinor/fusion-framework-module-msal-node';
+import { module as httpModule } from '@equinor/fusion-framework-module-http';
+import { enableServiceDiscovery, } from '@equinor/fusion-framework-module-service-discovery';
+import isContinuousIntegration from 'is-ci';
+// Default scope for Fusion service discovery
+const FUSION_SERVICE_SCOPE = ['5a842df8-3238-415d-b168-9f16a6a6031b/.default'];
+/**
+ * Enum for supported Fusion environments.
+ * Used to select the correct environment for service discovery and authentication.
+ */
+export var FusionEnv;
+(function (FusionEnv) {
+    FusionEnv["ContinuesIntegration"] = "ci";
+    FusionEnv["QualityAssurance"] = "fqa";
+    FusionEnv["Training"] = "tr";
+    FusionEnv["Production"] = "fprd";
+    FusionEnv["Development"] = "dev";
+})(FusionEnv || (FusionEnv = {}));
+/**
+ * Resolves the default environment based on CI status and dev allowance.
+ *
+ * @param allowDev - If true, allows development environment when not in CI.
+ * @returns The resolved Fusion environment.
+ */
+export const resolveDefaultEnv = (allowDev) => {
+    // If development is allowed and not running in CI, use development environment
+    if (allowDev && !isContinuousIntegration) {
+        return FusionEnv.Development;
+    }
+    // Otherwise, default to CI environment
+    return FusionEnv.ContinuesIntegration;
+};
+/**
+ * Initializes the Fusion Framework with the provided settings.
+ *
+ * This function configures HTTP, service discovery, and authentication modules
+ * based on the supplied configuration. It supports multiple authentication modes
+ * and allows customization of service discovery endpoints and scopes.
+ *
+ * @param config - The settings for framework initialization.
+ * @returns A promise resolving to the initialized Fusion Framework instance.
+ * @throws Will throw if required authentication parameters are missing.
+ */
+export const initializeFramework = async (config) => {
+    // Create a new module configurator for the framework
+    const configurator = new ModulesConfigurator();
+    // Determine the environment to use, defaulting to CI if not specified
+    const env = config.env ?? FusionEnv.ContinuesIntegration;
+    // Configure the HTTP module for service discovery
+    configurator.addConfig({
+        module: httpModule,
+        configure: (builder) => {
+            // Use CI environment for service discovery in development, otherwise use the selected env
+            const serviceDiscoveryEnv = env === FusionEnv.Development ? FusionEnv.ContinuesIntegration : env;
+            // Determine the base URI for service discovery
+            const baseUri = config.serviceDiscovery?.url ??
+                new URL(`/service-registry/environments/${serviceDiscoveryEnv}/services`, 'https://discovery.fusion.equinor.com').toString();
+            // Use provided scopes or default Fusion service scope
+            const defaultScopes = config.serviceDiscovery?.scope ?? FUSION_SERVICE_SCOPE;
+            // Register the service discovery client with the HTTP module
+            builder.configureClient('service_discovery', {
+                baseUri,
+                defaultScopes,
+            });
+        },
+    });
+    // Enable the service discovery module
+    enableServiceDiscovery(configurator);
+    // Enable the authentication module with custom configuration logic
+    enableAuthModule(configurator, (builder) => {
+        const { auth } = config;
+        // Handle direct token authentication
+        if ('token' in auth && auth.token) {
+            const { token } = auth;
+            builder.setMode('token_only');
+            builder.setAccessToken(token);
+            return;
+        }
+        // Handle silent or interactive authentication
+        const { clientId, tenantId, interactive } = auth;
+        if (!clientId || !tenantId) {
+            // Both clientId and tenantId are required for these modes
+            throw new Error('clientId and tenantId are required for auth module');
+        }
+        // Set client configuration for authentication
+        builder.setClientConfig(tenantId, clientId);
+        // Set authentication mode based on interactive flag
+        builder.setMode(interactive ? 'interactive' : 'silent');
+        if (interactive) {
+            // For interactive mode, server configuration is required
+            const { server } = auth;
+            if (!server.port) {
+                throw new Error('server.port is required for interactive mode');
+            }
+            builder.setServerPort(server.port);
+            builder.setServerOnOpen(server.onOpen);
+        }
+    });
+    // Initialize all configured modules and return the framework instance
+    const instance = await configurator.initialize();
+    return instance;
+};
+//# sourceMappingURL=framework.node.js.map

package/dist/esm/lib/framework.node.js.map

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

package/dist/esm/lib/index.js

@@ -0,0 +1,5 @@
+export { initializeFramework } from './framework.node.js';
+// Legacy imports - these will be removed in the next major version
+// @todo - remove these imports, introduced in v11
+export { defineAppConfig, defineAppManifest } from './legacy.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,qBAAqB,CAAC;AAEhF,mEAAmE;AACnE,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/lib/legacy.js

@@ -0,0 +1,38 @@
+import chalk from 'chalk';
+import { defineAppConfig as _defineConfig } from './app/app-config.js';
+import { defineAppManifest as _defineManifest } from './app/app-manifest.js';
+/**
+ * @deprecated
+ * Will be removed in the next major version.
+ * Please use `defineAppConfig` from `@equinor/fusion-framework-cli/app` instead.
+ *
+ * Transitional wrapper for legacy defineAppConfig. This function exists only to prevent immediate breaking changes
+ * and should be removed as soon as possible. Consumers should migrate to the new API without delay.
+ *
+ * @param args - Arguments passed to the new defineAppConfig function.
+ */
+export const defineAppConfig = (...args) => {
+    // Emit a strong warning to alert consumers that this usage is deprecated and must be fixed ASAP
+    console.warn(chalk.bgRed.white.bold('[DEPRECATION]'), chalk.redBright.bold('[@equinor/fusion-framework-cli] `defineAppConfig` is deprecated and will be removed in the next major version!\n' +
+        'Please update your code to use `defineAppConfig` from `@equinor/fusion-framework-cli/app` as soon as possible.'));
+    // Forward the call to the new implementation
+    return _defineConfig(...args);
+};
+/**
+ * @deprecated
+ * Will be removed in the next major version.
+ * Please use `defineAppManifest` from `@equinor/fusion-framework-cli/app` instead.
+ *
+ * Transitional wrapper for legacy defineAppManifest. This function exists only to prevent immediate breaking changes
+ * and should be removed as soon as possible. Consumers should migrate to the new API without delay.
+ *
+ * @param args - Arguments passed to the new defineAppManifest function.
+ */
+export const defineAppManifest = (...args) => {
+    // Emit a strong warning to alert consumers that this usage is deprecated and must be fixed ASAP
+    console.warn(chalk.bgRed.white.bold('[DEPRECATION]'), chalk.redBright.bold('[@equinor/fusion-framework-cli] `defineAppManifest` is deprecated and will be removed in the next major version!\n' +
+        'Please update your code to use `defineAppManifest` from `@equinor/fusion-framework-cli/app` as soon as possible.'));
+    // Forward the call to the new implementation
+    return _defineManifest(...args);
+};
+//# sourceMappingURL=legacy.js.map

package/dist/esm/lib/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../../src/lib/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,iBAAiB,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,IAAsC,EAAE,EAAE;IAC3E,gGAAgG;IAChG,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EACvC,KAAK,CAAC,SAAS,CAAC,IAAI,CAClB,kHAAkH;QAChH,gHAAgH,CACnH,CACF,CAAC;IACF,6CAA6C;IAC7C,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAwC,EAAE,EAAE;IAC/E,gGAAgG;IAChG,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EACvC,KAAK,CAAC,SAAS,CAAC,IAAI,CAClB,oHAAoH;QAClH,kHAAkH,CACrH,CACF,CAAC;IACF,6CAA6C;IAC7C,OAAO,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/dist/esm/lib/load-dev-server-config.js

@@ -0,0 +1,43 @@
+import { importConfig } from '@equinor/fusion-imports';
+/**
+ * Helper to define a dev server config function with proper typing.
+ * @param fn - The configuration function to be used as the dev server config.
+ * @returns The same function, typed as DevServerConfigFn.
+ */
+export const defineDevServerConfig = (fn) => fn;
+/**
+ * Loads the dev server configuration from a file or function.
+ *
+ * @param env - The runtime environment configuration.
+ * @param base - The base DevServerOptions to use as defaults.
+ * @param options - Optional settings for file name and extensions.
+ * @returns A promise resolving to the imported config result.
+ *
+ * This function uses importConfig to dynamically load the configuration file.
+ * If the config export is a function, it is invoked with the environment and a cloned base config.
+ * If the config export is an object, it is merged with the base config.
+ *
+ * Inline comments are provided for maintainability and clarity.
+ */
+export const loadDevServerConfig = async (env, base, options) => {
+    // Use importConfig to load the config file, defaulting to 'dev-server.config' if not specified
+    return importConfig(options?.file ?? 'dev-server.config', {
+        baseDir: env.root, // Set the base directory for config resolution
+        extensions: options?.extensions, // Allow custom file extensions
+        script: {
+            // Custom resolver for the config module
+            resolve: async (module) => {
+                // If the default export is a function, call it with env and a cloned base config
+                if (typeof module.default === 'function') {
+                    const baseClone = { ...base }; // Clone base to avoid mutation
+                    const result = (await module.default(env, { base: baseClone })) ?? base;
+                    // TODO: Add zod validation of the config for type safety
+                    return result ?? baseClone;
+                }
+                // If the default export is an object, return it or fallback to base
+                return module.default ?? base;
+            },
+        },
+    });
+};
+//# sourceMappingURL=load-dev-server-config.js.map

package/dist/esm/lib/load-dev-server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-dev-server-config.js","sourceRoot":"","sources":["../../../src/lib/load-dev-server-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,yBAAyB,CAAC;AAoBhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EAAqB,EAAE,EAAE,CAAC,EAAE,CAAC;AAEnE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,GAAe,EACf,IAAsB,EACtB,OAGC,EAC8C,EAAE;IACjD,+FAA+F;IAC/F,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,IAAI,mBAAmB,EAAE;QACxD,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,+CAA+C;QAClE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,+BAA+B;QAChE,MAAM,EAAE;YACN,wCAAwC;YACxC,OAAO,EAAE,KAAK,EAAE,MAA0C,EAA6B,EAAE;gBACvF,iFAAiF;gBACjF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACzC,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,+BAA+B;oBAC9D,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;oBACxE,yDAAyD;oBACzD,OAAO,MAAM,IAAI,SAAS,CAAC;gBAC7B,CAAC;gBACD,oEAAoE;gBACpE,OAAO,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;YAChC,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/lib/merge-dev-server-config.js

@@ -0,0 +1,37 @@
+import mergeWith from 'lodash.mergewith';
+/**
+ * Customizer function for lodash.mergeWith to handle merging arrays.
+ *
+ * If the property being merged is an array, the source value replaces the object value.
+ * This prevents arrays from being concatenated, which is the default lodash behavior.
+ *
+ * @param objValue - The value from the base object.
+ * @param srcValue - The value from the overrides object.
+ * @returns The value to use in the merged result, or undefined to use default merging.
+ */
+const customizer = (objValue, srcValue) => {
+    if (Array.isArray(objValue)) {
+        // Replace arrays instead of merging/concatenating them
+        return srcValue;
+    }
+    // For non-arrays, use default merge behavior
+};
+/**
+ * Merges a base development server configuration with an overrides object.
+ *
+ * Uses lodash.mergeWith to deeply merge properties, with custom logic for arrays.
+ * Arrays in the overrides object will replace arrays in the base config.
+ *
+ * @param base - The base development server configuration.
+ * @param overrides - A partial configuration object containing properties to override in the base configuration.
+ * @returns The merged development server configuration.
+ *
+ * Inline comments are provided for maintainability and clarity.
+ */
+export const mergeDevServerConfig = (base, overrides) => {
+    // Use lodash.mergeWith to merge base and overrides, applying the customizer for arrays
+    return mergeWith(base, overrides, customizer);
+};
+// Export as default for convenience in imports
+export default mergeDevServerConfig;
+//# sourceMappingURL=merge-dev-server-config.js.map

package/dist/esm/lib/merge-dev-server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-dev-server-config.js","sourceRoot":"","sources":["../../../src/lib/merge-dev-server-config.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAKzC;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,CAAC,QAAiB,EAAE,QAAiB,EAAE,EAAE;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,uDAAuD;QACvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,6CAA6C;AAC/C,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAsB,EACtB,SAA6C,EAC3B,EAAE;IACpB,uFAAuF;IACvF,OAAO,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAqB,CAAC;AACpE,CAAC,CAAC;AAEF,+CAA+C;AAC/C,eAAe,oBAAoB,CAAC"}

package/dist/esm/lib/portal/create-portal-manifest.js

@@ -0,0 +1,93 @@
+import { assert, assertObject } from '../utils/assert.js';
+import { resolveAnnotations } from '../utils/resolve-annotations.js';
+import { resolveEntryPoint } from '../utils/resolve-source-entry-point.js';
+import { resolveRepoFromPackage } from '../utils/resolve-package-repo.js';
+import { resolveGitRemoteUrl } from '../utils/resolve-git-remote-url.js';
+import { resolveGitCommitSha } from '../utils/resolve-git-commit-sha.js';
+import { ASSET_EXTENSIONS } from '../static.js';
+import { PortalManifestSchema } from './portal-manifest.schema.js';
+/**
+ * Resolves the appropriate entry point for a portal based on the current runtime environment.
+ *
+ * - In production or preview environments, it prefers the compiled entry point specified by
+ *   the `main` or `module` fields in the provided `package.json`, falling back to `'dist/bundle.js'` if neither is present.
+ * - In development, it uses the source entry point for improved debugging.
+ *
+ * @param env - The runtime environment configuration, including command and preview status.
+ * @param packageJson - The parsed contents of the package's `package.json` file.
+ * @returns The resolved entry point path as a string.
+ */
+const resolvePortalEntryPoint = (env, packageJson) => {
+    // Use compiled entry point when building for production or preview environments
+    if (env.command === 'build' || env.isPreview) {
+        // Prefer 'main', then 'module', then fallback to default bundle path
+        return packageJson.main || packageJson.module || 'dist/bundle.js';
+    }
+    // Use source entry point during development for better debugging
+    return resolveEntryPoint(env.root);
+};
+/**
+ * Creates a `PortalManifest` object from the provided `package.json` data and runtime environment.
+ *
+ * This function validates the input package information, determines the appropriate entry point,
+ * extracts metadata such as the app key, version, and repository information, and constructs a manifest
+ * object suitable for use in portal deployment and development workflows.
+ *
+ * @param env - The runtime environment, containing information such as the current command (e.g., 'build', 'dev').
+ * @param packageJson - The parsed `package.json` object for the portal package, expected to include at least `name` and `version`.
+ * @returns A fully constructed `PortalManifest` object containing metadata, build information, and asset configuration.
+ *
+ * @throws Will throw an error if `packageJson` is not a valid object or is missing required fields.
+ *
+ * @remarks
+ * - Maintainers: This function is the canonical way to generate a portal manifest from package metadata.
+ * - The manifest structure is tightly coupled to the portal build and deployment pipeline.
+ * - If you add new fields to the manifest, update this function and its documentation accordingly.
+ */
+export const createPortalManifestFromPackage = (env, packageJson) => {
+    // Validate that packageJson is a valid object and contains required fields
+    assertObject(packageJson, 'expected packageJson');
+    assert(packageJson.name, 'expected [name] in packageJson');
+    assert(packageJson.version, 'expected [version] in packageJson');
+    // Determine the entry point for the portal based on environment (prod/dev)
+    const entryPoint = resolvePortalEntryPoint(env, packageJson);
+    // Extract appKey from package name by removing the scope and leading @
+    // Example: '@scope/app-name' -> 'app-name'
+    const name = packageJson.name.replace(/^@|\w.*\//gm, '');
+    const version = packageJson.version;
+    // Only set assetPath when not building for production (used for dev/preview)
+    const assetPath = env.command === 'build' ? undefined : `bundles/portals/${name}/${version}`;
+    // Attempt to resolve GitHub repo from package, fallback to local git remote
+    const githubRepo = resolveRepoFromPackage(packageJson) ?? resolveGitRemoteUrl();
+    // Construct the portal manifest object with all required fields
+    const manifest = {
+        name,
+        displayName: packageJson.name,
+        description: packageJson.description || '',
+        build: {
+            templateEntry: entryPoint,
+            schemaEntry: 'portal.schema.json',
+            assetPath,
+            githubRepo,
+            version,
+            timestamp: new Date().toISOString(),
+            commitSha: resolveGitCommitSha(),
+            annotations: {
+                ...resolveAnnotations(),
+                // ...packageJson.annotations ?? {}
+            },
+            projectPage: packageJson.homepage,
+            allowedExtensions: ASSET_EXTENSIONS.map((ext) => `.${ext}`),
+        },
+    };
+    // Validate manifest against schema and throw if invalid
+    const parsed = PortalManifestSchema.safeParse(manifest);
+    if (!parsed.success) {
+        const details = parsed.error.issues
+            .map((i) => `- ${i.path.join('.')}: ${i.message}`)
+            .join('\n');
+        throw new Error(['Invalid portal manifest generated from package.json:', details].join('\n'));
+    }
+    return parsed.data;
+};
+//# sourceMappingURL=create-portal-manifest.js.map

package/dist/esm/lib/portal/create-portal-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-portal-manifest.js","sourceRoot":"","sources":["../../../../src/lib/portal/create-portal-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAI3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,uBAAuB,GAAG,CAAC,GAAe,EAAE,WAAwB,EAAU,EAAE;IACpF,gFAAgF;IAChF,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAC7C,qEAAqE;QACrE,OAAO,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,IAAI,gBAAgB,CAAC;IACpE,CAAC;IACD,iEAAiE;IACjE,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,GAAe,EACf,WAAwB,EACR,EAAE;IAClB,2EAA2E;IAC3E,YAAY,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IAClD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;IAC3D,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;IAEjE,2EAA2E;IAC3E,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE7D,uEAAuE;IACvE,2CAA2C;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAEpC,6EAA6E;IAC7E,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,IAAI,OAAO,EAAE,CAAC;IAE7F,4EAA4E;IAC5E,MAAM,UAAU,GAAG,sBAAsB,CAAC,WAAW,CAAC,IAAI,mBAAmB,EAAE,CAAC;IAEhF,gEAAgE;IAChE,MAAM,QAAQ,GAAG;QACf,IAAI;QACJ,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;QAC1C,KAAK,EAAE;YACL,aAAa,EAAE,UAAU;YACzB,WAAW,EAAE,oBAAoB;YACjC,SAAS;YACT,UAAU;YACV,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,mBAAmB,EAAE;YAChC,WAAW,EAAE;gBACX,GAAG,kBAAkB,EAAE;gBACvB,mCAAmC;aACpC;YACD,WAAW,EAAE,WAAW,CAAC,QAAQ;YACjC,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;SAC5D;KACF,CAAC;IAEF,wDAAwD;IACxD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,CAAC,sDAAsD,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC,IAAsB,CAAC;AACvC,CAAC,CAAC"}

package/dist/esm/lib/portal/index.js

@@ -0,0 +1,3 @@
+export { createPortalManifestFromPackage, definePortalManifest, loadPortalManifest, validatePortalManifest, } from './portal-manifest.js';
+export { loadPortalSchema, definePortalSchema, } from './load-portal-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/portal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/portal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GAIvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,yBAAyB,CAAC"}

package/dist/esm/lib/portal/load-portal-manifest.js

@@ -0,0 +1,54 @@
+import { importConfig } from '@equinor/fusion-imports';
+import { PortalManifestSchema } from './portal-manifest.schema.js';
+/**
+ * Loads a portal manifest configuration file, merging it with optional base values and supporting multiple file extensions.
+ *
+ * @template T - The type of the portal manifest, extending Partial<PortalManifest>. Defaults to PortalManifest.
+ * @param env - The runtime environment containing configuration such as the root directory and environment name.
+ * @param options - Optional settings for loading the manifest.
+ * @returns A promise that resolves to a `LoadAppManifestResult<T>` containing the loaded manifest, the file path, and the file extension.
+ *
+ * This function is the main entry point for loading portal manifest files. It supports merging with a base manifest, custom file name suggestions, and extension filtering.
+ *
+ * Example usage:
+ * ```ts
+ * const result = await loadPortalManifest(env, { base: {}, file: 'custom.manifest' });
+ * ```
+ */
+export const loadPortalManifest = async (env, options) => {
+    // Determine manifest file name suggestions, defaulting to environment-specific and generic names
+    const suggestions = options?.file ?? [`portal.manifest.${env.environment}`, 'portal.manifest'];
+    // Import the manifest configuration using the provided suggestions and options
+    const importResult = await importConfig(suggestions, {
+        baseDir: env.root, // Set the base directory for manifest resolution
+        extensions: options?.extensions, // Allow custom file extensions if provided
+        script: {
+            // Custom resolver for manifest modules
+            resolve: async (module) => {
+                // Use the provided base manifest or an empty object as the starting point
+                const base = options?.base ?? {};
+                // If the manifest export is a function, call it with the environment and base manifest
+                if (typeof module.default === 'function') {
+                    // Await the result of the manifest function, falling back to base if undefined
+                    const result = (await module.default(env, { base })) ?? base;
+                    return result ?? base;
+                }
+                // If the manifest export is an object, merge or return it directly
+                return module.default ?? base;
+            },
+        },
+    });
+    // Return the loaded manifest, file path, and extension for downstream use
+    // Validate the manifest before returning using the PortalManifestSchema (Zod)
+    const manifest = importResult.config;
+    const validation = PortalManifestSchema.safeParse(manifest);
+    if (!validation.success) {
+        throw new Error(`Invalid portal manifest: ${validation.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join('; ')}`);
+    }
+    return {
+        manifest,
+        path: importResult.path,
+        extension: importResult.extension,
+    };
+};
+//# sourceMappingURL=load-portal-manifest.js.map

package/dist/esm/lib/portal/load-portal-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-portal-manifest.js","sourceRoot":"","sources":["../../../../src/lib/portal/load-portal-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAuDnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,GAAe,EACf,OAAsC,EACH,EAAE;IACrC,iGAAiG;IACjG,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,mBAAmB,GAAG,CAAC,WAAW,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAE/F,+EAA+E;IAC/E,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE;QACnD,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,iDAAiD;QACpE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,2CAA2C;QAC5E,MAAM,EAAE;YACN,uCAAuC;YACvC,OAAO,EAAE,KAAK,EAAE,MAA4C,EAAc,EAAE;gBAC1E,0EAA0E;gBAC1E,MAAM,IAAI,GAAM,OAAO,EAAE,IAAI,IAAK,EAAQ,CAAC;gBAC3C,uFAAuF;gBACvF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACzC,+EAA+E;oBAC/E,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;oBAC7D,OAAO,MAAM,IAAI,IAAI,CAAC;gBACxB,CAAC;gBACD,mEAAmE;gBACnE,OAAQ,MAAM,CAAC,OAAa,IAAI,IAAI,CAAC;YACvC,CAAC;SACF;KACF,CAAC,CAAC;IAEH,0EAA0E;IAC1E,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAW,CAAC;IAC1C,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ;QACR,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/lib/portal/load-portal-schema.js

@@ -0,0 +1,49 @@
+import { importConfig } from '@equinor/fusion-imports';
+/**
+ * Helper to define a portal schema function with type inference.
+ * @template T - The type of the portal schema.
+ * @param fn - The schema function to define.
+ * @returns The provided schema function.
+ */
+export const definePortalSchema = (fn) => fn;
+/**
+ * Loads a portal schema from configuration files or schema functions.
+ *
+ * @template T - The type of the portal schema.
+ * @param env - The runtime environment used to resolve the schema.
+ * @param options - Optional configuration for file names and extensions.
+ * @returns An object containing the loaded schema, file path, and extension.
+ *
+ * This function attempts to import a schema configuration file or function based on the provided environment and options.
+ * It supports both direct schema objects and schema factory functions. The schema is resolved and validated before returning.
+ */
+export const loadPortalSchema = async (env, options) => {
+    // Determine possible schema file names based on environment and options
+    const suggestions = options?.file ?? [`portal.schema.${env.environment}`, 'portal.schema'];
+    // Attempt to import the schema configuration using the importConfig utility
+    const importResult = await importConfig(suggestions, {
+        baseDir: env.root,
+        extensions: options?.extensions,
+        script: {
+            // Custom resolver to handle both schema objects and schema factory functions
+            resolve: async (module) => {
+                // If the default export is a function, call it with the environment; otherwise, use the object directly
+                const result = typeof module.default === 'function'
+                    ? await Promise.resolve(module.default(env))
+                    : module.default;
+                // Validate that a schema was returned
+                if (!result) {
+                    throw new Error('Schema function did not return a valid schema');
+                }
+                return result;
+            },
+        },
+    });
+    // Return the loaded schema, along with the file path and extension for reference
+    return {
+        schema: importResult.config,
+        path: importResult.path,
+        extension: importResult.extension,
+    };
+};
+//# sourceMappingURL=load-portal-schema.js.map

package/dist/esm/lib/portal/load-portal-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-portal-schema.js","sourceRoot":"","sources":["../../../../src/lib/portal/load-portal-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAsBvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAyB,EAAqB,EAAE,EAAE,CAAC,EAAE,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,GAAe,EACf,OAGC,EACD,EAAE;IACF,wEAAwE;IACxE,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,iBAAiB,GAAG,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;IAE3F,4EAA4E;IAC5E,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE;QACnD,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,MAAM,EAAE;YACN,6EAA6E;YAC7E,OAAO,EAAE,KAAK,EAAE,MAA0C,EAAc,EAAE;gBACxE,wGAAwG;gBACxG,MAAM,MAAM,GACV,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;oBAClC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC5C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBACrB,sCAAsC;gBACtC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBACnE,CAAC;gBACD,OAAO,MAAW,CAAC;YACrB,CAAC;SACF;KACF,CAAC,CAAC;IACH,iFAAiF;IACjF,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,MAAW;QAChC,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,21 @@
+import { PortalManifestSchema } from './portal-manifest.schema.js';
+// Re-export relevant manifest utilities and types for external use
+export { loadPortalManifest, } from './load-portal-manifest.js';
+export { createPortalManifestFromPackage } from './create-portal-manifest.js';
+// Helper to define a typed portal manifest function
+export const definePortalManifest = (fn) => fn;
+export { PortalManifestSchema, PortalManifestBuildSchema, } from './portal-manifest.schema.js';
+/**
+ * Validates a portal manifest object against the PortalManifestSchema.
+ *
+ * @param manifest - The manifest object to validate.
+ * @returns The validated manifest object (typed) if valid.
+ * @throws ZodError if validation fails.
+ *
+ * Use this utility to ensure a manifest conforms to the expected schema before further processing.
+ */
+export function validatePortalManifest(manifest) {
+    // Throws if validation fails; returns typed manifest if valid
+    return PortalManifestSchema.parse(manifest);
+}
+//# sourceMappingURL=portal-manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal-manifest.js","sourceRoot":"","sources":["../../../../src/lib/portal/portal-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,mEAAmE;AACnE,OAAO,EACL,kBAAkB,GAGnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAqC,EAAuB,EAAE,EAAE,CAClG,EAAE,CAAC;AAEL,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAG1B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,8DAA8D;IAC9D,OAAO,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/esm/lib/portal/portal-manifest.schema.js

@@ -0,0 +1,134 @@
+/**
+ * Zod schema for validating the build section of the PortalManifest object.
+ *
+ * This schema defines the structure and types for the build metadata used in the portal manifest.
+ *
+ * @remarks
+ * - Maintainers: Update this schema if the build contract changes.
+ * - This schema is the canonical source for portal build validation and structure.
+ */
+import { z } from 'zod';
+export const PortalManifestBuildSchema = z.object({
+    // Main entry point for the portal (required)
+    templateEntry: z
+        .string({
+        required_error: 'templateEntry is required in build section',
+        invalid_type_error: 'templateEntry must be a string',
+    })
+        .describe('Main entry point for the portal'),
+    // Schema file for portal validation (required)
+    schemaEntry: z
+        .string({
+        required_error: 'schemaEntry is required in build section',
+        invalid_type_error: 'schemaEntry must be a string',
+    })
+        .describe('Schema file for portal validation'),
+    // Asset path for dev/preview builds (optional)
+    assetPath: z
+        .string({
+        invalid_type_error: 'assetPath must be a string',
+    })
+        .optional()
+        .describe('Asset path for dev/preview builds'),
+    // GitHub repo URL or local git remote (optional)
+    githubRepo: z
+        .string({
+        invalid_type_error: 'githubRepo must be a string',
+    })
+        .optional()
+        .describe('GitHub repo URL or local git remote'),
+    // Version from package.json (required)
+    version: z
+        .string({
+        required_error: 'version is required in build section',
+        invalid_type_error: 'version must be a string',
+    })
+        .describe('Version from package.json'),
+    // Current build timestamp (ISO8601, required)
+    timestamp: z
+        .string({
+        required_error: 'timestamp is required in build section',
+        invalid_type_error: 'timestamp must be a string',
+    })
+        .describe('Current build timestamp (ISO8601)'),
+    // Current git commit SHA (required)
+    commitSha: z
+        .string({
+        required_error: 'commitSha is required in build section',
+        invalid_type_error: 'commitSha must be a string',
+    })
+        .describe('Current git commit SHA'),
+    // Optional build annotations (key-value pairs)
+    annotations: z
+        .record(z.string(), {
+        invalid_type_error: 'annotations must be a record of string values',
+    })
+        .optional()
+        .describe('Optional build annotations'),
+    // Optional project homepage
+    projectPage: z
+        .string({
+        invalid_type_error: 'projectPage must be a string',
+    })
+        .optional()
+        .describe('Optional project homepage'),
+    // List of allowed asset extensions (with leading dot, required)
+    allowedExtensions: z
+        .array(z.string({
+        invalid_type_error: 'Each allowed extension must be a string',
+    }), {
+        required_error: 'allowedExtensions is required in build section',
+        invalid_type_error: 'allowedExtensions must be an array of strings',
+    })
+        .describe('List of allowed asset extensions (with leading dot)'),
+    // Optional schema for the portal (record of unknown values)
+    schema: z
+        .record(z.unknown(), {
+        invalid_type_error: 'schema must be a record of unknown values',
+    })
+        .optional()
+        .describe('Optional schema for the portal'),
+    // Optional configuration for the portal (record of unknown values)
+    config: z
+        .record(z.unknown(), {
+        invalid_type_error: 'config must be a record of unknown values',
+    })
+        .optional()
+        .describe('Optional configuration for the portal'),
+});
+/**
+ * Zod schema for validating the PortalManifest object.
+ *
+ * This schema defines the structure and types for the portal manifest used in the Fusion Framework CLI.
+ * It ensures that the manifest adheres to expected types and provides sensible defaults for build metadata.
+ *
+ * @remarks
+ * - Maintainers: Update this schema if the portal manifest contract changes.
+ * - This schema is the canonical source for portal manifest validation and structure.
+ */
+export const PortalManifestSchema = z.object({
+    // Short app key (unscoped, derived from package name, required)
+    name: z
+        .string({
+        required_error: 'name is required in portal manifest',
+        invalid_type_error: 'name must be a string',
+    })
+        .describe('Short app key (unscoped, derived from package name)'),
+    // Full package name, may include scope (optional)
+    displayName: z
+        .string({
+        invalid_type_error: 'displayName must be a string',
+    })
+        .optional()
+        .describe('Full package name, may include scope'),
+    // Description of the portal (optional)
+    description: z
+        .string({
+        invalid_type_error: 'description must be a string',
+    })
+        .optional()
+        .describe('Description of the portal'),
+    // Build section (required, validated by PortalManifestBuildSchema)
+    build: PortalManifestBuildSchema,
+});
+//# sourceMappingURL=portal-manifest.schema.js.map