@deepintel-ltd/farmpro-contracts 1.7.5 → 1.7.8

package/dist/routes/livestock-groups.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livestock-groups.routes.d.ts","sourceRoot":"","sources":["../../src/routes/livestock-groups.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ShC,CAAC"}

package/dist/routes/livestock-groups.routes.js

@@ -0,0 +1,287 @@
+import { initContract } from '@ts-rest/core';
+import { z } from 'zod';
+import { createLivestockGroupSchema, updateLivestockGroupSchema, createBatchRecordSchema, livestockGroupResponseSchema, livestockGroupListResponseSchema, batchRecordResponseSchema, batchRecordListResponseSchema, groupStatsResponseSchema, bulkAddMembersSchema, bulkRemoveMembersSchema, bulkCreateLivestockSchema, bulkHealthRecordSchema, bulkOperationResponseSchema, livestockGroupTypeSchema, trackingModeSchema, groupStatusSchema, batchRecordTypeSchema, } from '../schemas/livestock-groups.schemas';
+import { livestockCategorySchema, livestockListResponseSchema } from '../schemas/livestock.schemas';
+import { jsonApiErrorResponseSchema, jsonApiSuccessResponseSchema, jsonApiPaginationQuerySchema, jsonApiSortQuerySchema, } from '../schemas/common.schemas';
+const c = initContract();
+export const livestockGroupsRouter = c.router({
+    // ============================================================================
+    // Livestock Group CRUD
+    // ============================================================================
+    // List groups for a farm
+    listGroups: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        query: jsonApiPaginationQuerySchema
+            .merge(jsonApiSortQuerySchema)
+            .merge(z.object({
+            'filter[category]': livestockCategorySchema.optional(),
+            'filter[groupType]': livestockGroupTypeSchema.optional(),
+            'filter[trackingMode]': trackingModeSchema.optional(),
+            'filter[status]': groupStatusSchema.optional(),
+            search: z.string().optional(),
+        })),
+        responses: {
+            200: livestockGroupListResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'List livestock groups',
+        description: 'Get all livestock groups/batches for a farm with optional filtering',
+    },
+    // Get group statistics
+    getGroupStats: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups/stats',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        responses: {
+            200: groupStatsResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'Get group statistics',
+        description: 'Get summary statistics for all livestock groups on the farm',
+    },
+    // Create group
+    createGroup: {
+        method: 'POST',
+        path: '/farms/:farmId/livestock-groups',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        body: z.object({ data: createLivestockGroupSchema }),
+        responses: {
+            201: livestockGroupResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            409: jsonApiErrorResponseSchema, // Duplicate groupCode
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Create livestock group',
+        description: 'Create a new livestock group/batch (flock, herd, pond, etc.)',
+    },
+    // Get group by ID
+    getGroup: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups/:groupId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        responses: {
+            200: livestockGroupResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'Get livestock group by ID',
+        description: 'Get detailed information about a livestock group',
+    },
+    // Update group
+    updateGroup: {
+        method: 'PATCH',
+        path: '/farms/:farmId/livestock-groups/:groupId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        body: z.object({ data: updateLivestockGroupSchema }),
+        responses: {
+            200: livestockGroupResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            409: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Update livestock group',
+        description: 'Update livestock group information',
+    },
+    // Delete group
+    deleteGroup: {
+        method: 'DELETE',
+        path: '/farms/:farmId/livestock-groups/:groupId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        responses: {
+            204: jsonApiSuccessResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'Delete livestock group',
+        description: 'Delete a livestock group (does not delete member animals)',
+    },
+    // ============================================================================
+    // Group Members Management
+    // ============================================================================
+    // List group members (individual animals in the group)
+    listGroupMembers: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups/:groupId/members',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        query: jsonApiPaginationQuerySchema.merge(jsonApiSortQuerySchema),
+        responses: {
+            200: livestockListResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'List group members',
+        description: 'Get all individual animals in a livestock group',
+    },
+    // Add animals to group
+    addGroupMembers: {
+        method: 'POST',
+        path: '/farms/:farmId/livestock-groups/:groupId/members',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        body: z.object({ data: bulkAddMembersSchema }),
+        responses: {
+            200: bulkOperationResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Add animals to group',
+        description: 'Add existing livestock to a group',
+    },
+    // Remove animals from group
+    removeGroupMembers: {
+        method: 'DELETE',
+        path: '/farms/:farmId/livestock-groups/:groupId/members',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        body: z.object({ data: bulkRemoveMembersSchema }),
+        responses: {
+            200: bulkOperationResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Remove animals from group',
+        description: 'Remove animals from a group (does not delete the animals)',
+    },
+    // ============================================================================
+    // Batch Records (for BATCH tracking mode)
+    // ============================================================================
+    // List batch records for a group
+    listBatchRecords: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups/:groupId/records',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        query: jsonApiPaginationQuerySchema
+            .merge(jsonApiSortQuerySchema)
+            .merge(z.object({
+            'filter[recordType]': batchRecordTypeSchema.optional(),
+            'filter[startDate]': z.string().datetime().optional(),
+            'filter[endDate]': z.string().datetime().optional(),
+        })),
+        responses: {
+            200: batchRecordListResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'List batch records',
+        description: 'Get all batch-level records for a group (mortality, feeding, egg collection, etc.)',
+    },
+    // Create batch record
+    createBatchRecord: {
+        method: 'POST',
+        path: '/farms/:farmId/livestock-groups/:groupId/records',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        body: z.object({ data: createBatchRecordSchema }),
+        responses: {
+            201: batchRecordResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Create batch record',
+        description: 'Record a batch-level event (stocking, mortality, feeding, egg collection, etc.)',
+    },
+    // Get batch record by ID
+    getBatchRecord: {
+        method: 'GET',
+        path: '/farms/:farmId/livestock-groups/:groupId/records/:recordId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+            recordId: z.string().uuid(),
+        }),
+        responses: {
+            200: batchRecordResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'Get batch record by ID',
+        description: 'Get detailed information about a batch record',
+    },
+    // Delete batch record
+    deleteBatchRecord: {
+        method: 'DELETE',
+        path: '/farms/:farmId/livestock-groups/:groupId/records/:recordId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+            recordId: z.string().uuid(),
+        }),
+        responses: {
+            204: jsonApiSuccessResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+        },
+        summary: 'Delete batch record',
+        description: 'Delete a batch record',
+    },
+    // ============================================================================
+    // Bulk Operations
+    // ============================================================================
+    // Bulk create livestock
+    bulkCreateLivestock: {
+        method: 'POST',
+        path: '/farms/:farmId/livestock/bulk',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        body: z.object({ data: bulkCreateLivestockSchema }),
+        responses: {
+            201: bulkOperationResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Bulk create livestock',
+        description: 'Create multiple livestock at once with auto-generated tags or explicit entries',
+    },
+    // Bulk health record (apply to group or list of animals)
+    bulkHealthRecord: {
+        method: 'POST',
+        path: '/farms/:farmId/livestock/bulk/health-records',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        body: z.object({ data: bulkHealthRecordSchema }),
+        responses: {
+            201: bulkOperationResponseSchema,
+            400: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            422: jsonApiErrorResponseSchema,
+        },
+        summary: 'Bulk health record',
+        description: 'Apply a health record (vaccination, treatment) to a group or list of animals',
+    },
+});