@dakkitor/api-contracts 1.1.10 → 1.1.12

package/dist/qualifications/qualifications.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifications.contract.d.ts","sourceRoot":"","sources":["../../contracts/qualifications/qualifications.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,uBAAuB;;;;;;;;;EAQM,CAAC;AAE3C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYM,CAAC;AAEvC,eAAO,MAAM,6BAA6B;;;;;;EAIM,CAAC;AAEjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;EASM,CAAC;AAE7C,eAAO,MAAM,6BAA6B;;;;;;;;;EAWM,CAAC;AAEjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBM,CAAC;AAE7C,eAAO,MAAM,6BAA6B;;;;;;EAQM,CAAC;AAEjD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAEM,CAAC;AAI5C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAIF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIlC,CAAC"}

package/dist/qualifications/qualifications.contract.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qualificationsContract = exports.QualificationArraySchema = exports.UpdateQualificationTypeSchema = exports.UpdateQualificationSchema = exports.UpsertQualificationTypeSchema = exports.CreateQualificationSchema = exports.CreateQualificationTypeSchema = exports.QualificationSchema = exports.QualificationTypeSchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const c = (0, core_1.initContract)();
+// --- Schemas ---
+exports.QualificationTypeSchema = zod_1.z
+    .object({
+    id: zod_1.z
+        .string()
+        .uuid()
+        .describe('Unique identifier for the qualification type'),
+    name: zod_1.z.string().describe('Name of the qualification type'),
+})
+    .openapi({ title: 'QualificationType' });
+exports.QualificationSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid().describe('Unique identifier for the qualification'),
+    name: zod_1.z.string().describe('Name of the qualification'),
+    description: zod_1.z
+        .string()
+        .nullable()
+        .describe('Description of the qualification'),
+    types: zod_1.z
+        .array(exports.QualificationTypeSchema)
+        .describe('List of specific types associated with this qualification'),
+})
+    .openapi({ title: 'Qualification' });
+exports.CreateQualificationTypeSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1).describe('Name of the qualification type'),
+})
+    .openapi({ title: 'CreateQualificationType' });
+exports.CreateQualificationSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1).describe('Name of the qualification'),
+    description: zod_1.z.string().min(1).describe('Description of the qualification'),
+    types: zod_1.z
+        .array(exports.CreateQualificationTypeSchema)
+        .optional()
+        .describe('Optional list of types for the qualification'),
+})
+    .openapi({ title: 'CreateQualification' });
+exports.UpsertQualificationTypeSchema = zod_1.z
+    .object({
+    id: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe('ID of the existing qualification type to update. Omit to create a new type.'),
+    name: zod_1.z.string().min(1).describe('Name of the qualification type'),
+})
+    .openapi({ title: 'UpsertQualificationType' });
+exports.UpdateQualificationSchema = zod_1.z
+    .object({
+    name: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('New name of the qualification'),
+    description: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('New description of the qualification'),
+    types: zod_1.z
+        .array(exports.UpsertQualificationTypeSchema)
+        .optional()
+        .describe('List of types to create, update, or associate with the qualification.'),
+})
+    .openapi({ title: 'UpdateQualification' });
+exports.UpdateQualificationTypeSchema = zod_1.z
+    .object({
+    name: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Name of the qualification type'),
+})
+    .openapi({ title: 'UpdateQualificationType' });
+exports.QualificationArraySchema = zod_1.z
+    .array(exports.QualificationSchema)
+    .openapi({ title: 'QualificationArray' });
+// --- Contract ---
+exports.qualificationsContract = c.router({
+    create: {
+        method: 'POST',
+        path: '/qualifications',
+        body: exports.CreateQualificationSchema,
+        responses: {
+            201: exports.QualificationSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Create a new qualification',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    findAll: {
+        method: 'GET',
+        path: '/qualifications',
+        responses: {
+            200: exports.QualificationArraySchema,
+        },
+        summary: 'Retrieve all qualifications',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    findOne: {
+        method: 'GET',
+        path: '/qualifications/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        responses: {
+            200: exports.QualificationSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Retrieve a qualification by ID',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    update: {
+        method: 'PATCH',
+        path: '/qualifications/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        body: exports.UpdateQualificationSchema,
+        responses: {
+            200: exports.QualificationSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Update an existing qualification',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    remove: {
+        method: 'DELETE',
+        path: '/qualifications/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        body: c.noBody(),
+        responses: {
+            204: zod_1.z.undefined(),
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Delete a qualification',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    createType: {
+        method: 'POST',
+        path: '/qualifications/:qualificationId/types',
+        pathParams: zod_1.z.object({
+            qualificationId: zod_1.z.string().uuid(),
+        }),
+        body: exports.CreateQualificationTypeSchema,
+        responses: {
+            201: exports.QualificationSchema, // Controller returns the parent Qualification
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Add a new type to a qualification',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    updateType: {
+        method: 'PATCH',
+        path: '/qualifications/types/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        body: exports.UpdateQualificationTypeSchema,
+        responses: {
+            200: exports.QualificationTypeSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Update an existing qualification type',
+        metadata: {
+            tags: ['Qualifications'],
+        },
+    },
+    removeType: {
+        method: 'DELETE',
+        path: '/qualifications/types/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        body: c.noBody(),
+        responses: {
+            204: zod_1.z.undefined(),
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Delete a qualification type',
+        metadata: {
+            tags: ['Qualifications Management'],
+        },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});