@goatlab/node-backend 0.0.16 → 0.1.0

package/dist/server/services/secrets/secret.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.service.js","sourceRoot":"","sources":["../../../../src/server/services/secrets/secret.service.ts"],"names":[],"mappings":"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"}

package/dist/server/services/sendgrid/sendgrid.model.d.ts

@@ -0,0 +1,118 @@
+import type { EmailAddress, EmailAttachment } from '../email/email.model';
+export interface SendgridHTMLEmailRequest {
+    fromEmail: string;
+    fromName: string;
+    replyTo: string;
+    subject: string;
+    html: string;
+    categories: string[];
+    recipients: [
+        {
+            email: string;
+            name?: string;
+        }
+    ];
+    bcc?: EmailAddress[];
+    attachments?: EmailAttachment[];
+}
+export interface SendGridEmailResponse {
+    isSuccess: boolean;
+    statusCode: number;
+    body: string | Record<string, string>;
+    headers: Record<string, string>;
+}
+export interface TrackingSettingsJSON {
+    click_tracking?: {
+        enable?: boolean;
+        enable_text?: boolean;
+    };
+    open_tracking?: {
+        enable?: boolean;
+        substitution_tag?: string;
+    };
+    subscription_tracking?: {
+        enable?: boolean;
+        text?: string;
+        html?: string;
+        substitution_tag?: string;
+    };
+    ganalytics?: {
+        enable?: boolean;
+        utm_source?: string;
+        utm_medium?: string;
+        utm_term?: string;
+        utm_content?: string;
+        utm_campaign?: string;
+    };
+}
+export interface MailSettingsJSON {
+    bcc?: {
+        enable?: boolean;
+        email?: string;
+    };
+    bypass_list_management?: {
+        enable?: boolean;
+    };
+    footer?: {
+        enable?: boolean;
+        text?: string;
+        html?: string;
+    };
+    sandbox_mode?: {
+        enable?: boolean;
+    };
+    spam_check?: {
+        enable?: boolean;
+        threshold?: number;
+        post_to_url?: string;
+    };
+}
+export interface ASMOptionsJSON {
+    group_id: number;
+    groups_to_display?: number[];
+}
+export interface MailContent {
+    type: string;
+    value: string;
+}
+export interface AttachmentJSON {
+    content: string;
+    filename: string;
+    type?: string;
+    disposition?: string;
+    content_id?: string;
+}
+export interface EmailJSON {
+    name?: string;
+    email: string;
+}
+export interface PersonalizationJSON {
+    to: EmailJSON | EmailJSON[];
+    cc?: EmailJSON[];
+    bcc?: EmailJSON[];
+    headers?: Record<string, string>;
+    substitutions?: Record<string, string>;
+    dynamic_template_data?: Record<string, string>;
+    custom_args?: Record<string, string>;
+    subject?: string;
+    send_at?: number;
+}
+export interface MailJSON {
+    from: EmailJSON;
+    subject: string;
+    content: MailContent[];
+    personalizations: PersonalizationJSON[];
+    attachments?: AttachmentJSON[] | EmailAttachment[];
+    categories?: string[];
+    headers?: Record<string, string>;
+    mail_settings?: MailSettingsJSON;
+    tracking_settings?: TrackingSettingsJSON;
+    custom_args?: Record<string, string>;
+    sections?: Record<string, string>;
+    asm?: ASMOptionsJSON;
+    reply_to?: EmailJSON;
+    send_at?: number;
+    batch_id?: string;
+    template_id?: string;
+    ip_pool_name?: string;
+}

package/dist/server/services/sendgrid/sendgrid.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sendgrid.model.js.map

package/dist/server/services/sendgrid/sendgrid.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgrid.model.js","sourceRoot":"","sources":["../../../../src/server/services/sendgrid/sendgrid.model.ts"],"names":[],"mappings":""}

package/dist/server/services/sendgrid/sendgridApi.service.d.ts

@@ -0,0 +1,13 @@
+import { KyInstance } from '@goatlab/js-utils';
+import type { SendGridEmailResponse, SendgridHTMLEmailRequest } from './sendgrid.model';
+export declare class SendgridService {
+    sendgridApi: KyInstance | undefined;
+    shouldSendEmail: boolean;
+    fromEmail: string;
+    constructor({ token, shouldSendEmail, fromEmail, }: {
+        token: string;
+        shouldSendEmail?: boolean;
+        fromEmail: string;
+    });
+    sendFinalizedEmail(request: SendgridHTMLEmailRequest): Promise<SendGridEmailResponse>;
+}

package/dist/server/services/sendgrid/sendgridApi.service.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendgridService = void 0;
+const js_utils_1 = require("@goatlab/js-utils");
+class SendgridService {
+    sendgridApi = undefined;
+    shouldSendEmail = true;
+    fromEmail = 'test@example.com';
+    constructor({ token, shouldSendEmail = true, fromEmail, }) {
+        this.sendgridApi = js_utils_1.Http.getClient({
+            prefixUrl: 'https://api.sendgrid.com/v3/',
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+            retry: {
+                limit: 3,
+                // Sendgrid uses POST
+                methods: ['POST'],
+            },
+        });
+        this.shouldSendEmail = shouldSendEmail;
+        this.fromEmail = fromEmail;
+    }
+    // https://docs.sendgrid.com/api-reference/mail-send/mail-send
+    async sendFinalizedEmail(request) {
+        if (this.shouldSendEmail) {
+            console.log('NOT SENDING EMAILS - shouldSendEmail=false');
+            return {
+                isSuccess: false,
+                statusCode: 1,
+                body: {},
+                headers: {},
+            };
+        }
+        const json = {
+            personalizations: [
+                {
+                    to: request.recipients,
+                    bcc: request.bcc?.length ? request.bcc : undefined,
+                },
+            ],
+            subject: request.subject,
+            categories: request.categories,
+            content: [{ type: 'text/html', value: request.html }],
+            from: {
+                email: this.fromEmail,
+                name: request.fromName,
+            },
+            reply_to: { email: request.replyTo },
+            tracking_settings: {
+                click_tracking: {
+                    enable: true,
+                    enable_text: true,
+                },
+                open_tracking: {
+                    enable: true,
+                },
+            },
+            attachments: request.attachments?.length
+                ? request.attachments
+                : undefined,
+        };
+        if (!this.sendgridApi) {
+            return {
+                isSuccess: false,
+                statusCode: 1,
+                body: {},
+                headers: {},
+            };
+        }
+        return await this.sendgridApi
+            .post('mail/send', {
+            json,
+        })
+            .json();
+    }
+}
+exports.SendgridService = SendgridService;
+//# sourceMappingURL=sendgridApi.service.js.map

package/dist/server/services/sendgrid/sendgridApi.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgridApi.service.js","sourceRoot":"","sources":["../../../../src/server/services/sendgrid/sendgridApi.service.ts"],"names":[],"mappings":";;;AAAA,gDAAoD;AAOpD,MAAa,eAAe;IAC1B,WAAW,GAA2B,SAAS,CAAA;IAC/C,eAAe,GAAY,IAAI,CAAA;IAC/B,SAAS,GAAW,kBAAkB,CAAA;IAEtC,YAAY,EACV,KAAK,EACL,eAAe,GAAG,IAAI,EACtB,SAAS,GAKV;QACC,IAAI,CAAC,WAAW,GAAG,eAAI,CAAC,SAAS,CAAC;YAChC,SAAS,EAAE,8BAA8B;YACzC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC;gBACR,qBAAqB;gBACrB,OAAO,EAAE,CAAC,MAAM,CAAC;aAClB;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;QACtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,kBAAkB,CACtB,OAAiC;QAEjC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAA;YACzD,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,EAAE;aACZ,CAAA;QACH,CAAC;QAED,MAAM,IAAI,GAAa;YACrB,gBAAgB,EAAE;gBAChB;oBACE,EAAE,EAAE,OAAO,CAAC,UAAU;oBACtB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;iBACnD;aACF;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,EAAE;gBACJ,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,IAAI,EAAE,OAAO,CAAC,QAAQ;aACvB;YACD,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;YACpC,iBAAiB,EAAE;gBACjB,cAAc,EAAE;oBACd,MAAM,EAAE,IAAI;oBACZ,WAAW,EAAE,IAAI;iBAClB;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,IAAI;iBACb;aACF;YACD,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM;gBACtC,CAAC,CAAC,OAAO,CAAC,WAAW;gBACrB,CAAC,CAAC,SAAS;SACd,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,EAAE;aACZ,CAAA;QACH,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,WAAW;aAC1B,IAAI,CAAC,WAAW,EAAE;YACjB,IAAI;SACL,CAAC;aACD,IAAI,EAAyB,CAAA;IAClC,CAAC;CACF;AAxFD,0CAwFC"}

package/dist/server/services/sendgrid/sendgridHooks.model.d.ts

@@ -0,0 +1,27 @@
+import type { EmailCategory } from '../email/email.model';
+export declare enum SendgridEventType {
+    processed = "processed",
+    dropped = "dropped",
+    bounce = "bounce",
+    deferred = "deferred",
+    delivered = "delivered",
+    open = "open",
+    click = "click",
+    unsubscribe = "unsubscribe",
+    spamreport = "spamreport"
+}
+export interface SendgridEvent {
+    email: string;
+    category?: EmailCategory[];
+    'smtp-id'?: string;
+    sg_event_id: string;
+    sg_message_id?: string;
+    timestamp: number;
+    event: SendgridEventType;
+    ip?: string;
+    url?: string;
+    useragent?: string;
+    response?: string;
+    reason?: string;
+    status?: string;
+}

package/dist/server/services/sendgrid/sendgridHooks.model.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendgridEventType = void 0;
+var SendgridEventType;
+(function (SendgridEventType) {
+    // Process events
+    SendgridEventType["processed"] = "processed";
+    SendgridEventType["dropped"] = "dropped";
+    // Deliver events
+    SendgridEventType["bounce"] = "bounce";
+    SendgridEventType["deferred"] = "deferred";
+    SendgridEventType["delivered"] = "delivered";
+    // Read events
+    SendgridEventType["open"] = "open";
+    SendgridEventType["click"] = "click";
+    SendgridEventType["unsubscribe"] = "unsubscribe";
+    SendgridEventType["spamreport"] = "spamreport";
+})(SendgridEventType || (exports.SendgridEventType = SendgridEventType = {}));
+//# sourceMappingURL=sendgridHooks.model.js.map

package/dist/server/services/sendgrid/sendgridHooks.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgridHooks.model.js","sourceRoot":"","sources":["../../../../src/server/services/sendgrid/sendgridHooks.model.ts"],"names":[],"mappings":";;;AAEA,IAAY,iBAeX;AAfD,WAAY,iBAAiB;IAC3B,iBAAiB;IACjB,4CAAuB,CAAA;IACvB,wCAAmB,CAAA;IAEnB,iBAAiB;IACjB,sCAAiB,CAAA;IACjB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IAEvB,cAAc;IACd,kCAAa,CAAA;IACb,oCAAe,CAAA;IACf,gDAA2B,CAAA;IAC3B,8CAAyB,CAAA;AAC3B,CAAC,EAfW,iBAAiB,iCAAjB,iBAAiB,QAe5B"}

package/dist/server/services/translations/template.util.d.ts

@@ -0,0 +1,7 @@
+import type { AnyObject } from '@goatlab/js-utils';
+import type { PupaOptions } from '@goatlab/js-utils/dist/Strings/pupa';
+declare class TemplateUtil {
+    renderString(tmpl: string, params?: AnyObject, opt?: PupaOptions): string;
+}
+export declare const templateUtil: TemplateUtil;
+export {};

package/dist/server/services/translations/template.util.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateUtil = void 0;
+const js_utils_1 = require("@goatlab/js-utils");
+class TemplateUtil {
+    renderString(tmpl, params = {}, opt = {}) {
+        return js_utils_1.Strings.pupa(tmpl, params, opt);
+    }
+}
+exports.templateUtil = new TemplateUtil();
+//# sourceMappingURL=template.util.js.map

package/dist/server/services/translations/template.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.util.js","sourceRoot":"","sources":["../../../../src/server/services/translations/template.util.ts"],"names":[],"mappings":";;;AAEA,gDAA2C;AAE3C,MAAM,YAAY;IAChB,YAAY,CACV,IAAY,EACZ,SAAoB,EAAE,EACtB,MAAmB,EAAE;QAErB,OAAO,kBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;CACF;AAEY,QAAA,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA"}

package/dist/server/services/translations/translation.model.d.ts

@@ -0,0 +1,4 @@
+export type LANG = 'en_us' | 'en_gb' | 'es_us' | 'es_cl' | 'es_mx';
+export declare const SUPPORTED_LANGUAGES: LANG[];
+export declare const LANG_DEFAULT = "en_us";
+export declare const missingTranslationExcludeList: Set<string>;

package/dist/server/services/translations/translation.model.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.missingTranslationExcludeList = exports.LANG_DEFAULT = void 0;
+exports.LANG_DEFAULT = 'en_us';
+exports.missingTranslationExcludeList = new Set([]);
+//# sourceMappingURL=translation.model.js.map

package/dist/server/services/translations/translation.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.model.js","sourceRoot":"","sources":["../../../../src/server/services/translations/translation.model.ts"],"names":[],"mappings":";;;AAGa,QAAA,YAAY,GAAG,OAAO,CAAA;AAEtB,QAAA,6BAA6B,GAAG,IAAI,GAAG,CAAS,EAAE,CAAC,CAAA"}

package/dist/server/services/translations/translation.service.d.ts

@@ -0,0 +1,25 @@
+import type { StringMap } from '@goatlab/js-utils';
+import { LANG } from './translation.model';
+export interface UserLanguageOptions {
+    language: LANG | null;
+}
+declare class TranslationService {
+    getLocale(lang: LANG | null): StringMap;
+    getLocaleMap(): Record<LANG, StringMap>;
+    missingKey(key: string): string;
+    translate(key: string, acc: UserLanguageOptions, args?: any): string;
+    /**
+     * Implementation based on static ./src/lang/*.json files
+     */
+    translateIfExists(key: string, user: UserLanguageOptions, args?: {}): string | undefined;
+    formatResult(key: string, text: string, args?: {}): string;
+    reportMissing(key: string, opt: UserLanguageOptions): void;
+    /**
+     * Based on: https://nodejs.org/api/intl.html#intl_detecting_internationalization_support
+     */
+    hasFullICU(): boolean;
+}
+export declare const translationService: TranslationService;
+export declare function tr(key: string, user: UserLanguageOptions, args?: {}): string;
+export declare function trIfExists(key: string, user: UserLanguageOptions, args?: {}): string | undefined;
+export {};

package/dist/server/services/translations/translation.service.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translationService = void 0;
+exports.tr = tr;
+exports.trIfExists = trIfExists;
+const pupa_1 = require("@goatlab/js-utils/dist/Strings/pupa");
+const consts_1 = require("../../consts");
+const template_util_1 = require("./template.util");
+const translation_model_1 = require("./translation.model");
+class TranslationService {
+    // @Memo.syncMethod()
+    getLocale(lang) {
+        try {
+            return { ...require(`${consts_1.config.langDir}/${lang}.json`) };
+        }
+        catch {
+            console.warn(`Unsupported lang ${lang}`);
+            return undefined;
+        }
+    }
+    getLocaleMap() {
+        return translation_model_1.SUPPORTED_LANGUAGES.reduce((map, lang) => {
+            map[lang] = this.getLocale(lang);
+            return map;
+        }, {});
+    }
+    missingKey(key) {
+        return `[${key}]`;
+    }
+    translate(key, acc, args = {}) {
+        const v = this.translateIfExists(key, acc, args);
+        if (!v) {
+            this.reportMissing(key, acc);
+            if (process.env.MOCK_LANG && process.env.MOCK_LANG_THROW_IF_NOT_FOUND) {
+                throw new Error(`key ${key} does not exist`);
+            }
+        }
+        return v ?? this.missingKey(key);
+    }
+    /**
+     * Implementation based on static ./src/lang/*.json files
+     */
+    translateIfExists(key, user, args = {}) {
+        const fallbackLocale = this.getLocale(translation_model_1.LANG_DEFAULT);
+        const locale = this.getLocale(user.language);
+        const value = locale[key] ?? fallbackLocale[key];
+        return value && this.formatResult(key, value, args);
+    }
+    formatResult(key, text, args = {}) {
+        if (process.env.MOCK_LANG) {
+            return `** ${key} **`;
+        }
+        if (Object.keys(args).length) {
+            try {
+                return template_util_1.templateUtil.renderString(text, args);
+            }
+            catch (err) {
+                if (err instanceof pupa_1.MissingValueError) {
+                    // sentryService.captureMessage(
+                    //   `template value missing for key=${key}, param=${err.key}`,
+                    // )
+                    return template_util_1.templateUtil.renderString(text, args, { ignoreMissing: true });
+                }
+                throw err;
+            }
+        }
+        else {
+            return text;
+        }
+    }
+    reportMissing(key, opt) {
+        console.log(opt); // For Sentry
+        //sentryService.captureMessage(`translation missing for key=${key}}`)
+    }
+    /**
+     * Based on: https://nodejs.org/api/intl.html#intl_detecting_internationalization_support
+     */
+    hasFullICU() {
+        try {
+            const january = new Date(9e8);
+            const spanish = new Intl.DateTimeFormat('es', { month: 'long' });
+            return spanish.format(january) === 'enero';
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.translationService = new TranslationService();
+// Alias
+function tr(key, user, args = {}) {
+    return exports.translationService.translate(key, user, args);
+}
+function trIfExists(key, user, args = {}) {
+    return exports.translationService.translateIfExists(key, user, args);
+}
+//# sourceMappingURL=translation.service.js.map

package/dist/server/services/translations/translation.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.service.js","sourceRoot":"","sources":["../../../../src/server/services/translations/translation.service.ts"],"names":[],"mappings":"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"}

package/dist/server/services/util/benchmarker.d.ts

@@ -0,0 +1,13 @@
+export interface BenchmarkResult {
+    'Task name': string;
+    'Latency avg (ns)': string;
+    'Latency med (ns)': string;
+    'Throughput avg (ops/s)': string;
+    'Throughput med (ops/s)': string;
+    Samples: number;
+}
+export declare function analyzeBenchmarkResults(results: BenchmarkResult[]): {
+    name: string;
+    latencyImprovement: number;
+    throughputImprovement: number;
+}[];

package/dist/server/services/util/benchmarker.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeBenchmarkResults = analyzeBenchmarkResults;
+function analyzeBenchmarkResults(results) {
+    const parseValue = (value) => parseFloat(value.split(' ± ')[0]);
+    // Extract numeric values
+    const parsedResults = results.map((r) => ({
+        name: r['Task name'],
+        latencyAvg: parseValue(r['Latency avg (ns)']),
+        latencyMed: parseValue(r['Latency med (ns)']),
+        throughputAvg: parseValue(r['Throughput avg (ops/s)']),
+        throughputMed: parseValue(r['Throughput med (ops/s)']),
+        samples: r.Samples,
+    }));
+    console.log({ parsedResults });
+    // Find the best performers
+    const bestLatency = Math.min(...parsedResults.map((r) => r.latencyAvg)); // Lower is better
+    const bestThroughput = Math.max(...parsedResults.map((r) => r.throughputAvg)); // Higher is better
+    // Calculate improvements
+    const analysis = parsedResults.map((r) => ({
+        name: r.name,
+        latencyImprovement: ((bestLatency - r.latencyAvg) / bestLatency) * 100, // Lower is better
+        throughputImprovement: ((r.throughputAvg - bestThroughput) / bestThroughput) * 100, // Higher is better
+    }));
+    // Sort results from best to worst (by latency)
+    const sortedAnalysis = analysis.sort((a, b) => b.latencyImprovement - a.latencyImprovement);
+    console.table(sortedAnalysis.map(({ name, latencyImprovement, throughputImprovement }) => ({
+        'Task Name': name,
+        'Latency Improvement (%)': latencyImprovement.toFixed(2),
+        'Throughput Improvement (%)': throughputImprovement.toFixed(2),
+    })));
+    return sortedAnalysis;
+}
+//# sourceMappingURL=benchmarker.js.map

package/dist/server/services/util/benchmarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmarker.js","sourceRoot":"","sources":["../../../../src/server/services/util/benchmarker.ts"],"names":[],"mappings":";;AASA,0DA4CC;AA5CD,SAAgB,uBAAuB,CAAC,OAA0B;IAChE,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAC3C,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnC,yBAAyB;IACzB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC;QACpB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC7C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC7C,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;QACtD,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAA;IAEH,OAAO,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;IAE9B,2BAA2B;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA,CAAC,kBAAkB;IAC1F,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAA,CAAC,mBAAmB;IAEjG,yBAAyB;IACzB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,kBAAkB,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,GAAG,GAAG,EAAE,kBAAkB;QAC1F,qBAAqB,EACnB,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,cAAc,CAAC,GAAG,cAAc,CAAC,GAAG,GAAG,EAAE,mBAAmB;KACnF,CAAC,CAAC,CAAA;IAEH,+CAA+C;IAC/C,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CACtD,CAAA;IAED,OAAO,CAAC,KAAK,CACX,cAAc,CAAC,GAAG,CAChB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,WAAW,EAAE,IAAI;QACjB,yBAAyB,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,4BAA4B,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;KAC/D,CAAC,CACH,CACF,CAAA;IAED,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/server/services/util/pagination.d.ts

@@ -0,0 +1,50 @@
+import type { z, ZodTypeAny } from 'zod';
+interface PaginationParams<T> {
+    cursor?: number | null;
+    perPage?: number;
+    total: number;
+    items: T[];
+}
+interface PaginationResult<T> {
+    total: number;
+    perPage: number;
+    currentPage: number;
+    lastPage: number;
+    nextPage: number | null;
+    previousPage: number | null;
+    data: T[];
+}
+/**
+ * Class to handle pagination calculations and operations.
+ */
+declare class PaginationUtility {
+    /**
+     * Calculates the page number and the number of items to skip based on the cursor and items per page.
+     * @param cursor The current page number, defaults to 1 if not provided.
+     * @param perPage The number of items per page, defaults to 10 if not provided.
+     * @returns An object with the calculated page number and skip count.
+     */
+    calculatePaginationCursor({ cursor, perPage, }: {
+        cursor?: number | null;
+        perPage?: number | null;
+    }): {
+        page: number;
+        skip: number;
+    };
+    /**
+     * Paginates an array of items.
+     * @param cursor The page number to retrieve.
+     * @param perPage The number of items per page.
+     * @param total The total number of items.
+     * @param items The array of items to paginate.
+     * @returns The paginated result including metadata.
+     */
+    paginate<T>({ cursor, perPage, total, items, }: PaginationParams<T>): PaginationResult<T>;
+    getNextCursor<T extends ZodTypeAny>({ limit, items, schema, }: {
+        limit: number;
+        items: any[];
+        schema: T;
+    }): z.infer<T> | undefined;
+}
+export declare const paginationUtility: PaginationUtility;
+export {};

package/dist/server/services/util/pagination.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginationUtility = void 0;
+/**
+ * Class to handle pagination calculations and operations.
+ */
+class PaginationUtility {
+    /**
+     * Calculates the page number and the number of items to skip based on the cursor and items per page.
+     * @param cursor The current page number, defaults to 1 if not provided.
+     * @param perPage The number of items per page, defaults to 10 if not provided.
+     * @returns An object with the calculated page number and skip count.
+     */
+    calculatePaginationCursor({ cursor = 1, perPage = 10, }) {
+        const page = Math.max(1, cursor ?? 1);
+        const itemsPerPage = Math.max(1, perPage ?? 10);
+        const skip = (page - 1) * itemsPerPage;
+        return { page, skip };
+    }
+    /**
+     * Paginates an array of items.
+     * @param cursor The page number to retrieve.
+     * @param perPage The number of items per page.
+     * @param total The total number of items.
+     * @param items The array of items to paginate.
+     * @returns The paginated result including metadata.
+     */
+    paginate({ cursor = 1, perPage = 10, total, items, }) {
+        const page = Math.max(1, cursor ?? 1);
+        const itemsPerPage = Math.max(1, perPage || 10);
+        const lastPage = Math.ceil(total / itemsPerPage);
+        const nextPage = page + 1 <= lastPage ? page + 1 : null;
+        const previousPage = page - 1 >= 1 ? page - 1 : null;
+        return {
+            total,
+            perPage: itemsPerPage,
+            currentPage: page,
+            lastPage,
+            nextPage,
+            previousPage,
+            data: items,
+        };
+    }
+    getNextCursor({ limit, items, schema, }) {
+        let nextCursor;
+        if (items.length > limit) {
+            const nextItem = items.pop();
+            if (nextItem) {
+                // Validate and pick properties based on the provided Zod schema
+                nextCursor = schema.safeParse(nextItem).data;
+            }
+        }
+        return nextCursor;
+    }
+}
+exports.paginationUtility = new PaginationUtility();
+//# sourceMappingURL=pagination.js.map

package/dist/server/services/util/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../../src/server/services/util/pagination.ts"],"names":[],"mappings":";;;AAmBA;;GAEG;AACH,MAAM,iBAAiB;IACrB;;;;;OAKG;IACH,yBAAyB,CAAC,EACxB,MAAM,GAAG,CAAC,EACV,OAAO,GAAG,EAAE,GAIb;QACC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,CAAA;QAEtC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAI,EACV,MAAM,GAAG,CAAC,EACV,OAAO,GAAG,EAAE,EACZ,KAAK,EACL,KAAK,GACe;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,CAAA;QAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACvD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAEpD,OAAO;YACL,KAAK;YACL,OAAO,EAAE,YAAY;YACrB,WAAW,EAAE,IAAI;YACjB,QAAQ;YACR,QAAQ;YACR,YAAY;YACZ,IAAI,EAAE,KAAK;SACZ,CAAA;IACH,CAAC;IAED,aAAa,CAAuB,EAClC,KAAK,EACL,KAAK,EACL,MAAM,GAKP;QACC,IAAI,UAAkC,CAAA;QAEtC,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;YAE5B,IAAI,QAAQ,EAAE,CAAC;gBACb,gEAAgE;gBAChE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAA;YAC9C,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;CACF;AAEY,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAA"}