@t4dhg/mcp-factorial 8.2.0 → 10.0.0

package/dist/schemas/documents.d.ts

@@ -1,78 +1,108 @@
 /**
  * Document schemas: Folder, Document
+ *
+ * Field sets verified against live /documents/folders and /documents/documents
+ * responses on API version 2026-07-01.
  */
 import { z } from 'zod';
 /**
  * Folder schema
  */
 export declare const FolderSchema: z.ZodObject<{
-    id: z.ZodNumber;
+    id: z.ZodString;
     name: z.ZodString;
-    parent_id: z.ZodNullable<z.ZodNumber>;
-    company_id: z.ZodNullable<z.ZodNumber>;
-    created_at: z.ZodNullable<z.ZodString>;
-    updated_at: z.ZodNullable<z.ZodString>;
+    parent_folder_id: z.ZodNullable<z.ZodString>;
+    company_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    active: z.ZodBoolean;
+    /** 'company_internal', 'employee_my_documents' or 'unknown' */
+    space: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    id: number;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    id: string;
+    active: boolean;
     name: string;
-    parent_id: number | null;
+    parent_folder_id: string | null;
+    space: string;
+    company_id?: string | null | undefined;
 }, {
-    id: number;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    id: string;
+    active: boolean;
     name: string;
-    parent_id: number | null;
+    parent_folder_id: string | null;
+    space: string;
+    company_id?: string | null | undefined;
 }>;
 export type Folder = z.infer<typeof FolderSchema>;
 /**
  * Document schema
+ *
+ * Note that the API exposes the file name as `filename`, the MIME type as
+ * `content_type` and the size as `file_size`. It has no `name`, `mime_type`,
+ * `size_bytes` or `file_url` fields; the download URL is obtained separately
+ * through the download-urls endpoint.
  */
 export declare const DocumentSchema: z.ZodObject<{
-    id: z.ZodNumber;
-    name: z.ZodNullable<z.ZodString>;
-    folder_id: z.ZodNullable<z.ZodNumber>;
-    employee_id: z.ZodNullable<z.ZodNumber>;
-    author_id: z.ZodNullable<z.ZodNumber>;
-    company_id: z.ZodNullable<z.ZodNumber>;
+    id: z.ZodString;
+    filename: z.ZodString;
+    extension: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content_type: z.ZodNullable<z.ZodString>;
+    file_size: z.ZodNullable<z.ZodNumber>;
+    folder_id: z.ZodNullable<z.ZodString>;
+    employee_id: z.ZodNullable<z.ZodString>;
+    author_id: z.ZodNullable<z.ZodString>;
+    company_id: z.ZodNullable<z.ZodString>;
+    leave_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     public: z.ZodDefault<z.ZodBoolean>;
-    space: z.ZodNullable<z.ZodString>;
-    file_url: z.ZodNullable<z.ZodString>;
-    mime_type: z.ZodNullable<z.ZodString>;
-    size_bytes: z.ZodNullable<z.ZodNumber>;
+    space: z.ZodString;
+    is_company_document: z.ZodOptional<z.ZodBoolean>;
+    is_management_document: z.ZodOptional<z.ZodBoolean>;
+    is_pending_assignment: z.ZodOptional<z.ZodBoolean>;
+    signature_status: z.ZodOptional<z.ZodNullable<z.ZodEnum<["pending", "partially_signed", "declined", "completed", "bounced_email", "cancelled", "error", "expired"]>>>;
+    signees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deleted_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodNullable<z.ZodString>;
     updated_at: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
-    company_id: number | null;
+    id: string;
+    company_id: string | null;
     created_at: string | null;
     updated_at: string | null;
-    name: string | null;
-    employee_id: number | null;
-    folder_id: number | null;
-    author_id: number | null;
+    employee_id: string | null;
+    space: string;
+    filename: string;
+    content_type: string | null;
+    file_size: number | null;
+    folder_id: string | null;
+    author_id: string | null;
     public: boolean;
-    space: string | null;
-    file_url: string | null;
-    mime_type: string | null;
-    size_bytes: number | null;
+    deleted_at?: string | null | undefined;
+    extension?: string | null | undefined;
+    leave_id?: string | null | undefined;
+    is_company_document?: boolean | undefined;
+    is_management_document?: boolean | undefined;
+    is_pending_assignment?: boolean | undefined;
+    signature_status?: "pending" | "partially_signed" | "declined" | "completed" | "bounced_email" | "cancelled" | "error" | "expired" | null | undefined;
+    signees?: string[] | undefined;
 }, {
-    id: number;
-    company_id: number | null;
+    id: string;
+    company_id: string | null;
     created_at: string | null;
     updated_at: string | null;
-    name: string | null;
-    employee_id: number | null;
-    folder_id: number | null;
-    author_id: number | null;
-    space: string | null;
-    file_url: string | null;
-    mime_type: string | null;
-    size_bytes: number | null;
+    employee_id: string | null;
+    space: string;
+    filename: string;
+    content_type: string | null;
+    file_size: number | null;
+    folder_id: string | null;
+    author_id: string | null;
+    deleted_at?: string | null | undefined;
+    extension?: string | null | undefined;
+    leave_id?: string | null | undefined;
     public?: boolean | undefined;
+    is_company_document?: boolean | undefined;
+    is_management_document?: boolean | undefined;
+    is_pending_assignment?: boolean | undefined;
+    signature_status?: "pending" | "partially_signed" | "declined" | "completed" | "bounced_email" | "cancelled" | "error" | "expired" | null | undefined;
+    signees?: string[] | undefined;
 }>;
 export type Document = z.infer<typeof DocumentSchema>;
 //# sourceMappingURL=documents.d.ts.map

package/dist/schemas/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/schemas/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAczB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/schemas/documents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;IAMvB,+DAA+D;;;;;;;;;;;;;;;;EAE/D,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/documents.js

@@ -1,33 +1,62 @@
 /**
  * Document schemas: Folder, Document
+ *
+ * Field sets verified against live /documents/folders and /documents/documents
+ * responses on API version 2026-07-01.
  */
 import { z } from 'zod';
+import { resourceId } from './shared.js';
 /**
  * Folder schema
  */
 export const FolderSchema = z.object({
-    id: z.number(),
+    id: resourceId,
     name: z.string(),
-    parent_id: z.number().nullable(),
-    company_id: z.number().nullable(),
-    created_at: z.string().nullable(),
-    updated_at: z.string().nullable(),
+    parent_folder_id: resourceId.nullable(),
+    company_id: resourceId.nullable().optional(),
+    active: z.boolean(),
+    /** 'company_internal', 'employee_my_documents' or 'unknown' */
+    space: z.string(),
 });
 /**
  * Document schema
+ *
+ * Note that the API exposes the file name as `filename`, the MIME type as
+ * `content_type` and the size as `file_size`. It has no `name`, `mime_type`,
+ * `size_bytes` or `file_url` fields; the download URL is obtained separately
+ * through the download-urls endpoint.
  */
 export const DocumentSchema = z.object({
-    id: z.number(),
-    name: z.string().nullable(),
-    folder_id: z.number().nullable(),
-    employee_id: z.number().nullable(), // Employee the document belongs to
-    author_id: z.number().nullable(),
-    company_id: z.number().nullable(),
+    id: resourceId,
+    filename: z.string(),
+    extension: z.string().nullable().optional(),
+    content_type: z.string().nullable(),
+    file_size: z.number().nullable(),
+    folder_id: resourceId.nullable(),
+    employee_id: resourceId.nullable(), // Employee the document belongs to
+    author_id: resourceId.nullable(),
+    company_id: resourceId.nullable(),
+    leave_id: resourceId.nullable().optional(),
     public: z.boolean().default(false),
-    space: z.string().nullable(),
-    file_url: z.string().nullable(),
-    mime_type: z.string().nullable(),
-    size_bytes: z.number().nullable(),
+    space: z.string(),
+    is_company_document: z.boolean().optional(),
+    is_management_document: z.boolean().optional(),
+    is_pending_assignment: z.boolean().optional(),
+    signature_status: z
+        .enum([
+        'pending',
+        'partially_signed',
+        'declined',
+        'completed',
+        'bounced_email',
+        'cancelled',
+        'error',
+        'expired',
+    ])
+        .nullable()
+        .optional(),
+    signees: z.array(resourceId).optional(),
+    deleted_at: z.string().nullable().optional(),
     created_at: z.string().nullable(),
     updated_at: z.string().nullable(),
 });

package/dist/schemas/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/schemas/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,mCAAmC;IACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/schemas/documents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,gBAAgB,EAAE,UAAU,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,+DAA+D;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAIH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,UAAU;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,mCAAmC;IACvE,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9C,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7C,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC;QACJ,SAAS;QACT,kBAAkB;QAClB,UAAU;QACV,WAAW;QACX,eAAe;QACf,WAAW;QACX,OAAO;QACP,SAAS;KACV,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}

package/dist/schemas/employees.d.ts

@@ -4,10 +4,13 @@
 import { z } from 'zod';
 /**
  * Employee schema
+ *
+ * Field set verified against live /employees/employees responses on API
+ * version 2026-07-01.
  */
 export declare const EmployeeSchema: z.ZodObject<{
-    id: z.ZodNumber;
-    access_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    id: z.ZodString;
+    access_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     first_name: z.ZodNullable<z.ZodString>;
     last_name: z.ZodNullable<z.ZodString>;
     full_name: z.ZodNullable<z.ZodString>;
@@ -21,6 +24,8 @@ export declare const EmployeeSchema: z.ZodObject<{
     social_security_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     email: z.ZodNullable<z.ZodString>;
     login_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    communications_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unconfirmed_communications_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     phone_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     personal_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     address_line_1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -38,11 +43,12 @@ export declare const EmployeeSchema: z.ZodObject<{
     bank_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     swift_bic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     bank_number_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    company_id: z.ZodNullable<z.ZodNumber>;
-    legal_entity_id: z.ZodNullable<z.ZodNumber>;
-    location_id: z.ZodNullable<z.ZodNumber>;
-    manager_id: z.ZodNullable<z.ZodNumber>;
-    timeoff_manager_id: z.ZodNullable<z.ZodNumber>;
+    company_id: z.ZodNullable<z.ZodString>;
+    legal_entity_id: z.ZodNullable<z.ZodString>;
+    location_id: z.ZodNullable<z.ZodString>;
+    default_work_area_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    manager_id: z.ZodNullable<z.ZodString>;
+    timeoff_manager_id: z.ZodNullable<z.ZodString>;
     company_identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     attendable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -58,7 +64,7 @@ export declare const EmployeeSchema: z.ZodObject<{
     created_at: z.ZodNullable<z.ZodString>;
     updated_at: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
+    id: string;
     first_name: string | null;
     last_name: string | null;
     full_name: string | null;
@@ -66,15 +72,15 @@ export declare const EmployeeSchema: z.ZodObject<{
     email: string | null;
     birthday_on: string | null;
     nationality: string | null;
-    company_id: number | null;
-    legal_entity_id: number | null;
-    location_id: number | null;
-    manager_id: number | null;
-    timeoff_manager_id: number | null;
+    company_id: string | null;
+    legal_entity_id: string | null;
+    location_id: string | null;
+    manager_id: string | null;
+    timeoff_manager_id: string | null;
     terminated_on: string | null;
     created_at: string | null;
     updated_at: string | null;
-    access_id?: number | null | undefined;
+    access_id?: string | null | undefined;
     preferred_name?: string | null | undefined;
     birth_name?: string | null | undefined;
     pronouns?: string | null | undefined;
@@ -83,6 +89,8 @@ export declare const EmployeeSchema: z.ZodObject<{
     identifier_expiration_date?: string | null | undefined;
     social_security_number?: string | null | undefined;
     login_email?: string | null | undefined;
+    communications_email?: string | null | undefined;
+    unconfirmed_communications_email?: string | null | undefined;
     phone_number?: string | null | undefined;
     personal_email?: string | null | undefined;
     address_line_1?: string | null | undefined;
@@ -98,6 +106,7 @@ export declare const EmployeeSchema: z.ZodObject<{
     bank_number?: string | null | undefined;
     swift_bic?: string | null | undefined;
     bank_number_format?: string | null | undefined;
+    default_work_area_id?: string | null | undefined;
     company_identifier?: string | null | undefined;
     active?: boolean | null | undefined;
     attendable?: boolean | null | undefined;
@@ -110,7 +119,7 @@ export declare const EmployeeSchema: z.ZodObject<{
     contact_name?: string | null | undefined;
     contact_number?: string | null | undefined;
 }, {
-    id: number;
+    id: string;
     first_name: string | null;
     last_name: string | null;
     full_name: string | null;
@@ -118,15 +127,15 @@ export declare const EmployeeSchema: z.ZodObject<{
     email: string | null;
     birthday_on: string | null;
     nationality: string | null;
-    company_id: number | null;
-    legal_entity_id: number | null;
-    location_id: number | null;
-    manager_id: number | null;
-    timeoff_manager_id: number | null;
+    company_id: string | null;
+    legal_entity_id: string | null;
+    location_id: string | null;
+    manager_id: string | null;
+    timeoff_manager_id: string | null;
     terminated_on: string | null;
     created_at: string | null;
     updated_at: string | null;
-    access_id?: number | null | undefined;
+    access_id?: string | null | undefined;
     preferred_name?: string | null | undefined;
     birth_name?: string | null | undefined;
     pronouns?: string | null | undefined;
@@ -135,6 +144,8 @@ export declare const EmployeeSchema: z.ZodObject<{
     identifier_expiration_date?: string | null | undefined;
     social_security_number?: string | null | undefined;
     login_email?: string | null | undefined;
+    communications_email?: string | null | undefined;
+    unconfirmed_communications_email?: string | null | undefined;
     phone_number?: string | null | undefined;
     personal_email?: string | null | undefined;
     address_line_1?: string | null | undefined;
@@ -150,6 +161,7 @@ export declare const EmployeeSchema: z.ZodObject<{
     bank_number?: string | null | undefined;
     swift_bic?: string | null | undefined;
     bank_number_format?: string | null | undefined;
+    default_work_area_id?: string | null | undefined;
     company_identifier?: string | null | undefined;
     active?: boolean | null | undefined;
     attendable?: boolean | null | undefined;
@@ -165,41 +177,44 @@ export declare const EmployeeSchema: z.ZodObject<{
 export type Employee = z.infer<typeof EmployeeSchema>;
 /**
  * Team schema
+ *
+ * Field set verified against live /teams/teams responses on API version
+ * 2026-07-01. Teams carry no timestamps.
  */
 export declare const TeamSchema: z.ZodObject<{
-    id: z.ZodNumber;
+    id: z.ZodString;
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
-    company_id: z.ZodNullable<z.ZodNumber>;
-    employee_ids: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
-    lead_ids: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
-    created_at: z.ZodNullable<z.ZodString>;
-    updated_at: z.ZodNullable<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    company_id: z.ZodNullable<z.ZodString>;
+    employee_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    lead_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    id: string;
+    company_id: string | null;
     name: string;
     description: string | null;
-    employee_ids: number[];
-    lead_ids: number[];
+    employee_ids: string[];
+    lead_ids: string[];
+    avatar?: string | null | undefined;
 }, {
-    id: number;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    id: string;
+    company_id: string | null;
     name: string;
     description: string | null;
-    employee_ids?: number[] | undefined;
-    lead_ids?: number[] | undefined;
+    avatar?: string | null | undefined;
+    employee_ids?: string[] | undefined;
+    lead_ids?: string[] | undefined;
 }>;
 export type Team = z.infer<typeof TeamSchema>;
 /**
  * Location schema
+ *
+ * Field set verified against live /locations/locations responses on API
+ * version 2026-07-01. Locations carry no timestamps.
  */
 export declare const LocationSchema: z.ZodObject<{
-    id: z.ZodNumber;
+    id: z.ZodString;
     name: z.ZodString;
     country: z.ZodNullable<z.ZodString>;
     phone_number: z.ZodNullable<z.ZodString>;
@@ -208,11 +223,15 @@ export declare const LocationSchema: z.ZodObject<{
     address_line_1: z.ZodNullable<z.ZodString>;
     address_line_2: z.ZodNullable<z.ZodString>;
     postal_code: z.ZodNullable<z.ZodString>;
-    company_id: z.ZodNullable<z.ZodNumber>;
-    created_at: z.ZodNullable<z.ZodString>;
-    updated_at: z.ZodNullable<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    main: z.ZodOptional<z.ZodBoolean>;
+    latitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    longitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    radius: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    siret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    company_id: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
+    id: string;
     phone_number: string | null;
     address_line_1: string | null;
     address_line_2: string | null;
@@ -220,12 +239,16 @@ export declare const LocationSchema: z.ZodObject<{
     city: string | null;
     state: string | null;
     country: string | null;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    company_id: string | null;
     name: string;
+    timezone?: string | null | undefined;
+    main?: boolean | undefined;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    radius?: number | null | undefined;
+    siret?: string | null | undefined;
 }, {
-    id: number;
+    id: string;
     phone_number: string | null;
     address_line_1: string | null;
     address_line_2: string | null;
@@ -233,68 +256,103 @@ export declare const LocationSchema: z.ZodObject<{
     city: string | null;
     state: string | null;
     country: string | null;
-    company_id: number | null;
-    created_at: string | null;
-    updated_at: string | null;
+    company_id: string | null;
     name: string;
+    timezone?: string | null | undefined;
+    main?: boolean | undefined;
+    latitude?: number | null | undefined;
+    longitude?: number | null | undefined;
+    radius?: number | null | undefined;
+    siret?: string | null | undefined;
 }>;
 export type Location = z.infer<typeof LocationSchema>;
 /**
  * Contract schema
  *
- * Extended to include salary, job catalog, and compensation fields
- * available in the /contracts/contract-versions endpoint.
+ * Field set verified against live /contracts/contract-versions responses on
+ * API version 2026-07-01. The endpoint returns many more country-specific
+ * fields (es_*, fr_*, de_*, pt_*) that are not modelled here.
  */
 export declare const ContractSchema: z.ZodObject<{
-    id: z.ZodNumber;
-    employee_id: z.ZodNumber;
+    id: z.ZodString;
+    company_id: z.ZodOptional<z.ZodString>;
+    employee_id: z.ZodString;
     job_title: z.ZodNullable<z.ZodString>;
     effective_on: z.ZodNullable<z.ZodString>;
+    starts_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ends_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     salary_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     salary_frequency: z.ZodOptional<z.ZodNullable<z.ZodEnum<["yearly", "monthly", "weekly", "daily", "hourly"]>>>;
     working_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     working_hours_frequency: z.ZodOptional<z.ZodNullable<z.ZodEnum<["day", "week", "month", "year"]>>>;
-    job_catalog_level_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    job_catalog_role_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    contract_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    working_week_days: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    working_time_percentage_in_cents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    bank_holiday_treatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<["workable", "non_workable"]>>>;
+    has_payroll: z.ZodOptional<z.ZodBoolean>;
+    has_trial_period: z.ZodOptional<z.ZodBoolean>;
     trial_period_ends_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    ends_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    job_catalog_level_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    job_catalog_role_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    job_catalog_tree_node_uuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    de_base_salary_type_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version_data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     annual_working_time_distribution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodNullable<z.ZodString>;
     updated_at: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
+    id: string;
     created_at: string | null;
     updated_at: string | null;
-    employee_id: number;
+    employee_id: string;
     job_title: string | null;
     effective_on: string | null;
+    country?: string | null | undefined;
+    company_id?: string | undefined;
+    starts_on?: string | null | undefined;
+    ends_on?: string | null | undefined;
     salary_amount?: number | null | undefined;
     salary_frequency?: "yearly" | "monthly" | "weekly" | "daily" | "hourly" | null | undefined;
     working_hours?: number | null | undefined;
     working_hours_frequency?: "day" | "week" | "month" | "year" | null | undefined;
-    job_catalog_level_id?: number | null | undefined;
-    job_catalog_role_id?: number | null | undefined;
-    contract_type?: string | null | undefined;
+    working_week_days?: string | null | undefined;
+    working_time_percentage_in_cents?: number | null | undefined;
+    bank_holiday_treatment?: "workable" | "non_workable" | null | undefined;
+    has_payroll?: boolean | undefined;
+    has_trial_period?: boolean | undefined;
     trial_period_ends_on?: string | null | undefined;
-    ends_on?: string | null | undefined;
+    job_catalog_level_id?: string | null | undefined;
+    job_catalog_role_id?: string | null | undefined;
+    job_catalog_tree_node_uuid?: string | null | undefined;
+    de_base_salary_type_id?: string | null | undefined;
+    version_data?: Record<string, unknown> | null | undefined;
     annual_working_time_distribution?: string | null | undefined;
 }, {
-    id: number;
+    id: string;
     created_at: string | null;
     updated_at: string | null;
-    employee_id: number;
+    employee_id: string;
     job_title: string | null;
     effective_on: string | null;
+    country?: string | null | undefined;
+    company_id?: string | undefined;
+    starts_on?: string | null | undefined;
+    ends_on?: string | null | undefined;
     salary_amount?: number | null | undefined;
     salary_frequency?: "yearly" | "monthly" | "weekly" | "daily" | "hourly" | null | undefined;
     working_hours?: number | null | undefined;
     working_hours_frequency?: "day" | "week" | "month" | "year" | null | undefined;
-    job_catalog_level_id?: number | null | undefined;
-    job_catalog_role_id?: number | null | undefined;
-    contract_type?: string | null | undefined;
+    working_week_days?: string | null | undefined;
+    working_time_percentage_in_cents?: number | null | undefined;
+    bank_holiday_treatment?: "workable" | "non_workable" | null | undefined;
+    has_payroll?: boolean | undefined;
+    has_trial_period?: boolean | undefined;
     trial_period_ends_on?: string | null | undefined;
-    ends_on?: string | null | undefined;
+    job_catalog_level_id?: string | null | undefined;
+    job_catalog_role_id?: string | null | undefined;
+    job_catalog_tree_node_uuid?: string | null | undefined;
+    de_base_salary_type_id?: string | null | undefined;
+    version_data?: Record<string, unknown> | null | undefined;
     annual_working_time_distribution?: string | null | undefined;
 }>;
 export type Contract = z.infer<typeof ContractSchema>;
@@ -303,18 +361,18 @@ export type Contract = z.infer<typeof ContractSchema>;
  * Returns minimal fields to reduce response size
  */
 export declare const ContractSummarySchema: z.ZodObject<{
-    id: z.ZodNumber;
-    employee_id: z.ZodNumber;
+    id: z.ZodString;
+    employee_id: z.ZodString;
     job_title: z.ZodNullable<z.ZodString>;
     effective_on: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
-    employee_id: number;
+    id: string;
+    employee_id: string;
     job_title: string | null;
     effective_on: string | null;
 }, {
-    id: number;
-    employee_id: number;
+    id: string;
+    employee_id: string;
     job_title: string | null;
     effective_on: string | null;
 }>;

package/dist/schemas/employees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"employees.d.ts","sourceRoot":"","sources":["../../src/schemas/employees.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyEzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAazB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAapC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAAkC,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"employees.d.ts","sourceRoot":"","sources":["../../src/schemas/employees.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8EzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAQrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAapC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAAkC,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}