@meetkai/mka1 0.54.49 → 0.54.51

package/src/react-query/reposTagsDelete.ts

@@ -0,0 +1,119 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { reposTagsDelete } from "../funcs/reposTagsDelete.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ReposTagsDeleteMutationVariables = {
+  request: operations.DeleteRepoTagRequest;
+  options?: RequestOptions;
+};
+
+export type ReposTagsDeleteMutationData = void;
+
+export type ReposTagsDeleteMutationError =
+  | errors.RepoError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * 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.
+ */
+export function useReposTagsDeleteMutation(
+  options?: MutationHookOptions<
+    ReposTagsDeleteMutationData,
+    ReposTagsDeleteMutationError,
+    ReposTagsDeleteMutationVariables
+  >,
+): UseMutationResult<
+  ReposTagsDeleteMutationData,
+  ReposTagsDeleteMutationError,
+  ReposTagsDeleteMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildReposTagsDeleteMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyReposTagsDelete(): MutationKey {
+  return ["@meetkai/mka1", "tags", "delete"];
+}
+
+export function buildReposTagsDeleteMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ReposTagsDeleteMutationVariables,
+  ) => Promise<ReposTagsDeleteMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyReposTagsDelete(),
+    mutationFn: function reposTagsDeleteMutationFn({
+      request,
+      options,
+    }): Promise<ReposTagsDeleteMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(reposTagsDelete(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/reposTagsList.core.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { reposTagsList } from "../funcs/reposTagsList.js";
+import { combineSignals } from "../lib/primitives.js";
+import { 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 type ReposTagsListQueryData = components.RepoTagList;
+
+export function prefetchReposTagsList(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.ListRepoTagsRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildReposTagsListQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildReposTagsListQuery(
+  client$: SDKCore,
+  request: operations.ListRepoTagsRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (context: QueryFunctionContext) => Promise<ReposTagsListQueryData>;
+} {
+  return {
+    queryKey: queryKeyReposTagsList(request.org, request.name, {
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function reposTagsListQueryFn(
+      ctx,
+    ): Promise<ReposTagsListQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(reposTagsList(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyReposTagsList(
+  org: string,
+  name: string,
+  parameters: { xOnBehalfOf?: string | undefined },
+): QueryKey {
+  return ["@meetkai/mka1", "tags", "list", org, name, parameters];
+}

package/src/react-query/reposTagsList.ts

@@ -0,0 +1,167 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildReposTagsListQuery,
+  prefetchReposTagsList,
+  queryKeyReposTagsList,
+  ReposTagsListQueryData,
+} from "./reposTagsList.core.js";
+export {
+  buildReposTagsListQuery,
+  prefetchReposTagsList,
+  queryKeyReposTagsList,
+  type ReposTagsListQueryData,
+};
+
+export type ReposTagsListQueryError =
+  | errors.RepoError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * 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.
+ */
+export function useReposTagsList(
+  request: operations.ListRepoTagsRequest,
+  options?: QueryHookOptions<ReposTagsListQueryData, ReposTagsListQueryError>,
+): UseQueryResult<ReposTagsListQueryData, ReposTagsListQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildReposTagsListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * 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.
+ */
+export function useReposTagsListSuspense(
+  request: operations.ListRepoTagsRequest,
+  options?: SuspenseQueryHookOptions<
+    ReposTagsListQueryData,
+    ReposTagsListQueryError
+  >,
+): UseSuspenseQueryResult<ReposTagsListQueryData, ReposTagsListQueryError> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildReposTagsListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setReposTagsListData(
+  client: QueryClient,
+  queryKeyBase: [
+    org: string,
+    name: string,
+    parameters: { xOnBehalfOf?: string | undefined },
+  ],
+  data: ReposTagsListQueryData,
+): ReposTagsListQueryData | undefined {
+  const key = queryKeyReposTagsList(...queryKeyBase);
+
+  return client.setQueryData<ReposTagsListQueryData>(key, data);
+}
+
+export function invalidateReposTagsList(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      org: string,
+      name: string,
+      parameters: { xOnBehalfOf?: string | undefined },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "tags", "list", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllReposTagsList(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "tags", "list"],
+  });
+}

package/src/react-query/reposUpdate.ts

@@ -50,9 +50,21 @@ export type ReposUpdateMutationError =
  * Update a repository's labels
  *
  * @remarks
- * Applies a label-only update (name/description); org owner/admin only.
- * The repository id is stable, so a rename is a one-row DB update — no
- * Gitea write. Omitted fields are left unchanged.
+ * Applies a label-only update (name/description/kind); org owner/admin
+ * only. The repository id is stable, so a rename is a one-row DB update
+ * — no Gitea write. Omitted fields are left unchanged.
+ *
+ * `kind` is the ONE way a repository's kind changes after creation (the
+ * 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
+ * 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/environments.ts

@@ -131,7 +131,7 @@ export class Environments extends ClientSDK {
    * Generate or replace an environment evaluation key
    *
    * @remarks
-   * Returns the new plaintext key once. Only its SHA-256 digest is stored; generating another key immediately replaces the previous credential on this replica.
+   * Returns the new plaintext key once. Only its SHA-256 digest and a display hint are stored; generating another key immediately replaces the previous credential on this replica.
    */
   async generateEvaluationKey(
     request: operations.GenerateFeatureFlagEvaluationKeyRequest,

package/src/sdk/repos.ts

@@ -11,14 +11,22 @@ 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
    *
    * @remarks
    * Returns every repository in the caller's org (org owner/admin only).
-   * Pure DB read.
+   * Pure DB read. With `kind`, only repositories of that kind; an untyped
+   * (legacy, `kind: null`) repository appears in the unfiltered listing
+   * only.
    */
   async list(
     request: operations.ListReposRequest,
@@ -37,7 +45,9 @@ export class Repos extends ClientSDK {
    * @remarks
    * Provisions a repository (org owner/admin only): DB insert
    * (authoritative) → Gitea create (rolled back on failure). The repository
-   * belongs to the caller's org.
+   * belongs to the caller's org. `kind` says what it will hold and defaults
+   * to `repo` (a plain git repository); it decides which protocol planes
+   * answer for the name (see the `Repo` schema).
    */
   async create(
     request: operations.CreateRepoRequest,
@@ -90,9 +100,21 @@ export class Repos extends ClientSDK {
    * Update a repository's labels
    *
    * @remarks
-   * Applies a label-only update (name/description); org owner/admin only.
-   * The repository id is stable, so a rename is a one-row DB update — no
-   * Gitea write. Omitted fields are left unchanged.
+   * Applies a label-only update (name/description/kind); org owner/admin
+   * only. The repository id is stable, so a rename is a one-row DB update
+   * — no Gitea write. Omitted fields are left unchanged.
+   *
+   * `kind` is the ONE way a repository's kind changes after creation (the
+   * 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
+   * 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,
+    ));
+  }
+}