@deepintel-ltd/buildlink-api-contracts 0.2.23

package/contracts/timecards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timecards.d.ts","sourceRoot":"","sources":["../../../src/contracts/timecards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAE3B,mBAAmB,EACnB,qBAAqB,EAGrB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuI5B,CAAC;AAGH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/contracts/timecards.js

@@ -0,0 +1,133 @@
+import { initContract } from '@ts-rest/core';
+import { z } from 'zod';
+import { CuidSchema, JsonApiCollectionResponseSchema, JsonApiErrorResponseSchema, JsonApiResponseSchema, } from '../schemas/common';
+import { CreateTimecardEntryRequestSchema, CreateTimecardRequestSchema, TimecardEntryResourceSchema, TimecardFiltersSchema, TimecardQueryParamsSchema, TimecardResourceSchema, } from '../schemas/timecards';
+const c = initContract();
+export const timecardsContract = c.router({
+    // ===== TIMECARD MANAGEMENT =====
+    getTimecards: {
+        method: 'GET',
+        path: '/timecards',
+        query: TimecardFiltersSchema,
+        responses: {
+            200: JsonApiCollectionResponseSchema(TimecardResourceSchema),
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get timecards with filtering and pagination',
+    },
+    createTimecard: {
+        method: 'POST',
+        path: '/timecards',
+        query: TimecardQueryParamsSchema,
+        body: CreateTimecardRequestSchema,
+        responses: {
+            201: JsonApiResponseSchema(TimecardResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+        },
+        summary: 'Create a new timecard',
+    },
+    getTimecard: {
+        method: 'GET',
+        path: '/timecards/:timecardId',
+        pathParams: z.object({
+            timecardId: CuidSchema,
+        }),
+        query: TimecardQueryParamsSchema,
+        responses: {
+            200: JsonApiResponseSchema(TimecardResourceSchema),
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+        },
+        summary: 'Get a specific timecard',
+    },
+    addTimecardEntry: {
+        method: 'POST',
+        path: '/timecards/:timecardId/entries',
+        pathParams: z.object({
+            timecardId: CuidSchema,
+        }),
+        query: TimecardQueryParamsSchema,
+        body: CreateTimecardEntryRequestSchema,
+        responses: {
+            201: JsonApiResponseSchema(TimecardEntryResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+        },
+        summary: 'Add a new entry to a timecard',
+    },
+    submitTimecard: {
+        method: 'PATCH',
+        path: '/timecards/:timecardId/submit',
+        pathParams: z.object({
+            timecardId: CuidSchema,
+        }),
+        query: TimecardQueryParamsSchema,
+        body: z.object({
+            notes: z.string().max(500).optional(),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(TimecardResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+        },
+        summary: 'Submit a timecard for approval',
+    },
+    approveTimecard: {
+        method: 'PATCH',
+        path: '/timecards/:timecardId/approve',
+        pathParams: z.object({
+            timecardId: CuidSchema,
+        }),
+        query: TimecardQueryParamsSchema,
+        body: z.object({
+            action: z.enum(['APPROVE', 'REJECT']),
+            notes: z.string().max(1000).optional(),
+            rejectionReason: z.string().max(1000).optional(),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(TimecardResourceSchema),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+            404: JsonApiErrorResponseSchema,
+        },
+        summary: 'Approve or reject a submitted timecard',
+    },
+    exportPayrollData: {
+        method: 'POST',
+        path: '/timecards/payroll-export',
+        query: TimecardQueryParamsSchema,
+        body: z.object({
+            startDate: z.string().datetime(),
+            endDate: z.string().datetime(),
+            userIds: z.array(CuidSchema).optional(),
+            format: z.enum(['CSV', 'EXCEL', 'JSON']).default('CSV'),
+        }),
+        responses: {
+            200: JsonApiResponseSchema(z.object({
+                type: z.literal('payroll-exports'),
+                id: z.string(),
+                attributes: z.object({
+                    exportId: z.string(),
+                    format: z.enum(['CSV', 'EXCEL', 'JSON']),
+                    recordCount: z.number(),
+                    downloadUrl: z.string().url(),
+                    expiresAt: z.string().datetime(),
+                }),
+            })),
+            400: JsonApiErrorResponseSchema,
+            401: JsonApiErrorResponseSchema,
+            403: JsonApiErrorResponseSchema,
+        },
+        summary: 'Export timecard data for payroll processing',
+    },
+});
+//# sourceMappingURL=timecards.js.map

package/contracts/timecards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timecards.js","sourceRoot":"","sources":["../../../src/contracts/timecards.ts"],"names":[],"mappings":"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"}