@deepintel-ltd/farmpro-contracts 1.11.12 → 1.14.0

package/dist/routes/market-intelligence.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market-intelligence.routes.d.ts","sourceRoot":"","sources":["../../src/routes/market-intelligence.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB3C,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBnC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC"}
+{"version":3,"file":"market-intelligence.routes.d.ts","sourceRoot":"","sources":["../../src/routes/market-intelligence.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,QAAA,MAAM,yBAAyB;;;;;;;;;;IAU7B;;;OAGG;;;IAGH,gEAAgE;;IAEhE,qFAAqF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErF,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAZ3C;;;WAGG;;;QAGH,gEAAgE;;QAEhE,qFAAqF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBrF,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;EAiBxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWlC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAlEnC;;;uBAGG;;;oBAGH,gEAAgE;;oBAEhE,qFAAqF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GrF,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/routes/market-intelligence.routes.js

@@ -7,6 +7,35 @@ const marketProjectionSchema = z.object({
     outlook: z.string(),
     details: z.string(),
 });
+const priceSourceSchema = z.enum([
+    'farm_recent',
+    'farm',
+    'farm_report',
+    'platform',
+    'public',
+    'none',
+]);
+const cropPriceProjectionSchema = z.object({
+    crop: z.string(),
+    unit: z.string(),
+    currency: z.string(),
+    farmAveragePrice: z.number().nullable(),
+    farmRecentAveragePrice: z.number().nullable(),
+    farmSaleCount: z.number().int().nonnegative(),
+    farmLastSaleDate: z.string().datetime().nullable(),
+    platformAveragePrice: z.number().nullable(),
+    platformFarmCount: z.number().int().nonnegative(),
+    /**
+     * Best estimate for planning:
+     * farm recent → farm all-time → farm report → platform (sales + corroborated reports) → public
+     */
+    projectedPrice: z.number().nullable(),
+    source: priceSourceSchema,
+    /** Farm avg vs platform avg (%); null if either side missing */
+    vsPlatformPercent: z.number().nullable(),
+    /** Sum of field area (ha) for this crop on the farm; null if unknown / sales-only */
+    areaHa: z.number().nullable().optional(),
+});
 export const marketIntelligenceOverviewSchema = z.object({
     farmId: z.string().uuid(),
     domesticSummary: z
@@ -24,9 +53,42 @@ export const marketIntelligenceOverviewSchema = z.object({
     })
         .nullable(),
     projections: z.array(marketProjectionSchema),
+    priceProjections: z.array(cropPriceProjectionSchema),
     eudrAlertTitle: z.string().nullable(),
     updatedAt: z.string().datetime(),
 });
+export const createMarketPriceReportSchema = z.object({
+    crop: z.string().min(1).max(100),
+    pricePerUnit: z.number().positive().max(10_000_000),
+    unit: z
+        .string()
+        .min(1)
+        .max(50)
+        .optional()
+        .transform((u) => {
+        const raw = (u || 'kg').trim().toLowerCase();
+        if (!raw)
+            return 'kg';
+        if (raw === 'kilogram' || raw === 'kilograms')
+            return 'kg';
+        return raw;
+    }),
+    currency: z.enum(['NGN', 'USD']).optional(),
+    observedAt: z.string().datetime().optional(),
+    marketLabel: z.string().max(80).optional().nullable(),
+});
+export const marketPriceReportSchema = z.object({
+    id: z.string().uuid(),
+    farmId: z.string().uuid(),
+    crop: z.string(),
+    cropKey: z.string(),
+    pricePerUnit: z.number(),
+    unit: z.string(),
+    currency: z.string(),
+    observedAt: z.string().datetime(),
+    marketLabel: z.string().nullable(),
+    createdAt: z.string().datetime(),
+});
 export const marketIntelligenceRouter = c.router({
     getOverview: {
         method: 'GET',
@@ -40,6 +102,40 @@ export const marketIntelligenceRouter = c.router({
             404: jsonApiErrorResponseSchema,
         },
         summary: 'Farm market intelligence overview',
-        description: 'National market summaries and crop projections for sell-window decisions',
+        description: 'National market summaries plus crop price projections: farm sales, farm reports, platform knowledge, then public reference',
+    },
+    createPriceReport: {
+        method: 'POST',
+        path: '/farms/:farmId/market-intelligence/price-reports',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+        }),
+        body: createMarketPriceReportSchema,
+        responses: {
+            201: marketPriceReportSchema,
+            400: jsonApiErrorResponseSchema,
+            401: jsonApiErrorResponseSchema,
+            403: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'Submit a market price report',
+        description: 'Record an overheard / local market price. Trusted immediately for this farm; shared only after corroboration.',
+    },
+    listPriceReports: {
+        method: 'GET',
+        path: '/farms/:farmId/market-intelligence/price-reports',
+        pathParams: z.object({
+            farmId: z.string().uuid(),
+        }),
+        query: z.object({
+            days: z.coerce.number().int().min(1).max(365).optional().default(90),
+        }),
+        responses: {
+            200: z.object({ data: z.array(marketPriceReportSchema) }),
+            401: jsonApiErrorResponseSchema,
+            403: jsonApiErrorResponseSchema,
+            404: jsonApiErrorResponseSchema,
+        },
+        summary: 'List recent market price reports for a farm',
     },
 });