@nx/docker 22.0.0 → 22.1.0-beta.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nx/docker",
   "description": "The Nx Plugin for Docker to aid in containerizing projects.",
-  "version": "22.0.0",
+  "version": "22.1.0-beta.0",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"
@@ -47,12 +47,12 @@
   "executors": "./executors.json",
   "generators": "./generators.json",
   "dependencies": {
-    "@nx/devkit": "22.0.0",
+    "@nx/devkit": "22.1.0-beta.0",
     "enquirer": "~2.3.6",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "nx": "22.0.0"
+    "nx": "22.1.0-beta.0"
   },
   "types": "./src/index.d.ts"
 }

package/src/plugins/plugin.d.ts

@@ -1,7 +1,15 @@
 import { type CreateNodesV2 } from '@nx/devkit';
+export interface DockerTargetOptions {
+    name: string;
+    args?: string[];
+    env?: Record<string, string>;
+    envFile?: string;
+    cwd?: string;
+    configurations?: Record<string, Omit<DockerTargetOptions, 'configurations' | 'name'>>;
+}
 export interface DockerPluginOptions {
-    buildTarget?: string;
-    runTarget?: string;
+    buildTarget?: string | DockerTargetOptions;
+    runTarget?: string | DockerTargetOptions;
 }
 export declare const createNodesV2: CreateNodesV2<DockerPluginOptions>;
 //# sourceMappingURL=plugin.d.ts.map

package/src/plugins/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/plugins/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAmC5D,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/plugins/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CACrB,MAAM,EACN,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,MAAM,CAAC,CACrD,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC1C;AAsBD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAmC5D,CAAC"}

package/src/plugins/plugin.js

@@ -8,6 +8,8 @@ const cache_directory_1 = require("nx/src/utils/cache-directory");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const get_named_inputs_1 = require("@nx/devkit/src/utils/get-named-inputs");
+const git_utils_1 = require("nx/src/utils/git-utils");
+const interpolate_pattern_1 = require("../utils/interpolate-pattern");
 function readTargetsCache(cachePath) {
     return (0, fs_1.existsSync)(cachePath) ? (0, devkit_1.readJsonFile)(cachePath) : {};
 }
@@ -47,26 +49,91 @@ async function createNodesInternal(configFilePath, hash, normalizedOptions, cont
         },
     };
 }
+function interpolateDockerTargetOptions(options, projectRoot, imageRef, context) {
+    const commitSha = (0, git_utils_1.getLatestCommitSha)();
+    const projectName = getProjectName(projectRoot, context.workspaceRoot);
+    const tokens = {
+        projectRoot,
+        projectName,
+        imageRef,
+        currentDate: new Date(),
+        commitSha,
+        shortCommitSha: commitSha.slice(0, 7),
+    };
+    return (0, interpolate_pattern_1.interpolateObject)(options, tokens);
+}
+function getProjectName(projectRoot, workspaceRoot) {
+    const projectJsonPath = (0, path_1.join)(workspaceRoot, projectRoot, 'project.json');
+    if ((0, fs_1.existsSync)(projectJsonPath)) {
+        const projectJson = (0, devkit_1.readJsonFile)(projectJsonPath);
+        if (projectJson.name) {
+            return projectJson.name;
+        }
+    }
+    const packageJsonPath = (0, path_1.join)(workspaceRoot, projectRoot, 'package.json');
+    if ((0, fs_1.existsSync)(packageJsonPath)) {
+        const packageJson = (0, devkit_1.readJsonFile)(packageJsonPath);
+        if (packageJson.name) {
+            return packageJson.name;
+        }
+    }
+    return projectRoot.replace(/^[\\/]/, '').replace(/[\\/\s]+/g, '-');
+}
+function buildTargetOptions(interpolatedTarget, projectRoot, imageRef, isRunTarget = false) {
+    const options = {
+        cwd: interpolatedTarget.cwd ?? projectRoot,
+    };
+    if (isRunTarget) {
+        // Run target doesn't have default args
+        if (interpolatedTarget.args) {
+            options.args = interpolatedTarget.args;
+        }
+    }
+    else {
+        // Build target always includes --tag default
+        options.args = [`--tag ${imageRef}`, ...(interpolatedTarget.args ?? [])];
+    }
+    if (interpolatedTarget.env) {
+        options.env = interpolatedTarget.env;
+    }
+    if (interpolatedTarget.envFile) {
+        options.envFile = interpolatedTarget.envFile;
+    }
+    return options;
+}
+function buildTargetConfigurations(interpolatedTarget, projectRoot, imageRef, isRunTarget = false) {
+    if (!interpolatedTarget.configurations) {
+        return undefined;
+    }
+    const configurations = {};
+    for (const [configName, configOptions] of Object.entries(interpolatedTarget.configurations)) {
+        // Each configuration gets the full treatment with defaults
+        configurations[configName] = buildTargetOptions({ ...configOptions, name: interpolatedTarget.name }, projectRoot, imageRef, isRunTarget);
+    }
+    return configurations;
+}
 async function createDockerTargets(projectRoot, options, context) {
     const imageRef = projectRoot.replace(/^[\\/]/, '').replace(/[\\/\s]+/g, '-');
+    const interpolatedBuildTarget = interpolateDockerTargetOptions(options.buildTarget, projectRoot, imageRef, context);
+    const interpolatedRunTarget = interpolateDockerTargetOptions(options.runTarget, projectRoot, imageRef, context);
     const namedInputs = (0, get_named_inputs_1.getNamedInputs)(projectRoot, context);
     const targets = {};
     const metadata = {
         targetGroups: {
             ['Docker']: [
-                `${options.buildTarget}`,
-                `${options.runTarget}`,
+                interpolatedBuildTarget.name,
+                interpolatedRunTarget.name,
                 'nx-release-publish',
             ],
         },
     };
-    targets[options.buildTarget] = {
+    const buildOptions = buildTargetOptions(interpolatedBuildTarget, projectRoot, imageRef, false);
+    const buildConfigurations = buildTargetConfigurations(interpolatedBuildTarget, projectRoot, imageRef, false);
+    targets[interpolatedBuildTarget.name] = {
         dependsOn: ['build', '^build'],
         command: `docker build .`,
-        options: {
-            cwd: projectRoot,
-            args: [`--tag ${imageRef}`],
-        },
+        options: buildOptions,
+        ...(buildConfigurations && { configurations: buildConfigurations }),
         inputs: [
             ...('production' in namedInputs
                 ? ['production', '^production']
@@ -86,12 +153,13 @@ async function createDockerTargets(projectRoot, options, context) {
             },
         },
     };
-    targets[options.runTarget] = {
-        dependsOn: [options.buildTarget],
+    const runOptions = buildTargetOptions(interpolatedRunTarget, projectRoot, imageRef, true);
+    const runConfigurations = buildTargetConfigurations(interpolatedRunTarget, projectRoot, imageRef, true);
+    targets[interpolatedRunTarget.name] = {
+        dependsOn: [interpolatedBuildTarget.name],
         command: `docker run {args} ${imageRef}`,
-        options: {
-            cwd: projectRoot,
-        },
+        options: runOptions,
+        ...(runConfigurations && { configurations: runConfigurations }),
         inputs: [
             ...('production' in namedInputs
                 ? ['production', '^production']
@@ -116,8 +184,17 @@ async function createDockerTargets(projectRoot, options, context) {
     return { targets, metadata };
 }
 function normalizePluginOptions(options) {
+    const normalizeTarget = (target, defaultName) => {
+        if (typeof target === 'string') {
+            return { name: target };
+        }
+        if (target && typeof target === 'object') {
+            return { ...target, name: target.name ?? defaultName };
+        }
+        return { name: defaultName };
+    };
     return {
-        buildTarget: options.buildTarget ?? 'docker:build',
-        runTarget: options.runTarget ?? 'docker:run',
+        buildTarget: normalizeTarget(options.buildTarget, 'docker:build'),
+        runTarget: normalizeTarget(options.runTarget, 'docker:run'),
     };
 }

package/src/release/version-pattern-utils.d.ts

@@ -6,12 +6,14 @@
  * {commitSha} - The full commit sha for the current commit
  * {shortCommitSha} - The seven character commit sha for the current commit
  * {env.VAR_NAME} - The value of the environment variable VAR_NAME
+ * {versionActionsVersion} - The version generated during the version actions such as "1.2.3"
  */
 export interface PatternTokens {
     projectName: string;
     currentDate: Date;
     commitSha: string;
     shortCommitSha: string;
+    versionActionsVersion: string;
 }
 export declare function interpolateVersionPattern(versionPattern: string, data: Partial<PatternTokens>): string;
 //# sourceMappingURL=version-pattern-utils.d.ts.map

package/src/release/version-pattern-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-pattern-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/release/version-pattern-utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAsBD,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,UAsC7B"}
+{"version":3,"file":"version-pattern-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/release/version-pattern-utils.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,UAY7B"}

package/src/release/version-pattern-utils.js

@@ -2,23 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.interpolateVersionPattern = interpolateVersionPattern;
 const git_utils_1 = require("nx/src/utils/git-utils");
-const tokenRegex = /\{(env\.([^}]+)|([^|{}]+)(?:\|([^{}]+))?)\}/g;
-function formatDate(date, format) {
-    const year = String(date.getUTCFullYear());
-    const month = String(date.getUTCMonth() + 1).padStart(2, '0');
-    const day = String(date.getUTCDate()).padStart(2, '0');
-    const hours = String(date.getUTCHours()).padStart(2, '0');
-    const minutes = String(date.getUTCMinutes()).padStart(2, '0');
-    const seconds = String(date.getUTCSeconds()).padStart(2, '0');
-    return format
-        .replace(/YYYY/g, year)
-        .replace(/YY/g, year.slice(-2))
-        .replace(/MM/g, month)
-        .replace(/DD/g, day)
-        .replace(/HH/g, hours)
-        .replace(/mm/g, minutes)
-        .replace(/ss/g, seconds);
-}
+const interpolate_pattern_1 = require("../utils/interpolate-pattern");
 function interpolateVersionPattern(versionPattern, data) {
     const commitSha = (0, git_utils_1.getLatestCommitSha)();
     const substitutions = {
@@ -26,27 +10,7 @@ function interpolateVersionPattern(versionPattern, data) {
         currentDate: data.currentDate ?? new Date(),
         commitSha: data.commitSha ?? commitSha,
         shortCommitSha: data.shortCommitSha ?? commitSha.slice(0, 7),
+        versionActionsVersion: data.versionActionsVersion ?? '',
     };
-    return versionPattern.replace(tokenRegex, (match, fullMatch, envVarName, identifier, format) => {
-        // Handle environment variables
-        if (envVarName) {
-            const envValue = process.env[envVarName];
-            return envValue !== undefined ? envValue : match;
-        }
-        // Handle other tokens
-        const value = substitutions[identifier];
-        if (value === undefined) {
-            return match; // Keep original token if no data
-        }
-        // Handle date formatting
-        if (identifier === 'currentDate') {
-            if (format) {
-                return formatDate(value, format);
-            }
-            else {
-                return value.toISOString();
-            }
-        }
-        return value;
-    });
+    return (0, interpolate_pattern_1.interpolatePattern)(versionPattern, substitutions);
 }

package/src/release/version-utils.d.ts

@@ -1,7 +1,7 @@
 import type { ProjectGraphProjectNode } from '@nx/devkit';
 import type { FinalConfigForProject } from 'nx/src/command-line/release/utils/release-graph';
 export declare const getDockerVersionPath: (workspaceRoot: string, projectRoot: string) => string;
-export declare function handleDockerVersion(workspaceRoot: string, projectGraphNode: ProjectGraphProjectNode, finalConfigForProject: FinalConfigForProject, dockerVersionScheme?: string, dockerVersion?: string): Promise<{
+export declare function handleDockerVersion(workspaceRoot: string, projectGraphNode: ProjectGraphProjectNode, finalConfigForProject: FinalConfigForProject, dockerVersionScheme?: string, dockerVersion?: string, versionActionsVersion?: string): Promise<{
     newVersion: string;
     logs: string[];
 }>;

package/src/release/version-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/release/version-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAQ7F,eAAO,MAAM,oBAAoB,GAC/B,eAAe,MAAM,EACrB,aAAa,MAAM,WAGpB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,uBAAuB,EACzC,qBAAqB,EAAE,qBAAqB,EAC5C,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM;;;GA4CvB"}
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/release/version-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAQ7F,eAAO,MAAM,oBAAoB,GAC/B,eAAe,MAAM,EACrB,aAAa,MAAM,WAGpB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,uBAAuB,EACzC,qBAAqB,EAAE,qBAAqB,EAC5C,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,EACtB,qBAAqB,CAAC,EAAE,MAAM;;;GA6C/B"}

package/src/release/version-utils.js

@@ -15,7 +15,7 @@ const getDockerVersionPath = (workspaceRoot, projectRoot) => {
     return (0, path_1.join)(workspaceRoot, 'tmp', projectRoot, '.docker-version');
 };
 exports.getDockerVersionPath = getDockerVersionPath;
-async function handleDockerVersion(workspaceRoot, projectGraphNode, finalConfigForProject, dockerVersionScheme, dockerVersion) {
+async function handleDockerVersion(workspaceRoot, projectGraphNode, finalConfigForProject, dockerVersionScheme, dockerVersion, versionActionsVersion) {
     // If the full docker image reference is provided, use it directly
     const nxDockerImageRefEnvOverride = process.env.NX_DOCKER_IMAGE_REF?.trim() || undefined;
     // If an explicit dockerVersion is provided, use it directly
@@ -30,7 +30,7 @@ async function handleDockerVersion(workspaceRoot, projectGraphNode, finalConfigF
             const versionScheme = dockerVersionScheme && dockerVersionScheme in availableVersionSchemes
                 ? dockerVersionScheme
                 : await promptForNewVersion(availableVersionSchemes, projectGraphNode.name);
-            newVersion = calculateNewVersion(projectGraphNode.name, versionScheme, availableVersionSchemes);
+            newVersion = calculateNewVersion(projectGraphNode.name, versionScheme, availableVersionSchemes, versionActionsVersion);
         }
     }
     const logs = updateProjectVersion(newVersion, nxDockerImageRefEnvOverride, workspaceRoot, projectGraphNode.data.root, finalConfigForProject.dockerOptions.repositoryName, finalConfigForProject.dockerOptions.registryUrl);
@@ -53,12 +53,13 @@ async function promptForNewVersion(versionSchemes, projectName) {
     });
     return versionScheme;
 }
-function calculateNewVersion(projectName, versionScheme, versionSchemes) {
+function calculateNewVersion(projectName, versionScheme, versionSchemes, versionActionsVersion) {
     if (!(versionScheme in versionSchemes)) {
         throw new Error(`Could not find version scheme '${versionScheme}'. Available options are: ${Object.keys(versionSchemes).join(', ')}.`);
     }
     return (0, version_pattern_utils_1.interpolateVersionPattern)(versionSchemes[versionScheme], {
         projectName,
+        versionActionsVersion,
     });
 }
 function updateProjectVersion(newVersion, nxDockerImageRefEnvOverride, workspaceRoot, projectRoot, repositoryName, registry) {

package/src/utils/interpolate-pattern.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Interpolates pattern tokens in a string.
+ *
+ * Supported tokens:
+ * - {tokenName} - Simple token replacement
+ * - {currentDate} - Current date in ISO format
+ * - {currentDate|FORMAT} - Current date with custom format (YYYY, YY, MM, DD, HH, mm, ss)
+ * - {env.VAR_NAME} - Environment variable value
+ *
+ * @param pattern - String containing tokens to interpolate
+ * @param tokens - Record of token values
+ * @returns Interpolated string
+ */
+export declare function interpolatePattern(pattern: string, tokens: Record<string, any>): string;
+/**
+ * Recursively interpolates pattern tokens in all string values within an object or array.
+ *
+ * @param obj - Object or array to process
+ * @param tokens - Record of token values
+ * @returns New object/array with interpolated values
+ */
+export declare function interpolateObject<T>(obj: T, tokens: Record<string, any>): T;
+//# sourceMappingURL=interpolate-pattern.d.ts.map

package/src/utils/interpolate-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate-pattern.d.ts","sourceRoot":"","sources":["../../../../../packages/docker/src/utils/interpolate-pattern.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CA6BR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAkB3E"}

package/src/utils/interpolate-pattern.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interpolatePattern = interpolatePattern;
+exports.interpolateObject = interpolateObject;
+const tokenRegex = /\{(env\.([^}]+)|([^|{}]+)(?:\|([^{}]+))?)\}/g;
+function formatDate(date, format) {
+    const year = String(date.getUTCFullYear());
+    const month = String(date.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(date.getUTCDate()).padStart(2, '0');
+    const hours = String(date.getUTCHours()).padStart(2, '0');
+    const minutes = String(date.getUTCMinutes()).padStart(2, '0');
+    const seconds = String(date.getUTCSeconds()).padStart(2, '0');
+    return format
+        .replace(/YYYY/g, year)
+        .replace(/YY/g, year.slice(-2))
+        .replace(/MM/g, month)
+        .replace(/DD/g, day)
+        .replace(/HH/g, hours)
+        .replace(/mm/g, minutes)
+        .replace(/ss/g, seconds);
+}
+/**
+ * Interpolates pattern tokens in a string.
+ *
+ * Supported tokens:
+ * - {tokenName} - Simple token replacement
+ * - {currentDate} - Current date in ISO format
+ * - {currentDate|FORMAT} - Current date with custom format (YYYY, YY, MM, DD, HH, mm, ss)
+ * - {env.VAR_NAME} - Environment variable value
+ *
+ * @param pattern - String containing tokens to interpolate
+ * @param tokens - Record of token values
+ * @returns Interpolated string
+ */
+function interpolatePattern(pattern, tokens) {
+    return pattern.replace(tokenRegex, (match, fullMatch, envVarName, identifier, format) => {
+        // Handle environment variables
+        if (envVarName) {
+            const envValue = process.env[envVarName];
+            return envValue !== undefined ? envValue : match;
+        }
+        // Handle other tokens
+        const value = tokens[identifier];
+        if (value === undefined) {
+            return match; // Keep original token if no data
+        }
+        // Handle date formatting
+        if (identifier === 'currentDate') {
+            if (format) {
+                return formatDate(value, format);
+            }
+            else {
+                return value.toISOString();
+            }
+        }
+        return value;
+    });
+}
+/**
+ * Recursively interpolates pattern tokens in all string values within an object or array.
+ *
+ * @param obj - Object or array to process
+ * @param tokens - Record of token values
+ * @returns New object/array with interpolated values
+ */
+function interpolateObject(obj, tokens) {
+    if (typeof obj === 'string') {
+        return interpolatePattern(obj, tokens);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => interpolateObject(item, tokens));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = interpolateObject(value, tokens);
+        }
+        return result;
+    }
+    return obj;
+}