@homeflare/distilled-litellm 0.2.0

package/src/services/vantage.ts

@@ -0,0 +1,283 @@
+// AUTO-GENERATED by scripts/generate.ts from .generated-specs (pinned litellm-openapi @ 1.100.0 — see README). Do not edit.
+import * as S from "@distilled.cloud/core/schema";
+import * as Redacted from "effect/Redacted";
+import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
+import * as T from "../traits.ts";
+import {
+  LitellmProtocol,
+  type LitellmOpError,
+  type LitellmOpContext,
+} from "../protocol.ts";
+import * as Retry from "../retry.ts";
+
+export type { LitellmOpError, LitellmOpContext };
+
+export class UnprocessableEntity
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<UnprocessableEntity>()("UnprocessableEntity", {
+      code: S.Number,
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 422 }],
+  ) {}
+
+export interface DeleteVantageSettingsVantageDeleteDeleteRequest {}
+export const DeleteVantageSettingsVantageDeleteDeleteRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({}).pipe(
+      T.Http({ method: "DELETE", uri: "/vantage/delete", code: 200 }),
+    ),
+  ).annotate({
+    identifier: "DeleteVantageSettingsVantageDeleteDeleteRequest",
+  }) as any as S.Schema<DeleteVantageSettingsVantageDeleteDeleteRequest>;
+
+/** Response model for Vantage initialization */
+export interface VantageInitResponse {
+  message: string;
+  status: string;
+}
+export const VantageInitResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    message: S.String,
+    status: S.String,
+  }),
+).annotate({
+  identifier: "VantageInitResponse",
+}) as any as S.Schema<VantageInitResponse>;
+
+export interface GetVantageSettingsVantageSettingsGetRequest {}
+export const GetVantageSettingsVantageSettingsGetRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({}).pipe(
+      T.Http({ method: "GET", uri: "/vantage/settings", code: 200 }),
+    ),
+  ).annotate({
+    identifier: "GetVantageSettingsVantageSettingsGetRequest",
+  }) as any as S.Schema<GetVantageSettingsVantageSettingsGetRequest>;
+
+/** Response model for viewing Vantage settings with masked API key */
+export interface VantageSettingsView {
+  /** Masked API key showing only first 4 and last 4 characters */
+  api_key_masked?: string | null;
+  /** Vantage API base URL */
+  base_url?: string | null;
+  /** Masked integration token showing only first 4 and last 4 characters */
+  integration_token_masked?: string | null;
+  /** Configuration status */
+  status?: string | null;
+}
+export const VantageSettingsView = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    api_key_masked: S.optional(S.NullOr(S.String)),
+    base_url: S.optional(S.NullOr(S.String)),
+    integration_token_masked: S.optional(S.NullOr(S.String)),
+    status: S.optional(S.NullOr(S.String)),
+  }),
+).annotate({
+  identifier: "VantageSettingsView",
+}) as any as S.Schema<VantageSettingsView>;
+
+export interface PostInitVantageSettingsVantageInitRequest {
+  /** Vantage API key for authentication */
+  api_key: string | Redacted.Redacted<string>;
+  /** Vantage API base URL (default: https://api.vantage.sh) */
+  base_url?: string;
+  /** Vantage integration token for the cost-import endpoint */
+  integration_token: string;
+}
+export const PostInitVantageSettingsVantageInitRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      api_key: S.String.pipe(T.SensitiveValue({})),
+      base_url: S.optional(S.String),
+      integration_token: S.String,
+    }).pipe(T.Http({ method: "POST", uri: "/vantage/init", code: 200 })),
+  ).annotate({
+    identifier: "PostInitVantageSettingsVantageInitRequest",
+  }) as any as S.Schema<PostInitVantageSettingsVantageInitRequest>;
+
+export interface UpdateVantageSettingsVantageSettingsPutRequest {
+  /** New Vantage API key for authentication */
+  api_key?: string | null;
+  /** New Vantage API base URL */
+  base_url?: string | null;
+  /** New Vantage integration token */
+  integration_token?: string | null;
+}
+export const UpdateVantageSettingsVantageSettingsPutRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      api_key: S.optional(S.NullOr(S.String)),
+      base_url: S.optional(S.NullOr(S.String)),
+      integration_token: S.optional(S.NullOr(S.String)),
+    }).pipe(T.Http({ method: "PUT", uri: "/vantage/settings", code: 200 })),
+  ).annotate({
+    identifier: "UpdateVantageSettingsVantageSettingsPutRequest",
+  }) as any as S.Schema<UpdateVantageSettingsVantageSettingsPutRequest>;
+
+export interface VantageDryRunExportVantageDryRunPostRequest {
+  /** Limit on number of records to preview (default: 500) */
+  limit?: number | null;
+}
+export const VantageDryRunExportVantageDryRunPostRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      limit: S.optional(S.NullOr(S.Number)),
+    }).pipe(T.Http({ method: "POST", uri: "/vantage/dry-run", code: 200 })),
+  ).annotate({
+    identifier: "VantageDryRunExportVantageDryRunPostRequest",
+  }) as any as S.Schema<VantageDryRunExportVantageDryRunPostRequest>;
+
+export type VantageExportResponseDryRunDataMap = {
+  [key: string]: unknown | undefined;
+};
+export const VantageExportResponseDryRunDataMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<VantageExportResponseDryRunDataMap>;
+
+export type VantageExportResponseSummaryMap = {
+  [key: string]: unknown | undefined;
+};
+export const VantageExportResponseSummaryMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<VantageExportResponseSummaryMap>;
+
+/** Response model for Vantage export operations */
+export interface VantageExportResponse {
+  /** Dry run data including usage data and FOCUS transformed data */
+  dry_run_data?: VantageExportResponseDryRunDataMap | null;
+  message: string;
+  status: string;
+  /** Summary statistics for dry run */
+  summary?: VantageExportResponseSummaryMap | null;
+}
+export const VantageExportResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    dry_run_data: S.optional(S.NullOr(VantageExportResponseDryRunDataMap)),
+    message: S.String,
+    status: S.String,
+    summary: S.optional(S.NullOr(VantageExportResponseSummaryMap)),
+  }),
+).annotate({
+  identifier: "VantageExportResponse",
+}) as any as S.Schema<VantageExportResponse>;
+
+export interface VantageExportVantageExportPostRequest {
+  /** End time for data export in UTC */
+  end_time_utc?: string | null;
+  /** Optional limit on number of records to export (default: no limit) */
+  limit?: number | null;
+  /** Start time for data export in UTC */
+  start_time_utc?: string | null;
+}
+export const VantageExportVantageExportPostRequest = /*@__PURE__*/ S.suspend(
+  () =>
+    S.Struct({
+      end_time_utc: S.optional(S.NullOr(S.String)),
+      limit: S.optional(S.NullOr(S.Number)),
+      start_time_utc: S.optional(S.NullOr(S.String)),
+    }).pipe(T.Http({ method: "POST", uri: "/vantage/export", code: 200 })),
+).annotate({
+  identifier: "VantageExportVantageExportPostRequest",
+}) as any as S.Schema<VantageExportVantageExportPostRequest>;
+
+export type DeleteVantageSettingsVantageDeleteDeleteError = LitellmOpError;
+/** Delete Vantage Settings Delete Vantage settings from the database. Only admin users can delete Vantage settings. */
+export const deleteVantageSettingsVantageDeleteDelete: API.OperationMethod<
+  DeleteVantageSettingsVantageDeleteDeleteRequest,
+  VantageInitResponse,
+  DeleteVantageSettingsVantageDeleteDeleteError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: DeleteVantageSettingsVantageDeleteDeleteRequest,
+  output: VantageInitResponse,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetVantageSettingsVantageSettingsGetError = LitellmOpError;
+/** Get Vantage Settings View current Vantage settings. Returns the current Vantage configuration with the API key masked for security. Only admin users (Proxy Admin or Admin Viewer) can view Vantage settings. */
+export const getVantageSettingsVantageSettingsGet: API.OperationMethod<
+  GetVantageSettingsVantageSettingsGetRequest,
+  VantageSettingsView,
+  GetVantageSettingsVantageSettingsGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetVantageSettingsVantageSettingsGetRequest,
+  output: VantageSettingsView,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type PostInitVantageSettingsVantageInitError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Init Vantage Settings Initialize Vantage settings and store in the database. Parameters: - api_key: Vantage API key for authentication - integration_token: Vantage integration token for the cost-import endpoint - base_url: Vantage API base URL (default: https://api.vantage.sh) Only admin users can configure Vantage settings. */
+export const postInitVantageSettingsVantageInit: API.OperationMethod<
+  PostInitVantageSettingsVantageInitRequest,
+  VantageInitResponse,
+  PostInitVantageSettingsVantageInitError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: PostInitVantageSettingsVantageInitRequest,
+  output: VantageInitResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UpdateVantageSettingsVantageSettingsPutError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Update Vantage Settings Update existing Vantage settings. Allows updating individual Vantage configuration fields without requiring all fields. Only admin users can update Vantage settings. */
+export const updateVantageSettingsVantageSettingsPut: API.OperationMethod<
+  UpdateVantageSettingsVantageSettingsPutRequest,
+  VantageInitResponse,
+  UpdateVantageSettingsVantageSettingsPutError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UpdateVantageSettingsVantageSettingsPutRequest,
+  output: VantageInitResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type VantageDryRunExportVantageDryRunPostError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Vantage Dry Run Export Perform a dry run export using the Vantage logger. Returns the data that would be exported without actually sending it to Vantage. Parameters: - limit: Limit on number of records to preview (default: 500) Only admin users can perform Vantage exports. */
+export const vantageDryRunExportVantageDryRunPost: API.OperationMethod<
+  VantageDryRunExportVantageDryRunPostRequest,
+  VantageExportResponse,
+  VantageDryRunExportVantageDryRunPostError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: VantageDryRunExportVantageDryRunPostRequest,
+  output: VantageExportResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type VantageExportVantageExportPostError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Vantage Export Perform an actual export using the Vantage logger. Exports usage data in FOCUS CSV format to the Vantage API. Parameters: - limit: Optional limit on number of records to export - start_time_utc: Optional start time for data export - end_time_utc: Optional end time for data export Only admin users can perform Vantage exports. */
+export const vantageExportVantageExportPost: API.OperationMethod<
+  VantageExportVantageExportPostRequest,
+  VantageExportResponse,
+  VantageExportVantageExportPostError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: VantageExportVantageExportPostRequest,
+  output: VantageExportResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));