@deepintel-ltd/farmpro-contracts 1.23.1 → 1.24.0

package/dist/routes/poultry.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poultry.routes.d.ts","sourceRoot":"","sources":["../../src/routes/poultry.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,8BAA8B,gCAA8B,CAAC;AAE1E,eAAO,MAAM,8BAA8B,2CAAyC,CAAC;AAErF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAQpC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMvC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOtC,CAAC;AAEH,eAAO,MAAM,0BAA0B,6CAA2C,CAAC;AAEnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAOtC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAK3C,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBvC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AACjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC,MAAM,CAAC,CAAC;AACV,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/routes/poultry.routes.js

@@ -0,0 +1,195 @@
+import { initContract } from '@ts-rest/core';
+import { z } from 'zod';
+import { jsonApiErrorResponseSchema } from '../schemas/common.schemas';
+const c = initContract();
+export const poultryCommodityCategorySchema = z.enum(['output', 'input']);
+export const poultryMarketPriceSourceSchema = z.enum(['farm', 'platform', 'public']);
+export const poultryMarketLatestSchema = z.object({
+    pricePerUnit: z.number(),
+    unit: z.string(),
+    currency: z.string(),
+    observedAt: z.string().datetime(),
+    marketLabel: z.string().nullable(),
+    source: poultryMarketPriceSourceSchema,
+    farmCount: z.number().int().nonnegative().optional(),
+});
+export const poultryMarketCommoditySchema = z.object({
+    key: z.string(),
+    label: z.string(),
+    unit: z.string(),
+    category: poultryCommodityCategorySchema,
+    latest: poultryMarketLatestSchema.nullable(),
+});
+export const poultryFeedBridgeSchema = z.object({
+    maizePerKg: z.number().nullable(),
+    soyaPerKg: z.number().nullable(),
+    estimatedMashNgnPerTon: z.number().nullable(),
+    note: z.string(),
+});
+export const poultryMarketSnapshotSchema = z.object({
+    data: z.object({
+        commodities: z.array(poultryMarketCommoditySchema),
+        feedBridge: poultryFeedBridgeSchema,
+        sellRestockBrief: z.string(),
+        city: z.string().nullable().optional(),
+    }),
+});
+export const produceListingStatusSchema = z.enum(['DRAFT', 'PUBLISHED', 'CLOSED']);
+export const produceListingSchema = z.object({
+    id: z.string().uuid(),
+    farmId: z.string().uuid(),
+    productType: z.string(),
+    grade: z.string().nullable(),
+    quantity: z.number(),
+    unit: z.string(),
+    unitPrice: z.number(),
+    currency: z.string(),
+    availableFrom: z.string().datetime().nullable(),
+    availableTo: z.string().datetime().nullable(),
+    status: produceListingStatusSchema,
+    groupId: z.string().uuid().nullable(),
+    slug: z.string(),
+    notes: z.string().nullable(),
+    inquiryCount: z.number().int().nonnegative(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    publicPath: z.string().optional(),
+});
+export const produceListingWriteSchema = z.object({
+    productType: z.string().min(1).max(80),
+    grade: z.string().max(40).optional().nullable(),
+    quantity: z.number().positive(),
+    unit: z.string().min(1).max(20),
+    unitPrice: z.number().nonnegative(),
+    currency: z.string().length(3).optional(),
+    availableFrom: z.string().datetime().optional().nullable(),
+    availableTo: z.string().datetime().optional().nullable(),
+    groupId: z.string().uuid().optional().nullable(),
+    notes: z.string().max(2000).optional().nullable(),
+    status: produceListingStatusSchema.optional(),
+});
+export const produceListingUpdateSchema = produceListingWriteSchema.partial();
+export const poultryClimateReadingSchema = z.object({
+    value: z.number(),
+    unit: z.string(),
+    readAt: z.string().datetime(),
+    sensorId: z.string().uuid(),
+    sensorName: z.string(),
+    status: z.enum(['ok', 'warn', 'critical']),
+});
+export const poultryClimateHistoryPointSchema = z.object({
+    value: z.number(),
+    unit: z.string(),
+    readAt: z.string().datetime(),
+    sensorId: z.string().uuid(),
+});
+export const poultryClimateSnapshotSchema = z.object({
+    data: z.object({
+        groupId: z.string().uuid(),
+        temperature: poultryClimateReadingSchema.nullable(),
+        humidity: poultryClimateReadingSchema.nullable(),
+        thresholdStatus: z.enum(['ok', 'warn', 'critical', 'unknown']),
+        history: z.object({
+            temperature: z.array(poultryClimateHistoryPointSchema),
+            humidity: z.array(poultryClimateHistoryPointSchema),
+        }),
+        sensors: z.array(z.object({
+            id: z.string().uuid(),
+            name: z.string(),
+            type: z.string(),
+            status: z.string(),
+            lastReading: poultryClimateReadingSchema.nullable(),
+            lastSyncAt: z.string().datetime().nullable(),
+        })),
+    }),
+});
+export const poultryRouter = c.router({
+    getMarket: {
+        method: 'GET',
+        path: '/farms/:farmId/poultry/market',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+        }),
+        query: z.object({
+            city: z.string().max(80).optional(),
+        }),
+        responses: {
+            200: poultryMarketSnapshotSchema,
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Poultry market snapshot',
+        description: 'Cascade: farm latest → corroborated peer reports (≥3 farms) → public/platform seed. Includes feed bridge and sell/restock brief.',
+    },
+    getFlockClimate: {
+        method: 'GET',
+        path: '/farms/:farmId/poultry/flocks/:groupId/climate',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            groupId: z.string().uuid(),
+        }),
+        responses: {
+            200: poultryClimateSnapshotSchema,
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Poultry flock pen climate',
+        description: 'Last temperature/humidity readings and 24h history for sensors bound to the flock (groupId).',
+    },
+    listListings: {
+        method: 'GET',
+        path: '/farms/:farmId/poultry/listings',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        responses: {
+            200: z.object({ data: z.array(produceListingSchema) }),
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'List produce listings for a farm',
+    },
+    createListing: {
+        method: 'POST',
+        path: '/farms/:farmId/poultry/listings',
+        pathParams: z.object({ farmId: z.string().uuid() }),
+        body: produceListingWriteSchema,
+        responses: {
+            200: z.object({ data: produceListingSchema }),
+            201: z.object({ data: produceListingSchema }),
+            400: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Create a produce listing',
+    },
+    updateListing: {
+        method: 'PATCH',
+        path: '/farms/:farmId/poultry/listings/:listingId',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            listingId: z.string().uuid(),
+        }),
+        body: produceListingUpdateSchema,
+        responses: {
+            200: z.object({ data: produceListingSchema }),
+            400: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Update a produce listing',
+    },
+    publishListing: {
+        method: 'POST',
+        path: '/farms/:farmId/poultry/listings/:listingId/publish',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+            listingId: z.string().uuid(),
+        }),
+        body: z.object({}).optional(),
+        responses: {
+            200: z.object({ data: produceListingSchema }),
+            401: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Publish a produce listing (sets status + ensures slug)',
+    },
+});