repository-provider 26.1.2 → 26.3.1

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2017-2021 by arlac77
+Copyright (c) 2017-2022 by arlac77
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

package/README.md

@@ -51,20 +51,22 @@ console.log(await readme.getString());
     *   [Properties](#properties)
 *   [definePropertiesFromOptions](#definepropertiesfromoptions)
     *   [Parameters](#parameters-1)
-*   [setAttribute](#setattribute)
+*   [defaultValues](#defaultvalues)
     *   [Parameters](#parameters-2)
-*   [getAttribute](#getattribute)
+*   [setAttribute](#setattribute)
     *   [Parameters](#parameters-3)
-*   [optionJSON](#optionjson)
+*   [getAttribute](#getattribute)
     *   [Parameters](#parameters-4)
-*   [mapAttributes](#mapattributes)
+*   [optionJSON](#optionjson)
     *   [Parameters](#parameters-5)
-*   [mapAttributesInverse](#mapattributesinverse)
+*   [mapAttributes](#mapattributes)
     *   [Parameters](#parameters-6)
-*   [BaseObject](#baseobject)
+*   [mapAttributesInverse](#mapattributesinverse)
     *   [Parameters](#parameters-7)
+*   [BaseObject](#baseobject)
+    *   [Parameters](#parameters-8)
     *   [equals](#equals)
-        *   [Parameters](#parameters-8)
+        *   [Parameters](#parameters-9)
     *   [attributes](#attributes)
     *   [writableAttributes](#writableattributes)
     *   [attributeMapping](#attributemapping)
@@ -74,129 +76,131 @@ console.log(await readme.getString());
 *   [avatarURL](#avatarurl)
 *   [homePageURL](#homepageurl)
 *   [MessageDestination](#messagedestination)
-    *   [Parameters](#parameters-9)
-*   [BaseProvider](#baseprovider)
     *   [Parameters](#parameters-10)
+*   [BaseProvider](#baseprovider)
+    *   [Parameters](#parameters-11)
     *   [Properties](#properties-1)
     *   [equals](#equals-1)
-        *   [Parameters](#parameters-11)
+        *   [Parameters](#parameters-12)
     *   [repositoryBases](#repositorybases)
     *   [normalizeRepositoryName](#normalizerepositoryname)
-        *   [Parameters](#parameters-12)
-    *   [normalizeGroupName](#normalizegroupname)
         *   [Parameters](#parameters-13)
+    *   [normalizeGroupName](#normalizegroupname)
+        *   [Parameters](#parameters-14)
     *   [areRepositoryNamesCaseSensitive](#arerepositorynamescasesensitive)
     *   [areGroupNamesCaseSensitive](#aregroupnamescasesensitive)
     *   [supportsBase](#supportsbase)
-        *   [Parameters](#parameters-14)
-    *   [parseName](#parsename)
         *   [Parameters](#parameters-15)
-    *   [list](#list)
+    *   [parseName](#parsename)
         *   [Parameters](#parameters-16)
-    *   [projects](#projects)
+    *   [createRepository](#createrepository)
         *   [Parameters](#parameters-17)
-    *   [milestones](#milestones)
+    *   [list](#list)
         *   [Parameters](#parameters-18)
-    *   [repositories](#repositories)
+    *   [projects](#projects)
         *   [Parameters](#parameters-19)
-    *   [branches](#branches)
+    *   [milestones](#milestones)
         *   [Parameters](#parameters-20)
-    *   [tags](#tags)
+    *   [repositories](#repositories)
         *   [Parameters](#parameters-21)
-    *   [hooks](#hooks)
+    *   [branches](#branches)
         *   [Parameters](#parameters-22)
-    *   [pullRequests](#pullrequests)
+    *   [tags](#tags)
         *   [Parameters](#parameters-23)
-    *   [repositoryGroupClass](#repositorygroupclass)
-    *   [hookClass](#hookclass)
+    *   [hooks](#hooks)
+        *   [Parameters](#parameters-24)
+    *   [pullRequests](#pullrequests)
+        *   [Parameters](#parameters-25)
     *   [name](#name)
     *   [provider](#provider)
     *   [url](#url)
     *   [toJSON](#tojson)
+    *   [repositoryGroupClass](#repositorygroupclass)
+    *   [hookClass](#hookclass)
     *   [repositoryClass](#repositoryclass)
     *   [branchClass](#branchclass)
     *   [entryClass](#entryclass)
     *   [pullRequestClass](#pullrequestclass)
     *   [instanceIdentifier](#instanceidentifier)
     *   [optionsFromEnvironment](#optionsfromenvironment)
-        *   [Parameters](#parameters-24)
+        *   [Parameters](#parameters-26)
     *   [areOptionsSufficcient](#areoptionssufficcient)
-        *   [Parameters](#parameters-25)
+        *   [Parameters](#parameters-27)
     *   [initialize](#initialize)
-        *   [Parameters](#parameters-26)
+        *   [Parameters](#parameters-28)
 *   [priority](#priority)
 *   [name](#name-1)
 *   [messageDestination](#messagedestination-1)
 *   [Commit](#commit)
     *   [Properties](#properties-2)
 *   [Commit](#commit-1)
-    *   [Parameters](#parameters-27)
+    *   [Parameters](#parameters-29)
     *   [Properties](#properties-3)
 *   [CommitResult](#commitresult)
     *   [Properties](#properties-4)
 *   [Branch](#branch)
-    *   [Parameters](#parameters-28)
+    *   [Parameters](#parameters-30)
     *   [Properties](#properties-5)
     *   [url](#url-1)
     *   [refType](#reftype)
     *   [isDefault](#isdefault)
     *   [delete](#delete)
     *   [commit](#commit-2)
-        *   [Parameters](#parameters-29)
+        *   [Parameters](#parameters-31)
     *   [commitIntoPullRequest](#commitintopullrequest)
-        *   [Parameters](#parameters-30)
+        *   [Parameters](#parameters-32)
     *   [removeEntries](#removeentries)
-        *   [Parameters](#parameters-31)
+        *   [Parameters](#parameters-33)
     *   [entryClass](#entryclass-1)
     *   [createPullRequest](#createpullrequest)
-        *   [Parameters](#parameters-32)
+        *   [Parameters](#parameters-34)
     *   [pullRequestClass](#pullrequestclass-1)
     *   [createBranch](#createbranch)
-        *   [Parameters](#parameters-33)
+        *   [Parameters](#parameters-35)
 *   [Hook](#hook)
-    *   [Parameters](#parameters-34)
+    *   [Parameters](#parameters-36)
     *   [Properties](#properties-6)
     *   [equals](#equals-2)
-        *   [Parameters](#parameters-35)
+        *   [Parameters](#parameters-37)
     *   [toJSON](#tojson-1)
 *   [Issue](#issue)
-    *   [Parameters](#parameters-36)
+    *   [Parameters](#parameters-38)
 *   [Milestone](#milestone)
-    *   [Parameters](#parameters-37)
+    *   [Parameters](#parameters-39)
 *   [MultiGroupProvider](#multigroupprovider)
-    *   [Parameters](#parameters-38)
+    *   [Parameters](#parameters-40)
     *   [repository](#repository)
-        *   [Parameters](#parameters-39)
+        *   [Parameters](#parameters-41)
     *   [repositoryGroup](#repositorygroup)
-        *   [Parameters](#parameters-40)
+        *   [Parameters](#parameters-42)
     *   [repositoryGroups](#repositorygroups)
-        *   [Parameters](#parameters-41)
+        *   [Parameters](#parameters-43)
     *   [createRepositoryGroup](#createrepositorygroup)
-        *   [Parameters](#parameters-42)
+        *   [Parameters](#parameters-44)
     *   [addRepositoryGroup](#addrepositorygroup)
-        *   [Parameters](#parameters-43)
+        *   [Parameters](#parameters-45)
 *   [NamedObject](#namedobject)
-    *   [Parameters](#parameters-44)
+    *   [Parameters](#parameters-46)
     *   [Properties](#properties-7)
     *   [equals](#equals-3)
-        *   [Parameters](#parameters-45)
+        *   [Parameters](#parameters-47)
     *   [displayName](#displayname)
     *   [update](#update)
     *   [toJSON](#tojson-2)
 *   [Project](#project)
-    *   [Parameters](#parameters-46)
+    *   [Parameters](#parameters-48)
 *   [PullRequest](#pullrequest)
-    *   [Parameters](#parameters-47)
+    *   [Parameters](#parameters-49)
     *   [Properties](#properties-8)
     *   [fullName](#fullname)
     *   [url](#url-2)
     *   [repository](#repository-1)
     *   [provider](#provider-1)
     *   [equals](#equals-4)
-        *   [Parameters](#parameters-48)
+        *   [Parameters](#parameters-50)
     *   [delete](#delete-1)
     *   [merge](#merge)
-        *   [Parameters](#parameters-49)
+        *   [Parameters](#parameters-51)
     *   [decline](#decline)
     *   [reviews](#reviews)
     *   [identifier](#identifier)
@@ -204,9 +208,9 @@ console.log(await readme.getString());
     *   [defaultListStates](#defaultliststates)
     *   [validMergeMethods](#validmergemethods)
     *   [list](#list-1)
-        *   [Parameters](#parameters-50)
+        *   [Parameters](#parameters-52)
     *   [open](#open)
-        *   [Parameters](#parameters-51)
+        *   [Parameters](#parameters-53)
 *   [title](#title)
 *   [body](#body)
 *   [state](#state)
@@ -216,19 +220,19 @@ console.log(await readme.getString());
 *   [ContentEntry](#contententry)
     *   [Properties](#properties-9)
 *   [Ref](#ref)
-    *   [Parameters](#parameters-52)
+    *   [Parameters](#parameters-54)
     *   [equals](#equals-5)
-        *   [Parameters](#parameters-53)
+        *   [Parameters](#parameters-55)
     *   [ref](#ref-1)
     *   [refId](#refid)
-        *   [Parameters](#parameters-54)
+        *   [Parameters](#parameters-56)
     *   [entries](#entries)
-        *   [Parameters](#parameters-55)
+        *   [Parameters](#parameters-57)
     *   [asyncIterator](#asynciterator)
     *   [maybeEntry](#maybeentry)
-        *   [Parameters](#parameters-56)
+        *   [Parameters](#parameters-58)
     *   [entry](#entry)
-        *   [Parameters](#parameters-57)
+        *   [Parameters](#parameters-59)
     *   [provider](#provider-2)
     *   [owner](#owner)
     *   [fullName](#fullname-1)
@@ -244,7 +248,7 @@ console.log(await readme.getString());
     *   [attributes](#attributes-1)
 *   [isProtected](#isprotected-1)
 *   [RepositoryGroup](#repositorygroup-1)
-    *   [Parameters](#parameters-58)
+    *   [Parameters](#parameters-60)
     *   [Properties](#properties-10)
     *   [repositoryClass](#repositoryclass-1)
     *   [branchClass](#branchclass-1)
@@ -255,22 +259,22 @@ console.log(await readme.getString());
 *   [type](#type)
 *   [url](#url-3)
 *   [RepositoryOwner](#repositoryowner)
-    *   [Parameters](#parameters-59)
+    *   [Parameters](#parameters-61)
 *   [Repository](#repository-2)
-    *   [Parameters](#parameters-60)
+    *   [Parameters](#parameters-62)
     *   [Properties](#properties-11)
     *   [fullName](#fullname-2)
     *   [slug](#slug)
     *   [provider](#provider-3)
     *   [identifier](#identifier-2)
     *   [equals](#equals-6)
-        *   [Parameters](#parameters-61)
+        *   [Parameters](#parameters-63)
     *   [entry](#entry-1)
-        *   [Parameters](#parameters-62)
+        *   [Parameters](#parameters-64)
     *   [entries](#entries-1)
-        *   [Parameters](#parameters-63)
+        *   [Parameters](#parameters-65)
     *   [maybeEntry](#maybeentry-1)
-        *   [Parameters](#parameters-64)
+        *   [Parameters](#parameters-66)
     *   [urls](#urls)
     *   [url](#url-4)
     *   [cloneURL](#cloneurl)
@@ -282,40 +286,40 @@ console.log(await readme.getString());
     *   [isDisabled](#isdisabled-1)
     *   [isTemplate](#istemplate)
     *   [branch](#branch-1)
-        *   [Parameters](#parameters-65)
+        *   [Parameters](#parameters-67)
     *   [defaultBranch](#defaultbranch)
     *   [branches](#branches-1)
-        *   [Parameters](#parameters-66)
+        *   [Parameters](#parameters-68)
     *   [createBranch](#createbranch-1)
-        *   [Parameters](#parameters-67)
+        *   [Parameters](#parameters-69)
     *   [addBranch](#addbranch)
-        *   [Parameters](#parameters-68)
+        *   [Parameters](#parameters-70)
     *   [deleteBranch](#deletebranch)
-        *   [Parameters](#parameters-69)
+        *   [Parameters](#parameters-71)
     *   [tags](#tags-1)
-        *   [Parameters](#parameters-70)
+        *   [Parameters](#parameters-72)
     *   [tag](#tag)
-        *   [Parameters](#parameters-71)
+        *   [Parameters](#parameters-73)
     *   [delete](#delete-2)
     *   [createPullRequest](#createpullrequest-1)
-        *   [Parameters](#parameters-72)
+        *   [Parameters](#parameters-74)
     *   [addPullRequest](#addpullrequest)
-        *   [Parameters](#parameters-73)
+        *   [Parameters](#parameters-75)
     *   [pullRequests](#pullrequests-1)
     *   [pullRequest](#pullrequest-1)
-        *   [Parameters](#parameters-74)
+        *   [Parameters](#parameters-76)
     *   [deletePullRequest](#deletepullrequest)
-        *   [Parameters](#parameters-75)
+        *   [Parameters](#parameters-77)
     *   [addHook](#addhook)
-        *   [Parameters](#parameters-76)
+        *   [Parameters](#parameters-78)
     *   [createHook](#createhook)
-        *   [Parameters](#parameters-77)
+        *   [Parameters](#parameters-79)
     *   [hooks](#hooks-1)
     *   [hook](#hook-1)
-        *   [Parameters](#parameters-78)
+        *   [Parameters](#parameters-80)
     *   [type](#type-1)
     *   [refId](#refid-1)
-        *   [Parameters](#parameters-79)
+        *   [Parameters](#parameters-81)
     *   [repositoryClass](#repositoryclass-2)
     *   [pullRequestClass](#pullrequestclass-3)
     *   [branchClass](#branchclass-2)
@@ -329,23 +333,23 @@ console.log(await readme.getString());
 *   [Review](#review)
 *   [SingleGroupProvider](#singlegroupprovider)
     *   [repository](#repository-3)
-        *   [Parameters](#parameters-80)
+        *   [Parameters](#parameters-82)
     *   [repositoryGroup](#repositorygroup-2)
-        *   [Parameters](#parameters-81)
+        *   [Parameters](#parameters-83)
     *   [repositoryGroups](#repositorygroups-1)
-        *   [Parameters](#parameters-82)
+        *   [Parameters](#parameters-84)
 *   [Tag](#tag-1)
-    *   [Parameters](#parameters-83)
+    *   [Parameters](#parameters-85)
     *   [refType](#reftype-1)
     *   [isWritable](#iswritable-1)
 *   [asArray](#asarray)
-    *   [Parameters](#parameters-84)
+    *   [Parameters](#parameters-86)
 *   [stripBaseName](#stripbasename)
-    *   [Parameters](#parameters-85)
+    *   [Parameters](#parameters-87)
 *   [stripBaseNames](#stripbasenames)
-    *   [Parameters](#parameters-86)
+    *   [Parameters](#parameters-88)
 *   [generateBranchName](#generatebranchname)
-    *   [Parameters](#parameters-87)
+    *   [Parameters](#parameters-89)
 
 ## Application
 
@@ -397,6 +401,17 @@ Object.definedProperties(new aClass(),{ with_default: { value: 77 }})
 *   `properties` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** object properties (optional, default `{}`)
 *   `attributes` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**  (optional, default `object.constructor.attributes`)
 
+## defaultValues
+
+Get default values.
+
+### Parameters
+
+*   `attributes` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `object`  
+
+Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** filled with default values
+
 ## setAttribute
 
 Set Object attribute.
@@ -553,7 +568,7 @@ Returns **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/
 
 ### repositoryBases
 
-All possible base urls.
+All supported base urls.
 For github something like:
 
 *   <git@github.com>
@@ -624,6 +639,17 @@ base, group, repository and branch.
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** with separated attributes
 
+### createRepository
+
+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)** 
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Repository](#repository)>** 
+
 ### list
 
 List provider objects of a given type.
@@ -703,14 +729,6 @@ List pull requests.
 
 Returns **AsyncIterator<[PullRequest](#pullrequest)>** all matching pullRequests of the provider
 
-### repositoryGroupClass
-
-Returns **Class** repository group class used by the Provider
-
-### hookClass
-
-Returns **Class** hook class used by the Provider
-
 ### name
 
 Deliver the provider name.
@@ -732,6 +750,14 @@ Returns **any** url otf the provider.
 List all defined entries from attributes.
 return {object}
 
+### repositoryGroupClass
+
+Returns **Class** repository group class used by the Provider
+
+### hookClass
+
+Returns **Class** hook class used by the Provider
+
 ### repositoryClass
 
 Returns **Class** repository class used by the Provider
@@ -782,7 +808,7 @@ Creates a new provider for a given set of options.
 
 *   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** additional options (optional, default `{}`)
 
-    *   `options.instanceIdentifier` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
+    *   `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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repository-provider",
-  "version": "26.1.2",
+  "version": "26.3.1",
   "publishConfig": {
     "access": "public"
   },
@@ -33,15 +33,15 @@
     "matching-iterator": "^2.0.0"
   },
   "devDependencies": {
-    "ava": "^3.15.0",
+    "ava": "^4.0.1",
     "c8": "^7.11.0",
     "documentation": "^13.2.5",
-    "repository-provider-test-support": "^1.9.1",
-    "semantic-release": "^18.0.1",
-    "typescript": "^4.6.0-dev.20211231"
+    "repository-provider-test-support": "^1.9.8",
+    "semantic-release": "^19.0.2",
+    "typescript": "^4.6.0-dev.20220124"
   },
   "engines": {
-    "node": ">=14.18.1"
+    "node": ">=14.18.3"
   },
   "repository": {
     "type": "git",

package/src/base-object.mjs

@@ -71,6 +71,11 @@ export class BaseObject {
     );
   }
 
+  /**
+   * Save object attributes in the backing store.
+   */
+  async update() {}
+
   /**
    * Check for equality
    * @param {BaseObject} other
@@ -79,4 +84,36 @@ export class BaseObject {
   equals(other) {
     return other !== undefined;
   }
+
+  /**
+   * The provider we live in.
+   * @return {BaseProvider}
+   */
+  get provider() {
+    return this.owner.provider;
+  }
+
+  /**
+   * Forwarded to the owner.
+   * @param  {...any} args
+   */
+  info(...args) {
+    return this.owner.info(...args);
+  }
+
+  /**
+   * Forwarded to the owner.
+   * @param  {...any} args
+   */
+  warn(...args) {
+    return this.owner.warn(...args);
+  }
+
+  /**
+   * Forwarded to the owner.
+   * @param  {...any} args
+   */
+  error(...args) {
+    return this.owner.error(...args);
+  }
 }

package/src/base-provider.mjs

@@ -482,6 +482,13 @@ export class BaseProvider {
     return Branch;
   }
 
+  /**
+   * @return {Class} branch class used by the Provider
+   */
+  get tagClass() {
+    return Tag;
+  }
+
   /**
    * @return {Class} entry class used by the Provider
    */

package/src/branch.mjs

@@ -82,6 +82,7 @@ export class Branch extends Ref {
    * @param {boolean} options.dry do not create a branch and do not commit only create dummy PR
    * @param {boolean} options.skipWithoutCommits do not create a PR if no commits are given
    * @param {boolean} options.bodyFromCommitMessages generate body from commit messages
+   * @param {string} [options.body] body of the PR
    * @return {Promise<PullRequest>}
    */
   async commitIntoPullRequest(commits, options) {

package/src/hook.mjs

@@ -36,6 +36,11 @@ export class Hook extends BaseObject {
     repository._addHook(this);
   }
 
+  get owner()
+  {
+    return this.repository;
+  }
+
   get fullName() {
     return `${this.repository.fullName}/${this.id}`;
   }
@@ -59,16 +64,4 @@ export class Hook extends BaseObject {
   toJSON() {
     return optionJSON(this, { id: this.id, events: [...this.events] });
   }
-
-  info(...args) {
-    return this.repository.info(...args);
-  }
-
-  warn(...args) {
-    return this.repository.warn(...args);
-  }
-
-  error(...args) {
-    return this.repository.error(...args);
-  }
 }

package/src/named-object.mjs

@@ -34,13 +34,6 @@ export class NamedObject extends BaseObject {
     return this.name;
   }
 
-  /**
-   * Save object attributes in the backing store.
-   */
-  async update()
-  {
-  }
-
   toString() {
     return this.name;
   }

package/src/ref.mjs

@@ -96,14 +96,6 @@ export class Ref extends NamedObject {
     return e;
   }
 
-  /**
-   * The provider we live in.
-   * @return {BaseProvider}
-   */
-  get provider() {
-    return this.repository.provider;
-  }
-
   /**
    * Branch owner.
    * By default we provide the repository owner
@@ -208,16 +200,4 @@ export class Ref extends NamedObject {
       !this.isProtected
     );
   }
-
-  info(...args) {
-    return this.repository.info(...args);
-  }
-
-  warn(...args) {
-    return this.repository.warn(...args);
-  }
-
-  error(...args) {
-    return this.repository.error(...args);
-  }
 }

package/src/repository-group.mjs

@@ -49,6 +49,11 @@ export class RepositoryGroup extends RepositoryOwner(NamedObject) {
     });
   }
 
+  get owner()
+  {
+    return this.provider;
+  }
+
   get isAdmin() {
     return false;
   }
@@ -77,6 +82,14 @@ export class RepositoryGroup extends RepositoryOwner(NamedObject) {
     return this.provider.branchClass;
   }
 
+  /**
+   * By default we use the providers implementation.
+   * @return {Class} as defined in the provider
+   */
+  get tagClass() {
+    return this.provider.tagClass;
+  }
+
   /**
    * By default we use the providers implementation.
    * @return {Class} as defined in the provider
@@ -100,16 +113,4 @@ export class RepositoryGroup extends RepositoryOwner(NamedObject) {
   get hookClass() {
     return this.provider.hookClass;
   }
-
-  info(...args) {
-    return this.provider.info(...args);
-  }
-
-  warn(...args) {
-    return this.provider.warn(...args);
-  }
-
-  error(...args) {
-    return this.provider.error(...args);
-  }
 }

package/src/repository.mjs

@@ -42,7 +42,7 @@ export class Repository extends NamedObject {
        * URLs of the repository
        * @return {string[]}
        */
-      urls: { },
+      urls: {},
 
       cloneURL: { type: "url" },
 
@@ -229,6 +229,14 @@ export class Repository extends NamedObject {
     return false;
   }
 
+  /**
+   * Lookup the default branch.
+   * @return {Promise<Branch>} branch named after defaultBranchName
+   */
+  get defaultBranch() {
+    return this.branch(this.defaultBranchName);
+  }
+
   /**
    * Lookup branch by name.
    * @param {string} name
@@ -239,14 +247,6 @@ export class Repository extends NamedObject {
     return this._branches.get(name);
   }
 
-  /**
-   * Lookup the default branch.
-   * @return {Promise<Branch>} branch named after defaultBranchName
-   */
-  get defaultBranch() {
-    return this.branch(this.defaultBranchName);
-  }
-
   /**
    * @return {AsyncIterator<Branch>} of all branches
    */
@@ -274,7 +274,7 @@ export class Repository extends NamedObject {
    * Internal branch creation does not call repository.initialize()
    * @param {string} name of the new branch
    * @param {Object} options
-   * @return {Promise<Branch>} newly created branch
+   * @return {Branch} newly created branch
    */
   addBranch(name, options) {
     let branch = this._branches.get(name);
@@ -298,8 +298,14 @@ export class Repository extends NamedObject {
     this._branches.delete(name);
   }
 
-  _addTag(tag) {
-    this._tags.set(tag.name, tag);
+  /**
+   * Get a Tag.
+   * @param {string} name
+   * @return {Promise<Tag>}
+   */
+  async tag(name) {
+    await this.initializeTags();
+    return this._tags.get(name);
   }
 
   /**
@@ -315,13 +321,23 @@ export class Repository extends NamedObject {
   }
 
   /**
-   * Get a Tag.
-   * @param {string} name
-   * @return {Promise<Tag>}
+   * Add a new {@link Tag}.
+   * Internal tag creation does not call repository.initialize()
+   * @param {string} name of the new tag
+   * @param {Object} options
+   * @return {Tag} newly created tag
    */
-  async tag(name) {
-    await this.initializeTags();
-    return this._tags.get(name);
+  addTag(name, options) {
+    let tag = this._tags.get(name);
+    if (tag === undefined) {
+      tag = new this.tagClass(this, name, options);
+    }
+
+    return tag;
+  }
+
+  _addTag(tag) {
+    this._tags.set(tag.name, tag);
   }
 
   /**
@@ -498,6 +514,14 @@ export class Repository extends NamedObject {
     return this.owner.branchClass;
   }
 
+  /**
+   * By default we use the owners implementation.
+   * @return {Class} as defined in the owner
+   */
+  get tagClass() {
+    return this.owner.tagClass;
+  }
+
   /**
    * By default we use the owners implementation.
    * @return {Class} as defined in the owner
@@ -529,18 +553,6 @@ export class Repository extends NamedObject {
     });
   }
 
-  info(...args) {
-    return this.owner.info(...args);
-  }
-
-  warn(...args) {
-    return this.owner.warn(...args);
-  }
-
-  error(...args) {
-    return this.owner.error(...args);
-  }
-
   initialize() {}
 
   initializeHooks() {