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

package/dist/esm/cli/commands/portal/tag.js

@@ -0,0 +1,69 @@
+import { createCommand } from 'commander';
+import { createEnvOption } from '../../options/env.js';
+import { withAuthOptions } from '../../options/auth.js';
+import { tagPortal } from '../../../bin/portal-tag.js';
+import { ConsoleLogger } from '../../../bin/utils/ConsoleLogger.js';
+import { loadPortalManifest } from '../../../bin/portal-manifest.js';
+import { initializeFramework } from '../../../lib';
+export const command = withAuthOptions(createCommand('tag')
+    .description([
+    'Tag your Fusion portal application with a specific version or preview in the Fusion portal registry.',
+    '',
+    'This command applies a tag to the specified portal version, making it easy to manage releases and previews.',
+    'You can provide the portal name and version directly, or let the command resolve them from the manifest file.',
+    'Supports environment selection, debug, and silent modes.',
+    '',
+    'Examples:',
+    '  $ fusion portal tag latest',
+    '  $ fusion portal tag preview --env prod --manifest portal.manifest.prod.ts',
+    '  $ fusion portal tag stable --name my-portal --version 1.2.3',
+].join('\n'))
+    .addOption(createEnvOption({ allowDev: false }))
+    .option('-n, --name <string>', 'Portal name (if not provided, resolved from manifest)')
+    .option('-m, --manifest <string>', 'Manifest file to use for resolving portal name and version (only used when --name or --version is not provided)')
+    .option('-v, --version <string>', 'Version to tag (if not provided, resolved from manifest)')
+    .option('-d, --debug', 'Enable debug mode for verbose logging')
+    .option('--silent', 'Silent mode, suppresses output except errors')
+    .argument('<tag>', 'Tag to apply (latest | preview)')
+    .action(async (tag, options) => {
+    const log = options.silent ? null : new ConsoleLogger('app:tag', { debug: options.debug });
+    const env = {
+        command: 'build',
+        environment: options.env,
+        mode: process.env.NODE_ENV ?? 'production',
+        root: process.cwd(),
+    };
+    let name = options.name;
+    let version = options.version;
+    if (!name || !version) {
+        const { manifest: portalManifest } = await loadPortalManifest({
+            log,
+            manifest: options.manifest,
+            env,
+        });
+        name = name ?? portalManifest.name;
+        version = version ?? portalManifest.build?.version;
+    }
+    log?.start('Initializing Fusion Framework...');
+    const framework = await initializeFramework({
+        env: options.env,
+        auth: {
+            token: options.token,
+            tenantId: options.tenantId,
+            clientId: options.clientId,
+        },
+    });
+    log?.succeed('Initialized Fusion Framework');
+    tagPortal({
+        tag,
+        name,
+        version,
+        framework,
+        log,
+    }).catch((error) => {
+        log?.error('😢 Failed to tag application:', error);
+        process.exit(1);
+    });
+}));
+export default command;
+//# sourceMappingURL=tag.js.map

package/dist/esm/cli/commands/portal/tag.js.map

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

package/dist/esm/cli/commands/portal/upload.js

@@ -0,0 +1,40 @@
+import { createCommand } from 'commander';
+import { withAuthOptions } from '../../options/auth.js';
+import { createEnvOption } from '../../options/env.js';
+import { ConsoleLogger } from '../../../bin/utils';
+import { initializeFramework } from '../../../lib';
+import { uploadPortalBundle } from '../../../bin/portal-upload.js';
+export const command = withAuthOptions(createCommand('upload')
+    .description([
+    'Upload a Fusion portal bundle to the Fusion portal registry for deployment.',
+    '',
+    'This command uploads a distributable portal bundle to the Fusion portal registry using the current authentication and environment.',
+    'Supports debug mode and custom environment selection.',
+    '',
+    'Examples:',
+    '  $ fusion portal upload my-portal-bundle.zip',
+    '  $ fusion portal upload my-portal-bundle.zip --env prod',
+    '  $ fusion portal upload my-portal-bundle.zip --debug',
+].join('\n'))
+    .option('-d, --debug [boolean]', 'Enable debug mode for verbose logging', false)
+    .addOption(createEnvOption({ allowDev: false }))
+    .argument('<bundle>', 'Portal bundle to upload (e.g., out/bundle.zip)')
+    .action(async (bundle, options) => {
+    const log = new ConsoleLogger('portal:upload', { debug: options.debug });
+    log?.start('Initializing Fusion Framework...');
+    const framework = await initializeFramework({
+        env: options.env,
+        auth: {
+            token: options.token,
+            tenantId: options.tenantId,
+            clientId: options.clientId,
+        },
+    });
+    log?.succeed('Initialized Fusion Framework');
+    await uploadPortalBundle({ log, framework, fileOrBundle: bundle }).catch((error) => {
+        log.error('Failed to upload bundle:', error);
+        process.exit(1);
+    });
+}));
+export default command;
+//# sourceMappingURL=upload.js.map

package/dist/esm/cli/commands/portal/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../../../src/cli/commands/portal/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CACpC,aAAa,CAAC,QAAQ,CAAC;KACpB,WAAW,CACV;IACE,6EAA6E;IAC7E,EAAE;IACF,oIAAoI;IACpI,uDAAuD;IACvD,EAAE;IACF,WAAW;IACX,+CAA+C;IAC/C,0DAA0D;IAC1D,uDAAuD;CACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;KACA,MAAM,CAAC,uBAAuB,EAAE,uCAAuC,EAAE,KAAK,CAAC;KAC/E,SAAS,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;KAC/C,QAAQ,CAAC,UAAU,EAAE,gDAAgD,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAChC,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAEzE,GAAG,EAAE,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC;QAC1C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B;KACF,CAAC,CAAC;IACH,GAAG,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjF,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACL,CAAC;AACF,eAAe,OAAO,CAAC"}

package/dist/esm/cli/main.js

@@ -0,0 +1,52 @@
+/**
+ * Entry point for the Fusion Framework CLI.
+ *
+ * This file sets up the CLI program, loads the package metadata, and registers all available commands.
+ *
+ * Key responsibilities:
+ * - Locates the CLI's root directory and package.json using read-package-up.
+ * - Sets the CLI_BIN environment variable for internal use.
+ * - Initializes the Commander.js program with name, version, and description from package.json.
+ * - Registers all CLI commands via the registerCommands function.
+ * - Parses process arguments and starts the CLI.
+ *
+ * Maintenance notes:
+ * - To add new commands, update the registerCommands module.
+ * - To change CLI metadata (name, version, description), update package.json.
+ * - This file should remain minimal and only handle top-level CLI setup logic.
+ * - For troubleshooting, ensure the CLI_BIN path is set correctly and that package.json is accessible.
+ *
+ * For more details, see the Fusion Framework CLI documentation or contact the maintainers.
+ */
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+/** find cli package.json */
+import { readPackageUpSync } from 'read-package-up';
+// try to find the package.json of the CLI
+const pkg = readPackageUpSync({ cwd: fileURLToPath(import.meta.url) });
+if (!pkg) {
+    throw Error('failed to find program root');
+}
+// set the CLI_BIN environment variable to the path of the CLI binary
+process.env.CLI_BIN = resolve(dirname(pkg.path), String(pkg.packageJson.bin?.['fusion-framework-cli']));
+import { Command } from 'commander';
+// Create the main CLI program instance
+const program = new Command();
+program.name(pkg.packageJson.name);
+program.description([
+    `${pkg.packageJson.name}@${pkg.packageJson.version}`,
+    '',
+    'Fusion Framework CLI',
+    '',
+    'A toolkit for building, packaging, deploying, and managing Fusion applications and portals.',
+    '',
+    '• Run fusion <command> --help for details on any command.',
+    '• For documentation, issues, and source code, visit:',
+    `  ${pkg.packageJson.homepage}`,
+].join('\n'));
+program.version(pkg.packageJson.version, '-V, --version', 'CLI version');
+import registerCommands from './commands';
+registerCommands(program);
+/** read action and options and start programs */
+program.parse();
+//# sourceMappingURL=main.js.map

package/dist/esm/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,0CAA0C;AAC1C,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvE,IAAI,CAAC,GAAG,EAAE,CAAC;IACT,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC7C,CAAC;AAED,qEAAqE;AACrE,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,OAAO,CAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EACjB,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,CAAC,CACtD,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,uCAAuC;AACvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACnC,OAAO,CAAC,WAAW,CACjB;IACE,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE;IACpD,EAAE;IACF,sBAAsB;IACtB,EAAE;IACF,6FAA6F;IAC7F,EAAE;IACF,2DAA2D;IAC3D,sDAAsD;IACtD,KAAK,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE;CAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACF,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAEzE,OAAO,gBAAgB,MAAM,YAAY,CAAC;AAE1C,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAE1B,iDAAiD;AACjD,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/esm/cli/options/auth.js

@@ -0,0 +1,96 @@
+import { createOption, InvalidOptionArgumentError } from 'commander';
+// UUID validation regex (v4 UUID format)
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export const tenantOption = createOption('--tenantId <string>', 'The Azure Active Directory tenant ID')
+    .env('FUSION_TENANT_ID')
+    .default('3aa4a235-b6e2-48d5-9195-7fcf05b459b0');
+export const clientOption = createOption('--clientId <string>', 'The client ID of the application registered in Azure AD')
+    .env('FUSION_CLIENT_ID')
+    .default('a318b8e1-0295-4e17-98d5-35f67dfeba14');
+export const tokenOption = createOption('--token <string>', 'The Azure AD access token. If provided, the --tenant and --client options are ignored')
+    .env('FUSION_TOKEN')
+    .default(undefined);
+export const scopeOption = createOption('--scope <scopes...>', 'Azure audience scope, normally the application ID URI of the API you want to access and `.default`')
+    .env('FUSION_AUTH_SCOPE')
+    .default(['5a842df8-3238-415d-b168-9f16a6a6031b/.default']);
+/**
+ * Enhances a given command with authentication-related options.
+ *
+ * This function adds the following options to the provided command:
+ * - `tenantId`: Specifies the tenant identifier.
+ * - `clientId`: Specifies the client identifier.
+ * - `token`: Specifies the authentication token.
+ *
+ * @param command - The command to which authentication options will be added.
+ *
+ * @example
+ * ```ts
+ * import { createCommand } from 'commander';
+ * import { withAuthOptions } from './path/to/this/file';
+ * const command = withAuthOptions(
+ *   createCommand('my-command')
+ *     .description('My command description')
+ *     .action((options) => {
+ *       console.log('tenantId:', options.tenant);
+ *       console.log('clientId:', options.client);
+ *       console.log('token:', options.token);
+ *     })
+ * );
+ *
+ * withAuthOptions(command);
+ * ```
+ **/
+export const withAuthOptions = (command, args) => {
+    command.addOption(tenantOption);
+    command.addOption(clientOption);
+    if (!args?.excludeToken) {
+        command.addOption(tokenOption);
+    }
+    if (args?.includeScope) {
+        command.addOption(scopeOption);
+    }
+    command.hook('preAction', (thisCommand) => {
+        const options = thisCommand.opts();
+        // If token is provided, skip other validations
+        if (options.token) {
+            if (typeof options.token !== 'string' || options.token.trim() === '') {
+                throw new InvalidOptionArgumentError('Token must be a non-empty string.');
+            }
+            // Remove tenantId, clientId, and scope by setting them to undefined
+            thisCommand.setOptionValue('tenantId', undefined);
+            thisCommand.setOptionValue('clientId', undefined);
+            if (args?.includeScope) {
+                thisCommand.setOptionValue('scope', undefined);
+            }
+            return;
+        }
+        // Validate tenantId
+        if (!options.tenantId || typeof options.tenantId !== 'string') {
+            throw new InvalidOptionArgumentError('Tenant ID must be a non-empty string.');
+        }
+        if (!UUID_REGEX.test(options.tenantId)) {
+            throw new InvalidOptionArgumentError('Tenant ID must be a valid UUID.');
+        }
+        // Validate clientId
+        if (!options.clientId || typeof options.clientId !== 'string') {
+            throw new InvalidOptionArgumentError('Client ID must be a non-empty string.');
+        }
+        if (!UUID_REGEX.test(options.clientId)) {
+            throw new InvalidOptionArgumentError('Client ID must be a valid UUID.');
+        }
+        // Validate scope if included
+        if (args?.includeScope) {
+            if (!Array.isArray(options.scope) || options.scope.length === 0) {
+                throw new InvalidOptionArgumentError('Scope must be a non-empty array of strings.');
+            }
+            for (const scope of options.scope) {
+                if (typeof scope !== 'string' || scope.trim() === '') {
+                    throw new InvalidOptionArgumentError('Each scope must be a non-empty string.');
+                }
+            }
+        }
+    });
+    return command;
+};
+export default withAuthOptions;
+//# sourceMappingURL=auth.js.map

package/dist/esm/cli/options/auth.js.map

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

package/dist/esm/cli/options/env.js

@@ -0,0 +1,30 @@
+import { createOption } from 'commander';
+import { resolveDefaultEnv, FusionEnv } from '../../lib/framework.node.js';
+/**
+ * Creates an environment option for Fusion Framework CLI commands.
+ *
+ * @param options - Configuration options for the environment option.
+ * @param options.default - The default environment to use if not specified.
+ * @param options.allowDev - Whether to allow the development environment.
+ * @returns A configured Commander option for the environment.
+ */
+export const createEnvOption = (options) => {
+    const allowedEnvs = Object.values(FusionEnv).filter((env) => env === FusionEnv.Development ? options.allowDev : true);
+    return createOption('-e, --env <string>', [
+        'Specify the environment to use for the Fusion Framework command.',
+        `Allowed values: [${allowedEnvs.join(', ')}, custom]`,
+        'You can also set the environment using the FUSION_ENV environment variable.',
+        `Defaults to ${options.default ?? resolveDefaultEnv(options.allowDev)}.`,
+        options.allowDev
+            ? 'Development environment is allowed.'
+            : 'Development environment is not allowed for this command.',
+    ].join(' '))
+        .env('FUSION_ENV')
+        .default(options.default ?? resolveDefaultEnv(options.allowDev));
+};
+/**
+ * Default environment option that allows the development environment.
+ */
+export const envOption = createEnvOption({ allowDev: true });
+export default envOption;
+//# sourceMappingURL=env.js.map

package/dist/esm/cli/options/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../src/cli/options/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAI3E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAmD,EAAE,EAAE;IACrF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1D,GAAG,KAAK,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACxD,CAAC;IACF,OAAO,YAAY,CACjB,oBAAoB,EACpB;QACE,kEAAkE;QAClE,oBAAoB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;QACrD,6EAA6E;QAC7E,eAAe,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG;QACxE,OAAO,CAAC,QAAQ;YACd,CAAC,CAAC,qCAAqC;YACvC,CAAC,CAAC,0DAA0D;KAC/D,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ;SACE,GAAG,CAAC,YAAY,CAAC;SACjB,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7D,eAAe,SAAS,CAAC"}

package/dist/esm/lib/app/app-config.js

@@ -0,0 +1,12 @@
+export { mergeAppConfig } from './merge-app-config.js';
+/**
+ * Defines the application configuration by accepting a function that returns the configuration object.
+ *
+ * This utility is typically used to encapsulate and organize application-specific settings
+ * in a structured and type-safe manner.
+ *
+ * @param fn - A function that returns the application configuration object.
+ * @returns The result of invoking the provided configuration function.
+ */
+export const defineAppConfig = (fn) => fn;
+//# sourceMappingURL=app-config.js.map

package/dist/esm/lib/app/app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../../../../src/lib/app/app-config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoBvD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Utility to define an application manifest in a type-safe and organized manner.
+ *
+ * @param fn - A function conforming to AppManifestFn that generates the manifest configuration.
+ * @returns The result of the provided function, representing the application manifest.
+ *
+ * Usage: Use this to encapsulate manifest logic, enabling better maintainability and discoverability for RAG systems.
+ *
+ * Inline notes:
+ * - This function is a higher-order utility for manifest definition, not execution.
+ * - It does not invoke the function immediately; it simply returns it for later use.
+ * - Helps with static analysis and RAG-based documentation extraction.
+ */
+export const defineAppManifest = (fn) => fn;
+//# sourceMappingURL=app-manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/app-manifest.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,EAAE,CAAC"}

package/dist/{lib → esm/lib/app}/app-package.js

@@ -1,24 +1,25 @@
 import { existsSync } from 'node:fs';
 import { dirname, relative } from 'node:path';
 import { readPackageUp, } from 'read-package-up';
-import { assert } from './utils/assert.js';
-// implementation
+import { assert } from '../utils/assert.js';
+// Implementation for defineAppPackage, returns the input as-is.
 export function defineAppPackage(fnOrObject) {
+    // This function is intentionally a passthrough for both object and function types.
     return fnOrObject;
 }
 /**
  * Resolves the entry point of a given package.
  *
- * This function attempts to find the entry point of a package by checking several
- * common properties in the package's `package.json` file, such as `entrypoint`, `main`,
- * and `module`. If none of these properties are found, it defaults to checking for
- * common entry files like `src/index.ts`, `src/index.tsx`, `src/index.js`, and `src/index.jsx`.
+ * This function checks for common entry point fields in the package.json (entrypoint, main, module),
+ * and falls back to typical source files if not found. It returns the first existing entry.
  *
- * @param pkg - The resolved application package containing the package.json and path information.
+ * @param packageJson - The package.json object to resolve from.
+ * @param pkgPath - The path to the package.json file (used for relative resolution).
  * @returns The relative path to the resolved entry point.
  * @throws Will throw an error if no entry point can be resolved.
  */
 export const resolveEntryPoint = (packageJson, pkgPath = '') => {
+    // List of possible entry points, prioritized by common convention.
     const entrypoint = [
         packageJson.entrypoint,
         packageJson.main,
@@ -28,45 +29,64 @@ export const resolveEntryPoint = (packageJson, pkgPath = '') => {
         'src/index.js',
         'src/index.jsx',
     ]
+        // Filter out undefined/null values.
         .filter((x) => !!x)
+        // Map to relative paths from the package root.
         .map((x) => relative(dirname(pkgPath), x))
+        // Find the first entry that actually exists on disk.
         .find((entry) => existsSync(entry));
+    // Assert that an entry point was found, otherwise throw.
     assert(entrypoint, 'failed to resolve entrypoint');
     return entrypoint;
 };
 /**
  * Resolves the application key from the given package.json object.
  *
+ * This function strips any leading '@' or scope from the package name, returning a normalized key.
+ *
  * @param packageJson - An object containing the 'name' property from the package.json.
  * @returns The resolved application key, which is the package name with any leading '@' or scope removed.
  * @throws Will throw an error if the 'name' property is not present in the packageJson.
  */
 export const resolveAppKey = (packageJson) => {
+    // Ensure the package has a name property.
     assert(packageJson.name, 'expected [name] in packageJson');
+    // Remove leading '@' or scope from the name for normalization.
     return packageJson.name.replace(/^@|\w.*\//gm, '');
 };
 /**
  * Asserts the validity of a given package by resolving its application key and entry point.
  *
+ * This function is useful for validating that a package is correctly structured and can be used by the framework.
+ *
  * @param pkg - A partial representation of the application's package JSON.
+ * @throws Will throw if the package is missing a valid name or entry point.
  */
 export const assertPackage = (pkg) => {
+    // Validate that the package has a valid key and entry point.
     assert(resolveAppKey(pkg));
     assert(resolveEntryPoint(pkg));
 };
 /**
  * Resolves the application package by searching for the nearest `package.json` file.
  *
+ * This function uses `read-package-up` to traverse up the directory tree and find the closest package.json.
+ * It returns the package contents, its path, and the root directory.
+ *
  * @param options - Optional parameters to customize the search behavior.
  * @returns A promise that resolves to the found package information.
  * @throws Will throw an error if the `package.json` file is not found.
  */
 export const resolveAppPackage = async (options) => {
-    const result = await readPackageUp(options);
-    if (!result) {
+    // Attempt to find the nearest package.json using read-package-up.
+    const pkg = await readPackageUp(options);
+    if (!pkg) {
+        // Throw if no package.json is found in the directory tree.
         throw Error('failed to find package.json');
     }
-    return result;
+    // Return the resolved package, including its root directory.
+    return { ...pkg, root: dirname(pkg.path) };
 };
+// Export the main package resolver as the default export for convenience.
 export default resolveAppPackage;
 //# sourceMappingURL=app-package.js.map

package/dist/esm/lib/app/app-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-package.js","sourceRoot":"","sources":["../../../../src/lib/app/app-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAEL,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA0C5C,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,UAAiC;IAChE,mFAAmF;IACnF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAwB,EAAE,OAAO,GAAG,EAAE,EAAU,EAAE;IAClF,mEAAmE;IACnE,MAAM,UAAU,GAAG;QACjB,WAAW,CAAC,UAAU;QACtB,WAAW,CAAC,IAAI;QAChB,WAAW,CAAC,MAAM;QAClB,cAAc;QACd,eAAe;QACf,cAAc;QACd,eAAe;KAChB;QACC,oCAAoC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,+CAA+C;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAU,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,qDAAqD;SACpD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtC,yDAAyD;IACzD,MAAM,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;IAEnD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAsC,EAAE,EAAE;IACtE,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;IAC3D,+DAA+D;IAC/D,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAA4B,EAAE,EAAE;IAC5D,6DAA6D;IAC7D,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,iBAAiB,CAAC,GAAqB,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,OAAkC,EACL,EAAE;IAC/B,kEAAkE;IAClE,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,2DAA2D;QAC3D,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IACD,6DAA6D;IAC7D,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAwB,CAAC;AACnE,CAAC,CAAC;AAEF,0EAA0E;AAC1E,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,72 @@
+import { assert, assertObject } from '../utils/assert.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 { resolveAnnotations } from '../utils/resolve-annotations.js';
+import { ASSET_EXTENSIONS } from '../static.js';
+/**
+ * Resolves the entry point for the application based on the environment and package.json.
+ *
+ * Uses the compiled entry point for production/preview builds, otherwise uses the source entry point.
+ *
+ * @param env - The runtime environment.
+ * @param packageJson - The application's package.json object.
+ * @returns The resolved entry point path as a string.
+ */
+const resolveAppEntryPoint = (env, packageJson) => {
+    // use compiled entry point when building for production or preview
+    if (env.command === 'build' || env.isPreview) {
+        return packageJson.main || packageJson.module || 'dist/app-bundle.js';
+    }
+    // use source entry point when developing
+    return resolveEntryPoint(env.root);
+};
+/**
+ * Creates an AppManifest object from the given runtime environment and package.json.
+ *
+ * This function extracts and normalizes manifest fields, resolves the entry point, asset path,
+ * and repository information, and includes build metadata. It is the main entry for generating
+ * a manifest for Fusion Framework applications.
+ *
+ * @param env - The runtime environment.
+ * @param packageJson - The application's package.json object.
+ * @returns The generated AppManifest object.
+ * @throws If required fields are missing in packageJson.
+ * @public
+ */
+export const createAppManifestFromPackage = (env, packageJson) => {
+    // Validate input objects
+    assertObject(packageJson, 'expected packageJson');
+    assert(packageJson.name, 'expected [name] in packageJson');
+    assert(packageJson.version, 'expected [version] in packageJson');
+    // Resolve the entry point for the app
+    const entryPoint = resolveAppEntryPoint(env, packageJson);
+    // Extract appKey from package name by removing the scope and leading @
+    // This ensures a normalized, unique key for the app
+    const appKey = packageJson.name.replace(/^@|\w.*\//gm, '');
+    const version = packageJson.version;
+    // Try to resolve the GitHub repo from package or git config
+    const githubRepo = resolveRepoFromPackage(packageJson) ?? resolveGitRemoteUrl();
+    // Return the manifest object, using satisfies for type safety
+    return {
+        appKey,
+        displayName: packageJson.name,
+        description: packageJson.description || '',
+        keywords: packageJson.keywords,
+        type: 'standalone',
+        build: {
+            entryPoint,
+            githubRepo,
+            version,
+            timestamp: new Date().toISOString(), // Build timestamp for traceability
+            commitSha: resolveGitCommitSha(), // Current git commit SHA for traceability
+            annotations: resolveAnnotations(), // Resolve any build annotations
+            projectPage: packageJson.homepage,
+            allowedExtensions: ASSET_EXTENSIONS.map(
+            // TODO: @jaysencpp, this is just 🫤, extensions should not require leading dot
+            (ext) => `.${ext}`),
+        },
+    };
+};
+//# sourceMappingURL=create-app-manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/create-app-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,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,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG,CAAC,GAAe,EAAE,WAAwB,EAAU,EAAE;IACjF,mEAAmE;IACnE,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAC7C,OAAO,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,IAAI,oBAAoB,CAAC;IACxE,CAAC;IACD,yCAAyC;IACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,GAAe,EACf,WAAwB,EACX,EAAE;IACf,yBAAyB;IACzB,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,sCAAsC;IACtC,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE1D,uEAAuE;IACvE,oDAAoD;IACpD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAEpC,4DAA4D;IAC5D,MAAM,UAAU,GAAG,sBAAsB,CAAC,WAAW,CAAC,IAAI,mBAAmB,EAAE,CAAC;IAEhF,8DAA8D;IAC9D,OAAO;QACL,MAAM;QACN,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;QAC1C,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE;YACL,UAAU;YACV,UAAU;YACV,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,mCAAmC;YACxE,SAAS,EAAE,mBAAmB,EAAE,EAAE,0CAA0C;YAC5E,WAAW,EAAE,kBAAkB,EAAE,EAAE,gCAAgC;YACnE,WAAW,EAAE,WAAW,CAAC,QAAQ;YACjC,iBAAiB,EAAE,gBAAgB,CAAC,GAAG;YACrC,+EAA+E;YAC/E,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CACnB;SACF;KACoB,CAAC;AAC1B,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+export { defineAppManifest } from './app-manifest.js';
+export { createAppManifestFromPackage } from './create-app-manifest.js';
+export { mergeAppManifests } from './merge-app-manifest.js';
+export { loadAppManifest } from './load-app-manifest.js';
+export { mergeAppConfig } from './merge-app-config.js';
+export { defineAppConfig } from './app-config.js';
+export { loadAppConfig } from './load-app-config.js';
+export { ApiAppConfigSchema } from './schemas.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwC,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAA0B,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAoC,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAwB,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/esm/lib/app/load-app-config.js

@@ -0,0 +1,47 @@
+import { importConfig } from '@equinor/fusion-imports';
+import { ApiAppConfigSchema } from './schemas.js';
+/**
+ * Loads and resolves the application configuration from a file or function export.
+ *
+ * This function uses a script resolver to handle dynamic imports. If the imported module's default export
+ * is a function, it will be invoked with the runtime environment and the base configuration. The result
+ * is validated against the `ApiAppConfigSchema`. If the export is an object, it is validated directly.
+ *
+ * @param env - The runtime environment containing the root directory and other environment-specific settings.
+ * @param options - Optional parameters for configuring the import process.
+ * @returns A promise that resolves to the imported and validated application configuration.
+ *
+ * @remarks
+ * - Supports both static and dynamic config authoring patterns.
+ * - Ensures all configs are validated against the schema for type safety.
+ * - Designed for maintainability and RAG-based documentation extraction.
+ *
+ * @example
+ * ```ts
+ * const config = await loadAppConfig(env, { file: 'custom.config.ts' });
+ * ```
+ */
+export const loadAppConfig = (env, options) => {
+    // Suggest config filenames based on environment, fallback to default
+    const suggestions = options?.file ?? [`app.config.${env.environment}`, 'app.config'];
+    return importConfig(suggestions, {
+        baseDir: env.root, // Set the base directory for config resolution
+        extensions: options?.extensions, // Allow custom file extensions
+        script: {
+            // Custom resolver for the imported config module
+            resolve: async (module) => {
+                const base = options?.base ?? { environment: {} }; // Use provided base or default
+                // If the module's default export is a function, invoke it with the environment and base config
+                // and validate the result against the schema
+                if (typeof module.default === 'function') {
+                    const result = (await module.default(env, { base })) ?? base;
+                    return ApiAppConfigSchema.parse(result ?? base); // Validate and return
+                }
+                // If the module's default export is not a function, treat it as a configuration object
+                // and validate it against the schema
+                return ApiAppConfigSchema.parse(module.default ?? base); // Validate and return
+            },
+        },
+    });
+};
+//# sourceMappingURL=load-app-config.js.map

package/dist/esm/lib/app/load-app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-app-config.js","sourceRoot":"","sources":["../../../../src/lib/app/load-app-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EAAqB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAmCrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,GAAe,EACf,OAA8B,EACa,EAAE;IAC7C,qEAAqE;IACrE,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;IACrF,OAAO,YAAY,CAAC,WAAW,EAAE;QAC/B,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,+CAA+C;QAClE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,+BAA+B;QAChE,MAAM,EAAE;YACN,iDAAiD;YACjD,OAAO,EAAE,KAAK,EAAE,MAAoC,EAAyB,EAAE;gBAC7E,MAAM,IAAI,GAAiB,OAAO,EAAE,IAAI,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,+BAA+B;gBAEhG,+FAA+F;gBAC/F,6CAA6C;gBAC7C,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACzC,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;oBAC7D,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,sBAAsB;gBACzE,CAAC;gBACD,uFAAuF;gBACvF,qCAAqC;gBACrC,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,sBAAsB;YACjF,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}