@deallony/shared 1.2.62 → 1.2.64

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

@@ -71,6 +71,13 @@ export declare const APP_ROUTES: {
                 ad_id: string | number;
             };
         };
+        /** The owner's views report for an ad */
+        readonly viewsReport: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
         readonly promotionDetails: (params: {
             id: number | string;
             ad_id?: number | string;

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

@@ -36,6 +36,8 @@ exports.APP_ROUTES = {
             pathname: "/ad/promotions/history/[ad_id]",
             params: { ad_id: params.id },
         }),
+        /** The owner's views report for an ad */
+        viewsReport: (id) => ({ pathname: "/ad/views-report/[id]", params: { id } }),
         promotionDetails: (params) => ({
             pathname: "/ad/promotions/details/[id]",
             params: {

package/dist/cjs/dto/ad/Ad.dto.d.ts

@@ -2,10 +2,13 @@ import { z } from "zod";
 import type { IAd } from "../../types/ad/Ad";
 import { createAdSchema, saveAdSchema, updateAdSchema } from "../../schema/ad/save-ad.schema";
 import { findAdSchema } from "../../schema/ad/find-ad.schema";
+import { adDailyViewsSchema, adViewsReportSchema } from "../../schema/ad/ad-views.schema";
 export type CreateAdDto = z.infer<typeof createAdSchema>;
 export type UpdateAdDto = z.infer<typeof updateAdSchema>;
 export type SaveAdDto = z.infer<typeof saveAdSchema>;
 export type FindAdDto = z.input<typeof findAdSchema>;
+export type AdDailyViewsDto = z.input<typeof adDailyViewsSchema>;
+export type AdViewsReportDto = z.input<typeof adViewsReportSchema>;
 export declare const AdDto: (params: {
     ad: IAd;
 }) => IAd;

package/dist/cjs/schema/ad/ad-views.schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Most days of per-day views kept on the server (older merged days are deleted) */
+export declare const AD_DAILY_VIEWS_MAX_DAYS = 180;
+/** Body of `POST api/v1/ads/views-daily/:id`: the owner's views per day for the last `days` days */
+export declare const adDailyViewsSchema: z.ZodObject<{
+    days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/** Body of `POST api/v1/ads/views-report/:id`: one page of the owner's daily view records */
+export declare const adViewsReportSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;

package/dist/cjs/schema/ad/ad-views.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adViewsReportSchema = exports.adDailyViewsSchema = exports.AD_DAILY_VIEWS_MAX_DAYS = void 0;
+const zod_1 = require("zod");
+/** Most days of per-day views kept on the server (older merged days are deleted) */
+exports.AD_DAILY_VIEWS_MAX_DAYS = 180;
+/** Body of `POST api/v1/ads/views-daily/:id`: the owner's views per day for the last `days` days */
+exports.adDailyViewsSchema = zod_1.z.object({
+    days: zod_1.z.coerce.number().int().min(1).max(exports.AD_DAILY_VIEWS_MAX_DAYS).default(30),
+});
+/** Body of `POST api/v1/ads/views-report/:id`: one page of the owner's daily view records */
+exports.adViewsReportSchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().int().min(1).default(1),
+    limit: zod_1.z.coerce.number().int().min(1).max(100).default(15),
+});

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

@@ -1,2 +1,3 @@
 export * from './save-ad.schema';
 export * from './find-ad.schema';
+export * from './ad-views.schema';

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

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./save-ad.schema"), exports);
 __exportStar(require("./find-ad.schema"), exports);
+__exportStar(require("./ad-views.schema"), exports);

package/dist/cjs/types/ad/AdDailyViews.d.ts

@@ -0,0 +1,19 @@
+/** Views of an ad on one day (YYYY-MM-DD, Asia/Damascus) */
+export type IAdDailyViews = {
+    day: string;
+    views: number;
+};
+/** Header of the owner's views report */
+export type IAdViewsReportSummary = {
+    /** All-time views, including today's */
+    total_views: number;
+    today: number;
+    last_7_days: number;
+    last_30_days: number;
+    /** Average views per day over the last 30 days */
+    daily_average: number;
+    /** The day with the most views among the kept daily records */
+    best_day: IAdDailyViews | null;
+    /** First day with a daily record (records are kept for 180 days) */
+    tracked_since: string | null;
+};

package/dist/cjs/types/ad/AdDailyViews.js

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

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

@@ -7,6 +7,7 @@ export * as ModuleFetchEndpoints from "./common/ModuleFetchEndpointsLastUpdated"
 export * as FilterParams from "./common/FilterParams";
 export * as Ad from "./ad/Ad";
 export * as AdLocation from "./ad/AdLocation";
+export * as AdDailyViews from "./ad/AdDailyViews";
 export * as Addresses from "./addresses/Address";
 export * as AdPromotion from "./ad/AdPromotion";
 export * as Motor from "./motor/Motor";

package/dist/cjs/types/index.js

@@ -36,8 +36,8 @@ 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.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;
+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.AdDailyViews = 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.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 = exports.Loyalty = void 0;
 // common
 exports.LocalizedName = __importStar(require("./common/LocalizedName"));
 exports.Response = __importStar(require("./common/Response"));
@@ -49,6 +49,7 @@ exports.FilterParams = __importStar(require("./common/FilterParams"));
 // listings
 exports.Ad = __importStar(require("./ad/Ad"));
 exports.AdLocation = __importStar(require("./ad/AdLocation"));
+exports.AdDailyViews = __importStar(require("./ad/AdDailyViews"));
 exports.Addresses = __importStar(require("./addresses/Address"));
 exports.AdPromotion = __importStar(require("./ad/AdPromotion"));
 exports.Motor = __importStar(require("./motor/Motor"));

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

@@ -33,6 +33,8 @@ export const APP_ROUTES = {
             pathname: "/ad/promotions/history/[ad_id]",
             params: { ad_id: params.id },
         }),
+        /** The owner's views report for an ad */
+        viewsReport: (id) => ({ pathname: "/ad/views-report/[id]", params: { id } }),
         promotionDetails: (params) => ({
             pathname: "/ad/promotions/details/[id]",
             params: {

package/dist/esm/schema/ad/ad-views.schema.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Most days of per-day views kept on the server (older merged days are deleted) */
+export const AD_DAILY_VIEWS_MAX_DAYS = 180;
+/** Body of `POST api/v1/ads/views-daily/:id`: the owner's views per day for the last `days` days */
+export const adDailyViewsSchema = z.object({
+    days: z.coerce.number().int().min(1).max(AD_DAILY_VIEWS_MAX_DAYS).default(30),
+});
+/** Body of `POST api/v1/ads/views-report/:id`: one page of the owner's daily view records */
+export const adViewsReportSchema = z.object({
+    page: z.coerce.number().int().min(1).default(1),
+    limit: z.coerce.number().int().min(1).max(100).default(15),
+});

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

@@ -1,2 +1,3 @@
 export * from './save-ad.schema.js';
 export * from './find-ad.schema.js';
+export * from './ad-views.schema.js';

package/dist/esm/types/ad/AdDailyViews.js

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

package/dist/esm/types/index.js

@@ -12,6 +12,7 @@ export * as FilterParams from "./common/FilterParams.js";
 // listings
 export * as Ad from "./ad/Ad.js";
 export * as AdLocation from "./ad/AdLocation.js";
+export * as AdDailyViews from "./ad/AdDailyViews.js";
 export * as Addresses from "./addresses/Address.js";
 export * as AdPromotion from "./ad/AdPromotion.js";
 export * as Motor from "./motor/Motor.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deallony/shared",
-    "version": "1.2.62",
+    "version": "1.2.64",
     "private": false,
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",