@utilix-tech/sdk 0.1.0

package/dist/time-DbT8fjaF.d.cts

@@ -0,0 +1,145 @@
+/**
+ * @module time
+ * Tools covered:
+ *  - unix-time   : fromUnix, fromIsoString, getNow, formatRelative
+ *  - cron-parser : parseCron, COMMON_CRONS
+ *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
+ *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
+ *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ */
+interface TimestampResult {
+    unix: number;
+    unixMs: number;
+    iso: string;
+    utc: string;
+    local: string;
+    relative: string;
+}
+declare function formatRelative(diffMs: number): string;
+declare function fromUnix(ts: number): TimestampResult;
+declare function fromIsoString(iso: string): TimestampResult | {
+    error: string;
+};
+declare function getNow(): TimestampResult;
+interface CronField {
+    raw: string;
+    description: string;
+    valid: boolean;
+}
+interface CronResult {
+    raw: string;
+    fields: {
+        minute: CronField;
+        hour: CronField;
+        day: CronField;
+        month: CronField;
+        weekday: CronField;
+    };
+    summary: string;
+    valid: boolean;
+    error?: string;
+}
+declare function parseCron(expr: string): CronResult;
+declare const COMMON_CRONS: Array<{
+    expr: string;
+    label: string;
+}>;
+interface DateDiffResult {
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    totalDays: number;
+    totalHours: number;
+    totalMinutes: number;
+    totalSeconds: number;
+    isPast: boolean;
+    humanReadable: string;
+}
+declare function parseDate(input: string): Date | null;
+declare function humanizeDiff(result: DateDiffResult): string;
+declare function diffDates(from: string, to: string): DateDiffResult | {
+    error: string;
+};
+declare const COMMON_DATE_PRESETS: Array<{
+    label: string;
+    from: () => string;
+    to: () => string;
+}>;
+interface TimezoneEntry {
+    tz: string;
+    label: string;
+    offset: string;
+}
+declare const TIMEZONES: TimezoneEntry[];
+declare function getTimezoneOffset(tz: string, isoString: string): string;
+declare function convertTime(isoString: string, fromTz: string, toTz: string): {
+    result: string;
+    error?: string;
+};
+declare function formatInTimezone(isoString: string, tz: string): {
+    date: string;
+    time: string;
+    offset: string;
+    label: string;
+};
+declare function getAllZonesForTime(isoString: string): Array<TimezoneEntry & {
+    localTime: string;
+}>;
+interface CronNextField {
+    raw: string;
+    values: number[];
+    min: number;
+    max: number;
+}
+interface ParsedCron {
+    minute: CronNextField;
+    hour: CronNextField;
+    dayOfMonth: CronNextField;
+    month: CronNextField;
+    dayOfWeek: CronNextField;
+    timezone?: string;
+}
+declare function parseCronExpression(expr: string): ParsedCron | {
+    error: string;
+};
+declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Date[] | {
+    error: string;
+};
+declare function formatRunDate(date: Date, timezone?: string): string;
+declare function getRunInterval(dates: Date[]): string;
+
+declare const time_COMMON_CRONS: typeof COMMON_CRONS;
+declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
+type time_CronField = CronField;
+type time_CronNextField = CronNextField;
+type time_CronResult = CronResult;
+type time_DateDiffResult = DateDiffResult;
+type time_ParsedCron = ParsedCron;
+declare const time_TIMEZONES: typeof TIMEZONES;
+type time_TimestampResult = TimestampResult;
+type time_TimezoneEntry = TimezoneEntry;
+declare const time_convertTime: typeof convertTime;
+declare const time_diffDates: typeof diffDates;
+declare const time_formatInTimezone: typeof formatInTimezone;
+declare const time_formatRelative: typeof formatRelative;
+declare const time_formatRunDate: typeof formatRunDate;
+declare const time_fromIsoString: typeof fromIsoString;
+declare const time_fromUnix: typeof fromUnix;
+declare const time_getAllZonesForTime: typeof getAllZonesForTime;
+declare const time_getNextRuns: typeof getNextRuns;
+declare const time_getNow: typeof getNow;
+declare const time_getRunInterval: typeof getRunInterval;
+declare const time_getTimezoneOffset: typeof getTimezoneOffset;
+declare const time_humanizeDiff: typeof humanizeDiff;
+declare const time_parseCron: typeof parseCron;
+declare const time_parseCronExpression: typeof parseCronExpression;
+declare const time_parseDate: typeof parseDate;
+declare namespace time {
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate };
+}
+
+export { COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type TimestampResult as e, type TimezoneEntry as f, convertTime as g, diffDates as h, formatInTimezone as i, formatRelative as j, formatRunDate as k, fromIsoString as l, fromUnix as m, getAllZonesForTime as n, getNextRuns as o, getNow as p, getRunInterval as q, getTimezoneOffset as r, humanizeDiff as s, time as t, parseCron as u, parseCronExpression as v, parseDate as w };

package/dist/time-DbT8fjaF.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @module time
+ * Tools covered:
+ *  - unix-time   : fromUnix, fromIsoString, getNow, formatRelative
+ *  - cron-parser : parseCron, COMMON_CRONS
+ *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
+ *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
+ *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ */
+interface TimestampResult {
+    unix: number;
+    unixMs: number;
+    iso: string;
+    utc: string;
+    local: string;
+    relative: string;
+}
+declare function formatRelative(diffMs: number): string;
+declare function fromUnix(ts: number): TimestampResult;
+declare function fromIsoString(iso: string): TimestampResult | {
+    error: string;
+};
+declare function getNow(): TimestampResult;
+interface CronField {
+    raw: string;
+    description: string;
+    valid: boolean;
+}
+interface CronResult {
+    raw: string;
+    fields: {
+        minute: CronField;
+        hour: CronField;
+        day: CronField;
+        month: CronField;
+        weekday: CronField;
+    };
+    summary: string;
+    valid: boolean;
+    error?: string;
+}
+declare function parseCron(expr: string): CronResult;
+declare const COMMON_CRONS: Array<{
+    expr: string;
+    label: string;
+}>;
+interface DateDiffResult {
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    totalDays: number;
+    totalHours: number;
+    totalMinutes: number;
+    totalSeconds: number;
+    isPast: boolean;
+    humanReadable: string;
+}
+declare function parseDate(input: string): Date | null;
+declare function humanizeDiff(result: DateDiffResult): string;
+declare function diffDates(from: string, to: string): DateDiffResult | {
+    error: string;
+};
+declare const COMMON_DATE_PRESETS: Array<{
+    label: string;
+    from: () => string;
+    to: () => string;
+}>;
+interface TimezoneEntry {
+    tz: string;
+    label: string;
+    offset: string;
+}
+declare const TIMEZONES: TimezoneEntry[];
+declare function getTimezoneOffset(tz: string, isoString: string): string;
+declare function convertTime(isoString: string, fromTz: string, toTz: string): {
+    result: string;
+    error?: string;
+};
+declare function formatInTimezone(isoString: string, tz: string): {
+    date: string;
+    time: string;
+    offset: string;
+    label: string;
+};
+declare function getAllZonesForTime(isoString: string): Array<TimezoneEntry & {
+    localTime: string;
+}>;
+interface CronNextField {
+    raw: string;
+    values: number[];
+    min: number;
+    max: number;
+}
+interface ParsedCron {
+    minute: CronNextField;
+    hour: CronNextField;
+    dayOfMonth: CronNextField;
+    month: CronNextField;
+    dayOfWeek: CronNextField;
+    timezone?: string;
+}
+declare function parseCronExpression(expr: string): ParsedCron | {
+    error: string;
+};
+declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Date[] | {
+    error: string;
+};
+declare function formatRunDate(date: Date, timezone?: string): string;
+declare function getRunInterval(dates: Date[]): string;
+
+declare const time_COMMON_CRONS: typeof COMMON_CRONS;
+declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
+type time_CronField = CronField;
+type time_CronNextField = CronNextField;
+type time_CronResult = CronResult;
+type time_DateDiffResult = DateDiffResult;
+type time_ParsedCron = ParsedCron;
+declare const time_TIMEZONES: typeof TIMEZONES;
+type time_TimestampResult = TimestampResult;
+type time_TimezoneEntry = TimezoneEntry;
+declare const time_convertTime: typeof convertTime;
+declare const time_diffDates: typeof diffDates;
+declare const time_formatInTimezone: typeof formatInTimezone;
+declare const time_formatRelative: typeof formatRelative;
+declare const time_formatRunDate: typeof formatRunDate;
+declare const time_fromIsoString: typeof fromIsoString;
+declare const time_fromUnix: typeof fromUnix;
+declare const time_getAllZonesForTime: typeof getAllZonesForTime;
+declare const time_getNextRuns: typeof getNextRuns;
+declare const time_getNow: typeof getNow;
+declare const time_getRunInterval: typeof getRunInterval;
+declare const time_getTimezoneOffset: typeof getTimezoneOffset;
+declare const time_humanizeDiff: typeof humanizeDiff;
+declare const time_parseCron: typeof parseCron;
+declare const time_parseCronExpression: typeof parseCronExpression;
+declare const time_parseDate: typeof parseDate;
+declare namespace time {
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate };
+}
+
+export { COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type TimestampResult as e, type TimezoneEntry as f, convertTime as g, diffDates as h, formatInTimezone as i, formatRelative as j, formatRunDate as k, fromIsoString as l, fromUnix as m, getAllZonesForTime as n, getNextRuns as o, getNow as p, getRunInterval as q, getTimezoneOffset as r, humanizeDiff as s, time as t, parseCron as u, parseCronExpression as v, parseDate as w };