@dalmore/api-contracts 0.0.0-dev.f1cb508 → 0.0.0-dev.f48e7e9

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

@@ -1,7 +1,6 @@
 import { z } from 'zod';
-import { ComplianceReview, OfferingType, ManagedByType, SortOrder, SortBy, OfferingVersioningType, OfferingOnboardingStatus, AssetType, DurationType } from './common.types';
-import { OfferingStatus } from './issuer-offering.types';
-import { AssetTemplateType, InterestType } from './asset.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",
     PERCENTAGE = "PERCENTAGE"
@@ -27,6 +26,14 @@ export declare const OfferingPlatformSettings: z.ZodObject<{
 export type OfferingPlatformSettings = z.infer<typeof OfferingPlatformSettings>;
 export declare const IOffering: any;
 export type IOffering = z.infer<typeof IOffering>;
+export declare const QueueSoldOutOfferingsCheckResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+}, {
+    message: string;
+}>;
+export type QueueSoldOutOfferingsCheckResponse = z.infer<typeof QueueSoldOutOfferingsCheckResponseSchema>;
 export declare const IPaginatedOffering: z.ZodObject<{
     items: z.ZodArray<any, "many">;
     meta: z.ZodObject<{
@@ -68,9 +75,11 @@ export declare const IPaginatedOffering: z.ZodObject<{
     };
 }>;
 export type IPaginatedOffering = z.infer<typeof IPaginatedOffering>;
+export declare const OfferingDescriptionZod: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>, string | null | undefined, string | null | undefined>;
+export type OfferingDescriptionZod = z.infer<typeof OfferingDescriptionZod>;
 export declare const PatchOfferingBase: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>, string | null | undefined, string | null | undefined>;
     tid: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodNativeEnum<typeof OfferingType>>;
     targetAmount: z.ZodOptional<z.ZodNumber>;
@@ -113,6 +122,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 +145,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,13 +176,14 @@ 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;
 }>;
 export declare const PatchOffering: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>, string | null | undefined, string | null | undefined>;
     tid: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodNativeEnum<typeof OfferingType>>;
     targetAmount: z.ZodOptional<z.ZodNumber>;
@@ -214,6 +226,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,10 +238,7 @@ 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>;
-    principalAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    maxTotalRaise: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    interestType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof InterestType>>>;
     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>;
@@ -269,6 +279,13 @@ export declare const PatchOffering: z.ZodObject<{
     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;
@@ -296,6 +313,14 @@ export declare const PatchOffering: z.ZodObject<{
     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;
@@ -305,10 +330,7 @@ export declare const PatchOffering: z.ZodObject<{
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -350,6 +372,14 @@ export declare const PatchOffering: z.ZodObject<{
     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;
@@ -359,10 +389,7 @@ export declare const PatchOffering: z.ZodObject<{
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -374,9 +401,51 @@ export declare const PatchOffering: z.ZodObject<{
     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>>;
+    description: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>, string | null | undefined, string | null | undefined>;
     tid: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodNativeEnum<typeof OfferingType>>;
     targetAmount: z.ZodOptional<z.ZodNumber>;
@@ -416,11 +485,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>;
@@ -434,10 +503,7 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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>>>>;
-    principalAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    maxTotalRaise: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    interestType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof InterestType>>>;
     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>;
@@ -474,10 +540,19 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
         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;
@@ -505,15 +580,19 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -559,15 +638,20 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -581,6 +665,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;
@@ -608,15 +693,19 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -662,15 +751,20 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -682,7 +776,7 @@ export declare const PostComplianceOffering: z.ZodEffects<z.ZodObject<{
     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", "bankAccount", "escrowAccount"]>;
+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),
@@ -697,23 +791,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>;
@@ -725,32 +823,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<{
@@ -1177,7 +1275,7 @@ export declare const OfferingSettings: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
 export type OfferingSettings = z.infer<typeof OfferingSettings>;
 export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>, string | null | undefined, string | null | undefined>;
     tid: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodNativeEnum<typeof OfferingType>>;
     targetAmount: z.ZodOptional<z.ZodNumber>;
@@ -1220,6 +1318,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>>;
@@ -1231,10 +1330,7 @@ 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>;
-    principalAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    maxTotalRaise: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     interestRate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    interestType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof InterestType>>>;
     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>;
@@ -1275,6 +1371,13 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     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;
@@ -1302,6 +1405,14 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     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;
@@ -1311,10 +1422,7 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -1356,6 +1464,14 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     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;
@@ -1365,10 +1481,7 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -1636,6 +1749,14 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     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;
@@ -1645,10 +1766,7 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -1701,6 +1819,14 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     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;
@@ -1710,10 +1836,7 @@ export declare const PatchComplianceOffering: z.ZodEffects<z.ZodIntersection<z.Z
     durationType?: DurationType | null | undefined;
     tiers?: number[] | null | undefined;
     enableBonus?: boolean | undefined;
-    principalAmount?: number | null | undefined;
-    maxTotalRaise?: number | null | undefined;
     interestRate?: number | null | undefined;
-    interestType?: InterestType | null | undefined;
     bonusTiers?: {
         value: number;
         type: import("./bonus-tier.types").BonusType;
@@ -2457,6 +2580,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>;
@@ -2652,3 +2776,84 @@ export declare const EscrowValidationContextZod: z.ZodObject<{
     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;