uapp-communication-sdk 1.0.0-dev.54

package/types/core/domain/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared domain kernel: framework-agnostic value objects (and their errors) used by MORE THAN ONE
+ * feature. Importable from anywhere as `@core/domain`.
+ *
+ * A type belongs here only once a *second* feature needs it — until then it lives in that feature's
+ * own `domain/`. Everything here depends solely on `@core/result` and `@core/errors`; it must never
+ * reach for HTTP, DI, React, or any feature.
+ */
+export { Email } from './value-objects/email';
+export { WEEKDAYS } from './value-objects/weekday';
+export type { WeekdayId, WeekdayMeta } from './value-objects/weekday';
+export { TimeOfDay } from './value-objects/time-of-day';
+export { TimeRange } from './value-objects/time-range';
+export { InvalidEmailError } from './errors/invalid-email-error';
+export { InvalidTimeError } from './errors/invalid-time-error';
+//# sourceMappingURL=index.d.ts.map

package/types/core/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/domain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/types/core/domain/value-objects/email.d.ts

@@ -0,0 +1,18 @@
+import { type Result } from '@core/result';
+import { InvalidEmailError } from '../errors/invalid-email-error';
+/**
+ * Email value object. Immutable and self-validating: once you hold an `Email`, it is guaranteed
+ * well-formed. Construct it through `Email.create` (which returns a `Result`) — the constructor is
+ * private so an invalid `Email` cannot exist anywhere in the system.
+ *
+ * Part of the shared domain kernel (`@core/domain`): reusable by any feature that handles email
+ * addresses, with no dependency on a feature.
+ */
+export declare class Email {
+    readonly value: string;
+    private constructor();
+    static create(raw: string): Result<Email, InvalidEmailError>;
+    equals(other: Email): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=email.d.ts.map

package/types/core/domain/value-objects/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../../../../src/core/domain/value-objects/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAKlE;;;;;;;GAOG;AACH,qBAAa,KAAK;aACoB,KAAK,EAAE,MAAM;IAAjD,OAAO;WAEO,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAQ5D,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAI7B,QAAQ,IAAI,MAAM;CAG1B"}

package/types/core/domain/value-objects/time-of-day.d.ts

@@ -0,0 +1,24 @@
+import { type Result } from '@core/result';
+import { InvalidTimeError } from '../errors/invalid-time-error';
+/**
+ * TimeOfDay value object: an immutable, self-validating 24-hour "HH:MM" clock time. Once you hold a
+ * `TimeOfDay`, it is guaranteed well-formed (00:00–23:59). Construct it through `TimeOfDay.create`
+ * (which returns a `Result`) — the constructor is private so an invalid time cannot exist.
+ *
+ * Part of the shared domain kernel (`@core/domain`): reusable by any feature that handles times of
+ * day (schedule working hours, org work hours, …), with no dependency on a feature.
+ */
+export declare class TimeOfDay {
+    private readonly minutes;
+    private readonly normalized;
+    private constructor();
+    static create(raw: string): Result<TimeOfDay, InvalidTimeError>;
+    get minutesSinceMidnight(): number;
+    /** Normalised "HH:MM" string, zero-padded. */
+    get value(): string;
+    equals(other: TimeOfDay): boolean;
+    isBefore(other: TimeOfDay): boolean;
+    isAfter(other: TimeOfDay): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=time-of-day.d.ts.map

package/types/core/domain/value-objects/time-of-day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-of-day.d.ts","sourceRoot":"","sources":["../../../../../../src/core/domain/value-objects/time-of-day.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAOhE;;;;;;;GAOG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAF7B,OAAO;WAKO,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAYtE,IAAW,oBAAoB,IAAI,MAAM,CAExC;IAED,8CAA8C;IAC9C,IAAW,KAAK,IAAI,MAAM,CAEzB;IAEM,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIjC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAInC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIlC,QAAQ,IAAI,MAAM;CAG1B"}

package/types/core/domain/value-objects/time-range.d.ts

@@ -0,0 +1,22 @@
+import { type Result } from '@core/result';
+import { InvalidTimeError } from '../errors/invalid-time-error';
+import { TimeOfDay } from './time-of-day';
+/**
+ * TimeRange value object: an immutable span between two `TimeOfDay`s that owns the invariant
+ * "ends strictly after it starts". Construct it through `TimeRange.create` (which returns a
+ * `Result`) — the constructor is private so an invalid range cannot exist.
+ *
+ * Part of the shared domain kernel (`@core/domain`): reusable by any feature that validates a
+ * `from`→`to` window (schedule working hours, …), with no dependency on a feature.
+ */
+export declare class TimeRange {
+    private readonly start;
+    private readonly end;
+    private constructor();
+    static create(from: string, to: string): Result<TimeRange, InvalidTimeError>;
+    get from(): TimeOfDay;
+    get to(): TimeOfDay;
+    /** Length of the range, in minutes. */
+    get minutes(): number;
+}
+//# sourceMappingURL=time-range.d.ts.map

package/types/core/domain/value-objects/time-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.d.ts","sourceRoot":"","sources":["../../../../../../src/core/domain/value-objects/time-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFtB,OAAO;WAKO,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAenF,IAAW,IAAI,IAAI,SAAS,CAE3B;IAED,IAAW,EAAE,IAAI,SAAS,CAEzB;IAED,uCAAuC;IACvC,IAAW,OAAO,IAAI,MAAM,CAE3B;CACF"}

package/types/core/domain/value-objects/weekday.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Weekday identity & metadata, shared by every feature that renders a Monday-first week
+ * (schedule working hours, org work-hours editor, …).
+ *
+ * Part of the shared domain kernel (`@core/domain`): a plain, framework-free description of the
+ * seven days, with no dependency on any feature.
+ */
+export type WeekdayId = 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun';
+export interface WeekdayMeta {
+    readonly id: WeekdayId;
+    readonly short: string;
+    readonly long: string;
+}
+/** Monday-first week, matching the prototype's working-hours table. */
+export declare const WEEKDAYS: readonly WeekdayMeta[];
+//# sourceMappingURL=weekday.d.ts.map

package/types/core/domain/value-objects/weekday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekday.d.ts","sourceRoot":"","sources":["../../../../../../src/core/domain/value-objects/weekday.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,uEAAuE;AACvE,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAQ1C,CAAC"}

package/types/core/errors/app-error.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Root of the application error hierarchy.
+ *
+ * Every error we *intend* to throw or surface derives from this. That gives us a single,
+ * type-safe place to attach a stable machine-readable `code`, structured `context`, and a
+ * `cause` chain — instead of throwing bare strings or untyped `Error`s.
+ *
+ * Rules:
+ *  - Never `throw new Error('...')`. Throw a concrete subclass.
+ *  - Never swallow errors. Wrap them with `cause` so the chain is preserved.
+ */
+export declare abstract class AppError extends Error {
+    /** Stable, machine-readable identifier (e.g. `HTTP`, `CONFIG_INVALID`). */
+    abstract readonly code: string;
+    /** Optional structured data for logging/telemetry. Never put secrets here. */
+    readonly context?: Readonly<Record<string, unknown>>;
+    constructor(message: string, options?: {
+        readonly cause?: unknown;
+        readonly context?: Record<string, unknown>;
+    });
+}
+/** Configuration could not be loaded or validated. Thrown only at startup (fail fast). */
+export declare class ConfigError extends AppError {
+    readonly code = "CONFIG_INVALID";
+}
+/** An unexpected, non-recoverable error. Use when no more specific type applies. */
+export declare class UnexpectedError extends AppError {
+    readonly code = "UNEXPECTED";
+    static from(cause: unknown): UnexpectedError;
+}
+/**
+ * Base class for *domain* rule violations. Feature domains extend this so business errors
+ * are distinguishable from infrastructure failures and can be mapped to friendly messages.
+ */
+export declare abstract class DomainError extends AppError {
+}
+//# sourceMappingURL=app-error.d.ts.map

package/types/core/errors/app-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/app-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,2EAA2E;IAC3E,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,8EAA8E;IAC9E,SAAgB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBAG1D,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAgBrF;AAED,0FAA0F;AAC1F,qBAAa,WAAY,SAAQ,QAAQ;IACvC,SAAgB,IAAI,oBAAoB;CACzC;AAED,oFAAoF;AACpF,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAgB,IAAI,gBAAgB;WAEtB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe;CAQpD;AAED;;;GAGG;AACH,8BAAsB,WAAY,SAAQ,QAAQ;CAAG"}

package/types/core/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app-error';
+//# sourceMappingURL=index.d.ts.map

package/types/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/types/core/http/auth-refresh-http-client.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from '@core/logger/logger';
+import { type HttpClient, type RequestOptions } from '@core/http/http-client';
+export interface AuthRefreshHttpClientDeps {
+    /** Attempt to obtain a fresh token. Returns `true` if one is now available. */
+    readonly refresh: () => Promise<boolean>;
+    readonly logger: Logger;
+}
+/**
+ * Decorator that transparently recovers from an expired access token. On a `401` it triggers a
+ * single token refresh and replays the request exactly once. Concurrent `401`s share one in-flight
+ * refresh (single-flight), and anonymous requests (e.g. the token endpoint itself) are never
+ * refreshed — both guard against refresh storms and infinite recursion. `refresh` is injected, so
+ * core stays free of any feature dependency.
+ */
+export declare class AuthRefreshHttpClient implements HttpClient {
+    private readonly inner;
+    private readonly refresh;
+    private readonly logger;
+    private inFlightRefresh;
+    constructor(inner: HttpClient, deps: AuthRefreshHttpClientDeps);
+    get<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    getBlob(path: string, options?: RequestOptions): Promise<Blob>;
+    post<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    postForm<TResponse>(path: string, form: Readonly<Record<string, string>>, options?: RequestOptions): Promise<TResponse>;
+    private withRefresh;
+    private refreshOnce;
+    private runRefresh;
+}
+//# sourceMappingURL=auth-refresh-http-client.d.ts.map

package/types/core/http/auth-refresh-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh-http-client.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/auth-refresh-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAa,MAAM,wBAAwB,CAAC;AAEzF,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,UAAU;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,eAAe,CAAiC;gBAErC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,yBAAyB;IAM9D,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,IAAI,CAAC,SAAS,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,GAAG,CAAC,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,KAAK,CAAC,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7E,QAAQ,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;YAOP,WAAW;IAwBzB,OAAO,CAAC,WAAW;YAKL,UAAU;CAYzB"}

package/types/core/http/fetch-http-client.d.ts

@@ -0,0 +1,40 @@
+import type { Logger } from '@core/logger/logger';
+import { type HttpClient, type RequestOptions } from '@core/http/http-client';
+/** Supplies the current bearer token, or `undefined` when anonymous. */
+export type AuthTokenProvider = () => string | undefined;
+export interface FetchHttpClientDeps {
+    readonly baseUrl: string;
+    readonly logger: Logger;
+    readonly getAuthToken: AuthTokenProvider;
+}
+/**
+ * `fetch`-based `HttpClient`. The only place in the app that talks to the network directly.
+ * It is intentionally small and dependency-light; cross-cutting concerns (auth header, logging,
+ * error translation) are handled here once.
+ */
+export declare class FetchHttpClient implements HttpClient {
+    private readonly baseUrl;
+    private readonly logger;
+    private readonly getAuthToken;
+    constructor(deps: FetchHttpClientDeps);
+    get<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    getBlob(path: string, options?: RequestOptions): Promise<Blob>;
+    post<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    postForm<TResponse>(path: string, form: Readonly<Record<string, string>>, options?: RequestOptions): Promise<TResponse>;
+    private jsonBody;
+    private send;
+    private handleResponse;
+    /**
+     * Translate a `Retry-After` header into milliseconds. Supports both forms from RFC 7231:
+     * a numeric delay in seconds, or an HTTP-date. Anything missing or unparseable yields `null`.
+     */
+    private parseRetryAfter;
+    private readBody;
+    private buildHeaders;
+    private buildUrl;
+    private appendQuery;
+}
+//# sourceMappingURL=fetch-http-client.d.ts.map

package/types/core/http/fetch-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-http-client.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/fetch-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,cAAc,EAGpB,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAE9B,IAAI,EAAE,mBAAmB;IAMrC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAIpE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCpE,IAAI,CAAC,SAAS,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,GAAG,CAAC,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,KAAK,CAAC,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7E,QAAQ,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAUrB,OAAO,CAAC,QAAQ;YAUF,IAAI;YAkCJ,cAAc;IAwB5B;;;OAGG;IACH,OAAO,CAAC,eAAe;YAiBT,QAAQ;IAqBtB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;CAapB"}

package/types/core/http/http-client.d.ts

@@ -0,0 +1,62 @@
+import { AppError } from '@core/errors/app-error';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type QueryValue = string | number | boolean | readonly string[] | readonly number[] | undefined;
+export interface RequestOptions {
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly query?: Readonly<Record<string, QueryValue>>;
+    readonly signal?: AbortSignal;
+    /** Skip attaching the bearer token (e.g. the token endpoint itself). */
+    readonly anonymous?: boolean;
+}
+/**
+ * Transport abstraction. Higher layers depend on this interface — never on `fetch`/`axios` —
+ * so the network implementation is swappable and trivially mockable in tests.
+ *
+ * Implementations THROW `HttpError`/`NetworkError`. Repositories (infrastructure) are responsible
+ * for catching these and translating them into domain `Result`s.
+ */
+export interface HttpClient {
+    get<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * GET a binary resource as a `Blob` (with the bearer token attached, unlike a plain `<img src>`).
+     * Used for authenticated media/file downloads that must not go through JSON parsing.
+     */
+    getBlob(path: string, options?: RequestOptions): Promise<Blob>;
+    post<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    /** Send `application/x-www-form-urlencoded` — required by the OAuth token endpoint. */
+    postForm<TResponse>(path: string, form: Readonly<Record<string, string>>, options?: RequestOptions): Promise<TResponse>;
+}
+export interface HttpErrorProps {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly body: unknown;
+    /** Parsed `Retry-After` (ms) when the server sent one; otherwise `null`. */
+    readonly retryAfterMs: number | null;
+}
+/** The server responded with a non-2xx status. */
+export declare class HttpError extends AppError {
+    readonly code = "HTTP";
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly body: unknown;
+    readonly retryAfterMs: number | null;
+    constructor(props: HttpErrorProps);
+    isUnauthorized(): boolean;
+    isForbidden(): boolean;
+    isNotFound(): boolean;
+    isConflict(): boolean;
+    isTooManyRequests(): boolean;
+    isClientError(): boolean;
+    isServerError(): boolean;
+}
+/** The request never produced a response (offline, DNS, CORS, timeout, abort). */
+export declare class NetworkError extends AppError {
+    readonly code = "NETWORK";
+    constructor(url: string, cause: unknown);
+}
+//# sourceMappingURL=http-client.d.ts.map

package/types/core/http/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/http-client.ts"],"names":[],"mappings":"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"}

package/types/core/http/index.d.ts

@@ -0,0 +1,6 @@
+export * from './http-client';
+export * from './fetch-http-client';
+export * from './timeout-http-client';
+export * from './retry-http-client';
+export * from './auth-refresh-http-client';
+//# sourceMappingURL=index.d.ts.map

package/types/core/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/types/core/http/retry-http-client.d.ts

@@ -0,0 +1,36 @@
+import type { Logger } from '@core/logger/logger';
+import { type HttpClient, type RequestOptions } from '@core/http/http-client';
+export interface RetryHttpClientDeps {
+    readonly maxRetries?: number;
+    readonly baseDelayMs?: number;
+    readonly maxDelayMs?: number;
+    readonly logger: Logger;
+}
+/**
+ * Decorator that retries transient failures with exponential backoff and full jitter. Only `GET`
+ * is retried: it is the one idempotent verb where replay is always safe. Every other method is
+ * forwarded straight through — retrying a `POST`/`PUT`/`PATCH`/`DELETE` risks duplicate side
+ * effects. A `Retry-After` hint from the server (captured on `HttpError`) takes precedence over
+ * the computed backoff.
+ */
+export declare class RetryHttpClient implements HttpClient {
+    private readonly inner;
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly logger;
+    constructor(inner: HttpClient, deps: RetryHttpClientDeps);
+    get<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    getBlob(path: string, options?: RequestOptions): Promise<Blob>;
+    post<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    postForm<TResponse>(path: string, form: Readonly<Record<string, string>>, options?: RequestOptions): Promise<TResponse>;
+    private withRetry;
+    private isRetryable;
+    private computeDelay;
+    /** Resolve after `delayMs`, or early (without retrying further) if `signal` aborts. */
+    private sleep;
+}
+//# sourceMappingURL=retry-http-client.d.ts.map

package/types/core/http/retry-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-http-client.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/retry-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EAGpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,mBAAmB;IAQxD,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,IAAI,CAAC,SAAS,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,GAAG,CAAC,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,KAAK,CAAC,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAId,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7E,QAAQ,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;YAIP,SAAS;IAwBvB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,YAAY;IAQpB,uFAAuF;IACvF,OAAO,CAAC,KAAK;CAed"}

package/types/core/http/timeout-http-client.d.ts

@@ -0,0 +1,27 @@
+import type { Logger } from '@core/logger/logger';
+import type { HttpClient, RequestOptions } from '@core/http/http-client';
+export interface TimeoutHttpClientDeps {
+    readonly timeoutMs: number;
+    readonly logger: Logger;
+}
+/**
+ * Decorator that bounds every request with a deadline. When the timer fires it aborts the request,
+ * which causes the inner client's `fetch` to reject and surface as a `NetworkError` — the decorator
+ * does not translate the error itself. The caller's own `signal` is merged in, so an external
+ * cancellation still aborts the request before the deadline.
+ */
+export declare class TimeoutHttpClient implements HttpClient {
+    private readonly inner;
+    private readonly timeoutMs;
+    private readonly logger;
+    constructor(inner: HttpClient, deps: TimeoutHttpClientDeps);
+    get<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    getBlob(path: string, options?: RequestOptions): Promise<Blob>;
+    post<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse>(path: string, options?: RequestOptions): Promise<TResponse>;
+    postForm<TResponse>(path: string, form: Readonly<Record<string, string>>, options?: RequestOptions): Promise<TResponse>;
+    private withTimeout;
+}
+//# sourceMappingURL=timeout-http-client.d.ts.map

package/types/core/http/timeout-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-http-client.d.ts","sourceRoot":"","sources":["../../../../../src/core/http/timeout-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB;IAM1D,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,IAAI,CAAC,SAAS,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,GAAG,CAAC,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,KAAK,CAAC,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAOd,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7E,QAAQ,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;YAOP,WAAW;CAwB1B"}

package/types/core/logger/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logger';
+//# sourceMappingURL=index.d.ts.map

package/types/core/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/types/core/logger/logger.d.ts

@@ -0,0 +1,29 @@
+import type { LogLevel } from '@core/config/app-config';
+export type LogMeta = Readonly<Record<string, unknown>>;
+/**
+ * Logging abstraction. UI and services depend on this interface, never on `console` directly,
+ * so we can later swap in Sentry/structured logging without touching call sites.
+ */
+export interface Logger {
+    debug(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    error(message: string, error?: unknown, meta?: LogMeta): void;
+    /** Create a scoped child logger that prefixes every message with `[scope]`. */
+    child(scope: string): Logger;
+}
+/** Default `Logger` backed by the browser console, gated by the configured minimum level. */
+export declare class ConsoleLogger implements Logger {
+    private readonly minLevel;
+    private readonly scope?;
+    private readonly minWeight;
+    constructor(minLevel: LogLevel, scope?: string | undefined);
+    debug(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    error(message: string, error?: unknown, meta?: LogMeta): void;
+    child(scope: string): Logger;
+    private write;
+    private format;
+}
+//# sourceMappingURL=logger.d.ts.map

package/types/core/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/core/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D,+EAA+E;IAC/E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAUD,6FAA6F;AAC7F,qBAAa,aAAc,YAAW,MAAM;IAIxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,YAAA;IAK1B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAO7D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKnC,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,MAAM;CAGf"}

package/types/core/realtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from './realtime-connection';
+export { SignalRConnectionFactory } from './signalr-connection';
+export { NullRealtimeConnection } from './null-realtime-connection';
+//# sourceMappingURL=index.d.ts.map

package/types/core/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/types/core/realtime/null-realtime-connection.d.ts

@@ -0,0 +1,11 @@
+import type { RealtimeConnection, RealtimeEventHandler, RealtimeStatus, RealtimeStatusHandler } from './realtime-connection';
+/** A no-op realtime connection used when a module is disabled by scope/entitlement. */
+export declare class NullRealtimeConnection implements RealtimeConnection {
+    readonly status: RealtimeStatus;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    on(_method: string, _handler: RealtimeEventHandler): () => void;
+    invoke<TResult>(_method: string, ..._args: readonly unknown[]): Promise<TResult>;
+    onStatusChange(_handler: RealtimeStatusHandler): () => void;
+}
+//# sourceMappingURL=null-realtime-connection.d.ts.map

package/types/core/realtime/null-realtime-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-realtime-connection.d.ts","sourceRoot":"","sources":["../../../../../src/core/realtime/null-realtime-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,uFAAuF;AACvF,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,SAAgB,MAAM,EAAE,cAAc,CAAkB;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAGtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3B,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAKzD,MAAM,CAAC,OAAO,EACzB,OAAO,EAAE,MAAM,EACf,GAAG,KAAK,EAAE,SAAS,OAAO,EAAE,GAC3B,OAAO,CAAC,OAAO,CAAC;IAGZ,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;CAKnE"}

package/types/core/realtime/realtime-connection.d.ts

@@ -0,0 +1,37 @@
+/** Connection lifecycle state, transport-agnostic. */
+export type RealtimeStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/** Handler for a server→client event. Our wire contract sends a single payload object per event. */
+export type RealtimeEventHandler = (payload: unknown) => void;
+/** Handler for connection-status transitions. */
+export type RealtimeStatusHandler = (status: RealtimeStatus) => void;
+/**
+ * Port for a bidirectional realtime connection (the Dependency Inversion seam for live updates).
+ * The domain/feature code declares WHAT it subscribes to and invokes; the concrete transport
+ * (SignalR today, a standalone signalling service later) lives behind this interface — so no feature
+ * imports `@microsoft/signalr` directly, exactly as no feature imports `fetch`.
+ */
+export interface RealtimeConnection {
+    /** Open the connection (idempotent — a no-op if already connecting/connected). */
+    start(): Promise<void>;
+    /** Close the connection and release handlers. Safe to call when already stopped. */
+    stop(): Promise<void>;
+    /** Subscribe to a server→client event by name; returns an unsubscribe function. */
+    on(method: string, handler: RealtimeEventHandler): () => void;
+    /** Invoke a server method (client→server RPC) and await its result. */
+    invoke<TResult>(method: string, ...args: readonly unknown[]): Promise<TResult>;
+    /** Subscribe to status changes; returns an unsubscribe function. Fires with the current status. */
+    onStatusChange(handler: RealtimeStatusHandler): () => void;
+    /** The current connection status. */
+    readonly status: RealtimeStatus;
+}
+export interface RealtimeConnectionOptions {
+    /** Absolute or same-origin hub URL (e.g. `/signalr/chat`). */
+    readonly url: string;
+    /** Supplies the current bearer token for the handshake, or `undefined` when signed out. */
+    readonly accessTokenProvider: () => string | undefined;
+}
+/** Builds {@link RealtimeConnection} instances. Injected so tests can supply a fake. */
+export interface RealtimeConnectionFactory {
+    create(options: RealtimeConnectionOptions): RealtimeConnection;
+}
+//# sourceMappingURL=realtime-connection.d.ts.map

package/types/core/realtime/realtime-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-connection.d.ts","sourceRoot":"","sources":["../../../../../src/core/realtime/realtime-connection.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE1F,oGAAoG;AACpG,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,oFAAoF;IACpF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,mFAAmF;IACnF,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAC9D,uEAAuE;IACvE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,mGAAmG;IACnG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IAC3D,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,wFAAwF;AACxF,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAAC;CAChE"}

package/types/core/realtime/reconnect-policy.d.ts

@@ -0,0 +1,23 @@
+import type { IRetryPolicy, RetryContext } from '@microsoft/signalr';
+/**
+ * Hard ceiling on a single reconnect wait. Bounds the worst-case latency to recover once the network
+ * returns (and the per-attempt load a reconnecting fleet puts on the server).
+ */
+export declare const MAX_RECONNECT_DELAY_MS = 15000;
+/**
+ * Full-jitter, capped exponential backoff for realtime reconnection. Returns a delay in
+ * `[0, min(MAX, 1000·2^attempt)]` — always a finite number, so reconnection NEVER gives up (unlike
+ * SignalR's built-in default policy, which abandons the socket after 4 attempts / ~40s). Full jitter
+ * spreads a fleet's reconnects after a shared outage (e.g. a backend deploy) instead of stampeding at
+ * identical intervals.
+ */
+export declare const nextReconnectDelayMs: (previousRetryCount: number, random?: () => number) => number;
+/**
+ * SignalR reconnect policy that retries FOREVER with {@link nextReconnectDelayMs} backoff. Wiring this
+ * into `withAutomaticReconnect` is what keeps a client alive across laptop sleeps, phone backgrounding,
+ * network blips and backend deploys — the built-in default gives up after ~40s and never recovers.
+ */
+export declare class UnboundedReconnectPolicy implements IRetryPolicy {
+    nextRetryDelayInMilliseconds(retryContext: RetryContext): number;
+}
+//# sourceMappingURL=reconnect-policy.d.ts.map

package/types/core/realtime/reconnect-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-policy.d.ts","sourceRoot":"","sources":["../../../../../src/core/realtime/reconnect-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAK7C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,oBAAoB,MAAM,EAC1B,SAAQ,MAAM,MAAoB,KACjC,MAIF,CAAC;AAEF;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IACpD,4BAA4B,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM;CAGxE"}

package/types/core/realtime/signalr-connection.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '@core/logger';
+import { type RealtimeConnection, type RealtimeConnectionFactory, type RealtimeConnectionOptions } from './realtime-connection';
+/** Builds SignalR-backed realtime connections. The single concrete wired at the composition root. */
+export declare class SignalRConnectionFactory implements RealtimeConnectionFactory {
+    private readonly logger;
+    constructor(deps: {
+        readonly logger: Logger;
+    });
+    create(options: RealtimeConnectionOptions): RealtimeConnection;
+}
+//# sourceMappingURL=signalr-connection.d.ts.map

package/types/core/realtime/signalr-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalr-connection.d.ts","sourceRoot":"","sources":["../../../../../src/core/realtime/signalr-connection.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAI/B,MAAM,uBAAuB,CAAC;AA8M/B,qGAAqG;AACrG,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAI7C,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB;CAGtE"}

package/types/core/result/index.d.ts

@@ -0,0 +1,2 @@
+export * from './result';
+//# sourceMappingURL=index.d.ts.map

package/types/core/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/result/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}