@meetkai/mka1 0.54.50 → 0.54.51

package/src/react-query/reposUpdate.ts

@@ -58,10 +58,13 @@ export type ReposUpdateMutationError =
  * protocol planes never change it): it types a legacy `kind: null`
  * repository and corrects a wrong kind. `repo`, `model` and `dataset`
  * convert freely and any repository may become `image`; a repository
- * that still holds container-image content can be given no other kind
- * — leaving `image`, or typing a legacy `null` row as anything else, is
- * refused with `409 kind_has_content` (delete the tags through the
- * registry first). A kind is never un-set.
+ * whose container images are still named by a tag can be given no
+ * other kind — leaving `image`, or typing a legacy `null` row as
+ * anything else, is refused with `409 kind_has_content` (list and
+ * delete the tags through this API first). A switch away from `image`
+ * collects every image no tag reaches before it is judged, so an image
+ * only ever pushed by digest, or untagged through the registry, never
+ * blocks it. A kind is never un-set.
  */
 export function useReposUpdateMutation(
   options?: MutationHookOptions<

package/src/sdk/repos.ts

@@ -11,8 +11,14 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
+import { Tags } from "./tags.js";
 
 export class Repos extends ClientSDK {
+  private _tags?: Tags;
+  get tags(): Tags {
+    return (this._tags ??= new Tags(this._options));
+  }
+
   /**
    * List the caller's org's repositories
    *
@@ -102,10 +108,13 @@ export class Repos extends ClientSDK {
    * protocol planes never change it): it types a legacy `kind: null`
    * repository and corrects a wrong kind. `repo`, `model` and `dataset`
    * convert freely and any repository may become `image`; a repository
-   * that still holds container-image content can be given no other kind
-   * — leaving `image`, or typing a legacy `null` row as anything else, is
-   * refused with `409 kind_has_content` (delete the tags through the
-   * registry first). A kind is never un-set.
+   * whose container images are still named by a tag can be given no
+   * other kind — leaving `image`, or typing a legacy `null` row as
+   * anything else, is refused with `409 kind_has_content` (list and
+   * delete the tags through this API first). A switch away from `image`
+   * collects every image no tag reaches before it is judged, so an image
+   * only ever pushed by digest, or untagged through the registry, never
+   * blocks it. A kind is never un-set.
    */
   async update(
     request: operations.PatchRepoRequest,

package/src/sdk/tags.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { reposTagsDelete } from "../funcs/reposTagsDelete.js";
+import { reposTagsList } from "../funcs/reposTagsList.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Tags extends ClientSDK {
+  /**
+   * List an image repository's tags
+   *
+   * @remarks
+   * Lists the container-image tags a repository holds, newest-moved first,
+   * each with the manifest it points at, the manifest's media type, the
+   * image's declared size and when the tag last moved. The same access
+   * check as reading the repository (org owner/admin; `read:repos` for a
+   * key).
+   *
+   * It is a fact about what the repository HOLDS, not about its `kind`:
+   * a `model` lists `[]`, and a legacy `kind: null` repository that still
+   * holds images lists them — those are the tags a `409 kind_has_content`
+   * on PATCH is about, and deleting them through this API is what makes
+   * that PATCH go through.
+   *
+   * One page, of at most 1000 tags; `truncated` says whether the
+   * repository holds more. The registry's own `GET /v2/{org}/{name}/tags/list`
+   * is the paginated, names-only listing every OCI client speaks.
+   */
+  async list(
+    request: operations.ListRepoTagsRequest,
+    options?: RequestOptions,
+  ): Promise<components.RepoTagList> {
+    return unwrapAsync(reposTagsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete an image tag
+   *
+   * @remarks
+   * Removes one tag; org owner/admin only (`write:repos` for a key). The
+   * same untag as the registry's `DELETE /v2/{org}/{name}/manifests/{tag}`:
+   * the name goes and the image stays, reachable by digest and by any
+   * other tag that names it.
+   *
+   * What makes a repository convertible afterwards is the kind switch
+   * itself: `PATCH` to another `kind` first collects every image no tag
+   * reaches (a multi-arch index's per-platform images included) and is
+   * refused with `409 kind_has_content` only for images a tag still
+   * names. So delete the tags the listing shows, then switch.
+   */
+  async delete(
+    request: operations.DeleteRepoTagRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(reposTagsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+}