@wtf/release-docs 9.1.0 → 10.0.0

package/api/@wtf/release-oci/publish/interfaces/MovedImage.md

@@ -0,0 +1,41 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/publish](../README.md) / MovedImage
+
+# Interface: MovedImage
+
+Defined in: [packages/release-oci/src/publish.ts:343](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L343)
+
+An image whose tags that move point at its version.
+
+## Properties
+
+### digest
+
+> `readonly` **digest**: `string`
+
+Defined in: [packages/release-oci/src/publish.ts:347](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L347)
+
+The digest of its version, as `sha256:…`, which each tag that moves is copied of.
+
+***
+
+### repository
+
+> `readonly` **repository**: `string`
+
+Defined in: [packages/release-oci/src/publish.ts:345](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L345)
+
+The repository of the image, as `registry.gitlab.com/acme/images/base`.
+
+***
+
+### tags
+
+> `readonly` **tags**: readonly `string`[]
+
+Defined in: [packages/release-oci/src/publish.ts:349](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L349)
+
+Each tag that moves, copied of the digest of the version.

package/api/@wtf/release-oci/publish/interfaces/OciSource.md

@@ -6,7 +6,7 @@
 
 # Interface: OciSource
 
-Defined in: [packages/release-oci/src/publish.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L41)
+Defined in: [packages/release-oci/src/publish.ts:52](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L52)
 
 The tested image of a release: its repository and its tag, as the pipeline that tested it wrote it.
 
@@ -16,7 +16,7 @@ The tested image of a release: its repository and its tag, as the pipeline that
 
 > `readonly` **repository**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L43)
+Defined in: [packages/release-oci/src/publish.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L54)
 
 Its repository, as `registry.gitlab.com/acme/images/base/snapshot`.
 
@@ -26,6 +26,6 @@ Its repository, as `registry.gitlab.com/acme/images/base/snapshot`.
 
 > `readonly` **tag**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:45](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L45)
+Defined in: [packages/release-oci/src/publish.ts:56](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L56)
 
 Its tag, as `base-v1-4-2`.

package/api/@wtf/release-oci/publish/interfaces/PublishedImage.md

@@ -6,9 +6,9 @@
 
 # Interface: PublishedImage
 
-Defined in: [packages/release-oci/src/publish.ts:71](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L71)
+Defined in: [packages/release-oci/src/publish.ts:85](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L85)
 
-An image of a release published: each tag copied, and each the registry had already.
+An image of a release published: the tag of its version copied, or found at its digest.
 
 ## Extends
 
@@ -20,7 +20,7 @@ An image of a release published: each tag copied, and each the registry had alre
 
 > `readonly` **digest**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L65)
+Defined in: [packages/release-oci/src/publish.ts:79](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L79)
 
 The digest of the source, as `sha256:…`.
 
@@ -34,7 +34,7 @@ The digest of the source, as `sha256:…`.
 
 > `readonly` **platforms**: readonly `string`[]
 
-Defined in: [packages/release-oci/src/publish.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L67)
+Defined in: [packages/release-oci/src/publish.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L81)
 
 The platforms it is of, as `linux/amd64`: none of an image of one manifest of no index.
 
@@ -48,7 +48,7 @@ The platforms it is of, as `linux/amd64`: none of an image of one manifest of no
 
 > `readonly` **repository**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L51)
+Defined in: [packages/release-oci/src/publish.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L62)
 
 The repository of the image, as `registry.gitlab.com/acme/images/base`.
 
@@ -60,11 +60,11 @@ The repository of the image, as `registry.gitlab.com/acme/images/base`.
 
 ### skipped
 
-> `readonly` **skipped**: readonly `string`[]
+> `readonly` **skipped**: `boolean`
 
-Defined in: [packages/release-oci/src/publish.ts:77](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L77)
+Defined in: [packages/release-oci/src/publish.ts:89](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L89)
 
-Each tag the registry had already at the digest of the source, and the release skipped.
+Whether the registry had the version at the digest of the source already, and none was copied.
 
 ***
 
@@ -72,7 +72,7 @@ Each tag the registry had already at the digest of the source, and the release s
 
 > `readonly` **source**: [`OciSource`](OciSource.md)
 
-Defined in: [packages/release-oci/src/publish.ts:53](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L53)
+Defined in: [packages/release-oci/src/publish.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L64)
 
 The tested image, which the release copies.
 
@@ -82,20 +82,10 @@ The tested image, which the release copies.
 
 ***
 
-### tags
-
-> `readonly` **tags**: readonly `string`[]
-
-Defined in: [packages/release-oci/src/publish.ts:75](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L75)
-
-Each tag the release copied the source to, the version's first.
-
-***
-
 ### version
 
 > `readonly` **version**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:73](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L73)
+Defined in: [packages/release-oci/src/publish.ts:87](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L87)
 
-The version of the release, as `1.4.2`.
+The version of the release, its tag, as `1.4.2`.

package/api/@wtf/release-oci/publish/interfaces/SmokedImage.md

@@ -6,7 +6,7 @@
 
 # Interface: SmokedImage
 
-Defined in: [packages/release-oci/src/publish.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L63)
+Defined in: [packages/release-oci/src/publish.ts:77](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L77)
 
 The tested image of an image, as the registry has it.
 
@@ -24,7 +24,7 @@ The tested image of an image, as the registry has it.
 
 > `readonly` **digest**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L65)
+Defined in: [packages/release-oci/src/publish.ts:79](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L79)
 
 The digest of the source, as `sha256:…`.
 
@@ -34,7 +34,7 @@ The digest of the source, as `sha256:…`.
 
 > `readonly` **platforms**: readonly `string`[]
 
-Defined in: [packages/release-oci/src/publish.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L67)
+Defined in: [packages/release-oci/src/publish.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L81)
 
 The platforms it is of, as `linux/amd64`: none of an image of one manifest of no index.
 
@@ -44,7 +44,7 @@ The platforms it is of, as `linux/amd64`: none of an image of one manifest of no
 
 > `readonly` **repository**: `string`
 
-Defined in: [packages/release-oci/src/publish.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L51)
+Defined in: [packages/release-oci/src/publish.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L62)
 
 The repository of the image, as `registry.gitlab.com/acme/images/base`.
 
@@ -58,7 +58,7 @@ The repository of the image, as `registry.gitlab.com/acme/images/base`.
 
 > `readonly` **source**: [`OciSource`](OciSource.md)
 
-Defined in: [packages/release-oci/src/publish.ts:53](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/publish.ts#L53)
+Defined in: [packages/release-oci/src/publish.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/publish.ts#L64)
 
 The tested image, which the release copies.
 

package/api/@wtf/release-oci/registry/README.md

@@ -11,24 +11,40 @@ GitLab release of a tag links each image by: the Container Registry API of the p
 repositories, `GET /projects/<id>/registry/repositories`, each of its `location`, as
 `registry.gitlab.com/acme/images/base`, and its ID, whose page is
 `<project>/container_registry/<id>`. An image is linked where it lives, never uploaded.
+[checkRegistryAccess](functions/checkRegistryAccess.md) asks the same API once, before anything is released, whether the
+headers may read it: GitLab's job token may not, so a run of it alone fails there, not after the
+images are copied. The ecosystem's `publish` gives each image its page of the registry its options
+name ([ContainerRegistry](interfaces/ContainerRegistry.md)).
 
 ```ts
 import { registryPageOf } from '@wtf/release-oci/registry'
-import { gitlabHeadersOf, gitlabProjectOf } from '@wtf/release-trains/gitlab'
 
-const env = { CI_PROJECT_PATH: 'acme/images', GITLAB_TOKEN: 'token' }
 export const page = await registryPageOf({
   fetch,
-  project: gitlabProjectOf({}, env, undefined),
+  project: {
+    api: 'https://gitlab.com/api/v4',
+    id: '7',
+    path: 'acme/images',
+    url: 'https://gitlab.com/acme/images'
+  },
   repository: 'registry.gitlab.com/acme/images/base',
-  headers: gitlabHeadersOf(env)
+  headers: { 'PRIVATE-TOKEN': 'token' }
 })
 ```
 
 ## Interfaces
 
+- [ContainerRegistry](interfaces/ContainerRegistry.md)
+- [RegistryProject](interfaces/RegistryProject.md)
 - [RegistryQuery](interfaces/RegistryQuery.md)
+- [RegistryResponse](interfaces/RegistryResponse.md)
+
+## Type Aliases
+
+- [RegistryAccess](type-aliases/RegistryAccess.md)
+- [RegistryFetch](type-aliases/RegistryFetch.md)
 
 ## Functions
 
+- [checkRegistryAccess](functions/checkRegistryAccess.md)
 - [registryPageOf](functions/registryPageOf.md)

package/api/@wtf/release-oci/registry/functions/checkRegistryAccess.md

@@ -0,0 +1,28 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / checkRegistryAccess
+
+# Function: checkRegistryAccess()
+
+> **checkRegistryAccess**(`query`): `Promise`\<`void`\>
+
+Defined in: [packages/release-oci/src/registry.ts:146](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L146)
+
+Checks that `headers` may read the container registry of `project`, by one request of no
+effect, `GET /projects/<id>/registry/repositories?per_page=1`, as [registryPageOf](registryPageOf.md) needs it
+to: a token of the `read_api` or `api` scope may; the job token of a pipeline, `CI_JOB_TOKEN`, may
+not. Throws `EOCILINK` of a request GitLab refuses or that cannot be made.
+
+## Parameters
+
+### query
+
+[`RegistryAccess`](../type-aliases/RegistryAccess.md)
+
+The `fetch`, the project and the headers.
+
+## Returns
+
+`Promise`\<`void`\>

package/api/@wtf/release-oci/registry/functions/registryPageOf.md

@@ -8,7 +8,7 @@
 
 > **registryPageOf**(`query`): `Promise`\<`string`\>
 
-Defined in: [packages/release-oci/src/registry.ts:55](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L55)
+Defined in: [packages/release-oci/src/registry.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L102)
 
 The page of the image `repository` in the container registry of `project`: the repository of its
 `location`, of the first page of a hundred, at `<project>/container_registry/<id>`. Throws

package/api/@wtf/release-oci/registry/interfaces/ContainerRegistry.md

@@ -0,0 +1,35 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / ContainerRegistry
+
+# Interface: ContainerRegistry
+
+Defined in: [packages/release-oci/src/registry.ts:72](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L72)
+
+The container registry of a project of GitLab, and the headers its API is asked by.
+
+## Extended by
+
+- [`RegistryQuery`](RegistryQuery.md)
+
+## Properties
+
+### headers
+
+> `readonly` **headers**: `Readonly`\<`Record`\<`string`, `string`\>\>
+
+Defined in: [packages/release-oci/src/registry.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L76)
+
+The headers the request authenticates by: none of a public project.
+
+***
+
+### project
+
+> `readonly` **project**: [`RegistryProject`](RegistryProject.md)
+
+Defined in: [packages/release-oci/src/registry.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L74)
+
+The project whose container registry holds the images.

package/api/@wtf/release-oci/registry/interfaces/RegistryProject.md

@@ -0,0 +1,51 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / RegistryProject
+
+# Interface: RegistryProject
+
+Defined in: [packages/release-oci/src/registry.ts:60](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L60)
+
+A project of GitLab, of its container registry: as `gitlabProjectOf` of a GitLab client gives it.
+
+## Properties
+
+### api
+
+> `readonly` **api**: `string`
+
+Defined in: [packages/release-oci/src/registry.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L62)
+
+The URL of the API of GitLab, as `https://gitlab.com/api/v4`.
+
+***
+
+### id
+
+> `readonly` **id**: `string`
+
+Defined in: [packages/release-oci/src/registry.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L64)
+
+The project as the API names it: its ID, or its path encoded, as `acme%2Fimages`.
+
+***
+
+### path
+
+> `readonly` **path**: `string`
+
+Defined in: [packages/release-oci/src/registry.ts:66](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L66)
+
+The path of the project, as `acme/images`.
+
+***
+
+### url
+
+> `readonly` **url**: `string`
+
+Defined in: [packages/release-oci/src/registry.ts:68](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L68)
+
+The page of the project, as `https://gitlab.com/acme/images`.

package/api/@wtf/release-oci/registry/interfaces/RegistryQuery.md

@@ -6,17 +6,21 @@
 
 # Interface: RegistryQuery
 
-Defined in: [packages/release-oci/src/registry.ts:29](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L29)
+Defined in: [packages/release-oci/src/registry.ts:80](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L80)
 
 What [registryPageOf](../functions/registryPageOf.md) looks up.
 
+## Extends
+
+- [`ContainerRegistry`](ContainerRegistry.md)
+
 ## Properties
 
 ### fetch
 
-> `readonly` **fetch**: [`HttpFetch`](../../../release-trains/gitlab/type-aliases/HttpFetch.md)
+> `readonly` **fetch**: [`RegistryFetch`](../type-aliases/RegistryFetch.md)
 
-Defined in: [packages/release-oci/src/registry.ts:31](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L31)
+Defined in: [packages/release-oci/src/registry.ts:82](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L82)
 
 The `fetch` the request is made by.
 
@@ -26,19 +30,27 @@ The `fetch` the request is made by.
 
 > `readonly` **headers**: `Readonly`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [packages/release-oci/src/registry.ts:37](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L37)
+Defined in: [packages/release-oci/src/registry.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L76)
 
 The headers the request authenticates by: none of a public project.
 
+#### Inherited from
+
+[`ContainerRegistry`](ContainerRegistry.md).[`headers`](ContainerRegistry.md#headers)
+
 ***
 
 ### project
 
-> `readonly` **project**: [`GitLabProject`](../../../release-trains/gitlab/interfaces/GitLabProject.md)
+> `readonly` **project**: [`RegistryProject`](RegistryProject.md)
+
+Defined in: [packages/release-oci/src/registry.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L74)
+
+The project whose container registry holds the images.
 
-Defined in: [packages/release-oci/src/registry.ts:33](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L33)
+#### Inherited from
 
-The project whose container registry holds the image.
+[`ContainerRegistry`](ContainerRegistry.md).[`project`](ContainerRegistry.md#project)
 
 ***
 
@@ -46,6 +58,6 @@ The project whose container registry holds the image.
 
 > `readonly` **repository**: `string`
 
-Defined in: [packages/release-oci/src/registry.ts:35](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-oci/src/registry.ts#L35)
+Defined in: [packages/release-oci/src/registry.ts:84](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L84)
 
 The repository of the image, as `registry.gitlab.com/acme/images/base`.

package/api/@wtf/release-oci/registry/interfaces/RegistryResponse.md

@@ -0,0 +1,47 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / RegistryResponse
+
+# Interface: RegistryResponse
+
+Defined in: [packages/release-oci/src/registry.ts:34](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L34)
+
+A response of the API of GitLab, as a request of [RegistryFetch](../type-aliases/RegistryFetch.md) gives it.
+
+## Properties
+
+### ok
+
+> `readonly` **ok**: `boolean`
+
+Defined in: [packages/release-oci/src/registry.ts:36](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L36)
+
+Whether its status is of success, 2xx.
+
+***
+
+### status
+
+> `readonly` **status**: `number`
+
+Defined in: [packages/release-oci/src/registry.ts:38](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L38)
+
+Its status, as `200`.
+
+## Methods
+
+### text()
+
+> **text**(): `Promise`\<`string`\>
+
+Defined in: [packages/release-oci/src/registry.ts:44](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L44)
+
+Its body, as text.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The body.

package/api/@wtf/release-oci/registry/type-aliases/RegistryAccess.md

@@ -0,0 +1,13 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / RegistryAccess
+
+# Type Alias: RegistryAccess
+
+> **RegistryAccess** = `Omit`\<[`RegistryQuery`](../interfaces/RegistryQuery.md), `"repository"`\>
+
+Defined in: [packages/release-oci/src/registry.ts:136](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L136)
+
+What [checkRegistryAccess](../functions/checkRegistryAccess.md) asks: a registry query of no repository.

package/api/@wtf/release-oci/registry/type-aliases/RegistryFetch.md

@@ -0,0 +1,39 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/registry](../README.md) / RegistryFetch
+
+# Type Alias: RegistryFetch
+
+> **RegistryFetch** = (`url`, `init`) => `Promise`\<[`RegistryResponse`](../interfaces/RegistryResponse.md)\>
+
+Defined in: [packages/release-oci/src/registry.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/registry.ts#L54)
+
+The `fetch` the API of GitLab is asked by: the platform's, of the Fetch Standard, or a test's.
+
+## Parameters
+
+### url
+
+`string`
+
+The URL of the request.
+
+### init
+
+Its method and its headers.
+
+#### headers
+
+`Record`\<`string`, `string`\>
+
+#### method
+
+`string`
+
+## Returns
+
+`Promise`\<[`RegistryResponse`](../interfaces/RegistryResponse.md)\>
+
+What GitLab answered.

package/api/@wtf/release-oci/tags/README.md

@@ -6,15 +6,16 @@
 
 # @wtf/release-oci/tags
 
-The tags of a release of an image ([tagsOfRelease](functions/tagsOfRelease.md)): its version, and of a release, the
-minor and the major that move with each release of them, as `1.4` and `1` of `1.4.2`, which a
-consumer pins to take each fix of its line. A prerelease, as `2.0.0-next.1`, has its own tag
-alone, so no moving tag points at a version that is not released.
+The tags of a release of an image ([ReleaseTags](interfaces/ReleaseTags.md)): the tag of its version, which a release
+never moves once it is published, and the tags that move to each release of their line, as `1.4`
+and `1` of `1.4.2`, or `12.12` and `latest` of `12.12-wtf.1`, which a consumer pins to take each
+fix of its line. A release takes them as its caller gives them, and derives none: a release tool
+names those of its own rules. [checkReleaseTags](functions/checkReleaseTags.md) checks them, each a tag an image can have.
 
 ```ts
-import { tagsOfRelease } from '@wtf/release-oci/tags'
+import { checkReleaseTags } from '@wtf/release-oci/tags'
 
-export const tags = tagsOfRelease('1.4.2') // ['1.4.2', '1.4', '1']
+export const tags = checkReleaseTags({ version: '12.12-wtf.1', moving: ['12.12', 'latest'] })
 ```
 
 ## Interfaces
@@ -23,5 +24,5 @@ export const tags = tagsOfRelease('1.4.2') // ['1.4.2', '1.4', '1']
 
 ## Functions
 
-- [releaseTagsOf](functions/releaseTagsOf.md)
-- [tagsOfRelease](functions/tagsOfRelease.md)
+- [checkReleaseTags](functions/checkReleaseTags.md)
+- [isImageTag](functions/isImageTag.md)

package/api/@wtf/release-oci/tags/functions/checkReleaseTags.md

@@ -0,0 +1,35 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/tags](../README.md) / checkReleaseTags
+
+# Function: checkReleaseTags()
+
+> **checkReleaseTags**(`tags`): [`ReleaseTags`](../interfaces/ReleaseTags.md)
+
+Defined in: [packages/release-oci/src/tags.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/tags.ts#L54)
+
+The tags of a release, as its caller gives them, checked: each a tag the OCI distribution spec
+takes ([isImageTag](isImageTag.md)), none twice, and the tag of the version not among those that move.
+Throws, together, `EOCIVERSION` of the tags the spec does not take, and of the tags given twice.
+
+```ts
+import { checkReleaseTags } from '@wtf/release-oci/tags'
+
+export const tags = checkReleaseTags({ version: '1.4.2', moving: ['1.4', '1'] })
+```
+
+## Parameters
+
+### tags
+
+[`ReleaseTags`](../interfaces/ReleaseTags.md)
+
+The tag of the version, and those that move.
+
+## Returns
+
+[`ReleaseTags`](../interfaces/ReleaseTags.md)
+
+The same tags.

package/api/@wtf/release-oci/tags/functions/isImageTag.md

@@ -0,0 +1,27 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-oci/tags](../README.md) / isImageTag
+
+# Function: isImageTag()
+
+> **isImageTag**(`tag`): `boolean`
+
+Defined in: [packages/release-oci/src/tags.ts:38](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-oci/src/tags.ts#L38)
+
+Whether `tag` is a tag the OCI distribution spec takes, `[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}`.
+
+## Parameters
+
+### tag
+
+`string`
+
+The tag, as `1.4.2`.
+
+## Returns
+
+`boolean`
+
+Whether an image can have it.