@mittwald/api-client 4.458.0 → 4.460.0

package/dist/esm/generated/v2/client-react.js

@@ -14,6 +14,10 @@ const buildAiHostingApi = (baseClient) => ({
     customerGetPlan: new ApiCallAsyncResourceFactory(descriptors.aiHostingCustomerGetPlan, baseClient.aiHosting.customerGetPlan).getApiResource,
     /** Get a list of currently active models. */
     getModels: new ApiCallAsyncResourceFactory(descriptors.aiHostingGetModels, baseClient.aiHosting.getModels).getApiResource,
+    /** List the contract months of an ai hosting plan. */
+    planGetBillingPeriods: new ApiCallAsyncResourceFactory(descriptors.aiHostingPlanGetBillingPeriods, baseClient.aiHosting.planGetBillingPeriods).getApiResource,
+    /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+    planGetUsageStats: new ApiCallAsyncResourceFactory(descriptors.aiHostingPlanGetUsageStats, baseClient.aiHosting.planGetUsageStats).getApiResource,
     /** Get a list of keys of a project. */
     projectGetKeys: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetKeys, baseClient.aiHosting.projectGetKeys).getApiResource,
     /** Get a key of a project. */

package/dist/esm/generated/v2/client.js

@@ -30,6 +30,10 @@ export class MittwaldAPIV2Client extends ApiClientBase {
         customerUpdatePlan: this.requestFunctionFactory(descriptors.aiHostingCustomerUpdatePlan),
         /** Get a list of currently active models. */
         getModels: this.requestFunctionFactory(descriptors.aiHostingGetModels),
+        /** List the contract months of an ai hosting plan. */
+        planGetBillingPeriods: this.requestFunctionFactory(descriptors.aiHostingPlanGetBillingPeriods),
+        /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+        planGetUsageStats: this.requestFunctionFactory(descriptors.aiHostingPlanGetUsageStats),
         /** Get a list of keys of a project. */
         projectGetKeys: this.requestFunctionFactory(descriptors.aiHostingProjectGetKeys),
         /** Creates a new key for a project. */

package/dist/esm/generated/v2/descriptors.js

@@ -70,6 +70,18 @@ export const aiHostingGetModels = {
     method: "GET",
     operationId: "ai-hosting-get-models",
 };
+/** List the contract months of an ai hosting plan. */
+export const aiHostingPlanGetBillingPeriods = {
+    path: "/v2/customers/{customerId}/ai-hostings/{planId}/billing-periods",
+    method: "GET",
+    operationId: "ai-hosting-plan-get-billing-periods",
+};
+/** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+export const aiHostingPlanGetUsageStats = {
+    path: "/v2/customers/{customerId}/ai-hostings/{planId}/usage",
+    method: "GET",
+    operationId: "ai-hosting-plan-get-usage-stats",
+};
 /** Get a list of keys of a project. */
 export const aiHostingProjectGetKeys = {
     path: "/v2/projects/{projectId}/ai-hosting-keys",

package/dist/esm/generated/v3-next/client-react.js

@@ -14,6 +14,10 @@ const buildAiHostingApi = (baseClient) => ({
     customerGetPlan: new ApiCallAsyncResourceFactory(descriptors.aiHostingCustomerGetPlan, baseClient.aiHosting.customerGetPlan).getApiResource,
     /** Get a list of currently active models. */
     getModels: new ApiCallAsyncResourceFactory(descriptors.aiHostingGetModels, baseClient.aiHosting.getModels).getApiResource,
+    /** List the contract months of an ai hosting plan. */
+    planGetBillingPeriods: new ApiCallAsyncResourceFactory(descriptors.aiHostingPlanGetBillingPeriods, baseClient.aiHosting.planGetBillingPeriods).getApiResource,
+    /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+    planGetUsageStats: new ApiCallAsyncResourceFactory(descriptors.aiHostingPlanGetUsageStats, baseClient.aiHosting.planGetUsageStats).getApiResource,
     /** Get a list of keys of a project. */
     projectGetKeys: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetKeys, baseClient.aiHosting.projectGetKeys).getApiResource,
     /** Get a key of a project. */

package/dist/esm/generated/v3-next/client.js

@@ -30,6 +30,10 @@ export class MittwaldAPIV3NextClient extends ApiClientBase {
         customerUpdatePlan: this.requestFunctionFactory(descriptors.aiHostingCustomerUpdatePlan),
         /** Get a list of currently active models. */
         getModels: this.requestFunctionFactory(descriptors.aiHostingGetModels),
+        /** List the contract months of an ai hosting plan. */
+        planGetBillingPeriods: this.requestFunctionFactory(descriptors.aiHostingPlanGetBillingPeriods),
+        /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+        planGetUsageStats: this.requestFunctionFactory(descriptors.aiHostingPlanGetUsageStats),
         /** Get a list of keys of a project. */
         projectGetKeys: this.requestFunctionFactory(descriptors.aiHostingProjectGetKeys),
         /** Creates a new key for a project. */

package/dist/esm/generated/v3-next/descriptors.js

@@ -70,6 +70,18 @@ export const aiHostingGetModels = {
     method: "GET",
     operationId: "ai-hosting-get-models",
 };
+/** List the contract months of an ai hosting plan. */
+export const aiHostingPlanGetBillingPeriods = {
+    path: "/v3-next/customers/{customerId}/ai-hostings/{planId}/billing-periods",
+    method: "GET",
+    operationId: "ai-hosting-plan-get-billing-periods",
+};
+/** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+export const aiHostingPlanGetUsageStats = {
+    path: "/v3-next/customers/{customerId}/ai-hostings/{planId}/usage",
+    method: "GET",
+    operationId: "ai-hosting-plan-get-usage-stats",
+};
 /** Get a list of keys of a project. */
 export const aiHostingProjectGetKeys = {
     path: "/v3-next/projects/{projectId}/ai-hosting-keys",

package/dist/esm/version.js

@@ -1 +1 @@
-export const MittwaldAPIClientVersion = '4.457.1';
+export const MittwaldAPIClientVersion = '4.459.0';

package/dist/types/generated/v2/client-react.d.ts

@@ -94,6 +94,62 @@ declare const buildAiHostingApi: (baseClient: MittwaldAPIV2Client) => {
             [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
         } | undefined;
     } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV2.Components.Schemas.AihostingModel[]>;
+    /** List the contract months of an ai hosting plan. */
+    planGetBillingPeriods: (conf: {
+        customerId: string;
+        planId: string;
+        headers?: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+        } | undefined;
+    }) => import("@mittwald/react-use-promise").AsyncResource<{
+        customerId: string;
+        nextTokenReset?: string | undefined;
+        periods: {
+            end: string;
+            isCurrent: boolean;
+            shortenedByUpgrade: boolean;
+            start: string;
+            tokenLimit: number;
+        }[];
+        planId: string;
+    }>;
+    /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+    planGetUsageStats: (conf: {
+        queryParameters: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            startDate: string;
+            endDate: string;
+            keyId?: string | undefined;
+        };
+        customerId: string;
+        planId: string;
+        headers?: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+        } | undefined;
+    }) => import("@mittwald/react-use-promise").AsyncResource<{
+        customerId: string;
+        daily: {
+            byKey: {
+                [k: string]: number;
+            };
+            date: string;
+            totalTokens: number;
+        }[];
+        keys: {
+            id: string;
+            name: string;
+        }[];
+        modelShare: {
+            model: string;
+            tokens: number;
+        }[];
+        planId: string;
+        timeframe: {
+            end: string;
+            start: string;
+        };
+        totalTokens: number;
+    }>;
     /** Get a list of keys of a project. */
     projectGetKeys: (conf: {
         projectId: string;

package/dist/types/generated/v2/client.d.ts

@@ -730,6 +730,180 @@ export declare class MittwaldAPIV2Client extends ApiClientBase {
         }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
             [x: string]: unknown;
         }, 429, "application/json">>>;
+        /** List the contract months of an ai hosting plan. */
+        planGetBillingPeriods: (request: {
+            customerId: string;
+            planId: string;
+            headers?: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            } | undefined;
+        }, opts?: import("@mittwald/api-client-commons").RequestOptions<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            nextTokenReset?: string | undefined;
+            periods: {
+                end: string;
+                isCurrent: boolean;
+                shortenedByUpgrade: boolean;
+                start: string;
+                tokenLimit: number;
+            }[];
+            planId: string;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>> | undefined) => import("@mittwald/api-client-commons").ResponsePromise<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            nextTokenReset?: string | undefined;
+            periods: {
+                end: string;
+                isCurrent: boolean;
+                shortenedByUpgrade: boolean;
+                start: string;
+                tokenLimit: number;
+            }[];
+            planId: string;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>>;
+        /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+        planGetUsageStats: (request: {
+            queryParameters: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            };
+            customerId: string;
+            planId: string;
+            headers?: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            } | undefined;
+        }, opts?: import("@mittwald/api-client-commons").RequestOptions<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        } & {
+            queryParameters: {
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            } & Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            daily: {
+                byKey: {
+                    [k: string]: number;
+                };
+                date: string;
+                totalTokens: number;
+            }[];
+            keys: {
+                id: string;
+                name: string;
+            }[];
+            modelShare: {
+                model: string;
+                tokens: number;
+            }[];
+            planId: string;
+            timeframe: {
+                end: string;
+                start: string;
+            };
+            totalTokens: number;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>> | undefined) => import("@mittwald/api-client-commons").ResponsePromise<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        } & {
+            queryParameters: {
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            } & Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            daily: {
+                byKey: {
+                    [k: string]: number;
+                };
+                date: string;
+                totalTokens: number;
+            }[];
+            keys: {
+                id: string;
+                name: string;
+            }[];
+            modelShare: {
+                model: string;
+                tokens: number;
+            }[];
+            planId: string;
+            timeframe: {
+                end: string;
+                start: string;
+            };
+            totalTokens: number;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>>;
         /** Get a list of keys of a project. */
         projectGetKeys: (request: {
             projectId: string;

package/dist/types/generated/v2/descriptors.d.ts

@@ -27,6 +27,10 @@ export declare const aiHostingCustomerGetPlan: OpenAPIOperation<RequestType<Simp
 export declare const aiHostingCustomerUpdatePlan: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Parameters.RequestBody>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.$204.Content.Empty>, 204, "empty"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanId.Put.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Get a list of currently active models. */
 export declare const aiHostingGetModels: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2AiHostingModels.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
+/** List the contract months of an ai hosting plan. */
+export declare const aiHostingPlanGetBillingPeriods: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
+/** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+export declare const aiHostingPlanGetUsageStats: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2CustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Get a list of keys of a project. */
 export declare const aiHostingProjectGetKeys: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ProjectsProjectIdAiHostingKeys.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Creates a new key for a project. */

package/dist/types/generated/v2/types.d.ts

@@ -50,6 +50,14 @@ export declare namespace MittwaldAPIV2 {
             type RequestData = InferredRequestData<typeof descriptors.aiHostingGetModels>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingGetModels, TStatus>;
         }
+        namespace AiHostingPlanGetBillingPeriods {
+            type RequestData = InferredRequestData<typeof descriptors.aiHostingPlanGetBillingPeriods>;
+            type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingPlanGetBillingPeriods, TStatus>;
+        }
+        namespace AiHostingPlanGetUsageStats {
+            type RequestData = InferredRequestData<typeof descriptors.aiHostingPlanGetUsageStats>;
+            type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingPlanGetUsageStats, TStatus>;
+        }
         namespace AiHostingProjectGetKeys {
             type RequestData = InferredRequestData<typeof descriptors.aiHostingProjectGetKeys>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingProjectGetKeys, TStatus>;
@@ -2006,6 +2014,30 @@ export declare namespace MittwaldAPIV2 {
                 termsOfServiceLink: string;
                 tokenFactor: number;
             }
+            interface AihostingPlanBillingPeriods {
+                customerId: string;
+                /**
+                 * End of the current period, i.e. when the token counter next resets.
+                 */
+                nextTokenReset?: string;
+                /**
+                 * Every contract month of the plan from its start up to the current one, anchored on the plan start date rather than the calendar.
+                 */
+                periods: {
+                    end: string;
+                    isCurrent: boolean;
+                    /**
+                     * True when an upgrade cut this period short: the token counter is reset immediately on an upgrade, so the period ends there instead of on the regular grid. A downgrade does not do this - it takes effect at the next regular boundary.
+                     */
+                    shortenedByUpgrade: boolean;
+                    start: string;
+                    /**
+                     * The limit that applied during this period, which after a tariff change differs from the plan's current limit.
+                     */
+                    tokenLimit: number;
+                }[];
+                planId: string;
+            }
             type AihostingPlanOptions = MittwaldAPIV2.Components.Schemas.AihostingCustomerPlan;
             interface AihostingPlanUsageBig {
                 available: number;
@@ -2017,6 +2049,33 @@ export declare namespace MittwaldAPIV2 {
                 planLimit: number;
                 used: number;
             }
+            interface AihostingPlanUsageStats {
+                customerId: string;
+                daily: {
+                    byKey: {
+                        [k: string]: number;
+                    };
+                    date: string;
+                    totalTokens: number;
+                }[];
+                /**
+                 * Every licence of the plan, most used in the timeframe first. Includes licences deleted inside the timeframe, which still carry usage but are no longer returned by the keys endpoint. Ordered, so callers can key chart colours off the position.
+                 */
+                keys: {
+                    id: string;
+                    name: string;
+                }[];
+                modelShare: {
+                    model: string;
+                    tokens: number;
+                }[];
+                planId: string;
+                timeframe: {
+                    end: string;
+                    start: string;
+                };
+                totalTokens: number;
+            }
             interface AihostingProfile {
                 planIds: string[];
             }
@@ -3687,7 +3746,7 @@ export declare namespace MittwaldAPIV2 {
             }
             interface DatabaseCreateMySqlUser {
                 /**
-                 * An IP range (in CIDR notation) for which access should be allowed.
+                 * An IP range (in CIDR notation) for which access should be allowed. This field currently has no effect.
                  */
                 accessIpMask?: string;
                 /**
@@ -3708,6 +3767,9 @@ export declare namespace MittwaldAPIV2 {
                 password: string;
             }
             interface DatabaseCreateMySqlUserWithDatabase {
+                /**
+                 * This field currently has no effect.
+                 */
                 accessIpMask?: string;
                 /**
                  * The access level that this MySQLUser should have for the database. The `full` access level grants the user read/write privileges on the database.
@@ -3792,7 +3854,7 @@ export declare namespace MittwaldAPIV2 {
             }
             interface DatabaseMySqlUser {
                 /**
-                 * An IP range (in CIDR notation) for which access should be allowed.
+                 * An IP range (in CIDR notation) for which access should be allowed. This field currently has no effect.
                  */
                 accessIpMask?: string;
                 /**
@@ -8114,6 +8176,118 @@ export declare namespace MittwaldAPIV2 {
                 }
             }
         }
+        namespace V2CustomersCustomerIdAiHostingsPlanIdBillingPeriods {
+            namespace Get {
+                namespace Parameters {
+                    type Path = {
+                        customerId: string;
+                        planId: string;
+                    };
+                    type Header = {};
+                    type Query = {};
+                }
+                namespace Responses {
+                    namespace $200 {
+                        namespace Content {
+                            type ApplicationJson = MittwaldAPIV2.Components.Schemas.AihostingPlanBillingPeriods;
+                        }
+                    }
+                    namespace $400 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $403 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $404 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $429 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace Default {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        namespace V2CustomersCustomerIdAiHostingsPlanIdUsage {
+            namespace Get {
+                namespace Parameters {
+                    type Path = {
+                        customerId: string;
+                        planId: string;
+                    };
+                    type Header = {};
+                    type Query = {
+                        startDate: string;
+                        endDate: string;
+                        keyId?: string;
+                    };
+                }
+                namespace Responses {
+                    namespace $200 {
+                        namespace Content {
+                            type ApplicationJson = MittwaldAPIV2.Components.Schemas.AihostingPlanUsageStats;
+                        }
+                    }
+                    namespace $400 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $403 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $404 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $429 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace Default {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                }
+            }
+        }
         namespace V2ProjectsProjectIdAiHostingKeys {
             namespace Get {
                 namespace Parameters {
@@ -17390,6 +17564,9 @@ export declare namespace MittwaldAPIV2 {
                         mysqlUserId: string;
                     };
                     interface RequestBody {
+                        /**
+                         * This field currently has no effect.
+                         */
                         accessIpMask?: string;
                         accessLevel?: "full" | "readonly";
                         description?: string;

package/dist/types/generated/v3-next/client-react.d.ts

@@ -94,6 +94,62 @@ declare const buildAiHostingApi: (baseClient: MittwaldAPIV3NextClient) => {
             [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
         } | undefined;
     } | null | undefined) => import("@mittwald/react-use-promise").AsyncResource<import("./types.js").MittwaldAPIV3Next.Components.Schemas.DeMittwaldAihostingModel[]>;
+    /** List the contract months of an ai hosting plan. */
+    planGetBillingPeriods: (conf: {
+        customerId: string;
+        planId: string;
+        headers?: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+        } | undefined;
+    }) => import("@mittwald/react-use-promise").AsyncResource<{
+        customerId: string;
+        nextTokenReset?: string | undefined;
+        periods: {
+            end: string;
+            isCurrent: boolean;
+            shortenedByUpgrade: boolean;
+            start: string;
+            tokenLimit: number;
+        }[];
+        planId: string;
+    }>;
+    /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+    planGetUsageStats: (conf: {
+        queryParameters: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            startDate: string;
+            endDate: string;
+            keyId?: string | undefined;
+        };
+        customerId: string;
+        planId: string;
+        headers?: {
+            [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+        } | undefined;
+    }) => import("@mittwald/react-use-promise").AsyncResource<{
+        customerId: string;
+        daily: {
+            byKey: {
+                [k: string]: number;
+            };
+            date: string;
+            totalTokens: number;
+        }[];
+        keys: {
+            id: string;
+            name: string;
+        }[];
+        modelShare: {
+            model: string;
+            tokens: number;
+        }[];
+        planId: string;
+        timeframe: {
+            end: string;
+            start: string;
+        };
+        totalTokens: number;
+    }>;
     /** Get a list of keys of a project. */
     projectGetKeys: (conf: {
         projectId: string;

package/dist/types/generated/v3-next/client.d.ts

@@ -730,6 +730,180 @@ export declare class MittwaldAPIV3NextClient extends ApiClientBase {
         }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
             [x: string]: unknown;
         }, 429, "application/json">>>;
+        /** List the contract months of an ai hosting plan. */
+        planGetBillingPeriods: (request: {
+            customerId: string;
+            planId: string;
+            headers?: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            } | undefined;
+        }, opts?: import("@mittwald/api-client-commons").RequestOptions<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            nextTokenReset?: string | undefined;
+            periods: {
+                end: string;
+                isCurrent: boolean;
+                shortenedByUpgrade: boolean;
+                start: string;
+                tokenLimit: number;
+            }[];
+            planId: string;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>> | undefined) => import("@mittwald/api-client-commons").ResponsePromise<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            nextTokenReset?: string | undefined;
+            periods: {
+                end: string;
+                isCurrent: boolean;
+                shortenedByUpgrade: boolean;
+                start: string;
+                tokenLimit: number;
+            }[];
+            planId: string;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>>;
+        /** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+        planGetUsageStats: (request: {
+            queryParameters: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            };
+            customerId: string;
+            planId: string;
+            headers?: {
+                [x: string]: (string | number | boolean) | (string | number | boolean)[] | undefined;
+            } | undefined;
+        }, opts?: import("@mittwald/api-client-commons").RequestOptions<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        } & {
+            queryParameters: {
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            } & Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            daily: {
+                byKey: {
+                    [k: string]: number;
+                };
+                date: string;
+                totalTokens: number;
+            }[];
+            keys: {
+                id: string;
+                name: string;
+            }[];
+            modelShare: {
+                model: string;
+                tokens: number;
+            }[];
+            planId: string;
+            timeframe: {
+                end: string;
+                start: string;
+            };
+            totalTokens: number;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>> | undefined) => import("@mittwald/api-client-commons").ResponsePromise<import("@mittwald/api-client-commons").OpenAPIOperation<{
+            headers?: Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        } & {
+            pathParameters: {
+                customerId: string;
+                planId: string;
+            };
+        } & {
+            queryParameters: {
+                startDate: string;
+                endDate: string;
+                keyId?: string | undefined;
+            } & Partial<{
+                [TKey: string]: (string | number | boolean) | (string | number | boolean)[];
+            }>;
+        }, import("@mittwald/api-client-commons").Response<{
+            customerId: string;
+            daily: {
+                byKey: {
+                    [k: string]: number;
+                };
+                date: string;
+                totalTokens: number;
+            }[];
+            keys: {
+                id: string;
+                name: string;
+            }[];
+            modelShare: {
+                model: string;
+                tokens: number;
+            }[];
+            planId: string;
+            timeframe: {
+                end: string;
+                start: string;
+            };
+            totalTokens: number;
+        }, 200, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 400, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 403, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 404, "application/json"> | import("@mittwald/api-client-commons").Response<{
+            [x: string]: unknown;
+        }, 429, "application/json">>>;
         /** Get a list of keys of a project. */
         projectGetKeys: (request: {
             projectId: string;

package/dist/types/generated/v3-next/descriptors.d.ts

@@ -27,6 +27,10 @@ export declare const aiHostingCustomerGetPlan: OpenAPIOperation<RequestType<Simp
 export declare const aiHostingCustomerUpdatePlan: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Parameters.RequestBody>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.$204.Content.Empty>, 204, "empty"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanId.Put.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Get a list of currently active models. */
 export declare const aiHostingGetModels: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextAiHostingModels.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
+/** List the contract months of an ai hosting plan. */
+export declare const aiHostingPlanGetBillingPeriods: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
+/** Get aggregated token usage statistics for an ai hosting plan of a customer. */
+export declare const aiHostingPlanGetUsageStats: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextCustomersCustomerIdAiHostingsPlanIdUsage.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Get a list of keys of a project. */
 export declare const aiHostingProjectGetKeys: OpenAPIOperation<RequestType<Simplify<null>, Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.$400.Content.ApplicationJson>, 400, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.$403.Content.ApplicationJson>, 403, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.$404.Content.ApplicationJson>, 404, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextProjectsProjectIdAiHostingKeys.Get.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Creates a new key for a project. */

package/dist/types/generated/v3-next/types.d.ts

@@ -50,6 +50,14 @@ export declare namespace MittwaldAPIV3Next {
             type RequestData = InferredRequestData<typeof descriptors.aiHostingGetModels>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingGetModels, TStatus>;
         }
+        namespace AiHostingPlanGetBillingPeriods {
+            type RequestData = InferredRequestData<typeof descriptors.aiHostingPlanGetBillingPeriods>;
+            type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingPlanGetBillingPeriods, TStatus>;
+        }
+        namespace AiHostingPlanGetUsageStats {
+            type RequestData = InferredRequestData<typeof descriptors.aiHostingPlanGetUsageStats>;
+            type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingPlanGetUsageStats, TStatus>;
+        }
         namespace AiHostingProjectGetKeys {
             type RequestData = InferredRequestData<typeof descriptors.aiHostingProjectGetKeys>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.aiHostingProjectGetKeys, TStatus>;
@@ -2006,6 +2014,30 @@ export declare namespace MittwaldAPIV3Next {
                 termsOfServiceLink: string;
                 tokenFactor: number;
             }
+            interface DeMittwaldAihostingPlanBillingPeriods {
+                customerId: string;
+                /**
+                 * End of the current period, i.e. when the token counter next resets.
+                 */
+                nextTokenReset?: string;
+                /**
+                 * Every contract month of the plan from its start up to the current one, anchored on the plan start date rather than the calendar.
+                 */
+                periods: {
+                    end: string;
+                    isCurrent: boolean;
+                    /**
+                     * True when an upgrade cut this period short: the token counter is reset immediately on an upgrade, so the period ends there instead of on the regular grid. A downgrade does not do this - it takes effect at the next regular boundary.
+                     */
+                    shortenedByUpgrade: boolean;
+                    start: string;
+                    /**
+                     * The limit that applied during this period, which after a tariff change differs from the plan's current limit.
+                     */
+                    tokenLimit: number;
+                }[];
+                planId: string;
+            }
             type DeMittwaldAihostingPlanOptions = MittwaldAPIV3Next.Components.Schemas.DeMittwaldAihostingCustomerPlan;
             interface DeMittwaldAihostingPlanUsageBig {
                 available: number;
@@ -2017,6 +2049,33 @@ export declare namespace MittwaldAPIV3Next {
                 planLimit: number;
                 used: number;
             }
+            interface DeMittwaldAihostingPlanUsageStats {
+                customerId: string;
+                daily: {
+                    byKey: {
+                        [k: string]: number;
+                    };
+                    date: string;
+                    totalTokens: number;
+                }[];
+                /**
+                 * Every licence of the plan, most used in the timeframe first. Includes licences deleted inside the timeframe, which still carry usage but are no longer returned by the keys endpoint. Ordered, so callers can key chart colours off the position.
+                 */
+                keys: {
+                    id: string;
+                    name: string;
+                }[];
+                modelShare: {
+                    model: string;
+                    tokens: number;
+                }[];
+                planId: string;
+                timeframe: {
+                    end: string;
+                    start: string;
+                };
+                totalTokens: number;
+            }
             interface DeMittwaldAihostingProfile {
                 planIds: string[];
             }
@@ -3687,7 +3746,7 @@ export declare namespace MittwaldAPIV3Next {
             }
             interface DeMittwaldDatabaseCreateMySqlUser {
                 /**
-                 * An IP range (in CIDR notation) for which access should be allowed.
+                 * An IP range (in CIDR notation) for which access should be allowed. This field currently has no effect.
                  */
                 accessIpMask?: string;
                 /**
@@ -3708,6 +3767,9 @@ export declare namespace MittwaldAPIV3Next {
                 password: string;
             }
             interface DeMittwaldDatabaseCreateMySqlUserWithDatabase {
+                /**
+                 * This field currently has no effect.
+                 */
                 accessIpMask?: string;
                 /**
                  * The access level that this MySQLUser should have for the database. The `full` access level grants the user read/write privileges on the database.
@@ -3792,7 +3854,7 @@ export declare namespace MittwaldAPIV3Next {
             }
             interface DeMittwaldDatabaseMySqlUser {
                 /**
-                 * An IP range (in CIDR notation) for which access should be allowed.
+                 * An IP range (in CIDR notation) for which access should be allowed. This field currently has no effect.
                  */
                 accessIpMask?: string;
                 /**
@@ -8118,6 +8180,118 @@ export declare namespace MittwaldAPIV3Next {
                 }
             }
         }
+        namespace V3NextCustomersCustomerIdAiHostingsPlanIdBillingPeriods {
+            namespace Get {
+                namespace Parameters {
+                    type Path = {
+                        customerId: string;
+                        planId: string;
+                    };
+                    type Header = {};
+                    type Query = {};
+                }
+                namespace Responses {
+                    namespace $200 {
+                        namespace Content {
+                            type ApplicationJson = MittwaldAPIV3Next.Components.Schemas.DeMittwaldAihostingPlanBillingPeriods;
+                        }
+                    }
+                    namespace $400 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $403 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $404 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $429 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace Default {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        namespace V3NextCustomersCustomerIdAiHostingsPlanIdUsage {
+            namespace Get {
+                namespace Parameters {
+                    type Path = {
+                        customerId: string;
+                        planId: string;
+                    };
+                    type Header = {};
+                    type Query = {
+                        startDate: string;
+                        endDate: string;
+                        keyId?: string;
+                    };
+                }
+                namespace Responses {
+                    namespace $200 {
+                        namespace Content {
+                            type ApplicationJson = MittwaldAPIV3Next.Components.Schemas.DeMittwaldAihostingPlanUsageStats;
+                        }
+                    }
+                    namespace $400 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $403 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $404 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace $429 {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                    namespace Default {
+                        namespace Content {
+                            interface ApplicationJson {
+                                [k: string]: unknown;
+                            }
+                        }
+                    }
+                }
+            }
+        }
         namespace V3NextProjectsProjectIdAiHostingKeys {
             namespace Get {
                 namespace Parameters {
@@ -17381,6 +17555,9 @@ export declare namespace MittwaldAPIV3Next {
                         mysqlUserId: string;
                     };
                     interface RequestBody {
+                        /**
+                         * This field currently has no effect.
+                         */
                         accessIpMask?: string;
                         accessLevel?: "full" | "readonly";
                         description?: string;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const MittwaldAPIClientVersion = '4.457.1';
+export declare const MittwaldAPIClientVersion = '4.459.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/api-client",
-  "version": "4.458.0",
+  "version": "4.460.0",
   "author": "Mittwald CM Service GmbH & Co. KG <opensource@mittwald.de>",
   "type": "module",
   "description": "Auto-generated client for the mittwald API",
@@ -72,11 +72,11 @@
     "test:compile": "run tsc --noEmit"
   },
   "dependencies": {
-    "@mittwald/api-client-commons": "^4.458.0",
+    "@mittwald/api-client-commons": "^4.460.0",
     "browser-or-node": "^3.0.0"
   },
   "devDependencies": {
-    "@mittwald/api-code-generator": "^4.458.0",
+    "@mittwald/api-code-generator": "^4.460.0",
     "@mittwald/react-use-promise": "^4.2.3",
     "@types/node": "^22.18.11",
     "@types/react": "^18.3.26",
@@ -106,5 +106,5 @@
       "optional": true
     }
   },
-  "gitHead": "3e20ca48dfd8b382b92b9f35c47755b53fe20595"
+  "gitHead": "412b2a3b85320a7e8ccbfbab4a9d40a7221af60f"
 }