@deepintel-ltd/farmpro-contracts 1.15.4 → 1.15.6

package/dist/schemas/commodity-deals.schemas.d.ts

@@ -36,7 +36,7 @@ export declare const commodityDealComputedSchema: z.ZodObject<{
     staffCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     companyNet: z.ZodNullable<z.ZodNumber>;
     netAfterStaff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    /** Total company keep (= fee + capital return) */
+    /** Total company net (= fee + capital return) */
     companyCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     companyFeeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     companyCapitalReturn: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -134,7 +134,7 @@ export declare const commodityDealAttributesSchema: z.ZodObject<{
         staffCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         companyNet: z.ZodNullable<z.ZodNumber>;
         netAfterStaff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        /** Total company keep (= fee + capital return) */
+        /** Total company net (= fee + capital return) */
         companyCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         companyFeeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         companyCapitalReturn: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -627,7 +627,7 @@ export declare const commodityDealResourceSchema: z.ZodObject<{
             staffCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             companyNet: z.ZodNullable<z.ZodNumber>;
             netAfterStaff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            /** Total company keep (= fee + capital return) */
+            /** Total company net (= fee + capital return) */
             companyCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             companyFeeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             companyCapitalReturn: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -943,7 +943,7 @@ export declare const commodityDealResponseSchema: z.ZodObject<{
                 staffCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyNet: z.ZodNullable<z.ZodNumber>;
                 netAfterStaff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-                /** Total company keep (= fee + capital return) */
+                /** Total company net (= fee + capital return) */
                 companyCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyFeeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyCapitalReturn: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1418,7 +1418,7 @@ export declare const commodityDealListResponseSchema: z.ZodObject<{
                 staffCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyNet: z.ZodNullable<z.ZodNumber>;
                 netAfterStaff: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-                /** Total company keep (= fee + capital return) */
+                /** Total company net (= fee + capital return) */
                 companyCommissionAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyFeeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                 companyCapitalReturn: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1968,6 +1968,717 @@ export declare const commodityDealSummaryResponseSchema: z.ZodObject<{
         totalInvestorPoolOnPaidDeals?: number | undefined;
     };
 }>;
+export declare const commodityDealInsightsPeriodSchema: z.ZodEnum<["this_month", "last_3_months", "ytd", "all"]>;
+export declare const commodityDealInsightsTotalsSchema: z.ZodObject<{
+    paidDealCount: z.ZodNumber;
+    paidRevenue: z.ZodNumber;
+    totalCost: z.ZodNumber;
+    grossProfit: z.ZodNumber;
+    /** Company net (fee + capital return). API key unchanged — not legacy margin companyNet. */
+    companyKeep: z.ZodNumber;
+    investorPool: z.ZodNumber;
+    staffCommission: z.ZodNumber;
+    /** Gross / revenue * 100 when revenue > 0; otherwise null. */
+    avgMarginPct: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalCost: number;
+    grossProfit: number;
+    investorPool: number;
+    paidDealCount: number;
+    paidRevenue: number;
+    companyKeep: number;
+    staffCommission: number;
+    avgMarginPct: number | null;
+}, {
+    totalCost: number;
+    grossProfit: number;
+    investorPool: number;
+    paidDealCount: number;
+    paidRevenue: number;
+    companyKeep: number;
+    staffCommission: number;
+    avgMarginPct: number | null;
+}>;
+export declare const commodityDealInsightsMonthlySchema: z.ZodObject<{
+    month: z.ZodString;
+    paidRevenue: z.ZodNumber;
+    /** Company net for the month. API key unchanged. */
+    companyKeep: z.ZodNumber;
+    grossProfit: z.ZodNumber;
+    dealCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    month: string;
+    grossProfit: number;
+    paidRevenue: number;
+    companyKeep: number;
+    dealCount: number;
+}, {
+    month: string;
+    grossProfit: number;
+    paidRevenue: number;
+    companyKeep: number;
+    dealCount: number;
+}>;
+export declare const commodityDealInsightsBuyerSchema: z.ZodObject<{
+    buyerId: z.ZodString;
+    buyerName: z.ZodString;
+    paidRevenue: z.ZodNumber;
+    /** Company net attributable to this buyer. API key unchanged. */
+    companyKeep: z.ZodNumber;
+    dealCount: z.ZodNumber;
+    marginPct: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    buyerName: string;
+    buyerId: string;
+    paidRevenue: number;
+    companyKeep: number;
+    dealCount: number;
+    marginPct: number | null;
+}, {
+    buyerName: string;
+    buyerId: string;
+    paidRevenue: number;
+    companyKeep: number;
+    dealCount: number;
+    marginPct: number | null;
+}>;
+export declare const commodityDealInsightsPipelineSchema: z.ZodObject<{
+    invoicedUnpaidCount: z.ZodNumber;
+    overdueCount: z.ZodNumber;
+    unrealizedGrossProfit: z.ZodNumber;
+    unpaidInvoiceTotal: z.ZodNumber;
+    overdueInvoiceTotal: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    invoicedUnpaidCount: number;
+    unrealizedGrossProfit: number;
+    overdueCount: number;
+    unpaidInvoiceTotal: number;
+    overdueInvoiceTotal: number;
+}, {
+    invoicedUnpaidCount: number;
+    unrealizedGrossProfit: number;
+    overdueCount: number;
+    unpaidInvoiceTotal: number;
+    overdueInvoiceTotal: number;
+}>;
+export declare const commodityDealInsightsSchema: z.ZodObject<{
+    period: z.ZodEnum<["this_month", "last_3_months", "ytd", "all"]>;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Non-cancelled deals in the org (for empty-state branching). */
+    totalDealCount: z.ZodNumber;
+    totals: z.ZodObject<{
+        paidDealCount: z.ZodNumber;
+        paidRevenue: z.ZodNumber;
+        totalCost: z.ZodNumber;
+        grossProfit: z.ZodNumber;
+        /** Company net (fee + capital return). API key unchanged — not legacy margin companyNet. */
+        companyKeep: z.ZodNumber;
+        investorPool: z.ZodNumber;
+        staffCommission: z.ZodNumber;
+        /** Gross / revenue * 100 when revenue > 0; otherwise null. */
+        avgMarginPct: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    }, {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    }>;
+    prior: z.ZodNullable<z.ZodObject<{
+        paidDealCount: z.ZodNumber;
+        paidRevenue: z.ZodNumber;
+        totalCost: z.ZodNumber;
+        grossProfit: z.ZodNumber;
+        /** Company net (fee + capital return). API key unchanged — not legacy margin companyNet. */
+        companyKeep: z.ZodNumber;
+        investorPool: z.ZodNumber;
+        staffCommission: z.ZodNumber;
+        /** Gross / revenue * 100 when revenue > 0; otherwise null. */
+        avgMarginPct: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    }, {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    }>>;
+    monthly: z.ZodArray<z.ZodObject<{
+        month: z.ZodString;
+        paidRevenue: z.ZodNumber;
+        /** Company net for the month. API key unchanged. */
+        companyKeep: z.ZodNumber;
+        grossProfit: z.ZodNumber;
+        dealCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        month: string;
+        grossProfit: number;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+    }, {
+        month: string;
+        grossProfit: number;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+    }>, "many">;
+    profitSplit: z.ZodObject<{
+        /** Company net (fee + capital return). API key unchanged. */
+        companyKeep: z.ZodNumber;
+        investorPool: z.ZodNumber;
+        staffCommission: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        investorPool: number;
+        companyKeep: number;
+        staffCommission: number;
+    }, {
+        investorPool: number;
+        companyKeep: number;
+        staffCommission: number;
+    }>;
+    byBuyer: z.ZodArray<z.ZodObject<{
+        buyerId: z.ZodString;
+        buyerName: z.ZodString;
+        paidRevenue: z.ZodNumber;
+        /** Company net attributable to this buyer. API key unchanged. */
+        companyKeep: z.ZodNumber;
+        dealCount: z.ZodNumber;
+        marginPct: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        buyerName: string;
+        buyerId: string;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+        marginPct: number | null;
+    }, {
+        buyerName: string;
+        buyerId: string;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+        marginPct: number | null;
+    }>, "many">;
+    /** Current open pipeline — not filtered by `period`. */
+    pipeline: z.ZodObject<{
+        invoicedUnpaidCount: z.ZodNumber;
+        overdueCount: z.ZodNumber;
+        unrealizedGrossProfit: z.ZodNumber;
+        unpaidInvoiceTotal: z.ZodNumber;
+        overdueInvoiceTotal: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        invoicedUnpaidCount: number;
+        unrealizedGrossProfit: number;
+        overdueCount: number;
+        unpaidInvoiceTotal: number;
+        overdueInvoiceTotal: number;
+    }, {
+        invoicedUnpaidCount: number;
+        unrealizedGrossProfit: number;
+        overdueCount: number;
+        unpaidInvoiceTotal: number;
+        overdueInvoiceTotal: number;
+    }>;
+    /** Accrued staff commission on paid deals still unpaid to staff (current, not period-filtered). */
+    staffCommissionUnpaid: z.ZodNumber;
+    /** Derived the same way as summary: org rate > 0 or paid deals accrued commission. */
+    staffCommissionsEnabled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    monthly: {
+        month: string;
+        grossProfit: number;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+    }[];
+    period: "all" | "this_month" | "last_3_months" | "ytd";
+    staffCommissionsEnabled: boolean;
+    totalDealCount: number;
+    totals: {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    };
+    prior: {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    } | null;
+    profitSplit: {
+        investorPool: number;
+        companyKeep: number;
+        staffCommission: number;
+    };
+    byBuyer: {
+        buyerName: string;
+        buyerId: string;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+        marginPct: number | null;
+    }[];
+    pipeline: {
+        invoicedUnpaidCount: number;
+        unrealizedGrossProfit: number;
+        overdueCount: number;
+        unpaidInvoiceTotal: number;
+        overdueInvoiceTotal: number;
+    };
+    staffCommissionUnpaid: number;
+}, {
+    monthly: {
+        month: string;
+        grossProfit: number;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+    }[];
+    period: "all" | "this_month" | "last_3_months" | "ytd";
+    staffCommissionsEnabled: boolean;
+    totalDealCount: number;
+    totals: {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    };
+    prior: {
+        totalCost: number;
+        grossProfit: number;
+        investorPool: number;
+        paidDealCount: number;
+        paidRevenue: number;
+        companyKeep: number;
+        staffCommission: number;
+        avgMarginPct: number | null;
+    } | null;
+    profitSplit: {
+        investorPool: number;
+        companyKeep: number;
+        staffCommission: number;
+    };
+    byBuyer: {
+        buyerName: string;
+        buyerId: string;
+        paidRevenue: number;
+        companyKeep: number;
+        dealCount: number;
+        marginPct: number | null;
+    }[];
+    pipeline: {
+        invoicedUnpaidCount: number;
+        unrealizedGrossProfit: number;
+        overdueCount: number;
+        unpaidInvoiceTotal: number;
+        overdueInvoiceTotal: number;
+    };
+    staffCommissionUnpaid: number;
+    currency?: string | undefined;
+}>;
+export declare const commodityDealInsightsResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        period: z.ZodEnum<["this_month", "last_3_months", "ytd", "all"]>;
+        currency: z.ZodDefault<z.ZodString>;
+        /** Non-cancelled deals in the org (for empty-state branching). */
+        totalDealCount: z.ZodNumber;
+        totals: z.ZodObject<{
+            paidDealCount: z.ZodNumber;
+            paidRevenue: z.ZodNumber;
+            totalCost: z.ZodNumber;
+            grossProfit: z.ZodNumber;
+            /** Company net (fee + capital return). API key unchanged — not legacy margin companyNet. */
+            companyKeep: z.ZodNumber;
+            investorPool: z.ZodNumber;
+            staffCommission: z.ZodNumber;
+            /** Gross / revenue * 100 when revenue > 0; otherwise null. */
+            avgMarginPct: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        }, {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        }>;
+        prior: z.ZodNullable<z.ZodObject<{
+            paidDealCount: z.ZodNumber;
+            paidRevenue: z.ZodNumber;
+            totalCost: z.ZodNumber;
+            grossProfit: z.ZodNumber;
+            /** Company net (fee + capital return). API key unchanged — not legacy margin companyNet. */
+            companyKeep: z.ZodNumber;
+            investorPool: z.ZodNumber;
+            staffCommission: z.ZodNumber;
+            /** Gross / revenue * 100 when revenue > 0; otherwise null. */
+            avgMarginPct: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        }, {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        }>>;
+        monthly: z.ZodArray<z.ZodObject<{
+            month: z.ZodString;
+            paidRevenue: z.ZodNumber;
+            /** Company net for the month. API key unchanged. */
+            companyKeep: z.ZodNumber;
+            grossProfit: z.ZodNumber;
+            dealCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }, {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }>, "many">;
+        profitSplit: z.ZodObject<{
+            /** Company net (fee + capital return). API key unchanged. */
+            companyKeep: z.ZodNumber;
+            investorPool: z.ZodNumber;
+            staffCommission: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        }, {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        }>;
+        byBuyer: z.ZodArray<z.ZodObject<{
+            buyerId: z.ZodString;
+            buyerName: z.ZodString;
+            paidRevenue: z.ZodNumber;
+            /** Company net attributable to this buyer. API key unchanged. */
+            companyKeep: z.ZodNumber;
+            dealCount: z.ZodNumber;
+            marginPct: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }, {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }>, "many">;
+        /** Current open pipeline — not filtered by `period`. */
+        pipeline: z.ZodObject<{
+            invoicedUnpaidCount: z.ZodNumber;
+            overdueCount: z.ZodNumber;
+            unrealizedGrossProfit: z.ZodNumber;
+            unpaidInvoiceTotal: z.ZodNumber;
+            overdueInvoiceTotal: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        }, {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        }>;
+        /** Accrued staff commission on paid deals still unpaid to staff (current, not period-filtered). */
+        staffCommissionUnpaid: z.ZodNumber;
+        /** Derived the same way as summary: org rate > 0 or paid deals accrued commission. */
+        staffCommissionsEnabled: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        monthly: {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }[];
+        period: "all" | "this_month" | "last_3_months" | "ytd";
+        staffCommissionsEnabled: boolean;
+        totalDealCount: number;
+        totals: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        };
+        prior: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        } | null;
+        profitSplit: {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        };
+        byBuyer: {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }[];
+        pipeline: {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        };
+        staffCommissionUnpaid: number;
+    }, {
+        monthly: {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }[];
+        period: "all" | "this_month" | "last_3_months" | "ytd";
+        staffCommissionsEnabled: boolean;
+        totalDealCount: number;
+        totals: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        };
+        prior: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        } | null;
+        profitSplit: {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        };
+        byBuyer: {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }[];
+        pipeline: {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        };
+        staffCommissionUnpaid: number;
+        currency?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        currency: string;
+        monthly: {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }[];
+        period: "all" | "this_month" | "last_3_months" | "ytd";
+        staffCommissionsEnabled: boolean;
+        totalDealCount: number;
+        totals: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        };
+        prior: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        } | null;
+        profitSplit: {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        };
+        byBuyer: {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }[];
+        pipeline: {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        };
+        staffCommissionUnpaid: number;
+    };
+}, {
+    data: {
+        monthly: {
+            month: string;
+            grossProfit: number;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+        }[];
+        period: "all" | "this_month" | "last_3_months" | "ytd";
+        staffCommissionsEnabled: boolean;
+        totalDealCount: number;
+        totals: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        };
+        prior: {
+            totalCost: number;
+            grossProfit: number;
+            investorPool: number;
+            paidDealCount: number;
+            paidRevenue: number;
+            companyKeep: number;
+            staffCommission: number;
+            avgMarginPct: number | null;
+        } | null;
+        profitSplit: {
+            investorPool: number;
+            companyKeep: number;
+            staffCommission: number;
+        };
+        byBuyer: {
+            buyerName: string;
+            buyerId: string;
+            paidRevenue: number;
+            companyKeep: number;
+            dealCount: number;
+            marginPct: number | null;
+        }[];
+        pipeline: {
+            invoicedUnpaidCount: number;
+            unrealizedGrossProfit: number;
+            overdueCount: number;
+            unpaidInvoiceTotal: number;
+            overdueInvoiceTotal: number;
+        };
+        staffCommissionUnpaid: number;
+        currency?: string | undefined;
+    };
+}>;
 export declare const myEarningsAttributesSchema: z.ZodObject<{
     realizedEarnings: z.ZodNumber;
     projectedEarnings: z.ZodNumber;
@@ -1976,15 +2687,15 @@ export declare const myEarningsAttributesSchema: z.ZodObject<{
     currency: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     currency: string;
+    dealCount: number;
     realizedEarnings: number;
     projectedEarnings: number;
     capitalDeployed: number;
-    dealCount: number;
 }, {
+    dealCount: number;
     realizedEarnings: number;
     projectedEarnings: number;
     capitalDeployed: number;
-    dealCount: number;
     currency?: string | undefined;
 }>;
 export declare const myEarningsResponseSchema: z.ZodObject<{
@@ -1999,15 +2710,15 @@ export declare const myEarningsResponseSchema: z.ZodObject<{
             currency: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             currency: string;
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
         }, {
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
             currency?: string | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
@@ -2015,19 +2726,19 @@ export declare const myEarningsResponseSchema: z.ZodObject<{
         id: string;
         attributes: {
             currency: string;
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
         };
     }, {
         type: "investor-earnings";
         id: string;
         attributes: {
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
             currency?: string | undefined;
         };
     }>;
@@ -2037,10 +2748,10 @@ export declare const myEarningsResponseSchema: z.ZodObject<{
         id: string;
         attributes: {
             currency: string;
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
         };
     };
 }, {
@@ -2048,10 +2759,10 @@ export declare const myEarningsResponseSchema: z.ZodObject<{
         type: "investor-earnings";
         id: string;
         attributes: {
+            dealCount: number;
             realizedEarnings: number;
             projectedEarnings: number;
             capitalDeployed: number;
-            dealCount: number;
             currency?: string | undefined;
         };
     };
@@ -2068,6 +2779,10 @@ export type CommodityDealResponse = z.infer<typeof commodityDealResponseSchema>;
 export type CommodityDealListResponse = z.infer<typeof commodityDealListResponseSchema>;
 export type CommodityDealSummary = z.infer<typeof commodityDealSummarySchema>;
 export type CommodityDealSummaryResponse = z.infer<typeof commodityDealSummaryResponseSchema>;
+export type CommodityDealInsightsPeriod = z.infer<typeof commodityDealInsightsPeriodSchema>;
+export type CommodityDealInsightsTotals = z.infer<typeof commodityDealInsightsTotalsSchema>;
+export type CommodityDealInsights = z.infer<typeof commodityDealInsightsSchema>;
+export type CommodityDealInsightsResponse = z.infer<typeof commodityDealInsightsResponseSchema>;
 export type CreateDealParticipantInput = z.infer<typeof createDealParticipantSchema>;
 export type UpdateDealParticipantInput = z.infer<typeof updateDealParticipantSchema>;
 export type MyEarningsResponse = z.infer<typeof myEarningsResponseSchema>;