repository-provider 32.7.13 → 32.7.14

package/README.md

@@ -22,7 +22,7 @@ see list of avaliable implementations below
 ```es6
 import { Provider } from 'repository-provider';
 
-const provider = new Provider({ token: 'xxx' });
+const provider = new Provider({ /* access options as hosts and credentials */ });
 
 const branch = await provider.branch('myuser/myrepo#myBranch');
 
@@ -32,7 +32,7 @@ for await (const entry of branch.entries('**/*.md')) {
 
 const readme = await branch.entry('README.md');
 
-console.log(await readme.getString());
+console.log(await readme.string);
 ```
 
 # Derived Providers
@@ -324,29 +324,35 @@ console.log(await readme.getString());
     *   [hooks](#hooks-1)
     *   [hook](#hook-1)
         *   [Parameters](#parameters-78)
+    *   [milestone](#milestone-1)
+        *   [Parameters](#parameters-79)
+    *   [project](#project-1)
+        *   [Parameters](#parameters-80)
+    *   [application](#application-1)
+        *   [Parameters](#parameters-81)
     *   [type](#type-2)
     *   [refId](#refid-1)
-        *   [Parameters](#parameters-79)
+        *   [Parameters](#parameters-82)
     *   [attributes](#attributes-2)
 *   [defaultBranchName](#defaultbranchname)
 *   [Review](#review)
 *   [SingleGroupProvider](#singlegroupprovider)
     *   [repository](#repository-4)
-        *   [Parameters](#parameters-80)
+        *   [Parameters](#parameters-83)
     *   [repositoryGroup](#repositorygroup-2)
-        *   [Parameters](#parameters-81)
+        *   [Parameters](#parameters-84)
     *   [repositoryGroups](#repositorygroups-1)
-        *   [Parameters](#parameters-82)
+        *   [Parameters](#parameters-85)
 *   [Tag](#tag-1)
     *   [refType](#reftype-1)
 *   [asArray](#asarray)
-    *   [Parameters](#parameters-83)
+    *   [Parameters](#parameters-86)
 *   [stripBaseName](#stripbasename)
-    *   [Parameters](#parameters-84)
+    *   [Parameters](#parameters-87)
 *   [stripBaseNames](#stripbasenames)
-    *   [Parameters](#parameters-85)
+    *   [Parameters](#parameters-88)
 *   [generateBranchName](#generatebranchname)
-    *   [Parameters](#parameters-86)
+    *   [Parameters](#parameters-89)
 
 ## Application
 
@@ -388,7 +394,7 @@ Get default values.
 ### Parameters
 
 *   `attributes` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
-*   `object`  
+*   `object` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** filled with default values
 
@@ -416,7 +422,7 @@ mapAttributes({a:1},{a:"a'"}) // {"a'": 1}
 
 ### Parameters
 
-*   `object` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `object` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
 *   `mapping` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** keys renamed after mapping
@@ -429,7 +435,7 @@ Filters out null, undefined and empty strings
 ### Parameters
 
 *   `object` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
-*   `mapping` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `mapping` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** keys renamed after mapping
 
@@ -510,10 +516,12 @@ this defines the order
 
 ## BaseObject
 
+Creates an instance of BaseObject.
+
 ### Parameters
 
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
-*   `additionalProperties` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
+*   `additionalProperties` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
 
 ### updateAttributes
 
@@ -521,7 +529,7 @@ Takes values from options.
 
 #### Parameters
 
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
 *   `additionalProperties`  
 
 ### update
@@ -562,7 +570,7 @@ Check for equality
 
 #### Parameters
 
-*   `other` **[BaseObject](#baseobject)** 
+*   `other` **([BaseObject](#baseobject) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** 
 
 Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true if other is present
 
@@ -619,7 +627,7 @@ Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Globa
 
 #### Parameters
 
-*   `other`  
+*   `other` **any** 
 
 Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true if other provider is the same as the receiver
 
@@ -633,6 +641,7 @@ For github something like:
 *   git+ssh://github.com
 *   <https://github.com>
 *   git+<https://github.com>
+    By default we provide provider name with ':'.
 
 Returns **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** common base urls of all repositories
 
@@ -642,14 +651,14 @@ Does the provider support the base name.
 
 #### Parameters
 
-*   `base` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** to be checked
+*   `base` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** to be checked
 
 Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true if base is supported or base is undefined
 
 ### normalizeRepositoryName
 
 Bring a repository name into its normal form by removing any clutter.
-like .git suffix or #branch names.
+Like .git suffix or #branch names.
 
 #### Parameters
 
@@ -661,7 +670,7 @@ Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 ### normalizeGroupName
 
 Bring a group name into its normal form by removing any clutter.
-like .git suffix or #branch names.
+Like .git suffix or #branch names.
 
 #### Parameters
 
@@ -673,14 +682,14 @@ Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 ### areRepositoryNamesCaseSensitive
 
 Are repository names case sensitive.
-Overwrite and return false if you want to have case insensitive repository lookup
+Overwrite and return false if you want to have case insensitive repository lookup.
 
 Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true
 
 ### areGroupNamesCaseSensitive
 
 Are repositroy group names case sensitive.
-Overwrite and return false if you want to have case insensitive group lookup
+Overwrite and return false if you want to have case insensitive group lookup.
 
 Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true
 
@@ -691,7 +700,7 @@ base, group, repository and branch.
 
 #### Parameters
 
-*   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+*   `name` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 *   `focus` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** where lies the focus if only one path component is given (optional, default `"repository"`)
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** with separated attributes
@@ -703,7 +712,7 @@ Create a repository.
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of group and repository
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Repository](#repository)>**&#x20;
 
@@ -714,7 +723,7 @@ List provider objects of a given type.
 #### Parameters
 
 *   `type` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** name of the method to deliver typed iterator projects,milestones,hooks,repositories,branches,tags
-*   `patterns` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>)** group / repository filter
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** group / repository filter
 
 ### projects
 
@@ -722,7 +731,7 @@ List projects.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Project](#project)>** all matching projects of the provider
 
@@ -732,7 +741,7 @@ List milestones.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Milestone](#milestone)>** all matching milestones of the provider
 
@@ -742,7 +751,7 @@ List repositories.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Repository](#repository)>** all matching repos of the provider
 
@@ -752,7 +761,7 @@ List branches.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Branch](#branch)>** all matching branches of the provider
 
@@ -762,7 +771,7 @@ List tags.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Tag](#tag)>** all matching tags of the provider
 
@@ -772,7 +781,7 @@ List hooks.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Hook](#hook)>** all matching hooks of the provider
 
@@ -782,7 +791,7 @@ List pull requests.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[PullRequest](#pullrequest)>** all matching pullRequests of the provider
 
@@ -805,48 +814,37 @@ return {object}
 
 ### repositoryGroupClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** repository group class used by the Provider
-
 ### hookClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** hook class used by the Provider
-
 ### repositoryClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** repository class used by the Provider
-
 ### branchClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** branch class used by the Provider
-
 ### tagClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** branch class used by the Provider
-
 ### entryClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** entry class used by the Provider
-
 ### pullRequestClass
 
-Returns **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** pull request class used by the Provider
-
 ### instanceIdentifier
 
+Prefix used to form environment variables.
+'GITHUB\_' -> 'GITHUB\_TOKEN'
+
 Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** identifier for environment options
 
 ### optionsFromEnvironment
 
-Extract options suitable for the constructor
-form the given set of environment variables.
+Extract options suitable for the constructor.
+Form the given set of environment variables.
 Object with the detected key value pairs is delivered.
 
 #### Parameters
 
-*   `env` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** as from process.env
+*   `env` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** as from process.env
 *   `instanceIdentifier` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** part of variable name. (optional, default `this.instanceIdentifier`)
 
-Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** undefined if no suitable environment variables have been found
+Returns **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** undefined if no suitable environment variables have been found
 
 ### areOptionsSufficcient
 
@@ -869,7 +867,7 @@ Creates a new provider for a given set of options.
     *   `options.instanceIdentifier` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** name of the provider instance
 *   `env` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** taken from process.env
 
-Returns **[BaseProvider](#baseprovider)** newly created provider or undefined if options are not sufficient to construct a provider
+Returns **([BaseProvider](#baseprovider) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** newly created provider or undefined if options are not sufficient to construct a provider
 
 ## name
 
@@ -983,7 +981,7 @@ Simply calls Repository.createBranch() with the receiver as source branch
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** the new branch
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** passed through
 
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Branch](#branch)>** newly created branch (or already present old one with the same name)
 
@@ -1037,7 +1035,7 @@ Lookup a repository in the provider and all of its repository groups.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the repository
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Repository](#repository)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Repository](#repository) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### branch
 
@@ -1047,7 +1045,7 @@ Lookup a branch.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the branch
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Branch](#branch)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Branch](#branch) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### repositoryGroup
 
@@ -1057,7 +1055,7 @@ Lookup a repository group.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the group
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[RepositoryGroup](#repositorygroup)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([RepositoryGroup](#repositorygroup) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### repositoryGroups
 
@@ -1077,7 +1075,7 @@ If there is already a group for the given name it will be returend instead
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the group
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[RepositoryGroup](#repositorygroup)>**&#x20;
 
@@ -1088,7 +1086,7 @@ Add a new repository group (not provider specific actions are executed).
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the group
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[RepositoryGroup](#repositorygroup)**&#x20;
 
@@ -1101,8 +1099,8 @@ Object with a name.
 ### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
-*   `additionalProperties` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
+*   `additionalProperties` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 ### Properties
 
@@ -1449,7 +1447,7 @@ List entries of the branch.
 
 #### Parameters
 
-*   `matchingPatterns` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>?**&#x20;
+*   `matchingPatterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))?**&#x20;
 
 Returns **AsyncIterator<[ContentEntry](#contententry)>** all matching entries in the branch
 
@@ -1467,7 +1465,7 @@ Get exactly one matching entry by name or undefine if no such entry is found.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[ContentEntry](#contententry)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([ContentEntry](#contententry) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### entry
 
@@ -1559,7 +1557,7 @@ Abstract repository collection.
 
 *   `provider` **[BaseProvider](#baseprovider)**&#x20;
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the group
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
     *   `options.description` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** human readable description
     *   `options.id` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** internal id
@@ -1591,7 +1589,7 @@ Mixin to define a class able to handle a collection of repositories.
 
 ### Parameters
 
-*   `base` **Class** to be extendet
+*   `base` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** to be extendet
 
 ## Repository
 
@@ -1601,7 +1599,7 @@ Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Globa
 
 *   `owner` **[RepositoryOwner](#repositoryowner)**&#x20;
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** (#branch) will be removed
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
     *   `options.description` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** human readable description
     *   `options.id` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** internal id
@@ -1642,7 +1640,7 @@ List entries of the default branch.
 
 #### Parameters
 
-*   `matchingPatterns` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**&#x20;
+*   `matchingPatterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
 
 Returns **AsyncIterator<[ContentEntry](#contententry)>** all matching entries in the branch
 
@@ -1654,7 +1652,7 @@ Get exactly one matching entry by name or undefined if no such entry is found.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[ContentEntry](#contententry)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([ContentEntry](#contententry) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### commits
 
@@ -1662,7 +1660,7 @@ List commits of the default branch.
 
 #### Parameters
 
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[Commit](#commit)>** all matching commits in the repository
 
@@ -1719,7 +1717,7 @@ Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/
 
 Lookup the default branch.
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Branch](#branch)>** branch named after defaultBranchName
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Branch](#branch) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** branch named after defaultBranchName
 
 ### branch
 
@@ -1729,7 +1727,7 @@ Lookup branch by name.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Branch](#branch)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Branch](#branch) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### hasBranches
 
@@ -1739,7 +1737,7 @@ Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/
 
 #### Parameters
 
-*   `patterns` &#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
 
 Returns **AsyncIterator<[Branch](#branch)>** of all branches
 
@@ -1751,7 +1749,7 @@ Create a new [Branch](#branch) by cloning a given source branch.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the new branch
 *   `source` **[Branch](#branch)** branch defaults to the defaultBranch
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Branch](#branch)>** newly created branch (or already present old one with the same name)
 
@@ -1763,7 +1761,7 @@ Internal branch creation does not call repository.initialize()
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the new branch
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** to be passed to the branch
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** to be passed to the branch
 
 Returns **[Branch](#branch)** newly created branch
 
@@ -1791,7 +1789,7 @@ Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/
 
 #### Parameters
 
-*   `patterns` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>)**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
 
 Returns **AsyncIterator<[Tag](#tag)>** of all tags
 
@@ -1803,7 +1801,7 @@ Internal tag creation does not call repository.initialize()
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the new tag
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Tag](#tag)** newly created tag
 
@@ -1815,7 +1813,7 @@ Create a pull request (or deliver an already present for the given name).
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the pr
 *   `source` **[Branch](#branch)** branch
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[PullRequest](#pullrequest)>**&#x20;
 
@@ -1827,7 +1825,7 @@ Add a pull request.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 *   `source` **[Branch](#branch)**&#x20;
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[PullRequest](#pullrequest)**&#x20;
 
@@ -1839,13 +1837,13 @@ Returns **AsyncIterator<[PullRequest](#pullrequest)>** of all pull requests
 
 ### pullRequest
 
-The @{link PullRequest} for a given name.
+The @see [PullRequest](#pullrequest) for a given name.
 
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[PullRequest](#pullrequest)>**&#x20;
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([PullRequest](#pullrequest) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>**&#x20;
 
 ### deletePullRequest
 
@@ -1864,7 +1862,7 @@ Add a new [Hook](#hook).
 #### Parameters
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** of the new hoook name
-*   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
+*   `options` **([Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **[Hook](#hook)** newly created hook
 
@@ -1890,7 +1888,37 @@ Get a Hook.
 
 *   `id` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number))**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Hook](#hook)>** for the given id
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Hook](#hook) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** for the given id
+
+### milestone
+
+Get a Milestone.
+
+#### Parameters
+
+*   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Milestone](#milestone) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** for the given name
+
+### project
+
+Get a Project.
+
+#### Parameters
+
+*   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Project](#project) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** for the given name
+
+### application
+
+Get an Application.
+
+#### Parameters
+
+*   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([Application](#application) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** for the given name
 
 ### type
 
@@ -1906,7 +1934,7 @@ Get sha of a ref.
 
 *   `ref` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** sha of the ref
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** sha of the ref
 
 ### attributes
 
@@ -1954,7 +1982,7 @@ List groups.
 
 #### Parameters
 
-*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+*   `patterns` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 
 Returns **AsyncIterator<[RepositoryGroup](#repositorygroup)>** always deliver the one and only present group
 
@@ -1975,7 +2003,7 @@ The value undefined will be represented as an empty array.
 
 ### Parameters
 
-*   `value` **(any | [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array))**&#x20;
+*   `value` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array) | any)**&#x20;
 
 Returns **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)** value encapsulated in an array
 
@@ -1986,11 +2014,11 @@ A URL auth component will be removed to.
 
 ### Parameters
 
-*   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+*   `name` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 *   `repositoryBases` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** all possible bases
 *   `whenFound` **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)?** to be called with the found base name
 
-Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** name without base
+Returns **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** name without base
 
 ## stripBaseNames
 
@@ -1998,7 +2026,7 @@ Loops over names and executes stripBaseName.
 
 ### Parameters
 
-*   `names` **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>)**&#x20;
+*   `names` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**&#x20;
 *   `repositoryBases` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** all possible bases
 *   `whenFound` **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)?** to be called with the found base name
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repository-provider",
-  "version": "32.7.13",
+  "version": "32.7.14",
   "publishConfig": {
     "access": "public"
   },
@@ -30,14 +30,14 @@
     "lint:tsc": "tsc --allowJs --checkJs --noEmit -t esnext -m esnext --moduleResolution nodenext ./src/*.mjs"
   },
   "dependencies": {
-    "matching-iterator": "^2.0.11"
+    "matching-iterator": "^2.0.12"
   },
   "devDependencies": {
     "ava": "^5.2.0",
     "browser-ava": "^1.3.38",
     "c8": "^7.13.0",
     "documentation": "^14.0.1",
-    "repository-provider-test-support": "^2.3.3",
+    "repository-provider-test-support": "^2.3.4",
     "semantic-release": "^21.0.2",
     "typescript": "^5.0.4"
   },

package/src/base-object.mjs

@@ -127,7 +127,7 @@ import { description_attribute, id_attribute } from "./attributes.mjs";
 
   /**
    * Check for equality
-   * @param {BaseObject} other
+   * @param {BaseObject|undefined} other
    * @return {boolean} true if other is present
    */
   equals(other) {

package/src/base-provider.mjs

@@ -35,6 +35,8 @@ export class BaseProvider extends BaseObject {
   }
 
   /**
+   * Prefix used to form environment variables.
+   * 'GITHUB_' -> 'GITHUB_TOKEN'
    * @return {string} identifier for environment options
    */
   static get instanceIdentifier() {
@@ -42,10 +44,10 @@ export class BaseProvider extends BaseObject {
   }
 
   /**
-   * Extract options suitable for the constructor
-   * form the given set of environment variables.
+   * Extract options suitable for the constructor.
+   * Form the given set of environment variables.
    * Object with the detected key value pairs is delivered.
-   * @param {Object} env as from process.env
+   * @param {Object|undefined} env as from process.env
    * @param {string} instanceIdentifier part of variable name.
    * @return {Object|undefined} undefined if no suitable environment variables have been found
    */
@@ -152,6 +154,7 @@ export class BaseProvider extends BaseObject {
   }
 
   /**
+   * @param {*} other 
    * @return {boolean} true if other provider is the same as the receiver
    */
   equals(other) {
@@ -166,6 +169,7 @@ export class BaseProvider extends BaseObject {
    * - git+ssh://github.com
    * - https://github.com
    * - git+https://github.com
+   * By default we provide provider name with ':'.
    * @return {string[]} common base urls of all repositories
    */
   get repositoryBases() {
@@ -174,7 +178,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * Does the provider support the base name.
-   * @param {string} base to be checked
+   * @param {string|undefined} base to be checked
    * @return {boolean} true if base is supported or base is undefined
    */
   supportsBase(base) {
@@ -183,7 +187,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * Bring a repository name into its normal form by removing any clutter.
-   * like .git suffix or #branch names.
+   * Like .git suffix or #branch names.
    * @param {string} name
    * @param {boolean} forLookup
    * @return {string} normalized name
@@ -197,7 +201,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * Bring a group name into its normal form by removing any clutter.
-   * like .git suffix or #branch names.
+   * Like .git suffix or #branch names.
    * @param {string} name
    * @param {boolean} forLookup
    * @return {string} normalized name
@@ -211,7 +215,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * Are repository names case sensitive.
-   * Overwrite and return false if you want to have case insensitive repository lookup
+   * Overwrite and return false if you want to have case insensitive repository lookup.
    * @return {boolean} true
    */
   get areRepositoryNamesCaseSensitive() {
@@ -220,7 +224,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * Are repositroy group names case sensitive.
-   * Overwrite and return false if you want to have case insensitive group lookup
+   * Overwrite and return false if you want to have case insensitive group lookup.
    * @return {boolean} true
    */
   get areGroupNamesCaseSensitive() {
@@ -230,7 +234,7 @@ export class BaseProvider extends BaseObject {
   /**
    * Parses repository name and tries to split it into
    * base, group, repository and branch.
-   * @param {string} name
+   * @param {string|undefined} name
    * @param {string} focus where lies the focus if only one path component is given
    * @return {Object} with separated attributes
    */
@@ -288,7 +292,7 @@ export class BaseProvider extends BaseObject {
   /**
    * Create a repository.
    * @param {string} name of group and repository
-   * @param {Object} options
+   * @param {Object|undefined} options
    * @returns {Promise<Repository>}
    */
   async createRepository(name, options) {
@@ -301,7 +305,7 @@ export class BaseProvider extends BaseObject {
    * List provider objects of a given type.
    *
    * @param {string} type name of the method to deliver typed iterator projects,milestones,hooks,repositories,branches,tags
-   * @param {string[]|string} patterns group / repository filter
+   * @param {string[]|string|undefined} patterns group / repository filter
    */
   async *list(type, patterns) {
     if (patterns === undefined) {
@@ -324,7 +328,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List projects.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Project>} all matching projects of the provider
    */
   async *projects(patterns) {
@@ -333,7 +337,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List milestones.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Milestone>} all matching milestones of the provider
    */
   async *milestones(patterns) {
@@ -342,7 +346,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List repositories.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Repository>} all matching repos of the provider
    */
   async *repositories(patterns) {
@@ -351,7 +355,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List branches.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Branch>} all matching branches of the provider
    */
   async *branches(patterns) {
@@ -360,7 +364,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List tags.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Tag>} all matching tags of the provider
    */
   async *tags(patterns) {
@@ -369,7 +373,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List hooks.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<Hook>} all matching hooks of the provider
    */
   async *hooks(patterns) {
@@ -378,7 +382,7 @@ export class BaseProvider extends BaseObject {
 
   /**
    * List pull requests.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<PullRequest>} all matching pullRequests of the provider
    */
   async *pullRequests(patterns) {
@@ -444,49 +448,49 @@ export class BaseProvider extends BaseObject {
   }
 
   /**
-   * @return {Function} repository group class used by the Provider
+   * @return {typeof RepositoryGroup} repository group class used by the Provider
    */
   get repositoryGroupClass() {
     return RepositoryGroup;
   }
 
   /**
-   * @return {Function} hook class used by the Provider
+   * @return {typeof Hook} hook class used by the Provider
    */
   get hookClass() {
     return Hook;
   }
 
   /**
-   * @return {Function} repository class used by the Provider
+   * @return {typeof Repository} repository class used by the Provider
    */
   get repositoryClass() {
     return Repository;
   }
 
   /**
-   * @return {Function} branch class used by the Provider
+   * @return {typeof Branch} branch class used by the Provider
    */
   get branchClass() {
     return Branch;
   }
 
   /**
-   * @return {Function} branch class used by the Provider
+   * @return {typeof Tag} branch class used by the Provider
    */
   get tagClass() {
     return Tag;
   }
 
   /**
-   * @return {Function} entry class used by the Provider
+   * @return {typeof ContentEntry} entry class used by the Provider
    */
   get entryClass() {
     return undefined;
   }
 
   /**
-   * @return {Function} pull request class used by the Provider
+   * @return {typeof PullRequest} pull request class used by the Provider
    */
   get pullRequestClass() {
     return PullRequest;

package/src/branch.mjs

@@ -182,7 +182,7 @@ export class Branch extends Ref {
   /**
    * Create a pull request.
    * @param {Branch} toBranch
-   * @param {Object} options
+   * @param {Object|undefined} options
    * @return {Promise<PullRequest>}
    */
   async createPullRequest(toBranch, options) {

package/src/ref.mjs

@@ -54,7 +54,7 @@ export class Ref extends OwnedObject {
 
   /**
    * List entries of the branch.
-   * @param {string|string[]} [matchingPatterns]
+   * @param {string[]|string|undefined} [matchingPatterns]
    * @return {AsyncIterator<ContentEntry>} all matching entries in the branch
    */
   async *entries(matchingPatterns) {}

package/src/repository-owner.mjs

@@ -41,7 +41,7 @@ export function RepositoryOwner(base) {
 
     /**
      * Lookup a repository.
-     * @param {string} name of the repository may contain a #branch
+     * @param {string|undefined} name of the repository may contain a #branch
      * @return {Promise<Repository|undefined>}
      */
     async repository(name) {
@@ -53,7 +53,7 @@ export function RepositoryOwner(base) {
 
     /**
      * List repositories for the owner.
-     * @param {string[]|string} patterns
+     * @param {string[]|string|undefined} patterns
      * @return {AsyncIterator<Repository>} all matching repositories of the owner
      */
     async *repositories(patterns) {
@@ -84,10 +84,10 @@ export function RepositoryOwner(base) {
     /**
      * Lookup entity of a given type and name.
      * @param {string} type
-     * @param {string} name
+     * @param {string|undefined} name
      * @param {function} [split]
      * @param {Object} [defaultItem]
-     * @returns {Promise<NamedObject>} from a repository
+     * @returns {Promise<NamedObject|undefined>} from a repository
      */
     async lookup(type, name, split, defaultItem) {
       if (name !== undefined) {
@@ -147,7 +147,7 @@ export function RepositoryOwner(base) {
      * Create a new {@link Repository} in the provider.
      * If there is already if repository for the given name it will be returned.
      * @param {string} name
-     * @param {Object} options
+     * @param {Object|undefined} options
      * @return {Promise<Repository>} newly created repository (if not already present)
      */
     async createRepository(name, options) {
@@ -158,7 +158,7 @@ export function RepositoryOwner(base) {
      * Add a {@link Repository} to the group.
      * Only adds the repository to the in memory representation (does not execute any provider actions).
      * @param {string} name
-     * @param {Object} options
+     * @param {Object|undefined} options
      * @return {Promise<Repository>} newly created repository
      */
     addRepository(name, options) {

package/src/repository.mjs

@@ -97,6 +97,11 @@ export class Repository extends OwnedObject {
     return `${this.provider.url}${this.slug}`;
   }
 
+  get defaultBranchName()
+  {
+    return "master";
+  }
+
   /**
    * Lookup entries form the head of the default branch.
    * {@link Branch#entry}

package/src/single-group-provider.mjs

@@ -35,7 +35,7 @@ export class SingleGroupProvider extends RepositoryOwner(BaseProvider) {
 
   /**
    * List groups.
-   * @param {string[]|string} patterns
+   * @param {string[]|string|undefined} patterns
    * @return {AsyncIterator<RepositoryGroup>} always deliver the one and only present group
    */
   async *repositoryGroups(patterns) {