@meetkai/mka1 0.54.48 → 0.54.50

package/src/react-query/flagsUnarchive.ts

@@ -0,0 +1,108 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { flagsUnarchive } from "../funcs/flagsUnarchive.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.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 FlagsUnarchiveMutationVariables = {
+  request: operations.UnarchiveFeatureFlagRequest;
+  options?: RequestOptions;
+};
+
+export type FlagsUnarchiveMutationData = components.FeatureFlagDetail;
+
+export type FlagsUnarchiveMutationError =
+  | errors.FeatureFlagError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Restore an archived flag
+ */
+export function useFlagsUnarchiveMutation(
+  options?: MutationHookOptions<
+    FlagsUnarchiveMutationData,
+    FlagsUnarchiveMutationError,
+    FlagsUnarchiveMutationVariables
+  >,
+): UseMutationResult<
+  FlagsUnarchiveMutationData,
+  FlagsUnarchiveMutationError,
+  FlagsUnarchiveMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildFlagsUnarchiveMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyFlagsUnarchive(): MutationKey {
+  return ["@meetkai/mka1", "flags", "unarchive"];
+}
+
+export function buildFlagsUnarchiveMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: FlagsUnarchiveMutationVariables,
+  ) => Promise<FlagsUnarchiveMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyFlagsUnarchive(),
+    mutationFn: function flagsUnarchiveMutationFn({
+      request,
+      options,
+    }): Promise<FlagsUnarchiveMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(flagsUnarchive(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/flagsUpdate.ts

@@ -0,0 +1,108 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { flagsUpdate } from "../funcs/flagsUpdate.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.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 FlagsUpdateMutationVariables = {
+  request: operations.UpdateFeatureFlagRequest;
+  options?: RequestOptions;
+};
+
+export type FlagsUpdateMutationData = components.FeatureFlagDetail;
+
+export type FlagsUpdateMutationError =
+  | errors.FeatureFlagError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Update a flag's name, description, or default value
+ */
+export function useFlagsUpdateMutation(
+  options?: MutationHookOptions<
+    FlagsUpdateMutationData,
+    FlagsUpdateMutationError,
+    FlagsUpdateMutationVariables
+  >,
+): UseMutationResult<
+  FlagsUpdateMutationData,
+  FlagsUpdateMutationError,
+  FlagsUpdateMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildFlagsUpdateMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyFlagsUpdate(): MutationKey {
+  return ["@meetkai/mka1", "flags", "update"];
+}
+
+export function buildFlagsUpdateMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: FlagsUpdateMutationVariables,
+  ) => Promise<FlagsUpdateMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyFlagsUpdate(),
+    mutationFn: function flagsUpdateMutationFn({
+      request,
+      options,
+    }): Promise<FlagsUpdateMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(flagsUpdate(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -166,6 +166,23 @@ export * from "./datasetsListFormats.js";
 export * from "./datasetsListGenerations.js";
 export * from "./datasetsListGenerators.js";
 export * from "./datasetsQuoteGenerator.js";
+export * from "./flagsArchive.js";
+export * from "./flagsAuditList.js";
+export * from "./flagsCreate.js";
+export * from "./flagsDelete.js";
+export * from "./flagsEnvironmentsCreate.js";
+export * from "./flagsEnvironmentsDelete.js";
+export * from "./flagsEnvironmentsEvaluate.js";
+export * from "./flagsEnvironmentsEvaluateWithTraits.js";
+export * from "./flagsEnvironmentsGenerateEvaluationKey.js";
+export * from "./flagsEnvironmentsList.js";
+export * from "./flagsEnvironmentsRevokeEvaluationKey.js";
+export * from "./flagsEnvironmentsUpdate.js";
+export * from "./flagsGet.js";
+export * from "./flagsList.js";
+export * from "./flagsSetEnvironmentState.js";
+export * from "./flagsUnarchive.js";
+export * from "./flagsUpdate.js";
 export * from "./guardrailsDeleteGuardrails.js";
 export * from "./guardrailsGetGuardrails.js";
 export * from "./guardrailsListGuardrailsPolicies.js";

package/src/react-query/reposCreate.ts

@@ -52,7 +52,9 @@ export type ReposCreateMutationError =
  * @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).
  */
 export function useReposCreateMutation(
   options?: MutationHookOptions<

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

@@ -11,6 +11,7 @@ import { SDKCore } from "../core.js";
 import { reposList } from "../funcs/reposList.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 ReposListQueryData = operations.ListReposResponseBody;
@@ -39,7 +40,10 @@ export function buildReposListQuery(
   queryFn: (context: QueryFunctionContext) => Promise<ReposListQueryData>;
 } {
   return {
-    queryKey: queryKeyReposList({ xOnBehalfOf: request.xOnBehalfOf }),
+    queryKey: queryKeyReposList({
+      kind: request.kind,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
     queryFn: async function reposListQueryFn(ctx): Promise<ReposListQueryData> {
       const sig = combineSignals(
         ctx.signal,
@@ -62,7 +66,10 @@ export function buildReposListQuery(
 }
 
 export function queryKeyReposList(
-  parameters: { xOnBehalfOf?: string | undefined },
+  parameters: {
+    kind?: components.RepoKind | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
 ): QueryKey {
   return ["@meetkai/mka1", "repos", "list", parameters];
 }

package/src/react-query/reposList.ts

@@ -10,6 +10,7 @@ import {
   useSuspenseQuery,
   UseSuspenseQueryResult,
 } from "@tanstack/react-query";
+import * as components from "../models/components/index.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -57,7 +58,9 @@ export type ReposListQueryError =
  *
  * @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.
  */
 export function useReposList(
   request: operations.ListReposRequest,
@@ -79,7 +82,9 @@ export function useReposList(
  *
  * @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.
  */
 export function useReposListSuspense(
   request: operations.ListReposRequest,
@@ -98,7 +103,12 @@ export function useReposListSuspense(
 
 export function setReposListData(
   client: QueryClient,
-  queryKeyBase: [parameters: { xOnBehalfOf?: string | undefined }],
+  queryKeyBase: [
+    parameters: {
+      kind?: components.RepoKind | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
   data: ReposListQueryData,
 ): ReposListQueryData | undefined {
   const key = queryKeyReposList(...queryKeyBase);
@@ -109,7 +119,10 @@ export function setReposListData(
 export function invalidateReposList(
   client: QueryClient,
   queryKeyBase: TupleToPrefixes<
-    [parameters: { xOnBehalfOf?: string | undefined }]
+    [parameters: {
+      kind?: components.RepoKind | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
   >,
   filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
 ): Promise<void> {

package/src/react-query/reposUpdate.ts

@@ -50,9 +50,18 @@ 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
+ * 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.
  */
 export function useReposUpdateMutation(
   options?: MutationHookOptions<

package/src/sdk/audit.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { flagsAuditList } from "../funcs/flagsAuditList.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 Audit extends ClientSDK {
+  /**
+   * List audit entries, newest first
+   */
+  async list(
+    request: operations.ListFeatureFlagAuditEntriesRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagAuditPage> {
+    return unwrapAsync(flagsAuditList(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/environments.ts

@@ -0,0 +1,146 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { flagsEnvironmentsCreate } from "../funcs/flagsEnvironmentsCreate.js";
+import { flagsEnvironmentsDelete } from "../funcs/flagsEnvironmentsDelete.js";
+import { flagsEnvironmentsEvaluate } from "../funcs/flagsEnvironmentsEvaluate.js";
+import { flagsEnvironmentsEvaluateWithTraits } from "../funcs/flagsEnvironmentsEvaluateWithTraits.js";
+import { flagsEnvironmentsGenerateEvaluationKey } from "../funcs/flagsEnvironmentsGenerateEvaluationKey.js";
+import { flagsEnvironmentsList } from "../funcs/flagsEnvironmentsList.js";
+import { flagsEnvironmentsRevokeEvaluationKey } from "../funcs/flagsEnvironmentsRevokeEvaluationKey.js";
+import { flagsEnvironmentsUpdate } from "../funcs/flagsEnvironmentsUpdate.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 Environments extends ClientSDK {
+  /**
+   * List environments
+   */
+  async list(
+    request: operations.ListFeatureFlagEnvironmentsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.FeatureFlagEnvironment>> {
+    return unwrapAsync(flagsEnvironmentsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create an environment
+   *
+   * @remarks
+   * Every existing flag gets a disabled state in the new environment.
+   */
+  async create(
+    request: operations.CreateFeatureFlagEnvironmentRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagEnvironment> {
+    return unwrapAsync(flagsEnvironmentsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete an environment and every flag setting in it
+   */
+  async delete(
+    request: operations.DeleteFeatureFlagEnvironmentRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(flagsEnvironmentsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Rename an environment
+   */
+  async update(
+    request: operations.UpdateFeatureFlagEnvironmentRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagEnvironment> {
+    return unwrapAsync(flagsEnvironmentsUpdate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Evaluate every flag for an identity
+   *
+   * @remarks
+   * Resolves every non-archived flag of the environment for an anonymous caller, or for the identity given in the query. Sends an ETag and answers 304 to a matching If-None-Match after authenticating the environment evaluation key.
+   */
+  async evaluate(
+    security: operations.EvaluateFeatureFlagsSecurity,
+    request: operations.EvaluateFeatureFlagsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.EvaluateFeatureFlagsResponse | undefined> {
+    return unwrapAsync(flagsEnvironmentsEvaluate(
+      this,
+      security,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Evaluate every flag for an identity with traits
+   */
+  async evaluateWithTraits(
+    security: operations.EvaluateFeatureFlagsWithTraitsSecurity,
+    request: operations.EvaluateFeatureFlagsWithTraitsRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagEvaluateResponse> {
+    return unwrapAsync(flagsEnvironmentsEvaluateWithTraits(
+      this,
+      security,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Revoke an environment evaluation key
+   *
+   * @remarks
+   * Revocation is idempotent while the environment exists.
+   */
+  async revokeEvaluationKey(
+    request: operations.RevokeFeatureFlagEvaluationKeyRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(flagsEnvironmentsRevokeEvaluationKey(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Generate or replace an environment evaluation key
+   *
+   * @remarks
+   * 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,
+    options?: RequestOptions,
+  ): Promise<operations.GenerateFeatureFlagEvaluationKeyResponse> {
+    return unwrapAsync(flagsEnvironmentsGenerateEvaluationKey(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/flags.ts

@@ -0,0 +1,151 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { flagsArchive } from "../funcs/flagsArchive.js";
+import { flagsCreate } from "../funcs/flagsCreate.js";
+import { flagsDelete } from "../funcs/flagsDelete.js";
+import { flagsGet } from "../funcs/flagsGet.js";
+import { flagsList } from "../funcs/flagsList.js";
+import { flagsSetEnvironmentState } from "../funcs/flagsSetEnvironmentState.js";
+import { flagsUnarchive } from "../funcs/flagsUnarchive.js";
+import { flagsUpdate } from "../funcs/flagsUpdate.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";
+import { Audit } from "./audit.js";
+import { Environments } from "./environments.js";
+
+export class Flags extends ClientSDK {
+  private _audit?: Audit;
+  get audit(): Audit {
+    return (this._audit ??= new Audit(this._options));
+  }
+
+  private _environments?: Environments;
+  get environments(): Environments {
+    return (this._environments ??= new Environments(this._options));
+  }
+
+  /**
+   * List flags
+   *
+   * @remarks
+   * Every flag with a per-environment digest of its state.
+   */
+  async list(
+    request: operations.ListFeatureFlagsRequest,
+    options?: RequestOptions,
+  ): Promise<Array<components.FeatureFlagListItem>> {
+    return unwrapAsync(flagsList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a flag
+   *
+   * @remarks
+   * The flag starts disabled in every environment.
+   */
+  async create(
+    request: operations.CreateFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagDetail> {
+    return unwrapAsync(flagsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a flag and its settings in every environment
+   */
+  async delete(
+    request: operations.DeleteFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(flagsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a flag
+   */
+  async get(
+    request: operations.GetFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagDetail> {
+    return unwrapAsync(flagsGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update a flag's name, description, or default value
+   */
+  async update(
+    request: operations.UpdateFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagDetail> {
+    return unwrapAsync(flagsUpdate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Archive a flag
+   *
+   * @remarks
+   * Archived flags are excluded from evaluation in every environment; their settings are kept.
+   */
+  async archive(
+    request: operations.ArchiveFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagDetail> {
+    return unwrapAsync(flagsArchive(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Replace a flag's settings in one environment
+   */
+  async setEnvironmentState(
+    request: operations.SetFeatureFlagEnvironmentStateRequest,
+    options?: RequestOptions,
+  ): Promise<operations.SetFeatureFlagEnvironmentStateResponse> {
+    return unwrapAsync(flagsSetEnvironmentState(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Restore an archived flag
+   */
+  async unarchive(
+    request: operations.UnarchiveFeatureFlagRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagDetail> {
+    return unwrapAsync(flagsUnarchive(
+      this,
+      request,
+      options,
+    ));
+  }
+}