@deallony/shared 1.2.56 → 1.2.61

package/README.md

@@ -1,44 +1,43 @@
-# @deallony/shared
-
-Shared TypeScript types, DTOs, Zod schemas, and utilities for Deallony projects.
-
-## One-command releases
-
-Run from a clean, synchronized `main` branch with push access to `origin/main`.
-
-| Command | Action |
-| --- | --- |
-| `npm run deploy` | Bump patch, build, publish to npm, commit/tag/push GitLab |
-| `npm run deploy:minor` | npm + GitLab minor release |
-| `npm run deploy:major` | npm + GitLab major release |
-| `npm run deploy:dry-run` | Preview version and inspect current package, no mutation |
-| `npm run deploy:git` | Bump patch, build, commit/tag/push GitLab without npm publish |
-| `npm run deploy:git:minor` | GitLab-only minor release |
-| `npm run deploy:git:major` | GitLab-only major release |
-| `npm run deploy:git:dry-run` | Preview GitLab-only release |
-| `npm run test:release` | Unit tests for release helpers |
-
-Version increments follow semantic versioning; `1.2.99` becomes `1.2.100`.
-
-### Automatic npm login
-
-`npm run deploy` first checks `npm whoami`. If npm returns E401 or ENEEDAUTH,
-the script runs `npm login --registry=https://registry.npmjs.org/ --auth-type=web` and
-opens the browser sign-in flow. After you finish logging in, it rechecks your
-identity and continues the same release. Network failures and canceled logins
-stop the release before modifying the package version. `deploy:git` never logs
-into npm.
-
-### npm authentication
-
-Run `npm login --registry=https://registry.npmjs.org/` and ensure your account has
-publishing permission for the public scoped package `@deallony/shared`.
-Complete any npm 2FA prompts when required. Never commit npm tokens.
-
-### Failure recovery
-
-If publishing fails, inspect and restore generated local changes before retrying.
-If npm publication succeeds but Git push/commit fails, **do not republish that version**.
-Resolve the Git issue and push the existing release commit and `vX.Y.Z` tag.
-
-Merge this feature branch first; merging does not trigger publication automatically.
+# @deallony/shared
+
+Shared TypeScript types, DTOs, Zod schemas, and utilities for Deallony projects.
+
+## One-command releases
+
+Run from a clean, synchronized `main` branch with push access to `origin/main`.
+
+| Command | Action |
+| --- | --- |
+| `npm run deploy` | Bump patch, build, publish to npm, commit/tag/push GitLab |
+| `npm run deploy:minor` | npm + GitLab minor release |
+| `npm run deploy:major` | npm + GitLab major release |
+| `npm run deploy:dry-run` | Preview version and inspect current package, no mutation |
+| `npm run deploy:git` | Bump patch, build, commit/tag/push GitLab without npm publish |
+| `npm run deploy:git:minor` | GitLab-only minor release |
+| `npm run deploy:git:major` | GitLab-only major release |
+| `npm run deploy:git:dry-run` | Preview GitLab-only release |
+
+Version increments follow semantic versioning; `1.2.99` becomes `1.2.100`.
+
+### Automatic npm login
+
+`npm run deploy` first checks `npm whoami`. If npm returns E401 or ENEEDAUTH,
+the script runs `npm login --registry=https://registry.npmjs.org/ --auth-type=web` and
+opens the browser sign-in flow. After you finish logging in, it rechecks your
+identity and continues the same release. Network failures and canceled logins
+stop the release before modifying the package version. `deploy:git` never logs
+into npm.
+
+### npm authentication
+
+Run `npm login --registry=https://registry.npmjs.org/` and ensure your account has
+publishing permission for the public scoped package `@deallony/shared`.
+Complete any npm 2FA prompts when required. Never commit npm tokens.
+
+### Failure recovery
+
+If publishing fails, inspect and restore generated local changes before retrying.
+If npm publication succeeds but Git push/commit fails, **do not republish that version**.
+Resolve the Git issue and push the existing release commit and `vX.Y.Z` tag.
+
+Merge this feature branch first; merging does not trigger publication automatically.

package/dist/cjs/constants/routes/app.d.ts

@@ -71,6 +71,18 @@ export declare const APP_ROUTES: {
                 ad_id: string | number;
             };
         };
+        readonly promotionDetails: (params: {
+            id: number | string;
+            ad_id?: number | string;
+            data?: unknown;
+        }) => {
+            pathname: string;
+            params: {
+                id: string;
+                ad_id: string | undefined;
+                promotion: string | undefined;
+            };
+        };
         readonly list: (params: GenericParams) => {
             pathname: string;
             params: {
@@ -177,6 +189,9 @@ export declare const APP_ROUTES: {
         readonly noInternet: () => {
             pathname: string;
         };
+        readonly savedData: () => {
+            pathname: string;
+        };
     };
     readonly settings: {
         readonly selectCurrency: () => {
@@ -297,6 +312,105 @@ export declare const APP_ROUTES: {
         readonly details: () => {
             pathname: string;
         };
+        readonly topup: (amount?: number | string) => {
+            pathname: string;
+            params: {
+                amount: string;
+            } | undefined;
+        };
+    };
+    readonly addresses: {
+        readonly list: () => {
+            pathname: string;
+        };
+        readonly new: (fromAdDraftId?: string) => {
+            pathname: string;
+            params: {
+                fromAdDraftId: string;
+            } | undefined;
+        };
+        readonly edit: (id: number) => {
+            pathname: string;
+            params: {
+                id: string;
+            };
+        };
+    };
+    readonly support: {
+        readonly tickets: () => {
+            pathname: string;
+        };
+    };
+    readonly kyc: {
+        readonly details: () => {
+            pathname: string;
+        };
+        readonly fromSettings: () => {
+            pathname: string;
+            params: {
+                source: string;
+            };
+        };
+    };
+    readonly company: {
+        readonly list: () => {
+            pathname: string;
+        };
+        readonly new: () => {
+            pathname: string;
+        };
+        readonly edit: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
+        readonly details: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
+    };
+    readonly venue: {
+        readonly new: (companyId: number | string) => {
+            pathname: string;
+            params: {
+                company_id: string | number;
+            };
+        };
+        readonly edit: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
+        readonly details: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
+    };
+    readonly event: {
+        readonly new: (venueId: number | string) => {
+            pathname: string;
+            params: {
+                venue_id: string | number;
+            };
+        };
+        readonly edit: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
+        readonly details: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
     };
 };
 export type SharedAppRoutes = typeof APP_ROUTES;

package/dist/cjs/constants/routes/app.js

@@ -36,6 +36,14 @@ exports.APP_ROUTES = {
             pathname: "/ad/promotions/history/[ad_id]",
             params: { ad_id: params.id },
         }),
+        promotionDetails: (params) => ({
+            pathname: "/ad/promotions/details/[id]",
+            params: {
+                id: String(params.id),
+                ad_id: params.ad_id != null ? String(params.ad_id) : undefined,
+                promotion: params.data ? JSON.stringify(params.data) : undefined,
+            },
+        }),
         list: (params) => {
             const filter = JSON.stringify(params);
             if (params === null || params === void 0 ? void 0 : params.subject_type) {
@@ -80,6 +88,7 @@ exports.APP_ROUTES = {
         download: () => ({ pathname: "/system/download-app" }),
         needMobileApp: () => ({ pathname: "/system/need-mobile-app" }),
         noInternet: () => ({ pathname: "/system/no-internet" }),
+        savedData: () => ({ pathname: "/system/saved-data" }),
     },
     settings: {
         selectCurrency: () => ({ pathname: "/settings/select-currency" }),
@@ -132,5 +141,40 @@ exports.APP_ROUTES = {
     },
     wallet: {
         details: () => ({ pathname: "/wallet" }),
+        topup: (amount) => ({
+            pathname: "/wallet/topup",
+            params: amount != null ? { amount: String(amount) } : undefined,
+        }),
+    },
+    addresses: {
+        list: () => ({ pathname: "/user/addresses" }),
+        new: (fromAdDraftId) => ({
+            pathname: "/user/addresses/new",
+            params: fromAdDraftId ? { fromAdDraftId } : undefined,
+        }),
+        edit: (id) => ({ pathname: "/user/addresses/[id]", params: { id: String(id) } }),
+    },
+    support: {
+        tickets: () => ({ pathname: "/system/support-tickets" }),
+    },
+    kyc: {
+        details: () => ({ pathname: "/kyc" }),
+        fromSettings: () => ({ pathname: "/kyc", params: { source: "settings" } }),
+    },
+    company: {
+        list: () => ({ pathname: "/company/list" }),
+        new: () => ({ pathname: "/company/new" }),
+        edit: (id) => ({ pathname: "/company/new", params: { id } }),
+        details: (id) => ({ pathname: "/company/details/[id]", params: { id } }),
+    },
+    venue: {
+        new: (companyId) => ({ pathname: "/venue/new", params: { company_id: companyId } }),
+        edit: (id) => ({ pathname: "/venue/new", params: { id } }),
+        details: (id) => ({ pathname: "/venue/details/[id]", params: { id } }),
+    },
+    event: {
+        new: (venueId) => ({ pathname: "/event/new", params: { venue_id: venueId } }),
+        edit: (id) => ({ pathname: "/event/new", params: { id } }),
+        details: (id) => ({ pathname: "/event/details/[id]", params: { id } }),
     },
 };

package/dist/cjs/dto/ai/gemini-api-key.dto.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { createGeminiApiKeySchema, geminiApiKeyIdBodySchema, leasedGeminiApiKeySchema, leaseGeminiApiKeySchema, reorderGeminiApiKeysSchema, reportGeminiApiKeyUsageSchema, updateGeminiApiKeySchema } from '../../schema/ai/gemini-api-key.schema';
+export type CreateGeminiApiKeyDto = z.input<typeof createGeminiApiKeySchema>;
+export type UpdateGeminiApiKeyDto = z.input<typeof updateGeminiApiKeySchema>;
+export type GeminiApiKeyIdBodyDto = z.input<typeof geminiApiKeyIdBodySchema>;
+export type ReorderGeminiApiKeysDto = z.input<typeof reorderGeminiApiKeysSchema>;
+export type LeaseGeminiApiKeyDto = z.input<typeof leaseGeminiApiKeySchema>;
+export type LeasedGeminiApiKey = z.infer<typeof leasedGeminiApiKeySchema>;
+export type ReportGeminiApiKeyUsageDto = z.input<typeof reportGeminiApiKeyUsageSchema>;

package/dist/cjs/dto/ai/gemini-api-key.dto.js

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

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

@@ -2,6 +2,7 @@ export { AdDto } from './ad/Ad.dto';
 export * as AD from './ad/Ad.dto';
 export * as EVENTS from './events';
 export * as Ai from './ai/Ai.dto';
+export * as GEMINI_API_KEYS from './ai/gemini-api-key.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,12 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.POTENTIAL_USERS = exports.ADDRESSES = exports.PAYMENTS = exports.Ai = exports.EVENTS = exports.AD = exports.AdDto = void 0;
+exports.POTENTIAL_USERS = exports.ADDRESSES = exports.PAYMENTS = exports.GEMINI_API_KEYS = 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"));
 exports.EVENTS = __importStar(require("./events"));
 exports.Ai = __importStar(require("./ai/Ai.dto"));
+exports.GEMINI_API_KEYS = __importStar(require("./ai/gemini-api-key.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/schema/ai/gemini-api-key.schema.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/** Gemini model ID, e.g. gemini-3.1-flash-lite */
+export declare const geminiModelNameSchema: z.ZodString;
+export declare const createGeminiApiKeySchema: z.ZodObject<{
+    name: z.ZodString;
+    api_key: z.ZodString;
+    model_name: z.ZodString;
+    is_active: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Fields left out keep their current value; the key itself is only replaced when sent. */
+export declare const updateGeminiApiKeySchema: z.ZodObject<{
+    id: z.ZodCoercedNumber<unknown>;
+    name: z.ZodOptional<z.ZodString>;
+    api_key: z.ZodOptional<z.ZodString>;
+    model_name: z.ZodOptional<z.ZodString>;
+    is_active: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const geminiApiKeyIdBodySchema: z.ZodObject<{
+    id: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+/** Every key ID in the new order: the first ID gets sort_order 1. */
+export declare const reorderGeminiApiKeysSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/** Ask backend-core for the least-used available key, optionally only keys for one model. */
+export declare const leaseGeminiApiKeySchema: z.ZodObject<{
+    model_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const leasedGeminiApiKeySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    api_key: z.ZodString;
+    model_name: z.ZodString;
+}, z.core.$strip>;
+/** Sent after every Gemini call made with a leased key. */
+export declare const reportGeminiApiKeyUsageSchema: z.ZodObject<{
+    id: z.ZodCoercedNumber<unknown>;
+    total_tokens: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    success: z.ZodDefault<z.ZodBoolean>;
+    error_code: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    error_message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/cjs/schema/ai/gemini-api-key.schema.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportGeminiApiKeyUsageSchema = exports.leasedGeminiApiKeySchema = exports.leaseGeminiApiKeySchema = exports.reorderGeminiApiKeysSchema = exports.geminiApiKeyIdBodySchema = exports.updateGeminiApiKeySchema = exports.createGeminiApiKeySchema = exports.geminiModelNameSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Gemini API keys are stored in backend-core (one table) and shared by every Deallony service.
+ * The dashboard manages them through the admin schemas; other services lease a key and report
+ * the tokens they used through the internal schemas.
+ */
+const geminiApiKeyIdSchema = zod_1.z.coerce.number().int().positive();
+/** Gemini model ID, e.g. gemini-3.1-flash-lite */
+exports.geminiModelNameSchema = zod_1.z.string().trim().min(1).max(100);
+// ---------- Admin (dashboard) ----------
+exports.createGeminiApiKeySchema = zod_1.z.object({
+    name: zod_1.z.string().trim().min(1).max(255),
+    api_key: zod_1.z.string().trim().min(20).max(512),
+    model_name: exports.geminiModelNameSchema,
+    is_active: zod_1.z.boolean().default(true),
+});
+/** Fields left out keep their current value; the key itself is only replaced when sent. */
+exports.updateGeminiApiKeySchema = zod_1.z.object({
+    id: geminiApiKeyIdSchema,
+    name: zod_1.z.string().trim().min(1).max(255).optional(),
+    api_key: zod_1.z.string().trim().min(20).max(512).optional(),
+    model_name: exports.geminiModelNameSchema.optional(),
+    is_active: zod_1.z.boolean().optional(),
+});
+exports.geminiApiKeyIdBodySchema = zod_1.z.object({
+    id: geminiApiKeyIdSchema,
+});
+/** Every key ID in the new order: the first ID gets sort_order 1. */
+exports.reorderGeminiApiKeysSchema = zod_1.z.object({
+    ids: zod_1.z.array(geminiApiKeyIdSchema).min(1),
+});
+// ---------- Internal (other services) ----------
+/** Ask backend-core for the least-used available key, optionally only keys for one model. */
+exports.leaseGeminiApiKeySchema = zod_1.z.object({
+    model_name: exports.geminiModelNameSchema.optional(),
+});
+exports.leasedGeminiApiKeySchema = zod_1.z.object({
+    id: zod_1.z.number().int().positive(),
+    api_key: zod_1.z.string(),
+    model_name: zod_1.z.string(),
+});
+/** Sent after every Gemini call made with a leased key. */
+exports.reportGeminiApiKeyUsageSchema = zod_1.z.object({
+    id: geminiApiKeyIdSchema,
+    /** usageMetadata.totalTokenCount of the Gemini response; 0 when the call failed */
+    total_tokens: zod_1.z.coerce.number().int().min(0).default(0),
+    success: zod_1.z.boolean().default(true),
+    /** HTTP status Gemini answered with, e.g. 429 */
+    error_code: zod_1.z.coerce.number().int().optional(),
+    error_message: zod_1.z.string().trim().max(2000).optional(),
+});

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

@@ -1,2 +1,3 @@
 export * from './ai-fill-form.schema';
 export * from './ai-fill-ad-form.schema';
+export * from './gemini-api-key.schema';

package/dist/cjs/schema/ai/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ai-fill-form.schema"), exports);
 __exportStar(require("./ai-fill-ad-form.schema"), exports);
+__exportStar(require("./gemini-api-key.schema"), exports);

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

@@ -25,10 +25,8 @@ export declare const StartAiConversationSchema: z.ZodObject<{
         motors: "motors";
         used_products: "used_products";
     }>;
-    initial_message: z.ZodString;
     context: z.ZodObject<{
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        reason: z.ZodString;
         note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         previous_contact_count: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
@@ -58,7 +56,85 @@ export declare const PotentialUserConversationEventSchema: z.ZodObject<{
     }>;
     summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
+export declare const AiConversationStatusSchema: z.ZodEnum<{
+    starting: "starting";
+    waiting_for_reply: "waiting_for_reply";
+    chatting: "chatting";
+    interested: "interested";
+    human_handoff: "human_handoff";
+    not_interested: "not_interested";
+    converted: "converted";
+    opted_out: "opted_out";
+    closed: "closed";
+    failed: "failed";
+}>;
+export declare const AiConversationPurposeSchema: z.ZodEnum<{
+    marketing: "marketing";
+    support: "support";
+}>;
+/** Statuses of a conversation that is still open with the customer. */
+export declare const AI_CONVERSATION_ACTIVE_STATUSES: AiConversationStatus[];
+export declare const AiConversationListSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        starting: "starting";
+        waiting_for_reply: "waiting_for_reply";
+        chatting: "chatting";
+        interested: "interested";
+        human_handoff: "human_handoff";
+        not_interested: "not_interested";
+        converted: "converted";
+        opted_out: "opted_out";
+        closed: "closed";
+        failed: "failed";
+    }>>>;
+    active_only: z.ZodDefault<z.ZodBoolean>;
+    purpose: z.ZodOptional<z.ZodEnum<{
+        marketing: "marketing";
+        support: "support";
+    }>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export type MarketingSubjectType = z.infer<typeof MarketingSubjectTypeSchema>;
+export type AiConversationStatus = z.infer<typeof AiConversationStatusSchema>;
+export type AiConversationPurpose = z.infer<typeof AiConversationPurposeSchema>;
+export type AiConversationList = z.infer<typeof AiConversationListSchema>;
+export type AiConversationListItem = {
+    id: number;
+    potential_user_id: number | null;
+    user_id: number | null;
+    phone: string;
+    purpose: AiConversationPurpose;
+    subject_type: string;
+    status: AiConversationStatus;
+    ai_enabled: boolean;
+    human_takeover: boolean;
+    last_message_at: string | null;
+    created_at: string;
+    last_message: {
+        content: string;
+        direction: 'inbound' | 'outbound';
+        sender: 'user' | 'ai' | 'human';
+        created_at: string;
+    } | null;
+    /** Filled in by the marketplace from the potential user record. */
+    potential_user?: {
+        id: number;
+        name: string | null;
+        saved_by: number | null;
+    } | null;
+};
+export type AiConversationListResult = {
+    items: AiConversationListItem[];
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+    /** Counts over all conversations matching purpose and search, not only this page. */
+    status_counts: Record<AiConversationStatus, number>;
+    active_count: number;
+};
 export type ConversationLanguage = z.infer<typeof ConversationLanguageSchema>;
 export type StartAiConversation = z.infer<typeof StartAiConversationSchema>;
 export type ConversationEventType = z.infer<typeof ConversationEventTypeSchema>;

package/dist/cjs/schema/communication/ai-conversation.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PotentialUserConversationEventSchema = exports.ConversationEventTypeSchema = exports.StartAiConversationSchema = exports.ConversationLanguageSchema = exports.MarketingSubjectTypeSchema = void 0;
+exports.AiConversationListSchema = exports.AI_CONVERSATION_ACTIVE_STATUSES = exports.AiConversationPurposeSchema = exports.AiConversationStatusSchema = exports.PotentialUserConversationEventSchema = exports.ConversationEventTypeSchema = exports.StartAiConversationSchema = exports.ConversationLanguageSchema = exports.MarketingSubjectTypeSchema = void 0;
 const zod_1 = require("zod");
 exports.MarketingSubjectTypeSchema = zod_1.z.enum([
     'motors',
@@ -17,10 +17,8 @@ exports.StartAiConversationSchema = zod_1.z.object({
     language: exports.ConversationLanguageSchema.default('ar'),
     purpose: zod_1.z.literal('marketing'),
     subject_type: exports.MarketingSubjectTypeSchema,
-    initial_message: zod_1.z.string().min(1),
     context: zod_1.z.object({
         name: zod_1.z.string().nullable().optional(),
-        reason: zod_1.z.string().min(1),
         note: zod_1.z.string().nullable().optional(),
         previous_contact_count: zod_1.z.number().int().nonnegative().default(0),
     }),
@@ -41,3 +39,32 @@ exports.PotentialUserConversationEventSchema = zod_1.z.object({
     event: exports.ConversationEventTypeSchema,
     summary: zod_1.z.string().max(2000).nullable().optional(),
 });
+exports.AiConversationStatusSchema = zod_1.z.enum([
+    'starting',
+    'waiting_for_reply',
+    'chatting',
+    'interested',
+    'human_handoff',
+    'not_interested',
+    'converted',
+    'opted_out',
+    'closed',
+    'failed',
+]);
+exports.AiConversationPurposeSchema = zod_1.z.enum(['marketing', 'support']);
+/** Statuses of a conversation that is still open with the customer. */
+exports.AI_CONVERSATION_ACTIVE_STATUSES = [
+    'starting',
+    'waiting_for_reply',
+    'chatting',
+    'interested',
+    'human_handoff',
+];
+exports.AiConversationListSchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().int().positive().default(1),
+    limit: zod_1.z.coerce.number().int().min(1).max(100).default(20),
+    statuses: zod_1.z.array(exports.AiConversationStatusSchema).max(10).optional(),
+    active_only: zod_1.z.boolean().default(false),
+    purpose: exports.AiConversationPurposeSchema.optional(),
+    search: zod_1.z.string().trim().max(100).optional(),
+});

package/dist/cjs/schema/communication/support-ticket.schema.d.ts

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 export declare const SupportTicketStatusSchema: z.ZodEnum<{
+    closed: "closed";
     open: "open";
     assigned: "assigned";
     in_progress: "in_progress";
     waiting_customer: "waiting_customer";
     resolved: "resolved";
-    closed: "closed";
     reopened: "reopened";
 }>;
 export declare const SupportTicketPrioritySchema: z.ZodEnum<{
@@ -79,12 +79,12 @@ export declare const SupportTicketListSchema: z.ZodObject<{
     page: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
     status: z.ZodOptional<z.ZodEnum<{
+        closed: "closed";
         open: "open";
         assigned: "assigned";
         in_progress: "in_progress";
         waiting_customer: "waiting_customer";
         resolved: "resolved";
-        closed: "closed";
         reopened: "reopened";
     }>>;
     priority: z.ZodOptional<z.ZodEnum<{
@@ -98,12 +98,12 @@ export declare const SupportTicketListSchema: z.ZodObject<{
 export declare const SupportTicketStatusUpdateSchema: z.ZodObject<{
     id: z.ZodNumber;
     status: z.ZodEnum<{
+        closed: "closed";
         open: "open";
         assigned: "assigned";
         in_progress: "in_progress";
         waiting_customer: "waiting_customer";
         resolved: "resolved";
-        closed: "closed";
         reopened: "reopened";
     }>;
 }, z.core.$strip>;

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

@@ -63,5 +63,6 @@ export * as SocialMediaPlatform from "./media/SocialMediaPlatform";
 export * as SocialMediaProfile from "./media/SocialMediaProfile";
 export * as Kyc from "./kyc/Kyc";
 export * as Google from "./integrations/Google";
+export * as GeminiApiKey from "./integrations/GeminiApiKey";
 export * as Analysis from "./analysis/AnalysisDailySnapshot";
 export * as Payment from "./payments/Payment";

package/dist/cjs/types/index.js

@@ -37,7 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Loyalty = exports.Favorite = exports.Wallet = exports.Permission = exports.Role = exports.User = exports.EventVenue = exports.EventWedding = exports.EventTimeline = exports.EventRsvp = exports.Event = exports.District = exports.City = exports.AdminBoundary = exports.WorkType = exports.UsedProductCondition = exports.UsedProductAge = exports.Unit = exports.Transmission = exports.RegionalSpec = exports.PublisherType = exports.PropertyStatus = exports.PriceType = exports.OfferType = exports.LicenseType = exports.FuelType = exports.Feature = exports.Facility = exports.Currency = exports.Color = exports.CategoryWorkType = exports.Category = exports.CarBody = exports.UsedProduct = exports.Service = exports.PropertySubType = exports.Property = exports.MotorTrim = exports.Motor = exports.AdPromotion = exports.Addresses = exports.AdLocation = exports.Ad = exports.FilterParams = exports.ModuleFetchEndpoints = exports.Config = exports.AccessType = exports.Status = exports.Response = exports.LocalizedName = void 0;
-exports.Payment = exports.Analysis = exports.Google = exports.Kyc = exports.SocialMediaProfile = exports.SocialMediaPlatform = exports.Image = exports.Media = exports.File = exports.NotificationToken = exports.MessageTemplate = exports.Device = exports.Chat = exports.AppStartScreen = exports.MetaData = exports.Company = exports.PotentialUser = void 0;
+exports.Payment = exports.Analysis = exports.GeminiApiKey = exports.Google = exports.Kyc = exports.SocialMediaProfile = exports.SocialMediaPlatform = exports.Image = exports.Media = exports.File = exports.NotificationToken = exports.MessageTemplate = exports.Device = exports.Chat = exports.AppStartScreen = exports.MetaData = exports.Company = exports.PotentialUser = void 0;
 // common
 exports.LocalizedName = __importStar(require("./common/LocalizedName"));
 exports.Response = __importStar(require("./common/Response"));
@@ -113,6 +113,7 @@ exports.SocialMediaProfile = __importStar(require("./media/SocialMediaProfile"))
 exports.Kyc = __importStar(require("./kyc/Kyc"));
 // integrations
 exports.Google = __importStar(require("./integrations/Google"));
+exports.GeminiApiKey = __importStar(require("./integrations/GeminiApiKey"));
 // analysis
 exports.Analysis = __importStar(require("./analysis/AnalysisDailySnapshot"));
 // payments

package/dist/cjs/types/integrations/GeminiApiKey.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A Gemini API key as the dashboard sees it. The key itself never leaves backend-core in this
+ * shape: only `api_key_masked` is sent.
+ */
+export type IGeminiApiKey = {
+    id: number;
+    name: string;
+    /** e.g. "AIza…f3Kq" */
+    api_key_masked: string;
+    model_name: string;
+    /** Dashboard order, starting at 1 */
+    sort_order: number;
+    is_active: boolean;
+    /** All tokens used with this key */
+    total_tokens: number;
+    /** Tokens used today; resets every day */
+    daily_tokens: number;
+    /** The day daily_tokens belongs to (YYYY-MM-DD) */
+    daily_usage_date: string | null;
+    /** The key is skipped until this time, after Gemini rejected it for quota */
+    cooldown_until: string | null;
+    last_used_at: string | null;
+    last_error: string | null;
+    created_at: string;
+    updated_at: string;
+};

package/dist/cjs/types/integrations/GeminiApiKey.js

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

package/dist/esm/constants/routes/app.js

@@ -33,6 +33,14 @@ export const APP_ROUTES = {
             pathname: "/ad/promotions/history/[ad_id]",
             params: { ad_id: params.id },
         }),
+        promotionDetails: (params) => ({
+            pathname: "/ad/promotions/details/[id]",
+            params: {
+                id: String(params.id),
+                ad_id: params.ad_id != null ? String(params.ad_id) : undefined,
+                promotion: params.data ? JSON.stringify(params.data) : undefined,
+            },
+        }),
         list: (params) => {
             const filter = JSON.stringify(params);
             if (params === null || params === void 0 ? void 0 : params.subject_type) {
@@ -77,6 +85,7 @@ export const APP_ROUTES = {
         download: () => ({ pathname: "/system/download-app" }),
         needMobileApp: () => ({ pathname: "/system/need-mobile-app" }),
         noInternet: () => ({ pathname: "/system/no-internet" }),
+        savedData: () => ({ pathname: "/system/saved-data" }),
     },
     settings: {
         selectCurrency: () => ({ pathname: "/settings/select-currency" }),
@@ -129,5 +138,40 @@ export const APP_ROUTES = {
     },
     wallet: {
         details: () => ({ pathname: "/wallet" }),
+        topup: (amount) => ({
+            pathname: "/wallet/topup",
+            params: amount != null ? { amount: String(amount) } : undefined,
+        }),
+    },
+    addresses: {
+        list: () => ({ pathname: "/user/addresses" }),
+        new: (fromAdDraftId) => ({
+            pathname: "/user/addresses/new",
+            params: fromAdDraftId ? { fromAdDraftId } : undefined,
+        }),
+        edit: (id) => ({ pathname: "/user/addresses/[id]", params: { id: String(id) } }),
+    },
+    support: {
+        tickets: () => ({ pathname: "/system/support-tickets" }),
+    },
+    kyc: {
+        details: () => ({ pathname: "/kyc" }),
+        fromSettings: () => ({ pathname: "/kyc", params: { source: "settings" } }),
+    },
+    company: {
+        list: () => ({ pathname: "/company/list" }),
+        new: () => ({ pathname: "/company/new" }),
+        edit: (id) => ({ pathname: "/company/new", params: { id } }),
+        details: (id) => ({ pathname: "/company/details/[id]", params: { id } }),
+    },
+    venue: {
+        new: (companyId) => ({ pathname: "/venue/new", params: { company_id: companyId } }),
+        edit: (id) => ({ pathname: "/venue/new", params: { id } }),
+        details: (id) => ({ pathname: "/venue/details/[id]", params: { id } }),
+    },
+    event: {
+        new: (venueId) => ({ pathname: "/event/new", params: { venue_id: venueId } }),
+        edit: (id) => ({ pathname: "/event/new", params: { id } }),
+        details: (id) => ({ pathname: "/event/details/[id]", params: { id } }),
     },
 };

package/dist/esm/dto/ai/gemini-api-key.dto.js

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

package/dist/esm/dto/index.js

@@ -2,6 +2,7 @@ export { AdDto } from './ad/Ad.dto.js';
 export * as AD from './ad/Ad.dto.js';
 export * as EVENTS from './events/index.js';
 export * as Ai from './ai/Ai.dto.js';
+export * as GEMINI_API_KEYS from './ai/gemini-api-key.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/schema/ai/gemini-api-key.schema.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Gemini API keys are stored in backend-core (one table) and shared by every Deallony service.
+ * The dashboard manages them through the admin schemas; other services lease a key and report
+ * the tokens they used through the internal schemas.
+ */
+const geminiApiKeyIdSchema = z.coerce.number().int().positive();
+/** Gemini model ID, e.g. gemini-3.1-flash-lite */
+export const geminiModelNameSchema = z.string().trim().min(1).max(100);
+// ---------- Admin (dashboard) ----------
+export const createGeminiApiKeySchema = z.object({
+    name: z.string().trim().min(1).max(255),
+    api_key: z.string().trim().min(20).max(512),
+    model_name: geminiModelNameSchema,
+    is_active: z.boolean().default(true),
+});
+/** Fields left out keep their current value; the key itself is only replaced when sent. */
+export const updateGeminiApiKeySchema = z.object({
+    id: geminiApiKeyIdSchema,
+    name: z.string().trim().min(1).max(255).optional(),
+    api_key: z.string().trim().min(20).max(512).optional(),
+    model_name: geminiModelNameSchema.optional(),
+    is_active: z.boolean().optional(),
+});
+export const geminiApiKeyIdBodySchema = z.object({
+    id: geminiApiKeyIdSchema,
+});
+/** Every key ID in the new order: the first ID gets sort_order 1. */
+export const reorderGeminiApiKeysSchema = z.object({
+    ids: z.array(geminiApiKeyIdSchema).min(1),
+});
+// ---------- Internal (other services) ----------
+/** Ask backend-core for the least-used available key, optionally only keys for one model. */
+export const leaseGeminiApiKeySchema = z.object({
+    model_name: geminiModelNameSchema.optional(),
+});
+export const leasedGeminiApiKeySchema = z.object({
+    id: z.number().int().positive(),
+    api_key: z.string(),
+    model_name: z.string(),
+});
+/** Sent after every Gemini call made with a leased key. */
+export const reportGeminiApiKeyUsageSchema = z.object({
+    id: geminiApiKeyIdSchema,
+    /** usageMetadata.totalTokenCount of the Gemini response; 0 when the call failed */
+    total_tokens: z.coerce.number().int().min(0).default(0),
+    success: z.boolean().default(true),
+    /** HTTP status Gemini answered with, e.g. 429 */
+    error_code: z.coerce.number().int().optional(),
+    error_message: z.string().trim().max(2000).optional(),
+});

package/dist/esm/schema/ai/index.js

@@ -1,2 +1,3 @@
 export * from './ai-fill-form.schema.js';
 export * from './ai-fill-ad-form.schema.js';
+export * from './gemini-api-key.schema.js';

package/dist/esm/schema/communication/ai-conversation.schema.js

@@ -14,10 +14,8 @@ export const StartAiConversationSchema = z.object({
     language: ConversationLanguageSchema.default('ar'),
     purpose: z.literal('marketing'),
     subject_type: MarketingSubjectTypeSchema,
-    initial_message: z.string().min(1),
     context: z.object({
         name: z.string().nullable().optional(),
-        reason: z.string().min(1),
         note: z.string().nullable().optional(),
         previous_contact_count: z.number().int().nonnegative().default(0),
     }),
@@ -38,3 +36,32 @@ export const PotentialUserConversationEventSchema = z.object({
     event: ConversationEventTypeSchema,
     summary: z.string().max(2000).nullable().optional(),
 });
+export const AiConversationStatusSchema = z.enum([
+    'starting',
+    'waiting_for_reply',
+    'chatting',
+    'interested',
+    'human_handoff',
+    'not_interested',
+    'converted',
+    'opted_out',
+    'closed',
+    'failed',
+]);
+export const AiConversationPurposeSchema = z.enum(['marketing', 'support']);
+/** Statuses of a conversation that is still open with the customer. */
+export const AI_CONVERSATION_ACTIVE_STATUSES = [
+    'starting',
+    'waiting_for_reply',
+    'chatting',
+    'interested',
+    'human_handoff',
+];
+export const AiConversationListSchema = z.object({
+    page: z.coerce.number().int().positive().default(1),
+    limit: z.coerce.number().int().min(1).max(100).default(20),
+    statuses: z.array(AiConversationStatusSchema).max(10).optional(),
+    active_only: z.boolean().default(false),
+    purpose: AiConversationPurposeSchema.optional(),
+    search: z.string().trim().max(100).optional(),
+});

package/dist/esm/types/index.js

@@ -76,6 +76,7 @@ export * as SocialMediaProfile from "./media/SocialMediaProfile.js";
 export * as Kyc from "./kyc/Kyc.js";
 // integrations
 export * as Google from "./integrations/Google.js";
+export * as GeminiApiKey from "./integrations/GeminiApiKey.js";
 // analysis
 export * as Analysis from "./analysis/AnalysisDailySnapshot.js";
 // payments

package/dist/esm/types/integrations/GeminiApiKey.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deallony/shared",
-    "version": "1.2.56",
+    "version": "1.2.61",
     "private": false,
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
@@ -42,7 +42,6 @@
         "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": {