@equinor/fusion-framework-cli 13.0.1 → 13.1.1

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

@@ -5,6 +5,7 @@ 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';
+import { generateSnapshotVersion } from '../utils/snapshot.js';
 /**
  * Resolves the entry point for the application based on the environment and package.json.
  *
@@ -35,7 +36,7 @@ const resolveAppEntryPoint = (env, packageJson) => {
  * @throws If required fields are missing in packageJson.
  * @public
  */
-export const createAppManifestFromPackage = (env, packageJson) => {
+export const createAppManifestFromPackage = (env, packageJson, options) => {
     // Validate input objects
     assertObject(packageJson, 'expected packageJson');
     assert(packageJson.name, 'expected [name] in packageJson');
@@ -45,7 +46,9 @@ export const createAppManifestFromPackage = (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;
+    const version = options?.snapshot
+        ? generateSnapshotVersion(packageJson.version, options.snapshot)
+        : packageJson.version;
     const assetPath = env.command === 'build' ? undefined : `/bundles/apps/${appKey}@${version}`;
     // Try to resolve the GitHub repo from package or git config
     const githubRepo = resolveRepoFromPackage(packageJson) ?? resolveGitRemoteUrl();

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

@@ -1 +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;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,MAAM,IAAI,OAAO,EAAE,CAAC;IAE7F,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,SAAS;YACT,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"}
+{"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;AAGhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;;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,EACxB,OAAyC,EAC5B,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,OAAO,EAAE,QAAQ;QAC/B,CAAC,CAAC,uBAAuB,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;QAChE,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;IACxB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,MAAM,IAAI,OAAO,EAAE,CAAC;IAE7F,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,SAAS;YACT,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/utils/index.js

@@ -4,4 +4,5 @@ export { resolvePackage } from './resolve-package.js';
 export { fileExists, fileExistsSync } from './file-exists.js';
 export { writeFile } from './write-file.js';
 export { resolveAnnotations } from './resolve-annotations.js';
+export { generateSnapshotVersion } from './snapshot.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/lib/utils/snapshot.js

@@ -0,0 +1,40 @@
+import { coerce } from 'semver';
+/**
+ * Generates a snapshot version from a semantic version, coercing pre-release suffixes when present.
+ *
+ * This function accepts standard semantic versions and versions with pre-release suffixes (e.g.,
+ * `1.2.3-beta.1`). It uses {@link coerce} to normalize the input to the base `major.minor.patch`
+ * version before appending a timestamp-based snapshot suffix. Snapshot version formats:
+ * - With no identifier: {version}-snapshot.{unix_timestamp}
+ * - With identifier: {version}-{identifier}.{unix_timestamp}
+ *
+ * @param version - The semantic version to convert (pre-release suffixes are accepted and stripped)
+ * @param identifier - Optional snapshot identifier; if omitted or boolean, defaults to `snapshot`
+ * @returns The generated snapshot version string
+ * @throws {Error} If the version cannot be coerced into a valid semantic version
+ *
+ * @example
+ * ```typescript
+ * // With default identifier
+ * generateSnapshotVersion('1.2.3'); // Returns: "1.2.3-snapshot.1737545600"
+ *
+ * // With custom identifier
+ * generateSnapshotVersion('1.2.3', 'pr-123'); // Returns: "1.2.3-pr-123.1737545600"
+ * ```
+ *
+ * @public
+ */
+export function generateSnapshotVersion(version, identifier) {
+    // Coerce the version to strip any pre-release suffix and get the base version
+    const baseVersion = coerce(version)?.version;
+    if (!baseVersion) {
+        throw new Error(`Invalid semantic version: "${version}". Expected format: major.minor.patch`);
+    }
+    // Generate the unix timestamp for uniqueness
+    const unixTimestamp = Math.floor(Date.now() / 1000);
+    // Determine the suffix format based on whether an identifier was provided
+    const suffix = typeof identifier === 'string' ? `${identifier}.${unixTimestamp}` : `snapshot.${unixTimestamp}`;
+    // Return the formatted snapshot version
+    return `${baseVersion}-${suffix}`;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/esm/lib/utils/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../src/lib/utils/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,UAA6B;IACpF,8EAA8E;IAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,uCAAuC,CAAC,CAAC;IAChG,CAAC;IAED,6CAA6C;IAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEpD,0EAA0E;IAC1E,MAAM,MAAM,GACV,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,YAAY,aAAa,EAAE,CAAC;IAElG,wCAAwC;IACxC,OAAO,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '13.0.1';
+export const version = '13.1.1';
 //# sourceMappingURL=version.js.map

package/dist/types/bin/app-build.d.ts

@@ -19,6 +19,10 @@ export type BuildApplicationOptions = {
      * Logger instance for build output. If null, disables logging.
      */
     log?: ConsoleLogger | null;
+    /**
+     * Optional snapshot version used in the build.
+     */
+    snapshot?: boolean | string;
 };
 /**
  * Output of the application build process.
@@ -43,7 +47,7 @@ type ApplicationBuildOutput = {
  *
  * Loads the application manifest, applies Vite configuration, and runs the Vite build process.
  *
- * @param opt - Build options including environment, manifest path, and logger.
+ * @param opt - Build options including environment, manifest path, logger, and optional snapshot version.
  * @returns Output containing package info, manifest, and output directory.
  * @throws Will throw if the build process fails.
  * @public

package/dist/types/bin/app-manifest.d.ts

@@ -5,7 +5,8 @@ import type { ConsoleLogger } from './utils/index.js';
  *
  * This type defines the shape of the options object accepted by
  * {@link loadAppManifest}. It allows for optional logging, environment overrides,
- * and a custom manifest file path.
+ * a custom manifest file path, and an optional snapshot version to override the
+ * package.json version.
  *
  * @public
  */
@@ -22,11 +23,19 @@ export type ResolveAppManifestOptions = {
      * Partial runtime environment overrides (optional).
      */
     env?: Partial<RuntimeEnv>;
+    /**
+     * Optional snapshot version to use instead of package.json version.
+     * If provided, this version will be used in the manifest build metadata
+     * without modifying package.json.
+     */
+    snapshot?: boolean | string;
 };
 /**
  * Loads and resolves the application manifest based on the provided options.
  *
  * This function resolves the app package, sets up the runtime environment, and loads the manifest.
+ * If a snapshot version is provided, it will be used in the manifest build metadata instead of
+ * the package.json version, without modifying package.json.
  * Logging is supported for debugging and progress tracking. Returns the manifest, package, and environment.
  *
  * @param options - The options for resolving the application manifest.

package/dist/types/bin/app-pack.d.ts

@@ -3,7 +3,8 @@ import type { ConsoleLogger } from './utils/ConsoleLogger.js';
  * Options for bundling the application into an archive.
  *
  * This type defines the shape of the options object accepted by
- * {@link bundleApp}. It allows for optional logging, manifest path, and archive name.
+ * {@link bundleApp}. It allows for optional logging, manifest path, archive name,
+ * and an optional snapshot version to override the package.json version.
  *
  * @public
  */
@@ -20,14 +21,21 @@ export type BundleAppOptions = {
      * Name or path of the output archive file (optional).
      */
     archive?: string;
+    /**
+     * Optional snapshot version to use instead of package.json version.
+     * If provided, this version will be used in the manifest build metadata
+     * without modifying package.json.
+     */
+    snapshot?: boolean | string;
 };
 /**
  * Bundles the application into an archive for distribution or deployment.
  *
  * This function builds the application, validates the manifest, and creates an archive containing
- * the app manifest and metadata. Handles errors and logs progress for maintainability and debugging.
+ * the app manifest and metadata. If a snapshot version is provided, it will be used in the bundle
+ * metadata without modifying package.json. Handles errors and logs progress for maintainability and debugging.
  *
- * @param options - Options for logger, manifest path, and archive name.
+ * @param options - Options for logger, manifest path, archive name, and optional snapshot version.
  * @returns An object containing the archive path and the application manifest.
  * @throws If the manifest build config is missing or packaging fails.
  * @public

package/dist/types/bin/app-tag.d.ts

@@ -1,19 +1,5 @@
 import type { FusionFramework } from '@equinor/fusion-framework-cli/bin';
 import { type ConsoleLogger } from './utils/index.js';
-/**
- * Allowed tags for application versions in the app service.
- *
- * - `latest`: Marks the most recent stable version of the application.
- * - `preview`: Marks a pre-release or preview version for testing or review.
- *
- * Used by {@link tagApplication} to validate and apply version tags.
- *
- * @public
- */
-export declare enum AllowedTags {
-    Latest = "latest",
-    Preview = "preview"
-}
 /**
  * Options for tagging an application version in the app service.
  *
@@ -30,14 +16,15 @@ export declare enum AllowedTags {
  * @public
  */
 export type TagApplicationOptions = {
-    tag: AllowedTags;
+    tag: string;
     appKey: string;
     version: string;
     framework: FusionFramework;
     log?: ConsoleLogger | null;
 };
 /**
- * Tags an application version in the app service with a specified tag (e.g., 'latest' or 'preview').
+ * Tags an application version in the app service with a specified tag (e.g., 'latest', 'preview'
+ * or pr-1234).
  *
  * This function validates input, creates a client for the app service, and sends a tag request.
  * It provides detailed logging and error handling for common failure scenarios.

package/dist/types/bin/helpers/resolve-app-manifest.d.ts

@@ -14,4 +14,5 @@ import type { ConsoleLogger } from '../utils/index.js';
 export declare const resolveAppManifest: (env: RuntimeEnv, pkg: ResolvedPackage, options?: {
     log?: ConsoleLogger | null;
     manifestPath?: string;
+    snapshot?: boolean | string;
 }) => Promise<import("@equinor/fusion-framework-cli/app").AppManifest>;

package/dist/types/bin/index.d.ts

@@ -6,7 +6,7 @@ export { startAppDevServer } from './app-dev.js';
 export { checkApp } from './app-check.js';
 export { loadAppManifest } from './app-manifest.js';
 export { uploadApplication } from './app-upload.js';
-export { tagApplication, AllowedTags as AllowedAppTags } from './app-tag.js';
+export { tagApplication } from './app-tag.js';
 export { startPortalDevServer } from './portal-dev.js';
 export { buildPortal } from './portal-build.js';
 export { bundlePortal } from './portal-pack.js';

package/dist/types/cli/commands/app/pack.d.ts

@@ -9,9 +9,12 @@ export declare const DEFAULT_ARCHIVE: "app-bundle.zip";
  * - Output filename and directory can be specified.
  * - Optionally provide a manifest file to customize the bundle.
  * - If no manifest is provided, defaults to app.manifest.[ts|js|json] in the current directory.
+ * - Supports `--snapshot` flag to generate a snapshot version without modifying package.json.
  *
  * Usage:
  *   $ ffc app pack [manifest] [options]
+ *   $ ffc app pack --snapshot
+ *   $ ffc app pack --snapshot pr-123
  *
  * Arguments:
  *   [manifest]           Manifest file to use for bundling (e.g., app.manifest.ts)
@@ -20,10 +23,13 @@ export declare const DEFAULT_ARCHIVE: "app-bundle.zip";
  *   -a, --archive        Name of the output archive file (default: app-bundle.zip)
  *   -o, --output         Directory where the archive will be saved (default: current working directory)
  *   -d, --debug          Enable debug mode for verbose logging
+ *   -s, --snapshot       Generate a snapshot version (optionally with custom identifier)
  *
  * Example:
  *   $ ffc app pack
  *   $ ffc app pack app.manifest.dev.ts --archive my-app.zip --output ./dist
+ *   $ ffc app pack --snapshot
+ *   $ ffc app pack --snapshot pr-456
  *
  * @see bundleApp for implementation details
  */

package/dist/types/cli/commands/app/publish.d.ts

@@ -8,9 +8,12 @@
  * - Builds the app first if no bundle is provided.
  * - Supports specifying environment, manifest file, and tag.
  * - Debug mode and authentication options are supported.
+ * - Supports `--snapshot` flag to publish with a snapshot version without modifying package.json.
  *
  * Usage:
  *   $ ffc app publish [bundle] [options]
+ *   $ ffc app publish --snapshot
+ *   $ ffc app publish --snapshot pr-123
  *
  * Arguments:
  *   [bundle]             Path to the app bundle to upload
@@ -19,12 +22,15 @@
  *   -d, --debug          Enable debug mode for verbose logging (default: false)
  *   -e, --env <env>      Target environment
  *   -m, --manifest       Manifest file to use for bundling (e.g., app.manifest.ts)
- *   -t, --tag            Tag to apply to the published app (latest | preview)
+ *   -t, --tag            Tag to apply to the published app (e.g. latest | preview | pr-1234)
+ *   -s, --snapshot       Build with snapshot version (optionally with custom identifier)
  *
  * Example:
  *   $ ffc app publish
  *   $ ffc app publish --env prod --manifest app.manifest.prod.ts
  *   $ ffc app publish --tag latest app.bundle.zip
+ *   $ ffc app publish --snapshot
+ *   $ ffc app publish --snapshot pr-456
  *
  * @see uploadApplication, tagApplication for implementation details
  */

package/dist/types/cli/commands/app/tag.d.ts

@@ -12,7 +12,7 @@
  *   $ fusion tag <tag> [options]
  *
  * Arguments:
- *   <tag>                           Tag to apply (latest | preview)
+ *   <tag>                           Tag to apply (e.g. latest | preview | pr-1234)
  *
  * Options:
  *   -p, --package [package@version] Package to tag in format name@version (e.g., my-app@1.0.0). If not provided, loaded from manifest
@@ -25,6 +25,7 @@
  *   $ ffc app tag latest
  *   $ ffc app tag preview --env prod --manifest app.manifest.prod.ts
  *   $ ffc app tag latest --package my-app@1.2.3
+ *   $ ffc app tag pr-1234 --package my-app@1.2.3
  *
  * @see tagApplication for implementation details
  */

package/dist/types/cli/commands/portal/publish.d.ts

@@ -15,12 +15,13 @@
  *   -d, --debug          Enable debug mode for verbose logging
  *   -e, --env <env>      Target environment
  *   -m, --manifest       Manifest file to use for bundling
- *   -t, --tag            Tag to apply to the published portal (any string value)
+ *   -t, --tag            Tag to apply to the published portal (e.g latest | preview | pr-1234)
  *
  * Example:
  *   $ ffc portal publish
  *   $ ffc portal publish --env prod --manifest portal.manifest.prod.ts
  *   $ ffc portal publish --tag preview
+ *   $ ffc portal publish --tag pr-1234
  *
  * @see uploadPortalBundle, tagPortal for implementation details
  */

package/dist/types/cli/commands/portal/tag.d.ts

@@ -12,7 +12,7 @@
  *   $ ffc portal tag <tag> [options]
  *
  * Arguments:
- *   <tag>                  Tag to apply (e.g., latest, preview, next, or any string value)
+ *   <tag>                  Tag to apply (e.g., latest, preview, next, or string [a-z, A-Z, 0-9, ".", "-"])
  *
  * Options:
  *   -m, --manifest <file>  Manifest file to use (optional, defaults to portal.manifest.ts)

package/dist/types/lib/app/create-app-manifest.d.ts

@@ -14,4 +14,6 @@ import type { RuntimeEnv } from '../types.js';
  * @throws If required fields are missing in packageJson.
  * @public
  */
-export declare const createAppManifestFromPackage: (env: RuntimeEnv, packageJson: PackageJson) => AppManifest;
+export declare const createAppManifestFromPackage: (env: RuntimeEnv, packageJson: PackageJson, options?: {
+    snapshot?: boolean | string;
+}) => AppManifest;

package/dist/types/lib/utils/index.d.ts

@@ -4,3 +4,4 @@ export { resolvePackage, type ResolvedPackage } from './resolve-package.js';
 export { fileExists, fileExistsSync } from './file-exists.js';
 export { writeFile } from './write-file.js';
 export { resolveAnnotations } from './resolve-annotations.js';
+export { generateSnapshotVersion } from './snapshot.js';

package/dist/types/lib/utils/snapshot.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generates a snapshot version from a semantic version, coercing pre-release suffixes when present.
+ *
+ * This function accepts standard semantic versions and versions with pre-release suffixes (e.g.,
+ * `1.2.3-beta.1`). It uses {@link coerce} to normalize the input to the base `major.minor.patch`
+ * version before appending a timestamp-based snapshot suffix. Snapshot version formats:
+ * - With no identifier: {version}-snapshot.{unix_timestamp}
+ * - With identifier: {version}-{identifier}.{unix_timestamp}
+ *
+ * @param version - The semantic version to convert (pre-release suffixes are accepted and stripped)
+ * @param identifier - Optional snapshot identifier; if omitted or boolean, defaults to `snapshot`
+ * @returns The generated snapshot version string
+ * @throws {Error} If the version cannot be coerced into a valid semantic version
+ *
+ * @example
+ * ```typescript
+ * // With default identifier
+ * generateSnapshotVersion('1.2.3'); // Returns: "1.2.3-snapshot.1737545600"
+ *
+ * // With custom identifier
+ * generateSnapshotVersion('1.2.3', 'pr-123'); // Returns: "1.2.3-pr-123.1737545600"
+ * ```
+ *
+ * @public
+ */
+export declare function generateSnapshotVersion(version: string, identifier?: boolean | string): string;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "13.0.1";
+export declare const version = "13.1.1";

package/docs/ai-commands.md

@@ -418,7 +418,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
 
       - run: pnpm install
 
@@ -461,7 +461,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies

package/docs/dev-server-config.md

@@ -293,6 +293,16 @@ export default defineDevServerConfig(() => ({
 - `3`: Error (shows only errors and critical messages)
 - `4`: Critical (shows only critical messages - least verbose)
 
+### AG Grid License Key
+
+Eliminate AG Grid Enterprise license warnings during local development by setting the license key in your `.env` file:
+
+```bash
+FUSION_SPA_AG_GRID_KEY=your-license-key-here
+```
+
+The dev-portal automatically picks this up and configures AG Grid - no additional setup required.
+
 ### Portal Proxy Configuration
 
 **When you need it**: You want to control how portal assets are loaded during development - either from the Fusion portal service or from locally installed portal packages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-cli",
-  "version": "13.0.1",
+  "version": "13.1.1",
   "keywords": [
     "Fusion",
     "Fusion Framework",
@@ -104,15 +104,16 @@
     "is-mergeable-object": "^1.1.1",
     "is-path-inside": "^4.0.0",
     "ora": "^9.0.0",
-    "read-package-up": "^11.0.0",
+    "read-package-up": "^12.0.0",
+    "semver": "^7.6.0",
     "simple-git": "^3.28.0",
     "vite": "^7.1.12",
-    "vite-tsconfig-paths": "^5.1.4",
+    "vite-tsconfig-paths": "^6.0.4",
     "zod": "^4.1.8",
-    "@equinor/fusion-framework-dev-portal": "1.3.0",
-    "@equinor/fusion-framework-module-msal-node": "2.0.2",
-    "@equinor/fusion-framework-dev-server": "1.1.18",
-    "@equinor/fusion-imports": "1.1.8"
+    "@equinor/fusion-framework-dev-portal": "1.4.0",
+    "@equinor/fusion-framework-dev-server": "1.1.20",
+    "@equinor/fusion-framework-module-msal-node": "2.0.3",
+    "@equinor/fusion-imports": "1.1.10"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.0",
@@ -121,13 +122,14 @@
     "@rollup/plugin-replace": "^6.0.2",
     "@types/adm-zip": "^0.5.0",
     "@types/normalize-package-data": "^2.4.4",
+    "@types/semver": "^7.5.8",
     "@vitest/coverage-v8": "^3.2.4",
     "adm-zip": "^0.5.10",
     "ajv": "^8.17.1",
     "chalk": "^5.6.0",
     "is-ci": "^4.1.0",
     "normalize-package-data": "^8.0.0",
-    "open": "^10.1.1",
+    "open": "^11.0.0",
     "pretty-bytes": "^7.0.0",
     "rollup": "^4.50.2",
     "rollup-plugin-terser": "^7.0.2",
@@ -135,14 +137,14 @@
     "type-fest": "^5.0.0",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
-    "@equinor/fusion-framework-cli-plugin-ai-mcp": "1.0.1",
-    "@equinor/fusion-framework-cli-plugin-ai-search": "1.0.1",
-    "@equinor/fusion-framework-cli-plugin-ai-chat": "1.0.1",
-    "@equinor/fusion-framework-cli-plugin-ai-index": "1.0.1",
+    "@equinor/fusion-framework-cli-plugin-ai-chat": "1.0.3",
+    "@equinor/fusion-framework-cli-plugin-ai-mcp": "1.0.3",
+    "@equinor/fusion-framework-cli-plugin-ai-search": "1.0.3",
+    "@equinor/fusion-framework-cli-plugin-ai-index": "1.0.3",
     "@equinor/fusion-framework-module": "5.0.5",
-    "@equinor/fusion-framework-module-app": "7.2.1",
-    "@equinor/fusion-framework-module-http": "7.0.5",
-    "@equinor/fusion-framework-module-service-discovery": "9.0.4"
+    "@equinor/fusion-framework-module-app": "7.2.2",
+    "@equinor/fusion-framework-module-http": "7.0.6",
+    "@equinor/fusion-framework-module-service-discovery": "9.0.5"
   },
   "peerDependenciesMeta": {
     "typescript": {