@dalmore/api-contracts 1.0.9 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. package/README.md +48 -39
  2. package/common/helpers/index.ts +59 -0
  3. package/{src/common → common}/types/account-contact.types.ts +2 -1
  4. package/{src/common → common}/types/account-manager.types.ts +3 -7
  5. package/common/types/account-setting.types.ts +65 -0
  6. package/{src/common → common}/types/account.types.ts +1 -0
  7. package/{src/common → common}/types/activity.types.ts +1 -1
  8. package/{src/common → common}/types/api-key-logs.types.ts +1 -1
  9. package/{src/common → common}/types/asset.types.ts +14 -14
  10. package/{src/common → common}/types/auth.types.ts +7 -18
  11. package/{src/common → common}/types/bonus-tier.types.ts +33 -0
  12. package/{src/common → common}/types/cart.types.ts +4 -1
  13. package/{src/common → common}/types/common.types.ts +39 -7
  14. package/{src/common → common}/types/contact-us.types.ts +6 -2
  15. package/{src/common → common}/types/covered-person.types.ts +2 -1
  16. package/{src/common → common}/types/dashboard.types.ts +2 -9
  17. package/{src/common → common}/types/data-record.types.ts +1 -1
  18. package/{src/common → common}/types/disbursements.types.ts +119 -3
  19. package/{src/common → common}/types/escrow-account.types.ts +3 -3
  20. package/{src/common → common}/types/file.types.ts +20 -4
  21. package/common/types/i-will-do-it-later.types.ts +68 -0
  22. package/{src/common → common}/types/index.ts +2 -0
  23. package/{src/common → common}/types/individuals.types.ts +5 -17
  24. package/{src/common → common}/types/investor-account.types.ts +2 -1
  25. package/{src/common → common}/types/invite.types.ts +27 -1
  26. package/{src/common → common}/types/issuer-offering.types.ts +113 -30
  27. package/{src/common → common}/types/issuer-payment-method.types.ts +41 -0
  28. package/{src/common → common}/types/issuer.types.ts +9 -0
  29. package/{src/common → common}/types/legal-entity.types.ts +3 -2
  30. package/{src/common → common}/types/note.types.ts +1 -1
  31. package/common/types/notification.types.ts +544 -0
  32. package/{src/common → common}/types/offering.types.ts +106 -20
  33. package/{src/common → common}/types/page.types.ts +1 -1
  34. package/{src/common → common}/types/phone.type.ts +1 -1
  35. package/{src/common → common}/types/site-settings.types.ts +2 -1
  36. package/{src/common → common}/types/site.types.ts +2 -9
  37. package/{src/common/types/trade-line-item.type.ts → common/types/trade-line-item.types.ts} +2 -9
  38. package/{src/common → common}/types/trade.types.ts +137 -4
  39. package/{src/common → common}/types/transaction.types.ts +12 -1
  40. package/{src/common → common}/types/trusted-contact.types.ts +7 -7
  41. package/{src/common → common}/types/user.types.ts +17 -33
  42. package/{src/common → common}/types/zip.type.ts +1 -1
  43. package/contracts/clients/cart/index.ts +80 -0
  44. package/{src/contracts → contracts}/clients/files/index.ts +14 -1
  45. package/{src/contracts → contracts}/clients/files-public/index.ts +15 -1
  46. package/{src/contracts → contracts}/clients/index.ts +10 -0
  47. package/contracts/clients/issuer-payment-methods/index.ts +39 -0
  48. package/contracts/clients/payment-methods/index.ts +85 -0
  49. package/contracts/clients/trade-line-items/index.ts +66 -0
  50. package/{src/contracts → contracts}/clients/trades/index.ts +65 -1
  51. package/contracts/clients/transactions/index.ts +37 -0
  52. package/index.ts +10 -0
  53. package/package.json +32 -11
  54. package/index.mjs +0 -10876
  55. package/src/common/types/address.spec.ts +0 -203
  56. package/src/common/types/common.types.spec.ts +0 -336
  57. package/src/common/types/contract-helpers.ts +0 -205
  58. package/src/common/types/files.types.spec.ts +0 -154
  59. package/src/common/types/issuer-payment-method.types.spec.ts +0 -612
  60. package/src/common/types/notification.types.ts +0 -58
  61. package/src/common/types/offering.types.spec.ts +0 -91
  62. package/src/common/types/phone.spec.ts +0 -76
  63. package/src/common/types/site-link.types.spec.ts +0 -134
  64. /package/{src/common → common}/types/account-detail.types.ts +0 -0
  65. /package/{src/common → common}/types/account-integration.types.ts +0 -0
  66. /package/{src/common → common}/types/address.types.ts +0 -0
  67. /package/{src/common → common}/types/aic.types.ts +0 -0
  68. /package/{src/common → common}/types/aml.types.ts +0 -0
  69. /package/{src/common → common}/types/api-keys.types.ts +0 -0
  70. /package/{src/common → common}/types/batch-jobs.types.ts +0 -0
  71. /package/{src/common → common}/types/checklist-items.types.ts +0 -0
  72. /package/{src/common → common}/types/checklist.types.ts +0 -0
  73. /package/{src/common → common}/types/comply-advantage-api.types.ts +0 -0
  74. /package/{src/common → common}/types/comply-advantage.types.ts +0 -0
  75. /package/{src/common → common}/types/countries.types.ts +0 -0
  76. /package/{src/common → common}/types/data-room.types.ts +0 -0
  77. /package/{src/common → common}/types/default-theme-config.types.ts +0 -0
  78. /package/{src/common → common}/types/disbursement-adjustment.types.ts +0 -0
  79. /package/{src/common → common}/types/disbursement-approval-user.types.ts +0 -0
  80. /package/{src/common → common}/types/disbursement-review.types.ts +0 -0
  81. /package/{src/common → common}/types/disbursement-transaction.types.ts +0 -0
  82. /package/{src/common → common}/types/domain-filter.types.ts +0 -0
  83. /package/{src/common → common}/types/email-theme.types.ts +0 -0
  84. /package/{src/common → common}/types/entity.types.ts +0 -0
  85. /package/{src/common → common}/types/error-responses.types.ts +0 -0
  86. /package/{src/common → common}/types/exchange-api-key.types.ts +0 -0
  87. /package/{src/common → common}/types/exchange-import.types.ts +0 -0
  88. /package/{src/common → common}/types/exchange-provider.types.ts +0 -0
  89. /package/{src/common → common}/types/health.types.ts +0 -0
  90. /package/{src/common → common}/types/investorAccountIdSchema.type.ts +0 -0
  91. /package/{src/common → common}/types/investors-offering.types.ts +0 -0
  92. /package/{src/common → common}/types/issuer-bank-account.types.ts +0 -0
  93. /package/{src/common → common}/types/job-item.types.ts +0 -0
  94. /package/{src/common → common}/types/jobs.types.ts +0 -0
  95. /package/{src/common → common}/types/kyb.types.ts +0 -0
  96. /package/{src/common → common}/types/kyc.types.ts +0 -0
  97. /package/{src/common → common}/types/login-history.types.ts +0 -0
  98. /package/{src/common → common}/types/mail-template.types.ts +0 -0
  99. /package/{src/common → common}/types/north-cap-integration.types.ts +0 -0
  100. /package/{src/common → common}/types/notion-api.types.ts +0 -0
  101. /package/{src/common → common}/types/notion-database.types.ts +0 -0
  102. /package/{src/common → common}/types/notion-page.types.ts +0 -0
  103. /package/{src/common → common}/types/offering-reports.types.ts +0 -0
  104. /package/{src/common → common}/types/offering-submission.types.ts +0 -0
  105. /package/{src/common → common}/types/page-revision.types.ts +0 -0
  106. /package/{src/common → common}/types/password.type.ts +0 -0
  107. /package/{src/common → common}/types/payment-methods.types.ts +0 -0
  108. /package/{src/common → common}/types/portfolio.types.ts +0 -0
  109. /package/{src/common → common}/types/privacy-policy-and-tos.types.ts +0 -0
  110. /package/{src/common → common}/types/queue.types.ts +0 -0
  111. /package/{src/common → common}/types/registered-reps.types.ts +0 -0
  112. /package/{src/common → common}/types/rejection-reasons.types.ts +0 -0
  113. /package/{src/common → common}/types/reminder-config.types.ts +0 -0
  114. /package/{src/common → common}/types/review.types.ts +0 -0
  115. /package/{src/common → common}/types/role.types.ts +0 -0
  116. /package/{src/common → common}/types/secondary-customer.types.ts +0 -0
  117. /package/{src/common → common}/types/secondary-issuer.types.ts +0 -0
  118. /package/{src/common → common}/types/secondary-order.types.ts +0 -0
  119. /package/{src/common → common}/types/secondary-security.types.ts +0 -0
  120. /package/{src/common → common}/types/secondary-trade.entity.ts +0 -0
  121. /package/{src/common → common}/types/secondary-trade.types.ts +0 -0
  122. /package/{src/common → common}/types/secure-request.types.ts +0 -0
  123. /package/{src/common → common}/types/signer.types.ts +0 -0
  124. /package/{src/common → common}/types/site-link.types.ts +0 -0
  125. /package/{src/common → common}/types/sms.types.ts +0 -0
  126. /package/{src/common → common}/types/state-machine.types.ts +0 -0
  127. /package/{src/common → common}/types/states.types.ts +0 -0
  128. /package/{src/common → common}/types/subdoc-preview.types.ts +0 -0
  129. /package/{src/common → common}/types/task.types.ts +0 -0
  130. /package/{src/common → common}/types/trade-adjustment.type.ts +0 -0
  131. /package/{src/common → common}/types/typography.types.ts +0 -0
  132. /package/{src/common → common}/types/user-manual.types.ts +0 -0
  133. /package/{src/common → common}/types/user-setting.types.ts +0 -0
  134. /package/{src/common → common}/types/webhook.types.ts +0 -0
  135. /package/{src/contracts → contracts}/clients/accounts/index.ts +0 -0
  136. /package/{src/contracts → contracts}/clients/aic/index.ts +0 -0
  137. /package/{src/contracts → contracts}/clients/api-key-logs/index.ts +0 -0
  138. /package/{src/contracts → contracts}/clients/api-keys/index.ts +0 -0
  139. /package/{src/contracts → contracts}/clients/assets/index.ts +0 -0
  140. /package/{src/contracts → contracts}/clients/auth/index.ts +0 -0
  141. /package/{src/contracts → contracts}/clients/individuals/index.ts +0 -0
  142. /package/{src/contracts → contracts}/clients/investor-accounts/index.ts +0 -0
  143. /package/{src/contracts → contracts}/clients/issuers/index.ts +0 -0
  144. /package/{src/contracts → contracts}/clients/legal-entities/index.ts +0 -0
  145. /package/{src/contracts → contracts}/clients/offerings/index.ts +0 -0
  146. /package/{src/contracts → contracts}/clients/secure-requests/index.ts +0 -0
  147. /package/{src/contracts → contracts}/clients/sites/index.ts +0 -0
@@ -1,205 +0,0 @@
1
- /**
2
- * Contract helpers - minimal subset for API contracts package
3
- * This file is copied directly to @dalmore/api-contracts
4
- */
5
- import { HttpStatus } from '@nestjs/common';
6
- import parsePhoneNumberFromString, {
7
- CountryCode,
8
- PhoneNumber,
9
- } from 'libphonenumber-js';
10
- import { err, ok, Result } from 'neverthrow';
11
- import { ErrorResult } from './common.types';
12
-
13
- /**
14
- * Validates a US zip code format (12345 or 12345-6789)
15
- */
16
- export const validateUSZipCode = (zipCode: string): boolean => {
17
- const regex = /^[0-9]{5}(?:-[0-9]{4})?$/;
18
- return regex.test(zipCode);
19
- };
20
-
21
- /**
22
- * Validates a Canadian postal code format (A1A 1A1)
23
- */
24
- export const validateCanadaZipCode = (zipCode: string): boolean => {
25
- const regex = /^[A-Za-z]\d[A-Za-z] \d[A-Za-z]\d$/;
26
- return regex.test(zipCode);
27
- };
28
-
29
- /**
30
- * Normalizes a short date string (M/D/YY or M/D/YYYY) to MM/DD/YYYY format
31
- */
32
- export function normalizeShortDate(input: string): string {
33
- const [month, day, year] = input.split('/');
34
-
35
- if (!month || !day || !year) {
36
- throw new Error('Invalid date format');
37
- }
38
-
39
- const paddedMonth = month.padStart(2, '0');
40
- const paddedDay = day.padStart(2, '0');
41
- const fullYear = year.length === 2 ? `20${year}` : year;
42
-
43
- return `${paddedMonth}/${paddedDay}/${fullYear}`;
44
- }
45
-
46
- /**
47
- * Converts a string into a URL-safe slug
48
- */
49
- export function slugify(input: string, exclude: boolean = false): string {
50
- if (exclude) {
51
- const excludeWords = ['llc', 'inc', 'corp', 'co'];
52
- const negativeWordsList = [
53
- 'www',
54
- 'api',
55
- 'admin',
56
- 'dashboard',
57
- 'auth',
58
- 'cdn',
59
- 'static',
60
- 'blog',
61
- 'support',
62
- 'status',
63
- 'mail',
64
- 'smtp',
65
- 'ftp',
66
- 'ssh',
67
- 'login',
68
- 'register',
69
- 'signup',
70
- 'account',
71
- 'accounts',
72
- 'user',
73
- 'users',
74
- 'profile',
75
- 'settings',
76
- 'help',
77
- 'docs',
78
- 'documentation',
79
- 'developer',
80
- 'developers',
81
- 'app',
82
- 'apps',
83
- 'test',
84
- 'demo',
85
- 'staging',
86
- 'dev',
87
- 'prod',
88
- 'production',
89
- 'beta',
90
- 'alpha',
91
- 'portal',
92
- 'portals',
93
- 'client',
94
- 'clients',
95
- 'investor',
96
- 'investors',
97
- 'issuer',
98
- 'issuers',
99
- 'compliance',
100
- 'offering',
101
- 'offerings',
102
- 'trade',
103
- 'trades',
104
- ];
105
-
106
- let slug = input
107
- .toLowerCase()
108
- .replace(/[^\w\s-]/g, '')
109
- .replace(/[\s_-]+/g, '-')
110
- .replace(/^-+|-+$/g, '');
111
-
112
- excludeWords.forEach((word) => {
113
- slug = slug.replace(new RegExp(`-${word}$`, 'i'), '');
114
- });
115
-
116
- if (negativeWordsList.includes(slug)) {
117
- return 'new-account';
118
- }
119
-
120
- return slug;
121
- }
122
-
123
- return input
124
- .toLowerCase()
125
- .replace(/[^\w\s-]/g, '')
126
- .replace(/[\s_-]+/g, '-')
127
- .replace(/^-+|-+$/g, '');
128
- }
129
-
130
- type CurlOptions = {
131
- query?: Record<string, string>;
132
- headers?: Record<string, string>;
133
- body?: Record<string, unknown>;
134
- formData?: Record<string, string>;
135
- };
136
-
137
- export const authHeader: CurlOptions['headers'] = {
138
- Authorization: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9',
139
- };
140
-
141
- const generateCurlExample = (
142
- method: string,
143
- path: string,
144
- options: CurlOptions,
145
- ) => {
146
- const baseUrl = 'https://dalmore-client-portal-api-prod.onrender.com/api/v1';
147
- let curl = `curl -X ${method.toUpperCase()} '${baseUrl}${path}`;
148
- if (options.query) {
149
- const queryString = new URLSearchParams(options.query).toString();
150
- curl += `?${queryString}`;
151
- }
152
- curl += "'";
153
- if (options.headers) {
154
- Object.entries(options.headers).forEach(([key, value]) => {
155
- curl += ` \\\n --header '${key}: ${value}'`;
156
- });
157
- }
158
- if (options.body) {
159
- curl += ` \\\n --header 'Content-Type: application/json'`;
160
- curl += ` \\\n --data '${JSON.stringify(options.body)}'`;
161
- }
162
- if (options.formData) {
163
- Object.entries(options.formData).forEach(([key, value]) => {
164
- curl += ` \\\n --form '${key}=${value}'`;
165
- });
166
- }
167
- return curl;
168
- };
169
-
170
- export const generateApiDescription = (
171
- summary: string,
172
- method: string,
173
- path: string,
174
- options: CurlOptions,
175
- ) => {
176
- const curlExample = generateCurlExample(method, path, options);
177
- return `${summary}
178
-
179
- ### Example curl request
180
-
181
- \`\`\`bash
182
- ${curlExample}
183
- \`\`\``;
184
- };
185
-
186
- /**
187
- * Normalizes a phone number to E.164 format
188
- */
189
- export function normalizePhoneNumber(
190
- phoneNumber: string,
191
- countryCode: CountryCode,
192
- ): Result<PhoneNumber, ErrorResult> {
193
- const parsedPhoneNumber = parsePhoneNumberFromString(
194
- phoneNumber,
195
- countryCode,
196
- );
197
-
198
- if (!parsedPhoneNumber || !parsedPhoneNumber.isValid()) {
199
- return err({
200
- status: HttpStatus.BAD_REQUEST,
201
- message: 'Invalid phone number. Only numbers',
202
- });
203
- }
204
- return ok(parsedPhoneNumber);
205
- }
@@ -1,154 +0,0 @@
1
- import { typeid } from 'typeid-js';
2
- import {
3
- FileZod,
4
- allowedFileExtension,
5
- fileIdSchema,
6
- PostFileQueryParams,
7
- FileFilters,
8
- ADFFileProcessingPipeline,
9
- } from './file.types';
10
- import { FileLabels, FileStatus } from './common.types';
11
-
12
- describe('File Validation', () => {
13
- describe('fileIdSchema', () => {
14
- it('should validate correct file IDs', () => {
15
- const validFileId = typeid('file').toString();
16
- const result = fileIdSchema.safeParse(validFileId);
17
- expect(result.success).toBe(true);
18
- });
19
-
20
- it('should reject invalid file IDs', () => {
21
- const invalidFileIds = [
22
- 'user_01j5y5ghx8fvc83dmx3pznq7hv',
23
- 'file_invalid',
24
- '',
25
- ];
26
-
27
- invalidFileIds.forEach((id) => {
28
- const result = fileIdSchema.safeParse(id);
29
- expect(result.success).toBe(false);
30
- });
31
- });
32
- });
33
-
34
- describe('FileZod', () => {
35
- it('should validate a correct file object', () => {
36
- const validFile = {
37
- id: typeid('file').toString(),
38
- tid: 'some-tid',
39
- url: 'https://example.com/file.pdf',
40
- fileType: 'pdf',
41
- fileName: 'test.pdf',
42
- name: 'test',
43
- category: 'application',
44
- label: FileLabels.OTHER,
45
- metadata: null,
46
- private: false,
47
- complianceReview: 'PENDING',
48
- targetTable: 'TRADES',
49
- targetId: null,
50
- linkedFrom: null,
51
- accountId: typeid('account').toString(),
52
- userId: typeid('user').toString(),
53
- status: FileStatus.PENDING,
54
- pipeline: ADFFileProcessingPipeline.NONE,
55
- errorMessage: null,
56
- reviewLog: null,
57
- createdAt: new Date(),
58
- updatedAt: new Date(),
59
- deletedAt: null,
60
- };
61
-
62
- const result = FileZod.safeParse(validFile);
63
- expect(result.success).toBe(true);
64
- });
65
-
66
- it('should reject invalid file objects', () => {
67
- const invalidFile = {
68
- id: 'invalid_id',
69
- url: 'not-a-url',
70
- // missing required fields
71
- };
72
-
73
- const result = FileZod.safeParse(invalidFile);
74
- expect(result.success).toBe(false);
75
- });
76
- });
77
-
78
- describe('PostFileQueryParams', () => {
79
- it('should validate correct query parameters', () => {
80
- const validQuery = {
81
- name: 'test_file',
82
- category: 'application',
83
- label: FileLabels.OTHER,
84
- targetId: typeid('trade').toString(),
85
- };
86
-
87
- const result = PostFileQueryParams.safeParse(validQuery);
88
- expect(result.success).toBe(true);
89
- });
90
-
91
- it('should reject invalid target IDs', () => {
92
- const invalidQuery = {
93
- name: 'test_file',
94
- category: 'application',
95
- label: FileLabels.OTHER,
96
- targetId: 'invalid_id',
97
- };
98
-
99
- const result = PostFileQueryParams.safeParse(invalidQuery);
100
- expect(result.success).toBe(false);
101
- });
102
- });
103
-
104
- describe('FileFilters', () => {
105
- it('should handle optional includeLinkedFrom parameter', () => {
106
- const validFilters = [
107
- { includeLinkedFrom: 'true' },
108
- { includeLinkedFrom: 'false' },
109
- { includeLinkedFrom: undefined },
110
- {},
111
- ];
112
-
113
- validFilters.forEach((filter) => {
114
- const result = FileFilters.safeParse(filter);
115
- expect(result.success).toBe(true);
116
- });
117
- });
118
-
119
- it('should reject invalid includeLinkedFrom values', () => {
120
- const invalidFilters = [
121
- { includeLinkedFrom: 'yes' },
122
- { includeLinkedFrom: '1' },
123
- { includeLinkedFrom: 'TRUE' },
124
- ];
125
-
126
- invalidFilters.forEach((filter) => {
127
- const result = FileFilters.safeParse(filter);
128
- expect(result.success).toBe(false);
129
- });
130
- });
131
- });
132
-
133
- describe('allowedFileExtension', () => {
134
- it('should contain all supported extensions', () => {
135
- const expectedExtensions = [
136
- '.pdf',
137
- '.doc',
138
- '.docx',
139
- '.xls',
140
- '.xlsx',
141
- '.csv',
142
- '.gif',
143
- '.png',
144
- '.jpg',
145
- '.jpeg',
146
- '.txt',
147
- ];
148
-
149
- expectedExtensions.forEach((ext) => {
150
- expect(allowedFileExtension).toContain(ext);
151
- });
152
- });
153
- });
154
- });