@deallony/shared 1.2.54 → 1.2.55

package/dist/cjs/dto/index.d.ts

@@ -4,3 +4,4 @@ export * as EVENTS from './events';
 export * as Ai from './ai/Ai.dto';
 export * as PAYMENTS from './payments';
 export * as ADDRESSES from './addresses/addresses.dto';
+export * as POTENTIAL_USERS from './potential-users/potential-user-import.dto';

package/dist/cjs/dto/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ADDRESSES = exports.PAYMENTS = exports.Ai = exports.EVENTS = exports.AD = exports.AdDto = void 0;
+exports.POTENTIAL_USERS = exports.ADDRESSES = exports.PAYMENTS = exports.Ai = exports.EVENTS = exports.AD = exports.AdDto = void 0;
 var Ad_dto_1 = require("./ad/Ad.dto");
 Object.defineProperty(exports, "AdDto", { enumerable: true, get: function () { return Ad_dto_1.AdDto; } });
 exports.AD = __importStar(require("./ad/Ad.dto"));
@@ -41,3 +41,4 @@ exports.EVENTS = __importStar(require("./events"));
 exports.Ai = __importStar(require("./ai/Ai.dto"));
 exports.PAYMENTS = __importStar(require("./payments"));
 exports.ADDRESSES = __importStar(require("./addresses/addresses.dto"));
+exports.POTENTIAL_USERS = __importStar(require("./potential-users/potential-user-import.dto"));

package/dist/cjs/dto/potential-users/potential-user-import.dto.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { PotentialUserImportContactSchema, PotentialUserImportResultSchema, PotentialUserImportSchema, PotentialUserSourceTypeSchema } from '../../schema/potential-users/potential-user-import.schema';
+export type PotentialUserSourceType = z.infer<typeof PotentialUserSourceTypeSchema>;
+export type PotentialUserImportContact = z.input<typeof PotentialUserImportContactSchema>;
+export type PotentialUserImport = z.input<typeof PotentialUserImportSchema>;
+export type PotentialUserImportResult = z.infer<typeof PotentialUserImportResultSchema>;

package/dist/cjs/dto/potential-users/potential-user-import.dto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/schema/communication/ai-conversation.schema.d.ts

@@ -6,8 +6,8 @@ export declare const MarketingSubjectTypeSchema: z.ZodEnum<{
     used_products: "used_products";
 }>;
 export declare const ConversationLanguageSchema: z.ZodEnum<{
-    en: "en";
     ar: "ar";
+    en: "en";
 }>;
 export declare const StartAiConversationSchema: z.ZodObject<{
     request_id: z.ZodString;
@@ -15,8 +15,8 @@ export declare const StartAiConversationSchema: z.ZodObject<{
     user_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     phone: z.ZodString;
     language: z.ZodDefault<z.ZodEnum<{
-        en: "en";
         ar: "ar";
+        en: "en";
     }>>;
     purpose: z.ZodLiteral<"marketing">;
     subject_type: z.ZodEnum<{

package/dist/cjs/schema/index.d.ts

@@ -5,3 +5,4 @@ export * as EVENTS from './events';
 export * as PAYMENTS from './payments';
 export * as COMMUNICATION from './communication';
 export * as ADDRESSES from './addresses/addresses.schema';
+export * as POTENTIAL_USERS from './potential-users';

package/dist/cjs/schema/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ADDRESSES = exports.COMMUNICATION = exports.PAYMENTS = exports.EVENTS = exports.COMMON = exports.AI = exports.AD = void 0;
+exports.POTENTIAL_USERS = exports.ADDRESSES = exports.COMMUNICATION = exports.PAYMENTS = exports.EVENTS = exports.COMMON = exports.AI = exports.AD = void 0;
 exports.AD = __importStar(require("./ad"));
 exports.AI = __importStar(require("./ai"));
 exports.COMMON = __importStar(require("./common"));
@@ -41,3 +41,4 @@ exports.EVENTS = __importStar(require("./events"));
 exports.PAYMENTS = __importStar(require("./payments"));
 exports.COMMUNICATION = __importStar(require("./communication"));
 exports.ADDRESSES = __importStar(require("./addresses/addresses.schema"));
+exports.POTENTIAL_USERS = __importStar(require("./potential-users"));

package/dist/cjs/schema/potential-users/index.d.ts

@@ -0,0 +1 @@
+export * from './potential-user-import.schema';

package/dist/cjs/schema/potential-users/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./potential-user-import.schema"), exports);

package/dist/cjs/schema/potential-users/potential-user-import.schema.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+/** Where a potential user came from. One person can have several sources. */
+export declare const PotentialUserSourceTypeSchema: z.ZodEnum<{
+    employee: "employee";
+    qatayef_collect: "qatayef_collect";
+}>;
+/** Most contacts one import request may carry */
+export declare const POTENTIAL_USER_IMPORT_MAX_BATCH = 500;
+/** One contact found by an internal service, e.g. a phone collected from a website. */
+export declare const PotentialUserImportContactSchema: z.ZodObject<{
+    external_id: z.ZodString;
+    phone: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    website: z.ZodString;
+    source_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    subject_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        properties: "properties";
+        services: "services";
+        motors: "motors";
+        used_products: "used_products";
+    }>>>;
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const PotentialUserImportSchema: z.ZodObject<{
+    source_type: z.ZodDefault<z.ZodEnum<{
+        qatayef_collect: "qatayef_collect";
+    }>>;
+    contacts: z.ZodArray<z.ZodObject<{
+        external_id: z.ZodString;
+        phone: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        website: z.ZodString;
+        source_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        subject_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            properties: "properties";
+            services: "services";
+            motors: "motors";
+            used_products: "used_products";
+        }>>>;
+        data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const PotentialUserImportResultSchema: z.ZodObject<{
+    external_id: z.ZodString;
+    status: z.ZodEnum<{
+        created: "created";
+        updated: "updated";
+        skipped: "skipped";
+    }>;
+    potential_user_id: z.ZodNullable<z.ZodNumber>;
+    reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;

package/dist/cjs/schema/potential-users/potential-user-import.schema.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PotentialUserImportResultSchema = exports.PotentialUserImportSchema = exports.PotentialUserImportContactSchema = exports.POTENTIAL_USER_IMPORT_MAX_BATCH = exports.PotentialUserSourceTypeSchema = void 0;
+const zod_1 = require("zod");
+const ai_conversation_schema_1 = require("../communication/ai-conversation.schema");
+/** Where a potential user came from. One person can have several sources. */
+exports.PotentialUserSourceTypeSchema = zod_1.z.enum(['employee', 'qatayef_collect']);
+/** Most contacts one import request may carry */
+exports.POTENTIAL_USER_IMPORT_MAX_BATCH = 500;
+/** One contact found by an internal service, e.g. a phone collected from a website. */
+exports.PotentialUserImportContactSchema = zod_1.z.object({
+    /** The caller's own ID for this contact, echoed back in the result */
+    external_id: zod_1.z.string().trim().min(1).max(100),
+    /** E.164, e.g. +971501234567 */
+    phone: zod_1.z.string().trim().regex(/^\+[1-9]\d{6,14}$/, 'phone must be in E.164 format'),
+    name: zod_1.z.string().trim().max(255).nullish(),
+    /** The website the contact was found on, e.g. dubizzle.com; one source per website */
+    website: zod_1.z.string().trim().min(1).max(253),
+    source_url: zod_1.z.string().trim().url().max(2048).nullish(),
+    subject_type: ai_conversation_schema_1.MarketingSubjectTypeSchema.nullish(),
+    /** Fields without a column (email, price, listing title, listings count, ...) */
+    data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+});
+exports.PotentialUserImportSchema = zod_1.z.object({
+    source_type: exports.PotentialUserSourceTypeSchema.exclude(['employee']).default('qatayef_collect'),
+    contacts: zod_1.z.array(exports.PotentialUserImportContactSchema).min(1).max(exports.POTENTIAL_USER_IMPORT_MAX_BATCH),
+});
+exports.PotentialUserImportResultSchema = zod_1.z.object({
+    external_id: zod_1.z.string(),
+    status: zod_1.z.enum(['created', 'updated', 'skipped']),
+    potential_user_id: zod_1.z.number().int().positive().nullable(),
+    /** Why the contact was skipped */
+    reason: zod_1.z.string().nullable(),
+});

package/dist/cjs/types/user/PotentialUser.d.ts

@@ -1,3 +1,23 @@
+import type { PotentialUserSourceType } from "../../dto/potential-users/potential-user-import.dto";
+/**
+ * One way a potential user reached the list: an employee, or a website a service found it on.
+ * Stored in the potential user's `sources` JSON, one entry per source_key.
+ */
+export type IPotentialUserSource = {
+    source_type: PotentialUserSourceType;
+    /** What makes the source unique: "employee:<id>" or "website:<domain>" */
+    source_key: string;
+    /** The employee who added it, for "employee" sources */
+    employee_id?: number | null;
+    /** The internal service that reported it, e.g. "qatayef-collect" */
+    service_name?: string | null;
+    website?: string | null;
+    source_url?: string | null;
+    external_id?: string | null;
+    name_seen?: string | null;
+    first_seen_at: string;
+    last_seen_at: string;
+};
 export type IPotentialUser = {
     id: number;
     name?: string;
@@ -26,6 +46,13 @@ export type IPotentialUser = {
     last_conversation_id?: string | null;
     last_ai_summary?: string | null;
     is_blocked?: boolean;
+    /** Distinct sources (websites and employees) that added this phone */
+    added_count?: number | null;
+    first_source?: PotentialUserSourceType | null;
+    last_added_at?: string | null;
+    /** Fields without a column, merged from every source */
+    extra_data?: Record<string, unknown> | null;
+    sources?: IPotentialUserSource[] | null;
 };
 export type CreatePotentialUserDto = {
     name?: string;

package/dist/esm/dto/index.js

@@ -4,3 +4,4 @@ export * as EVENTS from './events/index.js';
 export * as Ai from './ai/Ai.dto.js';
 export * as PAYMENTS from './payments/index.js';
 export * as ADDRESSES from './addresses/addresses.dto.js';
+export * as POTENTIAL_USERS from './potential-users/potential-user-import.dto.js';

package/dist/esm/dto/potential-users/potential-user-import.dto.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/schema/index.js

@@ -5,3 +5,4 @@ export * as EVENTS from './events/index.js';
 export * as PAYMENTS from './payments/index.js';
 export * as COMMUNICATION from './communication/index.js';
 export * as ADDRESSES from './addresses/addresses.schema.js';
+export * as POTENTIAL_USERS from './potential-users/index.js';

package/dist/esm/schema/potential-users/index.js

@@ -0,0 +1 @@
+export * from './potential-user-import.schema.js';

package/dist/esm/schema/potential-users/potential-user-import.schema.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { MarketingSubjectTypeSchema } from '../communication/ai-conversation.schema.js';
+/** Where a potential user came from. One person can have several sources. */
+export const PotentialUserSourceTypeSchema = z.enum(['employee', 'qatayef_collect']);
+/** Most contacts one import request may carry */
+export const POTENTIAL_USER_IMPORT_MAX_BATCH = 500;
+/** One contact found by an internal service, e.g. a phone collected from a website. */
+export const PotentialUserImportContactSchema = z.object({
+    /** The caller's own ID for this contact, echoed back in the result */
+    external_id: z.string().trim().min(1).max(100),
+    /** E.164, e.g. +971501234567 */
+    phone: z.string().trim().regex(/^\+[1-9]\d{6,14}$/, 'phone must be in E.164 format'),
+    name: z.string().trim().max(255).nullish(),
+    /** The website the contact was found on, e.g. dubizzle.com; one source per website */
+    website: z.string().trim().min(1).max(253),
+    source_url: z.string().trim().url().max(2048).nullish(),
+    subject_type: MarketingSubjectTypeSchema.nullish(),
+    /** Fields without a column (email, price, listing title, listings count, ...) */
+    data: z.record(z.string(), z.unknown()).default({}),
+});
+export const PotentialUserImportSchema = z.object({
+    source_type: PotentialUserSourceTypeSchema.exclude(['employee']).default('qatayef_collect'),
+    contacts: z.array(PotentialUserImportContactSchema).min(1).max(POTENTIAL_USER_IMPORT_MAX_BATCH),
+});
+export const PotentialUserImportResultSchema = z.object({
+    external_id: z.string(),
+    status: z.enum(['created', 'updated', 'skipped']),
+    potential_user_id: z.number().int().positive().nullable(),
+    /** Why the contact was skipped */
+    reason: z.string().nullable(),
+});

package/package.json

@@ -1,58 +1,59 @@
-{
-    "name": "@deallony/shared",
-    "version": "1.2.54",
-    "private": false,
-    "main": "dist/cjs/index.js",
-    "module": "dist/esm/index.js",
-    "react-native": "dist/esm/index.js",
-    "types": "dist/cjs/index.d.ts",
-    "sideEffects": false,
-    "exports": {
-        ".": {
-            "require": "./dist/cjs/index.js",
-            "import": "./dist/esm/index.js",
-            "types": "./dist/cjs/index.d.ts"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "deploy": "node ./scripts/publish.js npm patch",
-        "=========": "============= UPDATE APPS LIBRARY =============",
-        "all:update": "npm run mobile:update && npm run backend:update && npm run dashboard:update && npm run whatsapp:update",
-        "mobile:update": "cd ../app && npm run upgrade:deallony:shared",
-        "backend:update": "cd ../backend-service-marketplace && pnpm install gitlab:qatayef-tech-aloo/deallony-development/shared-deallony",
-        "dashboard:update": "cd ../frontend-react-aloo && pnpm install gitlab:qatayef-tech-aloo/deallony-development/shared-deallony",
-        "whatsapp:update": "cd ../backend-nest-whatsapp-service-aloo && pnpm install gitlab:qatayef-tech-aloo/deallony-development/shared-deallony",
-        "current": "node -p \"require('./package.json').version\"",
-        "============================= Links with project =============================": "",
-        "link:backend": "cd ../backend-service-marketplace && pnpm add @deallony/shared@file:../shared-deallony",
-        "link:dashboard": "cd ../frontend-react-aloo && pnpm add @deallony/shared@file:../shared-deallony",
-        "link:mobile": "cd ../app && npm install ../shared-deallony",
-        "========": "============ DEFAULT ============",
-        "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node ./scripts/fix-esm-imports.mjs",
-        "watch": "tsc -p tsconfig.cjs.json --watch",
-        "deploy:patch": "node ./scripts/publish.js npm patch",
-        "deploy:minor": "node ./scripts/publish.js npm minor",
-        "deploy:major": "node ./scripts/publish.js npm major",
-        "deploy:dry-run": "node ./scripts/publish.js npm patch --dry-run",
-        "deploy:git": "node ./scripts/publish.js git patch",
-        "deploy:git:minor": "node ./scripts/publish.js git minor",
-        "deploy:git:major": "node ./scripts/publish.js git major",
-        "deploy:git:dry-run": "node ./scripts/publish.js git patch --dry-run",
-        "test:release": "node --test scripts/publish.test.js",
-        "prepublishOnly": "npm run build"
-    },
-    "dependencies": {
-        "zod": "^4.2.1"
-    },
-    "devDependencies": {
-        "@types/node": "^25.0.3",
-        "typescript": "^5.9.3"
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/",
-        "access": "public"
-    }
-}
+{
+    "name": "@deallony/shared",
+    "version": "1.2.55",
+    "private": false,
+    "main": "dist/cjs/index.js",
+    "module": "dist/esm/index.js",
+    "react-native": "dist/esm/index.js",
+    "types": "dist/cjs/index.d.ts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "require": "./dist/cjs/index.js",
+            "import": "./dist/esm/index.js",
+            "types": "./dist/cjs/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "deploy": "node ./scripts/publish.js npm patch",
+        "=========": "============= UPDATE APPS LIBRARY =============",
+        "all:update": "npm run mobile:update && npm run backend:update && npm run dashboard:update && npm run whatsapp:update && npm run collect:update",
+        "mobile:update": "cd ../app && npm run upgrade:deallony:shared",
+        "backend:update": "cd ../backend-service-marketplace && pnpm run upgrade:deallony:shared",
+        "dashboard:update": "cd ../frontend-react-aloo && pnpm run upgrade:deallony:shared",
+        "whatsapp:update": "cd ../backend-nest-whatsapp-service-aloo && pnpm run upgrade:deallony:shared",
+        "collect:update": "cd ../qatayef-collect/backend && npm run upgrade:deallony:shared",
+        "current": "node -p \"require('./package.json').version\"",
+        "============================= Links with project =============================": "",
+        "link:backend": "cd ../backend-service-marketplace && pnpm add @deallony/shared@file:../shared-deallony",
+        "link:dashboard": "cd ../frontend-react-aloo && pnpm add @deallony/shared@file:../shared-deallony",
+        "link:mobile": "cd ../app && npm install ../shared-deallony",
+        "========": "============ DEFAULT ============",
+        "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node ./scripts/fix-esm-imports.mjs",
+        "watch": "tsc -p tsconfig.cjs.json --watch",
+        "deploy:patch": "node ./scripts/publish.js npm patch",
+        "deploy:minor": "node ./scripts/publish.js npm minor",
+        "deploy:major": "node ./scripts/publish.js npm major",
+        "deploy:dry-run": "node ./scripts/publish.js npm patch --dry-run",
+        "deploy:git": "node ./scripts/publish.js git patch",
+        "deploy:git:minor": "node ./scripts/publish.js git minor",
+        "deploy:git:major": "node ./scripts/publish.js git major",
+        "deploy:git:dry-run": "node ./scripts/publish.js git patch --dry-run",
+        "test:release": "node --test scripts/publish.test.js",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "zod": "^4.2.1"
+    },
+    "devDependencies": {
+        "@types/node": "^25.0.3",
+        "typescript": "^5.9.3"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/",
+        "access": "public"
+    }
+}