mybase 1.2.2 → 2.0.0

package/ts/index.d.ts

@@ -1,35 +0,0 @@
-export * from "./funcs/getWeekNumber";
-export * from "./funcs/Geoip2Paths";
-export * from "./funcs/isLocal";
-export * from "./funcs/randomString";
-export * from "./funcs/utcnow";
-export * from "./funcs/validIp";
-export * from "./funcs/wait";
-export * from "./funcs/fileCacheIsValid";
-export * from "./funcs/hash_sha512";
-export * from "./funcs/vaultRead";
-export * from "./funcs/vaultFill";
-export * from "./funcs/asJSON";
-export * from "./funcs/promiseTimeout";
-export * from "./funcs/randomIP";
-export * from "./funcs/ip2int";
-export * from "./funcs/int2ip";
-export * from "./funcs/randomIP6";
-export * from "./funcs/randomTCPPort";
-export * from "./funcs/validEmail";
-export * from "./funcs/isLoopbackIP";
-export * from "./funcs/isLANIp";
-export * from "./funcs/getMysql1";
-export * from "./funcs/getMysql2";
-export * from "./funcs/initMysql2Pool";
-export * from "./funcs/randomUTFString";
-export * from "./funcs/MaxRuntimeHours";
-export * from "./funcs/ensureFolder";
-export * from "./funcs/knexConnection";
-export * from "./funcs/deepCopy";
-export * from "./models/Unixtime";
-export * from "./models/Timespan";
-export * from "./models/IPAddress";
-export * from "./models/OTPGenerator";
-export * from "./models/Interfaces";
-export * from "./models/DateIterator";

package/ts/index.test.ts

@@ -1,7 +0,0 @@
-import * as IMPORTS from "./index";
-
-test('exports', () => {
-    for(let fn of Object.values(IMPORTS)) {
-        expect(typeof fn=='function' || typeof fn==='object').toBe(true)
-    }
-})

package/ts/index.ts

@@ -1,39 +0,0 @@
-export * from "./funcs/getWeekNumber"
-export * from "./funcs/Geoip2Paths";
-export * from "./funcs/isLocal"
-export * from "./funcs/randomString"
-export * from "./funcs/utcnow"
-export * from "./funcs/validIp"
-export * from "./funcs/wait"
-export * from "./funcs/fileCacheIsValid"
-export * from "./funcs/hash_sha512"
-export * from "./funcs/vaultRead"
-export * from "./funcs/vaultFill"
-export * from "./funcs/asJSON"
-export * from "./funcs/promiseTimeout"
-export * from "./funcs/randomIP"
-export * from "./funcs/ip2int"
-export * from "./funcs/int2ip"
-export * from "./funcs/randomIP6"
-export * from "./funcs/randomTCPPort"
-export * from "./funcs/validEmail"
-export * from "./funcs/isLoopbackIP"
-export * from "./funcs/isLANIp"
-export * from "./funcs/getMysql1"
-export * from "./funcs/getMysql2"
-export * from "./funcs/initMysql2Pool"
-export * from "./funcs/randomUTFString"
-export * from "./funcs/MaxRuntimeHours"
-export * from "./funcs/ensureFolder"
-export * from "./funcs/knexConnection"
-export * from "./funcs/deepCopy"
-
-
-
-// models
-export * from "./models/Unixtime"
-export * from "./models/Timespan"
-export * from "./models/IPAddress"
-export * from "./models/OTPGenerator"
-export * from "./models/Interfaces"
-export * from "./models/DateIterator"

package/ts/models/DateIterator.test.ts

@@ -1,149 +0,0 @@
-import { DateIterator } from './DateIterator';
-import { Unixtime } from './Unixtime';
-
-describe('DateIterator', () => {
-  const start = () => Unixtime.fromYYYYMMDD('20240110');
-  const end = () => Unixtime.fromYYYYMMDD('20240105');
-
-  it('should iterate backwards day-by-day (end-exclusive) with default separator', () => {
-    const it = new DateIterator(start(), end());
-    expect(it.toArray()).toEqual([
-      '20240110',
-      '20240109',
-      '20240108',
-      '20240107',
-      '20240106',
-    ]);
-  });
-
-  it('should honor a custom separator', () => {
-    const it = new DateIterator(start(), end(), '-');
-    expect(it.toArray()).toEqual([
-      '2024-01-10',
-      '2024-01-09',
-      '2024-01-08',
-      '2024-01-07',
-      '2024-01-06',
-    ]);
-  });
-
-  it('should honor a slash separator', () => {
-    const it = new DateIterator(start(), end(), '/');
-    expect(it.toArray()).toEqual([
-      '2024/01/10',
-      '2024/01/09',
-      '2024/01/08',
-      '2024/01/07',
-      '2024/01/06',
-    ]);
-  });
-
-  it('next() should return null when exhausted', () => {
-    const s = Unixtime.fromYYYYMMDD('20240103');
-    const e = Unixtime.fromYYYYMMDD('20240101');
-    const it = new DateIterator(s, e);
-    expect(it.next()).toEqual('20240103');
-    expect(it.next()).toEqual('20240102');
-    expect(it.next()).toBeNull();
-    expect(it.next()).toBeNull();
-  });
-
-  it('should return empty array when start equals end (end-exclusive)', () => {
-    const s = Unixtime.fromYYYYMMDD('20240105');
-    const e = Unixtime.fromYYYYMMDD('20240105');
-    const it = new DateIterator(s, e);
-    expect(it.toArray()).toEqual([]);
-    expect(it.next()).toBeNull();
-  });
-
-  it('should throw when start is older than end', () => {
-    const s = Unixtime.fromYYYYMMDD('20240101');
-    const e = Unixtime.fromYYYYMMDD('20240110');
-    expect(() => new DateIterator(s, e)).toThrow(
-      'DateIterator: `start` must be newer than or equal to `end`'
-    );
-  });
-
-  it('should not mutate the caller-supplied Unixtime instances', () => {
-    const s = Unixtime.fromYYYYMMDD('20240110');
-    const e = Unixtime.fromYYYYMMDD('20240105');
-    const sBefore = s.toLongUnixtime();
-    const eBefore = e.toLongUnixtime();
-    const it = new DateIterator(s, e);
-    it.toArray();
-    expect(s.toLongUnixtime()).toEqual(sBefore);
-    expect(e.toLongUnixtime()).toEqual(eBefore);
-  });
-
-  it('reset() should allow the iterator to be consumed again', () => {
-    const it = new DateIterator(start(), end());
-    const first = it.toArray();
-    expect(it.next()).toBeNull();
-    it.reset();
-    const second = it.toArray();
-    expect(second).toEqual(first);
-  });
-
-  it('reset() should return the iterator for chaining', () => {
-    const it = new DateIterator(start(), end());
-    expect(it.reset()).toBe(it);
-  });
-
-  it('should be iterable via for..of', () => {
-    const it = new DateIterator(start(), end(), '-');
-    const out: string[] = [];
-    for (const d of it) out.push(d);
-    expect(out).toEqual([
-      '2024-01-10',
-      '2024-01-09',
-      '2024-01-08',
-      '2024-01-07',
-      '2024-01-06',
-    ]);
-  });
-
-  it('for..of should be independent of next()/toArray() cursor', () => {
-    const it = new DateIterator(start(), end());
-    expect(it.next()).toEqual('20240110');
-    const collected: string[] = [];
-    for (const d of it) collected.push(d);
-    expect(collected).toEqual([
-      '20240110',
-      '20240109',
-      '20240108',
-      '20240107',
-      '20240106',
-    ]);
-    expect(it.next()).toEqual('20240109');
-  });
-
-  it('should support spread syntax', () => {
-    const it = new DateIterator(
-      Unixtime.fromYYYYMMDD('20240103'),
-      Unixtime.fromYYYYMMDD('20240101')
-    );
-    expect([...it]).toEqual(['20240103', '20240102']);
-  });
-
-  it('should cross month boundaries correctly', () => {
-    const s = Unixtime.fromYYYYMMDD('20240302');
-    const e = Unixtime.fromYYYYMMDD('20240227');
-    const it = new DateIterator(s, e, '-');
-    expect(it.toArray()).toEqual([
-      '2024-03-02',
-      '2024-03-01',
-      '2024-02-29',
-      '2024-02-28',
-    ]);
-  });
-
-  it('should produce N entries for a span of N+1 days (end-exclusive)', () => {
-    const s = Unixtime.fromYYYYMMDD('20240620');
-    const e = Unixtime.fromYYYYMMDD('20240610');
-    const it = new DateIterator(s, e);
-    const arr = it.toArray();
-    expect(arr.length).toEqual(10);
-    expect(arr[0]).toEqual('20240620');
-    expect(arr[arr.length - 1]).toEqual('20240611');
-  });
-});

package/ts/models/DateIterator.ts

@@ -1,80 +0,0 @@
-import { Unixtime } from "./Unixtime"
-
-/**
- * Iterates day-by-day backwards from `start` toward `end` (end-exclusive),
- * emitting each date as a `yyyy{sep}mm{sep}dd` string.
- *
- * @example
- *   const it = new DateIterator(Unixtime.now(), Unixtime.now().addDays(-5))
- *   it.next()  // "20260417"
- *   it.next()  // "20260416"
- *   // ...
- *   it.next()  // null
- *
- * @example separator
- *   new DateIterator(start, end, "-").toArray()
- *   // ["2026-04-17", "2026-04-16", ...]
- *
- * @example for..of
- *   for (const d of new DateIterator(start, end, "/")) console.log(d)
- */
-export class DateIterator implements Iterable<string> {
-    private readonly start: Unixtime
-    private readonly end: Unixtime
-    private readonly separator: string
-    private cursor: Unixtime | null
-
-    constructor(start: Unixtime, end: Unixtime, separator: string = "") {
-        if (start.lessThan(end)) {
-            throw new Error('DateIterator: `start` must be newer than or equal to `end`')
-        }
-        // Defensive clones: callers' instances must not be mutated, and
-        // Unixtime.addDays() mutates the underlying Date.
-        this.start = start.clone()
-        this.end = end.clone()
-        this.separator = separator
-        this.cursor = this.start.clone()
-    }
-
-    /** Returns the next formatted date going backwards, or `null` when exhausted. */
-    next(): string | null {
-        if (this.cursor === null) return null
-        if (!this.cursor.greaterThan(this.end)) {
-            this.cursor = null
-            return null
-        }
-        const value = this.cursor.yyyymmdd(this.separator)
-        this.cursor.addDays(-1)
-        return value
-    }
-
-    /** Reset the iterator so it can be consumed again from `start`. */
-    reset(): this {
-        this.cursor = this.start.clone()
-        return this
-    }
-
-    /** Collect all remaining dates into an array. */
-    toArray(): string[] {
-        const out: string[] = []
-        let d: string | null
-        while ((d = this.next()) !== null) out.push(d)
-        return out
-    }
-
-    [Symbol.iterator](): Iterator<string> {
-        let cursor: Unixtime | null = this.start.clone()
-        const end = this.end
-        const sep = this.separator
-        return {
-            next(): IteratorResult<string> {
-                if (cursor === null || !cursor.greaterThan(end)) {
-                    return { value: undefined as unknown as string, done: true }
-                }
-                const value = cursor.yyyymmdd(sep)
-                cursor.addDays(-1)
-                return { value, done: false }
-            }
-        }
-    }
-}