@dakkitor/api-contracts 1.1.0 → 1.1.2

package/dist/client-contacts/client-contacts.contract.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientContactsContract = exports.FilterClientContactSchema = exports.UpdateClientContactSchema = exports.CreateClientContactBodySchema = exports.CreateClientContactSchema = exports.ClientContactSchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const clients_contract_1 = require("../clients/clients.contract");
+const error_schemas_1 = require("../common/error-schemas");
+const pagination_schema_1 = require("../common/pagination.schema");
+// Enums
+const SortOrderSchema = zod_1.z.enum(['ASC', 'DESC']);
+const ClientContactSortableFieldsSchema = zod_1.z.enum([
+    'name',
+    'position',
+    'email',
+    'createdAt',
+    'updatedAt',
+]);
+// Shared Schemas
+const ResourceIdSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+});
+// User Schema (duplicated from clients for now to avoid export issues, ideally should be in common)
+const UserSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string(),
+    email: zod_1.z.email(),
+});
+exports.ClientContactSchema = zod_1.z.object({
+    id: zod_1.z.uuid().describe('Contact ID'),
+    clientId: zod_1.z.uuid().describe('Client ID'),
+    client: clients_contract_1.ClientSchema.describe('Client Details'),
+    name: zod_1.z.string().describe('Contact Name'),
+    position: zod_1.z.string().optional().describe('Job Position'),
+    phone: zod_1.z.string().describe('Phone Number'),
+    email: zod_1.z.email().describe('Email Address'),
+    source: zod_1.z.string().optional().describe('Source'),
+    createdBy: UserSchema.describe('Created By'),
+    createdAt: zod_1.z.coerce.date().describe('Creation Date'),
+    updatedAt: zod_1.z.coerce.date().describe('Last Update Date'),
+    version: zod_1.z.number().describe('Version Number'),
+});
+exports.CreateClientContactSchema = zod_1.z.object({
+    client: ResourceIdSchema.describe('Client ID'),
+    name: zod_1.z.string().max(255).describe('Full Name'),
+    position: zod_1.z.string().max(255).optional().describe('Job Position'),
+    phone: zod_1.z.string().max(50).describe('Phone Number'),
+    email: zod_1.z.email().max(255).describe('Email Address'),
+    source: zod_1.z.string().max(255).optional().describe('Source'),
+});
+exports.CreateClientContactBodySchema = exports.CreateClientContactSchema.omit({
+    client: true,
+});
+exports.UpdateClientContactSchema = exports.CreateClientContactSchema.partial()
+    .extend({
+    version: zod_1.z.number().int().describe('Version for optimistic locking'),
+})
+    .omit({ client: true }); // client cannot be updated via this endpoint usually
+exports.FilterClientContactSchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().default(1).describe('Page number'),
+    limit: zod_1.z.coerce.number().default(50).describe('Results per page'),
+    name: zod_1.z.string().optional().describe('Filter by name'),
+    email: zod_1.z.string().optional().describe('Filter by email'),
+    phone: zod_1.z.string().optional().describe('Filter by phone'),
+    clientId: zod_1.z.uuid().optional().describe('Search client'),
+    createdById: zod_1.z.uuid().optional().describe('Search by creator'),
+    sortBy: ClientContactSortableFieldsSchema.default('createdAt').describe('Sort field'),
+    sortOrder: SortOrderSchema.default('DESC').describe('Sort order'),
+});
+const c = (0, core_1.initContract)();
+const clientContactsContractConfig = {
+    create: {
+        method: 'POST',
+        path: '/v2/client-contacts',
+        responses: {
+            201: exports.ClientContactSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        body: exports.CreateClientContactSchema,
+        summary: 'Create a new client contact',
+    },
+    createByClientId: {
+        method: 'POST',
+        path: '/v2/client-contacts/client/:clientId',
+        responses: {
+            201: exports.ClientContactSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        pathParams: zod_1.z.object({
+            clientId: zod_1.z.uuid(),
+        }),
+        body: exports.CreateClientContactBodySchema,
+        summary: 'Create a new contact for a specific client',
+    },
+    findAll: {
+        method: 'GET',
+        path: '/v2/client-contacts',
+        responses: {
+            200: (0, pagination_schema_1.createPaginatedResponseSchema)(exports.ClientContactSchema),
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        query: exports.FilterClientContactSchema,
+        summary: 'Get all client contacts',
+    },
+    findOne: {
+        method: 'GET',
+        path: '/v2/client-contacts/:contactId',
+        responses: {
+            200: exports.ClientContactSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        pathParams: zod_1.z.object({
+            contactId: zod_1.z.uuid(),
+        }),
+        summary: 'Get a client contact by ID',
+    },
+    update: {
+        method: 'PATCH',
+        path: '/v2/client-contacts/:contactId',
+        responses: {
+            200: exports.ClientContactSchema,
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        pathParams: zod_1.z.object({
+            contactId: zod_1.z.uuid(),
+        }),
+        body: exports.UpdateClientContactSchema,
+        summary: 'Update a client contact',
+    },
+    remove: {
+        method: 'DELETE',
+        path: '/v2/client-contacts/:contactId',
+        responses: {
+            204: c.noBody(),
+            400: error_schemas_1.ErrorResponseSchema,
+            401: error_schemas_1.ErrorResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            500: error_schemas_1.ErrorResponseSchema,
+        },
+        pathParams: zod_1.z.object({
+            contactId: zod_1.z.uuid(),
+        }),
+        body: c.noBody(),
+        summary: 'Delete a client contact',
+    },
+};
+const clientContactsContractRouter = c.router(clientContactsContractConfig);
+exports.clientContactsContract = clientContactsContractRouter;