@meetkai/mka1 0.54.48 → 0.54.49

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/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 is 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,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -20,6 +20,7 @@ import { ComputeTenants } from "./computetenants.js";
 import { ComputeUsage } from "./computeusage.js";
 import { ComputeVolumes } from "./computevolumes.js";
 import { Datasets } from "./datasets.js";
+import { Flags } from "./flags.js";
 import { Guardrails } from "./guardrails.js";
 import { Llm } from "./llm.js";
 import { Permissions } from "./permissions.js";
@@ -160,4 +161,9 @@ export class SDK extends ClientSDK {
   get datasets(): Datasets {
     return (this._datasets ??= new Datasets(this._options));
   }
+
+  private _flags?: Flags;
+  get flags(): Flags {
+    return (this._flags ??= new Flags(this._options));
+  }
 }