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

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

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

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

package/dist/esm/lib/static.js

@@ -0,0 +1,20 @@
+/**
+ * A constant array of supported asset file extensions categorized by type.
+ *
+ * The extensions are grouped as follows:
+ * - **Images**: `png`, `jpg`, `jpeg`, `gif`, `svg`, `ico`, `webp`
+ * - **Videos and audio**: `mp4`, `webm`, `mp3`
+ * - **Fonts**: `woff2`, `woff`, `eot`, `ttf`, `otf`
+ * - **Documents**: `pdf`, `md`, `txt`
+ */
+export const ASSET_EXTENSIONS = [
+    // Images
+    ...['png', 'jpg', 'jpeg', 'gif', 'svg', 'ico', 'webp'],
+    // Videos and audio
+    ...['mp4', 'webm', 'mp3'],
+    // Fonts
+    ...['woff2', 'woff', 'eot', 'ttf', 'otf'],
+    // Documents
+    ...['pdf', 'md', 'txt'],
+];
+//# sourceMappingURL=static.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../src/lib/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;IACtD,mBAAmB;IACnB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;IACzB,QAAQ;IACR,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACzC,YAAY;IACZ,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;CACf,CAAC"}

package/dist/{lib/utils → esm/lib}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/utils/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,87 @@
+import assert, { AssertionError } from 'node:assert';
+import { fileExists } from './file-exists.js';
+/**
+ * Re-exports the core Node.js assert function and AssertionError class.
+ * Useful for consistent assertion handling throughout the codebase.
+ */
+export { assert, AssertionError };
+/**
+ * Asserts that the provided value is a valid number (not NaN).
+ * Throws an AssertionError if the value is not a number.
+ *
+ * @param value - The value to check for being a number.
+ * @param message - Optional custom error message for assertion failure.
+ * @throws {AssertionError} If value is NaN.
+ */
+export function assertNumber(value, message) {
+    // Ensure the value is not NaN; this does not check for type 'number'.
+    assert(!Number.isNaN(value), new AssertionError({
+        message,
+        actual: value,
+        expected: '<number>',
+    }));
+}
+/**
+ * Asserts that a file exists at the given path.
+ * Throws an error if the file does not exist.
+ *
+ * @param value - The file path to check.
+ * @param message - Optional custom error message for assertion failure.
+ * @throws {AssertionError} If the file does not exist.
+ */
+export const assertFileExists = (value, message) => {
+    // Use fileExists utility to check for file presence.
+    assert(fileExists(value), message ?? `file ${String(value)} does not exist`);
+};
+/**
+ * Asserts that the provided value is an object.
+ * Throws an error if the value is not an object.
+ *
+ * @param value - The value to check for being an object.
+ * @param message - Optional custom error message or Error instance.
+ * @throws {AssertionError} If value is not an object.
+ */
+export function assertObject(value, message) {
+    // typeof null is 'object', so this does not exclude null values.
+    assert(typeof value === 'object', message);
+}
+/**
+ * Asserts that a specific property exists and has a value on an object.
+ * Used internally for property value checks.
+ *
+ * @param value - The value of the property to check.
+ * @param prop - The property key being checked.
+ * @param message - Optional custom error message.
+ * @throws {AssertionError} If the property value is falsy.
+ */
+function assertObjectEntryValue(value, prop, message) {
+    // Checks for truthy value; falsy values (0, '', false) will fail.
+    assert(!!value, message ?? `missing value of property ${prop}`);
+}
+/**
+ * Asserts that an object contains the specified properties and that each property has a value.
+ * Allows for custom assertion logic and pre-message prefixing.
+ *
+ * @typeParam T - The object type to check.
+ * @typeParam P - The array of property keys to check on the object.
+ * @param value - The object to check.
+ * @param options - Optional settings for property keys, assertion function, and message prefix.
+ * @throws {AssertionError} If any property is missing or fails the assertion.
+ */
+export function assertObjectEntries(value, options) {
+    // Use preMessage to prefix all assertion messages for context.
+    const preMessage = options?.preMessage ?? '';
+    // Ensure the value is an object before checking properties.
+    assert(typeof value === 'object', `${preMessage} to be an <object>`);
+    // Use custom assertion if provided, otherwise default.
+    const assertion = options?.assertion ?? assertObjectEntryValue;
+    // Use provided property list or all keys of the object.
+    const props = options?.props ?? Object.keys(value);
+    for (const prop of props) {
+        // Check that the property exists on the object.
+        assert(prop in value, `${preMessage} to have property [${String(prop)}]`);
+        // Check that the property value passes the assertion.
+        assertion(value[prop], prop, `${preMessage} property [${String(prop)}] to have value`);
+    }
+}
+//# sourceMappingURL=assert.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../../src/lib/utils/assert.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,OAAgB;IAC3D,sEAAsE;IACtE,MAAM,CACJ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EACpB,IAAI,cAAc,CAAC;QACjB,OAAO;QACP,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,UAAU;KACrB,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,OAAgB,EAAiB,EAAE;IAClF,qDAAqD;IACrD,MAAM,CAAC,UAAU,CAAC,KAAe,CAAC,EAAE,OAAO,IAAI,QAAQ,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAwB;IAClE,iEAAiE;IACjE,MAAM,CAAC,OAAO,KAAK,KAAK,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sBAAsB,CAAI,KAAc,EAAE,IAAO,EAAE,OAAgB;IAC1E,kEAAkE;IAClE,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,6BAA6B,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAQ,EACR,OAIC;IAED,+DAA+D;IAC/D,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;IAC7C,4DAA4D;IAC5D,MAAM,CAAC,OAAO,KAAK,KAAK,QAAQ,EAAE,GAAG,UAAU,oBAAoB,CAAC,CAAC;IACrE,uDAAuD;IACvD,MAAM,SAAS,GAAqC,OAAO,EAAE,SAAS,IAAI,sBAAsB,CAAC;IACjG,wDAAwD;IACxD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,gDAAgD;QAChD,MAAM,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,UAAU,sBAAsB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,sDAAsD;QACtD,SAAS,CACP,KAAK,CAAC,IAAe,CAAC,EACtB,IAAoB,EACpB,GAAG,UAAU,cAAc,MAAM,CAAC,IAAI,CAAC,iBAAiB,CACzD,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../../../src/lib/utils/expect.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,KAAQ,EAAE,EAAE;IACpC,OAAO;QACL,IAAI,EAAE,CAAC,QAAW,EAAE,OAAe,EAAoB,EAAE;YACvD,MAAM,CACJ,KAAK,KAAK,QAAQ,EAClB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM,EAAE,KAAK;oBACb,KAAK;iBACN;aACF,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,cAAc,EAAE,CAAC,QAAsB,EAAE,OAAe,EAAoB,EAAE;YAC5E,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC;YAC5B,MAAM,CACJ,MAAM,KAAK,QAAQ,EACnB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM;oBACN,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;iBACjD;aACF,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/{lib/plugins/app-assets/extension-filter-pattern.js → esm/lib/utils/extension-filter.js}

@@ -17,4 +17,4 @@ const trimLeadingDot = (ext) => ext.replace(/^\./, '');
  */
 export const createExtensionFilterPattern = (exts) => new RegExp(`\\.(${exts.map(trimLeadingDot).join('|')})(\\?.*)?$`);
 export default createExtensionFilterPattern;
-//# sourceMappingURL=extension-filter-pattern.js.map
+//# sourceMappingURL=extension-filter.js.map

package/dist/esm/lib/utils/extension-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-filter.js","sourceRoot":"","sources":["../../../../src/lib/utils/extension-filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,IAAc,EAAE,EAAE,CAC7D,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAEpE,eAAe,4BAA4B,CAAC"}

package/dist/esm/lib/utils/file-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-exists.js","sourceRoot":"","sources":["../../../../src/lib/utils/file-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,OAAiB,EAAE,EAAE;IAChE,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,OAAiB,EAAoB,EAAE;IACpF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+export { resolveEntryPoint } from './resolve-source-entry-point.js';
+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';
+//# sourceMappingURL=index.js.map

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

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

package/dist/{lib → esm/lib}/utils/parse-json-request.js

@@ -8,7 +8,9 @@
 export async function parseJsonFromRequest(req) {
     return await new Promise((resolve, reject) => {
         let data = '';
-        req.on('data', (chunk) => (data += chunk.toString()));
+        req.on('data', (chunk) => {
+            data += chunk.toString();
+        });
         req.on('end', () => resolve(JSON.parse(data)));
         req.on('error', reject);
     });

package/dist/esm/lib/utils/parse-json-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json-request.js","sourceRoot":"","sources":["../../../../src/lib/utils/parse-json-request.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAoB;IAC7D,OAAO,MAAM,IAAI,OAAO,CAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpE,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,eAAe,oBAAoB,CAAC"}

package/dist/esm/lib/utils/resolve-annotations.js

@@ -0,0 +1,28 @@
+import resolveGithubAnnotations from './resolve-github-annotations.js';
+import resolveDevopsAnnotations from './resolve-devops-annotations.js';
+/**
+ * Resolves CI/CD environment-specific annotation variables.
+ *
+ * This function determines the current CI/CD runtime environment (GitHub Actions, Azure DevOps, or other)
+ * and returns a set of annotation variables relevant to that environment. These annotations are typically
+ * used for reporting build, test, or deployment results in a way that is compatible with the CI/CD provider's UI.
+ *
+ * @returns {Record<string, string>} An object containing annotation variables for the detected environment.
+ * If no known environment is detected, returns an empty object.
+ */
+export const resolveAnnotations = () => {
+    // Check if running in GitHub Actions environment
+    // If so, delegate to the GitHub-specific annotation resolver
+    if (process.env.GITHUB_ACTIONS) {
+        return resolveGithubAnnotations();
+    }
+    // Check if running in Azure DevOps environment
+    // If so, delegate to the Azure DevOps-specific annotation resolver
+    if (process.env.SYSTEM_TEAMPROJECT) {
+        return resolveDevopsAnnotations();
+    }
+    // Fallback: No known CI/CD environment detected
+    // Return an empty object to indicate no annotations are available
+    return {};
+};
+//# sourceMappingURL=resolve-annotations.js.map

package/dist/esm/lib/utils/resolve-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-annotations.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-annotations.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,MAAM,iCAAiC,CAAC;AACvE,OAAO,wBAAwB,MAAM,iCAAiC,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAA2B,EAAE;IAC7D,iDAAiD;IACjD,6DAA6D;IAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,wBAAwB,EAAE,CAAC;IACpC,CAAC;IACD,+CAA+C;IAC/C,mEAAmE;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,OAAO,wBAAwB,EAAE,CAAC;IACpC,CAAC;IACD,gDAAgD;IAChD,kEAAkE;IAClE,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC"}

package/dist/esm/lib/utils/resolve-devops-annotations.js

@@ -0,0 +1,59 @@
+/**
+ * Resolves Azure DevOps-specific annotation variables from environment variables.
+ *
+ * This function extracts relevant build and repository information from Azure DevOps environment variables.
+ * It constructs a set of annotation variables that can be used for reporting or logging purposes in CI/CD pipelines.
+ *
+ * @returns {Record<string, string>} An object containing Azure DevOps annotation variables such as runId, repository,
+ * project, orgUrl, actor, branch, commitId, and runUrl. If a variable is not found, its value defaults to 'unknown'.
+ *
+ * Environment variables used by this function (see: https://learn.microsoft.com/en-us/azure/devops/pipelines/build/variables?view=azure-pipelines&tabs=yaml):
+ *   - BUILD_BUILDID: Unique build/run identifier
+ *   - BUILD_REPOSITORY_NAME: Repository name
+ *   - SYSTEM_TEAMPROJECT: Project name
+ *   - SYSTEM_COLLECTIONURI: Organization URL
+ *   - BUILD_REQUESTEDFOR: User who requested the build
+ *   - BUILD_SOURCEBRANCH: Source branch name
+ *   - BUILD_SOURCEVERSION: Commit SHA
+ *
+ * Notes for maintainers:
+ *   - If any environment variable is missing, its value defaults to 'unknown'.
+ *   - The runUrl is constructed only if orgUrl, project, and runId are available; otherwise, it is set to 'unknown'.
+ *   - If you need additional Azure DevOps context, refer to the official documentation and add new variables here.
+ *   - Some variables may contain sensitive information. Use caution when logging or exposing these values.
+ *
+ * Extending this function:
+ *   - To add more annotations, extract additional environment variables as needed and include them in the returned object.
+ *   - For custom pipelines or self-hosted agents, verify that all required environment variables are available.
+ */
+export const resolveAnnotations = () => {
+    // Extract Azure DevOps build and repository information from environment variables
+    const runId = process.env.BUILD_BUILDID || 'unknown'; // Unique build/run identifier
+    const repository = process.env.BUILD_REPOSITORY_NAME || 'unknown'; // Repository name
+    const project = process.env.SYSTEM_TEAMPROJECT || 'unknown'; // Project name
+    const orgUrl = process.env.SYSTEM_COLLECTIONURI || 'unknown'; // Organization URL
+    const actor = process.env.BUILD_REQUESTEDFOR || 'unknown'; // User who requested the build
+    const branch = process.env.BUILD_SOURCEBRANCH || 'unknown'; // Source branch name
+    const commitId = process.env.BUILD_SOURCEVERSION || 'unknown'; // Commit SHA
+    // Construct a direct URL to the build results if all required parts are available
+    let runUrl = 'unknown';
+    if (orgUrl !== 'unknown' && project !== 'unknown' && runId !== 'unknown') {
+        // Remove trailing slash from orgUrl if present, then build the run results URL
+        runUrl = `${orgUrl.replace(/\/$/, '')}${project}/_build/results?buildId=${runId}`;
+    }
+    // Aggregate all annotation variables into a single object for easy consumption
+    const annotations = {
+        runId,
+        repository,
+        project,
+        orgUrl,
+        actor,
+        branch,
+        commitId,
+        runUrl,
+    };
+    // Return the resolved annotation variables
+    return annotations;
+};
+export default resolveAnnotations;
+//# sourceMappingURL=resolve-devops-annotations.js.map

package/dist/esm/lib/utils/resolve-devops-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-devops-annotations.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-devops-annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAA2B,EAAE;IAC7D,mFAAmF;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC,CAAC,8BAA8B;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,SAAS,CAAC,CAAC,kBAAkB;IACrF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC,CAAC,eAAe;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,SAAS,CAAC,CAAC,mBAAmB;IACjF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC,CAAC,+BAA+B;IAC1F,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC,CAAC,qBAAqB;IACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC,CAAC,aAAa;IAE5E,kFAAkF;IAClF,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzE,+EAA+E;QAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,2BAA2B,KAAK,EAAE,CAAC;IACpF,CAAC;IAED,+EAA+E;IAC/E,MAAM,WAAW,GAA2B;QAC1C,KAAK;QACL,UAAU;QACV,OAAO;QACP,MAAM;QACN,KAAK;QACL,MAAM;QACN,QAAQ;QACR,MAAM;KACP,CAAC;IAEF,2CAA2C;IAC3C,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/esm/lib/utils/resolve-git-commit-sha.js

@@ -0,0 +1,23 @@
+import { execSync } from 'node:child_process';
+/**
+ * Resolves the Git commit SHA for a given reference.
+ *
+ * @param ref - The Git reference to resolve. Defaults to 'HEAD' if not provided.
+ * @returns The resolved Git commit SHA as a string, or `undefined` if the command fails.
+ *
+ * @remarks
+ * This function uses the `git rev-parse` command to determine the commit SHA.
+ * Ensure that the function is executed in a valid Git repository context.
+ *
+ * @throws Will throw an error if the `git` command fails or is not available.
+ */
+export const resolveGitCommitSha = (ref = 'HEAD') => {
+    try {
+        return execSync(`git rev-parse ${ref}`).toString().trim();
+    }
+    catch (error) {
+        // most likely due to not being in a git repository or invalid ref
+        return undefined; // Return undefined if the command fails or ref is not valid
+    }
+};
+//# sourceMappingURL=resolve-git-commit-sha.js.map

package/dist/esm/lib/utils/resolve-git-commit-sha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-git-commit-sha.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-git-commit-sha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,GAAG,MAAM,EAAsB,EAAE;IACtE,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kEAAkE;QAClE,OAAO,SAAS,CAAC,CAAC,4DAA4D;IAChF,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/lib/utils/resolve-git-remote-url.js

@@ -0,0 +1,24 @@
+import { execSync } from 'node:child_process';
+/**
+ * Resolves the URL of the Git remote named "origin" for the current repository.
+ *
+ * This function executes a shell command to retrieve the remote URL and converts
+ * SSH-style URLs (e.g., `git@github.com:user/repo.git`) to HTTPS-style URLs
+ * (e.g., `https://github.com/user/repo`). It also removes the `.git` suffix
+ * from the URL if present.
+ *
+ * @returns The resolved Git remote URL as a string, or `undefined` if the command
+ *          fails or the remote "origin" is not configured.
+ */
+export const resolveGitRemoteUrl = () => {
+    try {
+        const origin = execSync('git remote get-url origin').toString().trim();
+        return origin.replace('git@github.com:', 'https://github.com/').replace(/\.git$/, '');
+    }
+    catch (error) {
+        // most likely due to not being in a git repository or no remote named "origin"
+        return undefined; // Return undefined if the command fails or origin is not set
+    }
+};
+export default resolveGitRemoteUrl;
+//# sourceMappingURL=resolve-git-remote-url.js.map

package/dist/esm/lib/utils/resolve-git-remote-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-git-remote-url.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-git-remote-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAuB,EAAE;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+EAA+E;QAC/E,OAAO,SAAS,CAAC,CAAC,6DAA6D;IACjF,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}