@craftguild/jscalendar 0.5.3 → 0.5.4

package/dist/types.d.ts

@@ -1,246 +0,0 @@
-import type { TimeZoneId } from "./timezones.js";
-export { TimeZoneId, TimeZoneInput } from "./timezones.js";
-export type Id = string;
-export type Int = number;
-export type UnsignedInt = number;
-export type UTCDateTime = string;
-export type LocalDateTime = string;
-export type Duration = string;
-export type SignedDuration = string;
-export type BooleanMap = Record<string, true>;
-export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export type PatchValue = JsonValue | null;
-export interface PatchObject {
-    [key: string]: PatchValue;
-}
-type PatchFields<T> = {
-    [K in keyof Omit<T, "@type">]?: T[K] | null;
-};
-type PatchTag<TTag extends string> = {
-    __patchType?: TTag;
-};
-export type EventPatch = PatchFields<Event> & PatchTag<"Event">;
-export type TaskPatch = PatchFields<Task> & PatchTag<"Task">;
-export type GroupPatch = PatchFields<Group> & PatchTag<"Group">;
-export type ParticipantPatch = PatchFields<Participant>;
-export type LocationPatch = PatchFields<Location>;
-export type VirtualLocationPatch = PatchFields<VirtualLocation>;
-export type AlertPatch = PatchFields<Alert>;
-export type RelationPatch = PatchFields<Relation>;
-export type LinkPatch = PatchFields<Link>;
-export type TimeZonePatch = PatchFields<TimeZone>;
-export type TimeZoneRulePatch = PatchFields<TimeZoneRule>;
-export type RecurrenceRulePatch = PatchFields<RecurrenceRule>;
-export type NDayPatch = PatchFields<NDay>;
-export type PatchLike = PatchObject | EventPatch | TaskPatch | GroupPatch | TimeZoneRulePatch;
-export interface Relation {
-    "@type": "Relation";
-    relation?: BooleanMap;
-}
-export interface Link {
-    "@type": "Link";
-    href: string;
-    cid?: string;
-    contentType?: string;
-    size?: UnsignedInt;
-    rel?: string;
-    display?: string;
-    title?: string;
-}
-export interface Location {
-    "@type": "Location";
-    name?: string;
-    description?: string;
-    locationTypes?: BooleanMap;
-    relativeTo?: string;
-    timeZone?: TimeZoneId;
-    coordinates?: string;
-    links?: Record<Id, Link>;
-}
-export interface VirtualLocation {
-    "@type": "VirtualLocation";
-    name?: string;
-    description?: string;
-    uri: string;
-    features?: BooleanMap;
-}
-export interface Participant {
-    "@type": "Participant";
-    name?: string;
-    email?: string;
-    description?: string;
-    sendTo?: Record<string, string>;
-    kind?: string;
-    roles: BooleanMap;
-    locationId?: Id;
-    language?: string;
-    participationStatus?: string;
-    participationComment?: string;
-    expectReply?: boolean;
-    scheduleAgent?: string;
-    scheduleForceSend?: boolean;
-    scheduleSequence?: UnsignedInt;
-    scheduleStatus?: string[];
-    scheduleUpdated?: UTCDateTime;
-    sentBy?: string;
-    invitedBy?: Id;
-    delegatedTo?: Record<Id, true>;
-    delegatedFrom?: Record<Id, true>;
-    memberOf?: Record<Id, true>;
-    links?: Record<Id, Link>;
-    progress?: string;
-    progressUpdated?: UTCDateTime;
-    percentComplete?: UnsignedInt;
-}
-export interface OffsetTrigger {
-    "@type": "OffsetTrigger";
-    offset: SignedDuration;
-    relativeTo?: "start" | "end" | string;
-}
-export interface AbsoluteTrigger {
-    "@type": "AbsoluteTrigger";
-    when: UTCDateTime;
-}
-export interface UnknownTrigger {
-    "@type": string;
-    [key: string]: JsonValue;
-}
-export type Trigger = OffsetTrigger | AbsoluteTrigger | UnknownTrigger;
-export interface Alert {
-    "@type": "Alert";
-    trigger: Trigger;
-    acknowledged?: UTCDateTime;
-    relatedTo?: Record<string, Relation>;
-    action?: string;
-}
-export type DayOfWeek = "mo" | "tu" | "we" | "th" | "fr" | "sa" | "su";
-export interface NDay {
-    "@type": "NDay";
-    day: DayOfWeek;
-    nthOfPeriod?: Int;
-}
-export interface RecurrenceRule {
-    "@type": "RecurrenceRule";
-    frequency: "yearly" | "monthly" | "weekly" | "daily" | "hourly" | "minutely" | "secondly";
-    interval?: UnsignedInt;
-    rscale?: string;
-    skip?: "omit" | "backward" | "forward";
-    firstDayOfWeek?: DayOfWeek;
-    byDay?: NDay[];
-    byMonthDay?: Int[];
-    byMonth?: string[];
-    byYearDay?: Int[];
-    byWeekNo?: Int[];
-    byHour?: UnsignedInt[];
-    byMinute?: UnsignedInt[];
-    bySecond?: UnsignedInt[];
-    bySetPosition?: Int[];
-    count?: UnsignedInt;
-    until?: LocalDateTime;
-}
-export interface TimeZoneRule {
-    "@type": "TimeZoneRule";
-    start: LocalDateTime;
-    offsetFrom: string;
-    offsetTo: string;
-    recurrenceRules?: RecurrenceRule[];
-    recurrenceOverrides?: Record<LocalDateTime, TimeZoneRulePatch>;
-    names?: BooleanMap;
-    comments?: string[];
-}
-export interface TimeZone {
-    "@type": "TimeZone";
-    tzId: string;
-    updated?: UTCDateTime;
-    url?: string;
-    validUntil?: UTCDateTime;
-    aliases?: BooleanMap;
-    standard?: TimeZoneRule[];
-    daylight?: TimeZoneRule[];
-}
-export interface JSCalendarCommon {
-    "@type": string;
-    uid: string;
-    relatedTo?: Record<string, Relation>;
-    prodId?: string;
-    created?: UTCDateTime;
-    updated: UTCDateTime;
-    sequence?: UnsignedInt;
-    method?: string;
-    title?: string;
-    description?: string;
-    descriptionContentType?: string;
-    showWithoutTime?: boolean;
-    locations?: Record<Id, Location>;
-    virtualLocations?: Record<Id, VirtualLocation>;
-    links?: Record<Id, Link>;
-    locale?: string;
-    keywords?: BooleanMap;
-    categories?: BooleanMap;
-    color?: string;
-    recurrenceId?: LocalDateTime;
-    recurrenceIdTimeZone?: TimeZoneId | null;
-    recurrenceRules?: RecurrenceRule[];
-    excludedRecurrenceRules?: RecurrenceRule[];
-    excluded?: boolean;
-    priority?: Int;
-    freeBusyStatus?: string;
-    privacy?: string;
-    replyTo?: Record<string, string>;
-    sentBy?: string;
-    participants?: Record<Id, Participant>;
-    requestStatus?: string;
-    useDefaultAlerts?: boolean;
-    alerts?: Record<Id, Alert>;
-    timeZone?: TimeZoneId | null;
-    timeZones?: Partial<Record<TimeZoneId, TimeZone>>;
-}
-export interface Event extends JSCalendarCommon {
-    "@type": "Event";
-    start: LocalDateTime;
-    duration?: Duration;
-    status?: string;
-    localizations?: Record<string, EventPatch>;
-    recurrenceOverrides?: Record<LocalDateTime, EventPatch>;
-}
-export interface Task extends JSCalendarCommon {
-    "@type": "Task";
-    due?: LocalDateTime;
-    start?: LocalDateTime;
-    estimatedDuration?: Duration;
-    percentComplete?: UnsignedInt;
-    progress?: string;
-    progressUpdated?: UTCDateTime;
-    localizations?: Record<string, TaskPatch>;
-    recurrenceOverrides?: Record<LocalDateTime, TaskPatch>;
-}
-export interface Group extends JSCalendarCommon {
-    "@type": "Group";
-    entries: Array<Event | Task>;
-    source?: string;
-    localizations?: Record<string, GroupPatch>;
-    recurrenceOverrides?: Record<LocalDateTime, GroupPatch>;
-}
-export type JSCalendarObject = Event | Task | Group;
-export type CalendarType = JSCalendarObject["@type"];
-export type CreateInput<TType extends CalendarType> = TType extends "Event" ? Omit<Event, "@type" | "uid" | "updated"> & {
-    type?: "Event" | "event";
-    "@type"?: "Event";
-    uid?: string;
-    updated?: UTCDateTime;
-} : TType extends "Task" ? Omit<Task, "@type" | "uid" | "updated"> & {
-    type?: "Task" | "task";
-    "@type"?: "Task";
-    uid?: string;
-    updated?: UTCDateTime;
-} : Omit<Group, "@type" | "uid" | "updated"> & {
-    type?: "Group" | "group";
-    "@type"?: "Group";
-    uid?: string;
-    updated?: UTCDateTime;
-};
-export type AnyCreateInput = CreateInput<"Event"> | CreateInput<"Task"> | CreateInput<"Group">;
-export type CalendarLike = JSCalendarObject | PatchObject | JsonValue;

package/dist/types.js

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

package/dist/utils.d.ts

@@ -1,82 +0,0 @@
-import type { Duration, UTCDateTime } from "./types.js";
-export type PrimitiveLike = string | number | boolean | object | null | undefined;
-/**
- * Check whether a value is a string.
- * @param value Value to check.
- * @return True if the value is a string.
- */
-export declare function isStringValue(value: PrimitiveLike): value is string;
-/**
- * Check whether a value is a number.
- * @param value Value to check.
- * @return True if the value is a number.
- */
-export declare function isNumberValue(value: PrimitiveLike): value is number;
-/**
- * Check whether a value is a boolean.
- * @param value Value to check.
- * @return True if the value is a boolean.
- */
-export declare function isBooleanValue(value: PrimitiveLike): value is boolean;
-/**
- * Check whether a value is a non-null object.
- * @param value Value to check.
- * @return True if the value is a non-null object.
- */
-export declare function isObjectValue(value: PrimitiveLike): value is object;
-/**
- * Get the current UTC date-time string.
- * @return Current time as UTCDateTime.
- */
-export declare function nowUtc(): UTCDateTime;
-/**
- * Deep-clone a value using structuredClone.
- * @param value Value to clone.
- * @return Deep clone of the input value.
- */
-export declare function deepClone<T>(value: T): T;
-/**
- * Check if a string is a UTCDateTime with Z suffix.
- * @param value Date-time string.
- * @return True if the value ends with Z.
- */
-export declare function isUtcDateTime(value: string): boolean;
-/**
- * Compare two date-time strings, returning null when incomparable.
- * @param a Date-time string A.
- * @param b Date-time string B.
- * @return -1, 0, 1, or null when formats are incompatible.
- */
-export declare function compareDateTime(a: string, b: string): number | null;
-/**
- * Convert a duration string to milliseconds.
- * @param duration Duration string.
- * @return Milliseconds or null when invalid.
- */
-export declare function durationToMilliseconds(duration: Duration): number | null;
-/**
- * Normalize a UTCDateTime by trimming trailing fractional zeros.
- * @param value UTCDateTime string.
- * @return Normalized UTCDateTime string.
- */
-export declare function normalizeUtcDateTime(value: string): UTCDateTime;
-/**
- * Format a Date as LocalDateTime string.
- * @param value Date to format.
- * @return LocalDateTime string.
- */
-export declare function localDateTimeFromDate(value: Date): string;
-/**
- * Format a Date as a LocalDateTime in a target time zone.
- * @param value Date to format.
- * @param timeZone IANA time zone.
- * @return LocalDateTime string in the time zone.
- */
-export declare function dateTimeInTimeZone(value: Date, timeZone: string): string;
-/**
- * Convert LocalDateTime string to a UTC Date using a time zone.
- * @param value LocalDateTime string.
- * @param timeZone IANA time zone.
- * @return Date in UTC.
- */
-export declare function localDateTimeToUtcDate(value: string, timeZone: string): Date;

package/dist/utils.js

@@ -1,164 +0,0 @@
-import { format } from "date-fns";
-import { formatInTimeZone, fromZonedTime } from "date-fns-tz";
-const TYPEOF_FUNCTION = "function";
-const TYPEOF_STRING = "string";
-const TYPEOF_NUMBER = "number";
-const TYPEOF_BOOLEAN = "boolean";
-const TYPEOF_OBJECT = "object";
-/**
- * Check whether a value is a string.
- * @param value Value to check.
- * @return True if the value is a string.
- */
-export function isStringValue(value) {
-    return typeof value === TYPEOF_STRING;
-}
-/**
- * Check whether a value is a number.
- * @param value Value to check.
- * @return True if the value is a number.
- */
-export function isNumberValue(value) {
-    return typeof value === TYPEOF_NUMBER;
-}
-/**
- * Check whether a value is a boolean.
- * @param value Value to check.
- * @return True if the value is a boolean.
- */
-export function isBooleanValue(value) {
-    return typeof value === TYPEOF_BOOLEAN;
-}
-/**
- * Check whether a value is a non-null object.
- * @param value Value to check.
- * @return True if the value is a non-null object.
- */
-export function isObjectValue(value) {
-    return value !== null && typeof value === TYPEOF_OBJECT;
-}
-/**
- * Get the current UTC date-time string.
- * @return Current time as UTCDateTime.
- */
-export function nowUtc() {
-    return normalizeUtcDateTime(new Date().toISOString());
-}
-/**
- * Deep-clone a value using structuredClone.
- * @param value Value to clone.
- * @return Deep clone of the input value.
- */
-export function deepClone(value) {
-    if (typeof structuredClone === TYPEOF_FUNCTION) {
-        return structuredClone(value);
-    }
-    throw new Error("structuredClone is not available in this environment");
-}
-/**
- * Check if a string is a UTCDateTime with Z suffix.
- * @param value Date-time string.
- * @return True if the value ends with Z.
- */
-export function isUtcDateTime(value) {
-    return /Z$/.test(value);
-}
-/**
- * Compare two date-time strings, returning null when incomparable.
- * @param a Date-time string A.
- * @param b Date-time string B.
- * @return -1, 0, 1, or null when formats are incompatible.
- */
-export function compareDateTime(a, b) {
-    const aUtc = isUtcDateTime(a);
-    const bUtc = isUtcDateTime(b);
-    if (aUtc && bUtc) {
-        const aMs = Date.parse(a);
-        const bMs = Date.parse(b);
-        if (Number.isNaN(aMs) || Number.isNaN(bMs))
-            return null;
-        return aMs === bMs ? 0 : aMs < bMs ? -1 : 1;
-    }
-    if (!aUtc && !bUtc) {
-        if (a === b)
-            return 0;
-        return a < b ? -1 : 1;
-    }
-    return null;
-}
-/**
- * Convert a duration string to milliseconds.
- * @param duration Duration string.
- * @return Milliseconds or null when invalid.
- */
-export function durationToMilliseconds(duration) {
-    const re = /^P(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
-    const match = re.exec(duration);
-    if (!match)
-        return null;
-    const weeks = Number(match[1] || 0);
-    const days = Number(match[2] || 0);
-    const hours = Number(match[3] || 0);
-    const minutes = Number(match[4] || 0);
-    const seconds = Number(match[5] || 0);
-    const totalSeconds = weeks * 7 * 24 * 60 * 60 +
-        days * 24 * 60 * 60 +
-        hours * 60 * 60 +
-        minutes * 60 +
-        seconds;
-    return totalSeconds * 1000;
-}
-/**
- * Normalize a UTCDateTime by trimming trailing fractional zeros.
- * @param value UTCDateTime string.
- * @return Normalized UTCDateTime string.
- */
-export function normalizeUtcDateTime(value) {
-    const match = value.match(/^(.*)\.(\d+)Z$/);
-    if (!match)
-        return value;
-    const prefix = match[1] ?? value;
-    const fraction = match[2] ?? "";
-    const trimmed = fraction.replace(/0+$/, "");
-    if (trimmed.length === 0) {
-        return `${prefix}Z`;
-    }
-    return `${prefix}.${trimmed}Z`;
-}
-/**
- * Format a Date as LocalDateTime string.
- * @param value Date to format.
- * @return LocalDateTime string.
- */
-export function localDateTimeFromDate(value) {
-    return format(value, "yyyy-MM-dd'T'HH:mm:ss");
-}
-/**
- * Format a Date as a LocalDateTime in a target time zone.
- * @param value Date to format.
- * @param timeZone IANA time zone.
- * @return LocalDateTime string in the time zone.
- */
-export function dateTimeInTimeZone(value, timeZone) {
-    return formatInTimeZone(value, timeZone, "yyyy-MM-dd'T'HH:mm:ss");
-}
-/**
- * Convert LocalDateTime string to a UTC Date using a time zone.
- * @param value LocalDateTime string.
- * @param timeZone IANA time zone.
- * @return Date in UTC.
- */
-export function localDateTimeToUtcDate(value, timeZone) {
-    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})/.exec(value);
-    if (!match) {
-        throw new Error(`Invalid LocalDateTime: ${value}`);
-    }
-    const year = Number(match[1]);
-    const month = Number(match[2]);
-    const day = Number(match[3]);
-    const hour = Number(match[4]);
-    const minute = Number(match[5]);
-    const second = Number(match[6]);
-    const local = new Date(year, month - 1, day, hour, minute, second);
-    return fromZonedTime(local, timeZone);
-}

package/dist/validate/asserts.d.ts

@@ -1,155 +0,0 @@
-import type { JsonValue, PatchLike } from "../types.js";
-/**
- * Get the UTF-8 byte length of a string.
- * @param value Input string.
- * @return Byte length.
- */
-export declare function utf8Length(value: string): number;
-/**
- * Check whether a value is a plain record.
- * @param value Input value.
- * @return True if the value is a record.
- */
-export declare function isRecord(value: object | null | undefined): value is Record<string, JsonValue>;
-/**
- * Assert a value is a string when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertString(value: string | null | undefined, path: string): void;
-/**
- * Assert a value is a non-empty string when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertNonEmptyString(value: string | undefined, path: string): void;
-/**
- * Assert a value is a valid Id when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertId(value: string | undefined, path: string): void;
-/**
- * Assert a value is boolean when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertBoolean(value: boolean | null | undefined, path: string): void;
-/**
- * Assert a value is an integer when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertInteger(value: number | null | undefined, path: string): void;
-/**
- * Assert a value is a non-negative integer when defined.
- * @param value Value to check.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertUnsignedInt(value: number | null | undefined, path: string): void;
-/**
- * Assert a date-time string matches the expected format.
- * @param value Date-time string.
- * @param path Validation path.
- * @param requireZ Whether a Z suffix is required.
- * @return Nothing.
- */
-export declare function assertDateTime(value: string | undefined, path: string, requireZ: boolean): void;
-/**
- * Assert local date time when provided.
- * @param value LocalDateTime string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertLocalDateTime(value: string | undefined, path: string): void;
-/**
- * Assert utc date time when provided.
- * @param value UTCDateTime string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertUtcDateTime(value: string | undefined, path: string): void;
-/**
- * Assert duration like when provided.
- * @param value Duration string.
- * @param path Validation path.
- * @param signed Whether negative values are allowed.
- * @return Nothing.
- */
-export declare function assertDurationLike(value: string | undefined, path: string, signed: boolean): void;
-/**
- * Assert duration when provided.
- * @param value Duration string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertDuration(value: string | undefined, path: string): void;
-/**
- * Assert signed duration when provided.
- * @param value Duration string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertSignedDuration(value: string | undefined, path: string): void;
-/**
- * Assert boolean map when provided.
- * @param value Boolean map object.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertBooleanMap(value: object | undefined, path: string): void;
-/**
- * Assert ID boolean map when provided.
- * @param value Boolean map object keyed by Ids.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertIdBooleanMap(value: object | undefined, path: string): void;
-/**
- * Assert media type when provided.
- * @param value Media type string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertMediaType(value: string | undefined, path: string): void;
-/**
- * Assert text content type when provided.
- * @param value Media type string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertTextContentType(value: string | undefined, path: string): void;
-/**
- * Assert content ID when provided.
- * @param value Content-ID string.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertContentId(value: string | undefined, path: string): void;
-/**
- * Assert time zone when provided.
- * @param value Time zone ID.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertTimeZone(value: string | null | undefined, path: string): void;
-/**
- * Assert json value when provided.
- * @param value JSON value.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertJsonValue(value: JsonValue | object | null | undefined, path: string): void;
-/**
- * Assert patch object when provided.
- * @param value PatchObject.
- * @param path Validation path.
- * @return Nothing.
- */
-export declare function assertPatchObject(value: PatchLike | undefined, path: string): void;