@taon-dev/marketing 21.0.11 → 21.0.13

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.config.service.ts

@@ -0,0 +1,28 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Injectable } from '@angular/core';
+import { Observable } from 'rxjs';
+import { map } from 'rxjs/operators';
+import { Taon, TaonBaseAngularService } from 'taon/websql';
+import { TaonMarketingPopupProvider } from './taon-marketing-popup.provider';
+@Injectable()
+export class TaonMarketingPopupConfigService extends TaonBaseAngularService {
+    private taonMarketingPopupProvider = this.injectProvider(TaonMarketingPopupProvider);
+    get isEnableOption() {
+        return this.taonMarketingPopupProvider.enabledTaonMarketingPopupOption;
+    }
+    clone(): Partial<TaonMarketingPopupProvider> {
+        const cloned = this.taonMarketingPopupProvider.clone();
+        return cloned;
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.constants.ts

@@ -0,0 +1,33 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import type { TaonMarketingPopupEntity } from './taon-marketing-popup.entity';
+import { TaonMarketingPopupType } from './taon-marketing-popup.models';
+export const TaonMarketingPopupDefaultsValues = {
+    name: '',
+    enabled: false,
+    type: TaonMarketingPopupType.Dialog,
+    title: null,
+    content: null,
+    imageKey: null,
+    buttonText: null,
+    buttonUrl: null,
+    delaySeconds: 0,
+    displayOnPaths: null,
+    excludePaths: null,
+    startAt: null,
+    endAt: null,
+    maxDisplaysPerVisitor: null,
+    oncePerSession: true,
+    version: 0,
+    id: void 0,
+} satisfies Partial<TaonMarketingPopupEntity>;

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.controller.ts

@@ -0,0 +1,53 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Taon, TaonController, TaonBaseCrudController, Query, GET, POST, PUT, DELETE, Body, } from 'taon/websql';
+import { TaonMarketingPopupEntity } from './taon-marketing-popup.entity';
+import { TaonMarketingPopupRepository } from './taon-marketing-popup.repository';
+import type { TaonMarketingPopupFields } from './taon-marketing-popup.models';
+@TaonController<TaonMarketingPopupController>({
+    className: 'TaonMarketingPopupController',
+    allowedMethods: [
+        'getAll', 'getBy', 'paginationQuery', 'getActivePopups',
+        'savePopup', 'setEnabled', 'deletePopup',
+    ],
+})
+export class TaonMarketingPopupController extends TaonBaseCrudController<TaonMarketingPopupEntity, {}, TaonMarketingPopupController> {
+    entityClassResolveFn: () => typeof TaonMarketingPopupEntity = () => TaonMarketingPopupEntity;
+    private readonly taonMarketingPopupRepository = this.injectCustomRepo(TaonMarketingPopupRepository);
+    @GET()
+    getActivePopups(): Taon.Response<TaonMarketingPopupEntity[]> {
+        return async () => this.taonMarketingPopupRepository.activePopups();
+    }
+    @POST()
+    savePopup(
+    @Body()
+    input: TaonMarketingPopupFields, 
+    @Query('id')
+    id?: number): Taon.Response<TaonMarketingPopupEntity> {
+        return async () => this.taonMarketingPopupRepository.savePopup(input, id);
+    }
+    @PUT()
+    setEnabled(
+    @Query('id')
+    id: number, 
+    @Body('enabled')
+    enabled: boolean): Taon.Response<TaonMarketingPopupEntity> {
+        return async () => this.taonMarketingPopupRepository.setEnabled(id, enabled);
+    }
+    @DELETE()
+    deletePopup(
+    @Query('id')
+    id: number): Taon.Response<void> {
+        return async () => this.taonMarketingPopupRepository.deletePopup(id);
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.entity.ts

@@ -0,0 +1,54 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Column, CreateDateColumn, UpdateDateColumn, TaonBaseAbstractEntity, TaonEntity, } from 'taon/websql';
+import { TaonMarketingPopupType } from './taon-marketing-popup.models';
+@TaonEntity<TaonMarketingPopupEntity>({
+    className: 'TaonMarketingPopupEntity',
+    createTable: true,
+})
+export class TaonMarketingPopupEntity extends TaonBaseAbstractEntity<TaonMarketingPopupEntity> {
+    @Column({ type: 'varchar', length: 200, default: '' })
+    name: string = '';
+    @Column({ type: 'boolean', default: false })
+    enabled: boolean = false;
+    @Column({ type: 'varchar', default: TaonMarketingPopupType.Dialog })
+    type: TaonMarketingPopupType = TaonMarketingPopupType.Dialog;
+    @Column({ type: 'varchar', nullable: true })
+    title: string | null = null;
+    @Column({ type: 'text', nullable: true })
+    content: string | null = null;
+    @Column({ type: 'varchar', nullable: true })
+    imageKey: string | null = null;
+    @Column({ type: 'varchar', nullable: true })
+    buttonText: string | null = null;
+    @Column({ type: 'varchar', nullable: true })
+    buttonUrl: string | null = null;
+    @Column({ type: 'float', default: 0 })
+    delaySeconds: number = 0;
+    @Column({ type: 'simple-json', nullable: true })
+    displayOnPaths: string[] | null = null;
+    @Column({ type: 'simple-json', nullable: true })
+    excludePaths: string[] | null = null;
+    @Column({ type: 'datetime', nullable: true })
+    startAt: Date | null = null;
+    @Column({ type: 'datetime', nullable: true })
+    endAt: Date | null = null;
+    @Column({ type: 'integer', nullable: true })
+    maxDisplaysPerVisitor: number | null = null;
+    @Column({ type: 'boolean', default: true })
+    oncePerSession: boolean = true;
+    @CreateDateColumn({ type: 'datetime' })
+    createdAt: Date;
+    @UpdateDateColumn({ type: 'datetime' })
+    updatedAt: Date;
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.kv.repository.ts

@@ -0,0 +1,24 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { TaonBaseRepository, TaonBaseKvRepository, TaonRepository, } from 'taon/websql';
+import { TaonMarketingPopupEntity } from './taon-marketing-popup.entity';
+@TaonRepository({
+    className: 'TaonMarketingPopupKvRepository',
+})
+export class TaonMarketingPopupKvRepository extends TaonBaseKvRepository<{
+    usersToNotify: TaonMarketingPopupEntity[];
+}> {
+    async notifyUsers(users: TaonMarketingPopupEntity[]) {
+        this.set('usersToNotify', users);
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.middleware.ts

@@ -0,0 +1,19 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Taon, TaonBaseMiddleware, TaonMiddleware } from 'taon/websql';
+import { _ } from 'tnp-core/websql';
+@TaonMiddleware({
+    className: 'TaonMarketingPopupMiddleware',
+})
+export class TaonMarketingPopupMiddleware extends TaonBaseMiddleware {
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.models.ts

@@ -0,0 +1,44 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export enum TaonMarketingPopupType {
+    Dialog = 'dialog',
+    Bottom = 'bottom'
+}
+export interface TaonMarketingPopupFields {
+    name: string;
+    enabled: boolean;
+    type: TaonMarketingPopupType;
+    title: string | null;
+    content: string | null;
+    imageKey: string | null;
+    buttonText: string | null;
+    buttonUrl: string | null;
+    delaySeconds: number;
+    displayOnPaths: string[] | null;
+    excludePaths: string[] | null;
+    startAt: Date | string | null;
+    endAt: Date | string | null;
+    maxDisplaysPerVisitor: number | null;
+    oncePerSession: boolean;
+}
+export interface TaonMarketingPopupEvent {
+    name: 'popup-impression' | 'popup-click' | 'popup-close';
+    category: 'marketing';
+    path: string;
+    data: {
+        popupId: number;
+        type: TaonMarketingPopupType;
+    };
+    createdAt: Date;
+}
+export type TaonMarketingPopupImageResolver = (key: string) => string;

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.provider.ts

@@ -0,0 +1,30 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Taon, TaonBaseClass, TaonBaseProvider, TaonProvider } from 'taon/websql';
+import { _ } from 'tnp-core/websql';
+export class TaonTaonMarketingPopupConfig extends TaonBaseClass {
+    declare name: string;
+}
+@TaonProvider({
+    className: 'TaonMarketingPopupProvider',
+})
+export class TaonMarketingPopupProvider extends TaonBaseProvider {
+    enabledTaonMarketingPopupOption: boolean = true;
+    config = new TaonTaonMarketingPopupConfig();
+    clone() {
+        return {
+            enabledTaonMarketingPopupOption: this.enabledTaonMarketingPopupOption,
+            config: this.config.clone(),
+        };
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.repository.ts

@@ -0,0 +1,77 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { TaonBaseRepository, TaonRepository } from 'taon/websql';
+import { TaonMarketingPopupEntity } from './taon-marketing-popup.entity';
+import type { TaonMarketingPopupFields } from './taon-marketing-popup.models';
+import { TaonMarketingPopupUtils } from './taon-marketing-popup.utils';
+import { popupError, requirePopupId, validatePopup } from './taon-marketing-popup.validation';
+@TaonRepository({
+    className: 'TaonMarketingPopupRepository',
+})
+export class TaonMarketingPopupRepository extends TaonBaseRepository<TaonMarketingPopupEntity> {
+    entityClassResolveFn: () => typeof TaonMarketingPopupEntity = () => TaonMarketingPopupEntity;
+    async activePopups(): Promise<TaonMarketingPopupEntity[]> {
+        const popups = await this.find({ where: { enabled: true }, order: { id: 'ASC' } });
+        const now = new Date();
+        return popups.filter(popup => TaonMarketingPopupUtils.isActive(popup, now));
+    }
+    async savePopup(input: TaonMarketingPopupFields, id?: number): Promise<TaonMarketingPopupEntity> {
+        validatePopup(input);
+        if (id !== undefined) {
+            requirePopupId(id);
+        }
+        const popup = id === undefined
+            ? this.repo.create()
+            : await this.repo.findOneBy({ id });
+        if (!popup) {
+            popupError('Popup was not found.', 404);
+        }
+        Object.assign(popup, {
+            name: input.name.trim(),
+            enabled: input.enabled,
+            type: input.type,
+            title: input.title,
+            content: input.content,
+            imageKey: input.imageKey,
+            buttonText: input.buttonText,
+            buttonUrl: input.buttonUrl,
+            delaySeconds: input.delaySeconds,
+            displayOnPaths: input.displayOnPaths,
+            excludePaths: input.excludePaths,
+            startAt: input.startAt === null ? null : new Date(input.startAt),
+            endAt: input.endAt === null ? null : new Date(input.endAt),
+            maxDisplaysPerVisitor: input.maxDisplaysPerVisitor,
+            oncePerSession: input.oncePerSession,
+        });
+        return this.repo.save(popup);
+    }
+    async setEnabled(id: number, enabled: boolean): Promise<TaonMarketingPopupEntity> {
+        requirePopupId(id);
+        if (typeof enabled !== 'boolean') {
+            popupError('Enabled must be a boolean.');
+        }
+        const popup = await this.repo.findOneBy({ id });
+        if (!popup) {
+            popupError('Popup was not found.', 404);
+        }
+        popup.enabled = enabled;
+        return this.repo.save(popup);
+    }
+    async deletePopup(id: number): Promise<void> {
+        requirePopupId(id);
+        const result = await this.repo.delete(id);
+        if (!result.affected) {
+            popupError('Popup was not found.', 404);
+        }
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.subscriber.ts

@@ -0,0 +1,24 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { TaonBaseSubscriberForEntity, TaonSubscriber } from 'taon/websql';
+import { TaonMarketingPopupEntity } from './taon-marketing-popup.entity';
+import { TaonMarketingPopupProvider } from './taon-marketing-popup.provider';
+@TaonSubscriber<TaonMarketingPopupSubscriber>({
+    className: 'TaonMarketingPopupSubscriber',
+})
+export class TaonMarketingPopupSubscriber extends TaonBaseSubscriberForEntity {
+    private readonly taonMarketingPopupProvider = this.injectProvider(TaonMarketingPopupProvider);
+    listenTo(): typeof TaonMarketingPopupEntity {
+        return TaonMarketingPopupEntity;
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.utils.ts

@@ -0,0 +1,38 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import type { TaonMarketingPopupFields } from './taon-marketing-popup.models';
+export namespace TaonMarketingPopupUtils {
+    export function isActive(popup: TaonMarketingPopupFields, now = new Date()): boolean {
+        return popup.enabled &&
+            (!popup.startAt || new Date(popup.startAt).getTime() <= now.getTime()) &&
+            (!popup.endAt || new Date(popup.endAt).getTime() >= now.getTime());
+    }
+    export function matchesPath(pattern: string, path: string): boolean {
+        const pathname = path.split(/[?#]/, 1)[0];
+        return pattern.endsWith('*')
+            ? pathname.startsWith(pattern.slice(0, -1))
+            : pathname === pattern;
+    }
+    export function isPathPattern(value: string): boolean {
+        return /^\/[^?#\s*]*\*?$/.test(value);
+    }
+    export function allowsPath(popup: TaonMarketingPopupFields, path: string): boolean {
+        return (!popup.displayOnPaths?.length ||
+            popup.displayOnPaths.some(pattern => matchesPath(pattern, path))) &&
+            !popup.excludePaths?.some(pattern => matchesPath(pattern, path));
+    }
+    export function isSafeUrl(value: string): boolean {
+        return !/[\s\\\u0000-\u001f\u007f]/.test(value) &&
+            (/^\/(?!\/)/.test(value) || /^https?:\/\/[^/]+/i.test(value));
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.validation.ts

@@ -0,0 +1,72 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Taon } from 'taon/websql';
+import { TaonMarketingPopupType } from './taon-marketing-popup.models';
+import type { TaonMarketingPopupFields } from './taon-marketing-popup.models';
+import { TaonMarketingPopupUtils } from './taon-marketing-popup.utils';
+export function popupError(message: string, status = 400): never {
+    Taon.error({ message, status });
+    throw new Error(message);
+}
+export function requirePopupId(id: number): void {
+    if (!Number.isSafeInteger(id) || id <= 0) {
+        popupError('Popup ID must be a positive integer.');
+    }
+}
+export function validatePopup(input: TaonMarketingPopupFields): void {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        popupError('Popup must be an object.');
+    }
+    if (typeof input.name !== 'string' || !input.name.trim() || input.name.length > 200) {
+        popupError('Name is required and must not exceed 200 characters.');
+    }
+    if (!Object.values(TaonMarketingPopupType).includes(input.type)) {
+        popupError('Popup type must be dialog or bottom.');
+    }
+    if (typeof input.enabled !== 'boolean' || typeof input.oncePerSession !== 'boolean') {
+        popupError('Enabled and oncePerSession must be booleans.');
+    }
+    if (!Number.isFinite(input.delaySeconds) || input.delaySeconds < 0 ||
+        input.delaySeconds > 2147483) {
+        popupError('Delay must be between 0 and 2147483 seconds.');
+    }
+    if (input.maxDisplaysPerVisitor !== null &&
+        (!Number.isSafeInteger(input.maxDisplaysPerVisitor) || input.maxDisplaysPerVisitor < 1)) {
+        popupError('Maximum displays must be a positive integer or null.');
+    }
+    for (const field of ['title', 'content', 'imageKey', 'buttonText', 'buttonUrl'] as const) {
+        if (input[field] !== null && typeof input[field] !== 'string') {
+            popupError(`${field} must be a string or null.`);
+        }
+    }
+    if (input.buttonUrl && !TaonMarketingPopupUtils.isSafeUrl(input.buttonUrl)) {
+        popupError('Button URL must be an HTTP(S) URL or a root-relative path.');
+    }
+    for (const field of ['displayOnPaths', 'excludePaths'] as const) {
+        const paths = input[field];
+        if (paths !== null && (!Array.isArray(paths) || paths.some(path => typeof path !== 'string' || !TaonMarketingPopupUtils.isPathPattern(path)))) {
+            popupError(`${field} must contain paths beginning with / and an optional trailing *.`);
+        }
+    }
+    for (const field of ['startAt', 'endAt'] as const) {
+        const date = input[field];
+        if (date !== null && (!(date instanceof Date || typeof date === 'string') ||
+            !Number.isFinite(new Date(date).getTime()))) {
+            popupError(`${field} must be a valid date or null.`);
+        }
+    }
+    if (input.startAt && input.endAt &&
+        new Date(input.startAt).getTime() > new Date(input.endAt).getTime()) {
+        popupError('End date must not precede start date.');
+    }
+}

package/ts-source/websql-code/taon-marketing-popup/taon-marketing-popup.validators.ts

@@ -0,0 +1,38 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:watch:lib
+  inside @taon-dev/marketing project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { ValidatorFn } from '@angular/forms';
+import { TaonMarketingPopupUtils } from './taon-marketing-popup.utils';
+export namespace TaonMarketingPopupValidators {
+    export const paths: ValidatorFn = control => {
+        const value: unknown = control.value;
+        return typeof value === 'string' &&
+            value.split('\n').map(path => path.trim()).filter(Boolean)
+                .every(path => TaonMarketingPopupUtils.isPathPattern(path))
+            ? null : { popupPaths: true };
+    };
+    export const url: ValidatorFn = control => {
+        const value: unknown = control.value;
+        return typeof value === 'string' &&
+            (!value.trim() || TaonMarketingPopupUtils.isSafeUrl(value.trim()))
+            ? null : { popupUrl: true };
+    };
+    export const optionalPositiveInteger: ValidatorFn = control => control.value === null ||
+        (Number.isSafeInteger(control.value) && control.value > 0)
+        ? null : { popupDisplayLimit: true };
+    export const optionalDate: ValidatorFn = control => {
+        const value: unknown = control.value;
+        return typeof value === 'string' &&
+            (!value || Number.isFinite(new Date(value).getTime()))
+            ? null : { popupDate: true };
+    };
+}