evaengine 1.0.13 → 2.0.0

package/dist/utils/cron.js

@@ -0,0 +1,186 @@
+/**
+ * Minimal cron expression parser and scheduler.
+ * Replaces the unmaintained `later` package with Node built-ins.
+ *
+ * Supports 5-field (minute hour day-of-month month day-of-week) and
+ * 6-field (with a leading seconds) expressions. Each field accepts
+ * wildcard, step, single value, range, range-with-step and
+ * comma-separated lists. All times are interpreted in local time,
+ * matching the previous `later.date.localTime()` default.
+ */
+const FIELD_BOUNDS = {
+    second: [0, 59],
+    minute: [0, 59],
+    hour: [0, 23],
+    dayOfMonth: [1, 31],
+    month: [1, 12],
+    dayOfWeek: [0, 7]
+};
+const FIELD_ORDER = [
+    'second', 'minute', 'hour', 'dayOfMonth', 'month', 'dayOfWeek'
+];
+const parseField = (field, min, max) => {
+    const values = new Set();
+    for (const token of field.split(',')) {
+        if (token === '*') {
+            for (let value = min; value <= max; value += 1) {
+                values.add(value);
+            }
+            continue;
+        }
+        if (token.includes('/')) {
+            const [base, stepToken] = token.split('/');
+            const step = Number.parseInt(stepToken, 10);
+            if (Number.isNaN(step) || step < 1) {
+                throw new Error(`Invalid cron step "${stepToken}" in "${field}"`);
+            }
+            let start = min;
+            let end = max;
+            if (base !== '*') {
+                if (base.includes('-')) {
+                    [start, end] = base.split('-').map(v => Number.parseInt(v, 10));
+                }
+                else {
+                    start = Number.parseInt(base, 10);
+                }
+            }
+            if (Number.isNaN(start) || start < min || start > max
+                || Number.isNaN(end) || end < min || end > max || start > end) {
+                throw new Error(`Invalid cron value in "${field}"`);
+            }
+            for (let value = start; value <= end; value += step) {
+                values.add(value);
+            }
+            continue;
+        }
+        if (token.includes('-')) {
+            const [start, end] = token.split('-').map(v => Number.parseInt(v, 10));
+            if (Number.isNaN(start) || Number.isNaN(end)
+                || start < min || end > max || start > end) {
+                throw new Error(`Invalid cron range in "${field}"`);
+            }
+            for (let value = start; value <= end; value += 1) {
+                values.add(value);
+            }
+            continue;
+        }
+        const value = Number.parseInt(token, 10);
+        if (Number.isNaN(value) || value < min || value > max) {
+            throw new Error(`Invalid cron value "${token}" in "${field}"`);
+        }
+        values.add(value);
+    }
+    return values;
+};
+/**
+ * Parse a cron expression into a schedule of Sets.
+ */
+export const parseCron = (expression, useSeconds = false) => {
+    const parts = String(expression).trim().split(/\s+/);
+    const names = useSeconds ? FIELD_ORDER : FIELD_ORDER.slice(1);
+    if (parts.length !== names.length) {
+        throw new Error(`Cron expression must contain ${names.length} fields, got ${parts.length}: "${expression}"`);
+    }
+    const schedule = {};
+    names.forEach((name, index) => {
+        const [min, max] = FIELD_BOUNDS[name];
+        schedule[name] = parseField(parts[index], min, max);
+    });
+    if (schedule.dayOfWeek) {
+        if (schedule.dayOfWeek.has(7)) {
+            schedule.dayOfWeek.delete(7);
+            schedule.dayOfWeek.add(0);
+        }
+    }
+    return schedule;
+};
+const matches = (schedule, date) => {
+    if (schedule.second && !schedule.second.has(date.getSeconds())) {
+        return false;
+    }
+    if (schedule.minute && !schedule.minute.has(date.getMinutes())) {
+        return false;
+    }
+    if (schedule.hour && !schedule.hour.has(date.getHours())) {
+        return false;
+    }
+    if (schedule.dayOfMonth && !schedule.dayOfMonth.has(date.getDate())) {
+        return false;
+    }
+    if (schedule.month && !schedule.month.has(date.getMonth() + 1)) {
+        return false;
+    }
+    if (schedule.dayOfWeek && !schedule.dayOfWeek.has(date.getDay())) {
+        return false;
+    }
+    return true;
+};
+/**
+ * Compute the next run date strictly after `from` that matches the schedule.
+ */
+export const getNextRun = (schedule, from = new Date()) => {
+    const stepMs = schedule.second ? 1000 : 60000;
+    let current = new Date(Math.floor(from.getTime() / stepMs) * stepMs + stepMs);
+    const deadline = from.getTime() + 366 * 24 * 3600 * 1000;
+    while (current.getTime() <= deadline) {
+        if (matches(schedule, current)) {
+            return current;
+        }
+        //Fast-forward coarse fields so unschedulable expressions stay fast
+        if (schedule.month && !schedule.month.has(current.getMonth() + 1)) {
+            current = new Date(current.getFullYear(), current.getMonth() + 1, 1, 0, 0, 0, 0);
+            continue;
+        }
+        if (schedule.dayOfMonth && !schedule.dayOfMonth.has(current.getDate())) {
+            current.setDate(current.getDate() + 1);
+            current.setHours(0, 0, 0, 0);
+            continue;
+        }
+        if (schedule.dayOfWeek && !schedule.dayOfWeek.has(current.getDay())) {
+            current.setDate(current.getDate() + 1);
+            current.setHours(0, 0, 0, 0);
+            continue;
+        }
+        if (schedule.hour && !schedule.hour.has(current.getHours())) {
+            current.setHours(current.getHours() + 1, 0, 0, 0);
+            continue;
+        }
+        if (schedule.minute && !schedule.minute.has(current.getMinutes())) {
+            current.setMinutes(current.getMinutes() + 1, 0, 0);
+            continue;
+        }
+        if (schedule.second && !schedule.second.has(current.getSeconds())) {
+            current.setSeconds(current.getSeconds() + 1, 0);
+            continue;
+        }
+        current = new Date(current.getTime() + stepMs);
+    }
+    throw new Error('Cron expression has no match within the next year');
+};
+const MAX_TIMEOUT = 2147483647;
+/**
+ * Run `callback` on `schedule` until the returned handle is cleared.
+ */
+export const setCronInterval = (callback, schedule) => {
+    let timer = null;
+    const scheduleNext = () => {
+        const nextRun = getNextRun(schedule, new Date());
+        const delay = Math.max(0, nextRun.getTime() - Date.now());
+        timer = setTimeout(() => {
+            scheduleNext();
+            if (delay <= MAX_TIMEOUT) {
+                callback();
+            }
+        }, Math.min(delay, MAX_TIMEOUT));
+    };
+    scheduleNext();
+    return {
+        clear() {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+        }
+    };
+};
+//# sourceMappingURL=cron.js.map

package/dist/utils/cron.js.map

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

package/dist/utils/datetime.d.ts

@@ -0,0 +1,4 @@
+export declare const getTimestamp: () => number;
+export declare const getMilliTimestamp: () => number;
+export declare const getMicroTimestamp: () => number;
+export declare const getDatabaseDatetime: () => string;

package/dist/utils/datetime.js

@@ -0,0 +1,6 @@
+import moment from 'moment-timezone';
+export const getTimestamp = () => Math.floor(Date.now() / 1000);
+export const getMilliTimestamp = () => Date.now();
+export const getMicroTimestamp = () => Date.now() * 1000;
+export const getDatabaseDatetime = () => moment().format('YYYY-MM-DD HH:mm:ss');
+//# sourceMappingURL=datetime.js.map

package/dist/utils/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/utils/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;AAEb,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpB,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAW,EAAE,CAC9C,MAAM,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/utils/host.d.ts

@@ -0,0 +1,18 @@
+import type { Request } from 'express';
+/**
+ * getHostFullUrl 只读取 protocol/originalUrl/headers.host/get；
+ * 用最小结构类型兼容真实 express Request 与测试用的 duck-typed mock
+ */
+type HostUrlRequest = {
+    protocol: string;
+    originalUrl: string;
+    headers?: {
+        host?: string | undefined;
+    };
+    get(name: string): string | undefined;
+};
+export declare const getHostFullUrl: (req: HostUrlRequest, url?: string) => string;
+export declare const getHostIp: () => string;
+export declare const getHostPort: (req: Request) => number | string;
+export declare const getClientIp: (req: Request) => string | undefined;
+export {};

package/dist/utils/host.js

@@ -0,0 +1,33 @@
+import os from 'os';
+export const getHostFullUrl = (req, url) => {
+    const { protocol, originalUrl } = req;
+    const host = req.headers && req.headers.host ? req.headers.host : req.get('host');
+    return `${protocol}://${host}${url || originalUrl}`;
+};
+export const getHostIp = () => {
+    const ifaces = os.networkInterfaces();
+    const addresses = [];
+    Object.keys(ifaces).forEach((ifname) => {
+        ifaces[ifname].forEach((iface) => {
+            if (iface.family !== 'IPv4' || iface.internal !== false) {
+                // skip over internal (i.e. 127.0.0.1) and non-ipv4 addresses
+                return;
+            }
+            addresses.push(iface.address);
+        });
+    });
+    return addresses.length > 0 ? addresses[0] : '127.0.0.1';
+};
+export const getHostPort = (req) => {
+    if (!req.headers || !req.headers.host) {
+        return -1;
+    }
+    const [, port] = req.headers.host.split(':');
+    return port || -1;
+};
+export const getClientIp = (req) => req.headers['x-forwarded-for'] ||
+    req.connection.remoteAddress ||
+    req.socket.remoteAddress ||
+    // 原实现访问 connection.socket（Socket 上不存在该属性），不可达时按原样抛 TypeError，不做可选链
+    req.connection.socket.remoteAddress;
+//# sourceMappingURL=host.js.map

package/dist/utils/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/utils/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAcpB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAmB,EAAE,GAAY,EAAU,EAAE;IAC1E,MAAM,EACJ,QAAQ,EACR,WAAW,EACZ,GAAG,GAAG,CAAC;IACR,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClF,OAAO,GAAG,QAAQ,MAAM,IAAI,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE;IACpC,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,MAAM,CAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACxD,6DAA6D;gBAC7D,OAAO;YACT,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAY,EAAmB,EAAE;IAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAY,EAAsB,EAAE,CAC/D,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAwB;IACtD,GAAG,CAAC,UAAU,CAAC,aAAa;IAC5B,GAAG,CAAC,MAAM,CAAC,aAAa;IACxB,mEAAmE;IAClE,GAAG,CAAC,UAAgE,CAAC,MAAM,CAAC,aAAa,CAAC"}

package/{src/utils/index.js → dist/utils/index.d.ts}

@@ -6,30 +6,6 @@ import crc32 from './crc32.js';
 import { randomNumber, randomString } from './random.js';
 import { toCamelCase, toSnakeCase } from './case_converter.js';
 import { getHostFullUrl, getHostIp, getHostPort, getClientIp } from './host.js';
-import {
-  getTimestamp, getMilliTimestamp,
-  getMicroTimestamp, getDatabaseDatetime
-} from './datetime.js';
+import { getTimestamp, getMilliTimestamp, getMicroTimestamp, getDatabaseDatetime } from './datetime.js';
 import * as apiScaffold from './api_scaffold.js';
-
-export {
-  apiScaffold,
-  crc32,
-  getHostFullUrl,
-  getHostIp,
-  getHostPort,
-  getClientIp,
-  getTimestamp,
-  getMilliTimestamp,
-  getMicroTimestamp,
-  getDatabaseDatetime,
-  merge,
-  pagination,
-  paginationFilter,
-  randomNumber,
-  randomString,
-  test,
-  toCamelCase,
-  toSnakeCase,
-  wrapper
-};
+export { apiScaffold, crc32, getHostFullUrl, getHostIp, getHostPort, getClientIp, getTimestamp, getMilliTimestamp, getMicroTimestamp, getDatabaseDatetime, merge, pagination, paginationFilter, randomNumber, randomString, test, toCamelCase, toSnakeCase, wrapper };

package/dist/utils/index.js

@@ -0,0 +1,12 @@
+import merge from 'lodash/merge.js';
+import wrapper from "./wrapper.js";
+import * as test from "./test.js";
+import { pagination, paginationFilter } from "./pagination.js";
+import crc32 from "./crc32.js";
+import { randomNumber, randomString } from "./random.js";
+import { toCamelCase, toSnakeCase } from "./case_converter.js";
+import { getHostFullUrl, getHostIp, getHostPort, getClientIp } from "./host.js";
+import { getTimestamp, getMilliTimestamp, getMicroTimestamp, getDatabaseDatetime } from "./datetime.js";
+import * as apiScaffold from "./api_scaffold.js";
+export { apiScaffold, crc32, getHostFullUrl, getHostIp, getHostPort, getClientIp, getTimestamp, getMilliTimestamp, getMicroTimestamp, getDatabaseDatetime, merge, pagination, paginationFilter, randomNumber, randomString, test, toCamelCase, toSnakeCase, wrapper };
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EACL,YAAY,EAAE,iBAAiB,EAC/B,iBAAiB,EAAE,mBAAmB,EACvC,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,WAAW,EACX,KAAK,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,WAAW,EACX,OAAO,EACR,CAAC"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,150 @@
+/**
+ * pagination 的 req 只使用 protocol/baseUrl/path/query/get，
+ * 用最小结构类型同时兼容真实 express Request 与测试用的 duck-typed mock
+ */
+type PaginationRequest = {
+    protocol: string;
+    baseUrl: string;
+    path: string;
+    query: Record<string, unknown>;
+    get(name: string): string | undefined;
+};
+/**
+ @swagger
+ PaginationSnake:
+   type: object
+   properties:
+     total:
+       type: integer
+       description: 总数据量
+     offset:
+       type: integer
+       description: 偏移量
+     limit:
+       type: integer
+       description: 单页数据量
+     prev:
+       type: integer
+       description: 上页偏移量
+     next:
+       type: integer
+       description: 下页偏移量
+     prev_uri:
+       type: string
+       description: 上页Uri
+     next_uri:
+       type: string
+       description: 下页Uri
+     is_first:
+       type: boolean
+       description: 是否为首页
+     is_last:
+       type: boolean
+       description: 是否为末页
+     first_uri:
+       type: string
+       description: 首页Uri
+     last_uri:
+       type: string
+       description: 末页Uri
+   required:
+   - total
+   - offset
+   - limit
+   - prev
+   - next
+   - prev_uri
+   - next_uri
+   - is_first
+   - is_last
+   - first_uri
+   - last_uri
+   example:
+     total: 100
+     offset: 30
+     limit: 15
+     prev: 15
+     next: 45
+     prev_uri: http://localhost/v1/posts?offset=15&limit=15
+     next_uri: http://localhost/v1/posts?offset=30&limit=15
+     is_first: false
+     is_last: false
+     first_uri: http://localhost/v1/posts?offset=0&limit=15
+     last_uri: http://localhost/v1/posts?offset=90&limit=15
+ @swagger
+ Pagination:
+   type: object
+   properties:
+     total:
+       type: integer
+       description: 总数据量
+     offset:
+       type: integer
+       description: 偏移量
+     limit:
+       type: integer
+       description: 单页数据量
+     prev:
+       type: integer
+       description: 上页偏移量
+     next:
+       type: integer
+       description: 下页偏移量
+     prevUri:
+       type: string
+       description: 上页Uri
+     nextUri:
+       type: string
+       description: 下页Uri
+     isFirst:
+       type: boolean
+       description: 是否为首页
+     isLast:
+       type: boolean
+       description: 是否为末页
+     firstUri:
+       type: string
+       description: 首页Uri
+     lastUri:
+       type: string
+       description: 末页Uri
+   required:
+   - total
+   - offset
+   - limit
+   - prev
+   - next
+   - prevUri
+   - nextUri
+   - isFirst
+   - isLast
+   - firstUri
+   - lastUri
+   example:
+     total: 100
+     offset: 30
+     limit: 15
+     prev: 15
+     next: 45
+     prevUri: http://localhost/v1/posts?offset=15&limit=15
+     nextUri: http://localhost/v1/posts?offset=30&limit=15
+     isFirst: false
+     isLast: false
+     firstUri: http://localhost/v1/posts?offset=0&limit=15
+     lastUri: http://localhost/v1/posts?offset=90&limit=15
+ */
+export declare const pagination: ({ total, limit, offset, req, snakeCase: useSnake }: {
+    total: unknown;
+    limit: unknown;
+    offset: unknown;
+    req: PaginationRequest;
+    snakeCase?: boolean;
+}) => Record<string, unknown>;
+export declare const paginationFilter: ({ offset, limit }: {
+    offset?: unknown;
+    limit?: unknown;
+}, defaultLimit?: number, maxLimit?: number) => {
+    offset: number;
+    limit: number;
+};
+export {};