refactor contract handling to support single route per contract and improve reference generation logic

apps/edr-freight-api/src/modules/contracts/contracts.service.ts

@@ -6,6 +6,7 @@ import {
 } from '@nestjs/common';
 import { InjectDataSource } from '@nestjs/typeorm';
 import { DataSource } from 'typeorm';
+import { insertWithGeneratedReference } from '@edr/api-common';
 
 import { CompaniesService } from '../companies/companies.service';
 import { CompanyProfile, ProfileType } from '../companies/entities/company-profile.entity';
@@ -217,6 +218,48 @@ export class ContractsService {
     return { contract: await this.findById(contract.id), warnings };
   }
 
+  /** Insert one DRAFT contract row with the given reference (no children). */
+  private insertContract(
+    reference: string,
+    ctx: {
+      companyId: string | null | undefined;
+      companyProfileId: string | null;
+      isGovernment: boolean;
+      includesCustoms: boolean;
+      dto: CreateContractDto;
+    },
+  ): Promise<Contract> {
+    const { companyId, companyProfileId, isGovernment, includesCustoms, dto } = ctx;
+    return this.contractsRepository.create({
+      reference,
+      companyId: companyId ?? null,
+      companyProfileId,
+      isGovernment,
+      governmentInstitution: isGovernment ? dto.governmentInstitution!.trim() : null,
+      contractKind: dto.contractKind,
+      renewalOfId: dto.renewalOfId ?? null,
+      tradeDirection: dto.tradeDirection,
+      freightType: dto.freightType,
+      serviceTypeId: dto.serviceTypeId,
+      paymentCurrency: dto.paymentCurrency,
+      customsClearingEnabled: includesCustoms,
+      customsClearingAgent: includesCustoms ? null : (dto.customsClearingAgent ?? null),
+      equipmentReturn: dto.equipmentReturn ?? null,
+      firstMilePickupAddress: dto.firstMilePickupAddress ?? null,
+      firstMilePickupLat: dto.firstMilePickupLat ?? null,
+      firstMilePickupLng: dto.firstMilePickupLng ?? null,
+      lastMileDeliveryAddress: dto.lastMileDeliveryAddress ?? null,
+      lastMileDeliveryLat: dto.lastMileDeliveryLat ?? null,
+      lastMileDeliveryLng: dto.lastMileDeliveryLng ?? null,
+      isHazardous: dto.isHazardous ?? false,
+      isReefer: dto.isReefer ?? false,
+      contractType: dto.contractType ?? null,
+      status: 'DRAFT',
+      clearanceStatus: 'NOT_APPLICABLE',
+      clearanceCycleNumber: 0,
+    } as never);
+  }
+
   /**
    * Copy a company profile's stored business-license / onboarding documents onto
    * a contract by reference (no byte re-upload). Codes are slugged from each