@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/export-jobs/export-jobs.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-jobs.contract.d.ts","sourceRoot":"","sources":["../../contracts/export-jobs/export-jobs.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,kBAAkB,qEAAmE,CAAC;AACnG,eAAO,MAAM,kBAAkB,0EAAwE,CAAC;AAExG,eAAO,MAAM,cAAc;;;;;;;;;YAAqF,CAAC;AAEjH,eAAO,MAAM,6BAA6B,+DAKM,CAAC;AAEjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQM,CAAC;AAEzC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BpC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1B,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEK,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsD7B,CAAC;AAKH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAezB,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa9B,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCtB,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EASvB,CAAC"}

package/dist/export-jobs/export-jobs.contract.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USERS_EXPORT_COLUMNS = exports.JOBS_EXPORT_COLUMNS = exports.CALL_HISTORY_EXPORT_COLUMNS = exports.BOOKINGS_EXPORT_COLUMNS = exports.ACTIVES_EXPORT_COLUMNS = exports.exportJobsContract = exports.PaginatedExportJobResponseSchema = exports.ExportJobSchema = exports.CreateExportJobBodySchema = exports.FilterExportJobSchema = exports.ExportJobSortableFieldsSchema = exports.SortSpecSchema = exports.ExportStatusSchema = exports.ExportEntitySchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const actives_contract_1 = require("../actives/actives.contract");
+const bookings_contract_1 = require("../bookings/bookings.contract");
+const call_history_contract_1 = require("../call-history/call-history.contract");
+const jobs_contract_1 = require("../jobs/jobs.contract");
+const users_contract_1 = require("../users/users.contract");
+const common_schemas_1 = require("../common/common-schemas");
+const pagination_query_schema_1 = require("../common/pagination-query.schema");
+const pagination_schema_1 = require("../common/pagination.schema");
+const summary_schemas_1 = require("../shared/summary-schemas");
+const c = (0, core_1.initContract)();
+exports.ExportEntitySchema = zod_1.z.enum(['actives', 'bookings', 'call-history', 'jobs', 'users']);
+exports.ExportStatusSchema = zod_1.z.enum(['pending', 'processing', 'completed', 'failed', 'cancelled']);
+exports.SortSpecSchema = zod_1.z.array(zod_1.z.object({ field: zod_1.z.string(), dir: zod_1.z.enum(['ASC', 'DESC']) })).default([]);
+exports.ExportJobSortableFieldsSchema = zod_1.z.enum([
+    'requestedAt',
+    'completedAt',
+    'status',
+    'entity',
+]).openapi({ title: 'ExportJobSortableFields' });
+exports.FilterExportJobSchema = pagination_query_schema_1.PaginationQuerySchema.extend({
+    entity: exports.ExportEntitySchema.optional(),
+    status: exports.ExportStatusSchema.optional(),
+    userId: zod_1.z.string().uuid().optional().describe('Initiated by user'),
+    requestedAt: common_schemas_1.DateRangeSchema.optional()
+        .nullable()
+        .describe('Filter by request time range'),
+    sort: (0, common_schemas_1.createSortArraySchema)(exports.ExportJobSortableFieldsSchema),
+}).openapi({ title: 'FilterExportJob' });
+exports.CreateExportJobBodySchema = zod_1.z.discriminatedUnion('entity', [
+    zod_1.z.object({
+        entity: zod_1.z.literal('actives'),
+        filter: actives_contract_1.FilterActiveSchema,
+        sort: exports.SortSpecSchema,
+        columns: zod_1.z.array(zod_1.z.string()).min(1).max(50),
+    }),
+    zod_1.z.object({
+        entity: zod_1.z.literal('bookings'),
+        filter: bookings_contract_1.FilterBookingSchema,
+        sort: exports.SortSpecSchema,
+        columns: zod_1.z.array(zod_1.z.string()).min(1).max(50),
+    }),
+    zod_1.z.object({
+        entity: zod_1.z.literal('call-history'),
+        filter: call_history_contract_1.FilterCallHistorySchema,
+        sort: exports.SortSpecSchema,
+        columns: zod_1.z.array(zod_1.z.string()).min(1).max(50),
+    }),
+    zod_1.z.object({
+        entity: zod_1.z.literal('jobs'),
+        filter: jobs_contract_1.FilterJobSchema,
+        sort: exports.SortSpecSchema,
+        columns: zod_1.z.array(zod_1.z.string()).min(1).max(50),
+    }),
+    zod_1.z.object({
+        entity: zod_1.z.literal('users'),
+        filter: users_contract_1.FilterUserSchema,
+        sort: exports.SortSpecSchema,
+        columns: zod_1.z.array(zod_1.z.string()).min(1).max(50),
+    }),
+]);
+exports.ExportJobSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    userId: zod_1.z.string().uuid(),
+    user: summary_schemas_1.UserSummarySchema.nullable(),
+    entity: exports.ExportEntitySchema,
+    status: exports.ExportStatusSchema,
+    filter: zod_1.z.record(zod_1.z.unknown()),
+    sort: exports.SortSpecSchema,
+    columns: zod_1.z.array(zod_1.z.string()),
+    rowsProcessed: zod_1.z.number().int().nonnegative(),
+    rowsSkipped: zod_1.z.number().int().nonnegative(),
+    totalRows: zod_1.z.number().int().nullable(),
+    byteSize: zod_1.z.number().int().nonnegative().nullable(),
+    errorMessage: zod_1.z.string().nullable(),
+    requestedAt: zod_1.z.string(),
+    startedAt: zod_1.z.string().nullable(),
+    completedAt: zod_1.z.string().nullable(),
+    expiresAt: zod_1.z.string(),
+});
+exports.PaginatedExportJobResponseSchema = (0, pagination_schema_1.createPaginatedResponseSchema)(exports.ExportJobSchema).openapi({ title: 'PaginatedExportJobResponse' });
+exports.exportJobsContract = c.router({
+    create: {
+        method: 'POST',
+        path: '/v2/export-jobs',
+        body: exports.CreateExportJobBodySchema,
+        responses: {
+            201: exports.ExportJobSchema,
+            403: zod_1.z.object({ message: zod_1.z.string() }),
+            409: zod_1.z.object({ message: zod_1.z.string() }),
+        },
+        summary: 'Create an async CSV export job',
+    },
+    list: {
+        method: 'GET',
+        path: '/v2/export-jobs',
+        query: exports.FilterExportJobSchema,
+        responses: { 200: exports.PaginatedExportJobResponseSchema },
+        summary: 'List export jobs the caller is allowed to see',
+    },
+    getOne: {
+        method: 'GET',
+        path: '/v2/export-jobs/:id',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        responses: {
+            200: exports.ExportJobSchema,
+            404: zod_1.z.object({ message: zod_1.z.string() }),
+        },
+        summary: 'Fetch a single export job',
+    },
+    cancel: {
+        method: 'POST',
+        path: '/v2/export-jobs/:id/cancel',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: zod_1.z.object({}).optional(),
+        responses: {
+            200: exports.ExportJobSchema,
+            404: zod_1.z.object({ message: zod_1.z.string() }),
+            409: zod_1.z.object({ message: zod_1.z.string() }),
+        },
+        summary: 'Request cancellation of an export job',
+    },
+    download: {
+        method: 'GET',
+        path: '/v2/export-jobs/:id/download',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        responses: {
+            200: zod_1.z.object({ url: zod_1.z.string().url() }),
+            403: zod_1.z.object({ message: zod_1.z.string() }),
+            404: zod_1.z.object({ message: zod_1.z.string() }),
+            409: zod_1.z.object({ message: zod_1.z.string() }),
+            410: zod_1.z.object({ message: zod_1.z.string() }),
+        },
+        summary: 'Returns a short-lived presigned R2 URL for the export file',
+    },
+});
+// Per-entity column allow-lists, shared with the frontend dialog so both sides
+// reference the exact same set of allowed paths and labels.
+// These EXACTLY match what each exporter file declares.
+exports.ACTIVES_EXPORT_COLUMNS = [
+    { path: 'id', label: 'Active ID' },
+    { path: 'date', label: 'Date' },
+    { path: 'booking.startDate', label: 'Start Date' },
+    { path: 'booking.endDate', label: 'End Date' },
+    { path: 'status', label: 'Status' },
+    { path: 'worker.firstName', label: 'Worker First Name' },
+    { path: 'worker.lastName', label: 'Worker Last Name' },
+    { path: 'booking.id', label: 'Booking ID' },
+    { path: 'collaboration.client.name', label: 'Client' },
+    { path: 'pay.rate', label: 'Pay Rate' },
+    { path: 'pay.unit', label: 'Pay Unit' },
+    { path: 'pay.hourlyRate', label: 'Hourly Rate' },
+    { path: 'hoursWorked', label: 'Hours Worked' },
+    { path: 'createdAt', label: 'Created At' },
+];
+exports.BOOKINGS_EXPORT_COLUMNS = [
+    { path: 'id', label: 'Booking ID' },
+    { path: 'createdAt', label: 'Created At' },
+    { path: 'startDate', label: 'Start Date' },
+    { path: 'endDate', label: 'End Date' },
+    { path: 'status.category', label: 'Status Category' },
+    { path: 'status.type', label: 'Status Type' },
+    { path: 'worker.firstName', label: 'Worker First Name' },
+    { path: 'worker.lastName', label: 'Worker Last Name' },
+    { path: 'job.collaboration.client.name', label: 'Client' },
+    { path: 'job.collaboration.company.name', label: 'Company' },
+    { path: 'job.location.postcode', label: 'Postcode' },
+    { path: 'pay.rate', label: 'Pay Rate' },
+    { path: 'pay.unit', label: 'Pay Unit' },
+];
+exports.CALL_HISTORY_EXPORT_COLUMNS = [
+    { path: 'id', label: 'Call ID' },
+    { path: 'createdAt', label: 'Created At' },
+    { path: 'callType', label: 'Call Type' },
+    { path: 'leadSource', label: 'Lead Source' },
+    { path: 'rating', label: 'Rating' },
+    { path: 'ratingWeight', label: 'Rating Weight' },
+    { path: 'notes', label: 'Notes' },
+    { path: 'assignment.agent.firstName', label: 'Agent First Name' },
+    { path: 'assignment.agent.lastName', label: 'Agent Last Name' },
+    { path: 'assignment.lead.name', label: 'Lead Name' },
+    { path: 'assignment.lead.phoneNumber', label: 'Lead Phone' },
+    { path: 'assignment.company.name', label: 'Company' },
+];
+exports.JOBS_EXPORT_COLUMNS = [
+    { path: 'id', label: 'Job ID' },
+    { path: 'description', label: 'Description' },
+    { path: 'status', label: 'Status' },
+    { path: 'creationSource', label: 'Source' },
+    { path: 'numberOfPositions', label: 'Positions' },
+    { path: 'filledPositions', label: 'Filled Positions' },
+    { path: 'workHours', label: 'Work Hours' },
+    { path: 'tradeId', label: 'Trade ID' },
+    { path: 'trade.name', label: 'Trade' },
+    { path: 'pay.rate', label: 'Pay Rate' },
+    { path: 'pay.rateMax', label: 'Pay Rate Max' },
+    { path: 'pay.rateUnit', label: 'Pay Rate Unit' },
+    { path: 'pay.isNegotiable', label: 'Pay Negotiable' },
+    { path: 'pay.receivedRate', label: 'Received Rate' },
+    { path: 'location.postcode', label: 'Postcode' },
+    { path: 'location.postTown', label: 'Post Town' },
+    { path: 'location.adminDistrict', label: 'District' },
+    { path: 'location.address', label: 'Address' },
+    { path: 'distanceKm', label: 'Distance (km)' },
+    { path: 'collaboration.id', label: 'Collaboration ID' },
+    { path: 'collaboration.status', label: 'Collaboration Status' },
+    { path: 'collaboration.userId', label: 'Agent User ID' },
+    { path: 'collaboration.client.id', label: 'Client ID' },
+    { path: 'collaboration.client.name', label: 'Client' },
+    { path: 'collaboration.company.id', label: 'Company ID' },
+    { path: 'collaboration.company.name', label: 'Company' },
+    { path: 'collaboration.user.id', label: 'Agent ID' },
+    { path: 'collaboration.user.firstName', label: 'Agent First Name' },
+    { path: 'collaboration.user.lastName', label: 'Agent Last Name' },
+    { path: 'collaboration.user.phoneNumbers', label: 'Agent Phone Numbers' },
+    { path: 'collaboration.user.deletedAt', label: 'Agent Deleted At' },
+    { path: 'jobQualifications', label: 'Qualifications' },
+    { path: 'createdById', label: 'Created By User ID' },
+    { path: 'createdBy.id', label: 'Creator ID' },
+    { path: 'createdBy.firstName', label: 'Creator First Name' },
+    { path: 'createdBy.lastName', label: 'Creator Last Name' },
+    { path: 'createdBy.phoneNumbers', label: 'Creator Phone Numbers' },
+    { path: 'createdBy.deletedAt', label: 'Creator Deleted At' },
+    { path: 'createdAt', label: 'Created' },
+    { path: 'updatedAt', label: 'Updated' },
+];
+exports.USERS_EXPORT_COLUMNS = [
+    { path: 'id', label: 'User ID' },
+    { path: 'firstName', label: 'First Name' },
+    { path: 'lastName', label: 'Last Name' },
+    { path: 'email', label: 'Email' },
+    { path: 'roles', label: 'Roles' },
+    { path: 'status', label: 'Status' },
+    { path: 'office.name', label: 'Office' },
+    { path: 'createdAt', label: 'Created At' },
+];

package/dist/exports-events/exports-events.schemas.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Project: Internal Recruitment Platform API
+ * File: exports-events.schemas.ts
+ *
+ * Description: Event payload schemas for the /v2/exports/events SSE channel.
+ *              Same role as calls-feed.contract.ts for the calls feed.
+ */
+import { z } from 'zod';
+/**
+ * Event-name constants for the /v2/exports/events SSE channel.
+ * The string values are what the server sets as `event:` and what the
+ * client passes to `EventSource.addEventListener`.
+ */
+export declare const ExportsEventType: {
+    readonly CREATED: "export:created";
+    readonly STATUS_CHANGED: "export:status-changed";
+    readonly PROGRESS: "export:progress";
+    readonly COMPLETED: "export:completed";
+};
+export type ExportsEventType = (typeof ExportsEventType)[keyof typeof ExportsEventType];
+/** Payload for 'export:created'. Emitted when a new export job enters the queue. */
+export declare const ExportCreatedSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    status: z.ZodLiteral<"pending">;
+}, "strip", z.ZodTypeAny, {
+    status: "pending";
+    jobId: string;
+}, {
+    status: "pending";
+    jobId: string;
+}>;
+export type ExportCreated = z.infer<typeof ExportCreatedSchema>;
+/**
+ * Payload for 'export:status-changed'. Emitted on every status transition except
+ * the initial pending state (covered by 'export:created') and completion (covered
+ * by 'export:completed').
+ *
+ * `error` is intentionally named differently from the REST `errorMessage` column
+ * on `ExportJobSchema` — wire payloads prefer short names. It is `.optional()`
+ * (omitted when absent) rather than `.nullable()` to keep the wire lighter,
+ * unlike the REST field which uses `null`.
+ */
+export declare const ExportStatusChangedSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    status: z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled"]>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "processing" | "completed" | "failed" | "cancelled";
+    jobId: string;
+    error?: string | undefined;
+}, {
+    status: "pending" | "processing" | "completed" | "failed" | "cancelled";
+    jobId: string;
+    error?: string | undefined;
+}>;
+export type ExportStatusChanged = z.infer<typeof ExportStatusChangedSchema>;
+/** Payload for 'export:progress'. Throttled to one event per 2s per job, server-side. */
+export declare const ExportProgressSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    rowsProcessed: z.ZodNumber;
+    rowsSkipped: z.ZodNumber;
+    totalRows: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    rowsProcessed: number;
+    rowsSkipped: number;
+    totalRows: number | null;
+    jobId: string;
+}, {
+    rowsProcessed: number;
+    rowsSkipped: number;
+    totalRows: number | null;
+    jobId: string;
+}>;
+export type ExportProgress = z.infer<typeof ExportProgressSchema>;
+/** Payload for 'export:completed'. Emitted on successful completion only; failure / cancellation use 'export:status-changed'. */
+export declare const ExportCompletedSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    rowCount: z.ZodNumber;
+    fileSize: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    jobId: string;
+    rowCount: number;
+    fileSize: number | null;
+}, {
+    jobId: string;
+    rowCount: number;
+    fileSize: number | null;
+}>;
+export type ExportCompleted = z.infer<typeof ExportCompletedSchema>;
+//# sourceMappingURL=exports-events.schemas.d.ts.map

package/dist/exports-events/exports-events.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports-events.schemas.d.ts","sourceRoot":"","sources":["../../contracts/exports-events/exports-events.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,oFAAoF;AACpF,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,yFAAyF;AACzF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,iIAAiI;AACjI,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/exports-events/exports-events.schemas.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Project: Internal Recruitment Platform API
+ * File: exports-events.schemas.ts
+ *
+ * Description: Event payload schemas for the /v2/exports/events SSE channel.
+ *              Same role as calls-feed.contract.ts for the calls feed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportCompletedSchema = exports.ExportProgressSchema = exports.ExportStatusChangedSchema = exports.ExportCreatedSchema = exports.ExportsEventType = void 0;
+const zod_1 = require("zod");
+const export_jobs_contract_1 = require("../export-jobs/export-jobs.contract");
+/**
+ * Event-name constants for the /v2/exports/events SSE channel.
+ * The string values are what the server sets as `event:` and what the
+ * client passes to `EventSource.addEventListener`.
+ */
+exports.ExportsEventType = {
+    CREATED: 'export:created',
+    STATUS_CHANGED: 'export:status-changed',
+    PROGRESS: 'export:progress',
+    COMPLETED: 'export:completed',
+};
+/** Payload for 'export:created'. Emitted when a new export job enters the queue. */
+exports.ExportCreatedSchema = zod_1.z.object({
+    jobId: zod_1.z.string().uuid(),
+    status: zod_1.z.literal('pending'),
+});
+/**
+ * Payload for 'export:status-changed'. Emitted on every status transition except
+ * the initial pending state (covered by 'export:created') and completion (covered
+ * by 'export:completed').
+ *
+ * `error` is intentionally named differently from the REST `errorMessage` column
+ * on `ExportJobSchema` — wire payloads prefer short names. It is `.optional()`
+ * (omitted when absent) rather than `.nullable()` to keep the wire lighter,
+ * unlike the REST field which uses `null`.
+ */
+exports.ExportStatusChangedSchema = zod_1.z.object({
+    jobId: zod_1.z.string().uuid(),
+    status: export_jobs_contract_1.ExportStatusSchema,
+    error: zod_1.z.string().optional(),
+});
+/** Payload for 'export:progress'. Throttled to one event per 2s per job, server-side. */
+exports.ExportProgressSchema = zod_1.z.object({
+    jobId: zod_1.z.string().uuid(),
+    rowsProcessed: zod_1.z.number().int().nonnegative(),
+    rowsSkipped: zod_1.z.number().int().nonnegative(),
+    totalRows: zod_1.z.number().int().nullable(),
+});
+/** Payload for 'export:completed'. Emitted on successful completion only; failure / cancellation use 'export:status-changed'. */
+exports.ExportCompletedSchema = zod_1.z.object({
+    jobId: zod_1.z.string().uuid(),
+    rowCount: zod_1.z.number().int().nonnegative(),
+    fileSize: zod_1.z.number().int().nonnegative().nullable(),
+});