@dakkitor/api-contracts 1.1.130 → 1.1.131

package/dist/own-research/own-research.contract.d.ts.map

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

package/dist/own-research/own-research.contract.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Project: Internal Recruitment Platform API
+ * File: own-research.contract.ts
+ *
+ * Description: Contract definition for Own Research API - allows agents to add and call their own leads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownResearchContract = exports.AgentInfoResponseSchema = exports.AddOwnResearchLeadResponseSchema = exports.AddOwnResearchLeadSchema = exports.RecordOwnResearchCallResponseSchema = exports.RecordOwnResearchCallSchema = exports.CheckPhoneRequestSchema = exports.CheckPhoneResponseSchema = exports.OwnResearchLeadSchema = void 0;
+const zod_openapi_1 = require("@anatine/zod-openapi");
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const call_rating_schema_1 = require("../common/call-rating.schema");
+const common_schemas_1 = require("../common/common-schemas");
+const error_schemas_1 = require("../common/error-schemas");
+const lead_assignments_contract_1 = require("../lead-assignments/lead-assignments.contract");
+(0, zod_openapi_1.extendZodWithOpenApi)(zod_1.z);
+const c = (0, core_1.initContract)();
+// Schemas
+exports.OwnResearchLeadSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid().describe("Own research lead ID"),
+    agentId: zod_1.z.string().uuid().describe("Agent who owns this lead"),
+    name: zod_1.z.string().describe("Lead contact name"),
+    phoneNumber: zod_1.z.string().describe("Lead phone number"),
+    source: zod_1.z.string().describe("Lead source"),
+    status: zod_1.z.string().describe("Lead status"),
+    callCount: zod_1.z.number().int().describe("Number of calls made"),
+    lastCalledAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .nullable()
+        .describe("Last call date"),
+    cooldownUntil: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .nullable()
+        .describe("Cooldown expiry date"),
+    blacklistReason: zod_1.z.string().nullable().describe("Blacklist reason"),
+    existsInLeadsTable: zod_1.z
+        .boolean()
+        .describe("Whether this lead also exists in the main leads table"),
+    originalLeadId: zod_1.z
+        .string()
+        .uuid()
+        .nullable()
+        .describe("ID of the matching lead in the main leads table"),
+    createdAt: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .describe("Creation date"),
+    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 date"),
+})
+    .openapi({ title: "OwnResearchLead" });
+exports.CheckPhoneResponseSchema = zod_1.z
+    .object({
+    existsInLeads: zod_1.z
+        .boolean()
+        .describe("Whether the phone number exists in the main leads table"),
+    existsInOwnResearch: zod_1.z
+        .boolean()
+        .describe("Whether the phone number exists in the agent's own research leads"),
+    lead: zod_1.z
+        .object({
+        id: zod_1.z.string().uuid(),
+        name: zod_1.z.string(),
+        phoneNumber: zod_1.z.string(),
+        status: zod_1.z.string(),
+        cooldownUntil: zod_1.z
+            .union([zod_1.z.string().datetime(), zod_1.z.date()])
+            .transform((val) => (val instanceof Date ? val.toISOString() : val))
+            .nullable(),
+    })
+        .nullable()
+        .optional()
+        .describe("Existing lead from the main leads table"),
+    ownResearchLead: exports.OwnResearchLeadSchema.nullable()
+        .optional()
+        .describe("Existing lead from the agent's own research"),
+    isOnCooldown: zod_1.z
+        .boolean()
+        .describe("Whether the lead is currently on cooldown"),
+    cooldownUntil: zod_1.z
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((val) => (val instanceof Date ? val.toISOString() : val))
+        .nullable()
+        .describe("Cooldown expiry date if on cooldown"),
+})
+    .openapi({ title: "CheckPhoneResponse" });
+exports.CheckPhoneRequestSchema = zod_1.z
+    .object({
+    phoneNumber: zod_1.z.string().min(1).max(20).describe("Phone number to check"),
+})
+    .openapi({ title: "CheckPhoneRequest" });
+exports.RecordOwnResearchCallSchema = zod_1.z
+    .object({
+    phoneNumber: common_schemas_1.PhoneSchema.describe("Lead phone number"),
+    name: zod_1.z.string().min(1).max(255).describe("Lead contact name"),
+    rating: call_rating_schema_1.CallRatingSchema.describe("Call rating"),
+    notes: zod_1.z
+        .string()
+        .max(1000)
+        .optional()
+        .describe("Optional notes about the call"),
+})
+    .openapi({ title: "RecordOwnResearchCall" });
+exports.RecordOwnResearchCallResponseSchema = zod_1.z
+    .object({
+    assignment: lead_assignments_contract_1.LeadAssignmentSchema.describe("The completed assignment"),
+    ownResearchLead: exports.OwnResearchLeadSchema.describe("The own research lead record"),
+})
+    .openapi({ title: "RecordOwnResearchCallResponse" });
+exports.AddOwnResearchLeadSchema = zod_1.z
+    .object({
+    phoneNumber: common_schemas_1.PhoneSchema.describe("Lead phone number"),
+    name: zod_1.z.string().min(1).max(255).describe("Lead contact name"),
+})
+    .openapi({ title: "AddOwnResearchLead" });
+exports.AddOwnResearchLeadResponseSchema = zod_1.z
+    .object({
+    ownResearchLead: exports.OwnResearchLeadSchema.describe("The created or existing own research lead record"),
+})
+    .openapi({ title: "AddOwnResearchLeadResponse" });
+exports.AgentInfoResponseSchema = zod_1.z
+    .object({
+    companyId: zod_1.z.string().uuid().nullable().describe("Agent's company ID"),
+    companyName: zod_1.z.string().nullable().describe("Agent's company name"),
+})
+    .openapi({ title: "AgentInfoResponse" });
+exports.ownResearchContract = c.router({
+    getAgentInfo: {
+        method: "GET",
+        path: "/own-research/agent-info",
+        responses: {
+            200: exports.AgentInfoResponseSchema,
+        },
+        summary: "Get the current agent's company info for own research",
+        metadata: {
+            tags: ["Own Research"],
+        },
+    },
+    checkPhone: {
+        method: "POST",
+        path: "/own-research/check-phone",
+        body: exports.CheckPhoneRequestSchema,
+        responses: {
+            200: exports.CheckPhoneResponseSchema,
+        },
+        summary: "Check if a phone number exists in leads or own research",
+        metadata: {
+            tags: ["Own Research"],
+        },
+    },
+    addLead: {
+        method: "POST",
+        path: "/own-research/leads",
+        body: exports.AddOwnResearchLeadSchema,
+        responses: {
+            201: exports.AddOwnResearchLeadResponseSchema,
+        },
+        summary: "Add a lead to own research without recording a call",
+        metadata: {
+            tags: ["Own Research"],
+        },
+    },
+    recordCall: {
+        method: "POST",
+        path: "/own-research/call",
+        body: exports.RecordOwnResearchCallSchema,
+        responses: {
+            201: exports.RecordOwnResearchCallResponseSchema,
+        },
+        summary: "Record an own research call (creates lead, assignment, and call history)",
+        metadata: {
+            tags: ["Own Research"],
+        },
+    },
+}, {
+    pathPrefix: "/v2",
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakkitor/api-contracts",
-  "version": "1.1.130",
+  "version": "1.1.131",
   "description": "TypeScript API contracts using ts-rest and Zod",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",