@sera4/essentia 3.0.13 → 3.1.0-rc.1

package/dist/ts/last-commit/index.js

@@ -0,0 +1,82 @@
+import fs from "node:fs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import async from "async";
+import git from "git-rev";
+const appDir = dirname(fileURLToPath(import.meta.url));
+const commitFile = `${appDir}/last-commit.json`;
+const lastCommit = {
+    parseLastCommit() {
+        return new Promise((resolve, reject) => {
+            async.waterfall([
+                (next) => {
+                    const commit = {};
+                    git.branch((str) => {
+                        commit.branch = str;
+                        next(null, commit);
+                    });
+                },
+                (commit, next) => {
+                    git.long((str) => {
+                        commit.commit = str; // Fixed typo: was "commmit"
+                        next(null, commit);
+                    });
+                },
+            ], (err, commit) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(commit);
+                }
+            });
+        });
+    },
+    getLastCommit() {
+        return new Promise((resolve, reject) => {
+            fs.readFile(commitFile, "utf8", (err, data) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    try {
+                        const commit = JSON.parse(data);
+                        resolve(commit);
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                }
+            });
+        });
+    },
+    getLastCommitSync() {
+        const data = fs.readFileSync(commitFile, "utf8");
+        return JSON.parse(data);
+    },
+    writeLastCommit() {
+        return new Promise((resolve, reject) => {
+            async.waterfall([
+                (next) => {
+                    this.parseLastCommit()
+                        .then((commit) => next(null, commit))
+                        .catch((e) => next(e));
+                },
+                (commit, next) => {
+                    fs.writeFile(commitFile, JSON.stringify(commit, null, 2), "utf8", (err) => {
+                        next(err, commit);
+                    });
+                },
+            ], (err, commit) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(commit);
+                }
+            });
+        });
+    },
+};
+export default lastCommit;
+//# sourceMappingURL=index.js.map

package/dist/ts/last-commit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/last-commit/index.ts"],"names":[],"mappings":"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"}

package/dist/ts/logger/index.d.ts

@@ -0,0 +1,4 @@
+import { S4Logger } from "./s4-logger.js";
+export { S4Logger };
+export { LOG_LEVELS, type LogLevel, type ResolveLogLevelOptions } from "./s4-logger.js";
+export default S4Logger;

package/dist/ts/logger/index.js

@@ -0,0 +1,5 @@
+import { S4Logger } from "./s4-logger.js";
+export { S4Logger };
+export { LOG_LEVELS } from "./s4-logger.js";
+export default S4Logger;
+//# sourceMappingURL=index.js.map

package/dist/ts/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,UAAU,EAA8C,MAAM,gBAAgB,CAAC;AACxF,eAAe,QAAQ,CAAC"}

package/dist/ts/logger/s4-logger.d.ts

@@ -0,0 +1,41 @@
+import "winston-logstash";
+export declare const LOG_LEVELS: readonly ["error", "warn", "info", "debug", "trace"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export interface ResolveLogLevelOptions {
+    /** Default level used when env var is unset or invalid. */
+    defaultLevel?: string;
+    /** Whether the runtime is production. Defaults to NODE_ENV === 'production'. */
+    isProduction?: boolean;
+    /** Env var to read. Defaults to 'S4_LOG_LEVEL'. */
+    envVar?: string;
+    /** Tag used in the warning emitted when the requested level is rejected. */
+    warnTag?: string;
+}
+interface LoggerOptions {
+    level?: string;
+    service?: string;
+    format?: "logstash" | "json" | "default";
+}
+export declare class S4Logger {
+    configure(options?: LoggerOptions): void;
+    setLevel(level?: string): void;
+    /**
+     * Resolve a log level from the environment, applying a production floor of
+     * `info` (debug/trace are rejected with a console warning in prod). Returns
+     * the default level when the env var is unset or invalid.
+     */
+    static resolveLogLevel(options?: ResolveLogLevelOptions): LogLevel;
+    mute(): void;
+    unmute(): void;
+    trace(...args: any[]): void;
+    debug(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    error(...args: any[]): void;
+    getStream(): {
+        write: (message: string, encoding?: string) => void;
+    };
+}
+declare const s4logger: S4Logger;
+export default s4logger;

package/dist/ts/logger/s4-logger.js

@@ -0,0 +1,134 @@
+import util from "node:util";
+import jsonStringify from "fast-safe-stringify";
+import winston from "winston";
+import "winston-logstash";
+const colorizer = winston.format.colorize();
+// IETF RFC5424:
+// Severity of all levels is assumed to be numerically ascending from most important to least important.
+const levels = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+    trace: 4,
+};
+export const LOG_LEVELS = ["error", "warn", "info", "debug", "trace"];
+// Levels below 'info' are too noisy for production. We enforce an info+ floor
+// so an accidental S4_LOG_LEVEL=debug can't leak verbose logs into prod.
+const PROD_DISALLOWED_LEVELS = new Set(["debug", "trace"]);
+function isLogLevel(value) {
+    return typeof value === "string" && LOG_LEVELS.includes(value.toLowerCase());
+}
+// These colors are not used, however if colors are not defined for custom levels
+// then winston will throw an exception.
+winston.addColors({
+    trace: "white",
+});
+const defaultLevel = process.env.NODE_ENV === "production" ? "info" : "debug";
+const devFormat = {
+    transform(info) {
+        const { message } = info;
+        const level = info[Symbol.for("level")];
+        const args = info[Symbol.for("splat")];
+        const strArgs = args ? args.map(jsonStringify).join(" ") : "";
+        info[Symbol.for("message")] = `${colorizer.colorize(level, `${level}:\t`)}${message} ${strArgs}`;
+        return info;
+    },
+};
+const defaultTransport = new winston.transports.Console({
+    format: devFormat,
+    level: "trace",
+});
+const logger = winston.createLogger({
+    levels: levels,
+    level: defaultLevel,
+    defaultMeta: {},
+    transports: [defaultTransport],
+});
+export class S4Logger {
+    configure(options) {
+        if (!options) {
+            return;
+        }
+        this.setLevel(options.level);
+        logger.defaultMeta.service = options.service;
+        switch (options.format?.toLowerCase()) {
+            case "logstash":
+                defaultTransport.format = winston.format.logstash();
+                break;
+            case "json":
+                defaultTransport.format = winston.format.json();
+                break;
+            default:
+                defaultTransport.format = devFormat;
+                break;
+        }
+    }
+    setLevel(level) {
+        if (isLogLevel(level)) {
+            logger.level = level;
+            // Also update the transport level to ensure proper filtering
+            defaultTransport.level = level;
+        }
+    }
+    /**
+     * Resolve a log level from the environment, applying a production floor of
+     * `info` (debug/trace are rejected with a console warning in prod). Returns
+     * the default level when the env var is unset or invalid.
+     */
+    static resolveLogLevel(options = {}) {
+        const isProduction = options.isProduction ?? process.env.NODE_ENV === "production";
+        const fallbackDefault = isProduction ? "info" : "debug";
+        const defaultLevel = isLogLevel(options.defaultLevel) ? options.defaultLevel.toLowerCase() : fallbackDefault;
+        const envVar = options.envVar ?? "S4_LOG_LEVEL";
+        const warnTag = options.warnTag ?? "[s4-logger]";
+        const requested = process.env[envVar];
+        if (!isLogLevel(requested)) {
+            return defaultLevel;
+        }
+        const normalized = requested.toLowerCase();
+        if (isProduction && PROD_DISALLOWED_LEVELS.has(normalized)) {
+            console.warn(`${warnTag} Ignoring ${envVar}=${normalized} in production; falling back to '${defaultLevel}'`);
+            return defaultLevel;
+        }
+        return normalized;
+    }
+    mute() {
+        logger.transports.forEach((t) => {
+            t.silent = true;
+        });
+    }
+    unmute() {
+        logger.transports.forEach((t) => {
+            t.silent = false;
+        });
+    }
+    trace(...args) {
+        logger.trace(util.format(...args));
+    }
+    debug(...args) {
+        logger.debug(util.format(...args));
+    }
+    log(...args) {
+        logger.debug(util.format(...args));
+    }
+    warn(...args) {
+        logger.warn(util.format(...args));
+    }
+    info(...args) {
+        logger.info(util.format(...args));
+    }
+    error(...args) {
+        logger.error(util.format(...args));
+    }
+    getStream() {
+        return {
+            write: (message, _encoding) => {
+                logger.info(message);
+            },
+        };
+    }
+}
+const s4logger = new S4Logger();
+export default s4logger;
+//# sourceMappingURL=s4-logger.js.map

package/dist/ts/logger/s4-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s4-logger.js","sourceRoot":"","sources":["../../../ts/logger/s4-logger.ts"],"names":[],"mappings":"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"}

package/dist/ts/paginator/index.d.ts

@@ -0,0 +1,2 @@
+export { default as s4Paginator } from "./s4-pagination.js";
+export { default as sqlPaginator } from "./sql-pagination.js";

package/dist/ts/paginator/index.js

@@ -0,0 +1,3 @@
+export { default as s4Paginator } from "./s4-pagination.js";
+export { default as sqlPaginator } from "./sql-pagination.js";
+//# sourceMappingURL=index.js.map

package/dist/ts/paginator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/paginator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ts/paginator/s4-pagination.d.ts

@@ -0,0 +1,28 @@
+interface PaginationData {
+    total: number;
+    pages?: number;
+    page?: number;
+    offset?: number;
+    limit?: number;
+    docs: any[];
+}
+interface Request {
+    query?: Record<string, any>;
+    [key: string]: any;
+}
+interface Response {
+    status: (code: number) => any;
+    end: () => any;
+    set: (header: string, value: string) => any;
+    json: (data: any) => any;
+    [key: string]: any;
+}
+declare class S4Pagination {
+    createPaginator(req: Request, res: Response, _next: any): {
+        page: number;
+        page_size: number;
+        reply: (data: PaginationData | null) => void;
+    };
+}
+declare const paginator: S4Pagination;
+export default paginator;

package/dist/ts/paginator/s4-pagination.js

@@ -0,0 +1,49 @@
+const default_page = 1;
+const default_size = 5;
+function parseRequest(req, item, default_value) {
+    if (!req?.query) {
+        return default_value;
+    }
+    const r = parseInt(req.query[item], 10);
+    if (Number.isNaN(r) || r < default_value) {
+        return default_value;
+    }
+    return r;
+}
+class S4Pagination {
+    createPaginator(req, res, _next) {
+        const paginator = {
+            page: parseRequest(req, "page", default_page),
+            page_size: parseRequest(req, "page_size", default_size),
+            reply: (data) => {
+                if (!data) {
+                    res.status(500).end();
+                    return;
+                }
+                const pagination = {
+                    total: data.total,
+                    total_pages: data.pages ?? 0,
+                    current_page: data.page ?? 1,
+                    first_page: data.page === 1,
+                    last_page: data.offset === data.pages,
+                    page_size: data.limit ?? 0,
+                    out_of_bounds: data.docs.length === 0,
+                };
+                if (!pagination.out_of_bounds) {
+                    if (pagination.current_page > 1) {
+                        pagination.previous_page = pagination.current_page - 1;
+                    }
+                    if (pagination.current_page < pagination.total_pages) {
+                        pagination.next_page = pagination.current_page + 1;
+                    }
+                }
+                res.set("s4-pagination", JSON.stringify(pagination));
+                res.json(data.docs);
+            },
+        };
+        return paginator;
+    }
+}
+const paginator = new S4Pagination();
+export default paginator;
+//# sourceMappingURL=s4-pagination.js.map

package/dist/ts/paginator/s4-pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s4-pagination.js","sourceRoot":"","sources":["../../../ts/paginator/s4-pagination.ts"],"names":[],"mappings":"AAkCA,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,SAAS,YAAY,CAAC,GAAY,EAAE,IAAY,EAAE,aAAqB;IACrE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QAChB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,YAAY;IAChB,eAAe,CAAC,GAAY,EAAE,GAAa,EAAE,KAAU;QACrD,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC;YAC7C,SAAS,EAAE,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC;YACvD,KAAK,EAAE,CAAC,IAA2B,EAAE,EAAE;gBACrC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACtB,OAAO;gBACT,CAAC;gBACD,MAAM,UAAU,GAAuB;oBACrC,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;oBAC5B,YAAY,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;oBAC5B,UAAU,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC;oBAC3B,SAAS,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK;oBACrC,SAAS,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;oBAC1B,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;iBACtC,CAAC;gBAEF,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;oBAC9B,IAAI,UAAU,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;wBAChC,UAAU,CAAC,aAAa,GAAG,UAAU,CAAC,YAAY,GAAG,CAAC,CAAC;oBACzD,CAAC;oBACD,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;wBACrD,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,YAAY,GAAG,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBAED,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;SACF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,MAAM,SAAS,GAAG,IAAI,YAAY,EAAE,CAAC;AACrC,eAAe,SAAS,CAAC"}

package/dist/ts/paginator/sql-pagination.d.ts

@@ -0,0 +1,52 @@
+interface PaginateIn {
+    size: string;
+    index: string;
+}
+interface PaginateOut {
+    current_page: string;
+    first_page: string;
+    last_page: string;
+    next_page: string;
+    out_of_bounds: string;
+    page_size: string;
+    previous_page: string;
+    total_pages: string;
+    total_size: string;
+    links: string | boolean;
+}
+interface PaginationOptions {
+    limit?: number;
+    offset?: number;
+    [key: string]: any;
+}
+interface ModelInstance {
+    findAndCountAll: (options: PaginationOptions) => Promise<{
+        rows: any[];
+        count: number;
+    }>;
+}
+declare class SequelizePaginator {
+    private paginateIn;
+    private paginateOut;
+    private zeroBasedOffset;
+    private paginationHeader;
+    private headersOnly;
+    private paginationTag;
+    private collectionTag;
+    constructor();
+    paginate(Model: any, resource?: string): {
+        using: (options: PaginationOptions, resp: any) => ModelInstance;
+        paginate: (options?: PaginationOptions) => Promise<unknown>;
+    };
+    configure(options: Partial<{
+        paginateIn: Partial<PaginateIn>;
+        paginateOut: Partial<PaginateOut>;
+        zeroBasedOffset: boolean;
+        paginationHeader: string;
+        headersOnly: boolean;
+        paginationTag: string;
+        collectionTag: string;
+    }>): void;
+}
+declare const sqlPaginator: SequelizePaginator;
+export default sqlPaginator;

package/dist/ts/paginator/sql-pagination.js

@@ -0,0 +1,176 @@
+class SequelizePaginator {
+    paginateIn;
+    paginateOut;
+    zeroBasedOffset;
+    paginationHeader;
+    headersOnly;
+    paginationTag;
+    collectionTag;
+    constructor() {
+        this.paginateIn = {
+            size: "page_size",
+            index: "page_index",
+        };
+        this.paginateOut = {
+            current_page: "current_page",
+            first_page: "first_page",
+            last_page: "last_page",
+            next_page: "next_page",
+            out_of_bounds: "out_of_bounds",
+            page_size: "page_size",
+            previous_page: "previous_page",
+            total_pages: "total_pages",
+            total_size: "total_size",
+            links: "",
+        };
+        this.zeroBasedOffset = true;
+        this.paginationHeader = "tws-pagination";
+        this.headersOnly = false;
+        this.paginationTag = "_pagination";
+        this.collectionTag = "_collection";
+    }
+    paginate(Model, resource = "") {
+        const model = Model.instance || Model;
+        const DEFAULT_PAGINATION = { limit: 15, offset: 0 };
+        const pagination = { limit: 15, offset: 0 };
+        let response = null;
+        const using = (options, resp) => {
+            response = resp;
+            let limit = DEFAULT_PAGINATION.limit;
+            let offset = DEFAULT_PAGINATION.offset;
+            if (options?.[this.paginateIn.size]) {
+                limit = parseInt(options[this.paginateIn.size], 10);
+            }
+            if (options?.[this.paginateIn.index]) {
+                offset = parseInt(options[this.paginateIn.index], 10);
+            }
+            if (!Number.isInteger(limit) || limit < 1) {
+                limit = 1;
+            }
+            if (!Number.isInteger(offset) || offset < 0) {
+                offset = 0;
+            }
+            if (!this.zeroBasedOffset) {
+                offset = offset <= 1 ? 0 : offset - 1;
+            }
+            pagination.limit = limit;
+            pagination.offset = offset;
+            return model;
+        };
+        const paginate = (options = {}) => {
+            options.limit = pagination.limit;
+            options.offset = pagination.limit * pagination.offset;
+            return new Promise((resolve, reject) => {
+                model
+                    .findAndCountAll(options)
+                    .then((r) => {
+                    const paginationData = getPaginationData(r);
+                    if (response) {
+                        response.set(this.paginationHeader, JSON.stringify(paginationData));
+                    }
+                    let data = {};
+                    if (this.headersOnly) {
+                        data = r.rows;
+                    }
+                    else {
+                        data[this.paginationTag] = addLinks(paginationData);
+                        data[this.collectionTag] = r.rows;
+                    }
+                    resolve(data);
+                })
+                    .catch((e) => reject(e));
+            });
+        };
+        const addLinks = (data) => {
+            let linksKey = null;
+            if (this.paginateOut.links === true) {
+                linksKey = "links";
+            }
+            else if (this.paginateOut.links) {
+                linksKey = this.paginateOut.links;
+            }
+            if (data && linksKey && !data[this.paginateOut.out_of_bounds]) {
+                const links = {};
+                const firstPageIndex = this.zeroBasedOffset ? 0 : 1;
+                const lastPageIndex = this.zeroBasedOffset
+                    ? data[this.paginateOut.total_pages] - 1
+                    : data[this.paginateOut.total_pages];
+                links[this.paginateOut.first_page] =
+                    `${resource}?${this.paginateIn.index}=${firstPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                links[this.paginateOut.last_page] =
+                    `${resource}?${this.paginateIn.index}=${lastPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                if (data[this.paginateOut.previous_page]) {
+                    const prevPageIndex = this.zeroBasedOffset
+                        ? data[this.paginateOut.previous_page] - 1
+                        : data[this.paginateOut.previous_page];
+                    links[this.paginateOut.previous_page] =
+                        `${resource}?${this.paginateIn.index}=${prevPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                }
+                if (data[this.paginateOut.next_page]) {
+                    const nextPageIndex = this.zeroBasedOffset
+                        ? data[this.paginateOut.next_page] - 1
+                        : data[this.paginateOut.next_page];
+                    links[this.paginateOut.next_page] =
+                        `${resource}?${this.paginateIn.index}=${nextPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                }
+                data[linksKey] = links;
+            }
+            return data;
+        };
+        const getPaginationData = (result) => {
+            const totalSize = result.count;
+            const pageSize = pagination.limit;
+            const currentPage = Math.floor(pagination.offset / pageSize) + 1;
+            const totalPages = Math.ceil(totalSize / pageSize);
+            const outOfBounds = currentPage > totalPages || currentPage < 1;
+            const paginationData = {
+                [this.paginateOut.current_page]: currentPage,
+                [this.paginateOut.first_page]: currentPage === 1,
+                [this.paginateOut.last_page]: currentPage === totalPages,
+                [this.paginateOut.out_of_bounds]: outOfBounds,
+                [this.paginateOut.page_size]: pageSize,
+                [this.paginateOut.total_pages]: totalPages,
+                [this.paginateOut.total_size]: totalSize,
+            };
+            if (!outOfBounds) {
+                if (currentPage > 1) {
+                    paginationData[this.paginateOut.previous_page] = currentPage - 1;
+                }
+                if (currentPage < totalPages) {
+                    paginationData[this.paginateOut.next_page] = currentPage + 1;
+                }
+            }
+            return paginationData;
+        };
+        return {
+            using,
+            paginate,
+        };
+    }
+    configure(options) {
+        if (options.paginateIn) {
+            this.paginateIn = { ...this.paginateIn, ...options.paginateIn };
+        }
+        if (options.paginateOut) {
+            this.paginateOut = { ...this.paginateOut, ...options.paginateOut };
+        }
+        if (options.zeroBasedOffset !== undefined) {
+            this.zeroBasedOffset = options.zeroBasedOffset;
+        }
+        if (options.paginationHeader) {
+            this.paginationHeader = options.paginationHeader;
+        }
+        if (options.headersOnly !== undefined) {
+            this.headersOnly = options.headersOnly;
+        }
+        if (options.paginationTag) {
+            this.paginationTag = options.paginationTag;
+        }
+        if (options.collectionTag) {
+            this.collectionTag = options.collectionTag;
+        }
+    }
+}
+const sqlPaginator = new SequelizePaginator();
+export default sqlPaginator;
+//# sourceMappingURL=sql-pagination.js.map

package/dist/ts/paginator/sql-pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-pagination.js","sourceRoot":"","sources":["../../../ts/paginator/sql-pagination.ts"],"names":[],"mappings":"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"}

package/dist/ts/paper-trail/helpers.d.ts

@@ -0,0 +1,14 @@
+interface DiffResult {
+    kind: string;
+    path: string[];
+    lhs?: any;
+    rhs?: any;
+}
+declare const _default: {
+    capitalizeFirstLetter: (string: string) => string;
+    toUnderscored: (obj: Record<string, string>) => Record<string, string>;
+    calcDelta: (current: Record<string, any>, next: Record<string, any>, exclude: string[], strict: boolean, DEBUG?: boolean) => DiffResult[] | null;
+    diffToString: (val: any) => string;
+};
+export default _default;
+export type { DiffResult };