uapp-communication-sdk 1.0.0-dev.54

package/types/features/schedule/domain/day-availability.d.ts

@@ -0,0 +1,9 @@
+import type { WeekdayId } from './weekday';
+export interface DayAvailability {
+    readonly active: boolean;
+    readonly from: string;
+    readonly to: string;
+}
+/** A full Mon–Sun working-hours table. One entry per weekday, never partial. */
+export type WeeklyAvailability = Readonly<Record<WeekdayId, DayAvailability>>;
+//# sourceMappingURL=day-availability.d.ts.map

package/types/features/schedule/domain/day-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-availability.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/day-availability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC"}

package/types/features/schedule/domain/effective-availability.d.ts

@@ -0,0 +1,34 @@
+import { type WeekdayId } from '@core/domain';
+import type { DayAvailability, WeeklyAvailability } from './day-availability';
+/** Out-of-the-box weekly availability: Mon–Fri 09:00–17:00, weekend closed. */
+export declare const DEFAULT_WEEKLY_AVAILABILITY: WeeklyAvailability;
+/** Monday-first weekday id (`mon`…`sun`) for a local `Date`. */
+export declare const weekdayIdOf: (date: Date) => WeekdayId;
+/**
+ * The effective weekly working hours for the host: their personal override if set, else the
+ * branch/org default, else the built-in default. This is the single Calendly-style source of truth —
+ * the availability editor and the booking slot engine both resolve hours through here, so a change in
+ * one is reflected in the other. `branchDefault` is the settings feature's `WeeklyHours`, which is
+ * structurally a `WeeklyAvailability` (same per-weekday `{ active, from, to }` shape).
+ */
+export declare const resolveEffectiveAvailability: (personal: WeeklyAvailability | null, branchDefault: WeeklyAvailability | null) => WeeklyAvailability;
+/** Where the effective table came from in the fallback chain (backend-resolved). */
+export type EffectiveAvailabilitySource = 'personal' | 'branch' | 'org' | 'default';
+/**
+ * The hours that actually apply to a user after the fallback chain, plus whether the value is the user's
+ * own override. Resolved server-side (see the backend `GetEffectiveAvailability`) so the Working Hours
+ * screen and the booking slot engine share one source of truth.
+ */
+export interface EffectiveAvailability {
+    readonly weekly: WeeklyAvailability;
+    readonly isOverride: boolean;
+    readonly source: EffectiveAvailabilitySource;
+}
+/**
+ * Build an {@link EffectiveAvailability} from a personal table alone (override → the built-in default).
+ * The real gateway resolves branch/org tiers server-side; the mock/fake gateways use this simpler form.
+ */
+export declare const effectiveFromPersonal: (personal: WeeklyAvailability | null) => EffectiveAvailability;
+/** The availability window that governs a specific date — its weekday's row in the table. */
+export declare const availabilityForDate: (availability: WeeklyAvailability, date: Date) => DayAvailability;
+//# sourceMappingURL=effective-availability.d.ts.map

package/types/features/schedule/domain/effective-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-availability.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/effective-availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,EAAE,kBAQzC,CAAC;AAKF,gEAAgE;AAChE,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,KAAG,SACM,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,kBAAkB,GAAG,IAAI,EACnC,eAAe,kBAAkB,GAAG,IAAI,KACvC,kBAA8E,CAAC;AAElF,oFAAoF;AACpF,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,kBAAkB,GAAG,IAAI,KAClC,qBAID,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,GAC9B,cAAc,kBAAkB,EAChC,MAAM,IAAI,KACT,eAAkD,CAAC"}

package/types/features/schedule/domain/errors/schedule-errors.d.ts

@@ -0,0 +1,25 @@
+import { DomainError } from '@core/errors';
+/** Base type for every schedule-domain failure. */
+export declare abstract class ScheduleError extends DomainError {
+}
+/** The schedule service could not be reached or returned an unexpected response. */
+export declare class ScheduleUnavailableError extends ScheduleError {
+    readonly code = "SCHEDULE_UNAVAILABLE";
+    constructor(cause?: unknown);
+}
+/** An active day was saved with an end time at or before its start time. */
+export declare class InvalidAvailabilityError extends ScheduleError {
+    readonly code = "SCHEDULE_INVALID_AVAILABILITY";
+    constructor();
+}
+/** A schedule block was created/updated with missing title or an end at/before its start. */
+export declare class InvalidScheduleBlockError extends ScheduleError {
+    readonly code = "SCHEDULE_INVALID_BLOCK";
+    constructor(message?: string);
+}
+/** A block referenced by id does not exist (e.g. edited/deleted concurrently). */
+export declare class ScheduleBlockNotFoundError extends ScheduleError {
+    readonly code = "SCHEDULE_BLOCK_NOT_FOUND";
+    constructor();
+}
+//# sourceMappingURL=schedule-errors.d.ts.map

package/types/features/schedule/domain/errors/schedule-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-errors.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/schedule/domain/errors/schedule-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,mDAAmD;AACnD,8BAAsB,aAAc,SAAQ,WAAW;CAAG;AAE1D,oFAAoF;AACpF,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,SAAgB,IAAI,0BAA0B;gBAE3B,KAAK,CAAC,EAAE,OAAO;CAGnC;AAED,4EAA4E;AAC5E,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,SAAgB,IAAI,mCAAmC;;CAKxD;AAED,6FAA6F;AAC7F,qBAAa,yBAA0B,SAAQ,aAAa;IAC1D,SAAgB,IAAI,4BAA4B;gBAG9C,OAAO,SAA4D;CAItE;AAED,kFAAkF;AAClF,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,SAAgB,IAAI,8BAA8B;;CAKnD"}

package/types/features/schedule/domain/index.d.ts

@@ -0,0 +1,15 @@
+export * from './errors/schedule-errors';
+export * from './datetime';
+export * from './day-availability';
+export * from './effective-availability';
+export * from './recurrence';
+export * from './schedule-block';
+export * from './schedule-preferences';
+export * from './schedule-status';
+export * from './schedule-summary';
+export * from './schedule-week';
+export * from './time-range';
+export * from './weekday';
+export type { ScheduleGateway } from './ports/schedule-gateway';
+export type { CalendarSink, CalendarMeetingBlock } from './ports/calendar-sink';
+//# sourceMappingURL=index.d.ts.map

package/types/features/schedule/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/types/features/schedule/domain/ports/calendar-sink.d.ts

@@ -0,0 +1,16 @@
+/** A meeting block to be written into the calendar by an external feature (e.g. meetings). */
+export interface CalendarMeetingBlock {
+    readonly userId: string;
+    readonly title: string;
+    readonly start: string;
+    readonly end: string;
+    readonly notes: string;
+}
+/**
+ * Narrow write capability the schedule exposes so another feature can drop meeting blocks onto
+ * the calendar without reaching into schedule internals. The schedule gateway implements it.
+ */
+export interface CalendarSink {
+    addMeetingBlocks(blocks: readonly CalendarMeetingBlock[]): void;
+}
+//# sourceMappingURL=calendar-sink.d.ts.map

package/types/features/schedule/domain/ports/calendar-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-sink.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/schedule/domain/ports/calendar-sink.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAAC;CACjE"}

package/types/features/schedule/domain/ports/schedule-gateway.d.ts

@@ -0,0 +1,20 @@
+import type { Result } from '@core/result';
+import type { WeeklyAvailability } from '../day-availability';
+import type { EffectiveAvailability } from '../effective-availability';
+import type { ScheduleError } from '../errors/schedule-errors';
+import type { ScheduleBlock, ScheduleBlockDraft } from '../schedule-block';
+import type { SchedulePreferences } from '../schedule-preferences';
+/** Port to the schedule service, implemented over the ABP HTTP gateway (+ mock/fake for tests). */
+export interface ScheduleGateway {
+    getAvailability(): Promise<Result<WeeklyAvailability | null, ScheduleError>>;
+    /** The hours that actually apply after the personal → branch → org → default fallback (server-resolved). */
+    getEffectiveAvailability(): Promise<Result<EffectiveAvailability, ScheduleError>>;
+    saveAvailability(availability: WeeklyAvailability | null): Promise<Result<WeeklyAvailability | null, ScheduleError>>;
+    listBlocks(): Promise<Result<readonly ScheduleBlock[], ScheduleError>>;
+    createBlock(draft: ScheduleBlockDraft): Promise<Result<ScheduleBlock, ScheduleError>>;
+    updateBlock(id: string, draft: ScheduleBlockDraft): Promise<Result<ScheduleBlock, ScheduleError>>;
+    deleteBlock(id: string): Promise<Result<void, ScheduleError>>;
+    getPreferences(): Promise<Result<SchedulePreferences, ScheduleError>>;
+    savePreferences(preferences: SchedulePreferences): Promise<Result<SchedulePreferences, ScheduleError>>;
+}
+//# sourceMappingURL=schedule-gateway.d.ts.map

package/types/features/schedule/domain/ports/schedule-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/schedule/domain/ports/schedule-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,kBAAkB,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7E,4GAA4G;IAC5G,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAAC,CAAC;IAClF,gBAAgB,CACd,YAAY,EAAE,kBAAkB,GAAG,IAAI,GACtC,OAAO,CAAC,MAAM,CAAC,kBAAkB,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACvE,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IACtF,WAAW,CACT,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC,CAAC;IACtE,eAAe,CACb,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC,CAAC;CACxD"}

package/types/features/schedule/domain/recurrence-calc.d.ts

@@ -0,0 +1,13 @@
+import { type Recurrence } from './recurrence';
+export declare const CAP = 1500;
+export declare const lastDayOfMonth: (year: number, month: number) => number;
+/** Which nth weekday a date is within its month (1–4, or 5 = last). */
+export declare const nthOfMonth: (date: Date) => number;
+export declare const nthWeekdayDate: (year: number, month: number, nth: number, weekday: number) => Date | null;
+export declare const dayStart: (date: Date) => Date;
+export declare const dailyDays: (base: Date, interval: number, until: Date) => Date[];
+export declare const weeklyDays: (base: Date, rec: Recurrence, until: Date) => Date[];
+export declare const monthlyAnchor: (base: Date, rec: Recurrence, year: number, month: number) => Date | null;
+export declare const monthlyDays: (base: Date, rec: Recurrence, until: Date, yearly: boolean) => Date[];
+export declare const candidateDays: (base: Date, rec: Recurrence, until: Date) => Date[];
+//# sourceMappingURL=recurrence-calc.d.ts.map

package/types/features/schedule/domain/recurrence-calc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurrence-calc.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/recurrence-calc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,GAAG,OAAO,CAAC;AAExB,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MACrB,CAAC;AAEzC,uEAAuE;AACvE,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,MACI,CAAC;AAE7C,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,KAAK,MAAM,EACX,SAAS,MAAM,KACd,IAAI,GAAG,IAST,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,IACyB,CAAC;AAEhE,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,EAAE,UAAU,MAAM,EAAE,OAAO,IAAI,KAAG,IAAI,EASzE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,EAAE,KAAK,UAAU,EAAE,OAAO,IAAI,KAAG,IAAI,EAmBzE,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,IAAI,EACV,KAAK,UAAU,EACf,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ,IAAI,GAAG,IAKT,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,MAAM,IAAI,EACV,KAAK,UAAU,EACf,OAAO,IAAI,EACX,QAAQ,OAAO,KACd,IAAI,EAaN,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,EAAE,KAAK,UAAU,EAAE,OAAO,IAAI,KAAG,IAAI,EAW5E,CAAC"}

package/types/features/schedule/domain/recurrence.d.ts

@@ -0,0 +1,65 @@
+export type RecurrenceFreq = 'daily' | 'weekly' | 'monthly' | 'yearly';
+export type MonthlyMode = 'dayOfMonth' | 'nthWeekday';
+export type RecurrenceEndType = 'never' | 'after' | 'on';
+/** A recurrence rule. The concrete day/weekday come from the block's `start`, Teams-style. */
+export interface Recurrence {
+    readonly freq: RecurrenceFreq;
+    /** Repeat every N units (≥ 1). */
+    readonly interval: number;
+    /** Selected weekdays (0=Sun … 6=Sat) for weekly/bi-weekly. */
+    readonly weekdays: readonly number[];
+    /** Monthly/yearly: anchor by calendar day, or by the start's nth-weekday. */
+    readonly monthlyMode: MonthlyMode;
+    readonly endType: RecurrenceEndType;
+    /** Number of occurrences when `endType` is `after`. */
+    readonly endCount: number;
+    /** `YYYY-MM-DD` (or '') when `endType` is `on`. */
+    readonly endDate: string;
+    /** `YYYY-MM-DD` dates removed from the series (skipped occurrences). */
+    readonly exceptions: readonly string[];
+    readonly differentTimes?: boolean;
+    readonly weekdayTimes?: Record<number, readonly {
+        readonly start: string;
+        readonly end: string;
+    }[]>;
+}
+export declare const RECURRENCE_FREQUENCIES: readonly {
+    readonly id: RecurrenceFreq;
+    readonly label: string;
+}[];
+/** Type guard to check if a string is a valid RecurrenceFreq. */
+export declare const isValidRecurrenceFreq: (freq: string) => freq is RecurrenceFreq;
+/** Get human readable label for a RecurrenceFreq. */
+export declare const recurrenceFreqLabel: (freq: RecurrenceFreq) => string;
+/** A sensible default rule for a brand-new recurring block: weekly on the start's weekday. */
+export declare const defaultRecurrence: (startIso: string) => Recurrence;
+export interface OccurrenceTimes {
+    readonly start: string;
+    readonly end: string;
+}
+export declare const occurrencesInRange: (block: {
+    readonly start: string;
+    readonly end: string;
+    readonly recurrence: Recurrence | null;
+}, rangeStart: Date, rangeEnd: Date) => OccurrenceTimes[];
+/**
+ * Occurrences of `block` whose [start, end] interval OVERLAPS [rangeStart, rangeEnd] — unlike
+ * {@link occurrencesInRange}, which keeps an occurrence only when its START lands in the range. This is what
+ * lets the calendar render an event that BEGAN before the visible range but spills into it (drawn as a
+ * continued-from-previous segment). The underlying query is widened by the block's own duration so a
+ * just-before spill-in occurrence is generated, then the results are filtered to those that genuinely
+ * overlap. `occurrencesInRange` is deliberately left as-is so booking/availability keep their existing
+ * start-based semantics.
+ *
+ * <p>The overlap predicate `occStart ≤ rangeEnd && occEnd > rangeStart` is a strict superset of the
+ * start-based inclusion (`rangeStart ≤ occStart ≤ rangeEnd`), so every occurrence the old expansion emitted
+ * is still emitted — only genuine spill-ins are added.</p>
+ */
+export declare const occurrencesOverlappingRange: (block: {
+    readonly start: string;
+    readonly end: string;
+    readonly recurrence: Recurrence | null;
+}, rangeStart: Date, rangeEnd: Date) => OccurrenceTimes[];
+/** Human-readable summary, e.g. "Weekly on Mon, Wed · until 31 Dec 2026". */
+export declare const recurrenceSummary: (rec: Recurrence, startIso: string) => string;
+//# sourceMappingURL=recurrence.d.ts.map

package/types/features/schedule/domain/recurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurrence.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/recurrence.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AACtD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAC5B,MAAM,EACN,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAC5D,CAAC;CACH;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS;IAC5C,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,EAKA,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,cACJ,CAAC;AAE1D,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,GAAI,MAAM,cAAc,KAAG,MACa,CAAC;AAKzE,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,UASnD,CAAC;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAwKD,eAAO,MAAM,kBAAkB,GAC7B,OAAO;IACL,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC,EACD,YAAY,IAAI,EAChB,UAAU,IAAI,KACb,eAAe,EASjB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO;IACL,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC,EACD,YAAY,IAAI,EAChB,UAAU,IAAI,KACb,eAAe,EAajB,CAAC;AAqCF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,GAAI,KAAK,UAAU,EAAE,UAAU,MAAM,KAAG,MAMrE,CAAC"}

package/types/features/schedule/domain/schedule-block.d.ts

@@ -0,0 +1,53 @@
+import { type Result } from '@core/result';
+import { type ScheduleError } from './errors/schedule-errors';
+import type { Recurrence } from './recurrence';
+import type { ScheduleStatus } from './schedule-status';
+export interface ScheduleBlockProps {
+    readonly id: string;
+    readonly userId?: string | undefined;
+    readonly title: string;
+    readonly status: ScheduleStatus;
+    /** ISO datetime the block starts (also the series anchor when recurring). */
+    readonly start: string;
+    /** ISO datetime the block ends (for all-day this is 23:59 on the same date). */
+    readonly end: string;
+    readonly allDay: boolean;
+    readonly notes: string;
+    /** The recurrence rule, or `null` for a one-off block. */
+    readonly recurrence: Recurrence | null;
+}
+/** The fields a user supplies for a block — the `id` is assigned by the gateway on create. */
+export type ScheduleBlockDraft = Omit<ScheduleBlockProps, 'id'>;
+/** A single status block on the schedule. Immutable; lives at a real point in time. */
+export declare class ScheduleBlock {
+    readonly id: string;
+    readonly userId?: string | undefined;
+    readonly title: string;
+    readonly status: ScheduleStatus;
+    readonly start: string;
+    readonly end: string;
+    readonly allDay: boolean;
+    readonly notes: string;
+    readonly recurrence: Recurrence | null;
+    constructor(props: ScheduleBlockProps);
+    /** Length of the block in minutes. */
+    get durationMinutes(): number;
+    get isRecurring(): boolean;
+    get hasNotes(): boolean;
+}
+/**
+ * Corruption-guard caps on how long a single block may span (mirror the backend `ScheduleConsts`). An
+ * all-day block is 00:00–23:59 (≈24h, up to ~25h across a fall-back DST day), so it gets 26h of slack; a
+ * TIMED block is a single-day event (genuine multi-day ranges become a recurrence), so it must stay under a
+ * day — anything spanning a full day is a cross-day corruption (the ~25h "12:00–13:00 that crossed midnight"
+ * bug).
+ */
+export declare const MAX_BLOCK_DURATION_HOURS = 26;
+export declare const MAX_TIMED_BLOCK_DURATION_HOURS = 24;
+/**
+ * Domain invariant for a block: it must carry a title, end strictly after it starts, and — as a corruption
+ * guard — stay within its per-kind duration cap (a timed block under a day; an all-day block within DST
+ * slack). Returns the normalised draft (trimmed title) so the rule lives here, not in a use case/component.
+ */
+export declare const validateBlockDraft: (draft: ScheduleBlockDraft) => Result<ScheduleBlockDraft, ScheduleError>;
+//# sourceMappingURL=schedule-block.d.ts.map

package/types/features/schedule/domain/schedule-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-block.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/schedule-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AAEpD,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC;AAED,8FAA8F;AAC9F,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAEhE,uFAAuF;AACvF,qBAAa,aAAa;IACxB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,cAAc,CAAC;IACvC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,OAAO,CAAC;IAChC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;gBAE3B,KAAK,EAAE,kBAAkB;IAY5C,sCAAsC;IACtC,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,kBAAkB,KACxB,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAmB1C,CAAC"}

package/types/features/schedule/domain/schedule-preferences.d.ts

@@ -0,0 +1,18 @@
+export interface SchedulePreferences {
+    /** Default meeting length offered to bookers, in minutes. */
+    readonly meetingDuration: number;
+    /** Gap auto-reserved on either side of a meeting, in minutes. */
+    readonly bufferMinutes: number;
+    readonly workStart: string;
+    readonly workEnd: string;
+    /** The user's PERSONAL (home/working) timezone (empty = none). */
+    readonly timezone: string;
+    readonly branchId: string;
+    /** Server-computed IANA zone the user's availability is anchored to, and the client's display default
+     *  below any explicit pick/personal zone (personal → branch → tenant-default-branch → "UTC"). Read-only. */
+    readonly availabilityTimezone: string;
+}
+export declare const MEETING_DURATIONS: readonly number[];
+export declare const BUFFER_OPTIONS: readonly number[];
+export declare const TIMEZONES: readonly string[];
+//# sourceMappingURL=schedule-preferences.d.ts.map

package/types/features/schedule/domain/schedule-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-preferences.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/schedule-preferences.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;gHAC4G;IAC5G,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAqB,CAAC;AAErE,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAmB,CAAC;AAEhE,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAOtC,CAAC"}

package/types/features/schedule/domain/schedule-status.d.ts

@@ -0,0 +1,12 @@
+export type ScheduleStatus = 'available' | 'busy' | 'meeting' | 'focus' | 'away';
+export interface ScheduleStatusMeta {
+    readonly id: ScheduleStatus;
+    readonly label: string;
+}
+/** The five block statuses, in the order the legend renders them. */
+export declare const SCHEDULE_STATUSES: readonly ScheduleStatusMeta[];
+/** Type guard to check if a string is a valid ScheduleStatus. */
+export declare const isValidScheduleStatus: (status: string) => status is ScheduleStatus;
+/** Get the human-readable label for a ScheduleStatus. */
+export declare const scheduleStatusLabel: (status: ScheduleStatus) => string;
+//# sourceMappingURL=schedule-status.d.ts.map

package/types/features/schedule/domain/schedule-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-status.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/schedule-status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAE,SAAS,kBAAkB,EAM1D,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,cACX,CAAC;AAEvD,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MACU,CAAC"}

package/types/features/schedule/domain/schedule-summary.d.ts

@@ -0,0 +1,13 @@
+import type { ScheduleOccurrence } from './schedule-week';
+export interface DaySummary {
+    readonly busyHours: number;
+    readonly meetingCount: number;
+    readonly focusHours: number;
+}
+/**
+ * Pure domain service: roll ONE day's occurrences up into the sidebar's at-a-glance figures — busy hours,
+ * meeting count, and focus hours for that day. "Free" is computed separately (work window − commitments);
+ * an `available` block is open time and never appears here.
+ */
+export declare const summarizeToday: (occurrences: readonly ScheduleOccurrence[], today: Date) => DaySummary;
+//# sourceMappingURL=schedule-summary.d.ts.map

package/types/features/schedule/domain/schedule-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-summary.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/schedule-summary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAgBD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,SAAS,kBAAkB,EAAE,EAC1C,OAAO,IAAI,KACV,UAUF,CAAC"}

package/types/features/schedule/domain/schedule-week.d.ts

@@ -0,0 +1,30 @@
+import type { ScheduleBlock } from './schedule-block';
+/** A concrete placement of a block within a visible week. */
+export interface ScheduleOccurrence {
+    readonly key: string;
+    readonly block: ScheduleBlock;
+    /** 0 = Monday … 6 = Sunday — the column within the visible week. */
+    readonly dayIndex: number;
+    /** Local `YYYY-MM-DD` of this occurrence. */
+    readonly date: string;
+    /** The concrete ISO start/end of THIS day's segment (clipped to the day when the block crosses midnight). */
+    readonly start: string;
+    readonly end: string;
+    /** Set when this segment is the tail of a timed block that began on a previous day (crossed midnight). */
+    readonly continuesFromPrevDay?: boolean;
+    /** Set when this segment is the head/middle of a timed block that runs past midnight into the next day. */
+    readonly continuesToNextDay?: boolean;
+}
+/**
+ * Project the schedule's blocks onto a visible week via the recurrence engine. Each block yields the
+ * concrete occurrences whose start falls inside the week. `weekDates` must be the seven `Date`s
+ * (Mon…Sun) of the visible week, in order.
+ */
+/**
+ * Project blocks onto an arbitrary date range (inclusive of both end days), via the recurrence
+ * engine. Used for the week grid (7 days) and the month grid (42 days). `dayIndex` is the
+ * Monday-first weekday (column within a week); month views bucket by `date` instead.
+ */
+export declare const expandRange: (rangeStartDate: Date, rangeEndDate: Date, blocks: readonly ScheduleBlock[]) => readonly ScheduleOccurrence[];
+export declare const expandWeek: (blocks: readonly ScheduleBlock[], weekDates: readonly Date[]) => readonly ScheduleOccurrence[];
+//# sourceMappingURL=schedule-week.d.ts.map

package/types/features/schedule/domain/schedule-week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-week.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/schedule-week.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0GAA0G;IAC1G,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,2GAA2G;IAC3G,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAuFD;;;;GAIG;AACH;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,gBAAgB,IAAI,EACpB,cAAc,IAAI,EAClB,QAAQ,SAAS,aAAa,EAAE,KAC/B,SAAS,kBAAkB,EAqC7B,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,QAAQ,SAAS,aAAa,EAAE,EAChC,WAAW,SAAS,IAAI,EAAE,KACzB,SAAS,kBAAkB,EAO7B,CAAC"}

package/types/features/schedule/domain/time-range.d.ts

@@ -0,0 +1,3 @@
+/** Minutes since midnight for a `HH:MM` 24-hour time string. */
+export declare const toMinutes: (time: string) => number;
+//# sourceMappingURL=time-range.d.ts.map

package/types/features/schedule/domain/time-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/time-range.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAGxC,CAAC"}

package/types/features/schedule/domain/weekday.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Weekday identity & metadata now live in the shared domain kernel (`@core/domain`), since both
+ * the schedule and settings features need them. Re-exported here so existing schedule imports
+ * (`@features/schedule` / `../domain`) keep resolving unchanged.
+ */
+export { WEEKDAYS } from '@core/domain';
+export type { WeekdayId, WeekdayMeta } from '@core/domain';
+//# sourceMappingURL=weekday.d.ts.map

package/types/features/schedule/domain/weekday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekday.d.ts","sourceRoot":"","sources":["../../../../../../src/features/schedule/domain/weekday.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/types/features/schedule/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public API of the `schedule` feature. Other features and the app shell import ONLY from here.
+ */
+export { createScheduleModule, type ScheduleModule, type ScheduleModuleDeps, } from './schedule-module';
+export { ScheduleModuleProvider, useScheduleBlocks, usePreferences, useSavePreferences, useAvailability, useViewerTimeZone, } from './presentation';
+export type { ScheduleBlock, ScheduleStatus, SchedulePreferences, WeeklyAvailability, DayAvailability, Recurrence, CalendarSink, CalendarMeetingBlock, } from './domain';
+export { occurrencesInRange, defaultRecurrence, expandWeek, resolveEffectiveAvailability, availabilityForDate, weekdayIdOf, DEFAULT_WEEKLY_AVAILABILITY, TIMEZONES, } from './domain';
+//# sourceMappingURL=index.d.ts.map

package/types/features/schedule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/schedule/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,WAAW,EACX,2BAA2B,EAC3B,SAAS,GACV,MAAM,UAAU,CAAC"}