repository-provider 35.2.21 → 35.2.23

package/README.md

@@ -181,15 +181,17 @@ console.log(await readme.string);
         *   [Parameters](#parameters-41)
     *   [initialize](#initialize-1)
         *   [Parameters](#parameters-42)
-*   [MessageDestination](#messagedestination)
+*   [DecodedRepositoryName](#decodedrepositoryname)
     *   [Properties](#properties-2)
+*   [MessageDestination](#messagedestination)
+    *   [Properties](#properties-3)
 *   [name](#name-2)
 *   [name](#name-3)
 *   [messageDestination](#messagedestination-1)
 *   [parsedName](#parsedname)
 *   [Branch](#branch)
     *   [Parameters](#parameters-43)
-    *   [Properties](#properties-3)
+    *   [Properties](#properties-4)
     *   [url](#url)
     *   [refType](#reftype)
     *   [isWritable](#iswritable-1)
@@ -207,10 +209,10 @@ console.log(await readme.string);
         *   [Parameters](#parameters-48)
 *   [CommitResult](#commitresult)
     *   [Parameters](#parameters-49)
-    *   [Properties](#properties-4)
+    *   [Properties](#properties-5)
 *   [Commit](#commit-1)
     *   [Parameters](#parameters-50)
-    *   [Properties](#properties-5)
+    *   [Properties](#properties-6)
 *   [Hook](#hook)
 *   [Issue](#issue)
 *   [Milestone](#milestone)
@@ -229,7 +231,7 @@ console.log(await readme.string);
         *   [Parameters](#parameters-56)
 *   [NamedObject](#namedobject)
     *   [Parameters](#parameters-57)
-    *   [Properties](#properties-6)
+    *   [Properties](#properties-7)
     *   [displayName](#displayname)
     *   [condensedName](#condensedname)
     *   [fullCondensedName](#fullcondensedname)
@@ -295,7 +297,7 @@ console.log(await readme.string);
 *   [Project](#project)
 *   [PullRequest](#pullrequest)
     *   [Parameters](#parameters-73)
-    *   [Properties](#properties-7)
+    *   [Properties](#properties-8)
     *   [source](#source)
     *   [fullName](#fullname-3)
     *   [url](#url-3)
@@ -352,7 +354,7 @@ console.log(await readme.string);
 *   [isProtected](#isprotected-2)
 *   [RepositoryGroup](#repositorygroup-1)
     *   [Parameters](#parameters-83)
-    *   [Properties](#properties-8)
+    *   [Properties](#properties-9)
     *   [attributeMapping](#attributemapping-1)
 *   [type](#type-1)
 *   [homePageURL](#homepageurl-2)
@@ -360,7 +362,7 @@ console.log(await readme.string);
     *   [Parameters](#parameters-84)
 *   [Repository](#repository-4)
     *   [Parameters](#parameters-85)
-    *   [Properties](#properties-9)
+    *   [Properties](#properties-10)
     *   [slug](#slug-2)
     *   [url](#url-4)
     *   [entry](#entry-2)
@@ -799,6 +801,8 @@ base, group, repository and branch.
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
 *   `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 **[DecodedRepositoryName](#decodedrepositoryname)** result
+
 ### createRepository
 
 Create a repository.
@@ -817,7 +821,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` **([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
+*   `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)>** group / repository filter
 
 Returns **AsyncIterable<([Repository](#repository) | [PullRequest](#pullrequest) | [Branch](#branch) | [Tag](#tag) | [Project](#project) | [Milestone](#milestone) | [Hook](#hook))>** all matching repositories of the providers
 
@@ -1050,6 +1054,8 @@ base, group, repository and branch.
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?**&#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 **[DecodedRepositoryName](#decodedrepositoryname)** result
+
 ### createRepository
 
 Create a repository.
@@ -1068,7 +1074,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` **([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
+*   `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)>** group / repository filter
 
 Returns **AsyncIterable<([Repository](#repository) | [PullRequest](#pullrequest) | [Branch](#branch) | [Tag](#tag) | [Project](#project) | [Milestone](#milestone) | [Hook](#hook))>** all matching repositories of the providers
 
@@ -1204,6 +1210,17 @@ Creates a new provider for a given set of options.
 
 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
 
+## DecodedRepositoryName
+
+Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)
+
+### Properties
+
+*   `base` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?**&#x20;
+*   `group` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?**&#x20;
+*   `repository` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?**&#x20;
+*   `branch` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?**&#x20;
+
 ## MessageDestination
 
 Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repository-provider",
-  "version": "35.2.21",
+  "version": "35.2.23",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -43,12 +43,12 @@
   },
   "devDependencies": {
     "ava": "^6.1.3",
-    "browser-ava": "^2.2.15",
-    "c8": "^9.1.0",
+    "browser-ava": "^2.2.21",
+    "c8": "^10.1.2",
     "documentation": "^14.0.3",
-    "repository-provider-test-support": "^3.1.5",
+    "repository-provider-test-support": "^3.1.6",
     "semantic-release": "^24.0.0",
-    "typescript": "^5.4.5"
+    "typescript": "^5.5.3"
   },
   "engines": {
     "node": ">=20.12.2"

package/src/base-provider.mjs

@@ -20,6 +20,14 @@ import {
  * @typedef {import('./milestone.mjs').Milestone} Milestone
  */
 
+/**
+ * @typedef {Object} DecodedRepositoryName
+ * @property {string} [base]
+ * @property {string} [group]
+ * @property {string} [repository]
+ * @property {string} [branch]
+ */
+
 /**
  * @typedef {Object} MessageDestination
  * Endpoint to deliver log messages to.
@@ -251,7 +259,7 @@ export class BaseProvider extends BaseObject {
    * base, group, repository and branch.
    * @param {string} [name]
    * @param {string} focus where lies the focus if only one path component is given
-   * @return {{base: string|undefined, group: string|undefined, repository: string|undefined, branch: string|undefined}} with separated attributes
+   * @returns {DecodedRepositoryName} result
    */
   parseName(name, focus = "repository") {
     const result = {};
@@ -323,23 +331,28 @@ 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|undefined} patterns group / repository filter
+   * @param {string[]} patterns group / repository filter
    * @return {AsyncIterable<Repository|PullRequest|Branch|Tag|Project|Milestone|Hook>} all matching repositories of the providers
    */
   async *list(type, patterns) {
-    if (patterns === undefined) {
+    if (patterns.length === 0) {
       // @ts-ignore
       for await (const group of this.repositoryGroups()) {
         yield* group[type]();
       }
     } else {
-      for (const pattern of asArray(patterns)) {
+      for (const pattern of patterns) {
         // @ts-ignore
-        const [groupPattern, repoPattern] = stripBaseName(
+        let [groupPattern, repoPattern] = stripBaseName(
           pattern,
           this.repositoryBases
         ).split(/\//);
 
+        if(repoPattern) {
+          // TODO do cleanup in stripBase()
+          repoPattern = repoPattern.replace(/\.git(#.*)?$/, (all,b) => b || "");
+        }
+
         // @ts-ignore
         for await (const group of this.repositoryGroups(groupPattern)) {
           yield* group[type](repoPattern);
@@ -355,7 +368,7 @@ export class BaseProvider extends BaseObject {
    */
   async *projects(patterns) {
     // @ts-ignore
-    yield* this.list("projects", patterns);
+    yield* this.list("projects", asArray(patterns));
   }
 
   /**
@@ -365,7 +378,7 @@ export class BaseProvider extends BaseObject {
    */
   async *milestones(patterns) {
     // @ts-ignore
-    yield* this.list("milestones", patterns);
+    yield* this.list("milestones", asArray(patterns));
   }
 
   /**
@@ -375,7 +388,7 @@ export class BaseProvider extends BaseObject {
    */
   async *repositories(patterns) {
     // @ts-ignore
-    yield* this.list("repositories", patterns);
+    yield* this.list("repositories", asArray(patterns));
   }
 
   /**
@@ -385,7 +398,7 @@ export class BaseProvider extends BaseObject {
    */
   async *branches(patterns) {
     // @ts-ignore
-    yield* this.list("branches", patterns);
+    yield* this.list("branches", asArray(patterns));
   }
 
   /**
@@ -395,7 +408,7 @@ export class BaseProvider extends BaseObject {
    */
   async *tags(patterns) {
     // @ts-ignore
-    yield* this.list("tags", patterns);
+    yield* this.list("tags", asArray(patterns));
   }
 
   /**
@@ -405,7 +418,7 @@ export class BaseProvider extends BaseObject {
    */
   async *hooks(patterns) {
     // @ts-ignore
-    yield* this.list("hooks", patterns);
+    yield* this.list("hooks", asArray(patterns));
   }
 
   /**
@@ -415,7 +428,7 @@ export class BaseProvider extends BaseObject {
    */
   async *pullRequests(patterns) {
     // @ts-ignore
-    yield* this.list("pullRequests", patterns);
+    yield* this.list("pullRequests", asArray(patterns));
   }
 
   /**

package/types/attributes.d.mts

@@ -84,4 +84,4 @@ export const language_attribute: AttributeDefinition;
  * @type {AttributeDefinition}
  */
 export const type_attribute: AttributeDefinition;
-export type AttributeDefinition = import('pacc').AttributeDefinition;
+export type AttributeDefinition = import("pacc").AttributeDefinition;

package/types/base-provider.d.mts

@@ -2,6 +2,13 @@
  * @typedef {import('./project.mjs').Project} Project
  * @typedef {import('./milestone.mjs').Milestone} Milestone
  */
+/**
+ * @typedef {Object} DecodedRepositoryName
+ * @property {string} [base]
+ * @property {string} [group]
+ * @property {string} [repository]
+ * @property {string} [branch]
+ */
 /**
  * @typedef {Object} MessageDestination
  * Endpoint to deliver log messages to.
@@ -77,7 +84,7 @@ export class BaseProvider extends BaseObject {
             description?: string;
             set?: Function;
             get?: Function;
-            env?: string | string[];
+            env?: string[] | string;
         };
     };
     /**
@@ -153,14 +160,9 @@ export class BaseProvider extends BaseObject {
      * base, group, repository and branch.
      * @param {string} [name]
      * @param {string} focus where lies the focus if only one path component is given
-     * @return {{base: string|undefined, group: string|undefined, repository: string|undefined, branch: string|undefined}} with separated attributes
+     * @returns {DecodedRepositoryName} result
      */
-    parseName(name?: string, focus?: string): {
-        base: string | undefined;
-        group: string | undefined;
-        repository: string | undefined;
-        branch: string | undefined;
-    };
+    parseName(name?: string, focus?: string): DecodedRepositoryName;
     /**
      * Create a repository.
      * @param {string} name of group and repository
@@ -172,10 +174,10 @@ 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|undefined} patterns group / repository filter
+     * @param {string[]} patterns group / repository filter
      * @return {AsyncIterable<Repository|PullRequest|Branch|Tag|Project|Milestone|Hook>} all matching repositories of the providers
      */
-    list(type: string, patterns: string[] | string | undefined): AsyncIterable<Repository | PullRequest | Branch | Tag | Project | Milestone | Hook>;
+    list(type: string, patterns: string[]): AsyncIterable<Repository | PullRequest | Branch | Tag | Project | Milestone | Hook>;
     /**
      * List projects.
      * @param {string[]|string} [patterns]
@@ -249,8 +251,14 @@ export class BaseProvider extends BaseObject {
     get entryClass(): typeof ContentEntry;
     get pullRequestClass(): typeof PullRequest;
 }
-export type Project = import('./project.mjs').Project;
-export type Milestone = import('./milestone.mjs').Milestone;
+export type Project = import("./project.mjs").Project;
+export type Milestone = import("./milestone.mjs").Milestone;
+export type DecodedRepositoryName = {
+    base?: string;
+    group?: string;
+    repository?: string;
+    branch?: string;
+};
 /**
  * Endpoint to deliver log messages to.
  */

package/types/hook.d.mts

@@ -18,7 +18,7 @@ export class Hook extends OwnedObject {
             default?: any;
             set?: Function;
             get?: Function;
-            env?: string | string[];
+            env?: string[] | string;
         };
         content_type: {
             default: string;
@@ -32,7 +32,7 @@ export class Hook extends OwnedObject {
             description?: string;
             set?: Function;
             get?: Function;
-            env?: string | string[];
+            env?: string[] | string;
         };
         insecure_ssl: import("pacc").AttributeDefinition;
         events: {

package/types/owned-object.d.mts

@@ -109,6 +109,6 @@ export class OwnedObject extends NamedObject {
     get entryClass(): any;
     get hookClass(): any;
 }
-export type BaseProvider = import('./base-provider.mjs').BaseProvider;
-export type Repository = import('./repository.mjs').Repository;
+export type BaseProvider = import("./base-provider.mjs").BaseProvider;
+export type Repository = import("./repository.mjs").Repository;
 import { NamedObject } from "./named-object.mjs";

package/types/pull-request.d.mts

@@ -83,7 +83,7 @@ export class PullRequest extends OwnedObject {
             description?: string;
             set?: Function;
             get?: Function;
-            env?: string | string[];
+            env?: string[] | string;
         };
         /**
          * Locked state of the pull request.

package/types/ref.d.mts

@@ -66,6 +66,6 @@ export class Ref extends OwnedObject {
      */
     [Symbol.asyncIterator](): AsyncGenerator<ContentEntry>;
 }
-export type Repository = import('./repository.mjs').Repository;
+export type Repository = import("./repository.mjs").Repository;
 import { OwnedObject } from "./owned-object.mjs";
 import { ContentEntry } from "content-entry";

package/types/repository-group.d.mts

@@ -3,17 +3,17 @@ declare const RepositoryGroup_base: {
         [x: string]: any;
         "__#2@#repositories": Map<any, any>;
         normalizeRepositoryName(name: string, forLookup: boolean): string;
-        repository(name?: string): Promise<import("./repository.mjs").Repository>;
-        repositories(patterns?: string | string[]): AsyncIterable<import("./repository.mjs").Repository>;
-        lookup(type: string, name?: string, split?: Function, defaultItem?: any): Promise<OwnedObject>;
-        list(type: string, patterns?: string | string[], split?: Function, defaultItem?: any): AsyncIterable<OwnedObject>;
+        repository(name?: string): Promise<import("./repository.mjs").Repository | undefined>;
+        repositories(patterns?: string[] | string): AsyncIterable<import("./repository.mjs").Repository>;
+        lookup(type: string, name?: string, split?: Function, defaultItem?: any): Promise<OwnedObject | undefined>;
+        list(type: string, patterns?: string[] | string, split?: Function, defaultItem?: any): AsyncIterable<OwnedObject>;
         createRepository(name: string, options?: any): Promise<import("./repository.mjs").Repository>;
         addRepository(name: string, options?: any): Promise<import("./repository.mjs").Repository>;
         _addRepository(repository: any): void;
         deleteRepository(name: string): Promise<any>;
         initializeRepositories(): void;
-        branch(name: string): Promise<import("./branch.mjs").Branch>;
-        branches(patterns?: string | string[]): AsyncIterable<import("./branch.mjs").Branch>;
+        branch(name: string): Promise<import("./branch.mjs").Branch | undefined>;
+        branches(patterns?: string[] | string): AsyncIterable<import("./branch.mjs").Branch>;
         tag(name: any): Promise<OwnedObject>;
         tags(patterns: any): AsyncGenerator<OwnedObject, void, undefined>;
         pullRequest(name: any): Promise<OwnedObject>;

package/types/repository.d.mts

@@ -39,7 +39,7 @@ export class Repository extends OwnedObject {
             description?: string;
             set?: Function;
             get?: Function;
-            env?: string | string[];
+            env?: string[] | string;
         };
         cloneURL: import("pacc").AttributeDefinition;
         isArchived: import("pacc").AttributeDefinition;

package/types/single-group-provider.d.mts

@@ -3,17 +3,17 @@ declare const SingleGroupProvider_base: {
         [x: string]: any;
         "__#2@#repositories": Map<any, any>;
         normalizeRepositoryName(name: string, forLookup: boolean): string;
-        repository(name?: string): Promise<Repository>;
-        repositories(patterns?: string | string[]): AsyncIterable<Repository>;
-        lookup(type: string, name?: string, split?: Function, defaultItem?: any): Promise<import("./owned-object.mjs").OwnedObject>;
-        list(type: string, patterns?: string | string[], split?: Function, defaultItem?: any): AsyncIterable<import("./owned-object.mjs").OwnedObject>;
+        repository(name?: string): Promise<Repository | undefined>;
+        repositories(patterns?: string[] | string): AsyncIterable<Repository>;
+        lookup(type: string, name?: string, split?: Function, defaultItem?: any): Promise<import("./owned-object.mjs").OwnedObject | undefined>;
+        list(type: string, patterns?: string[] | string, split?: Function, defaultItem?: any): AsyncIterable<import("./owned-object.mjs").OwnedObject>;
         createRepository(name: string, options?: any): Promise<Repository>;
         addRepository(name: string, options?: any): Promise<Repository>;
         _addRepository(repository: any): void;
         deleteRepository(name: string): Promise<any>;
         initializeRepositories(): void;
-        branch(name: string): Promise<import("./branch.mjs").Branch>;
-        branches(patterns?: string | string[]): AsyncIterable<import("./branch.mjs").Branch>;
+        branch(name: string): Promise<import("./branch.mjs").Branch | undefined>;
+        branches(patterns?: string[] | string): AsyncIterable<import("./branch.mjs").Branch>;
         tag(name: any): Promise<import("./owned-object.mjs").OwnedObject>;
         tags(patterns: any): AsyncGenerator<import("./owned-object.mjs").OwnedObject, void, undefined>;
         pullRequest(name: any): Promise<import("./owned-object.mjs").OwnedObject>;