@dakkitor/api-contracts 1.1.154 → 1.5.0

package/dist/common/pagination-query.schema.spec.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const dashboard_widgets_contract_1 = require("../dashboards/dashboard-widgets.contract");
+const user_access_grants_contract_1 = require("../user-access-grants/user-access-grants.contract");
+const pagination_query_schema_1 = require("./pagination-query.schema");
+describe('PaginationQuerySchema', () => {
+    it('defaults to page 1 / limit 50', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.parse({})).toEqual({ page: 1, limit: 50 });
+    });
+    it('coerces numeric strings from the query string', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.parse({ page: '2', limit: '25' })).toEqual({
+            page: 2,
+            limit: 25,
+        });
+    });
+    it('accepts a limit exactly at the cap', () => {
+        // apps/bot getAllUsers() pages at exactly MAX_PAGE_SIZE over HTTP.
+        expect(pagination_query_schema_1.PaginationQuerySchema.parse({ limit: pagination_query_schema_1.MAX_PAGE_SIZE }).limit).toBe(pagination_query_schema_1.MAX_PAGE_SIZE);
+    });
+    it('rejects a limit above the cap', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ limit: pagination_query_schema_1.MAX_PAGE_SIZE + 1 }).success).toBe(false);
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ limit: 100000 }).success).toBe(false);
+    });
+    it('rejects a limit below 1', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ limit: 0 }).success).toBe(false);
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ limit: -5 }).success).toBe(false);
+    });
+    it('rejects a non-integer limit', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ limit: 2.5 }).success).toBe(false);
+    });
+    it('rejects page below 1, which would produce a negative SQL OFFSET', () => {
+        // Consumers compute `const skip = (page - 1) * limit`.
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ page: 0 }).success).toBe(false);
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ page: -1 }).success).toBe(false);
+    });
+    it('rejects a non-integer page', () => {
+        expect(pagination_query_schema_1.PaginationQuerySchema.safeParse({ page: 1.5 }).success).toBe(false);
+    });
+});
+describe('per-contract limit overrides', () => {
+    it('lets the admin agent-stats table ask for 1000 rows', () => {
+        expect(dashboard_widgets_contract_1.AllAgentsCallHistoryQuerySchema.parse({ limit: 1000 }).limit).toBe(1000);
+        expect(dashboard_widgets_contract_1.AllAgentsCallHistoryQuerySchema.safeParse({ limit: 1001 }).success).toBe(false);
+    });
+    it('lets the access-grants drawer ask for 300 grants', () => {
+        expect(user_access_grants_contract_1.UserAccessGrantListQuerySchema.parse({ limit: 300 }).limit).toBe(300);
+        expect(user_access_grants_contract_1.UserAccessGrantListQuerySchema.safeParse({ limit: 301 }).success).toBe(false);
+    });
+    it('still floors page at 1 on the overriding contracts', () => {
+        expect(dashboard_widgets_contract_1.AllAgentsCallHistoryQuerySchema.safeParse({ page: 0 }).success).toBe(false);
+        expect(user_access_grants_contract_1.UserAccessGrantListQuerySchema.safeParse({ page: 0 }).success).toBe(false);
+    });
+});

package/dist/companies/companies.contract.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import { AutocompleteQuerySchema } from '../common/common-schemas';
-declare const CompanySortableFieldsSchema: z.ZodEnum<["name", "createdAt", "updatedAt"]>;
+export declare const CompanySortableFieldsSchema: z.ZodEnum<["name", "createdAt", "updatedAt"]>;
+/** Maps sort field values to ability field paths on SortCompanySchema. */
+export declare const CompanySortFieldMapping: Record<string, string>;
 export type CompanySortableFields = z.infer<typeof CompanySortableFieldsSchema>;
 export declare const CompanySchema: z.ZodObject<{
     id: z.ZodString;
@@ -37,20 +39,32 @@ export declare const FilterCompanySchema: z.ZodObject<{
     page: z.ZodDefault<z.ZodNumber>;
 } & {
     name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    sortBy: z.ZodNullable<z.ZodOptional<z.ZodEnum<["name", "createdAt", "updatedAt"]>>>;
-    sortOrder: z.ZodNullable<z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>>;
+    sort: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodEnum<["name", "createdAt", "updatedAt"]>;
+        order: z.ZodEnum<["ASC", "DESC"]>;
+    }, "strip", z.ZodTypeAny, {
+        field: "name" | "createdAt" | "updatedAt";
+        order: "ASC" | "DESC";
+    }, {
+        field: "name" | "createdAt" | "updatedAt";
+        order: "ASC" | "DESC";
+    }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     limit: number;
     page: number;
+    sort?: {
+        field: "name" | "createdAt" | "updatedAt";
+        order: "ASC" | "DESC";
+    }[] | null | undefined;
     name?: string | null | undefined;
-    sortBy?: "name" | "createdAt" | "updatedAt" | null | undefined;
-    sortOrder?: "ASC" | "DESC" | null | undefined;
 }, {
-    name?: string | null | undefined;
     limit?: number | undefined;
     page?: number | undefined;
-    sortBy?: "name" | "createdAt" | "updatedAt" | null | undefined;
-    sortOrder?: "ASC" | "DESC" | null | undefined;
+    sort?: {
+        field: "name" | "createdAt" | "updatedAt";
+        order: "ASC" | "DESC";
+    }[] | null | undefined;
+    name?: string | null | undefined;
 }>;
 export declare const CompanyAutocompleteResponseSchema: z.ZodObject<{
     id: z.ZodString;
@@ -290,32 +304,44 @@ export declare const companiesContractRouter: {
         };
     };
     findAll: {
+        metadata: {
+            tags: string[];
+            openApi: {
+                operationId: string;
+            };
+        };
         query: z.ZodObject<{
             limit: z.ZodDefault<z.ZodNumber>;
             page: z.ZodDefault<z.ZodNumber>;
         } & {
             name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-            sortBy: z.ZodNullable<z.ZodOptional<z.ZodEnum<["name", "createdAt", "updatedAt"]>>>;
-            sortOrder: z.ZodNullable<z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>>;
+            sort: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field: z.ZodEnum<["name", "createdAt", "updatedAt"]>;
+                order: z.ZodEnum<["ASC", "DESC"]>;
+            }, "strip", z.ZodTypeAny, {
+                field: "name" | "createdAt" | "updatedAt";
+                order: "ASC" | "DESC";
+            }, {
+                field: "name" | "createdAt" | "updatedAt";
+                order: "ASC" | "DESC";
+            }>, "many">>>;
         }, "strip", z.ZodTypeAny, {
             limit: number;
             page: number;
+            sort?: {
+                field: "name" | "createdAt" | "updatedAt";
+                order: "ASC" | "DESC";
+            }[] | null | undefined;
             name?: string | null | undefined;
-            sortBy?: "name" | "createdAt" | "updatedAt" | null | undefined;
-            sortOrder?: "ASC" | "DESC" | null | undefined;
         }, {
-            name?: string | null | undefined;
             limit?: number | undefined;
             page?: number | undefined;
-            sortBy?: "name" | "createdAt" | "updatedAt" | null | undefined;
-            sortOrder?: "ASC" | "DESC" | null | undefined;
+            sort?: {
+                field: "name" | "createdAt" | "updatedAt";
+                order: "ASC" | "DESC";
+            }[] | null | undefined;
+            name?: string | null | undefined;
         }>;
-        metadata: {
-            tags: string[];
-            openApi: {
-                operationId: string;
-            };
-        };
         summary: "Get all companies";
         method: "GET";
         path: "/v2/companies";
@@ -470,6 +496,12 @@ export declare const companiesContractRouter: {
         };
     };
     autocomplete: {
+        metadata: {
+            tags: string[];
+            openApi: {
+                operationId: string;
+            };
+        };
         query: z.ZodObject<{
             query: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
@@ -480,12 +512,6 @@ export declare const companiesContractRouter: {
             id?: string | undefined;
             query?: string | undefined;
         }>;
-        metadata: {
-            tags: string[];
-            openApi: {
-                operationId: string;
-            };
-        };
         summary: "Get companies for autocomplete";
         method: "GET";
         path: "/v2/companies/autocomplete";
@@ -1104,5 +1130,4 @@ export declare const companiesContractRouter: {
         };
     };
 };
-export {};
 //# sourceMappingURL=companies.contract.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"companies.contract.d.ts","sourceRoot":"","sources":["../../contracts/companies/companies.contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAOlC,QAAA,MAAM,2BAA2B,+CAEa,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAWxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;EAIM,CAAC;AAEvC,eAAO,MAAM,mBAAmB;;;;;;EAIM,CAAC;AAEvC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;EAY9B,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;EAKF,CAAC;AAE7C,eAAO,MAAM,8BAA8B;;;;;;;;;WAEM,CAAC;AAElD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIM,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC/E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGnC,CAAC"}
+{"version":3,"file":"companies.contract.d.ts","sourceRoot":"","sources":["../../contracts/companies/companies.contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAOlC,eAAO,MAAM,2BAA2B,+CAEM,CAAC;AAE/C,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI1D,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAWxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;EAIM,CAAC;AAEvC,eAAO,MAAM,mBAAmB;;;;;;EAIM,CAAC;AAEvC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;EAKF,CAAC;AAE7C,eAAO,MAAM,8BAA8B;;;;;;;;;WAEM,CAAC;AAElD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIM,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC/E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGnC,CAAC"}

package/dist/companies/companies.contract.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.companiesContractRouter = exports.CompaniesPaginatedResponseSchema = exports.CompanyAutocompleteArraySchema = exports.CompanyAutocompleteResponseSchema = exports.FilterCompanySchema = exports.UpdateCompanySchema = exports.CreateCompanySchema = exports.CompanySchema = void 0;
+exports.companiesContractRouter = exports.CompaniesPaginatedResponseSchema = exports.CompanyAutocompleteArraySchema = exports.CompanyAutocompleteResponseSchema = exports.FilterCompanySchema = exports.UpdateCompanySchema = exports.CreateCompanySchema = exports.CompanySchema = exports.CompanySortFieldMapping = exports.CompanySortableFieldsSchema = void 0;
 const zod_openapi_1 = require("@anatine/zod-openapi");
 const core_1 = require("@ts-rest/core");
 const zod_1 = require("zod");
@@ -9,9 +9,15 @@ 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");
 (0, zod_openapi_1.extendZodWithOpenApi)(zod_1.z);
-const CompanySortableFieldsSchema = zod_1.z
+exports.CompanySortableFieldsSchema = zod_1.z
     .enum(['name', 'createdAt', 'updatedAt'])
     .openapi({ title: 'CompanySortableFields' });
+/** Maps sort field values to ability field paths on SortCompanySchema. */
+exports.CompanySortFieldMapping = {
+    name: 'name',
+    createdAt: 'createdAt',
+    updatedAt: 'updatedAt',
+};
 exports.CompanySchema = zod_1.z.object({
     id: zod_1.z.string().uuid().describe('Company ID'),
     name: zod_1.z.string().describe('Company Name'),
@@ -26,12 +32,12 @@ exports.CompanySchema = zod_1.z.object({
 });
 exports.CreateCompanySchema = zod_1.z
     .object({
-    name: zod_1.z.string().max(255).describe('Company Name'),
+    name: zod_1.z.string().trim().max(255).describe('Company Name'),
 })
     .openapi({ title: 'CreateCompany' });
 exports.UpdateCompanySchema = zod_1.z
     .object({
-    name: zod_1.z.string().max(255).optional().describe('Company Name'),
+    name: zod_1.z.string().trim().max(255).optional().describe('Company Name'),
 })
     .openapi({ title: 'UpdateCompany' });
 exports.FilterCompanySchema = pagination_query_schema_1.PaginationQuerySchema.extend({
@@ -40,12 +46,7 @@ exports.FilterCompanySchema = pagination_query_schema_1.PaginationQuerySchema.ex
         .optional()
         .nullable()
         .describe('Filter by company name (case-insensitive contains match)'),
-    sortBy: CompanySortableFieldsSchema.optional()
-        .nullable()
-        .describe('The field to sort the results by.'),
-    sortOrder: common_schemas_1.SortOrderSchema.optional()
-        .nullable()
-        .describe('The order to sort the results by.'),
+    sort: (0, common_schemas_1.createSortArraySchema)(exports.CompanySortableFieldsSchema),
 });
 exports.CompanyAutocompleteResponseSchema = zod_1.z
     .object({