@webamoki/web-svelte 1.2.3 → 2.1.0

package/dist/{utils → shared/utils}/datetime/index.d.ts

@@ -1,15 +1,48 @@
 import type { Transport } from '@sveltejs/kit';
 import { CalendarDate, type DateDuration, Time, ZonedDateTime } from '@internationalized/date';
-import type { Day } from '../types/arktype.js';
 export declare const Days: readonly ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+export type Day = (typeof Days)[number];
 export declare const DayIndex: Record<Day, number>;
+export declare class LocalDateF {
+    private readonly timezone;
+    constructor(timezone: string);
+    /**
+     * Calculates the age from a date of birth.
+     * @param dob - The date of birth.
+     * @returns The age in years.
+     * @throws Error if the date of birth is in the future.
+     */
+    ageFromDob(dob: CalendarDate): number;
+    /**
+     * Checks if a given date is today.
+     * @param date - The date to check.
+     * @returns True if the date is today, false otherwise.
+     */
+    isDateToday(date: CalendarDate): boolean;
+    /**
+     * @returns The current date and time.
+     */
+    now(): ZonedDateTime;
+    /**
+     * @returns The current date.
+     */
+    today(): CalendarDate;
+}
+/** Gets the day index of the date */
+export declare function getDayIndexOfDate(date: CalendarDate): number;
 /**
- * Calculates the age from a date of birth.
- * @param dob - The date of birth.
- * @returns The age in years.
- * @throws Error if the date of birth is in the future.
+ * Gets the day of the week for a given date.
+ * @param date - The date to get the day of the week for.
+ * @returns The day of the week
  */
-export declare function ageFromDob(dob: CalendarDate, timezone: string): number;
+export declare function getDayOfDate(date: CalendarDate): Day;
+/**
+ * Checks if a given date is a specific day of the week.
+ * @param date - The date to check.
+ * @param dayOfWeek - The day of the week to check against.
+ * @returns True if the date is the specified day, false otherwise.
+ */
+export declare function isDateDay(date: CalendarDate, dayOfWeek: Day): boolean;
 /**
  * Checks if two time ranges overlap, boundaries are not considered overlapping.
  * @param start1 - The start time of the first range.
@@ -27,14 +60,6 @@ export declare function checkOverlap(start1: Time, end1: Time, start2: Time, end
  * @returns True if the dates are within duration, false otherwise.
  */
 export declare function datesWithin(date1: CalendarDate, date2: CalendarDate, duration: DateDuration): boolean;
-/** Gets the day index of the date */
-export declare function getDayIndex(date: CalendarDate): number;
-/**
- * Gets the day of the week for a given date.
- * @param date - The date to get the day of the week for.
- * @returns The day of the week
- */
-export declare function getDayOfDate(date: CalendarDate): Day;
 /**
  * Gets the most recent occurrence of a day of the week.
  * @param dayOfWeek - The day of the week
@@ -66,19 +91,6 @@ export declare function getLastMonths(count: number, startDate: CalendarDate): C
  * @returns The date of the next occurrence of the specified day.
  */
 export declare function getNextDateOfDay(dayOfWeek: Day, startDate: CalendarDate): CalendarDate;
-/**
- * Checks if a given date is a specific day of the week.
- * @param date - The date to check.
- * @param dayOfWeek - The day of the week to check against.
- * @returns True if the date is the specified day, false otherwise.
- */
-export declare function isDateDay(date: CalendarDate, dayOfWeek: Day): boolean;
-/**
- * Checks if a given date is today.
- * @param date - The date to check.
- * @returns True if the date is today, false otherwise.
- */
-export declare function isDateToday(date: CalendarDate, timezone: string): boolean;
 /**
  * Calculates the difference in weeks between two dates.
  * @param date1 - The first date in order.
@@ -135,9 +147,15 @@ export declare function formatDateShort(date: CalendarDate): string;
  * Formats the month only.
  * @param date - The date to format.
  * @returns The formatted month string.
- * @example "Oct"
+ * @example "Oct 23"
  */
 export declare function formatMonth(date: CalendarDate): string;
+/**
+ * Gives time in HH:MM format
+ * @param time
+ * @returns string of time in that format
+ */
+export declare function formatTime(time: Time): string;
 /**
  * Calculates the end time given a starting time and duration.
  * @param timeStart starting time
@@ -151,12 +169,6 @@ export declare function formatTimeEnd(timeStart: Time, durationMinutes: number):
  * @returns string of time in that format
  */
 export declare function formatTimeFull(time: Time): string;
-/**
- * Gives time in HH:MM format
- * @param time
- * @returns string of time in that format
- */
-export declare function formatTimeShort(time: Time): string;
 /**
  * Unfreezes a CalendarDate object from a snapshot.
  * @param raw - The snapshot of the CalendarDate object.
@@ -169,4 +181,10 @@ export declare function unfreezeDate(raw: ReturnType<typeof $state.snapshot<Cale
  * @returns The unfrozen Time object.
  */
 export declare function unfreezeTime(raw: ReturnType<typeof $state.snapshot<Time>>): Time;
+/**
+ * Unfreezes a ZonedDateTime object from a snapshot.
+ * @param date - The snapshot of the ZonedDateTime object.
+ * @returns The unfrozen ZonedDateTime object.
+ */
+export declare function unfreezeAbsoluteDate(date: ReturnType<typeof $state.snapshot<ZonedDateTime>>): ZonedDateTime;
 export declare const dateTransport: Transport;

package/dist/{utils → shared/utils}/datetime/index.js

@@ -1,6 +1,5 @@
-import { CalendarDate, DateFormatter, fromDate, getDayOfWeek, getLocalTimeZone, startOfMonth, Time, toCalendarDate, today, toTime, ZonedDateTime } from '@internationalized/date';
+import { CalendarDate, DateFormatter, fromDate, getDayOfWeek, getLocalTimeZone, now as nowFn, startOfMonth, Time, toCalendarDate, today as todayFn, toTime, ZonedDateTime } from '@internationalized/date';
 import { map, range } from 'ramda';
-const DEFAULT_TIME_ZONE = 'Europe/London';
 const DEFAULT_LOCALE = 'en-GB';
 // Day of the week
 export const Days = [
@@ -13,26 +12,77 @@ export const Days = [
     'Sunday'
 ];
 export const DayIndex = Object.fromEntries(Days.map((day, index) => [day, index]));
-/**
- * Calculates the age from a date of birth.
- * @param dob - The date of birth.
- * @returns The age in years.
- * @throws Error if the date of birth is in the future.
- */
-export function ageFromDob(dob, timezone) {
-    const todayDate = today(timezone);
-    if (todayDate.compare(dob) < 0) {
-        throw new Error('Date of birth is in the future');
+// Date functions local to a timezone
+export class LocalDateF {
+    timezone;
+    constructor(timezone) {
+        this.timezone = timezone;
+    }
+    /**
+     * Calculates the age from a date of birth.
+     * @param dob - The date of birth.
+     * @returns The age in years.
+     * @throws Error if the date of birth is in the future.
+     */
+    ageFromDob(dob) {
+        const todayDate = this.today();
+        if (todayDate.compare(dob) < 0) {
+            throw new Error('Date of birth is in the future');
+        }
+        let years = todayDate.year - dob.year;
+        const monthDiff = todayDate.month - dob.month;
+        const dayDiff = todayDate.day - dob.day;
+        // Adjust years down if birthday hasn't occurred this year
+        if (monthDiff < 0 || (monthDiff === 0 && dayDiff < 0)) {
+            years--;
+        }
+        return years;
     }
-    let years = todayDate.year - dob.year;
-    const monthDiff = todayDate.month - dob.month;
-    const dayDiff = todayDate.day - dob.day;
-    // Adjust years down if birthday hasn't occurred this year
-    if (monthDiff < 0 || (monthDiff === 0 && dayDiff < 0)) {
-        years--;
+    /**
+     * Checks if a given date is today.
+     * @param date - The date to check.
+     * @returns True if the date is today, false otherwise.
+     */
+    isDateToday(date) {
+        return this.today().compare(date) === 0;
     }
-    return years;
+    /**
+     * @returns The current date and time.
+     */
+    now() {
+        return nowFn(this.timezone);
+    }
+    /**
+     * @returns The current date.
+     */
+    today() {
+        return todayFn(this.timezone);
+    }
+}
+/** Gets the day index of the date */
+export function getDayIndexOfDate(date) {
+    // Always start 0 on Monday
+    return getDayOfWeek(date, DEFAULT_LOCALE, 'mon');
+}
+/**
+ * Gets the day of the week for a given date.
+ * @param date - The date to get the day of the week for.
+ * @returns The day of the week
+ */
+export function getDayOfDate(date) {
+    return Days[getDayIndexOfDate(date)];
+}
+/**
+ * Checks if a given date is a specific day of the week.
+ * @param date - The date to check.
+ * @param dayOfWeek - The day of the week to check against.
+ * @returns True if the date is the specified day, false otherwise.
+ */
+export function isDateDay(date, dayOfWeek) {
+    const dateDay = getDayOfDate(date);
+    return dateDay === dayOfWeek;
 }
+/* Intervals */
 /**
  * Checks if two time ranges overlap, boundaries are not considered overlapping.
  * @param start1 - The start time of the first range.
@@ -57,19 +107,6 @@ export function datesWithin(date1, date2, duration) {
         return false;
     return date1.add(duration).compare(date2) >= 0;
 }
-/** Gets the day index of the date */
-export function getDayIndex(date) {
-    // Always start 0 on Monday
-    return getDayOfWeek(date, DEFAULT_LOCALE, 'mon');
-}
-/**
- * Gets the day of the week for a given date.
- * @param date - The date to get the day of the week for.
- * @returns The day of the week
- */
-export function getDayOfDate(date) {
-    return Days[getDayIndex(date)];
-}
 /**
  * Gets the most recent occurrence of a day of the week.
  * @param dayOfWeek - The day of the week
@@ -79,7 +116,7 @@ export function getDayOfDate(date) {
  */
 export function getLastDateOfDay(dayOfWeek, startDate) {
     const dayIndex = DayIndex[dayOfWeek];
-    const startIndex = getDayIndex(startDate);
+    const startIndex = getDayIndexOfDate(startDate);
     // Already on the day
     if (startIndex === dayIndex)
         return startDate;
@@ -126,7 +163,7 @@ export function getLastMonths(count, startDate) {
  */
 export function getNextDateOfDay(dayOfWeek, startDate) {
     const dayIndex = DayIndex[dayOfWeek];
-    const startIndex = getDayIndex(startDate);
+    const startIndex = getDayIndexOfDate(startDate);
     // Already on the day
     if (startIndex === dayIndex)
         return startDate;
@@ -134,25 +171,6 @@ export function getNextDateOfDay(dayOfWeek, startDate) {
     const addition = (dayIndex - startIndex + 7) % 7;
     return startDate.add({ days: addition });
 }
-/* Intervals */
-/**
- * Checks if a given date is a specific day of the week.
- * @param date - The date to check.
- * @param dayOfWeek - The day of the week to check against.
- * @returns True if the date is the specified day, false otherwise.
- */
-export function isDateDay(date, dayOfWeek) {
-    const dateDay = getDayOfDate(date);
-    return dateDay === dayOfWeek;
-}
-/**
- * Checks if a given date is today.
- * @param date - The date to check.
- * @returns True if the date is today, false otherwise.
- */
-export function isDateToday(date, timezone) {
-    return today(timezone).compare(date) === 0;
-}
 const msPerWeek = 7 * 24 * 60 * 60 * 1000;
 /**
  * Calculates the difference in weeks between two dates.
@@ -160,9 +178,10 @@ const msPerWeek = 7 * 24 * 60 * 60 * 1000;
  * @param date2 - The second date in order.
  */
 export function dateDiffWeeks(date1, date2) {
-    const date1Abs = date1.toDate(DEFAULT_TIME_ZONE).getTime();
-    const date2Abs = date2.toDate(DEFAULT_TIME_ZONE).getTime();
-    return Math.floor((date2Abs - date1Abs) / msPerWeek);
+    const date1Ms = date1.toDate('UTC').getTime();
+    const date2Ms = date2.toDate('UTC').getTime();
+    const absDiff = Math.abs(date2Ms - date1Ms);
+    return Math.floor(absDiff / msPerWeek);
 }
 /* Formatting */
 /* Day of the week*/
@@ -253,12 +272,22 @@ export function formatDateShort(date) {
  * Formats the month only.
  * @param date - The date to format.
  * @returns The formatted month string.
- * @example "Oct"
+ * @example "Oct 23"
  */
 export function formatMonth(date) {
     return formatDate(date, MonthFormatter);
 }
 /* Times */
+/**
+ * Gives time in HH:MM format
+ * @param time
+ * @returns string of time in that format
+ */
+export function formatTime(time) {
+    const hours = padNum(time.hour, 2);
+    const minutes = padNum(time.minute, 2);
+    return `${hours}:${minutes}`;
+}
 /**
  * Calculates the end time given a starting time and duration.
  * @param timeStart starting time
@@ -267,7 +296,7 @@ export function formatMonth(date) {
  */
 export function formatTimeEnd(timeStart, durationMinutes) {
     const timeEnd = timeStart.add({ minutes: durationMinutes });
-    return formatTimeShort(timeEnd);
+    return formatTime(timeEnd);
 }
 /**
  * Gives time in HH:MM:SS format
@@ -280,16 +309,18 @@ export function formatTimeFull(time) {
     const seconds = padNum(time.second, 2);
     return `${hours}:${minutes}:${seconds}`;
 }
-/**
- * Gives time in HH:MM format
- * @param time
- * @returns string of time in that format
- */
-export function formatTimeShort(time) {
-    const hours = padNum(time.hour, 2);
-    const minutes = padNum(time.minute, 2);
-    return `${hours}:${minutes}`;
+/* Helpers */
+function formatDate(date, formatter) {
+    const nativeDate = date.toDate(getLocalTimeZone());
+    return formatter.format(nativeDate);
 }
+// Pad number with zeroes to the left
+function padNum(num, len) {
+    if (isNaN(num))
+        return '0'.repeat(len);
+    return num.toString().padStart(len, '0');
+}
+/* State handling */
 /**
  * Unfreezes a CalendarDate object from a snapshot.
  * @param raw - The snapshot of the CalendarDate object.
@@ -306,17 +337,13 @@ export function unfreezeDate(raw) {
 export function unfreezeTime(raw) {
     return new Time(raw.hour, raw.minute, raw.second, raw.millisecond);
 }
-/* State handling */
-function formatDate(date, formatter) {
-    const nativeDate = date.toDate(getLocalTimeZone());
-    return formatter.format(nativeDate);
-}
-// Pad number with zeroes to the left
-function padNum(num, len) {
-    if (isNaN(num)) {
-        return '0'.repeat(len);
-    }
-    return num.toString().padStart(len, '0');
+/**
+ * Unfreezes a ZonedDateTime object from a snapshot.
+ * @param date - The snapshot of the ZonedDateTime object.
+ * @returns The unfrozen ZonedDateTime object.
+ */
+export function unfreezeAbsoluteDate(date) {
+    return new ZonedDateTime(date.year, date.month, date.day, date.timeZone, date.offset, date.hour, date.minute, date.second, date.millisecond);
 }
 // SerDe
 export const dateTransport = {

package/dist/{utils → shared/utils}/email/README.md

@@ -4,17 +4,17 @@ This package provides utilities for sending emails using AWS Simple Email Servic
 
 ## Key Features
 
-- **Cloudflare Workers Compatible**: Uses direct AWS SES API calls with fetch instead of AWS SDK
-- **AWS Signature V4**: Implements proper AWS authentication for secure API requests
+- **Cloudflare Workers Compatible**: Uses `aws4fetch` for direct AWS SES API calls
+- **AWS Signature V4**: Handled by `aws4fetch` for secure API requests
 - **Zero Heavy Dependencies**: No AWS SDK required, works in any JavaScript runtime with fetch support
 
 ## Installation
 
-No additional dependencies required beyond the standard JavaScript runtime. The implementation uses:
+The implementation uses:
 
+- `aws4fetch` for AWS Signature V4 signing and requests
 - Native `fetch` API for HTTP requests
-- Web Crypto API for AWS Signature V4 signing
-- Native `DOMParser` for XML response parsing
+- Native `DOMParser` for XML response parsing (optional, used for error/response parsing)
 
 ## Configuration
 

package/dist/{utils → shared/utils}/email/ses.js

@@ -1,4 +1,4 @@
-import { signRequest } from './aws-signer.js';
+import { AwsClient } from 'aws4fetch';
 /**
  * Send an email using AWS SES API.
  * Uses AWS Signature V4 signing and fetch API for Cloudflare Workers compatibility.
@@ -71,21 +71,29 @@ export async function sendEmail(options) {
     const host = `email.${awsRegion}.amazonaws.com`;
     const path = '/';
     try {
-        // Sign the request
-        const { headers } = await signRequest('POST', host, path, body, {
+        const aws = new AwsClient({
             accessKeyId: awsAccessKeyId,
             region: awsRegion,
-            secretAccessKey: awsSecretAccessKey
+            secretAccessKey: awsSecretAccessKey,
+            service: 'ses'
         });
-        // Make the request
-        const response = await fetch(`https://${host}${path}`, {
+        const url = `https://${host}${path}`;
+        const init = {
             body,
             headers: {
-                ...headers,
-                'Content-Length': body.length.toString(),
-                Host: host
+                'Content-Type': 'application/x-form-urlencoded'
             },
             method: 'POST'
+        };
+        // Sign the request and then use the global fetch.
+        // We avoid using aws.fetch() directly as it can cause issues in some test environments
+        // or when fetch is mocked/replaced after AwsClient instantiation.
+        const signedRequest = await aws.sign(url, init);
+        // Use two-argument fetch to satisfy tests that expect the second argument to be an options object
+        const response = await fetch(signedRequest.url, {
+            body: init.body,
+            headers: signedRequest.headers,
+            method: signedRequest.method
         });
         const responseText = await response.text();
         if (!response.ok) {

package/dist/shared/utils/functional/index.d.ts

@@ -0,0 +1,2 @@
+import { Result } from './result.js';
+export { Result };

package/dist/shared/utils/functional/index.js

@@ -0,0 +1,2 @@
+import { Result } from './result.js';
+export { Result };

package/dist/shared/utils/functional/result.d.ts

@@ -0,0 +1,72 @@
+export type Result<T, E> = {
+    error: E;
+    ok: false;
+} | {
+    ok: true;
+    value: T;
+};
+export declare const Result: {
+    /**
+     * Creates a failed result with the given error.
+     */
+    err<E>(error: E): {
+        error: E;
+        ok: false;
+    };
+    /**
+     * Creates a successful result with the given value.
+     */
+    ok<T>(value: T): {
+        ok: true;
+        value: T;
+    };
+    /**
+     * Returns true if the result is Ok.
+     */
+    isOk<T, E>(result: Result<T, E>): result is {
+        ok: true;
+        value: T;
+    };
+    /**
+     * Returns true if the result is Err.
+     */
+    isErr<T, E>(result: Result<T, E>): result is {
+        error: E;
+        ok: false;
+    };
+    /**
+     * Returns the contained Ok value or a provided default.
+     */
+    unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+    /**
+     * Returns the contained Ok value or computes it from the provided op.
+     * @param op - Computes value in error case or throws an error.
+     */
+    unwrapOrElse<T, E>(result: Result<T, E>, op: (error: E) => T): T;
+    /**
+     * Maps a Result<T, E> to Result<U, E> by applying a function to a contained Ok value,
+     * leaving an Err value untouched.
+     */
+    map<T, U, E>(result: Result<T, E>, fn: (val: T) => U): Result<U, E>;
+    /**
+     * Maps a Result<T, E> to Result<T, F> by applying a function to a contained Err value,
+     * leaving an Ok value untouched.
+     */
+    mapErr<T, E, F>(result: Result<T, E>, fn: (err: E) => F): Result<T, F>;
+    /**
+     * Calls op if the result is Ok, otherwise returns the Err value of self.
+     * This function can be used for control flow based on Result values.
+     */
+    andThen<T, U, E>(result: Result<T, E>, op: (val: T) => Result<U, E>): Result<U, E>;
+    /**
+     * Calls op if the result is Err, otherwise returns the Ok value of self.
+     */
+    orElse<T, E, F>(result: Result<T, E>, op: (err: E) => Result<T, F>): Result<T, F>;
+    /**
+     * Pattern matches the Result and returns the result of the corresponding arm.
+     */
+    match<T, E, R>(result: Result<T, E>, arms: {
+        err: (err: E) => R;
+        ok: (val: T) => R;
+    }): R;
+};

package/dist/shared/utils/functional/result.js

@@ -0,0 +1,86 @@
+export const Result = {
+    /**
+     * Creates a failed result with the given error.
+     */
+    err(error) {
+        return { error, ok: false };
+    },
+    /**
+     * Creates a successful result with the given value.
+     */
+    ok(value) {
+        return { ok: true, value };
+    },
+    /**
+     * Returns true if the result is Ok.
+     */
+    isOk(result) {
+        return result.ok;
+    },
+    /**
+     * Returns true if the result is Err.
+     */
+    isErr(result) {
+        return !result.ok;
+    },
+    /**
+     * Returns the contained Ok value or a provided default.
+     */
+    unwrapOr(result, defaultValue) {
+        if (result.ok)
+            return result.value;
+        return defaultValue;
+    },
+    /**
+     * Returns the contained Ok value or computes it from the provided op.
+     * @param op - Computes value in error case or throws an error.
+     */
+    unwrapOrElse(result, op) {
+        if (result.ok)
+            return result.value;
+        return op(result.error);
+    },
+    /**
+     * Maps a Result<T, E> to Result<U, E> by applying a function to a contained Ok value,
+     * leaving an Err value untouched.
+     */
+    map(result, fn) {
+        if (result.ok)
+            return Result.ok(fn(result.value));
+        return result;
+    },
+    /**
+     * Maps a Result<T, E> to Result<T, F> by applying a function to a contained Err value,
+     * leaving an Ok value untouched.
+     */
+    mapErr(result, fn) {
+        if (!result.ok)
+            return Result.err(fn(result.error));
+        return result;
+    },
+    /**
+     * Calls op if the result is Ok, otherwise returns the Err value of self.
+     * This function can be used for control flow based on Result values.
+     */
+    andThen(result, op) {
+        if (result.ok)
+            return op(result.value);
+        return result;
+    },
+    /**
+     * Calls op if the result is Err, otherwise returns the Ok value of self.
+     */
+    orElse(result, op) {
+        if (!result.ok)
+            return op(result.error);
+        return result;
+    },
+    /**
+     * Pattern matches the Result and returns the result of the corresponding arm.
+     */
+    match(result, arms) {
+        if (result.ok)
+            return arms.ok(result.value);
+        return arms.err(result.error);
+    }
+};

package/dist/shared/utils/functional/result.spec.d.ts

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