@mittwald/api-client 4.458.0 → 4.459.0

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

@@ -24,6 +24,10 @@ const buildAiHostingApi = (baseClient) => ({
     projectGetPlan: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetPlan, baseClient.aiHosting.projectGetPlan).getApiResource,
     /** Get all ai hosting plans and usages of a project. */
     projectGetPlans: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetPlans, baseClient.aiHosting.projectGetPlans).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,
 });
 const buildAppApi = (baseClient) => ({
     /** Get the installed `SystemSoftware' for a specific `AppInstallation`. */

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

@@ -48,6 +48,10 @@ export class MittwaldAPIV2Client extends ApiClientBase {
         projectGetPlans: this.requestFunctionFactory(descriptors.aiHostingProjectGetPlans),
         /** Links a container with a project licence. */
         projectLinkContainer: this.requestFunctionFactory(descriptors.aiHostingProjectLinkContainer),
+        /** 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),
     };
     /** The App API allows you to manage your apps within a project, and all the system softwares that are installed as dependencies. */
     app = {

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

@@ -2860,3 +2860,15 @@ export const verificationVerifyCompany = {
     method: "POST",
     operationId: "verification-verify-company",
 };
+/** 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",
+};

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

@@ -24,6 +24,10 @@ const buildAiHostingApi = (baseClient) => ({
     projectGetPlan: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetPlan, baseClient.aiHosting.projectGetPlan).getApiResource,
     /** Get all ai hosting plans and usages of a project. */
     projectGetPlans: new ApiCallAsyncResourceFactory(descriptors.aiHostingProjectGetPlans, baseClient.aiHosting.projectGetPlans).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,
 });
 const buildAppApi = (baseClient) => ({
     /** Get the installed `SystemSoftware' for a specific `AppInstallation`. */

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

@@ -48,6 +48,10 @@ export class MittwaldAPIV3NextClient extends ApiClientBase {
         projectGetPlans: this.requestFunctionFactory(descriptors.aiHostingProjectGetPlans),
         /** Links a container with a project licence. */
         projectLinkContainer: this.requestFunctionFactory(descriptors.aiHostingProjectLinkContainer),
+        /** 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),
     };
     /** The App API allows you to manage your apps within a project, and all the system softwares that are installed as dependencies. */
     app = {

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

@@ -2860,3 +2860,15 @@ export const verificationVerifyCompany = {
     method: "POST",
     operationId: "verification-verify-company",
 };
+/** 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",
+};

package/dist/esm/version.js

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

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

@@ -167,6 +167,62 @@ declare const buildAiHostingApi: (baseClient: MittwaldAPIV2Client) => {
         modelTermsApprovalRequired: boolean;
         plans: import("./types.js").MittwaldAPIV2.Components.Schemas.AihostingProjectPlan[];
     }>;
+    /** 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;
+    }>;
 };
 declare const buildAppApi: (baseClient: MittwaldAPIV2Client) => {
     /** Get the installed `SystemSoftware' for a specific `AppInstallation`. */

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

@@ -1317,6 +1317,180 @@ export declare class MittwaldAPIV2Client extends ApiClientBase {
         }, 412, "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">>>;
     };
     /** The App API allows you to manage your apps within a project, and all the system softwares that are installed as dependencies. */
     readonly app: {

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

@@ -957,3 +957,7 @@ export declare const verificationDetectPhishingEmail: OpenAPIOperation<RequestTy
 export declare const verificationVerifyAddress: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Parameters.RequestBody>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyAddress.Post.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Check if a company exists. */
 export declare const verificationVerifyCompany: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Parameters.RequestBody>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Parameters.Path>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Parameters.Query>, Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Parameters.Header>>, Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Responses.$412.Content.Empty>, 412, "empty"> | Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV2.Paths.V2ActionsVerifyCompany.Post.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">>;

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

@@ -1910,6 +1910,14 @@ export declare namespace MittwaldAPIV2 {
             type RequestData = InferredRequestData<typeof descriptors.verificationVerifyCompany>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.verificationVerifyCompany, 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 Components {
         namespace Schemas {
@@ -7238,6 +7246,57 @@ export declare namespace MittwaldAPIV2 {
             }
             type VerificationEmailOrigin = "IS_MITTWALD" | "IS_NOT_MITTWALD" | "COULD_BE_MITTWALD";
             type ContainerVolumeSortOrder = "nameAsc" | "nameDesc" | "storageAsc" | "storageDesc";
+            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;
+            }
+            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 CommonsAddress {
                 street: string;
                 houseNumber: string;
@@ -32111,5 +32170,117 @@ 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;
+                            }
+                        }
+                    }
+                }
+            }
+        }
     }
 }

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

@@ -167,6 +167,62 @@ declare const buildAiHostingApi: (baseClient: MittwaldAPIV3NextClient) => {
         modelTermsApprovalRequired: boolean;
         plans: import("./types.js").MittwaldAPIV3Next.Components.Schemas.DeMittwaldAihostingProjectPlan[];
     }>;
+    /** 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;
+    }>;
 };
 declare const buildAppApi: (baseClient: MittwaldAPIV3NextClient) => {
     /** Get the installed `SystemSoftware' for a specific `AppInstallation`. */

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

@@ -1317,6 +1317,180 @@ export declare class MittwaldAPIV3NextClient extends ApiClientBase {
         }, 412, "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">>>;
     };
     /** The App API allows you to manage your apps within a project, and all the system softwares that are installed as dependencies. */
     readonly app: {

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

@@ -957,3 +957,7 @@ export declare const verificationDetectPhishingEmail: OpenAPIOperation<RequestTy
 export declare const verificationVerifyAddress: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Parameters.RequestBody>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyAddress.Post.Responses.Default.Content.ApplicationJson>, "default", "application/json">>;
 /** Check if a company exists. */
 export declare const verificationVerifyCompany: OpenAPIOperation<RequestType<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Parameters.RequestBody>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Parameters.Path>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Parameters.Query>, Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Parameters.Header>>, Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Responses.$200.Content.ApplicationJson>, 200, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Responses.$412.Content.Empty>, 412, "empty"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.Responses.$429.Content.ApplicationJson>, 429, "application/json"> | Response<Simplify<MittwaldAPIV3Next.Paths.V3NextActionsVerifyCompany.Post.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">>;

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

@@ -1910,6 +1910,14 @@ export declare namespace MittwaldAPIV3Next {
             type RequestData = InferredRequestData<typeof descriptors.verificationVerifyCompany>;
             type ResponseData<TStatus extends HttpStatus = 200> = InferredResponseData<typeof descriptors.verificationVerifyCompany, 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 Components {
         namespace Schemas {
@@ -7242,6 +7250,57 @@ export declare namespace MittwaldAPIV3Next {
             }
             type DeMittwaldVerificationEmailOrigin = "IS_MITTWALD" | "IS_NOT_MITTWALD" | "COULD_BE_MITTWALD";
             type DeMittwaldContainerVolumeSortOrder = "nameAsc" | "nameDesc" | "storageAsc" | "storageDesc";
+            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;
+            }
+            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 DeMittwaldCommonsAddress {
                 street: string;
                 houseNumber: string;
@@ -32035,5 +32094,117 @@ 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;
+                            }
+                        }
+                    }
+                }
+            }
+        }
     }
 }

package/dist/types/version.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/api-client",
-  "version": "4.458.0",
+  "version": "4.459.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.459.0",
     "browser-or-node": "^3.0.0"
   },
   "devDependencies": {
-    "@mittwald/api-code-generator": "^4.458.0",
+    "@mittwald/api-code-generator": "^4.459.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": "a786ecfbe5c35ba24408c57632f20e2c28045f19"
 }