@dakkitor/api-contracts 1.1.9 → 1.1.11

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

@@ -0,0 +1 @@
+{"version":3,"file":"locations.contract.d.ts","sourceRoot":"","sources":["../../contracts/locations/locations.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAUhE,eAAO,MAAM,mBAAmB,uDAEG,CAAC;AAEpC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDM,CAAC;AAGlC,eAAO,MAAM,oBAAoB;;;;;;;;;EAAuB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;EAE/B,CAAC;AAIH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAIhC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF7B,CAAC"}

package/dist/locations/locations.contract.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locationsContract = exports.CreateLocationSchema = exports.FilterLocationSchema = exports.UpdateLocationSchema = exports.LocationSchema = exports.PostcodeLevelSchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const common_schemas_1 = require("../common/common-schemas");
+Object.defineProperty(exports, "CreateLocationSchema", { enumerable: true, get: function () { return common_schemas_1.CreateLocationSchema; } });
+const error_schemas_1 = require("../common/error-schemas");
+const pagination_query_schema_1 = require("../common/pagination-query.schema");
+const pagination_schema_1 = require("../common/pagination.schema");
+const c = (0, core_1.initContract)();
+// --- Schemas ---
+// PostcodeLevel enum - matches the TypeORM enum
+exports.PostcodeLevelSchema = zod_1.z
+    .enum(['POSTCODE', 'SECTOR', 'DISTRICT', 'AREA'])
+    .describe('Type of the location');
+exports.LocationSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid().describe('Unique identifier for the location'),
+    address: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('The specific address line'),
+    type: exports.PostcodeLevelSchema,
+    postcode: zod_1.z.string().optional().describe('The postcode or relevant part'),
+    county: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('County associated with the postcode'),
+    adminDistrict: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Administrative district'),
+    builtUpArea: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Built-up area description'),
+    postTown: zod_1.z.string().nullable().optional().describe('Primary post town'),
+    areaCovered: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Description of the area covered'),
+    country: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Country associated with the postcode'),
+    region: zod_1.z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Region associated with the postcode'),
+    createdAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .describe('Creation timestamp'),
+    updatedAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .describe('Last update timestamp'),
+})
+    .openapi({ title: 'Location' });
+// Reuse CreateLocationSchema from common-schemas
+exports.UpdateLocationSchema = common_schemas_1.CreateLocationSchema;
+exports.FilterLocationSchema = pagination_query_schema_1.PaginationQuerySchema.openapi({
+    title: 'FilterLocation',
+});
+// --- Contract ---
+exports.locationsContract = c.router({
+    create: {
+        method: 'POST',
+        path: '/locations',
+        body: common_schemas_1.CreateLocationSchema,
+        responses: {
+            201: exports.LocationSchema,
+        },
+        summary: 'Create a new location',
+        metadata: {
+            tags: ['Locations'],
+        },
+    },
+    findAll: {
+        method: 'GET',
+        path: '/locations',
+        query: exports.FilterLocationSchema,
+        responses: {
+            200: (0, pagination_schema_1.createPaginatedResponseSchema)(exports.LocationSchema),
+        },
+        summary: 'Get all locations',
+        metadata: {
+            tags: ['Locations'],
+        },
+    },
+    findOne: {
+        method: 'GET',
+        path: '/locations/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        responses: {
+            200: exports.LocationSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Get a location by ID',
+        metadata: {
+            tags: ['Locations'],
+        },
+    },
+    update: {
+        method: 'PATCH',
+        path: '/locations/:id',
+        pathParams: zod_1.z.object({
+            id: zod_1.z.string().uuid(),
+        }),
+        body: exports.UpdateLocationSchema,
+        responses: {
+            200: exports.LocationSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Update a location by ID',
+        metadata: {
+            tags: ['Locations'],
+        },
+    },
+    remove: {
+        method: 'DELETE',
+        path: '/locations/: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 location by ID',
+        metadata: {
+            tags: ['Locations'],
+        },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

package/dist/postcodes/postcodes.contract.d.ts

@@ -0,0 +1,370 @@
+import { z } from 'zod';
+export declare const PostcodeAutocompleteQuerySchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    query?: string | undefined;
+}, {
+    id?: string | undefined;
+    query?: string | undefined;
+}>;
+export declare const PostcodeAutocompleteResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    id: string;
+}, {
+    code: string;
+    id: string;
+}>;
+export declare const PostcodeSearchQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+} & {
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const PostcodeSearchResultSchema: z.ZodObject<{
+    code: z.ZodString;
+    type: z.ZodEnum<["area", "district", "sector", "postcode"]>;
+    description: z.ZodOptional<z.ZodString>;
+    relevance: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "postcode" | "area" | "district" | "sector";
+    relevance: number;
+    description?: string | undefined;
+}, {
+    code: string;
+    type: "postcode" | "area" | "district" | "sector";
+    relevance: number;
+    description?: string | undefined;
+}>;
+export declare const PostcodeAutocompleteArraySchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    id: string;
+}, {
+    code: string;
+    id: string;
+}>, "many">;
+export type PostcodeAutocompleteQuery = z.infer<typeof PostcodeAutocompleteQuerySchema>;
+export type PostcodeAutocompleteResponse = z.infer<typeof PostcodeAutocompleteResponseSchema>;
+export type PostcodeAutocompleteArray = z.infer<typeof PostcodeAutocompleteArraySchema>;
+export type PostcodeSearchQuery = z.infer<typeof PostcodeSearchQuerySchema>;
+export type PostcodeSearchResult = z.infer<typeof PostcodeSearchResultSchema>;
+export declare const postcodesContract: {
+    autocomplete: {
+        metadata: {
+            tags: string[];
+        };
+        query: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id?: string | undefined;
+            query?: string | undefined;
+        }, {
+            id?: string | undefined;
+            query?: string | undefined;
+        }>;
+        summary: "Get postcodes for autocomplete";
+        method: "GET";
+        path: "/v1/postcodes/autocomplete";
+        responses: {
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                id: string;
+            }, {
+                code: string;
+                id: string;
+            }>, "many">;
+        };
+    };
+    search: {
+        metadata: {
+            tags: string[];
+        };
+        query: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodNumber>;
+            page: z.ZodDefault<z.ZodNumber>;
+        } & {
+            query: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            page: number;
+            query: string;
+        }, {
+            query: string;
+            limit?: number | undefined;
+            page?: number | undefined;
+        }>;
+        summary: "Search postcodes";
+        method: "GET";
+        path: "/v1/postcodes/search";
+        responses: {
+            400: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            401: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            403: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            500: z.ZodObject<{
+                statusCode: z.ZodNumber;
+                message: z.ZodString;
+                code: z.ZodString;
+                details: z.ZodOptional<z.ZodUnknown>;
+                timestamp: z.ZodString;
+                path: z.ZodString;
+                correlationId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }, {
+                code: string;
+                path: string;
+                message: string;
+                statusCode: number;
+                timestamp: string;
+                details?: unknown;
+                correlationId?: string | undefined;
+            }>;
+            200: z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    code: z.ZodString;
+                    type: z.ZodEnum<["area", "district", "sector", "postcode"]>;
+                    description: z.ZodOptional<z.ZodString>;
+                    relevance: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    code: string;
+                    type: "postcode" | "area" | "district" | "sector";
+                    relevance: number;
+                    description?: string | undefined;
+                }, {
+                    code: string;
+                    type: "postcode" | "area" | "district" | "sector";
+                    relevance: number;
+                    description?: string | undefined;
+                }>, "many">;
+                totalCount: z.ZodNumber;
+                limit: z.ZodNumber;
+                skip: z.ZodNumber;
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                limit: number;
+                items: {
+                    code: string;
+                    type: "postcode" | "area" | "district" | "sector";
+                    relevance: number;
+                    description?: string | undefined;
+                }[];
+                totalCount: number;
+                skip: number;
+                currentPage: number;
+                totalPages: number;
+            }, {
+                limit: number;
+                items: {
+                    code: string;
+                    type: "postcode" | "area" | "district" | "sector";
+                    relevance: number;
+                    description?: string | undefined;
+                }[];
+                totalCount: number;
+                skip: number;
+                currentPage: number;
+                totalPages: number;
+            }>;
+        };
+    };
+};
+//# sourceMappingURL=postcodes.contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postcodes.contract.d.ts","sourceRoot":"","sources":["../../contracts/postcodes/postcodes.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,+BAA+B;;;;;;;;;EAaM,CAAC;AAEnD,eAAO,MAAM,kCAAkC;;;;;;;;;EAKM,CAAC;AAEtD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;EAKM,CAAC;AAE7C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAYM,CAAC;AAE9C,eAAO,MAAM,+BAA+B;;;;;;;;;WAEM,CAAC;AAInD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC7B,CAAC"}

package/dist/postcodes/postcodes.contract.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postcodesContract = exports.PostcodeAutocompleteArraySchema = exports.PostcodeSearchResultSchema = exports.PostcodeSearchQuerySchema = exports.PostcodeAutocompleteResponseSchema = exports.PostcodeAutocompleteQuerySchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const pagination_query_schema_1 = require("../common/pagination-query.schema");
+const pagination_schema_1 = require("../common/pagination.schema");
+const c = (0, core_1.initContract)();
+// --- Schemas ---
+exports.PostcodeAutocompleteQuerySchema = zod_1.z
+    .object({
+    query: zod_1.z
+        .string()
+        .optional()
+        .describe('Search query string to filter postcodes'),
+    id: zod_1.z
+        .string()
+        .optional()
+        .describe('Specific postcode ID to include in results (validates UK postcode format)'),
+})
+    .openapi({ title: 'PostcodeAutocompleteQuery' });
+exports.PostcodeAutocompleteResponseSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().describe('The unique identifier of the postcode.'),
+    code: zod_1.z.string().describe('The postcode code.'),
+})
+    .openapi({ title: 'PostcodeAutocompleteResponse' });
+exports.PostcodeSearchQuerySchema = pagination_query_schema_1.PaginationQuerySchema.extend({
+    query: zod_1.z
+        .string()
+        .min(1)
+        .describe('Search query for postcode or part of postcode'),
+}).openapi({ title: 'PostcodeSearchQuery' });
+exports.PostcodeSearchResultSchema = zod_1.z
+    .object({
+    code: zod_1.z.string().describe('Postcode code or identifier'),
+    type: zod_1.z
+        .enum(['area', 'district', 'sector', 'postcode'])
+        .describe('Type of postcode entity'),
+    description: zod_1.z
+        .string()
+        .optional()
+        .describe('Additional information about the postcode'),
+    relevance: zod_1.z.number().describe('Relevance score for the search result'),
+})
+    .openapi({ title: 'PostcodeSearchResult' });
+exports.PostcodeAutocompleteArraySchema = zod_1.z
+    .array(exports.PostcodeAutocompleteResponseSchema)
+    .openapi({ title: 'PostcodeAutocompleteArray' });
+// --- Contract ---
+exports.postcodesContract = c.router({
+    autocomplete: {
+        method: 'GET',
+        path: '/postcodes/autocomplete',
+        query: exports.PostcodeAutocompleteQuerySchema,
+        responses: {
+            200: exports.PostcodeAutocompleteArraySchema,
+        },
+        summary: 'Get postcodes for autocomplete',
+        metadata: {
+            tags: ['Postcodes'],
+        },
+    },
+    search: {
+        method: 'GET',
+        path: '/postcodes/search',
+        query: exports.PostcodeSearchQuerySchema,
+        responses: {
+            200: (0, pagination_schema_1.createPaginatedResponseSchema)(exports.PostcodeSearchResultSchema),
+        },
+        summary: 'Search postcodes',
+        metadata: {
+            tags: ['Postcodes'],
+        },
+    },
+}, {
+    pathPrefix: '/v1', // Keeping v1 as per controller, but usually we migrate to v2.
+    // Wait, the guideline says "Versioning: Use pathPrefix ... (e.g., pathPrefix: '/v2')".
+    // The existing controller is @Controller('v1/postcodes').
+    // I should probably use /v2 for the new controller to avoid conflict if I mount it alongside.
+    // But the goal is migration.
+    // Let's stick to /v2 for the new contract to be safe and consistent with other migrations.
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});