@meetkai/mka1 0.54.50 → 0.54.51

package/src/models/components/repotag.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type RepoTag = {
+  /**
+   * The manifest the tag points at, `sha256:<hex>`.
+   */
+  digest: string;
+  /**
+   * The manifest's media type, as the registry serves it.
+   */
+  mediaType: string;
+  /**
+   * The image's total size in bytes as its manifest declares it (the
+   *
+   * @remarks
+   * config plus every layer — what `docker images` prints), or `null`
+   * when the manifest states no total: a multi-arch index, whose
+   * sizes belong to its per-platform children.
+   */
+  size: number | null;
+  tag: string;
+  /**
+   * When the tag was last pushed or moved.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const RepoTag$inboundSchema: z.ZodType<RepoTag, z.ZodTypeDef, unknown> =
+  z.object({
+    digest: z.string(),
+    media_type: z.string(),
+    size: z.nullable(z.number().int()),
+    tag: z.string(),
+    updated_at: z.string().datetime({ offset: true }).transform(v =>
+      new Date(v)
+    ),
+  }).transform((v) => {
+    return remap$(v, {
+      "media_type": "mediaType",
+      "updated_at": "updatedAt",
+    });
+  });
+/** @internal */
+export type RepoTag$Outbound = {
+  digest: string;
+  media_type: string;
+  size: number | null;
+  tag: string;
+  updated_at: string;
+};
+
+/** @internal */
+export const RepoTag$outboundSchema: z.ZodType<
+  RepoTag$Outbound,
+  z.ZodTypeDef,
+  RepoTag
+> = z.object({
+  digest: z.string(),
+  mediaType: z.string(),
+  size: z.nullable(z.number().int()),
+  tag: z.string(),
+  updatedAt: z.date().transform(v => v.toISOString()),
+}).transform((v) => {
+  return remap$(v, {
+    mediaType: "media_type",
+    updatedAt: "updated_at",
+  });
+});
+
+export function repoTagToJSON(repoTag: RepoTag): string {
+  return JSON.stringify(RepoTag$outboundSchema.parse(repoTag));
+}
+export function repoTagFromJSON(
+  jsonString: string,
+): SafeParseResult<RepoTag, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RepoTag$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RepoTag' from JSON`,
+  );
+}

package/src/models/components/repotaglist.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  RepoTag,
+  RepoTag$inboundSchema,
+  RepoTag$Outbound,
+  RepoTag$outboundSchema,
+} from "./repotag.js";
+
+export type RepoTagList = {
+  /**
+   * Newest-moved first.
+   */
+  tags: Array<RepoTag>;
+  /**
+   * `true` when the repository holds more tags than this one page
+   *
+   * @remarks
+   * (1000) shows. Never silently cut.
+   */
+  truncated: boolean;
+};
+
+/** @internal */
+export const RepoTagList$inboundSchema: z.ZodType<
+  RepoTagList,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tags: z.array(RepoTag$inboundSchema),
+  truncated: z.boolean(),
+});
+/** @internal */
+export type RepoTagList$Outbound = {
+  tags: Array<RepoTag$Outbound>;
+  truncated: boolean;
+};
+
+/** @internal */
+export const RepoTagList$outboundSchema: z.ZodType<
+  RepoTagList$Outbound,
+  z.ZodTypeDef,
+  RepoTagList
+> = z.object({
+  tags: z.array(RepoTag$outboundSchema),
+  truncated: z.boolean(),
+});
+
+export function repoTagListToJSON(repoTagList: RepoTagList): string {
+  return JSON.stringify(RepoTagList$outboundSchema.parse(repoTagList));
+}
+export function repoTagListFromJSON(
+  jsonString: string,
+): SafeParseResult<RepoTagList, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RepoTagList$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RepoTagList' from JSON`,
+  );
+}

package/src/models/operations/deleterepotag.ts

@@ -0,0 +1,84 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type DeleteRepoTagRequest = {
+  /**
+   * The organization URL slug.
+   */
+  org: string;
+  /**
+   * The repository name (URL label).
+   */
+  name: string;
+  /**
+   * The image tag, exactly as pushed (tags are case-sensitive).
+   */
+  tag: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const DeleteRepoTagRequest$inboundSchema: z.ZodType<
+  DeleteRepoTagRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  tag: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type DeleteRepoTagRequest$Outbound = {
+  org: string;
+  name: string;
+  tag: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const DeleteRepoTagRequest$outboundSchema: z.ZodType<
+  DeleteRepoTagRequest$Outbound,
+  z.ZodTypeDef,
+  DeleteRepoTagRequest
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  tag: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function deleteRepoTagRequestToJSON(
+  deleteRepoTagRequest: DeleteRepoTagRequest,
+): string {
+  return JSON.stringify(
+    DeleteRepoTagRequest$outboundSchema.parse(deleteRepoTagRequest),
+  );
+}
+export function deleteRepoTagRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<DeleteRepoTagRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeleteRepoTagRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeleteRepoTagRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -115,6 +115,7 @@ export * from "./deleteorgautomodel.js";
 export * from "./deleteorgbudget.js";
 export * from "./deleteprompt.js";
 export * from "./deleterepo.js";
+export * from "./deleterepotag.js";
 export * from "./deleteresponse.js";
 export * from "./deleteserviceaccount.js";
 export * from "./deleteserviceaccountapikey.js";
@@ -296,6 +297,7 @@ export * from "./listprompts.js";
 export * from "./listpromptversions.js";
 export * from "./listrepos.js";
 export * from "./listrepositoriesapiv1sandboxgithubrepositoriesget.js";
+export * from "./listrepotags.js";
 export * from "./listresponsefeedback.js";
 export * from "./listresponses.js";
 export * from "./listscopedapikeys.js";

package/src/models/operations/listrepotags.ts

@@ -0,0 +1,77 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type ListRepoTagsRequest = {
+  /**
+   * The organization URL slug.
+   */
+  org: string;
+  /**
+   * The repository name (URL label).
+   */
+  name: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const ListRepoTagsRequest$inboundSchema: z.ZodType<
+  ListRepoTagsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type ListRepoTagsRequest$Outbound = {
+  org: string;
+  name: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const ListRepoTagsRequest$outboundSchema: z.ZodType<
+  ListRepoTagsRequest$Outbound,
+  z.ZodTypeDef,
+  ListRepoTagsRequest
+> = z.object({
+  org: z.string(),
+  name: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function listRepoTagsRequestToJSON(
+  listRepoTagsRequest: ListRepoTagsRequest,
+): string {
+  return JSON.stringify(
+    ListRepoTagsRequest$outboundSchema.parse(listRepoTagsRequest),
+  );
+}
+export function listRepoTagsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<ListRepoTagsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListRepoTagsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListRepoTagsRequest' from JSON`,
+  );
+}

package/src/react-query/index.ts

@@ -392,6 +392,8 @@ export * from "./reposCreate.js";
 export * from "./reposDelete.js";
 export * from "./reposGet.js";
 export * from "./reposList.js";
+export * from "./reposTagsDelete.js";
+export * from "./reposTagsList.js";
 export * from "./reposUpdate.js";
 export * from "./sandboxCreate.js";
 export * from "./sandboxDownloadArchive.js";

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"],
+  });
+}