@dalmore/api-contracts 0.0.0-dev.a9772b4 → 0.0.0-dev.abccaef

package/common/types/offering.types.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
-import { ComplianceReview, OfferingType, ManagedByType, SortOrder, SortBy, OfferingVersioningType, OfferingOnboardingStatus, AssetType, DurationType } from './common.types';
-import { OfferingStatus } from './issuer-offering.types';
+import { ComplianceReview, OfferingType, ManagedByType, SortOrder, SortBy, OfferingVersioningType, OfferingOnboardingStatus, AssetType, DurationType, WarrantSharesCalculationMethod } from './common.types';
 import { AssetTemplateType } from './asset.types';
 export declare enum OfferingFeeType {
     FIXED = "FIXED",
@@ -113,6 +112,7 @@ export declare const PatchOfferingBase: z.ZodObject<{
     cancellationPeriod: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
     showTotalRaised: z.ZodOptional<z.ZodBoolean>;
     issuerId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    shareClassId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
 }, "strip", z.ZodTypeAny, {
     platformSettings: string | null;
     type?: OfferingType | undefined;
@@ -135,6 +135,7 @@ export declare const PatchOfferingBase: z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    shareClassId?: string | null | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -165,6 +166,7 @@ export declare const PatchOfferingBase: z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    shareClassId?: string | null | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -214,6 +216,7 @@ export declare const PatchOffering: z.ZodObject<{
     cancellationPeriod: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
     showTotalRaised: z.ZodOptional<z.ZodBoolean>;
     issuerId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    shareClassId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
 } & {
     assetName: z.ZodOptional<z.ZodString>;
     assetType: z.ZodOptional<z.ZodNativeEnum<typeof AssetType>>;
@@ -225,6 +228,54 @@ export declare const PatchOffering: z.ZodObject<{
     template: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNativeEnum<typeof AssetTemplateType>>>>;
     tiers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber, "many">>>;
     enableBonus: z.ZodOptional<z.ZodBoolean>;
+    interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    bonusTiers: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        type: z.ZodNativeEnum<typeof import("./bonus-tier.types").BonusType>;
+        value: z.ZodEffects<z.ZodNumber, number, number>;
+        startAmount: z.ZodEffects<z.ZodNumber, number, number>;
+        endAmount: z.ZodEffects<z.ZodNumber, number, number>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, "many">>;
+    hasEscrow: z.ZodOptional<z.ZodBoolean>;
+    bankAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    escrowAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    escrowAgreementFileId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    warrantsEnabled: z.ZodOptional<z.ZodBoolean>;
+    totalShares: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    warrantTermYears: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    exercisePrice: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    warrantPercentage: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    calculationMethod: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof WarrantSharesCalculationMethod>>>;
+    incrementThreshold: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
 }, "strip", z.ZodTypeAny, {
     platformSettings: string | null;
     type?: OfferingType | undefined;
@@ -248,6 +299,18 @@ export declare const PatchOffering: z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -257,6 +320,13 @@ export declare const PatchOffering: z.ZodObject<{
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -288,6 +358,18 @@ export declare const PatchOffering: z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -297,11 +379,60 @@ export declare const PatchOffering: z.ZodObject<{
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
 }>;
 export type PatchOffering = z.infer<typeof PatchOffering>;
+/**
+ * Optional params for resolveAndValidateOfferingUpdateFields.
+ * All fields are optional and nullable; resolution merges with offering/asset values.
+ */
+export declare const ResolveOfferingUpdateFieldsParamsZod: z.ZodObject<{
+    minInvestment: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxInvestment: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    targetAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    pricePerUnit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    targetAmount?: number | null | undefined;
+    minInvestment?: number | null | undefined;
+    maxInvestment?: number | null | undefined;
+    pricePerUnit?: number | null | undefined;
+}, {
+    targetAmount?: number | null | undefined;
+    minInvestment?: number | null | undefined;
+    maxInvestment?: number | null | undefined;
+    pricePerUnit?: number | null | undefined;
+}>;
+export type ResolveOfferingUpdateFieldsParams = z.infer<typeof ResolveOfferingUpdateFieldsParamsZod>;
+/**
+ * Resolved, validated offering update fields (price per unit, target amount, min/max investment).
+ * Returned by resolveAndValidateOfferingUpdateFields and passed into validateBonusTiersForUpdate.
+ */
+export declare const ResolvedOfferingUpdateFieldsZod: z.ZodObject<{
+    pricePerUnit: z.ZodNumber;
+    targetAmount: z.ZodNumber;
+    minInvestment: z.ZodNullable<z.ZodNumber>;
+    maxInvestment: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    targetAmount: number;
+    minInvestment: number | null;
+    maxInvestment: number | null;
+    pricePerUnit: number;
+}, {
+    targetAmount: number;
+    minInvestment: number | null;
+    maxInvestment: number | null;
+    pricePerUnit: number;
+}>;
+export type ResolvedOfferingUpdateFields = z.infer<typeof ResolvedOfferingUpdateFieldsZod>;
 export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -344,11 +475,11 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     subscriptionAgreementId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
     jointSubscriptionAgreementTemplateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     cancellationPeriod: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-    showTotalRaised: z.ZodOptional<z.ZodBoolean>;
     issuerId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 } & {
     accountId: z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>;
     managedBy: z.ZodOptional<z.ZodNativeEnum<typeof ManagedByType>>;
+    shareClassId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
     assetName: z.ZodString;
     assetType: z.ZodNativeEnum<typeof AssetType>;
     pricePerUnit: z.ZodNullable<z.ZodNumber>;
@@ -359,10 +490,59 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     template: z.ZodDefault<z.ZodNativeEnum<typeof AssetTemplateType>>;
     tiers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber, "many">>>;
     enableBonus: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    hasEscrow: z.ZodOptional<z.ZodBoolean>;
+    bankAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    escrowAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    bonusTiers: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        type: z.ZodNativeEnum<typeof import("./bonus-tier.types").BonusType>;
+        value: z.ZodEffects<z.ZodNumber, number, number>;
+        startAmount: z.ZodEffects<z.ZodNumber, number, number>;
+        endAmount: z.ZodEffects<z.ZodNumber, number, number>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, "many">>;
+    warrantsEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    totalShares: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    warrantTermYears: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    exercisePrice: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    warrantPercentage: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    calculationMethod: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof WarrantSharesCalculationMethod>>>;
+    incrementThreshold: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    showTotalRaised: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     accountId: string;
     template: AssetTemplateType;
     platformSettings: string | null;
+    warrantsEnabled: boolean;
     assetName: string;
     assetType: AssetType;
     pricePerUnit: number | null;
@@ -387,11 +567,28 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     yield?: number | null | undefined;
     duration?: number | null | undefined;
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -428,11 +625,29 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     yield?: number | null | undefined;
     duration?: number | null | undefined;
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -440,6 +655,7 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     accountId: string;
     template: AssetTemplateType;
     platformSettings: string | null;
+    warrantsEnabled: boolean;
     assetName: string;
     assetType: AssetType;
     pricePerUnit: number | null;
@@ -464,11 +680,28 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     yield?: number | null | undefined;
     duration?: number | null | undefined;
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -505,17 +738,35 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     yield?: number | null | undefined;
     duration?: number | null | undefined;
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
 }>;
 export type PostComplianceOffering = z.infer<typeof PostComplianceOffering>;
-export declare const offeringsInclude: z.ZodEnum<["account", "issuer", "trades", "assets", "disbursements", "draftVersion", "publishedVersion", "revisions", "onboardingReviewedBy"]>;
+export declare const offeringsInclude: z.ZodEnum<["account", "issuer", "trades", "assets", "disbursements", "draftVersion", "publishedVersion", "revisions", "onboardingReviewedBy", "bankAccount", "escrowAccount", "shareClass"]>;
 /**
  * @description Query parameters for including related entities
  * @xample in contract us as -> query: z.object({}).merge(UsersIncludeQuery),
@@ -530,23 +781,27 @@ export declare const OfferingsIncludeQuery: z.ZodObject<{
 export interface OfferingsIncludeQuery extends z.infer<typeof OfferingsIncludeQuery> {
 }
 /**
- * @description
- * Filters for querying offerings.
+ * Filters supported for querying offerings.
  *
- * The "combinedStatus" filter provides a unified status that combines three separate fields:
- * - complianceReview: The compliance review status of the offering
- * - onboardingStatus: The onboarding completion status
- * - enabled: Whether the offering is currently enabled/active
+ * Available fields:
+ * - `issuerName`: (string, optional) Filter by name of the issuer.
+ * - `name`: (string, optional) Filter by offering name.
+ * - `accountId`: (AccountId, optional) Filter by tenant/account ID.
+ * - `issuerId`: (IssuerId, optional) Filter by issuer ID.
+ * - `type`: (OfferingType, optional) Filter by offering type.
+ * - `status`: (ComplianceReview, optional) Filter by compliance review status.
+ * - `enabled`: (boolean, optional) Filter for enabled/active offerings.
+ * - `managedBy`: (ManagedByType, optional) Filter by which system or user manages the offering.
+ * - `versioningType`: (OfferingVersioningType, optional) Filter by versioning strategy.
+ * - `onboardingStatus`: (OfferingOnboardingStatus, optional) Filter by issuer onboarding status.
  *
- * The combinedStatus is calculated using the following priority rules:
- * 1. If onboardingStatus is "IN_REVIEW" → combinedStatus = "ONBOARDING"
- * 2. Else if complianceReview is not "APPROVED" → combinedStatus = "IN_COMPLIANCE_REVIEW"
- * 3. Else if onboardingStatus is "COMPLETE" and complianceReview is "APPROVED" →
- *    - If enabled is true → combinedStatus = "ACTIVE"
- *    - If enabled is false → combinedStatus = "PAUSED"
+ * @remarks
+ * These filters can be combined to query offerings across multiple dimensions.
  *
- * This allows for filtering offerings by a single summary state that reflects the overall user-facing status,
- * rather than requiring separate filters for each individual field.
+ * Example use:
+ * ```ts
+ * { issuerName: "ABC Capital", type: OfferingType.REG_A }
+ * ```
  */
 export declare const OfferingFiltersZod: z.ZodObject<{
     issuerName: z.ZodOptional<z.ZodString>;
@@ -558,32 +813,32 @@ export declare const OfferingFiltersZod: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
     managedBy: z.ZodOptional<z.ZodNativeEnum<typeof ManagedByType>>;
     versioningType: z.ZodOptional<z.ZodNativeEnum<typeof OfferingVersioningType>>;
-    combinedStatus: z.ZodOptional<z.ZodNativeEnum<typeof OfferingStatus>>;
     onboardingStatus: z.ZodOptional<z.ZodNativeEnum<typeof OfferingOnboardingStatus>>;
+    complianceReview: z.ZodOptional<z.ZodNativeEnum<typeof ComplianceReview>>;
 }, "strip", z.ZodTypeAny, {
     type?: OfferingType | undefined;
     status?: ComplianceReview | undefined;
     accountId?: string | undefined;
     name?: string | undefined;
     managedBy?: ManagedByType | undefined;
+    complianceReview?: ComplianceReview | undefined;
     onboardingStatus?: OfferingOnboardingStatus | undefined;
     enabled?: boolean | undefined;
     issuerId?: string | undefined;
     issuerName?: string | undefined;
     versioningType?: OfferingVersioningType | undefined;
-    combinedStatus?: OfferingStatus | undefined;
 }, {
     type?: OfferingType | undefined;
     status?: ComplianceReview | undefined;
     accountId?: string | undefined;
     name?: string | undefined;
     managedBy?: ManagedByType | undefined;
+    complianceReview?: ComplianceReview | undefined;
     onboardingStatus?: OfferingOnboardingStatus | undefined;
     enabled?: unknown;
     issuerId?: string | undefined;
     issuerName?: string | undefined;
     versioningType?: OfferingVersioningType | undefined;
-    combinedStatus?: OfferingStatus | undefined;
 }>;
 export type OfferingFiltersZod = z.infer<typeof OfferingFiltersZod>;
 export declare const OfferingSortZod: z.ZodObject<{
@@ -1053,6 +1308,7 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     cancellationPeriod: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
     showTotalRaised: z.ZodOptional<z.ZodBoolean>;
     issuerId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    shareClassId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
 } & {
     assetName: z.ZodOptional<z.ZodString>;
     assetType: z.ZodOptional<z.ZodNativeEnum<typeof AssetType>>;
@@ -1064,6 +1320,54 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     template: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNativeEnum<typeof AssetTemplateType>>>>;
     tiers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber, "many">>>;
     enableBonus: z.ZodOptional<z.ZodBoolean>;
+    interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    bonusTiers: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        type: z.ZodNativeEnum<typeof import("./bonus-tier.types").BonusType>;
+        value: z.ZodEffects<z.ZodNumber, number, number>;
+        startAmount: z.ZodEffects<z.ZodNumber, number, number>;
+        endAmount: z.ZodEffects<z.ZodNumber, number, number>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }, {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }>, "many">>;
+    hasEscrow: z.ZodOptional<z.ZodBoolean>;
+    bankAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    escrowAccountId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    escrowAgreementFileId: z.ZodOptional<z.ZodNullable<z.ZodLazy<z.ZodEffects<z.ZodString, string, string>>>>;
+    warrantsEnabled: z.ZodOptional<z.ZodBoolean>;
+    totalShares: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    warrantTermYears: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    exercisePrice: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    warrantPercentage: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
+    calculationMethod: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof WarrantSharesCalculationMethod>>>;
+    incrementThreshold: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodNumber, number, number>>>;
 }, "strip", z.ZodTypeAny, {
     platformSettings: string | null;
     type?: OfferingType | undefined;
@@ -1087,6 +1391,18 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -1096,6 +1412,13 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -1127,6 +1450,18 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -1136,6 +1471,13 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -1393,6 +1735,18 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -1402,6 +1756,13 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -1444,6 +1805,18 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     memorandumId?: string | null | undefined;
     subscriptionAgreementId?: string | null | undefined;
     showTotalRaised?: boolean | undefined;
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    shareClassId?: string | null | undefined;
     assetName?: string | undefined;
     assetType?: AssetType | undefined;
     pricePerUnit?: number | null | undefined;
@@ -1453,6 +1826,13 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
+    interestRate?: number | null | undefined;
+    bonusTiers?: {
+        value: number;
+        type: import("./bonus-tier.types").BonusType;
+        startAmount: number;
+        endAmount: number;
+    }[] | undefined;
     entitySubscriptionAgreementTemplateId?: string | null | undefined;
     subscriptionAgreementTemplateId?: string | null | undefined;
     jointSubscriptionAgreementTemplateId?: string | null | undefined;
@@ -2190,6 +2570,7 @@ export type OfferingUpdateFields = {
     managedBy?: ManagedByType | null;
     showTotalRaised?: boolean;
     enabled?: boolean;
+    shareClassId?: string | null;
 };
 export declare const ReviewOfferingOnboarding: z.ZodObject<{
     onboardingStatus: z.ZodNativeEnum<typeof OfferingOnboardingStatus>;
@@ -2333,3 +2714,136 @@ export declare const IPaginatedOnboardingOfferingSummaryResponse: z.ZodObject<{
     };
 }>;
 export type IPaginatedOnboardingOfferingSummaryResponse = z.infer<typeof IPaginatedOnboardingOfferingSummaryResponse>;
+/**
+ * Maps asset types to fields that should be reset (nullified) when converting
+ * from one asset type to another. This ensures incompatible fields from the
+ * previous type are cleared when the asset type changes.
+ */
+export declare const ESCROW_ENABLED_OFFERING_FIELD_RESETS: Partial<IOffering>;
+/**
+ * Schema for escrow validation data input
+ */
+export declare const EscrowValidationDataZod: z.ZodObject<{
+    hasEscrow: z.ZodOptional<z.ZodBoolean>;
+    bankAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    escrowAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    escrowAgreementFileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+}, {
+    hasEscrow?: boolean | undefined;
+    escrowAgreementFileId?: string | null | undefined;
+    bankAccountId?: string | null | undefined;
+    escrowAccountId?: string | null | undefined;
+}>;
+export type EscrowValidationData = z.infer<typeof EscrowValidationDataZod>;
+/**
+ * Schema for escrow validation context
+ */
+export declare const EscrowValidationContextZod: z.ZodObject<{
+    accountId: z.ZodString;
+    issuerId: z.ZodString;
+    offeringId: z.ZodString;
+    currentBankAccountId: z.ZodNullable<z.ZodString>;
+    currentEscrowAccountId: z.ZodNullable<z.ZodString>;
+    currentEscrowAgreementFileId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    offeringId: string;
+    issuerId: string;
+    currentBankAccountId: string | null;
+    currentEscrowAccountId: string | null;
+    currentEscrowAgreementFileId: string | null;
+}, {
+    accountId: string;
+    offeringId: string;
+    issuerId: string;
+    currentBankAccountId: string | null;
+    currentEscrowAccountId: string | null;
+    currentEscrowAgreementFileId: string | null;
+}>;
+export type EscrowValidationContext = z.infer<typeof EscrowValidationContextZod>;
+/**
+ * Shape of warrant fields shared by Offering and OfferingRevision for validation.
+ */
+export declare const WarrantSharesBaseZod: z.ZodObject<{
+    warrantsEnabled: z.ZodBoolean;
+    totalShares: z.ZodNullable<z.ZodNumber>;
+    warrantTermYears: z.ZodNullable<z.ZodNumber>;
+    exercisePrice: z.ZodNullable<z.ZodNumber>;
+    warrantPercentage: z.ZodNullable<z.ZodNumber>;
+    calculationMethod: z.ZodNullable<z.ZodNativeEnum<typeof WarrantSharesCalculationMethod>>;
+    incrementThreshold: z.ZodNullable<z.ZodNumber>;
+    fullyDilutedShares: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    warrantsEnabled: boolean;
+    totalShares: number | null;
+    warrantTermYears: number | null;
+    exercisePrice: number | null;
+    warrantPercentage: number | null;
+    calculationMethod: WarrantSharesCalculationMethod | null;
+    incrementThreshold: number | null;
+    fullyDilutedShares: number | null;
+}, {
+    warrantsEnabled: boolean;
+    totalShares: number | null;
+    warrantTermYears: number | null;
+    exercisePrice: number | null;
+    warrantPercentage: number | null;
+    calculationMethod: WarrantSharesCalculationMethod | null;
+    incrementThreshold: number | null;
+    fullyDilutedShares: number | null;
+}>;
+export type WarrantSharesBase = z.infer<typeof WarrantSharesBaseZod>;
+/**
+ * All warrant field keys used when picking warrant data from base or patch.
+ */
+export declare const WARRANT_FIELD_KEYS: (keyof WarrantSharesBase)[];
+/**
+ * Warrant field keys required when enabling warrants (turning warrants on).
+ */
+export declare const WARRANT_REQUIRED_WHEN_ENABLED_KEYS: (keyof WarrantSharesBase)[];
+/**
+ * Patch input for warrant validation (optional warrant fields from PATCH body).
+ */
+export declare const WarrantValidationDataZod: z.ZodObject<{
+    warrantsEnabled: z.ZodOptional<z.ZodBoolean>;
+    totalShares: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    warrantTermYears: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    exercisePrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    warrantPercentage: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    calculationMethod: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof WarrantSharesCalculationMethod>>>;
+    incrementThreshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fullyDilutedShares: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    fullyDilutedShares?: number | null | undefined;
+}, {
+    warrantsEnabled?: boolean | undefined;
+    totalShares?: number | null | undefined;
+    warrantTermYears?: number | null | undefined;
+    exercisePrice?: number | null | undefined;
+    warrantPercentage?: number | null | undefined;
+    calculationMethod?: WarrantSharesCalculationMethod | null | undefined;
+    incrementThreshold?: number | null | undefined;
+    fullyDilutedShares?: number | null | undefined;
+}>;
+export type WarrantValidationData = z.infer<typeof WarrantValidationDataZod>;
+/**
+ * Validated warrant payload to persist on revision and offering.
+ */
+export type WarrantValidationResult = WarrantSharesBase;
+/**
+ * Warrant-related fields to reset (nullify) when warrants are disabled.
+ * Used when warrantsEnabled is set to false so revision and offering stay in sync.
+ */
+export declare const WARRANT_DISABLED_FIELD_RESETS: WarrantValidationResult;