@eclipse-che/che-devworkspace-generator 0.0.1-96cdbb4 → 0.0.1-99986b8

package/README.md

@@ -1,28 +1,56 @@
 ## DevWorkspace Generator
-The library is used by Devfile registry component to generate the DevWorkspace components and DevWorkspace templates.
+The library is used by Devfile registry component to generate the DevWorkspace components and DevWorkspace templates. It requires editor definitions from the 
+[che-plugin-registry](https://github.com/eclipse-che/che-plugin-registry/).
 
 ## How to use the library
-The library could be used as a standalone library.
+The library can be used as a standalone library.
 
 ```
 USAGE
     $ node lib/entrypoint.js [OPTIONS]
 
 OPTIONS
-      --devfile-path    path to the devfile.yaml file
-      --devfile-url     URL to the git repository that contains devfile.yaml 
-      --plugin-registry-url URL to the plugin registry that contains an editor's definition
-      --editor-entry    editor's ID 
-      --editor-path:    path to the editor's devfile.yaml file
-      --output-file path to the file where the generated content will be stored
-      --project.    describes project entry
+      --devfile-url:           URL to the git repository that contains devfile.yaml
+            or
+      --devfile-path:          path to the devfile.yaml file
 
-EXAMPLE
+      --plugin-registry-url:   URL to the plugin registry that contains editor definitions (devfile.yaml)
+      --editor-entry:          editor ID, found on the <plugin-registry-url>, to resolve the devfile.yaml
+            or
+      --editor-path:           local file path of the editor devfile.yaml
+
+      --output-file:           local file path for the generated devworkspace yaml 
+
+      --project.<project-name> local file path for the sample project zip (for airgapped/offline registry builds)
+
+      --injectDefaultComponent: inject a default dev container component if no component is defined in the devfile and it doesn't provide a parent, the value can be true or false, default is false
+
+      --defaultComponentImage: image to use for the default dev container component that will be injected if no componetn is defined in the devfile and it doesn't provide a parent devfile, default is quay.io/devfile/universal-developer-image:ubi8-latest
+
+EXAMPLES
+
+    # online example, using editor definition from https://che-plugin-registry-main.surge.sh/
+
+    $ node lib/entrypoint.js \
+        --devfile-url:https://github.com/che-samples/java-spring-petclinic/tree/main \
+        --plugin-registry-url:https://che-plugin-registry-main.surge.sh/v3/ \
+        --editor-entry:che-incubator/che-code/latest \
+        --output-file:/tmp/devworkspace-che-code-latest.yaml \
+        --injectDefaultComponent:true \
+        --defaultComponentImage:registry.access.redhat.com/ubi8/openjdk-11:latest
+
+    # offline example with devfile.yaml files and zipped project available locally
+
+    $ node lib/entrypoint.js \
+        --devfile-path:/remote-source/python-hello-world/app/devfile.yaml \
+        --editor-path:/build/plugins/che-incubator/che-code/latest/devfile.yaml \
+        --output-file:./devfiles/python__python-hello-world/devworkspace-che-code-latest.yaml \
+        --project.python-hello-world='{{_INTERNAL_URL_}}/resources/v2/python-hello-world.zip'
 
-    $ node lib/entrypoint.js --devfile-url:https://github.com/che-samples/java-spring-petclinic/tree/main --editor-entry:che-incubator/che-code/insiders --plugin-registry-url:https://che-plugin-registry-main.surge.sh/v3/ --output-file:/tmp/all-in-one.yaml`
 ```
 
-The file `/tmp/all-in-one.yaml` contains a DevWorkspace based on the repository devfile and a Che-Code DevWorkspaceTemplate.
-If DevWorkspace engine is available on the cluster, the following command will create a DevWorkspace:
+The output file `devworkspace-che-code-latest.yaml` contains a DevWorkspace based on the repository devfile and a Che-Code DevWorkspaceTemplate.
+
+If the DevWorkspace engine is installed on the cluster, the following command will create a DevWorkspace:
 
-`$ kubectl apply -f /tmp/all-in-one.yaml`
+`$ kubectl apply -f /tmp/devworkspace-che-code-latest.yaml`

package/lib/bitbucket/bitbucket-module.d.ts

@@ -0,0 +1,12 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { ContainerModule } from 'inversify';
+declare const bitbucketModule: ContainerModule;
+export { bitbucketModule };

package/lib/bitbucket/bitbucket-module.js

@@ -0,0 +1,21 @@
+"use strict";
+exports.__esModule = true;
+exports.bitbucketModule = void 0;
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+var inversify_1 = require("inversify");
+var bitbucket_resolver_1 = require("./bitbucket-resolver");
+var types_1 = require("../types");
+var Resolver = types_1.TYPES.Resolver;
+var bitbucketModule = new inversify_1.ContainerModule(function (bind) {
+    bind(Resolver).to(bitbucket_resolver_1.BitbucketResolver).inSingletonScope();
+});
+exports.bitbucketModule = bitbucketModule;
+//# sourceMappingURL=bitbucket-module.js.map

package/lib/bitbucket/bitbucket-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-module.js","sourceRoot":"","sources":["../../src/bitbucket/bitbucket-module.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;yEAQyE;AACzE,uCAAwD;AAExD,2DAAyD;AACzD,kCAAiC;AAEzB,IAAA,QAAQ,GAAK,aAAK,SAAV,CAAW;AAE3B,IAAM,eAAe,GAAG,IAAI,2BAAe,CAAC,UAAC,IAAqB;IAChE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,sCAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEM,0CAAe"}

package/lib/bitbucket/bitbucket-resolver.d.ts

@@ -0,0 +1,17 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { Url } from '../resolve/url';
+import { Resolver } from '../resolve/resolver';
+export declare class BitbucketResolver implements Resolver {
+    static readonly BITBUCKET_URL_PATTERN: RegExp;
+    isValid(url: string): boolean;
+    resolve(url: string): Url;
+    private getGroup;
+}

package/lib/bitbucket/bitbucket-resolver.js

@@ -0,0 +1,56 @@
+"use strict";
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+exports.__esModule = true;
+exports.BitbucketResolver = void 0;
+var bitbucket_url_1 = require("./bitbucket-url");
+var inversify_1 = require("inversify");
+var BitbucketResolver = /** @class */ (function () {
+    function BitbucketResolver() {
+    }
+    BitbucketResolver_1 = BitbucketResolver;
+    BitbucketResolver.prototype.isValid = function (url) {
+        return BitbucketResolver_1.BITBUCKET_URL_PATTERN.test(url);
+    };
+    BitbucketResolver.prototype.resolve = function (url) {
+        var match = BitbucketResolver_1.BITBUCKET_URL_PATTERN.exec(url);
+        if (!match) {
+            throw new Error("Invalid bitbucket URL: " + url);
+        }
+        var workspaceId = this.getGroup(match, 'workspaceId');
+        var repoName = this.getGroup(match, 'repoName');
+        if (/^[\w-][\w.-]*?\.git$/.test(repoName)) {
+            repoName = repoName.substring(0, repoName.length - 4);
+        }
+        var branchName = this.getGroup(match, 'branchName', 'HEAD');
+        return new bitbucket_url_1.BitbucketUrl(workspaceId, repoName, branchName);
+    };
+    BitbucketResolver.prototype.getGroup = function (match, groupName, defaultValue) {
+        if (match.groups && match.groups[groupName]) {
+            return match.groups[groupName];
+        }
+        return defaultValue;
+    };
+    var BitbucketResolver_1;
+    // eslint-disable-next-line max-len
+    BitbucketResolver.BITBUCKET_URL_PATTERN = /^https:\/\/.*@?bitbucket\.org\/(?<workspaceId>[^\/]+)\/(?<repoName>[^\/]+)(\/(src|branch)\/(?<branchName>[^\/]+))?\/?$/;
+    BitbucketResolver = BitbucketResolver_1 = __decorate([
+        (0, inversify_1.injectable)()
+    ], BitbucketResolver);
+    return BitbucketResolver;
+}());
+exports.BitbucketResolver = BitbucketResolver;
+//# sourceMappingURL=bitbucket-resolver.js.map

package/lib/bitbucket/bitbucket-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-resolver.js","sourceRoot":"","sources":["../../src/bitbucket/bitbucket-resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;;;;;;;AAEzE,iDAA+C;AAC/C,uCAAuC;AAKvC;IAAA;IA6BA,CAAC;0BA7BY,iBAAiB;IAK5B,mCAAO,GAAP,UAAQ,GAAW;QACjB,OAAO,mBAAiB,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,mCAAO,GAAP,UAAQ,GAAW;QACjB,IAAM,KAAK,GAAG,mBAAiB,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,4BAA0B,GAAK,CAAC,CAAC;SAClD;QACD,IAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACzC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;SACvD;QACD,IAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,4BAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAEO,oCAAQ,GAAhB,UAAiB,KAAsB,EAAE,SAAiB,EAAE,YAAqB;QAC/E,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAChC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;;IA3BD,mCAAmC;IACnB,uCAAqB,GACnC,wHAAyH,CAAA;IAHhH,iBAAiB;QAD7B,IAAA,sBAAU,GAAE;OACA,iBAAiB,CA6B7B;IAAD,wBAAC;CAAA,AA7BD,IA6BC;AA7BY,8CAAiB"}

package/lib/bitbucket/bitbucket-url.d.ts

@@ -0,0 +1,22 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { Url } from '../resolve/url';
+export declare class BitbucketUrl implements Url {
+    private readonly workspaceId;
+    private readonly repoName;
+    private readonly branchName;
+    private static readonly BITBUCKET_URL;
+    constructor(workspaceId: string, repoName: string, branchName: string);
+    getContentUrl(path: string): string;
+    getUrl(): string;
+    getCloneUrl(): string;
+    getRepoName(): string;
+    getBranchName(): string;
+}

package/lib/bitbucket/bitbucket-url.js

@@ -0,0 +1,38 @@
+"use strict";
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+exports.__esModule = true;
+exports.BitbucketUrl = void 0;
+var BitbucketUrl = /** @class */ (function () {
+    function BitbucketUrl(workspaceId, repoName, branchName) {
+        this.workspaceId = workspaceId;
+        this.repoName = repoName;
+        this.branchName = branchName;
+    }
+    BitbucketUrl.prototype.getContentUrl = function (path) {
+        return BitbucketUrl.BITBUCKET_URL + "/" + this.workspaceId + "/" + this.repoName + "/raw/" + this.branchName + "/" + path;
+    };
+    BitbucketUrl.prototype.getUrl = function () {
+        return BitbucketUrl.BITBUCKET_URL + "/" + this.workspaceId + "/" + this.repoName + "/src/" + this.branchName;
+    };
+    BitbucketUrl.prototype.getCloneUrl = function () {
+        return BitbucketUrl.BITBUCKET_URL + "/" + this.workspaceId + "/" + this.repoName + ".git";
+    };
+    BitbucketUrl.prototype.getRepoName = function () {
+        return this.repoName;
+    };
+    BitbucketUrl.prototype.getBranchName = function () {
+        return this.branchName;
+    };
+    BitbucketUrl.BITBUCKET_URL = 'https://bitbucket.org';
+    return BitbucketUrl;
+}());
+exports.BitbucketUrl = BitbucketUrl;
+//# sourceMappingURL=bitbucket-url.js.map

package/lib/bitbucket/bitbucket-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-url.js","sourceRoot":"","sources":["../../src/bitbucket/bitbucket-url.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;AAIzE;IAGE,sBACmB,WAAmB,EACnB,QAAgB,EAChB,UAAkB;QAFlB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ,oCAAa,GAAb,UAAc,IAAY;QACxB,OAAU,YAAY,CAAC,aAAa,SAAI,IAAI,CAAC,WAAW,SAAI,IAAI,CAAC,QAAQ,aAAQ,IAAI,CAAC,UAAU,SAAI,IAAM,CAAC;IAC7G,CAAC;IAED,6BAAM,GAAN;QACE,OAAU,YAAY,CAAC,aAAa,SAAI,IAAI,CAAC,WAAW,SAAI,IAAI,CAAC,QAAQ,aAAQ,IAAI,CAAC,UAAY,CAAC;IACrG,CAAC;IAED,kCAAW,GAAX;QACE,OAAU,YAAY,CAAC,aAAa,SAAI,IAAI,CAAC,WAAW,SAAI,IAAI,CAAC,QAAQ,SAAM,CAAC;IAClF,CAAC;IAED,kCAAW,GAAX;QACE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,oCAAa,GAAb;QACE,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IA1BuB,0BAAa,GAAG,uBAAuB,CAAC;IA2BlE,mBAAC;CAAA,AA5BD,IA4BC;AA5BY,oCAAY"}

package/lib/bitbucket-server/bitbucket-server-module.d.ts

@@ -0,0 +1,12 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { ContainerModule } from 'inversify';
+declare const bitbucketServerModule: ContainerModule;
+export { bitbucketServerModule };

package/lib/bitbucket-server/bitbucket-server-module.js

@@ -0,0 +1,21 @@
+"use strict";
+exports.__esModule = true;
+exports.bitbucketServerModule = void 0;
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+var inversify_1 = require("inversify");
+var bitbucket_server_resolver_1 = require("./bitbucket-server-resolver");
+var types_1 = require("../types");
+var Resolver = types_1.TYPES.Resolver;
+var bitbucketServerModule = new inversify_1.ContainerModule(function (bind) {
+    bind(Resolver).to(bitbucket_server_resolver_1.BitbucketServerResolver).inSingletonScope();
+});
+exports.bitbucketServerModule = bitbucketServerModule;
+//# sourceMappingURL=bitbucket-server-module.js.map

package/lib/bitbucket-server/bitbucket-server-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-server-module.js","sourceRoot":"","sources":["../../src/bitbucket-server/bitbucket-server-module.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;yEAQyE;AACzE,uCAAwD;AAExD,yEAAsE;AACtE,kCAAiC;AAEzB,IAAA,QAAQ,GAAK,aAAK,SAAV,CAAW;AAE3B,IAAM,qBAAqB,GAAG,IAAI,2BAAe,CAAC,UAAC,IAAqB;IACtE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,mDAAuB,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAChE,CAAC,CAAC,CAAC;AAEM,sDAAqB"}

package/lib/bitbucket-server/bitbucket-server-resolver.d.ts

@@ -0,0 +1,17 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { Url } from '../resolve/url';
+import { Resolver } from '../resolve/resolver';
+export declare class BitbucketServerResolver implements Resolver {
+    static readonly BITBUCKET_URL_PATTERNS: RegExp[];
+    isValid(url: string): boolean;
+    resolve(url: string): Url;
+    private getGroup;
+}

package/lib/bitbucket-server/bitbucket-server-resolver.js

@@ -0,0 +1,64 @@
+"use strict";
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+exports.__esModule = true;
+exports.BitbucketServerResolver = void 0;
+var bitbucket_server_url_1 = require("./bitbucket-server-url");
+var inversify_1 = require("inversify");
+var BitbucketServerResolver = /** @class */ (function () {
+    function BitbucketServerResolver() {
+    }
+    BitbucketServerResolver_1 = BitbucketServerResolver;
+    BitbucketServerResolver.prototype.isValid = function (url) {
+        return BitbucketServerResolver_1.BITBUCKET_URL_PATTERNS.some(function (p) { return p.test(url); });
+    };
+    BitbucketServerResolver.prototype.resolve = function (url) {
+        var regExp = BitbucketServerResolver_1.BITBUCKET_URL_PATTERNS.find(function (p) { return p.test(url); });
+        if (!regExp) {
+            throw new Error("Invalid bitbucket-server URL: " + url);
+        }
+        var match = regExp.exec(url);
+        var scheme = this.getGroup(match, 'scheme');
+        var hostName = this.getGroup(match, 'host');
+        var user = this.getGroup(match, 'user');
+        var project = this.getGroup(match, 'project');
+        var repo = this.getGroup(match, 'repo');
+        var branch = this.getGroup(match, 'branch');
+        if (branch !== undefined && branch.startsWith('refs%2Fheads%2F')) {
+            branch = branch.substring(15);
+        }
+        return new bitbucket_server_url_1.BitbucketServerUrl(scheme, hostName, user, project, repo, branch);
+    };
+    BitbucketServerResolver.prototype.getGroup = function (match, groupName) {
+        if (match.groups && match.groups[groupName]) {
+            return match.groups[groupName];
+        }
+    };
+    var BitbucketServerResolver_1;
+    // eslint-disable-next-line max-len
+    BitbucketServerResolver.BITBUCKET_URL_PATTERNS = [
+        /^(?<scheme>https?):\/\/(?<host>.*)\/scm\/~(?<user>[^\/]+)\/(?<repo>.*).git$/,
+        /^(?<scheme>https?):\/\/(?<host>.*)\/users\/(?<user>[^\/]+)\/repos\/(?<repo>[^\/]+)\/browse(\?at=(?<branch>.*))?$/,
+        /^(?<scheme>https?):\/\/(?<host>.*)\/scm\/(?<project>[^\/~]+)\/(?<repo>[^\/]+).git$/,
+        /^(?<scheme>https?):\/\/(?<host>.*)\/projects\/(?<project>[^\/]+)\/repos\/(?<repo>[^\/]+)\/browse(\?at=(?<branch>.*))?$/,
+    ];
+    BitbucketServerResolver = BitbucketServerResolver_1 = __decorate([
+        (0, inversify_1.injectable)()
+    ], BitbucketServerResolver);
+    return BitbucketServerResolver;
+}());
+exports.BitbucketServerResolver = BitbucketServerResolver;
+//# sourceMappingURL=bitbucket-server-resolver.js.map

package/lib/bitbucket-server/bitbucket-server-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-server-resolver.js","sourceRoot":"","sources":["../../src/bitbucket-server/bitbucket-server-resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;;;;;;;AAEzE,+DAA4D;AAC5D,uCAAuC;AAKvC;IAAA;IAoCA,CAAC;gCApCY,uBAAuB;IASlC,yCAAO,GAAP,UAAQ,GAAW;QACjB,OAAO,yBAAuB,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAX,CAAW,CAAC,CAAC;IAC/E,CAAC;IAED,yCAAO,GAAP,UAAQ,GAAW;QACjB,IAAM,MAAM,GAAG,yBAAuB,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAX,CAAW,CAAC,CAAC;QACrF,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,mCAAiC,GAAK,CAAC,CAAC;SACzD;QACD,IAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAChD,IAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;YAChE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;SAC/B;QACD,OAAO,IAAI,yCAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC;IAEO,0CAAQ,GAAhB,UAAiB,KAAsB,EAAE,SAAiB;QACxD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAChC;IACH,CAAC;;IAlCD,mCAAmC;IACnB,8CAAsB,GAAa;QACjD,6EAA6E;QAC7E,kHAAkH;QAClH,oFAAoF;QACpF,wHAAwH;KACxH,CAAA;IAPS,uBAAuB;QADnC,IAAA,sBAAU,GAAE;OACA,uBAAuB,CAoCnC;IAAD,8BAAC;CAAA,AApCD,IAoCC;AApCY,0DAAuB"}

package/lib/bitbucket-server/bitbucket-server-url.d.ts

@@ -0,0 +1,24 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { Url } from '../resolve/url';
+export declare class BitbucketServerUrl implements Url {
+    private readonly scheme;
+    private readonly hostName;
+    private readonly user;
+    private readonly project;
+    private readonly repo;
+    private readonly branch;
+    constructor(scheme: string, hostName: string, user: string | undefined, project: string | undefined, repo: string, branch: string | undefined);
+    getContentUrl(path: string): string;
+    getUrl(): string;
+    getCloneUrl(): string;
+    getRepoName(): string;
+    getBranchName(): string;
+}

package/lib/bitbucket-server/bitbucket-server-url.js

@@ -0,0 +1,43 @@
+"use strict";
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+exports.__esModule = true;
+exports.BitbucketServerUrl = void 0;
+var BitbucketServerUrl = /** @class */ (function () {
+    function BitbucketServerUrl(scheme, hostName, user, project, repo, branch) {
+        this.scheme = scheme;
+        this.hostName = hostName;
+        this.user = user;
+        this.project = project;
+        this.repo = repo;
+        this.branch = branch;
+    }
+    BitbucketServerUrl.prototype.getContentUrl = function (path) {
+        var isUser = this.user !== undefined;
+        return this.scheme + "://" + this.hostName + "/" + (isUser ? 'users' : 'projects') + "/" + (isUser ? this.user : this.project) + "/repos/" + this.repo + "/raw/" + path + (this.branch !== undefined ? '?/at=' + this.branch : '');
+    };
+    BitbucketServerUrl.prototype.getUrl = function () {
+        var isUser = this.user !== undefined;
+        return this.scheme + "://" + this.hostName + "/" + (isUser ? 'users' : 'projects') + "/" + (isUser ? this.user : this.project) + "/repos/" + this.repo + (this.branch !== undefined ? '/browse?at=' + this.branch : '');
+    };
+    BitbucketServerUrl.prototype.getCloneUrl = function () {
+        var isUser = this.user !== undefined;
+        return this.scheme + "://" + this.hostName + "/scm/" + (isUser ? '~' + this.user : this.project.toLowerCase()) + "/" + this.repo + ".git";
+    };
+    BitbucketServerUrl.prototype.getRepoName = function () {
+        return this.repo;
+    };
+    BitbucketServerUrl.prototype.getBranchName = function () {
+        return this.branch;
+    };
+    return BitbucketServerUrl;
+}());
+exports.BitbucketServerUrl = BitbucketServerUrl;
+//# sourceMappingURL=bitbucket-server-url.js.map

package/lib/bitbucket-server/bitbucket-server-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-server-url.js","sourceRoot":"","sources":["../../src/bitbucket-server/bitbucket-server-url.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;AAIzE;IACE,4BACmB,MAAc,EACd,QAAgB,EAChB,IAAwB,EACxB,OAA2B,EAC3B,IAAY,EACZ,MAA0B;QAL1B,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAoB;QACxB,YAAO,GAAP,OAAO,CAAoB;QAC3B,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAoB;IAC1C,CAAC;IAEJ,0CAAa,GAAb,UAAc,IAAY;QACxB,IAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;QACvC,OAAU,IAAI,CAAC,MAAM,WAAM,IAAI,CAAC,QAAQ,UAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,WACvE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,gBACzB,IAAI,CAAC,IAAI,aAAQ,IAAI,IAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;IAC7F,CAAC;IAED,mCAAM,GAAN;QACE,IAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;QACvC,OAAU,IAAI,CAAC,MAAM,WAAM,IAAI,CAAC,QAAQ,UAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,WACvE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,gBACzB,IAAI,CAAC,IAAI,IAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;IACvF,CAAC;IAED,wCAAW,GAAX;QACE,IAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;QACvC,OAAU,IAAI,CAAC,MAAM,WAAM,IAAI,CAAC,QAAQ,cAAQ,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UACnG,IAAI,CAAC,IAAI,SACL,CAAC;IACT,CAAC;IAED,wCAAW,GAAX;QACE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,0CAAa,GAAb;QACE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACH,yBAAC;AAAD,CAAC,AAtCD,IAsCC;AAtCY,gDAAkB"}

package/lib/devfile/dev-container-component-finder.d.ts

@@ -13,5 +13,6 @@ import { V1alpha2DevWorkspaceSpecTemplateComponents } from '@devfile/api';
  * Need to find dev container from main dev workspace
  */
 export declare class DevContainerComponentFinder {
-    find(devfileContext: DevfileContext): Promise<V1alpha2DevWorkspaceSpecTemplateComponents | undefined>;
+    private devContainerComponentInserter;
+    find(devfileContext: DevfileContext, injectDefaultComponent?: string, defaultComponentImage?: string): Promise<V1alpha2DevWorkspaceSpecTemplateComponents | undefined>;
 }

package/lib/devfile/dev-container-component-finder.js

@@ -53,23 +53,33 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 exports.__esModule = true;
 exports.DevContainerComponentFinder = void 0;
 var inversify_1 = require("inversify");
+var dev_container_component_inserter_1 = require("./dev-container-component-inserter");
 /**
  * Need to find dev container from main dev workspace
  */
 var DevContainerComponentFinder = /** @class */ (function () {
     function DevContainerComponentFinder() {
     }
-    DevContainerComponentFinder.prototype.find = function (devfileContext) {
-        var _a, _b, _c;
+    DevContainerComponentFinder.prototype.find = function (devfileContext, injectDefaultComponent, defaultComponentImage) {
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function () {
-            var devComponents;
-            return __generator(this, function (_d) {
-                devComponents = (_c = (_b = (_a = devfileContext.devWorkspace.spec) === null || _a === void 0 ? void 0 : _a.template) === null || _b === void 0 ? void 0 : _b.components) === null || _c === void 0 ? void 0 : _c.filter(function (component) { return component.container; }).filter(
+            var devComponents, devComponents_1;
+            return __generator(this, function (_e) {
+                // if a devfile contains a parent, we should not add a default dev container
+                if ((_a = devfileContext.devfile) === null || _a === void 0 ? void 0 : _a.parent) {
+                    return [2 /*return*/, undefined];
+                }
+                devComponents = (_d = (_c = (_b = devfileContext.devWorkspace.spec) === null || _b === void 0 ? void 0 : _b.template) === null || _c === void 0 ? void 0 : _c.components) === null || _d === void 0 ? void 0 : _d.filter(function (component) { return component.container; }).filter(
                 // we should ignore component that do not mount the sources
                 function (component) { return component.container && component.container.mountSources !== false; });
-                // only one, fine, else error
                 if (!devComponents || devComponents.length === 0) {
-                    throw new Error('Not able to find any dev container component in DevWorkspace');
+                    // do not inject a default component if injectDefaultComponent parameter is false
+                    if (!injectDefaultComponent || injectDefaultComponent !== 'true') {
+                        return [2 /*return*/, undefined];
+                    }
+                    this.devContainerComponentInserter.insert(devfileContext, defaultComponentImage);
+                    devComponents_1 = devfileContext.devWorkspace.spec.template.components.filter(function (component) { return component.container; });
+                    return [2 /*return*/, devComponents_1[0]];
                 }
                 else if (devComponents.length === 1) {
                     return [2 /*return*/, devComponents[0]];
@@ -82,6 +92,9 @@ var DevContainerComponentFinder = /** @class */ (function () {
             });
         });
     };
+    __decorate([
+        (0, inversify_1.inject)(dev_container_component_inserter_1.DevContainerComponentInserter)
+    ], DevContainerComponentFinder.prototype, "devContainerComponentInserter");
     DevContainerComponentFinder = __decorate([
         (0, inversify_1.injectable)()
     ], DevContainerComponentFinder);

package/lib/devfile/dev-container-component-finder.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-container-component-finder.js","sourceRoot":"","sources":["../../src/devfile/dev-container-component-finder.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIzE,uCAAuC;AAEvC;;GAEG;AAEH;IAAA;IAwBA,CAAC;IAvBO,0CAAI,GAAV,UAAW,cAA8B;;;;;gBAEjC,aAAa,GAAG,MAAA,MAAA,MAAA,cAAc,CAAC,YAAY,CAAC,IAAI,0CAAE,QAAQ,0CAAE,UAAU,0CACxE,MAAM,CAAC,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,SAAS,EAAnB,CAAmB,EACxC,MAAM;gBACL,2DAA2D;gBAC3D,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,KAAK,EAAjE,CAAiE,CAC/E,CAAC;gBAEJ,6BAA6B;gBAC7B,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;oBAChD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;iBACjF;qBAAM,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;oBACrC,sBAAO,aAAa,CAAC,CAAC,CAAC,EAAC;iBACzB;qBAAM;oBACL,OAAO,CAAC,IAAI,CACV,+FAA6F,aAAa,CAAC,GAAG,CAC5G,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,IAAI,EAAd,CAAc,CAC1B,CACJ,CAAC;oBACF,sBAAO,aAAa,CAAC,CAAC,CAAC,EAAC;iBACzB;;;;KACF;IAvBU,2BAA2B;QADvC,IAAA,sBAAU,GAAE;OACA,2BAA2B,CAwBvC;IAAD,kCAAC;CAAA,AAxBD,IAwBC;AAxBY,kEAA2B"}
+{"version":3,"file":"dev-container-component-finder.js","sourceRoot":"","sources":["../../src/devfile/dev-container-component-finder.ts"],"names":[],"mappings":";AAAA;;;;;;;;yEAQyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIzE,uCAA+C;AAC/C,uFAAmF;AAEnF;;GAEG;AAEH;IAAA;IA0CA,CAAC;IAtCO,0CAAI,GAAV,UACE,cAA8B,EAC9B,sBAA+B,EAC/B,qBAA8B;;;;;gBAE9B,4EAA4E;gBAC5E,IAAI,MAAA,cAAc,CAAC,OAAO,0CAAE,MAAM,EAAE;oBAClC,sBAAO,SAAS,EAAC;iBAClB;gBAEK,aAAa,GAAG,MAAA,MAAA,MAAA,cAAc,CAAC,YAAY,CAAC,IAAI,0CAAE,QAAQ,0CAAE,UAAU,0CACxE,MAAM,CAAC,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,SAAS,EAAnB,CAAmB,EACxC,MAAM;gBACL,2DAA2D;gBAC3D,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,KAAK,EAAjE,CAAiE,CAC/E,CAAC;gBAEJ,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;oBAChD,iFAAiF;oBACjF,IAAI,CAAC,sBAAsB,IAAI,sBAAsB,KAAK,MAAM,EAAE;wBAChE,sBAAO,SAAS,EAAC;qBAClB;oBACD,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;oBAE7E,kBAAgB,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,SAAS,EAAnB,CAAmB,CAAC,CAAC;oBAElH,sBAAO,eAAa,CAAC,CAAC,CAAC,EAAC;iBACzB;qBAAM,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;oBACrC,sBAAO,aAAa,CAAC,CAAC,CAAC,EAAC;iBACzB;qBAAM;oBACL,OAAO,CAAC,IAAI,CACV,+FAA6F,aAAa,CAAC,GAAG,CAC5G,UAAA,SAAS,IAAI,OAAA,SAAS,CAAC,IAAI,EAAd,CAAc,CAC1B,CACJ,CAAC;oBACF,sBAAO,aAAa,CAAC,CAAC,CAAC,EAAC;iBACzB;;;;KACF;IAvCD;QADC,IAAA,kBAAM,EAAC,gEAA6B,CAAC;8EAC+B;IAF1D,2BAA2B;QADvC,IAAA,sBAAU,GAAE;OACA,2BAA2B,CA0CvC;IAAD,kCAAC;CAAA,AA1CD,IA0CC;AA1CY,kEAA2B"}

package/lib/devfile/dev-container-component-inserter.d.ts

@@ -0,0 +1,18 @@
+/**********************************************************************
+ * Copyright (c) 2023 Red Hat, Inc.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ ***********************************************************************/
+import { DevfileContext } from '../api/devfile-context';
+/**
+ * Adds a new component on empty devfile with specific name and image
+ */
+export declare class DevContainerComponentInserter {
+    readonly DEFAULT_DEV_CONTAINER_IMAGE = "quay.io/devfile/universal-developer-image:ubi8-latest";
+    readonly DEFAULT_DEV_CONTAINER_NAME = "dev";
+    insert(devfileContext: DevfileContext, defaultComponentImage?: string): Promise<void>;
+}