@steuerboard/mcp 0.3.4 → 0.4.0

package/src/models/accountantuser.ts

@@ -17,15 +17,19 @@ export type AccountantUser = {
   roles: Array<AccountantUserRole>;
 };
 
-export const AccountantUser$zodSchema: z.ZodType<
-  AccountantUser,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  createdAt: z.string().datetime({ offset: true }),
-  email: z.string(),
-  firstName: z.string().nullable(),
-  id: z.string(),
-  lastName: z.string().nullable(),
-  roles: z.array(AccountantUserRole$zodSchema),
+export const AccountantUser$zodSchema: z.ZodType<AccountantUser> = z.object({
+  createdAt: z.iso.datetime({ offset: true }).describe(
+    "ISO 8601 timestamp when the accountant user record was created.",
+  ),
+  email: z.string().describe("Email address of the accountant user."),
+  firstName: z.string().nullable().describe(
+    "First name of the accountant user, if provided.",
+  ),
+  id: z.string().describe("Identifier of the accountant user."),
+  lastName: z.string().nullable().describe(
+    "Last name of the accountant user, if provided.",
+  ),
+  roles: z.array(AccountantUserRole$zodSchema).describe(
+    "Roles assigned to the accountant user.",
+  ),
 });

package/src/models/accountantuserrole.ts

@@ -10,12 +10,15 @@ export type AccountantUserRole = {
   customName: string | null;
 };
 
-export const AccountantUserRole$zodSchema: z.ZodType<
-  AccountantUserRole,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  customName: z.string().nullable(),
-  id: z.string(),
-  name: z.string().nullable(),
-});
+export const AccountantUserRole$zodSchema: z.ZodType<AccountantUserRole> = z
+  .object({
+    customName: z.string().nullable().describe(
+      "Custom label for the role, if defined.",
+    ),
+    id: z.string().describe(
+      "Identifier of the role assigned to the accountant user.",
+    ),
+    name: z.string().nullable().describe(
+      "Internal identifier of the role. Null when the role is custom only.",
+    ),
+  });

package/src/models/autherror.ts

@@ -3,23 +3,33 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const AuthErrorStatusCode = {
+  FourHundredAndOne: 401,
+} as const;
+export type AuthErrorStatusCode = ClosedEnum<typeof AuthErrorStatusCode>;
 
 export const AuthErrorStatusCode$zodSchema = z.literal(401);
 
-export type AuthErrorStatusCode = z.infer<typeof AuthErrorStatusCode$zodSchema>;
+export const AuthErrorType = {
+  AuthError: "auth_error",
+} as const;
+export type AuthErrorType = ClosedEnum<typeof AuthErrorType>;
 
 export const AuthErrorType$zodSchema = z.enum([
   "auth_error",
 ]);
 
-export type AuthErrorType = z.infer<typeof AuthErrorType$zodSchema>;
+export const AuthErrorCode = {
+  Unauthorized: "unauthorized",
+} as const;
+export type AuthErrorCode = ClosedEnum<typeof AuthErrorCode>;
 
 export const AuthErrorCode$zodSchema = z.enum([
   "unauthorized",
 ]);
 
-export type AuthErrorCode = z.infer<typeof AuthErrorCode$zodSchema>;
-
 export type AuthError = {
   status_code: AuthErrorStatusCode;
   type: AuthErrorType;
@@ -27,10 +37,9 @@ export type AuthError = {
   message: string;
 };
 
-export const AuthError$zodSchema: z.ZodType<AuthError, z.ZodTypeDef, unknown> =
-  z.object({
-    code: AuthErrorCode$zodSchema,
-    message: z.string(),
-    status_code: AuthErrorStatusCode$zodSchema,
-    type: AuthErrorType$zodSchema,
-  });
+export const AuthError$zodSchema: z.ZodType<AuthError> = z.object({
+  code: AuthErrorCode$zodSchema,
+  message: z.string(),
+  status_code: AuthErrorStatusCode$zodSchema,
+  type: AuthErrorType$zodSchema,
+});

package/src/models/badrequest.ts

@@ -3,25 +3,33 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const BadRequestStatusCode = {
+  FourHundredAndTen: 410,
+} as const;
+export type BadRequestStatusCode = ClosedEnum<typeof BadRequestStatusCode>;
 
 export const BadRequestStatusCode$zodSchema = z.literal(410);
 
-export type BadRequestStatusCode = z.infer<
-  typeof BadRequestStatusCode$zodSchema
->;
+export const BadRequestType = {
+  BadRequest: "bad_request",
+} as const;
+export type BadRequestType = ClosedEnum<typeof BadRequestType>;
 
 export const BadRequestType$zodSchema = z.enum([
   "bad_request",
 ]);
 
-export type BadRequestType = z.infer<typeof BadRequestType$zodSchema>;
+export const BadRequestCode = {
+  CollectTokenExpired: "collect_token_expired",
+} as const;
+export type BadRequestCode = ClosedEnum<typeof BadRequestCode>;
 
 export const BadRequestCode$zodSchema = z.enum([
   "collect_token_expired",
 ]);
 
-export type BadRequestCode = z.infer<typeof BadRequestCode$zodSchema>;
-
 export type BadRequest = {
   status_code: BadRequestStatusCode;
   type: BadRequestType;
@@ -29,11 +37,7 @@ export type BadRequest = {
   message: string;
 };
 
-export const BadRequest$zodSchema: z.ZodType<
-  BadRequest,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
+export const BadRequest$zodSchema: z.ZodType<BadRequest> = z.object({
   code: BadRequestCode$zodSchema,
   message: z.string(),
   status_code: BadRequestStatusCode$zodSchema,

package/src/models/client.ts

@@ -3,10 +3,21 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
  */
+export const ClientClientType = {
+  NaturalPerson: "natural_person",
+  IndividualEnterprise: "individual_enterprise",
+  LegalPerson: "legal_person",
+} as const;
+/**
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
+ */
+export type ClientClientType = ClosedEnum<typeof ClientClientType>;
+
 export const ClientClientType$zodSchema = z.enum([
   "natural_person",
   "individual_enterprise",
@@ -15,8 +26,6 @@ export const ClientClientType$zodSchema = z.enum([
   "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
 );
 
-export type ClientClientType = z.infer<typeof ClientClientType$zodSchema>;
-
 export type Client = {
   id: string;
   name: string;
@@ -30,16 +39,25 @@ export type Client = {
   updatedAt: string;
 };
 
-export const Client$zodSchema: z.ZodType<Client, z.ZodTypeDef, unknown> = z
-  .object({
-    archivedAt: z.string().datetime({ offset: true }).nullable(),
-    createdAt: z.string().datetime({ offset: true }),
-    customId: z.string().nullable(),
-    datevClientId: z.string().nullable(),
-    id: z.string(),
-    legalName: z.string().nullable(),
-    name: z.string(),
-    slug: z.string(),
-    type: ClientClientType$zodSchema,
-    updatedAt: z.string().datetime({ offset: true }),
-  });
+export const Client$zodSchema: z.ZodType<Client> = z.object({
+  archivedAt: z.iso.datetime({ offset: true }).nullable().describe(
+    "The date and time the client was archived. ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).",
+  ),
+  createdAt: z.iso.datetime({ offset: true }).describe(
+    "The date and time of the creation for the client. ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).",
+  ),
+  customId: z.string().nullable().describe(
+    "The client's custom ID can be defined by the accountant",
+  ),
+  datevClientId: z.string().nullable().describe("The client's ID in DATEV"),
+  id: z.string().describe("The ID of the client"),
+  legalName: z.string().nullable().describe("The legal name of the client"),
+  name: z.string().describe("The name of the client"),
+  slug: z.string().describe("The slug of the client"),
+  type: ClientClientType$zodSchema.describe(
+    "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+  ),
+  updatedAt: z.iso.datetime({ offset: true }).describe(
+    "The date and time of the last update for the client. ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).",
+  ),
+});

package/src/models/clientcreate.ts

@@ -3,10 +3,21 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
  */
+export const ClientCreateClientType = {
+  NaturalPerson: "natural_person",
+  IndividualEnterprise: "individual_enterprise",
+  LegalPerson: "legal_person",
+} as const;
+/**
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
+ */
+export type ClientCreateClientType = ClosedEnum<typeof ClientCreateClientType>;
+
 export const ClientCreateClientType$zodSchema = z.enum([
   "natural_person",
   "individual_enterprise",
@@ -15,10 +26,6 @@ export const ClientCreateClientType$zodSchema = z.enum([
   "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
 );
 
-export type ClientCreateClientType = z.infer<
-  typeof ClientCreateClientType$zodSchema
->;
-
 /**
  * The address of the client
  */
@@ -30,17 +37,14 @@ export type ClientCreateAddress = {
   countryCode?: string | undefined;
 };
 
-export const ClientCreateAddress$zodSchema: z.ZodType<
-  ClientCreateAddress,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  city: z.string(),
-  countryCode: z.string().default("DE"),
-  line1: z.string(),
-  line2: z.string().optional(),
-  postalCode: z.string(),
-}).describe("The address of the client");
+export const ClientCreateAddress$zodSchema: z.ZodType<ClientCreateAddress> = z
+  .object({
+    city: z.string(),
+    countryCode: z.string().default("DE"),
+    line1: z.string(),
+    line2: z.string().optional(),
+    postalCode: z.string(),
+  }).describe("The address of the client");
 
 export type ClientCreate = {
   name: string;
@@ -49,13 +53,15 @@ export type ClientCreate = {
   address?: ClientCreateAddress | undefined;
 };
 
-export const ClientCreate$zodSchema: z.ZodType<
-  ClientCreate,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  address: z.lazy(() => ClientCreateAddress$zodSchema).optional(),
-  customId: z.string().optional(),
-  name: z.string(),
-  type: ClientCreateClientType$zodSchema,
+export const ClientCreate$zodSchema: z.ZodType<ClientCreate> = z.object({
+  address: z.lazy(() => ClientCreateAddress$zodSchema).optional().describe(
+    "The address of the client",
+  ),
+  customId: z.string().optional().describe(
+    "The client's custom ID can be defined by the accountant",
+  ),
+  name: z.string().describe("The name of the client"),
+  type: ClientCreateClientType$zodSchema.describe(
+    "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+  ),
 });

package/src/models/clientupdate.ts

@@ -3,10 +3,21 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
  */
+export const ClientUpdateClientType = {
+  NaturalPerson: "natural_person",
+  IndividualEnterprise: "individual_enterprise",
+  LegalPerson: "legal_person",
+} as const;
+/**
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
+ */
+export type ClientUpdateClientType = ClosedEnum<typeof ClientUpdateClientType>;
+
 export const ClientUpdateClientType$zodSchema = z.enum([
   "natural_person",
   "individual_enterprise",
@@ -15,10 +26,6 @@ export const ClientUpdateClientType$zodSchema = z.enum([
   "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
 );
 
-export type ClientUpdateClientType = z.infer<
-  typeof ClientUpdateClientType$zodSchema
->;
-
 /**
  * The address of the client
  */
@@ -30,17 +37,14 @@ export type ClientUpdateAddress = {
   countryCode?: string | undefined;
 };
 
-export const ClientUpdateAddress$zodSchema: z.ZodType<
-  ClientUpdateAddress,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  city: z.string(),
-  countryCode: z.string().default("DE"),
-  line1: z.string(),
-  line2: z.string().optional(),
-  postalCode: z.string(),
-}).describe("The address of the client");
+export const ClientUpdateAddress$zodSchema: z.ZodType<ClientUpdateAddress> = z
+  .object({
+    city: z.string(),
+    countryCode: z.string().default("DE"),
+    line1: z.string(),
+    line2: z.string().optional(),
+    postalCode: z.string(),
+  }).describe("The address of the client");
 
 export type ClientUpdate = {
   name?: string | undefined;
@@ -50,14 +54,17 @@ export type ClientUpdate = {
   address?: ClientUpdateAddress | null | undefined;
 };
 
-export const ClientUpdate$zodSchema: z.ZodType<
-  ClientUpdate,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  address: z.lazy(() => ClientUpdateAddress$zodSchema).nullable().optional(),
-  customId: z.string().nullable().optional(),
-  legalName: z.string().nullable().optional(),
-  name: z.string().optional(),
-  type: ClientUpdateClientType$zodSchema.optional(),
+export const ClientUpdate$zodSchema: z.ZodType<ClientUpdate> = z.object({
+  address: z.lazy(() => ClientUpdateAddress$zodSchema).nullable().optional()
+    .describe("The address of the client"),
+  customId: z.string().nullable().optional().describe(
+    "The client's custom ID can be defined by the accountant",
+  ),
+  legalName: z.string().nullable().optional().describe(
+    "The legal name of the client",
+  ),
+  name: z.string().optional().describe("The updated name of the client"),
+  type: ClientUpdateClientType$zodSchema.optional().describe(
+    "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+  ),
 });

package/src/models/clientuser.ts

@@ -13,15 +13,19 @@ export type ClientUser = {
   roles: Array<string>;
 };
 
-export const ClientUser$zodSchema: z.ZodType<
-  ClientUser,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  createdAt: z.string().datetime({ offset: true }),
-  email: z.string(),
-  firstName: z.string().nullable(),
-  id: z.string(),
-  lastName: z.string().nullable(),
-  roles: z.array(z.string()),
+export const ClientUser$zodSchema: z.ZodType<ClientUser> = z.object({
+  createdAt: z.iso.datetime({ offset: true }).describe(
+    "The date and time when the client user record was created. ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ).",
+  ),
+  email: z.string().describe("Email address of the client user."),
+  firstName: z.string().nullable().describe(
+    "First name of the client user, if provided.",
+  ),
+  id: z.string().describe("Identifier of the client user."),
+  lastName: z.string().nullable().describe(
+    "Last name of the client user, if provided.",
+  ),
+  roles: z.array(z.string()).describe(
+    "List of role names assigned to the user.",
+  ),
 });

package/src/models/clientuserinvite.ts

@@ -3,31 +3,43 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * Role to assign to the invited user. Can be 'admin', 'user'.
  */
+export const ClientUserInviteUserRole = {
+  Admin: "admin",
+  User: "user",
+} as const;
+/**
+ * Role to assign to the invited user. Can be 'admin', 'user'.
+ */
+export type ClientUserInviteUserRole = ClosedEnum<
+  typeof ClientUserInviteUserRole
+>;
+
 export const ClientUserInviteUserRole$zodSchema = z.enum([
   "admin",
   "user",
 ]).describe("Role to assign to the invited user. Can be 'admin', 'user'.");
 
-export type ClientUserInviteUserRole = z.infer<
-  typeof ClientUserInviteUserRole$zodSchema
->;
-
 export type ClientUserInvite = {
   email: string;
   role: ClientUserInviteUserRole;
   workspaceIds?: Array<string> | undefined;
 };
 
-export const ClientUserInvite$zodSchema: z.ZodType<
-  ClientUserInvite,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  email: z.string(),
-  role: ClientUserInviteUserRole$zodSchema,
-  workspaceIds: z.array(z.string()).optional(),
-});
+export const ClientUserInvite$zodSchema: z.ZodType<ClientUserInvite> = z.object(
+  {
+    email: z.string().describe(
+      "Email address that should receive the invitation.",
+    ),
+    role: ClientUserInviteUserRole$zodSchema.describe(
+      "Role to assign to the invited user. Can be 'admin', 'user'.",
+    ),
+    workspaceIds: z.array(z.string()).optional().describe(
+      "Optional list of workspace IDs the user should join immediately.",
+    ),
+  },
+);

package/src/models/clientuserupdate.ts

@@ -3,25 +3,33 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * Role to assign to the invited user. Can be 'admin', 'user'.
  */
+export const ClientUserUpdateUserRole = {
+  Admin: "admin",
+  User: "user",
+} as const;
+/**
+ * Role to assign to the invited user. Can be 'admin', 'user'.
+ */
+export type ClientUserUpdateUserRole = ClosedEnum<
+  typeof ClientUserUpdateUserRole
+>;
+
 export const ClientUserUpdateUserRole$zodSchema = z.enum([
   "admin",
   "user",
 ]).describe("Role to assign to the invited user. Can be 'admin', 'user'.");
 
-export type ClientUserUpdateUserRole = z.infer<
-  typeof ClientUserUpdateUserRole$zodSchema
->;
-
 export type ClientUserUpdate = { role: ClientUserUpdateUserRole };
 
-export const ClientUserUpdate$zodSchema: z.ZodType<
-  ClientUserUpdate,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  role: ClientUserUpdateUserRole$zodSchema,
-});
+export const ClientUserUpdate$zodSchema: z.ZodType<ClientUserUpdate> = z.object(
+  {
+    role: ClientUserUpdateUserRole$zodSchema.describe(
+      "Role to assign to the invited user. Can be 'admin', 'user'.",
+    ),
+  },
+);

package/src/models/collectbulksubmission.ts

@@ -14,11 +14,9 @@ export type CollectBulkSubmissionSubmission = {
 };
 
 export const CollectBulkSubmissionSubmission$zodSchema: z.ZodType<
-  CollectBulkSubmissionSubmission,
-  z.ZodTypeDef,
-  unknown
+  CollectBulkSubmissionSubmission
 > = z.object({
-  createdAt: z.string().datetime({ offset: true }),
+  createdAt: z.iso.datetime({ offset: true }),
   fileMimeType: z.string().nullable(),
   fileName: z.string().nullable(),
   fileSize: z.number().nullable(),
@@ -30,10 +28,9 @@ export type CollectBulkSubmission = {
   submissions: Array<CollectBulkSubmissionSubmission>;
 };
 
-export const CollectBulkSubmission$zodSchema: z.ZodType<
-  CollectBulkSubmission,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  submissions: z.array(z.lazy(() => CollectBulkSubmissionSubmission$zodSchema)),
-});
+export const CollectBulkSubmission$zodSchema: z.ZodType<CollectBulkSubmission> =
+  z.object({
+    submissions: z.array(
+      z.lazy(() => CollectBulkSubmissionSubmission$zodSchema),
+    ),
+  });

package/src/models/collectbulksubmitform.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod";
+import * as b64$ from "../lib/base64.js";
 
 export type CollectBulkSubmitFormFile = {
   fileName: string;
@@ -10,11 +11,11 @@ export type CollectBulkSubmitFormFile = {
 };
 
 export const CollectBulkSubmitFormFile$zodSchema: z.ZodType<
-  CollectBulkSubmitFormFile,
-  z.ZodTypeDef,
-  unknown
+  CollectBulkSubmitFormFile
 > = z.object({
-  content: z.string().base64(),
+  content: z.string().describe("Base64-encoded binary content").transform(
+    b64$.bytesFromBase64,
+  ),
   fileName: z.string(),
 });
 
@@ -23,11 +24,12 @@ export type CollectBulkSubmitForm = {
   groupId: string;
 };
 
-export const CollectBulkSubmitForm$zodSchema: z.ZodType<
-  CollectBulkSubmitForm,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  files: z.array(z.lazy(() => CollectBulkSubmitFormFile$zodSchema)),
-  groupId: z.string(),
-});
+export const CollectBulkSubmitForm$zodSchema: z.ZodType<CollectBulkSubmitForm> =
+  z.object({
+    files: z.array(z.lazy(() => CollectBulkSubmitFormFile$zodSchema)).describe(
+      "The files to upload",
+    ),
+    groupId: z.string().describe(
+      "The ID of the BULK_MATCH group to submit against",
+    ),
+  });

package/src/models/collectfilesubmission.ts

@@ -14,16 +14,19 @@ export type CollectFileSubmission = {
   createdAt: string;
 };
 
-export const CollectFileSubmission$zodSchema: z.ZodType<
-  CollectFileSubmission,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  collectItemId: z.string(),
-  createdAt: z.string().datetime({ offset: true }),
-  fileMimeType: z.string().nullable(),
-  fileName: z.string().nullable(),
-  fileSize: z.number().nullable(),
-  id: z.string(),
-  status: z.string(),
-});
+export const CollectFileSubmission$zodSchema: z.ZodType<CollectFileSubmission> =
+  z.object({
+    collectItemId: z.string().describe("The ID of the collect item"),
+    createdAt: z.iso.datetime({ offset: true }).describe(
+      "The date and time the submission was created",
+    ),
+    fileMimeType: z.string().nullable().describe(
+      "The MIME type of the uploaded file",
+    ),
+    fileName: z.string().nullable().describe("The name of the uploaded file"),
+    fileSize: z.number().nullable().describe(
+      "The size of the uploaded file in bytes",
+    ),
+    id: z.string().describe("The ID of the submission"),
+    status: z.string().describe("The status of the submission"),
+  });