@dalmore/api-contracts 1.0.2 → 1.0.5

package/common/types/queue.types.ts

@@ -1,111 +0,0 @@
-import { typeid } from 'typeid-js';
-
-export enum QueueFrequency {
-  SUPER_HIGH_FREQUENCY = 'SUPER_HIGH_FREQUENCY',
-  HIGH_FREQUENCY = 'HIGH_FREQUENCY',
-  MEDIUM_FREQUENCY = 'MEDIUM_FREQUENCY',
-  LOW_FREQUENCY = 'LOW_FREQUENCY',
-}
-
-interface QueueOptionsConfig {
-  removeOnComplete: number;
-  removeOnFail: number;
-  attempts: number;
-  backoff: {
-    type: 'exponential' | 'fixed';
-    delay: number;
-  };
-}
-
-const FREQUENCY_CONFIGS: Record<QueueFrequency, QueueOptionsConfig> = {
-  [QueueFrequency.SUPER_HIGH_FREQUENCY]: {
-    removeOnComplete: 50,
-    removeOnFail: 25,
-    attempts: 1,
-    backoff: {
-      type: 'fixed',
-      delay: 500,
-    },
-  },
-  [QueueFrequency.HIGH_FREQUENCY]: {
-    removeOnComplete: 50,
-    removeOnFail: 25,
-    attempts: 2,
-    backoff: {
-      type: 'fixed',
-      delay: 1000,
-    },
-  },
-  [QueueFrequency.MEDIUM_FREQUENCY]: {
-    removeOnComplete: 75,
-    removeOnFail: 35,
-    attempts: 3,
-    backoff: {
-      type: 'exponential',
-      delay: 1500,
-    },
-  },
-  [QueueFrequency.LOW_FREQUENCY]: {
-    removeOnComplete: 100,
-    removeOnFail: 50,
-    attempts: 3,
-    backoff: {
-      type: 'exponential',
-      delay: 2000,
-    },
-  },
-};
-
-/**
- * Creates standardized BullMQ job options based on frequency and job ID
- * @param jobId - Unique identifier for the job (for deduplication)
- * @param frequency - Queue frequency level (defaults to LOW_FREQUENCY)
- * @param customOptions - Optional custom options to override defaults
- * @returns JobsOptions for BullMQ
- */
-export function createQueueJobOptions(
-  jobId?: string,
-  frequency: QueueFrequency = QueueFrequency.LOW_FREQUENCY,
-  customOptions?: Partial<JobsOptions>,
-): JobsOptions {
-  const config = FREQUENCY_CONFIGS[frequency];
-  const finalJobId = jobId || typeid('job').toString();
-
-  return {
-    jobId: finalJobId,
-    removeOnComplete: config.removeOnComplete,
-    removeOnFail: config.removeOnFail,
-    attempts: config.attempts,
-    backoff: config.backoff,
-    ...customOptions,
-  };
-}
-
-/**
- * Convenience functions for each frequency level
- */
-export const createSuperHighFrequencyJobOptions = (
-  jobId?: string,
-  customOptions?: Partial<JobsOptions>,
-) =>
-  createQueueJobOptions(
-    jobId,
-    QueueFrequency.SUPER_HIGH_FREQUENCY,
-    customOptions,
-  );
-
-export const createHighFrequencyJobOptions = (
-  jobId?: string,
-  customOptions?: Partial<JobsOptions>,
-) => createQueueJobOptions(jobId, QueueFrequency.HIGH_FREQUENCY, customOptions);
-
-export const createMediumFrequencyJobOptions = (
-  jobId?: string,
-  customOptions?: Partial<JobsOptions>,
-) =>
-  createQueueJobOptions(jobId, QueueFrequency.MEDIUM_FREQUENCY, customOptions);
-
-export const createLowFrequencyJobOptions = (
-  jobId?: string,
-  customOptions?: Partial<JobsOptions>,
-) => createQueueJobOptions(jobId, QueueFrequency.LOW_FREQUENCY, customOptions);

package/common/types/registered-reps.types.ts

@@ -1,25 +0,0 @@
-import { z } from 'zod';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { TypeID } from 'typeid-js';
-
-extendZodWithOpenApi(z);
-
-export enum CommissionRateType {
-  FIXED = 'FIXED',
-  PERCENTAGE = 'PERCENTAGE',
-}
-
-export const registeredRepIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'registered_rep';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid registered rep ID format. Must be a valid TypeID with "registered_rep" prefix. Example: registered_rep_01j5y5ghx8fvc83dmx3pznq7hv',
-  },
-);

package/common/types/rejection-reasons.types.ts

@@ -1,56 +0,0 @@
-import { IBaseEntity } from './entity.types';
-
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-
-export const RejectionReasons = {
-  KYC: [
-    'ID document is expired',
-    'ID photo is blurry or unclear',
-    'ID does not match applicant’s name',
-    'Document type not accepted',
-    'Incomplete or missing ID submission',
-  ],
-  AML: [
-    'Missing supporting financial documents',
-    'Income documentation not sufficient',
-    'CPA/Attorney letter is outdated or unsigned',
-    'Documents do not meet accreditation criteria',
-  ],
-  AIC: [
-    'Individual appears on a sanctions list',
-    'Match found in politically exposed persons (PEP) database',
-    'Potential adverse media found',
-    'High-risk jurisdiction flagged',
-    'Name match flagged – additional verification required',
-  ],
-  SUB_DOC: [
-    'Signature missing or incorrect',
-    'Incomplete or incorrectly filled document',
-    'Document version is outdated',
-    'Not all pages were submitted',
-    'Mismatch in investment amount',
-  ],
-};
-
-export const rejectionReasonIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'rejection_reason';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid rejection reason ID format. Must be a valid TypeID with "rejection_reason" prefix.',
-  },
-);
-
-export const RejectionReasonZod = IBaseEntity.extend({
-  id: z.string(),
-  reason: z.string(),
-  target: z.string(),
-});
-export type RejectionReasonZod = z.infer<typeof RejectionReasonZod>;

package/common/types/review.types.ts

@@ -1,133 +0,0 @@
-import { z } from 'zod';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import {
-  AicStatus,
-  AMLStatus,
-  BaseStatus,
-  KYCStatus,
-  IPaginationMeta,
-} from './common.types';
-import { accountIdSchema } from './account.types';
-import { individualIdSchema } from './individuals.types';
-extendZodWithOpenApi(z);
-
-export const AccountStats = z.object({
-  account: z.object({
-    id: accountIdSchema,
-    name: z.string(),
-    active: z.boolean(),
-    dba: z.string().nullable(),
-  }),
-  needsReview: z.number(),
-  pending: z.number(),
-  approved: z.number(),
-  rejected: z.number(),
-  manualReview: z.number(),
-});
-export type AccountStats = z.infer<typeof AccountStats>;
-
-export const PendingReviewStats = z.object({
-  account: z.object({
-    id: z.string(),
-    name: z.string(),
-  }),
-  needsReview: z.number(),
-  pending: z.number(),
-  rejected: z.number(),
-  error: z.number(),
-  approved: z.number(),
-});
-export type PendingReviewStats = z.infer<typeof PendingReviewStats>;
-
-export const GetPendingReviewResponse = z.object({
-  items: z.array(PendingReviewStats),
-  meta: IPaginationMeta,
-});
-export type GetPendingReviewResponse = z.infer<typeof GetPendingReviewResponse>;
-
-export enum PendingReviewType {
-  PENDING_TRADES = 'PENDING_TRADES',
-  ALL = 'ALL',
-}
-
-export enum StatusType {
-  AML = 'aml',
-  KYC = 'kyc',
-  AIC = 'aic',
-}
-
-export const PendingReviewFilters = z.object({
-  type: z
-    .nativeEnum(PendingReviewType)
-    .optional()
-    .default(PendingReviewType.ALL),
-  statusType: z.nativeEnum(StatusType).optional().default(StatusType.KYC),
-});
-export type PendingReviewFilters = z.infer<typeof PendingReviewFilters>;
-
-export const GetReviewKycResponse = z.array(AccountStats);
-export type GetReviewKycResponse = z.infer<typeof GetReviewKycResponse>;
-
-export const GetReviewAmlResponse = z.array(AccountStats);
-export type GetReviewAmlResponse = z.infer<typeof GetReviewAmlResponse>;
-
-export const GetReviewAicResponse = z.array(AccountStats);
-export type GetReviewAicResponse = z.infer<typeof GetReviewAicResponse>;
-
-export const ReviewKycFilters = z.object({
-  accountId: accountIdSchema.optional(),
-  kycStatus: z.nativeEnum(KYCStatus).optional(),
-  needsReview: z
-    .string()
-    .optional()
-    .default('false')
-    .refine(
-      (v) => {
-        return v === 'true' || v === 'false';
-      },
-      {
-        message: 'needsReview must be a boolean string',
-      },
-    ),
-});
-export type ReviewKycFilters = z.infer<typeof ReviewKycFilters>;
-
-export const ReviewAmlFilters = z.object({
-  accountId: accountIdSchema.optional(),
-  amlStatus: z.nativeEnum(AMLStatus).optional(),
-  needsReview: z
-    .string()
-    .optional()
-    .default('false')
-    .refine((v) => v === 'true' || v === 'false', {
-      message: 'needsReview must be a boolean string',
-    }),
-});
-export type ReviewAmlFilters = z.infer<typeof ReviewAmlFilters>;
-
-export const ReviewAicFilters = z.object({
-  accountId: accountIdSchema.optional(),
-  aicStatus: z.nativeEnum(AicStatus).optional(),
-  needsReview: z
-    .string()
-    .optional()
-    .default('false')
-    .refine((v) => v === 'true' || v === 'false', {
-      message: 'needsReview must be a boolean string',
-    }),
-});
-export type ReviewAicFilters = z.infer<typeof ReviewAicFilters>;
-
-export const PostReviewBody = z.object({
-  individualIds: z.array(individualIdSchema).min(1).max(100),
-  status: z.nativeEnum(BaseStatus),
-});
-export type PostReviewBody = z.infer<typeof PostReviewBody>;
-
-export const PostReviewResponse = z.object({
-  individualsUpdated: z.array(accountIdSchema).min(1).max(100),
-  status: z.nativeEnum(BaseStatus),
-  reviewedBy: z.string(),
-  targetObject: z.any(),
-});
-export type PostReviewResponse = z.infer<typeof PostReviewResponse>;

package/common/types/role.types.ts

@@ -1,26 +0,0 @@
-import { z } from 'zod';
-import { PortalType, UserRole } from './common.types';
-import { IBaseEntity } from './entity.types';
-import { TypeID } from 'typeid-js';
-
-export const roleIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'role';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid role ID format. Must be a valid TypeID with "role" prefix.',
-  },
-);
-
-export const RoleZod = IBaseEntity.extend({
-  id: z.string(),
-  name: z.nativeEnum(UserRole),
-  type: z.nativeEnum(PortalType),
-});
-export type RoleZod = z.infer<typeof RoleZod>;

package/common/types/secondary-customer.types.ts

@@ -1,66 +0,0 @@
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-import {
-  ExchangeProvider,
-  IPaginationMeta,
-  PaginationOptionsZod,
-} from './common.types';
-import { IBaseEntity } from './entity.types';
-import { accountIdSchema } from './account.types';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { RawAccountData } from './exchange-provider.types';
-
-extendZodWithOpenApi(z);
-
-export const secondaryCustomerIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const id = TypeID.fromString(value);
-      return id.getType() === 'secondary_customer';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid secondary customer ID format. Must be a valid TypeID with "secondary_customer" prefix.',
-  },
-);
-
-export const SecondaryCustomer = IBaseEntity.extend({
-  accountId: accountIdSchema,
-  tid: z.string(),
-  provider: z.nativeEnum(ExchangeProvider).default(ExchangeProvider.PPEX),
-  rawAccountData: z.custom<RawAccountData>().nullable(),
-});
-export type SecondaryCustomer = z.infer<typeof SecondaryCustomer>;
-
-export const IPaginatedSecondaryCustomers = z.object({
-  items: z.array(SecondaryCustomer),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondaryCustomers = z.infer<
-  typeof IPaginatedSecondaryCustomers
->;
-
-export const SecondaryCustomerFiltersZod = z.object({
-  accountId: accountIdSchema.optional(),
-  search: z.string().max(50).optional(),
-  provider: z.nativeEnum(ExchangeProvider).optional(),
-  tid: z.string().max(50).optional(),
-});
-
-export const GetSecondaryCustomerFiltersZod = PaginationOptionsZod.merge(
-  SecondaryCustomerFiltersZod,
-);
-export type GetSecondaryCustomerFiltersZod = z.infer<
-  typeof GetSecondaryCustomerFiltersZod
->;
-
-export const ExportSecondaryCustomersResponse = z.object({
-  message: z.string(),
-});
-
-export type ExportSecondaryCustomersResponse = z.infer<
-  typeof ExportSecondaryCustomersResponse
->;

package/common/types/secondary-issuer.types.ts

@@ -1,50 +0,0 @@
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { IBaseEntity } from './entity.types';
-import { IPaginationMeta } from './common.types';
-import { SecondarySecurityZod } from './secondary-security.types';
-extendZodWithOpenApi(z);
-
-export const secondaryIssuerIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'secondary_issuer';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid secondary issuer id. Must be a valid id with "secondary_issuer" prefix.',
-  },
-);
-
-export const SecondaryIssuerZod = IBaseEntity.extend({
-  name: z.string(),
-  accountId: z.string().optional(),
-  securities: z.array(z.lazy(() => SecondarySecurityZod)),
-  ppexIssuerId: z.string().optional(),
-});
-export type SecondaryIssuerZod = z.infer<typeof SecondaryIssuerZod>;
-
-export const IPaginatedSecondaryIssuers = z.object({
-  items: z.array(SecondaryIssuerZod),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondaryIssuers = z.infer<
-  typeof IPaginatedSecondaryIssuers
->;
-
-export const CreateSecondaryIssuer = z.object({
-  name: z.string().max(250),
-  ppexIssuerId: z.string().max(250),
-});
-export type CreateSecondaryIssuer = z.infer<typeof CreateSecondaryIssuer>;
-
-export const UpdateSecondaryIssuer = z.object({
-  name: z.string().max(250).optional(),
-  ppexIssuerId: z.string().max(250).optional(),
-});
-export type UpdateSecondaryIssuer = z.infer<typeof UpdateSecondaryIssuer>;

package/common/types/secondary-order.types.ts

@@ -1,58 +0,0 @@
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-import { accountIdSchema } from './account.types';
-import {
-  DateField,
-  DateRangeFiltersZod,
-  ExchangeProvider,
-  IPaginationMeta,
-} from './common.types';
-import { IBaseEntity } from './entity.types';
-import { RawOrderData } from './exchange-provider.types';
-
-extendZodWithOpenApi(z);
-
-export const secondaryOrderIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'secondary_order';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid secondary order id. Must be a valid id with "secondary_order" prefix.',
-  },
-);
-
-export const SecondaryOrder = IBaseEntity.extend({
-  accountId: z.string(),
-  tid: z.string(),
-  provider: z.nativeEnum(ExchangeProvider),
-  rawOrderData: z.custom<RawOrderData>().nullable(),
-});
-export type SecondaryOrder = z.infer<typeof SecondaryOrder>;
-
-export const IPaginatedSecondaryOrders = z.object({
-  items: z.array(SecondaryOrder),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondaryOrders = z.infer<
-  typeof IPaginatedSecondaryOrders
->;
-
-export const SecondaryOrderFiltersZod = z.object({
-  accountId: accountIdSchema.optional(),
-  search: z.string().max(50).optional(),
-  provider: z.nativeEnum(ExchangeProvider).optional(),
-  tid: z.string().max(50).optional(),
-});
-
-export const SecondaryOrderDateRangeFiltersZod = DateRangeFiltersZod.extend({
-  dateField: z
-    .enum([DateField.CREATED_AT, DateField.RAW_ORDER_CREATED_DATE])
-    .optional(),
-});

package/common/types/secondary-security.types.ts

@@ -1,60 +0,0 @@
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { IBaseEntity } from './entity.types';
-import { IPaginationMeta } from './common.types';
-import { secondaryIssuerIdSchema } from './secondary-issuer.types';
-import { accountIdSchema } from './account.types';
-
-extendZodWithOpenApi(z);
-
-export const secondarySecurityIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'secondary_security';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid secondary security id. Must be a valid id with "secondary_security" prefix.',
-  },
-);
-
-export const SecondarySecurityZod = IBaseEntity.extend({
-  name: z.string(),
-  issuerId: z.lazy(() => secondaryIssuerIdSchema),
-  accountId: z.lazy(() => accountIdSchema),
-  ticker: z.string(),
-  ppexSecurityId: z.string(),
-});
-
-export type SecondarySecurityZod = z.infer<typeof SecondarySecurityZod>;
-
-export const IPaginatedSecondarySecurities = z.object({
-  items: z.array(SecondarySecurityZod),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondarySecurities = z.infer<
-  typeof IPaginatedSecondarySecurities
->;
-
-export const CreateSecondarySecurity = z.object({
-  name: z.string().min(1).max(255),
-  issuerId: z.lazy(() => secondaryIssuerIdSchema),
-  accountId: z.lazy(() => accountIdSchema),
-  ticker: z.string().min(1).max(255),
-  ppexSecurityId: z.string().min(1).max(255),
-});
-export type CreateSecondarySecurity = z.infer<typeof CreateSecondarySecurity>;
-
-export const UpdateSecondarySecurity = z.object({
-  name: z.string().min(1).max(255).optional(),
-  issuerId: z.lazy(() => secondaryIssuerIdSchema).optional(),
-  accountId: z.lazy(() => accountIdSchema).optional(),
-  ticker: z.string().min(1).max(255).optional(),
-  ppexSecurityId: z.string().min(1).max(255).optional(),
-});
-export type UpdateSecondarySecurity = z.infer<typeof UpdateSecondarySecurity>;

package/common/types/secondary-trade.entity.ts

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-import { BaseStatus } from './common.types';
-
-export enum PhoenixApprovalStatus {
-  APPROVED = BaseStatus.APPROVED,
-  PENDING = BaseStatus.PENDING,
-}
-
-export const PhoenixSecondaryTradePayloadZod = z.object({
-  investment_ids: z.string(),
-  approval_status: z.nativeEnum(PhoenixApprovalStatus),
-});
-
-export type PhoenixSecondaryTradePayload = z.infer<
-  typeof PhoenixSecondaryTradePayloadZod
->;

package/common/types/secondary-trade.types.ts

@@ -1,95 +0,0 @@
-import { TypeID } from 'typeid-js';
-import { z } from 'zod';
-import { extendZodWithOpenApi } from '@anatine/zod-openapi';
-import { IBaseEntity } from './entity.types';
-import {
-  ComplianceReview,
-  DateField,
-  DateRangeFiltersZod,
-  ExchangeProvider,
-} from './common.types';
-import { RawTradeData } from './exchange-provider.types';
-import { IPaginationMeta } from './common.types';
-import { accountIdSchema } from './account.types';
-extendZodWithOpenApi(z);
-
-export const secondaryTradeIdSchema = z.string().refine(
-  (value) => {
-    try {
-      const tid = TypeID.fromString(value);
-      return tid.getType() === 'secondary_trade';
-    } catch {
-      return false;
-    }
-  },
-  {
-    message:
-      'Invalid secondary trade id. Must be a valid id with "secondary_trade" prefix.',
-  },
-);
-
-export const SecondaryTradeZod = IBaseEntity.extend({
-  accountId: z.string(),
-  tid: z.string(),
-  provider: z.nativeEnum(ExchangeProvider),
-  complianceReview: z.nativeEnum(ComplianceReview),
-  complianceReviewNotes: z.string().nullable(),
-  complianceReviewerId: z.string().nullable(),
-  rawTradeData: z.custom<RawTradeData>().nullable(),
-});
-
-export type SecondaryTrade = z.infer<typeof SecondaryTradeZod>;
-
-export const IPaginatedSecondaryTrades = z.object({
-  items: z.array(SecondaryTradeZod),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondaryTrades = z.infer<
-  typeof IPaginatedSecondaryTrades
->;
-
-export const SecondaryTradeFiltersZod = z.object({
-  accountId: accountIdSchema.optional(),
-  search: z.string().max(50).optional(),
-  provider: z.nativeEnum(ExchangeProvider).optional(),
-  tid: z.string().max(50).optional(),
-  complianceReview: z.nativeEnum(ComplianceReview).optional(),
-});
-
-export type SecondaryTradeFiltersZod = z.infer<typeof SecondaryTradeFiltersZod>;
-export const ExportSecondaryTradesResponse = z.object({
-  message: z.string(),
-});
-
-export type ExportSecondaryTradesResponse = z.infer<
-  typeof ExportSecondaryTradesResponse
->;
-
-export const SecondaryTradeDateRangeFiltersZod = DateRangeFiltersZod.extend({
-  dateField: z
-    .enum([DateField.CREATED_AT, DateField.RAW_TRADE_CREATED_DATE])
-    .optional(),
-});
-
-export const SecondaryTradeSummaryZod = z.object({
-  accountId: accountIdSchema,
-  accountName: z.string(),
-  totalNeedsReviewCount: z.number().int(),
-  totalReadyToApproveCount: z.number().int(),
-});
-export type SecondaryTradeSummaryZod = z.infer<typeof SecondaryTradeSummaryZod>;
-
-export const IPaginatedSecondaryTradeSummaryResponse = z.object({
-  items: z.array(SecondaryTradeSummaryZod),
-  meta: IPaginationMeta,
-});
-export type IPaginatedSecondaryTradeSummaryResponse = z.infer<
-  typeof IPaginatedSecondaryTradeSummaryResponse
->;
-
-export const CountResultZod = z.array(
-  z.object({
-    count: z.string(),
-  }),
-);
-export type CountResultZod = z.infer<typeof CountResultZod>;