miakapi 3.0.31 → 4.0.0-alpha.1

package/dist/api.d.ts

@@ -0,0 +1,224 @@
+export type ProtocolObject = {
+    [key: string]: ProtocolValue;
+};
+export type ProtocolValue = null | boolean | number | string | Uint8Array | ProtocolValue[] | ProtocolObject;
+export type Unsubscribe = () => void;
+export type CoordinatorStatus = 'idle' | 'connecting' | 'authenticating' | 'synchronizing' | 'ready' | 'reconnecting' | 'draining' | 'stopping' | 'stopped';
+export type DispatchOutcome = 'not_dispatched' | 'sent' | 'accepted' | 'applied' | 'outcome_unknown';
+export interface AccessTokenRequest {
+    coordinatorName: string;
+    reason: 'initial' | 'reauth' | 'reconnect';
+    relayHost?: string;
+    signal: AbortSignal;
+}
+export interface AccessToken {
+    relayUrl: string;
+    token: string;
+    expiresAtMs: number;
+}
+export interface AccessTokenProvider {
+    getAccessToken(request: AccessTokenRequest): Promise<AccessToken>;
+}
+export interface CoordinatorLogRecord {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    event: string;
+    status?: CoordinatorStatus;
+    code?: number;
+}
+export interface CoordinatorLogger {
+    write(record: CoordinatorLogRecord): void;
+}
+export interface CoordinatorOptions {
+    name: string;
+    accessTokenProvider: AccessTokenProvider;
+    logger?: CoordinatorLogger;
+}
+export interface CoordinatorConfiguration {
+    state: Readonly<Record<string, ProtocolValue>>;
+    stateAccess: readonly UserStateAccess[];
+    events: readonly EventDeclaration[];
+    eventAccess: readonly UserEventAccess[];
+    functions: Readonly<Record<string, FunctionHandler>>;
+}
+export interface ReadySession {
+    sessionId: number;
+    generation: number;
+    connectedAtMs: number;
+}
+export interface CoordinatorFailure extends Error {
+    kind: 'protocol' | 'authentication' | 'authorization' | 'conflict' | 'invalid_lifecycle' | 'unavailable' | 'cancelled' | 'superseded' | 'internal';
+    code?: number;
+    retryable: boolean;
+    outcome: DispatchOutcome;
+    correlation?: {
+        kind: 'event' | 'call';
+        localId: string;
+    };
+}
+export declare class ApplicationCallError extends Error {
+    readonly code: number;
+    readonly retryable: boolean;
+    constructor(code: number, message?: string, retryable?: boolean);
+}
+export interface LifecycleEvent {
+    previous: CoordinatorStatus;
+    current: CoordinatorStatus;
+    session?: ReadySession;
+    reason?: CoordinatorFailure;
+}
+export interface StartOptions {
+    signal?: AbortSignal;
+}
+export interface StopOptions {
+    deadlineMs?: number;
+}
+export interface DeclarationOptions {
+    signal?: AbortSignal;
+}
+export interface OperationOptions {
+    signal?: AbortSignal;
+}
+export interface DeclarationReceipt {
+    sessionId: number;
+    generation: number;
+}
+export interface StateReceipt {
+    outcome: 'applied';
+}
+export type StateMutation = {
+    path: string;
+    value: ProtocolValue;
+} | {
+    path: string;
+    delete: true;
+};
+export interface CoordinatorState {
+    declare(entries: Readonly<Record<string, ProtocolValue>>, options?: DeclarationOptions): Promise<DeclarationReceipt>;
+    set(mutations: readonly StateMutation[], options?: OperationOptions): Promise<StateReceipt>;
+}
+export interface UserStateAccess {
+    userId: string;
+    patterns: readonly string[];
+}
+export interface UserEventAccess {
+    userId: string;
+    publish: readonly string[];
+    subscribe: readonly string[];
+}
+export interface CoordinatorAccess {
+    declareState(entries: readonly UserStateAccess[], options?: DeclarationOptions): Promise<DeclarationReceipt>;
+    declareEvents(entries: readonly UserEventAccess[], options?: DeclarationOptions): Promise<DeclarationReceipt>;
+}
+export declare const EventDirection: Readonly<{
+    readonly acceptFromUsers: 1;
+    readonly publishToUsers: 2;
+    readonly acceptFromCoordinators: 4;
+    readonly publishToCoordinators: 8;
+}>;
+export interface EventDeclaration {
+    topic: string;
+    directions: number;
+}
+export type EventTarget = {
+    kind: 'default';
+} | {
+    kind: 'user_session';
+    id: number;
+} | {
+    kind: 'coordinator';
+    id: string;
+};
+export interface SentEvent {
+    outcome: 'sent';
+}
+export interface EventHandle {
+    readonly localId: string;
+    readonly sent: Promise<SentEvent>;
+}
+export interface IncomingEvent {
+    source: Principal;
+    topic: string;
+    value: ProtocolValue;
+}
+export interface CoordinatorEvents {
+    declare(entries: readonly EventDeclaration[], options?: DeclarationOptions): Promise<DeclarationReceipt>;
+    publish(topic: string, value: ProtocolValue, options?: OperationOptions & {
+        target?: EventTarget;
+    }): EventHandle;
+    subscribe(topic: string, listener: (event: IncomingEvent) => void): Unsubscribe;
+}
+export interface Principal {
+    kind: 'user' | 'coordinator' | 'cli';
+    id: string;
+    sessionId: number;
+    coordinatorName: string | null;
+    verifiedEmail: string | null;
+}
+export interface IncomingCall {
+    source: Principal;
+    arguments: ProtocolValue;
+    idempotencyKey: string | null;
+    signal: AbortSignal;
+    emit(value: ProtocolValue): Promise<void>;
+}
+export type FunctionHandler = (call: IncomingCall) => ProtocolValue | Promise<ProtocolValue>;
+export interface CoordinatorFunctions {
+    declare(handlers: Readonly<Record<string, FunctionHandler>>, options?: DeclarationOptions): Promise<DeclarationReceipt>;
+}
+export type CallTarget = {
+    kind: 'default';
+} | {
+    kind: 'user_session';
+    id: number;
+} | {
+    kind: 'coordinator';
+    id: string;
+};
+export interface StartCallOptions {
+    function: string;
+    arguments: ProtocolValue;
+    timeoutMs: number;
+    target?: CallTarget;
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+}
+export interface CallHandle {
+    readonly localId: string;
+    readonly accepted: Promise<void>;
+    readonly stream: AsyncIterable<ProtocolValue>;
+    readonly result: Promise<ProtocolValue>;
+    cancel(reason?: string): void;
+}
+export interface CoordinatorCalls {
+    start(options: StartCallOptions): CallHandle;
+}
+export interface PresenceEntry {
+    sessionId: number;
+    userId: string;
+}
+export interface CoordinatorPresence {
+    snapshot(): readonly PresenceEntry[];
+    subscribe(listener: (entries: readonly PresenceEntry[]) => void): Unsubscribe;
+}
+export interface CoordinatorErrors {
+    subscribe(listener: (failure: CoordinatorFailure) => void): Unsubscribe;
+}
+export interface Coordinator {
+    readonly status: CoordinatorStatus;
+    readonly state: CoordinatorState;
+    readonly access: CoordinatorAccess;
+    readonly events: CoordinatorEvents;
+    readonly functions: CoordinatorFunctions;
+    readonly calls: CoordinatorCalls;
+    readonly presence: CoordinatorPresence;
+    readonly errors: CoordinatorErrors;
+    configure(configuration: CoordinatorConfiguration): void;
+    start(options?: StartOptions): Promise<ReadySession>;
+    stop(options?: StopOptions): Promise<void>;
+    subscribe(listener: (event: LifecycleEvent) => void): Unsubscribe;
+}
+export type CoordinatorFactory = (options: CoordinatorOptions) => Coordinator;
+export interface CoordinatorModule {
+    createCoordinator: CoordinatorFactory;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,47 @@
+const API_UTF8 = new TextEncoder();
+const API_CONTROL_CHARACTER = /\p{Cc}/u;
+function hasUnpairedSurrogate(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const unit = value.charCodeAt(index);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const following = value.charCodeAt(index + 1);
+            if (index + 1 >= value.length || following < 0xdc00 || following > 0xdfff)
+                return true;
+            index += 1;
+        }
+        else if (unit >= 0xdc00 && unit <= 0xdfff) {
+            return true;
+        }
+    }
+    return false;
+}
+export class ApplicationCallError extends Error {
+    code;
+    retryable;
+    constructor(code, message = 'Application call failed', retryable = false) {
+        if (!Number.isInteger(code) || code < 2_000 || code > 2_999) {
+            throw new RangeError('Application call error code must be between 2000 and 2999');
+        }
+        if (typeof message !== 'string'
+            || message.length === 0
+            || hasUnpairedSurrogate(message)
+            || API_CONTROL_CHARACTER.test(message)
+            || API_UTF8.encode(message).byteLength > 256) {
+            throw new TypeError('Application call error message must contain 1 to 256 safe UTF-8 bytes');
+        }
+        if (typeof retryable !== 'boolean') {
+            throw new TypeError('Application call error retryable flag must be a boolean');
+        }
+        super(message);
+        this.name = 'ApplicationCallError';
+        this.code = code;
+        this.retryable = retryable;
+    }
+}
+export const EventDirection = Object.freeze({
+    acceptFromUsers: 0x01,
+    publishToUsers: 0x02,
+    acceptFromCoordinators: 0x04,
+    publishToCoordinators: 0x08,
+});
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;AACnC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAExC,SAAS,oBAAoB,CAAC,KAAa;IACzC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,GAAG,MAAM,IAAI,SAAS,GAAG,MAAM;gBAAE,OAAO,IAAI,CAAC;YACvF,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAmGD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,SAAS,CAAU;IAE5B,YAAY,IAAY,EAAE,OAAO,GAAG,yBAAyB,EAAE,SAAS,GAAG,KAAK;QAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAC5D,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,QAAQ;eAC1B,OAAO,CAAC,MAAM,KAAK,CAAC;eACpB,oBAAoB,CAAC,OAAO,CAAC;eAC7B,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;eACnC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YAC/C,MAAM,IAAI,SAAS,CAAC,uEAAuE,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;QACjF,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAyED,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,sBAAsB,EAAE,IAAI;IAC5B,qBAAqB,EAAE,IAAI;CACnB,CAAC,CAAC"}

package/dist/browser-api.d.ts

@@ -0,0 +1,113 @@
+import type { DispatchOutcome, ProtocolValue, StartOptions, StopOptions, Unsubscribe } from './api.js';
+export type BrowserClientStatus = 'idle' | 'connecting' | 'authenticating' | 'synchronizing' | 'ready' | 'reconnecting' | 'draining' | 'stopping' | 'stopped';
+export type BrowserRelayCredentialReason = 'initial' | 'reauth' | 'reconnect';
+export interface BrowserRelayCredentialRequest {
+    readonly homeId: string;
+    readonly reason: BrowserRelayCredentialReason;
+    readonly signal: AbortSignal;
+}
+export interface BrowserRelayCredential {
+    readonly relayUrl: string;
+    readonly accessToken: string;
+    readonly expiresAtMs: number;
+}
+export interface BrowserRelayCredentialProvider {
+    getCredential(request: BrowserRelayCredentialRequest): Promise<BrowserRelayCredential>;
+}
+export interface ControlPlaneBrowserRelayCredentialProviderOptions {
+    readonly exchangeEndpoint: string;
+    readonly getFirebaseIdToken: (request: BrowserRelayCredentialRequest) => Promise<string>;
+    readonly getAppCheckToken: (request: BrowserRelayCredentialRequest) => Promise<string>;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export interface BrowserClientLogRecord {
+    readonly level: 'debug' | 'info' | 'warn' | 'error';
+    readonly event: string;
+    readonly status?: BrowserClientStatus;
+    readonly code?: number;
+}
+export interface BrowserClientLogger {
+    write(record: BrowserClientLogRecord): void;
+}
+export interface BrowserClientOptions {
+    readonly homeId: string;
+    readonly credentialProvider: BrowserRelayCredentialProvider;
+    readonly logger?: BrowserClientLogger;
+}
+export interface BrowserCoordinatorStatus {
+    readonly name: string;
+    readonly generation: number;
+    readonly status: 'connected' | 'grace';
+}
+export interface BrowserReadySession {
+    readonly sessionId: number;
+    readonly connectedAtMs: number;
+    readonly enrolled: boolean;
+    readonly coordinators: readonly BrowserCoordinatorStatus[];
+}
+export interface BrowserHomeStatus {
+    readonly enrolled: boolean;
+    readonly coordinators: readonly BrowserCoordinatorStatus[];
+    readonly stale: boolean;
+}
+export interface BrowserHome {
+    snapshot(): BrowserHomeStatus | undefined;
+    subscribe(listener: (status: BrowserHomeStatus) => void): Unsubscribe;
+}
+export interface BrowserClientFailure extends Error {
+    readonly kind: 'protocol' | 'authentication' | 'authorization' | 'conflict' | 'invalid_lifecycle' | 'unavailable' | 'cancelled' | 'internal';
+    readonly code?: number;
+    readonly retryable: boolean;
+    readonly outcome: DispatchOutcome;
+    readonly correlation?: {
+        readonly kind: 'call';
+        readonly localId: string;
+    };
+}
+export interface BrowserLifecycleEvent {
+    readonly previous: BrowserClientStatus;
+    readonly current: BrowserClientStatus;
+    readonly session?: BrowserReadySession;
+    readonly reason?: BrowserClientFailure;
+}
+export interface BrowserStateSnapshot {
+    readonly epoch: Uint8Array;
+    readonly revision: number;
+    readonly values: Readonly<Record<string, ProtocolValue>>;
+    readonly stale: boolean;
+}
+export interface BrowserState {
+    snapshot(): BrowserStateSnapshot | undefined;
+    subscribe(listener: (snapshot: BrowserStateSnapshot) => void): Unsubscribe;
+}
+export interface BrowserCallOptions {
+    readonly function: string;
+    readonly arguments: ProtocolValue;
+    readonly timeoutMs: number;
+    readonly idempotencyKey?: string;
+    readonly signal?: AbortSignal;
+}
+export interface BrowserCallHandle {
+    readonly localId: string;
+    readonly accepted: Promise<void>;
+    readonly result: Promise<ProtocolValue>;
+    cancel(): void;
+}
+export interface BrowserCalls {
+    start(options: BrowserCallOptions): BrowserCallHandle;
+}
+export interface BrowserClientErrors {
+    subscribe(listener: (failure: BrowserClientFailure) => void): Unsubscribe;
+}
+export interface BrowserClient {
+    readonly status: BrowserClientStatus;
+    readonly home: BrowserHome;
+    readonly state: BrowserState;
+    readonly calls: BrowserCalls;
+    readonly errors: BrowserClientErrors;
+    start(options?: StartOptions): Promise<BrowserReadySession>;
+    stop(options?: StopOptions): Promise<void>;
+    subscribe(listener: (event: BrowserLifecycleEvent) => void): Unsubscribe;
+}
+export type BrowserClientFactory = (options: BrowserClientOptions) => BrowserClient;
+//# sourceMappingURL=browser-api.d.ts.map

package/dist/browser-api.d.ts.map

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

package/dist/browser-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-api.js.map

package/dist/browser-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-api.js","sourceRoot":"","sources":["../src/browser-api.ts"],"names":[],"mappings":""}

package/dist/browser-client.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserClient, BrowserClientOptions } from './browser-api.js';
+export declare function createBrowserClient(options: BrowserClientOptions): BrowserClient;
+//# sourceMappingURL=browser-client.d.ts.map

package/dist/browser-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-client.d.ts","sourceRoot":"","sources":["../src/browser-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EAGb,oBAAoB,EASrB,MAAM,kBAAkB,CAAC;AA+tB1B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF"}