@dalmore/api-contracts 1.0.1 → 1.0.2

package/common/helpers/index.ts

@@ -10,6 +10,123 @@ import parsePhoneNumberFromString, {
 import { err, ok, Result } from 'neverthrow';
 import { ErrorResult } from '../types/common.types';
 
+/**
+ * Validates a US zip code format (12345 or 12345-6789)
+ */
+export const validateUSZipCode = (zipCode: string): boolean => {
+  const regex = /^[0-9]{5}(?:-[0-9]{4})?$/;
+  return regex.test(zipCode);
+};
+
+/**
+ * Validates a Canadian postal code format (A1A 1A1)
+ */
+export const validateCanadaZipCode = (zipCode: string): boolean => {
+  const regex = /^[A-Za-z]\d[A-Za-z] \d[A-Za-z]\d$/;
+  return regex.test(zipCode);
+};
+
+/**
+ * Normalizes a short date string (M/D/YY or M/D/YYYY) to MM/DD/YYYY format
+ */
+export function normalizeShortDate(input: string): string {
+  const [month, day, year] = input.split('/');
+
+  if (!month || !day || !year) {
+    throw new Error('Invalid date format');
+  }
+
+  const paddedMonth = month.padStart(2, '0');
+  const paddedDay = day.padStart(2, '0');
+  const fullYear = year.length === 2 ? `20${year}` : year;
+
+  return `${paddedMonth}/${paddedDay}/${fullYear}`;
+}
+
+/**
+ * Converts a string into a URL-safe slug
+ */
+export function slugify(input: string, exclude: boolean = false): string {
+  if (exclude) {
+    const excludeWords = ['llc', 'inc', 'corp', 'co'];
+    const negativeWordsList = [
+      'www',
+      'api',
+      'admin',
+      'dashboard',
+      'auth',
+      'cdn',
+      'static',
+      'blog',
+      'support',
+      'status',
+      'mail',
+      'smtp',
+      'ftp',
+      'ssh',
+      'login',
+      'register',
+      'signup',
+      'account',
+      'accounts',
+      'user',
+      'users',
+      'profile',
+      'settings',
+      'help',
+      'docs',
+      'documentation',
+      'developer',
+      'developers',
+      'app',
+      'apps',
+      'test',
+      'demo',
+      'staging',
+      'dev',
+      'prod',
+      'production',
+      'beta',
+      'alpha',
+      'portal',
+      'portals',
+      'client',
+      'clients',
+      'investor',
+      'investors',
+      'issuer',
+      'issuers',
+      'compliance',
+      'offering',
+      'offerings',
+      'trade',
+      'trades',
+    ];
+
+    let slug = input
+      .toLowerCase()
+      .replace(/[^\w\s-]/g, '')
+      .replace(/[\s_-]+/g, '-')
+      .replace(/^-+|-+$/g, '');
+
+    excludeWords.forEach((word) => {
+      slug = slug.replace(new RegExp(`-${word}$`, 'i'), '');
+    });
+
+    if (negativeWordsList.includes(slug)) {
+      return 'new-account';
+    }
+
+    return slug;
+  }
+
+  return input
+    .toLowerCase()
+    .replace(/[^\w\s-]/g, '')
+    .replace(/[\s_-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
 type CurlOptions = {
   query?: Record<string, string>;
   headers?: Record<string, string>;

package/common/types/batch-jobs.types.ts

@@ -5,7 +5,6 @@ import { dateSchema, IPaginationMeta, UserRole } from './common.types';
 import { userIdSchema } from './user.types';
 import { accountIdSchema } from './account.types';
 import { IBaseEntity } from './entity.types';
-import { JobsOptions } from 'bullmq';
 
 extendZodWithOpenApi(z);
 

package/common/types/common.types.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { TypeID } from 'typeid-js';
 import { ErrorHttpStatusCode } from '@ts-rest/core';
 import { TwoFactorMethod } from './sms.types';
-import { normalizeShortDate } from '../helpers';
+import { normalizeShortDate } from './contract-helpers';
 import { HttpStatus } from '@nestjs/common';
 
 extendZodWithOpenApi(z);

package/common/types/contract-helpers.ts

@@ -10,6 +10,123 @@ import parsePhoneNumberFromString, {
 import { err, ok, Result } from 'neverthrow';
 import { ErrorResult } from './common.types';
 
+/**
+ * Validates a US zip code format (12345 or 12345-6789)
+ */
+export const validateUSZipCode = (zipCode: string): boolean => {
+  const regex = /^[0-9]{5}(?:-[0-9]{4})?$/;
+  return regex.test(zipCode);
+};
+
+/**
+ * Validates a Canadian postal code format (A1A 1A1)
+ */
+export const validateCanadaZipCode = (zipCode: string): boolean => {
+  const regex = /^[A-Za-z]\d[A-Za-z] \d[A-Za-z]\d$/;
+  return regex.test(zipCode);
+};
+
+/**
+ * Normalizes a short date string (M/D/YY or M/D/YYYY) to MM/DD/YYYY format
+ */
+export function normalizeShortDate(input: string): string {
+  const [month, day, year] = input.split('/');
+
+  if (!month || !day || !year) {
+    throw new Error('Invalid date format');
+  }
+
+  const paddedMonth = month.padStart(2, '0');
+  const paddedDay = day.padStart(2, '0');
+  const fullYear = year.length === 2 ? `20${year}` : year;
+
+  return `${paddedMonth}/${paddedDay}/${fullYear}`;
+}
+
+/**
+ * Converts a string into a URL-safe slug
+ */
+export function slugify(input: string, exclude: boolean = false): string {
+  if (exclude) {
+    const excludeWords = ['llc', 'inc', 'corp', 'co'];
+    const negativeWordsList = [
+      'www',
+      'api',
+      'admin',
+      'dashboard',
+      'auth',
+      'cdn',
+      'static',
+      'blog',
+      'support',
+      'status',
+      'mail',
+      'smtp',
+      'ftp',
+      'ssh',
+      'login',
+      'register',
+      'signup',
+      'account',
+      'accounts',
+      'user',
+      'users',
+      'profile',
+      'settings',
+      'help',
+      'docs',
+      'documentation',
+      'developer',
+      'developers',
+      'app',
+      'apps',
+      'test',
+      'demo',
+      'staging',
+      'dev',
+      'prod',
+      'production',
+      'beta',
+      'alpha',
+      'portal',
+      'portals',
+      'client',
+      'clients',
+      'investor',
+      'investors',
+      'issuer',
+      'issuers',
+      'compliance',
+      'offering',
+      'offerings',
+      'trade',
+      'trades',
+    ];
+
+    let slug = input
+      .toLowerCase()
+      .replace(/[^\w\s-]/g, '')
+      .replace(/[\s_-]+/g, '-')
+      .replace(/^-+|-+$/g, '');
+
+    excludeWords.forEach((word) => {
+      slug = slug.replace(new RegExp(`-${word}$`, 'i'), '');
+    });
+
+    if (negativeWordsList.includes(slug)) {
+      return 'new-account';
+    }
+
+    return slug;
+  }
+
+  return input
+    .toLowerCase()
+    .replace(/[^\w\s-]/g, '')
+    .replace(/[\s_-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
 type CurlOptions = {
   query?: Record<string, string>;
   headers?: Record<string, string>;

package/common/types/page.types.ts

@@ -14,7 +14,7 @@ import {
   UrlSchema,
 } from './common.types';
 import { accountIdSchema } from './account.types';
-import { slugify } from '../helpers';
+import { slugify } from './contract-helpers';
 import { fileIdSchema } from './file.types';
 
 extendZodWithOpenApi(z);

package/common/types/queue.types.ts

@@ -1,4 +1,3 @@
-import { JobsOptions } from 'bullmq';
 import { typeid } from 'typeid-js';
 
 export enum QueueFrequency {

package/common/types/trade.types.ts

@@ -53,8 +53,10 @@ import {
   SecondaryTrade,
   SecondaryTradeFiltersZod,
 } from './secondary-trade.types';
-import { InvestorAccount } from '../../investor-accounts/entities/investor-account.entity';
-import { Trade } from '../../trades/entities/trade.entity';
+
+// Stub types for backend entities (not included in contracts package)
+type InvestorAccount = Record<string, unknown>;
+type Trade = Record<string, unknown>;
 
 extendZodWithOpenApi(z);
 export const CheckResultsSchema = z.object({

package/common/types/zip.type.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { validateCanadaZipCode, validateUSZipCode } from '../helpers';
+import { validateCanadaZipCode, validateUSZipCode } from './contract-helpers';
 import { CountryCode, CountryEnumSchema } from './countries.types';
 
 export function refineAddressZip(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalmore/api-contracts",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Type-safe API contracts for Dalmore Client Portal",
   "main": "./contracts/index.ts",
   "types": "./contracts/index.ts",

package/common/types/reminder-config.types.ts

@@ -1,40 +0,0 @@
-import { Job } from 'bullmq';
-import { QueryRunner } from 'typeorm';
-import { Site } from '../../sites/entities/site.entity';
-import { ProcessTradeCancellationReminderDto } from '../../workers/dto.worker';
-
-export enum ReminderType {
-  DAILY = 'daily',
-  CUMULATIVE = 'cumulative',
-  WARNING = 'warning',
-  CANCEL = 'cancel',
-  SKIP = 'skip', // for days with no action
-}
-
-export interface ReminderConfig {
-  day: number;
-  type: ReminderType;
-  daysLeft?: number; // for warning type
-  createTask?: boolean; // for daily type
-  priority?: 'low' | 'medium' | 'high' | 'urgent';
-}
-
-export interface ReminderTemplate {
-  subject: (params: ReminderTemplateParams) => string;
-  description: (params: ReminderTemplateParams) => string;
-}
-
-export interface ReminderTemplateParams {
-  day: number;
-  offeringName: string;
-  daysLeft?: number;
-  userName: string;
-  tradeStatus: string;
-}
-
-export interface ReminderContext {
-  queryRunner: QueryRunner;
-  job: Job<ProcessTradeCancellationReminderDto>;
-  site: Site;
-  logContext: any;
-}