@api-client/core 0.6.29 → 0.7.0

package/build/src/models/{arc/ArcProject.d.ts → AppProject.d.ts}

@@ -1,12 +1,27 @@
-import { IHttpRequest } from "../HttpRequest.js";
-import { IRequest, Request } from "../Request.js";
-import { IThing, Thing } from "../Thing.js";
-import { ARCHistoryRequest, ARCSavedRequest } from "../legacy/request/ArcRequest.js";
-import { ARCProject } from "../legacy/models/ArcLegacyProject.js";
-export declare const ArcProjectKind = "ARC#HttpProject";
-export declare const ArcProjectFolderKind = "ARC#HttpProjectFolder";
-export declare const ArcProjectRequestKind = "ARC#HttpProjectRequest";
-export interface IArcRequestCloneOptions {
+import { IHttpRequest } from "./HttpRequest.js";
+import { IRequest, Request } from "./Request.js";
+import { Environment, IEnvironment, Kind as EnvironmentKind } from './Environment.js';
+import { IThing, Thing } from "./Thing.js";
+import { ARCHistoryRequest, ARCSavedRequest } from "./legacy/request/ArcRequest.js";
+import { ARCProject } from "./legacy/models/ArcLegacyProject.js";
+import { Certificate, HttpCertificate } from "./ClientCertificate.js";
+import { IProjectRequestIterator } from "./HttpProject.js";
+export declare const AppProjectKind = "Core#AppProject";
+export declare const AppProjectFolderKind = "Core#AppProjectFolder";
+export declare const AppProjectRequestKind = "Core#AppProjectRequest";
+export interface IAppProjectItemOptions {
+    /**
+     * The parent folder to add the item to.
+     */
+    parent?: string;
+}
+export interface IAppProjectItemCreateOptions extends IAppProjectItemOptions {
+    /**
+     * The position at which to add the item.
+     */
+    index?: number;
+}
+export interface IAppProjectRequestCloneOptions {
     /**
      * By default it revalidates (re-creates) keys in the request.
      * Set this to true to not make any changes to the keys.
@@ -19,13 +34,13 @@ export interface IArcRequestCloneOptions {
      */
     withoutAttach?: boolean;
 }
-export interface IArcFolderAddOptions {
+export interface IAppProjectFolderAddOptions {
     /**
      * Optionally the position at which to add the request into the list of items.
      */
     index?: number;
 }
-export interface IArcFolderCloneOptions {
+export interface IAppProjectFolderCloneOptions {
     /**
      * By default it clones the folder with all requests in it.
      * Set this to `true` to skip copying the requests along with the folder.
@@ -42,7 +57,7 @@ export interface IArcFolderCloneOptions {
      * is put into the project root rather than the parent folder (as it would when cloning
      * a folder inside the same project).
      */
-    targetProject?: ArcProject;
+    targetProject?: AppProject;
     /**
      * The **key** of the target folder.
      *
@@ -51,119 +66,127 @@ export interface IArcFolderCloneOptions {
      */
     targetFolder?: string;
 }
-export interface IArcFolderCreateOptions {
+export interface IAppProjectFolderCreateOptions extends IAppProjectItemOptions {
     /**
      * Ignores the operation when the folder with the same name already exists.
      * This command can be used used to ensure that the folder exists.
      */
     skipExisting?: boolean;
-    /**
-     * The id of the parent folder. When not set it adds the folder to the project root.
-     */
-    parent?: string;
     /**
      * Optionally the position at which to add the folder into the list of items.
      */
     index?: number;
 }
-export interface IArcFolderSearchOptions {
+export interface IAppProjectFolderSearchOptions {
     /**
      * When set it searches for a folder using keys only.
      * By default it searches for a key and the name.
      */
     keyOnly?: boolean;
 }
-export interface IArcFolderDeleteOptions {
+export interface IAppProjectFolderDeleteOptions {
     /**
      * When set it won't throw an error when the folder is not found in the project.
      */
     safe?: boolean;
 }
-export interface IArcRequestAddOptions {
-    /**
-     * The id of the parent folder. When not set it adds the request to the project root.
-     */
-    parent?: string;
+export interface IAppProjectRequestAddOptions extends IAppProjectItemOptions {
     /**
      * Optionally the position at which to add the request into the list of items.
      */
     index?: number;
 }
-export interface IArcRequestSearchOptions {
+export interface IAppProjectRequestSearchOptions {
     /**
      * When set it searches for a request using keys only.
      * By default it searches for a key and the name.
      */
     keyOnly?: boolean;
 }
-export interface IArcRequestDeleteOptions {
+export interface IAppProjectRequestDeleteOptions {
     /**
      * When set it won't throw an error when the request is not found in the project.
      */
     safe?: boolean;
 }
-export interface IArcProjectMoveOptions {
+export interface IAppProjectProjectMoveOptions extends IAppProjectItemOptions {
     /**
      * The position at which to insert the object in the destination. BY default it adds the object at the end.
      */
     index?: number;
-    /**
-     * The name or the key of the parent folder to move the item into.
-     * When not set it moves the item to the project's root.
-     */
-    parent?: string;
 }
-export interface IArcFolderListOptions {
+export interface IAppProjectFolderListOptions {
     /**
      * Folder name or key to list folders for.
      */
     folder?: string;
 }
-export interface IArcProjectCloneOptions {
+export interface IAppProjectProjectCloneOptions {
     /**
      * By default it revalidates (re-creates) keys in the request.
      * Set this to true to not make any changes to the keys.
      */
     withoutRevalidate?: boolean;
 }
-export interface IArcProjectRequest extends IRequest {
-    kind: typeof ArcProjectRequestKind;
+export interface IAppProjectEnvironmentCreateOptions extends IAppProjectItemOptions {
+    /**
+     * The position at which to add the item.
+     */
+    index?: number;
+}
+export interface IAppProjectReadEnvironmentOptions extends IAppProjectItemOptions {
+    /**
+     * The name or the key of the environment to select.
+     *
+     * When the name is not specified it selects:
+     * - the first environment from the project, if any
+     * - any parent folder's first environment to the requested folder, if any (if parent is set)
+     * - the requested folder's first environment, if any (if parent is set)
+     */
+    nameOrKey?: string;
+}
+export interface IAppProjectRequest extends IRequest {
+    kind: typeof AppProjectRequestKind;
     key: string;
 }
-export interface IArcProjectItem {
-    kind: typeof ArcProjectFolderKind | typeof ArcProjectRequestKind;
+export interface IAppProjectItem {
+    kind: typeof AppProjectFolderKind | typeof AppProjectRequestKind | typeof EnvironmentKind;
     key: string;
 }
-export interface IArcProjectDefinitions {
+export interface IAppProjectDefinitions {
     /**
      * The list of all folders defined in the project.
      */
-    folders?: IProjectParent[];
+    folders?: IAppProjectParent[];
     /**
      * The list of all requests defined in the project.
      */
-    requests?: IArcProjectRequest[];
+    requests?: IAppProjectRequest[];
+    environments?: IEnvironment[];
+    certificates?: HttpCertificate[];
 }
-export interface ArcProjectDefinitions {
+export interface AppProjectDefinitions {
     /**
      * The list of all folders defined in the project.
      */
-    folders: ArcProjectFolder[];
+    folders: AppProjectFolder[];
     /**
      * The list of all requests defined in the project.
      */
-    requests: ArcProjectRequest[];
+    requests: AppProjectRequest[];
+    environments: Environment[];
+    certificates: Certificate[];
 }
-export interface IArcProject extends IProjectParent {
-    definitions: IArcProjectDefinitions;
+/**
+ * An app project is similar to the HttpProject but stored for a single application
+ * and has no sharing options. The AppProject can be upgraded to an HttpProject.
+ */
+export interface IAppProject extends IAppProjectParent {
+    definitions: IAppProjectDefinitions;
 }
-export interface IProjectParent {
+export interface IAppProjectParent {
     key: string;
-    /**
-     * The auto-generated key for the folder object.
-     * For the project root this is the same as the `_id`.
-     */
-    kind: typeof ArcProjectKind | typeof ArcProjectFolderKind;
+    kind: typeof AppProjectKind | typeof AppProjectFolderKind;
     /**
      * Folder meta
      */
@@ -173,7 +196,7 @@ export interface IProjectParent {
      * It is an ordered list of requests and folders.
      * The actual definition is kept in the root's `definitions`.
      */
-    items: IArcProjectItem[];
+    items: IAppProjectItem[];
     /**
      * Timestamp when the project was last updated.
      */
@@ -183,7 +206,7 @@ export interface IProjectParent {
      */
     created?: number;
 }
-export declare class ArcProjectRequest extends Request {
+export declare class AppProjectRequest extends Request {
     kind: string;
     /**
      * The identifier of the request.
@@ -192,7 +215,7 @@ export declare class ArcProjectRequest extends Request {
     /**
      * A reference to the top level project object.
      */
-    project: ArcProject;
+    project: AppProject;
     /**
      * Creates a project request from an URL.
      * This does not manipulate the project.
@@ -200,7 +223,7 @@ export declare class ArcProjectRequest extends Request {
      * @param url The Request URL. This is required.
      * @param project The parent project.
      */
-    static fromUrl(url: string, project?: ArcProject): ArcProjectRequest;
+    static fromUrl(url: string, project?: AppProject): AppProjectRequest;
     /**
      * Creates a project request from a name.
      * This does not manipulate the project.
@@ -208,7 +231,7 @@ export declare class ArcProjectRequest extends Request {
      * @param name The Request name.
      * @param project The parent project.This is required.
      */
-    static fromName(name: string, project?: ArcProject): ArcProjectRequest;
+    static fromName(name: string, project?: AppProject): AppProjectRequest;
     /**
      * Creates a project request from an HttpRequest definition.
      * This does not manipulate the project.
@@ -216,22 +239,22 @@ export declare class ArcProjectRequest extends Request {
      * @param project The parent project This is required.
      * @param info The request data.
      */
-    static fromHttpRequest(info: IHttpRequest, project?: ArcProject): ArcProjectRequest;
+    static fromHttpRequest(info: IHttpRequest, project?: AppProject): AppProjectRequest;
     /**
      * Creates a project request for a schema of a Request.
      */
-    static fromRequest(request: IRequest, project: ArcProject): ArcProjectRequest;
-    constructor(project: ArcProject, input?: string | IArcProjectRequest);
-    new(init: IArcProjectRequest): void;
-    toJSON(): IArcProjectRequest;
+    static fromRequest(request: IRequest, project: AppProject): AppProjectRequest;
+    constructor(project: AppProject, input?: string | IAppProjectRequest);
+    new(init: IAppProjectRequest): void;
+    toJSON(): IAppProjectRequest;
     /**
      * @returns The instance of the ArcProject or a ArcProjectFolder that is a closes parent of this instance.
      */
-    getParent(): ArcProjectFolder | ArcProject | undefined;
+    getParent(): AppProjectFolder | AppProject | undefined;
     /**
      * @returns A reference to the parent folder or the top-level HTTP project.
      */
-    getProject(): ArcProject;
+    getProject(): AppProject;
     /**
      * Removes this request from the project.
      */
@@ -241,7 +264,7 @@ export declare class ArcProjectRequest extends Request {
      * By default it attaches the copied request to the same parent.
      * Use the options dictionary to control this behavior.
      */
-    clone(opts?: IArcRequestCloneOptions): ArcProjectRequest;
+    clone(opts?: IAppProjectRequestCloneOptions): AppProjectRequest;
     /**
      * The static version of the `clone()` method.
      *
@@ -250,13 +273,13 @@ export declare class ArcProjectRequest extends Request {
      * @param opts Optional options.
      * @returns The copied request.
      */
-    static clone(request: IArcProjectRequest, project: ArcProject, opts?: IArcRequestCloneOptions): ArcProjectRequest;
+    static clone(request: IAppProjectRequest, project: AppProject, opts?: IAppProjectRequestCloneOptions): AppProjectRequest;
 }
-export declare class ArcProjectItem {
+export declare class AppProjectItem {
     /**
      * The kind of the item.
      */
-    kind: typeof ArcProjectFolderKind | typeof ArcProjectRequestKind;
+    kind: typeof AppProjectFolderKind | typeof AppProjectRequestKind | typeof EnvironmentKind;
     /**
      * The identifier of the object in the `definitions` array of the project.
      */
@@ -264,7 +287,7 @@ export declare class ArcProjectItem {
     /**
      * A reference to the top level project object.
      */
-    project: ArcProject;
+    project: AppProject;
     /**
      * Checks whether the input is a definition of a project item.
      */
@@ -272,38 +295,42 @@ export declare class ArcProjectItem {
     /**
      * @return An instance that represents a request item
      */
-    static projectRequest(project: ArcProject, key: string): ArcProjectItem;
+    static projectRequest(project: AppProject, key: string): AppProjectItem;
     /**
      * @return An instance that represents a folder item
      */
-    static projectFolder(project: ArcProject, key: string): ArcProjectItem;
+    static projectFolder(project: AppProject, key: string): AppProjectItem;
+    /**
+     * @return An instance that represents an environment item
+     */
+    static projectEnvironment(project: AppProject, key: string): AppProjectItem;
     /**
      * @param project The top-most project.
      * @param input The project item definition used to restore the state.
      */
-    constructor(project: ArcProject, input: string | IArcProjectItem);
+    constructor(project: AppProject, input: string | IAppProjectItem);
     /**
      * Creates a new project item clearing anything that is so far defined.
      *
      * Note, this throws an error when the project item is not a project item.
      */
-    new(init: IArcProjectItem): void;
-    toJSON(): IArcProjectItem;
+    new(init: IAppProjectItem): void;
+    toJSON(): IAppProjectItem;
     /**
      * @returns The instance of the definition associated with this item.
      */
-    getItem(): ArcProjectFolder | ArcProjectRequest | undefined;
+    getItem(): AppProjectFolder | AppProjectRequest | Environment | undefined;
     /**
      * @returns The instance of the ArcProject or a ArcProjectFolder that is a closest parent of this item.
      */
-    getParent(): ArcProjectFolder | ArcProject | undefined;
+    getParent(): AppProjectFolder | AppProject | undefined;
 }
-export declare abstract class ArcProjectParent {
+export declare abstract class AppProjectParent {
     /**
      * The auto-generated key for the folder object.
      * For the project root this is the same as the `_id`.
      */
-    kind: typeof ArcProjectKind | typeof ArcProjectFolderKind;
+    kind: typeof AppProjectKind | typeof AppProjectFolderKind;
     /**
      * The key of the project / folder.
      */
@@ -317,7 +344,7 @@ export declare abstract class ArcProjectParent {
      * It is an ordered list of requests and folders.
      * The actual definition is kept in the root's `definitions`.
      */
-    items: ArcProjectItem[];
+    items: AppProjectItem[];
     /**
      * Timestamp when the project was last updated.
      */
@@ -326,41 +353,41 @@ export declare abstract class ArcProjectParent {
      * Timestamp when the project was created.
      */
     created: number;
-    constructor(kind: typeof ArcProjectKind | typeof ArcProjectFolderKind, input?: string | IProjectParent);
+    constructor(kind: typeof AppProjectKind | typeof AppProjectFolderKind, input?: string | IAppProjectParent);
     /**
      * Creates a new project folder clearing anything that is so far defined.
      *
      * Note, this throws an error when the project folder is not a project folder.
      */
-    new(init: IProjectParent): void;
-    abstract setItems(items?: IArcProjectItem[]): void;
+    new(init: IAppProjectParent): void;
+    abstract setItems(items?: IAppProjectItem[]): void;
     /**
      * Lists items (not the actual definitions!) that are folders.
      */
-    listFolderItems(): ArcProjectItem[];
+    listFolderItems(): AppProjectItem[];
     /**
      * Lists items (not the actual definitions!) that are requests.
      */
-    listRequestItems(): ArcProjectItem[];
+    listRequestItems(): AppProjectItem[];
 }
-export declare class ArcProjectFolder extends ArcProjectParent {
-    project: ArcProject;
+export declare class AppProjectFolder extends AppProjectParent {
+    project: AppProject;
     /**
      * Creates a new ArcProjectFolder object from a name.
      * @param project The top-most project.
      * @param name The name to set.
      */
-    static fromName(project: ArcProject, name?: string): ArcProjectFolder;
-    constructor(project: ArcProject, input?: string | IProjectParent);
-    toJSON(): IProjectParent;
-    setItems(items?: IArcProjectItem[]): void;
+    static fromName(project: AppProject, name?: string): AppProjectFolder;
+    constructor(project: AppProject, input?: string | IAppProjectParent);
+    toJSON(): IAppProjectParent;
+    setItems(items?: IAppProjectItem[]): void;
     /**
      * Appends an instance of a folder to a project.
      *
      * @param folder The folder to add to this project.
      * @returns The added folder.
      */
-    addFolder(folder: ArcProjectFolder): ArcProjectFolder;
+    addFolder(folder: AppProjectFolder): AppProjectFolder;
     /**
      * Appends new folder to a project from a full folder schema.
      * This is primarily used to insert a folder on the client side
@@ -369,14 +396,14 @@ export declare class ArcProjectFolder extends ArcProjectParent {
      * @param folder The folder schema to add to this project.
      * @returns The added folder.
      */
-    addFolder(folder: IProjectParent): ArcProjectFolder;
+    addFolder(folder: IAppProjectParent): AppProjectFolder;
     /**
      * Appends a new folder to the project or a sub-folder.
      *
      * @param name The name to set. Optional.
      * @returns The newly inserted folder. If the folder already existed it returns its instance.
      */
-    addFolder(name?: string): ArcProjectFolder;
+    addFolder(name?: string): AppProjectFolder;
     /**
      * Adds a request to the project or a sub-folder.
      *
@@ -384,7 +411,7 @@ export declare class ArcProjectFolder extends ArcProjectParent {
      * @param opts The request add options.
      * @returns The inserted into the definitions request.
      */
-    addRequest(url: string, opts?: IArcFolderAddOptions): ArcProjectRequest;
+    addRequest(url: string, opts?: IAppProjectFolderAddOptions): AppProjectRequest;
     /**
      * Adds a request to the project or a sub-folder.
      *
@@ -392,15 +419,15 @@ export declare class ArcProjectFolder extends ArcProjectParent {
      * @param opts The request add options.
      * @returns The inserted into the definitions request.
      */
-    addRequest(request: IArcProjectRequest | ArcProjectRequest, opts?: IArcFolderAddOptions): ArcProjectRequest;
+    addRequest(request: IAppProjectRequest | AppProjectRequest, opts?: IAppProjectFolderAddOptions): AppProjectRequest;
     /**
      * @returns The instance of the ArcProject or a ArcProjectFolder that is a closes parent of this instance.
      */
-    getParent(): ArcProjectFolder | ArcProject | undefined;
+    getParent(): AppProjectFolder | AppProject | undefined;
     /**
      * @returns A reference to the parent folder or the top-level HTTP project.
      */
-    getProject(): ArcProject;
+    getProject(): AppProject;
     /**
      * Removes this folder from the project.
      */
@@ -414,14 +441,14 @@ export declare class ArcProjectFolder extends ArcProjectParent {
      *
      * @param opts Cloning options
      */
-    clone(opts?: IArcFolderCloneOptions): ArcProjectFolder;
+    clone(opts?: IAppProjectFolderCloneOptions): AppProjectFolder;
     /**
      * Clones the current requests to the target folder.
      *
      * @param folder The target folder into which to put the requests. The folder has to have the target project attached to it.
      * @param project The originating project where the definitions are stored
      */
-    protected cloneRequests(folder: ArcProjectFolder, project: ArcProject): void;
+    protected cloneRequests(folder: AppProjectFolder, project: AppProject): void;
     /**
      * Clones the sub-folders to the target folder.
      *
@@ -429,24 +456,65 @@ export declare class ArcProjectFolder extends ArcProjectParent {
      * @param project The originating project where the definitions are stored
      * @param withRequests Whether to clone requests with the folder.
      */
-    protected cloneSubFolders(folder: ArcProjectFolder, project: ArcProject, withRequests?: boolean): void;
+    protected cloneSubFolders(folder: AppProjectFolder, project: AppProject, withRequests?: boolean): void;
     /**
      * Lists folders in this folder.
      */
-    listFolders(): ArcProjectFolder[];
+    listFolders(): AppProjectFolder[];
     /**
      * Lists requests in this folder.
      */
-    listRequests(): ArcProjectRequest[];
+    listRequests(): AppProjectRequest[];
     /**
      * Adds a request to the project that has been created for a previous version of ARC.
      *
      * @param legacy The legacy request definition.
      * @returns The created project request.
      */
-    addLegacyRequest(legacy: ARCSavedRequest | ARCHistoryRequest): Promise<ArcProjectRequest>;
+    addLegacyRequest(legacy: ARCSavedRequest | ARCHistoryRequest): Promise<AppProjectRequest>;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The definition of the environment to use to create the environment
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: IEnvironment, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The instance of the environment to add
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: Environment, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The name of the environment to create
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: string, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    /**
+     * @param key The environment key to read.
+     */
+    getEnvironment(key: string): Environment | undefined;
+    /**
+     * Removes an environment from the folder or a sub-folder.
+     *
+     * @param key the key of the environment to remove
+     * @returns The removed environment, if any.
+     */
+    removeEnvironment(key: string): Environment | undefined;
+    /**
+     * This is a link to the `getEnvironments()`. The difference is that on the
+     * project level it won't return environments defined with the class initialization.
+     */
+    listEnvironments(): Environment[];
 }
-export declare class ArcProject extends ArcProjectParent {
+/**
+ * An app project is similar to the HttpProject but stored for a single application
+ * and has no sharing options. The AppProject can be upgraded to an HttpProject.
+ */
+export declare class AppProject extends AppProjectParent {
     /**
      * Timestamp when the project was last updated.
      */
@@ -455,29 +523,29 @@ export declare class ArcProject extends ArcProjectParent {
      * Timestamp when the project was created.
      */
     created: number;
-    definitions: ArcProjectDefinitions;
+    definitions: AppProjectDefinitions;
     /**
      * Creates a new ARC project from a name.
      * @param name The name to set.
      */
-    static fromName(name: string): ArcProject;
+    static fromName(name: string): AppProject;
     /**
      * Creates an HTTP project instance from ARC's legacy project definition.
      *
      * Note, the `requests` should be processed and the payload restored to it's original value.
      */
-    static fromLegacyProject(project: ARCProject, requests: ARCSavedRequest[]): Promise<ArcProject>;
-    constructor(input?: string | IArcProject);
-    new(init: IArcProject): void;
-    toJSON(): IArcProject;
-    setItems(items?: IArcProjectItem[]): void;
+    static fromLegacyProject(project: ARCProject, requests: ARCSavedRequest[]): Promise<AppProject>;
+    constructor(input?: string | IAppProject);
+    new(init: IAppProject): void;
+    toJSON(): IAppProject;
+    setItems(items?: IAppProjectItem[]): void;
     /**
      * Finds a parent of a definition.
      *
      * @param  key The key of the definition.
      * @returns The parent or undefine when not found.
      */
-    findParent(key: string): ArcProjectFolder | ArcProject | undefined;
+    findParent(key: string): AppProjectFolder | AppProject | undefined;
     /**
      * Appends an instance of a folder to a project.
      *
@@ -485,7 +553,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Optional folder add options.
      * @returns The added folder.
      */
-    addFolder(folder: ArcProjectFolder, opts?: IArcFolderCreateOptions): ArcProjectFolder;
+    addFolder(folder: AppProjectFolder, opts?: IAppProjectFolderCreateOptions): AppProjectFolder;
     /**
      * Appends new folder to a project from a full folder schema.
      * This is primarily used to insert a folder on the client side
@@ -495,7 +563,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Optional folder add options.
      * @returns The added folder.
      */
-    addFolder(folder: IProjectParent, opts?: IArcFolderCreateOptions): ArcProjectFolder;
+    addFolder(folder: IAppProjectParent, opts?: IAppProjectFolderCreateOptions): AppProjectFolder;
     /**
      * Appends a new folder to the project or a sub-folder.
      *
@@ -503,7 +571,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Folder create options.
      * @returns The newly inserted folder. If the folder already existed it returns its instance.
      */
-    addFolder(name?: string, opts?: IArcFolderCreateOptions): ArcProjectFolder;
+    addFolder(name?: string, opts?: IAppProjectFolderCreateOptions): AppProjectFolder;
     /**
      * Searches for a folder in the structure.
      *
@@ -511,14 +579,14 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Optional search options.
      * @returns Found project folder or undefined.
      */
-    findFolder(nameOrKey: string, opts?: IArcFolderSearchOptions): ArcProjectFolder | undefined;
+    findFolder(nameOrKey: string, opts?: IAppProjectFolderSearchOptions): AppProjectFolder | undefined;
     /**
      * Removes a folder from the project.
      * @param key The folder key. It ignores the name when searching to the folder to avoid ambiguity.
      * @param opts Folder remove options.
      * @returns The removed folder definition or undefined when not removed.
      */
-    removeFolder(key: string, opts?: IArcFolderDeleteOptions): ArcProjectFolder | undefined;
+    removeFolder(key: string, opts?: IAppProjectFolderDeleteOptions): AppProjectFolder | undefined;
     /**
      * Moves a folder between folders and the project or between items inside a folder or a project
      *
@@ -527,7 +595,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param key The key of the request to move.
      * @param opts The moving options.
      */
-    moveFolder(key: string, opts?: IArcProjectMoveOptions): void;
+    moveFolder(key: string, opts?: IAppProjectProjectMoveOptions): void;
     /**
      * Checks whether a folder has a child (anywhere down the structure).
      *
@@ -543,7 +611,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts The request add options.
      * @returns The inserted into the definitions request.
      */
-    addRequest(url: string, opts?: IArcRequestAddOptions): ArcProjectRequest;
+    addRequest(url: string, opts?: IAppProjectRequestAddOptions): AppProjectRequest;
     /**
      * Adds a request to the project or a sub-folder.
      *
@@ -551,14 +619,14 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts The request add options.
      * @returns The inserted into the definitions request.
      */
-    addRequest(request: IArcProjectRequest | ArcProjectRequest, opts?: IArcRequestAddOptions): ArcProjectRequest;
+    addRequest(request: IAppProjectRequest | AppProjectRequest, opts?: IAppProjectRequestAddOptions): AppProjectRequest;
     /**
      * Adds a request to the project that has been created for a previous version of ARC.
      *
      * @param legacy The legacy request definition.
      * @returns The created project request.
      */
-    addLegacyRequest(legacy: ARCSavedRequest | ARCHistoryRequest): Promise<ArcProjectRequest>;
+    addLegacyRequest(legacy: ARCSavedRequest | ARCHistoryRequest): Promise<AppProjectRequest>;
     /**
      * Searches for a request in the project.
      *
@@ -566,7 +634,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Optional search options.
      * @returns Found project request or undefined.
      */
-    findRequest(nameOrKey: string, opts?: IArcRequestSearchOptions): ArcProjectRequest | undefined;
+    findRequest(nameOrKey: string, opts?: IAppProjectRequestSearchOptions): AppProjectRequest | undefined;
     /**
      * Removes a request from the project.
      *
@@ -574,7 +642,7 @@ export declare class ArcProject extends ArcProjectParent {
      * @param opts Request remove options.
      * @returns The removed request definition or undefined when not removed.
      */
-    removeRequest(key: string, opts?: IArcRequestDeleteOptions): ArcProjectRequest | undefined;
+    removeRequest(key: string, opts?: IAppProjectRequestDeleteOptions): AppProjectRequest | undefined;
     /**
      * Moves a request between folders and the project or between items inside a folder or a project.
      *
@@ -583,40 +651,40 @@ export declare class ArcProject extends ArcProjectParent {
      * @param key The key of the request to move.
      * @param opts The moving options.
      */
-    moveRequest(key: string, opts?: IArcProjectMoveOptions): void;
+    moveRequest(key: string, opts?: IAppProjectProjectMoveOptions): void;
     /**
      * Lists items (not the actual definitions!) that are folders.
      */
-    listFolderItems(): ArcProjectItem[];
+    listFolderItems(): AppProjectItem[];
     /**
      * Lists items (not the actual definitions!) that are requests.
      */
-    listRequestItems(): ArcProjectItem[];
+    listRequestItems(): AppProjectItem[];
     /**
      * Lists folders from the project or a sub-folder.
      * @param opts Folder listing options.
      */
-    listFolders(opts?: IArcFolderListOptions): ArcProjectFolder[];
+    listFolders(opts?: IAppProjectFolderListOptions): AppProjectFolder[];
     /**
      * Lists requests in this project or a sub-folder.
      * @param folder The optional folder name or the key to list requests for.
      */
-    listRequests(folder?: string): ArcProjectRequest[];
+    listRequests(folder?: string): AppProjectRequest[];
     /**
      * Lists definitions for the `items` of the project or a folder.
      * @param folder Optionally the folder name to list the definitions for.
      */
-    listDefinitions(folder?: string): (ArcProjectFolder | ArcProjectRequest)[];
+    listDefinitions(folder?: string): (AppProjectFolder | AppProjectRequest | Environment)[];
     /**
      * @returns On the project level this always returns undefined.
      */
-    getParent(): ArcProjectFolder | ArcProject | undefined;
-    getProject(): ArcProject;
+    getParent(): AppProjectFolder | AppProject | undefined;
+    getProject(): AppProject;
     /**
      * Makes a copy of this project.
      */
-    clone(opts?: IArcProjectCloneOptions): ArcProject;
-    static clone(project: IArcProject, opts?: IArcProjectCloneOptions): ArcProject;
+    clone(opts?: IAppProjectProjectCloneOptions): AppProject;
+    static clone(project: IAppProject, opts?: IAppProjectProjectCloneOptions): AppProject;
     /**
      * Re-generates keys in the project, taking care of the references.
      *
@@ -624,5 +692,99 @@ export declare class ArcProject extends ArcProjectParent {
      *
      * @param src The project instance to re-generate keys for.
      */
-    static regenerateKeys(src: ArcProject): void;
+    static regenerateKeys(src: AppProject): void;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The definition of the environment to use to create the environment
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: IEnvironment, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The instance of the environment to add
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: Environment, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    /**
+     * Adds an environment to the project.
+     *
+     * @param env The name of the environment to create
+     * @returns The same or created environment.
+     */
+    addEnvironment(env: string, opts?: IAppProjectEnvironmentCreateOptions): Environment;
+    protected _createEnv(env: IEnvironment | Environment | string): Environment;
+    /**
+     * @param key The environment key to read.
+     */
+    getEnvironment(key: string, opts?: IAppProjectItemOptions): Environment | undefined;
+    /**
+     * Removes an environment from the folder or a sub-folder.
+     *
+     * @param key the key of the environment to remove
+     * @returns The removed environment, if any.
+     */
+    removeEnvironment(key: string, opts?: IAppProjectItemOptions): Environment | undefined;
+    /**
+     * This is a link to the `getEnvironments()`. The difference is that on the
+     * project level it won't return environments defined with the class initialization.
+     */
+    listEnvironments(opts?: IAppProjectItemOptions): Environment[];
+    /**
+     * Reads the list of environments from then selected folder up to the project root.
+     * It stops going up in the project structure when selected environment has the `encapsulated`
+     * property set to true.
+     * The environments are ordered from the top-most level to the selected folder.
+     *
+     * @param opts The environment read options
+     */
+    readEnvironments(opts?: IAppProjectReadEnvironmentOptions): Environment[];
+    /**
+     * Finds a definition for an environment regardless of its parent.
+     *
+     * @param key The Key of the environment to find.
+     * @returns The environment definition or undefined if not found.
+     */
+    findEnvironment(key: string): Environment | undefined;
+    /**
+     * Depending on the options returns a project or a folder.
+     * It throws when parent folder cannot ber found.
+     */
+    protected _getRoot(opts: {
+        parent?: string;
+    }): AppProjectFolder | AppProject;
+    protected _insertItem(item: AppProjectItem, root: AppProjectFolder | AppProject, opts: IAppProjectItemCreateOptions): void;
+    /**
+     * Finds a definition for a certificate.
+     *
+     * @param key The key of the certificate to find.
+     * @returns The certificate definition or undefined if not found.
+     */
+    findCertificate(key: string): Certificate | undefined;
+    /**
+     * Adds a certificate to the project.
+     *
+     * @param init Either an instance of a certificate or its definition.
+     * @returns The inserted certificate.
+     */
+    addCertificate(init: Certificate | HttpCertificate): Certificate;
+    /**
+     * Removes a certificate from the project.
+     *
+     * @param key the key of the certificate to remove
+     * @returns The removed certificate, if any.
+     */
+    removeCertificate(key: string): Certificate | undefined;
+    /**
+     * Finds the requests that are using the certificate identified by the key.
+     *
+     * @param key The key of the certificate to find the usage for.
+     * @returns The list of requests that use this certificate.
+     */
+    findCertificateRequests(key: string): AppProjectRequest[];
+    /**
+     * Iterates over requests in the project.
+     */
+    requestIterator(opts?: IProjectRequestIterator): Generator<AppProjectRequest>;
 }