@deepintel-ltd/buildlink-api-contracts 0.2.23

package/contracts/resources.js

@@ -0,0 +1,869 @@
+import { initContract } from '@ts-rest/core';
+import { z } from 'zod';
+import { CuidSchema, JsonApiCollectionResponseSchema, JsonApiErrorResponseSchema, JsonApiResponseSchema, } from '../schemas/common';
+import { BaseFiltersSchema, CreateEquipmentRequestSchema, CreateLaborResourceRequestSchema, CreateMaterialRequestSchema, CreateResourceAllocationRequestSchema, CreateResourceAssignmentRequestSchema, EquipmentFiltersSchema, EquipmentResourceSchema, LaborResourceFiltersSchema, LaborResourceResourceSchema, MaterialFiltersSchema, MaterialResourceSchema, MaterialStockAdjustmentSchema, ResourceAllocationSchema, ResourceAssignmentResourceSchema, ResourceAvailabilityRequestSchema, ResourceAvailabilityResponseSchema, ResourceInsightsQuerySchema, ResourceInsightsResponseSchema, ResourceOptimizationQuerySchema, ResourceOptimizationResponseSchema, ResourceSearchQuerySchema, ResourceSearchResourceSchema, ResourceStatusSchema, ResourceUtilizationQuerySchema, UpdateEquipmentRequestSchema, UpdateLaborResourceRequestSchema, UpdateMaterialRequestSchema, UpdateResourceAllocationRequestSchema, } from '../schemas/resources';
+const c = initContract();
+// Enhanced cursor pagination schema for production use
+const CursorPaginationQuerySchema = z.object({
+    cursor: z.string().optional(),
+    limit: z.coerce.number().min(1).max(100).default(20),
+    direction: z.enum(['forward', 'backward']).default('forward'),
+    includeTotal: z.coerce.boolean().default(false),
+});
+// Standard query parameters for filtering
+const StandardQuerySchema = z.object({
+    search: z.string().optional(),
+    status: ResourceStatusSchema.optional(),
+    location: z.string().optional(),
+    category: z.string().optional(),
+    sortBy: z.enum(['name', 'createdAt', 'updatedAt', 'status']).default('updatedAt'),
+    sortOrder: z.enum(['asc', 'desc']).default('desc'),
+});
+export const resourcesContract = c.router({
+    // ===== EQUIPMENT MANAGEMENT =====
+    getEquipmentList: {
+        method: 'GET',
+        path: '/resources/equipment',
+        query: EquipmentFiltersSchema.merge(CursorPaginationQuerySchema).merge(StandardQuerySchema),
+        responses: {
+            200: JsonApiCollectionResponseSchema(EquipmentResourceSchema).extend({
+                meta: z.object({
+                    pagination: z.object({
+                        hasNextPage: z.boolean(),
+                        hasPreviousPage: z.boolean(),
+                        nextCursor: z.string().optional(),
+                        previousCursor: z.string().optional(),
+                        totalCount: z.number().optional(),
+                    }),
+                    filters: z.record(z.unknown()).optional(),
+                }),
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get all equipment',
+        description: 'Retrieve all equipment with advanced filtering, sorting, and cursor-based pagination',
+    },
+    getEquipment: {
+        method: 'GET',
+        path: '/resources/equipment/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        query: z.object({
+            include: z.array(z.enum(['allocations', 'maintenance', 'projects'])).optional(),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(EquipmentResourceSchema).extend({
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get equipment by ID',
+        description: 'Retrieve detailed information about a specific equipment item',
+    },
+    createEquipment: {
+        method: 'POST',
+        path: '/resources/equipment',
+        body: z.object({
+            data: z.object({
+                type: z.literal('equipment'),
+                attributes: CreateEquipmentRequestSchema,
+            }),
+        }),
+        responses: {
+            201: JsonApiResponseSchema(EquipmentResourceSchema).extend({
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create equipment',
+        description: 'Add new equipment to the system with full validation',
+    },
+    updateEquipment: {
+        method: 'PATCH',
+        path: '/resources/equipment/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('equipment'),
+                id: CuidSchema,
+                attributes: UpdateEquipmentRequestSchema,
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(EquipmentResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Update equipment',
+        description: 'Update existing equipment with validation and audit logging',
+    },
+    deleteEquipment: {
+        method: 'DELETE',
+        path: '/resources/equipment/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: null,
+        responses: {
+            204: z.null(),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            409: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Delete equipment',
+        description: 'Safely remove equipment from the system with dependency checking',
+    },
+    // ===== MATERIAL MANAGEMENT =====
+    getMaterialsList: {
+        method: 'GET',
+        path: '/resources/materials',
+        query: MaterialFiltersSchema.merge(CursorPaginationQuerySchema)
+            .merge(StandardQuerySchema)
+            .extend({
+            lowStock: z.coerce.boolean().optional(),
+            expiringSoon: z.coerce.boolean().optional(),
+        }),
+        responses: {
+            200: JsonApiCollectionResponseSchema(MaterialResourceSchema).extend({
+                meta: z.object({
+                    pagination: z.object({
+                        hasNextPage: z.boolean(),
+                        hasPreviousPage: z.boolean(),
+                        nextCursor: z.string().optional(),
+                        previousCursor: z.string().optional(),
+                        totalCount: z.number().optional(),
+                    }),
+                    summary: z
+                        .object({
+                        totalValue: z.number(),
+                        lowStockItems: z.number(),
+                        expiringSoonItems: z.number(),
+                    })
+                        .optional(),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get all materials',
+        description: 'Retrieve materials inventory with stock level monitoring',
+    },
+    getMaterial: {
+        method: 'GET',
+        path: '/resources/materials/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        query: z.object({
+            include: z.array(z.enum(['stockHistory', 'allocations', 'suppliers'])).optional(),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(MaterialResourceSchema).extend({
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get material by ID',
+        description: 'Retrieve detailed material information including stock history',
+    },
+    createMaterial: {
+        method: 'POST',
+        path: '/resources/materials',
+        body: z.object({
+            data: z.object({
+                type: z.literal('materials'),
+                attributes: CreateMaterialRequestSchema,
+            }),
+        }),
+        responses: {
+            201: JsonApiResponseSchema(MaterialResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create material',
+        description: 'Add new material to inventory with automatic reorder point setup',
+    },
+    updateMaterial: {
+        method: 'PATCH',
+        path: '/resources/materials/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('materials'),
+                id: CuidSchema,
+                attributes: UpdateMaterialRequestSchema,
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(MaterialResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Update material',
+        description: 'Update material information with validation',
+    },
+    deleteMaterial: {
+        method: 'DELETE',
+        path: '/resources/materials/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: null,
+        responses: {
+            204: z.null(),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            409: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Delete material',
+        description: 'Remove material from inventory with safety checks',
+    },
+    adjustMaterialStock: {
+        method: 'POST',
+        path: '/resources/materials/:id/stock-adjustment',
+        pathParams: z.object({ id: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('material-stock-adjustments'),
+                attributes: MaterialStockAdjustmentSchema,
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(MaterialResourceSchema).extend({
+                meta: z.object({
+                    adjustment: z.object({
+                        previousQuantity: z.number(),
+                        newQuantity: z.number(),
+                        adjustmentAmount: z.number(),
+                        reason: z.string(),
+                    }),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Adjust material stock',
+        description: 'Adjust material stock levels with audit trail',
+    },
+    // ===== LABOR RESOURCE MANAGEMENT =====
+    getLaborResourcesList: {
+        method: 'GET',
+        path: '/resources/labor',
+        query: LaborResourceFiltersSchema.merge(CursorPaginationQuerySchema)
+            .merge(StandardQuerySchema)
+            .extend({
+            skillLevel: z.enum(['JUNIOR', 'INTERMEDIATE', 'SENIOR', 'EXPERT']).optional(),
+            availability: z.enum(['FULL_TIME', 'PART_TIME', 'CONTRACT', 'ON_CALL']).optional(),
+            available: z.coerce.boolean().optional(),
+        }),
+        responses: {
+            200: JsonApiCollectionResponseSchema(LaborResourceResourceSchema).extend({
+                meta: z.object({
+                    pagination: z.object({
+                        hasNextPage: z.boolean(),
+                        hasPreviousPage: z.boolean(),
+                        nextCursor: z.string().optional(),
+                        previousCursor: z.string().optional(),
+                        totalCount: z.number().optional(),
+                    }),
+                    summary: z
+                        .object({
+                        totalResources: z.number(),
+                        availableResources: z.number(),
+                        averageHourlyRate: z.number(),
+                    })
+                        .optional(),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get all labor resources',
+        description: 'Retrieve labor resources with availability and skill filtering',
+    },
+    getLaborResource: {
+        method: 'GET',
+        path: '/resources/labor/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        query: z.object({
+            include: z.array(z.enum(['assignments', 'skills', 'performance'])).optional(),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(LaborResourceResourceSchema).extend({
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get labor resource by ID',
+        description: 'Retrieve detailed labor resource information',
+    },
+    createLaborResource: {
+        method: 'POST',
+        path: '/resources/labor',
+        body: z.object({
+            data: z.object({
+                type: z.literal('labor-resources'),
+                attributes: CreateLaborResourceRequestSchema,
+            }),
+        }),
+        responses: {
+            201: JsonApiResponseSchema(LaborResourceResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create labor resource',
+        description: 'Add new labor resource with skill and availability setup',
+    },
+    updateLaborResource: {
+        method: 'PATCH',
+        path: '/resources/labor/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('labor-resources'),
+                id: CuidSchema,
+                attributes: UpdateLaborResourceRequestSchema,
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(LaborResourceResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Update labor resource',
+        description: 'Update labor resource information and availability',
+    },
+    deleteLaborResource: {
+        method: 'DELETE',
+        path: '/resources/labor/:id',
+        pathParams: z.object({ id: CuidSchema }),
+        body: null,
+        responses: {
+            204: z.null(),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            409: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Delete labor resource',
+        description: 'Remove labor resource with assignment safety checks',
+    },
+    // ===== RESOURCE ASSIGNMENTS =====
+    getResourceAssignments: {
+        method: 'GET',
+        path: '/projects/:projectId/resource-assignments',
+        pathParams: z.object({ projectId: CuidSchema }),
+        query: CursorPaginationQuerySchema.extend({
+            resourceType: z.enum(['EQUIPMENT', 'MATERIAL', 'LABOR']).optional(),
+            status: z.enum(['ACTIVE', 'COMPLETED', 'CANCELLED']).optional(),
+            startDate: z.string().date().optional(),
+            endDate: z.string().date().optional(),
+        }),
+        responses: {
+            200: JsonApiCollectionResponseSchema(ResourceAssignmentResourceSchema).extend({
+                meta: z.object({
+                    pagination: z.object({
+                        hasNextPage: z.boolean(),
+                        hasPreviousPage: z.boolean(),
+                        nextCursor: z.string().optional(),
+                        previousCursor: z.string().optional(),
+                        totalCount: z.number().optional(),
+                    }),
+                    summary: z
+                        .object({
+                        totalAssignments: z.number(),
+                        activeAssignments: z.number(),
+                        totalCost: z.number(),
+                    })
+                        .optional(),
+                }),
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get project resource assignments',
+        description: 'Retrieve all resource assignments for a specific project',
+    },
+    createResourceAssignment: {
+        method: 'POST',
+        path: '/projects/:projectId/resource-assignments',
+        pathParams: z.object({ projectId: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-assignments'),
+                attributes: CreateResourceAssignmentRequestSchema,
+            }),
+        }),
+        responses: {
+            201: JsonApiResponseSchema(ResourceAssignmentResourceSchema).extend({
+                included: z
+                    .array(z.object({
+                    type: z.string(),
+                    id: z.string(),
+                    attributes: z.record(z.unknown()),
+                }))
+                    .optional(),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            409: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create resource assignment',
+        description: 'Assign a resource to a project with availability validation',
+    },
+    updateResourceAssignment: {
+        method: 'PATCH',
+        path: '/projects/:projectId/resource-assignments/:assignmentId',
+        pathParams: z.object({
+            projectId: CuidSchema,
+            assignmentId: CuidSchema,
+        }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-assignments'),
+                id: CuidSchema,
+                attributes: z.object({
+                    quantity: z.number().positive().optional(),
+                    notes: z.string().optional(),
+                    returnedAt: z.string().datetime().optional(),
+                }),
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(ResourceAssignmentResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Update resource assignment',
+        description: 'Update resource assignment details or mark as returned',
+    },
+    deleteResourceAssignment: {
+        method: 'DELETE',
+        path: '/projects/:projectId/resource-assignments/:assignmentId',
+        pathParams: z.object({
+            projectId: CuidSchema,
+            assignmentId: CuidSchema,
+        }),
+        body: null,
+        responses: {
+            204: z.null(),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Delete resource assignment',
+        description: 'Remove resource assignment and free up the resource',
+    },
+    // ===== ADVANCED RESOURCE OPERATIONS =====
+    searchResources: {
+        method: 'GET',
+        path: '/resources/search',
+        query: ResourceSearchQuerySchema,
+        responses: {
+            200: JsonApiCollectionResponseSchema(ResourceSearchResourceSchema).extend({
+                meta: z.object({
+                    searchQuery: z.string(),
+                    totalResults: z.number(),
+                    searchTime: z.number(),
+                    filters: z.record(z.unknown()).optional(),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Search resources',
+        description: 'Advanced search across all resource types with relevance scoring',
+    },
+    checkResourceAvailability: {
+        method: 'POST',
+        path: '/resources/availability-check',
+        body: ResourceAvailabilityRequestSchema,
+        responses: {
+            200: ResourceAvailabilityResponseSchema,
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Check resource availability',
+        description: 'Check resource availability with conflict detection and alternatives',
+    },
+    getResourceUtilization: {
+        method: 'GET',
+        path: '/resources/utilization',
+        query: ResourceUtilizationQuerySchema,
+        responses: {
+            200: z.object({
+                data: z.object({
+                    type: z.literal('resource-utilization'),
+                    id: z.string(),
+                    attributes: z.object({
+                        period: z.object({
+                            startDate: z.string().date(),
+                            endDate: z.string().date(),
+                        }),
+                        summary: z.object({
+                            totalResources: z.number(),
+                            averageUtilization: z.number().min(0).max(1),
+                            totalCost: z.number(),
+                            efficiency: z.number().min(0).max(1),
+                        }),
+                        equipment: z.array(z.object({
+                            id: CuidSchema,
+                            name: z.string(),
+                            utilizationRate: z.number().min(0).max(1),
+                            totalHours: z.number().min(0),
+                            downtime: z.number().min(0),
+                            costEfficiency: z.number().min(0).max(1),
+                        })),
+                        materials: z.array(z.object({
+                            id: CuidSchema,
+                            name: z.string(),
+                            consumptionRate: z.number().min(0),
+                            wastePercentage: z.number().min(0).max(1),
+                            totalUsed: z.number().min(0),
+                            costPerUnit: z.number(),
+                        })),
+                        labor: z.array(z.object({
+                            id: CuidSchema,
+                            name: z.string(),
+                            efficiencyScore: z.number().min(0).max(1),
+                            hoursWorked: z.number().min(0),
+                            overtimeHours: z.number().min(0),
+                            productivityRate: z.number().min(0),
+                        })),
+                    }),
+                }),
+                meta: z.object({
+                    generatedAt: z.string().datetime(),
+                    reportPeriod: z.string(),
+                    includeDowntime: z.boolean(),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get resource utilization report',
+        description: 'Comprehensive utilization analytics with performance metrics',
+    },
+    getResourceInsights: {
+        method: 'GET',
+        path: '/resources/insights',
+        query: ResourceInsightsQuerySchema,
+        responses: {
+            200: ResourceInsightsResponseSchema,
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get resource insights',
+        description: 'AI-powered insights and recommendations for resource optimization',
+    },
+    optimizeResourceAllocation: {
+        method: 'POST',
+        path: '/resources/optimization',
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-optimization-request'),
+                attributes: ResourceOptimizationQuerySchema,
+            }),
+        }),
+        responses: {
+            200: ResourceOptimizationResponseSchema,
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Optimize resource allocation',
+        description: 'Generate AI-powered optimization recommendations for resource allocation',
+    },
+    // ===== RESOURCE ALLOCATIONS =====
+    getResourceAllocations: {
+        method: 'GET',
+        path: '/projects/:projectId/resource-allocations',
+        pathParams: z.object({ projectId: CuidSchema }),
+        query: CursorPaginationQuerySchema.merge(z.object({
+            resourceId: CuidSchema.optional(),
+            startDate: z.string().datetime().optional(),
+            endDate: z.string().datetime().optional(),
+            status: z.enum(['IN_USE', 'COMPLETED']).optional(),
+        })),
+        responses: {
+            200: JsonApiCollectionResponseSchema(z.object({
+                type: z.literal('resource-allocations'),
+                id: CuidSchema,
+                attributes: ResourceAllocationSchema,
+            })),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get project resource allocations',
+        description: 'Retrieve allocations for a single project',
+    },
+    getResourceAllocation: {
+        method: 'GET',
+        path: '/projects/:projectId/resource-allocations/:allocationId',
+        pathParams: z.object({ projectId: CuidSchema, allocationId: CuidSchema }),
+        responses: {
+            200: JsonApiResponseSchema(z.object({
+                type: z.literal('resource-allocations'),
+                id: CuidSchema,
+                attributes: ResourceAllocationSchema,
+            })),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get allocation by ID',
+        description: 'Retrieve a single resource allocation record',
+    },
+    createResourceAllocation: {
+        method: 'POST',
+        path: '/projects/:projectId/resource-allocations',
+        pathParams: z.object({ projectId: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-allocations'),
+                attributes: CreateResourceAllocationRequestSchema,
+            }),
+        }),
+        responses: {
+            201: JsonApiResponseSchema(z.object({
+                type: z.literal('resource-allocations'),
+                id: CuidSchema,
+                attributes: ResourceAllocationSchema,
+            })),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create allocation',
+        description: 'Allocate a resource to a project',
+    },
+    updateResourceAllocation: {
+        method: 'PATCH',
+        path: '/projects/:projectId/resource-allocations/:allocationId',
+        pathParams: z.object({ projectId: CuidSchema, allocationId: CuidSchema }),
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-allocations'),
+                id: CuidSchema,
+                attributes: UpdateResourceAllocationRequestSchema,
+            }),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(z.object({
+                type: z.literal('resource-allocations'),
+                id: CuidSchema,
+                attributes: ResourceAllocationSchema,
+            })),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Update allocation',
+        description: 'Patch an existing allocation',
+    },
+    deleteResourceAllocation: {
+        method: 'DELETE',
+        path: '/projects/:projectId/resource-allocations/:allocationId',
+        pathParams: z.object({ projectId: CuidSchema, allocationId: CuidSchema }),
+        body: null,
+        responses: {
+            204: z.null(),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Delete allocation',
+        description: 'Remove allocation and restore resource availability',
+    },
+    // ===== BULK OPERATIONS =====
+    bulkUpdateResources: {
+        method: 'PATCH',
+        path: '/resources/bulk-update',
+        body: z.object({
+            data: z.array(z.object({
+                type: z.enum(['equipment', 'materials', 'labor-resources']),
+                id: CuidSchema,
+                attributes: z.record(z.unknown()),
+            })),
+        }),
+        responses: {
+            200: z.object({
+                data: z.array(z.object({
+                    type: z.string(),
+                    id: CuidSchema,
+                    attributes: z.object({
+                        success: z.boolean(),
+                        message: z.string().optional(),
+                    }),
+                })),
+                meta: z.object({
+                    totalProcessed: z.number(),
+                    successful: z.number(),
+                    failed: z.number(),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Bulk update resources',
+        description: 'Update multiple resources in a single operation with transaction safety',
+    },
+    exportResources: {
+        method: 'POST',
+        path: '/resources/export',
+        body: z.object({
+            data: z.object({
+                type: z.literal('resource-export-request'),
+                attributes: z.object({
+                    resourceTypes: z.array(z.enum(['EQUIPMENT', 'MATERIAL', 'LABOR'])).optional(),
+                    format: z.enum(['csv', 'xlsx', 'json']).default('csv'),
+                    filters: BaseFiltersSchema.optional(),
+                    includeRelations: z.boolean().default(false),
+                }),
+            }),
+        }),
+        responses: {
+            202: z.object({
+                data: z.object({
+                    type: z.literal('export-job'),
+                    id: CuidSchema,
+                    attributes: z.object({
+                        status: z.literal('processing'),
+                        downloadUrl: z.string().optional(),
+                        expiresAt: z.string().datetime(),
+                    }),
+                }),
+            }),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            422: JsonApiErrorResponseSchema,
+            500: JsonApiErrorResponseSchema,
+        },
+        summary: 'Export resources data',
+        description: 'Export resource data in various formats with async processing',
+    },
+});
+//# sourceMappingURL=resources.js.map