@t4dhg/mcp-factorial 1.1.0 → 2.0.0

package/dist/schemas.d.ts

@@ -0,0 +1,502 @@
+/**
+ * Zod schemas for runtime validation of API responses
+ *
+ * Catches API version mismatches and ensures type safety at runtime.
+ */
+import { z } from 'zod';
+/**
+ * Employee schema
+ */
+export declare const EmployeeSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    first_name: z.ZodNullable<z.ZodString>;
+    last_name: z.ZodNullable<z.ZodString>;
+    full_name: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    birthday_on: z.ZodNullable<z.ZodString>;
+    hired_on: z.ZodNullable<z.ZodString>;
+    start_date: z.ZodNullable<z.ZodString>;
+    terminated_on: z.ZodNullable<z.ZodString>;
+    gender: z.ZodNullable<z.ZodString>;
+    nationality: z.ZodNullable<z.ZodString>;
+    manager_id: z.ZodNullable<z.ZodNumber>;
+    role: z.ZodNullable<z.ZodString>;
+    timeoff_manager_id: z.ZodNullable<z.ZodNumber>;
+    company_id: z.ZodNullable<z.ZodNumber>;
+    legal_entity_id: z.ZodNullable<z.ZodNumber>;
+    team_ids: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
+    location_id: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    first_name: string | null;
+    last_name: string | null;
+    full_name: string | null;
+    email: string | null;
+    birthday_on: string | null;
+    hired_on: string | null;
+    start_date: string | null;
+    terminated_on: string | null;
+    gender: string | null;
+    nationality: string | null;
+    manager_id: number | null;
+    role: string | null;
+    timeoff_manager_id: number | null;
+    company_id: number | null;
+    legal_entity_id: number | null;
+    team_ids: number[];
+    location_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+}, {
+    id: number;
+    first_name: string | null;
+    last_name: string | null;
+    full_name: string | null;
+    email: string | null;
+    birthday_on: string | null;
+    hired_on: string | null;
+    start_date: string | null;
+    terminated_on: string | null;
+    gender: string | null;
+    nationality: string | null;
+    manager_id: number | null;
+    role: string | null;
+    timeoff_manager_id: number | null;
+    company_id: number | null;
+    legal_entity_id: number | null;
+    location_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    team_ids?: number[] | undefined;
+}>;
+export type Employee = z.infer<typeof EmployeeSchema>;
+/**
+ * Team schema
+ */
+export declare const TeamSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    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>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+    employee_ids: number[];
+    lead_ids: number[];
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+    employee_ids?: number[] | undefined;
+    lead_ids?: number[] | undefined;
+}>;
+export type Team = z.infer<typeof TeamSchema>;
+/**
+ * Location schema
+ */
+export declare const LocationSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    country: z.ZodNullable<z.ZodString>;
+    phone_number: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    city: z.ZodNullable<z.ZodString>;
+    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>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    country: string | null;
+    phone_number: string | null;
+    state: string | null;
+    city: string | null;
+    address_line_1: string | null;
+    address_line_2: string | null;
+    postal_code: string | null;
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    country: string | null;
+    phone_number: string | null;
+    state: string | null;
+    city: string | null;
+    address_line_1: string | null;
+    address_line_2: string | null;
+    postal_code: string | null;
+}>;
+export type Location = z.infer<typeof LocationSchema>;
+/**
+ * Contract schema
+ */
+export declare const ContractSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    employee_id: z.ZodNumber;
+    job_title: z.ZodNullable<z.ZodString>;
+    effective_on: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    job_title: string | null;
+    effective_on: string | null;
+}, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    job_title: string | null;
+    effective_on: string | null;
+}>;
+export type Contract = z.infer<typeof ContractSchema>;
+/**
+ * Leave schema
+ */
+export declare const LeaveSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    employee_id: z.ZodNumber;
+    leave_type_id: z.ZodNumber;
+    start_on: z.ZodString;
+    finish_on: z.ZodString;
+    half_day: z.ZodNullable<z.ZodEnum<["all_day", "start", "finish"]>>;
+    status: z.ZodEnum<["pending", "approved", "declined"]>;
+    description: z.ZodNullable<z.ZodString>;
+    deleted_at: z.ZodNullable<z.ZodString>;
+    duration_attributes: z.ZodNullable<z.ZodObject<{
+        days: z.ZodNumber;
+        hours: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        days: number;
+        hours: number;
+    }, {
+        days: number;
+        hours: number;
+    }>>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    status: "pending" | "approved" | "declined";
+    created_at: string | null;
+    updated_at: string | null;
+    description: string | null;
+    employee_id: number;
+    leave_type_id: number;
+    start_on: string;
+    finish_on: string;
+    half_day: "all_day" | "start" | "finish" | null;
+    deleted_at: string | null;
+    duration_attributes: {
+        days: number;
+        hours: number;
+    } | null;
+}, {
+    id: number;
+    status: "pending" | "approved" | "declined";
+    created_at: string | null;
+    updated_at: string | null;
+    description: string | null;
+    employee_id: number;
+    leave_type_id: number;
+    start_on: string;
+    finish_on: string;
+    half_day: "all_day" | "start" | "finish" | null;
+    deleted_at: string | null;
+    duration_attributes: {
+        days: number;
+        hours: number;
+    } | null;
+}>;
+export type Leave = z.infer<typeof LeaveSchema>;
+/**
+ * Leave type schema
+ */
+export declare const LeaveTypeSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    code: z.ZodNullable<z.ZodString>;
+    color: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    company_id: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    code: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+    color: string | null;
+}, {
+    id: number;
+    company_id: number | null;
+    code: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+    color: string | null;
+}>;
+export type LeaveType = z.infer<typeof LeaveTypeSchema>;
+/**
+ * Allowance schema
+ */
+export declare const AllowanceSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    employee_id: z.ZodNumber;
+    leave_type_id: z.ZodNumber;
+    policy_id: z.ZodNullable<z.ZodNumber>;
+    balance_days: z.ZodNumber;
+    consumed_days: z.ZodNumber;
+    available_days: z.ZodNumber;
+    valid_from: z.ZodNullable<z.ZodString>;
+    valid_to: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    leave_type_id: number;
+    policy_id: number | null;
+    balance_days: number;
+    consumed_days: number;
+    available_days: number;
+    valid_from: string | null;
+    valid_to: string | null;
+}, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    leave_type_id: number;
+    policy_id: number | null;
+    balance_days: number;
+    consumed_days: number;
+    available_days: number;
+    valid_from: string | null;
+    valid_to: string | null;
+}>;
+export type Allowance = z.infer<typeof AllowanceSchema>;
+/**
+ * Shift schema
+ */
+export declare const ShiftSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    employee_id: z.ZodNumber;
+    clock_in: z.ZodString;
+    clock_out: z.ZodNullable<z.ZodString>;
+    worked_hours: z.ZodNullable<z.ZodNumber>;
+    break_minutes: z.ZodNullable<z.ZodNumber>;
+    location: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    clock_in: string;
+    clock_out: string | null;
+    worked_hours: number | null;
+    break_minutes: number | null;
+    location: string | null;
+    notes: string | null;
+}, {
+    id: number;
+    created_at: string | null;
+    updated_at: string | null;
+    employee_id: number;
+    clock_in: string;
+    clock_out: string | null;
+    worked_hours: number | null;
+    break_minutes: number | null;
+    location: string | null;
+    notes: string | null;
+}>;
+export type Shift = z.infer<typeof ShiftSchema>;
+/**
+ * Folder schema
+ */
+export declare const FolderSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    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>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    parent_id: number | null;
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    parent_id: number | null;
+}>;
+export type Folder = z.infer<typeof FolderSchema>;
+/**
+ * Document schema
+ */
+export declare const DocumentSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    folder_id: z.ZodNullable<z.ZodNumber>;
+    author_id: z.ZodNullable<z.ZodNumber>;
+    company_id: z.ZodNullable<z.ZodNumber>;
+    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>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    folder_id: number | null;
+    author_id: number | null;
+    public: boolean;
+    space: string | null;
+    file_url: string | null;
+    mime_type: string | null;
+    size_bytes: number | null;
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    folder_id: number | null;
+    author_id: number | null;
+    space: string | null;
+    file_url: string | null;
+    mime_type: string | null;
+    size_bytes: number | null;
+    public?: boolean | undefined;
+}>;
+export type Document = z.infer<typeof DocumentSchema>;
+/**
+ * Job role schema
+ */
+export declare const JobRoleSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    company_id: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+}>;
+export type JobRole = z.infer<typeof JobRoleSchema>;
+/**
+ * Job level schema
+ */
+export declare const JobLevelSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    company_id: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+}, {
+    id: number;
+    company_id: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    name: string;
+    description: string | null;
+}>;
+export type JobLevel = z.infer<typeof JobLevelSchema>;
+/**
+ * API response wrapper schema
+ */
+export declare function createApiResponseSchema<T extends z.ZodTypeAny>(dataSchema: T): z.ZodObject<{
+    data: T;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    data: T;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    data: T;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * API list response wrapper schema
+ */
+export declare function createApiListResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    data: z.ZodArray<T, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+}, {
+    data: T["_input"][];
+}>;
+/**
+ * Parse and validate data against a schema
+ * @throws SchemaValidationError if validation fails
+ */
+export declare function parseData<T>(schemaName: string, schema: z.ZodSchema<T>, data: unknown): T;
+/**
+ * Safely parse data without throwing (returns undefined on failure)
+ */
+export declare function safeParseData<T>(schema: z.ZodSchema<T>, data: unknown): T | undefined;
+/**
+ * Parse an array of items against a schema
+ */
+export declare function parseArray<T>(schemaName: string, itemSchema: z.ZodSchema<T>, data: unknown): T[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}