@taico/taico 0.8.0 → 0.8.1

package/dist/threads/timers/timer-input.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_ITERATIONS = exports.MAX_DURATION_SECONDS = void 0;
+exports.parseDuration = parseDuration;
+exports.parseMaxIterations = parseMaxIterations;
+exports.describeDuration = describeDuration;
+exports.parseInstant = parseInstant;
+exports.MAX_DURATION_SECONDS = 366 * 24 * 60 * 60;
+exports.MAX_ITERATIONS = 10;
+const UNIT_SECONDS = { s: 1, m: 60, h: 3600 };
+const UNIT_NAMES = { s: 'second', m: 'minute', h: 'hour' };
+function parseDuration(input) {
+    const match = /^([1-9]\d*)([smh])$/.exec(input.trim());
+    if (!match) {
+        return {
+            ok: false,
+            error: `Invalid duration "${input}". Use a positive whole number followed by one unit: s, m or h (for example "30s", "5m", "2h"). Compound values such as "1h30m" are not supported; use "90m".`,
+        };
+    }
+    const seconds = Number(match[1]) * UNIT_SECONDS[match[2]];
+    if (seconds > exports.MAX_DURATION_SECONDS) {
+        return { ok: false, error: `Duration "${input}" is too long. The longest supported is 366 days.` };
+    }
+    return { ok: true, value: seconds };
+}
+function parseMaxIterations(input) {
+    if (typeof input !== 'number' || !Number.isInteger(input) || input < 1) {
+        return { ok: false, error: 'maxIterations must be a positive whole number.' };
+    }
+    if (input > exports.MAX_ITERATIONS) {
+        return { ok: false, error: `maxIterations can be at most ${exports.MAX_ITERATIONS}.` };
+    }
+    return { ok: true, value: input };
+}
+function describeDuration(seconds) {
+    for (const unit of ['h', 'm', 's']) {
+        if (seconds % UNIT_SECONDS[unit] === 0) {
+            const count = seconds / UNIT_SECONDS[unit];
+            return `${count} ${UNIT_NAMES[unit]}${count === 1 ? '' : 's'}`;
+        }
+    }
+    return `${seconds} seconds`;
+}
+const DATETIME_PATTERN = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?(?:\.\d+)?(Z|[+-]\d{2}:\d{2})?$/;
+function parseInstant(at, timezone) {
+    const match = DATETIME_PATTERN.exec(at.trim());
+    if (!match) {
+        return {
+            ok: false,
+            error: `Invalid datetime "${at}". Use ISO 8601, for example "2026-10-15T12:00:00Z", "2026-10-15T12:00:00+11:00", or "2026-10-15T12:00:00" with a timezone such as "Australia/Sydney".`,
+        };
+    }
+    const [, year, month, day, hour, minute, second = '0', offset] = match;
+    const fields = {
+        year: Number(year),
+        month: Number(month),
+        day: Number(day),
+        hour: Number(hour),
+        minute: Number(minute),
+        second: Number(second),
+    };
+    const asUtc = Date.UTC(fields.year, fields.month - 1, fields.day, fields.hour, fields.minute, fields.second);
+    const check = new Date(asUtc);
+    if (check.getUTCFullYear() !== fields.year ||
+        check.getUTCMonth() !== fields.month - 1 ||
+        check.getUTCDate() !== fields.day ||
+        check.getUTCHours() !== fields.hour ||
+        check.getUTCMinutes() !== fields.minute ||
+        check.getUTCSeconds() !== fields.second) {
+        return { ok: false, error: `"${at}" is not a real date and time.` };
+    }
+    const zone = timezone?.trim() || undefined;
+    if (zone && !isValidTimeZone(zone)) {
+        return { ok: false, error: `Unknown timezone "${timezone}". Use an IANA name such as "Australia/Sydney" or "UTC".` };
+    }
+    if (offset) {
+        const offsetMinutes = offset === 'Z' ? 0 : parseOffset(offset);
+        if (offsetMinutes === null) {
+            return {
+                ok: false,
+                error: `"${at}" has offset ${offset}, which is not a real UTC offset. Offsets run from -12:00 to +14:00 with minutes 00-59.`,
+            };
+        }
+        const instant = new Date(asUtc - offsetMinutes * 60_000);
+        if (zone && zoneOffsetMinutes(zone, instant) !== offsetMinutes) {
+            return {
+                ok: false,
+                error: `"${at}" has offset ${offset}, which does not match timezone "${zone}" at that time. Give either the offset or the timezone, not conflicting ones.`,
+            };
+        }
+        return { ok: true, value: instant };
+    }
+    if (!zone) {
+        return {
+            ok: false,
+            error: `"${at}" has no offset. Add one ("Z" for UTC, or "+10:00") or pass a timezone such as "Australia/Sydney".`,
+        };
+    }
+    const candidateOffsets = new Set([-86_400_000, 0, 86_400_000].map((shift) => zoneOffsetMinutes(zone, new Date(asUtc + shift))));
+    const instants = [...candidateOffsets]
+        .map((offsetMinutes) => new Date(asUtc - offsetMinutes * 60_000))
+        .filter((instant) => zoneOffsetMinutes(zone, instant) * 60_000 === asUtc - instant.getTime());
+    const unique = [...new Set(instants.map((instant) => instant.getTime()))];
+    if (unique.length === 0) {
+        return { ok: false, error: `${at} does not exist in ${zone}: the clocks skip it for daylight saving. Pick another time.` };
+    }
+    if (unique.length > 1) {
+        return {
+            ok: false,
+            error: `${at} happens twice in ${zone} because of daylight saving. Give an offset to say which one (for example "${at}${formatOffset(zoneOffsetMinutes(zone, new Date(Math.min(...unique))))}").`,
+        };
+    }
+    return { ok: true, value: new Date(unique[0]) };
+}
+function isValidTimeZone(zone) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: zone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const MIN_OFFSET_MINUTES = -12 * 60;
+const MAX_OFFSET_MINUTES = 14 * 60;
+function parseOffset(offset) {
+    const sign = offset.startsWith('-') ? -1 : 1;
+    const [hours, minutes] = offset.slice(1).split(':').map(Number);
+    if (minutes > 59) {
+        return null;
+    }
+    const total = sign * (hours * 60 + minutes);
+    if (total < MIN_OFFSET_MINUTES || total > MAX_OFFSET_MINUTES) {
+        return null;
+    }
+    return total;
+}
+function formatOffset(minutes) {
+    const sign = minutes < 0 ? '-' : '+';
+    const abs = Math.abs(minutes);
+    return `${sign}${String(Math.floor(abs / 60)).padStart(2, '0')}:${String(abs % 60).padStart(2, '0')}`;
+}
+function zoneOffsetMinutes(zone, instant) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: zone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    }).formatToParts(instant);
+    const get = (type) => Number(parts.find((part) => part.type === type)?.value);
+    const wallAsUtc = Date.UTC(get('year'), get('month') - 1, get('day'), get('hour'), get('minute'), get('second'));
+    const wholeSeconds = Math.floor(instant.getTime() / 1000) * 1000;
+    return Math.round((wallAsUtc - wholeSeconds) / 60_000);
+}
+//# sourceMappingURL=timer-input.js.map

package/dist/threads/timers/timer-input.js.map

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

package/dist/threads/timers/timer-input.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/threads/timers/timer-input.spec.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const timer_input_1 = require("./timer-input");
+describe('timer input', () => {
+    describe('parseDuration', () => {
+        it.each([
+            ['5s', 5],
+            ['5m', 300],
+            ['2h', 7200],
+            [' 90m ', 5400],
+        ])('reads %p as %p seconds', (input, seconds) => {
+            expect((0, timer_input_1.parseDuration)(input)).toEqual({ ok: true, value: seconds });
+        });
+        it.each(['1h30m', '0m', '-5m', '5', 'm', '5d', '1.5h', '05m', ''])('rejects %p', (input) => {
+            expect((0, timer_input_1.parseDuration)(input).ok).toBe(false);
+        });
+        it('rejects durations longer than a year', () => {
+            expect((0, timer_input_1.parseDuration)('9000h').ok).toBe(false);
+        });
+    });
+    describe('parseMaxIterations', () => {
+        it('accepts positive whole numbers', () => {
+            expect((0, timer_input_1.parseMaxIterations)(5)).toEqual({ ok: true, value: 5 });
+        });
+        it('accepts up to 10', () => {
+            expect((0, timer_input_1.parseMaxIterations)(10)).toEqual({ ok: true, value: 10 });
+        });
+        it.each([0, -1, 1.5, '5', undefined, 11])('rejects %p', (input) => {
+            expect((0, timer_input_1.parseMaxIterations)(input).ok).toBe(false);
+        });
+    });
+    describe('describeDuration', () => {
+        it.each([
+            [300, '5 minutes'],
+            [3600, '1 hour'],
+            [90, '90 seconds'],
+            [5400, '90 minutes'],
+        ])('describes %p seconds as %p', (seconds, text) => {
+            expect((0, timer_input_1.describeDuration)(seconds)).toBe(text);
+        });
+    });
+    describe('parseInstant', () => {
+        const iso = (at, timezone) => {
+            const result = (0, timer_input_1.parseInstant)(at, timezone);
+            return result.ok ? result.value.toISOString() : result.error;
+        };
+        it('reads UTC and offset timestamps', () => {
+            expect(iso('2026-10-15T12:00:00Z')).toBe('2026-10-15T12:00:00.000Z');
+            expect(iso('2026-10-15T12:00:00+11:00')).toBe('2026-10-15T01:00:00.000Z');
+            expect(iso('2026-10-15T12:00-03:30')).toBe('2026-10-15T15:30:00.000Z');
+        });
+        it('reads a local time in a timezone', () => {
+            expect(iso('2026-10-15T12:00:00', 'Australia/Sydney')).toBe('2026-10-15T01:00:00.000Z');
+            expect(iso('2026-07-15T12:00:00', 'Australia/Sydney')).toBe('2026-07-15T02:00:00.000Z');
+        });
+        it('accepts an offset that agrees with the timezone', () => {
+            expect(iso('2026-10-15T12:00:00+11:00', 'Australia/Sydney')).toBe('2026-10-15T01:00:00.000Z');
+        });
+        it('rejects an offset that conflicts with the timezone', () => {
+            expect((0, timer_input_1.parseInstant)('2026-10-15T12:00:00+10:00', 'Australia/Sydney').ok).toBe(false);
+        });
+        it('rejects a local time with no timezone', () => {
+            expect((0, timer_input_1.parseInstant)('2026-10-15T12:00:00').ok).toBe(false);
+        });
+        it('rejects a local time that daylight saving skips', () => {
+            const result = (0, timer_input_1.parseInstant)('2026-10-04T02:30:00', 'Australia/Sydney');
+            expect(result.ok).toBe(false);
+            expect(!result.ok && result.error).toContain('does not exist');
+        });
+        it('rejects a local time that daylight saving repeats', () => {
+            const result = (0, timer_input_1.parseInstant)('2026-04-05T02:30:00', 'Australia/Sydney');
+            expect(result.ok).toBe(false);
+            expect(!result.ok && result.error).toContain('happens twice');
+        });
+        it('accepts the extreme real offsets', () => {
+            expect(iso('2026-10-15T12:00:00+14:00')).toBe('2026-10-14T22:00:00.000Z');
+            expect(iso('2026-10-15T12:00:00-12:00')).toBe('2026-10-16T00:00:00.000Z');
+            expect(iso('2026-10-15T12:00:00+05:45')).toBe('2026-10-15T06:15:00.000Z');
+        });
+        it.each(['+24:00', '+11:60', '-13:00', '+14:01', '+99:99'])('rejects the invalid offset %p', (offset) => {
+            const result = (0, timer_input_1.parseInstant)(`2026-10-15T12:00:00${offset}`);
+            expect(result.ok).toBe(false);
+            expect(!result.ok && result.error).toContain('not a real UTC offset');
+        });
+        it('rejects unknown timezones, impossible dates and other formats', () => {
+            expect((0, timer_input_1.parseInstant)('2026-10-15T12:00:00', 'Mars/Olympus').ok).toBe(false);
+            expect((0, timer_input_1.parseInstant)('2026-02-30T12:00:00Z').ok).toBe(false);
+            expect((0, timer_input_1.parseInstant)('tomorrow at noon').ok).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=timer-input.spec.js.map

package/dist/threads/timers/timer-input.spec.js.map

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