@deepintel-ltd/farmpro-contracts 1.25.1 → 1.26.0

package/dist/schemas/trade-cash-events.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trade-cash-events.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/trade-cash-events.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trade-cash-events.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/trade-cash-events.schemas.ts"],"names":[],"mappings":"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"}

package/dist/schemas/trade-cash-events.schemas.js

@@ -6,6 +6,11 @@ export const tradeCashEventTypeSchema = z.enum([
     'commission_payout',
     'supplier_payment',
     'buyer_receipt',
+    'advance_disburse',
+    'advance_handoff',
+    'advance_settle',
+    'advance_return',
+    'advance_writeoff',
 ]);
 export const tradeCashPartyTypeSchema = z.enum([
     'investor',
@@ -14,6 +19,31 @@ export const tradeCashPartyTypeSchema = z.enum([
     'buyer',
     'broker',
     'other',
+    'company',
+]);
+export const tradeCashFunderTypeSchema = z.enum([
+    'company',
+    'staff',
+    'investor',
+    'unattributed',
+]);
+export const tradeSourcingAdvanceStatusSchema = z.enum([
+    'pending_receipt',
+    'open',
+    'settled',
+    'written_off',
+    'cancelled',
+]);
+export const tradeSourcingAdvanceHolderTypeSchema = z.enum([
+    'staff',
+    'supplier',
+    'other',
+]);
+export const advanceSettlementOutcomeSchema = z.enum([
+    'spent',
+    'returned',
+    'written_off',
+    'overspend',
 ]);
 export const tradeCashEventAttributesSchema = z
     .object({
@@ -30,6 +60,13 @@ export const tradeCashEventAttributesSchema = z
     dealId: z.string().uuid().nullable().optional(),
     invoiceId: z.string().uuid().nullable().optional(),
     notes: z.string().nullable().optional(),
+    funderType: tradeCashFunderTypeSchema.optional().default('unattributed'),
+    funderId: z.string().max(100).nullable().optional(),
+    funderName: z.string().max(200).nullable().optional(),
+    advanceId: z.string().uuid().nullable().optional(),
+    voidedAt: z.string().datetime().nullable().optional(),
+    voidedById: z.string().uuid().nullable().optional(),
+    voidReason: z.string().nullable().optional(),
 })
     .merge(timestampsSchema);
 export const createTradeCashEventAttributesSchema = z.object({
@@ -45,6 +82,14 @@ export const createTradeCashEventAttributesSchema = z.object({
     dealId: z.string().uuid().optional().nullable(),
     invoiceId: z.string().uuid().optional().nullable(),
     notes: z.string().optional().nullable(),
+    /** Required for supplier_payment and advance events; derived for capital_in/out. */
+    funderType: tradeCashFunderTypeSchema.optional(),
+    funderId: z.string().max(100).optional().nullable(),
+    funderName: z.string().max(200).optional().nullable(),
+    advanceId: z.string().uuid().optional().nullable(),
+});
+export const voidTradeCashEventAttributesSchema = z.object({
+    reason: z.string().min(1).max(500),
 });
 export const tradeCashEventResourceSchema = createJsonApiResourceSchema('trade-cash-events', tradeCashEventAttributesSchema);
 export const tradeCashEventResponseSchema = jsonApiSingleResponseSchema(tradeCashEventResourceSchema);
@@ -53,6 +98,10 @@ export const createTradeCashEventSchema = z.object({
     type: z.literal('trade-cash-events'),
     attributes: createTradeCashEventAttributesSchema,
 });
+export const voidTradeCashEventSchema = z.object({
+    type: z.literal('trade-cash-events'),
+    attributes: voidTradeCashEventAttributesSchema,
+});
 export const investorBalanceAttributesSchema = z.object({
     partyId: z.string(),
     partyName: z.string().nullable().optional(),
@@ -70,6 +119,65 @@ export const investorBalancesResponseSchema = z.object({
         }),
     }),
 });
+export const funderBreakdownSchema = z.object({
+    funderType: tradeCashFunderTypeSchema,
+    funderId: z.string().nullable().optional(),
+    funderName: z.string().nullable().optional(),
+    amount: z.number(),
+});
+export const advancePositionSchema = z.object({
+    advanceId: z.string().uuid(),
+    holderType: tradeSourcingAdvanceHolderTypeSchema,
+    holderId: z.string().nullable().optional(),
+    holderName: z.string(),
+    funderType: tradeCashFunderTypeSchema,
+    funderId: z.string().nullable().optional(),
+    funderName: z.string().nullable().optional(),
+    remaining: z.number(),
+    amount: z.number(),
+    status: tradeSourcingAdvanceStatusSchema,
+    openedAt: z.string().datetime(),
+    expectedSettleBy: z.string().datetime().nullable().optional(),
+    overdue: z.boolean(),
+    ageDays: z.number(),
+});
+export const tradeTreasuryAttributesSchema = z.object({
+    asOf: z.string().datetime(),
+    computedAt: z.string().datetime(),
+    currency: z.string().length(3),
+    received: z.number(),
+    returnedToFunders: z.number(),
+    available: z.number(),
+    inSourcing: z.number(),
+    unallocatedSpend: z.number(),
+    goodsNotDelivered: z.number(),
+    deliveredUnpaid: z.number(),
+    receivable: z.number(),
+    capitalOutstanding: z.number(),
+    buyerReceipts: z.number(),
+    /** received − returned vs available + capitalOutstanding */
+    reconciliation: z.object({
+        capitalBase: z.number(),
+        deployedAndHeld: z.number(),
+        profitLossAndCostsRetained: z.number(),
+    }),
+    byFunder: z.object({
+        received: z.array(funderBreakdownSchema),
+        returned: z.array(funderBreakdownSchema),
+        inSourcing: z.array(funderBreakdownSchema),
+        unallocatedSpend: z.array(funderBreakdownSchema),
+        goodsNotDelivered: z.array(funderBreakdownSchema),
+        deliveredUnpaid: z.array(funderBreakdownSchema),
+    }),
+    openAdvances: z.array(advancePositionSchema),
+});
+export const tradeTreasuryResponseSchema = z.object({
+    data: z.object({
+        type: z.literal('trade-treasury'),
+        id: z.string(),
+        attributes: tradeTreasuryAttributesSchema,
+    }),
+});
 export const tradeControlBoardResponseSchema = z.object({
     data: z.object({
         type: z.literal('trade-control-board'),
@@ -130,3 +238,99 @@ export const createInvoicePaymentSchema = z.object({
     type: z.literal('invoice-payments'),
     attributes: createInvoicePaymentAttributesSchema,
 });
+// ── Sourcing advances ────────────────────────────────────────────────────────
+export const tradeSourcingAdvanceAttributesSchema = z
+    .object({
+    organizationId: z.string().uuid(),
+    holderType: tradeSourcingAdvanceHolderTypeSchema,
+    holderId: z.string().max(100).nullable().optional(),
+    holderName: z.string().max(200),
+    funderType: tradeCashFunderTypeSchema,
+    funderId: z.string().max(100).nullable().optional(),
+    funderName: z.string().max(200).nullable().optional(),
+    parentAdvanceId: z.string().uuid().nullable().optional(),
+    amount: z.number().positive(),
+    remaining: z.number(),
+    currency: z.string().length(3).default('NGN'),
+    status: tradeSourcingAdvanceStatusSchema,
+    expectedSettleBy: z.string().datetime().nullable().optional(),
+    dealId: z.string().uuid().nullable().optional(),
+    purchaseOrderId: z.string().uuid().nullable().optional(),
+    purpose: z.string().max(500).nullable().optional(),
+    notes: z.string().nullable().optional(),
+    confirmedAt: z.string().datetime().nullable().optional(),
+    overdue: z.boolean().optional(),
+})
+    .merge(timestampsSchema);
+export const createSourcingAdvanceAttributesSchema = z.object({
+    holderType: tradeSourcingAdvanceHolderTypeSchema,
+    holderId: z.string().max(100).optional().nullable(),
+    holderName: z.string().min(1).max(200),
+    funderType: z.enum(['company', 'staff', 'investor']),
+    funderId: z.string().max(100).optional().nullable(),
+    funderName: z.string().max(200).optional().nullable(),
+    amount: z.number().positive(),
+    currency: z.string().length(3).optional().default('NGN'),
+    occurredAt: z.string().datetime(),
+    expectedSettleBy: z.string().datetime().optional().nullable(),
+    dealId: z.string().uuid().optional().nullable(),
+    purchaseOrderId: z.string().uuid().optional().nullable(),
+    purpose: z.string().max(500).optional().nullable(),
+    notes: z.string().optional().nullable(),
+    method: z.string().max(100).optional().nullable(),
+    reference: z.string().max(200).optional().nullable(),
+});
+export const handoffAdvanceAttributesSchema = z.object({
+    amount: z.number().positive(),
+    holderType: tradeSourcingAdvanceHolderTypeSchema,
+    holderId: z.string().max(100).optional().nullable(),
+    holderName: z.string().min(1).max(200),
+    occurredAt: z.string().datetime(),
+    notes: z.string().optional().nullable(),
+});
+export const advanceSettlementLineSchema = z.object({
+    outcome: advanceSettlementOutcomeSchema,
+    amount: z.number().positive(),
+    supplierName: z.string().max(200).optional().nullable(),
+    supplierId: z.string().max(100).optional().nullable(),
+    dealId: z.string().uuid().optional().nullable(),
+    purchaseOrderId: z.string().uuid().optional().nullable(),
+    proofRef: z.string().max(200).optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const submitAdvanceSettlementAttributesSchema = z.object({
+    lines: z.array(advanceSettlementLineSchema).min(1),
+    notes: z.string().optional().nullable(),
+});
+export const approveAdvanceSettlementAttributesSchema = z.object({
+    occurredAt: z.string().datetime(),
+    notes: z.string().optional().nullable(),
+});
+export const writeoffAdvanceAttributesSchema = z.object({
+    amount: z.number().positive(),
+    reason: z.string().min(1).max(500),
+    occurredAt: z.string().datetime(),
+});
+export const tradeSourcingAdvanceResourceSchema = createJsonApiResourceSchema('trade-sourcing-advances', tradeSourcingAdvanceAttributesSchema);
+export const tradeSourcingAdvanceResponseSchema = jsonApiSingleResponseSchema(tradeSourcingAdvanceResourceSchema);
+export const tradeSourcingAdvanceListResponseSchema = jsonApiCollectionResponseSchema(tradeSourcingAdvanceResourceSchema);
+export const createSourcingAdvanceSchema = z.object({
+    type: z.literal('trade-sourcing-advances'),
+    attributes: createSourcingAdvanceAttributesSchema,
+});
+export const handoffAdvanceSchema = z.object({
+    type: z.literal('trade-sourcing-advances'),
+    attributes: handoffAdvanceAttributesSchema,
+});
+export const submitAdvanceSettlementSchema = z.object({
+    type: z.literal('trade-sourcing-settlement-requests'),
+    attributes: submitAdvanceSettlementAttributesSchema,
+});
+export const approveAdvanceSettlementSchema = z.object({
+    type: z.literal('trade-sourcing-settlement-requests'),
+    attributes: approveAdvanceSettlementAttributesSchema,
+});
+export const writeoffAdvanceSchema = z.object({
+    type: z.literal('trade-sourcing-advances'),
+    attributes: writeoffAdvanceAttributesSchema,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepintel-ltd/farmpro-contracts",
-  "version": "1.25.1",
+  "version": "1.26.0",
   "description": "Type-safe API contracts for FarmPro API",
   "main": "dist/index.js",
   "module": "dist/index.js",