database-devtools 0.1.0

package/dist/types/protocol.d.cts

@@ -0,0 +1,291 @@
+import { a as WriteOperation } from '../write-C3toEIMs.cjs';
+
+/** Client and server roles on the WebSocket hub. */
+declare const DevToolsRole: {
+    readonly MOBILE: "mobile";
+    readonly BROWSER: "browser";
+};
+type DevToolsRole = (typeof DevToolsRole)[keyof typeof DevToolsRole];
+/** All wire message type identifiers. */
+declare const MessageType: {
+    readonly REGISTER: "register";
+    readonly PING: "ping";
+    readonly PONG: "pong";
+    readonly DEVICE_STATUS: "deviceStatus";
+    readonly BROADCAST: "broadcast";
+    readonly REFRESH_REQUEST: "refreshRequest";
+    readonly SNAPSHOT_UPLOAD_REQUESTED: "snapshotUploadRequested";
+    readonly REFRESH_STATUS: "refreshStatus";
+    readonly SNAPSHOT_READY: "snapshotReady";
+    readonly REFRESH_ERROR: "refreshError";
+    readonly EXPORT_SNAPSHOT_REQUEST: "exportSnapshotRequest";
+    readonly EXPORT_SNAPSHOT_ERROR: "exportSnapshotError";
+    readonly BEGIN_TRANSACTION_REQUEST: "beginTransactionRequest";
+    readonly COMMIT_TRANSACTION_REQUEST: "commitTransactionRequest";
+    readonly ROLLBACK_TRANSACTION_REQUEST: "rollbackTransactionRequest";
+    readonly WRITE_REQUEST: "writeRequest";
+    readonly BEGIN_TRANSACTION: "beginTransaction";
+    readonly COMMIT_TRANSACTION: "commitTransaction";
+    readonly ROLLBACK_TRANSACTION: "rollbackTransaction";
+    readonly EXECUTE_WRITE: "executeWrite";
+    readonly TRANSACTION_ACK: "transactionAck";
+    readonly WRITE_ACK: "writeAck";
+    readonly TRANSACTION_STATUS: "transactionStatus";
+    readonly WRITE_RESULT: "writeResult";
+    readonly WRITE_ERROR: "writeError";
+};
+type MessageTypeValue = (typeof MessageType)[keyof typeof MessageType];
+/** Shared base for every protocol message. */
+interface DevToolsMessageBase {
+    type: MessageTypeValue;
+    timestamp: number;
+}
+type DeviceMetadata = {
+    platform?: string;
+    appName?: string;
+    [key: string]: string | undefined;
+};
+/** Client → Server: register role on connect. */
+interface RegisterMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REGISTER;
+    role: DevToolsRole;
+    deviceId?: string;
+    metadata?: DeviceMetadata;
+}
+/** Server → Client: heartbeat probe. */
+interface PingMessage extends DevToolsMessageBase {
+    type: typeof MessageType.PING;
+    pingId: string;
+}
+/** Client → Server: heartbeat response. */
+interface PongMessage extends DevToolsMessageBase {
+    type: typeof MessageType.PONG;
+    pingId: string;
+}
+type BrowserConnectionInfo = {
+    connectionId: string;
+    connectedAt: number;
+};
+type MobileDeviceInfo = {
+    deviceId: string;
+    connectionId: string;
+    connectedAt: number;
+    metadata?: DeviceMetadata;
+};
+type DeviceStatusPayload = {
+    browserCount: number;
+    mobileCount: number;
+    browsers: BrowserConnectionInfo[];
+    mobiles: MobileDeviceInfo[];
+};
+/** Server → Client: hub snapshot after connect/disconnect. */
+interface DeviceStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.DEVICE_STATUS;
+    payload: DeviceStatusPayload;
+}
+/** Server → Client: generic routed envelope for future features. */
+interface BroadcastMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BROADCAST;
+    payload: unknown;
+}
+type RefreshType = 'snapshot';
+type RefreshState = 'requested' | 'exporting' | 'uploading' | 'ready' | 'failed' | 'timeout';
+/** @deprecated Use RefreshState */
+type SyncState = RefreshState;
+type RefreshErrorCode = 'DEVICE_OFFLINE' | 'REFRESH_IN_PROGRESS' | 'EXPORT_FAILED' | 'UPLOAD_FAILED' | 'TIMEOUT' | 'SNAPSHOT_NOT_FOUND' | 'INVALID_REQUEST';
+/** @deprecated Use RefreshErrorCode */
+type SyncErrorCode = RefreshErrorCode;
+/** Browser → Server: request a database snapshot from a mobile device. */
+interface RefreshRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_REQUEST;
+    deviceId: string;
+    refreshType: RefreshType;
+}
+/** Server → Mobile: export database and upload via REST. */
+interface SnapshotUploadRequestedMessage extends DevToolsMessageBase {
+    type: typeof MessageType.SNAPSHOT_UPLOAD_REQUESTED;
+    deviceId: string;
+    refreshType: RefreshType;
+}
+/** Server → Browser: refresh progress update. */
+interface RefreshStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_STATUS;
+    deviceId: string;
+    state: RefreshState;
+    message?: string;
+}
+/** Server → Browser: snapshot uploaded and ready to download. */
+interface SnapshotReadyMessage extends DevToolsMessageBase {
+    type: typeof MessageType.SNAPSHOT_READY;
+    deviceId: string;
+    size: number;
+    exportedAt: number;
+    kind: string;
+    mimeType: string;
+    databaseName?: string;
+}
+/** Server → Browser: refresh failed. */
+interface RefreshErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_ERROR;
+    deviceId: string;
+    code: RefreshErrorCode;
+    message: string;
+}
+/** Mobile → Server: push database snapshot to the web inspector. */
+interface ExportSnapshotRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXPORT_SNAPSHOT_REQUEST;
+    refreshType: RefreshType;
+}
+/** Server → Mobile: export request failed before upload. */
+interface ExportSnapshotErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXPORT_SNAPSHOT_ERROR;
+    code: RefreshErrorCode;
+    message: string;
+}
+type RefreshInitiator = 'browser' | 'mobile';
+type TransactionStatusState = 'idle' | 'opening' | 'open' | 'committing' | 'rolling_back' | 'failed';
+type WriteErrorCode = 'DEVICE_OFFLINE' | 'NO_TRANSACTION' | 'TRANSACTION_BUSY' | 'INVALID_OPERATION' | 'WRITE_FAILED' | 'ADAPTER_ERROR' | 'TIMEOUT';
+/** Browser → Server: open a write transaction on a device. */
+interface BeginTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BEGIN_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: commit the active transaction. */
+interface CommitTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.COMMIT_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: roll back the active transaction. */
+interface RollbackTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.ROLLBACK_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: execute a structured write inside a transaction. */
+interface WriteRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_REQUEST;
+    writeId: string;
+    transactionId: string;
+    deviceId: string;
+    operation: WriteOperation;
+}
+/** Server → Mobile: begin a transaction on the live database. */
+interface BeginTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BEGIN_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: commit the open transaction. */
+interface CommitTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.COMMIT_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: roll back the open transaction. */
+interface RollbackTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.ROLLBACK_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: run a structured write operation. */
+interface ExecuteWriteMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXECUTE_WRITE;
+    writeId: string;
+    transactionId: string;
+    operation: WriteOperation;
+}
+/** Mobile → Server: transaction lifecycle acknowledgement. */
+interface TransactionAckMessage extends DevToolsMessageBase {
+    type: typeof MessageType.TRANSACTION_ACK;
+    transactionId: string;
+    action: 'begin' | 'commit' | 'rollback';
+    ok: boolean;
+    message?: string;
+}
+/** Mobile → Server: write operation acknowledgement. */
+interface WriteAckMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_ACK;
+    writeId: string;
+    transactionId: string;
+    ok: boolean;
+    rowsAffected?: number;
+    message?: string;
+}
+/** Server → Browser: transaction state update. */
+interface TransactionStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.TRANSACTION_STATUS;
+    transactionId: string;
+    deviceId: string;
+    state: TransactionStatusState;
+    message?: string;
+}
+/** Server → Browser: write succeeded. */
+interface WriteResultMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_RESULT;
+    writeId: string;
+    transactionId: string;
+    rowsAffected: number;
+}
+/** Server → Browser: write or transaction failed. */
+interface WriteErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_ERROR;
+    transactionId: string;
+    writeId?: string;
+    code: WriteErrorCode;
+    message: string;
+}
+type ClientMessage = RegisterMessage | PongMessage | RefreshRequestMessage | ExportSnapshotRequestMessage | BeginTransactionRequestMessage | CommitTransactionRequestMessage | RollbackTransactionRequestMessage | WriteRequestMessage | TransactionAckMessage | WriteAckMessage;
+type ServerMessage = PingMessage | DeviceStatusMessage | BroadcastMessage | SnapshotUploadRequestedMessage | RefreshStatusMessage | SnapshotReadyMessage | RefreshErrorMessage | ExportSnapshotErrorMessage | BeginTransactionMessage | CommitTransactionMessage | RollbackTransactionMessage | ExecuteWriteMessage | TransactionStatusMessage | WriteResultMessage | WriteErrorMessage;
+type DevToolsMessage = ClientMessage | ServerMessage;
+declare const DEVTOOLS_WS_PATH = "/ws";
+declare const DEFAULT_DEVTOOLS_PORT = 3847;
+declare const DEFAULT_DEVTOOLS_HOST = "0.0.0.0";
+declare const HEARTBEAT_INTERVAL_MS = 30000;
+declare const HEARTBEAT_TIMEOUT_MS = 10000;
+declare const DEVICE_SNAPSHOT_API_PATH = "/api/devices";
+declare const PROJECT_DATABASE_API_PATH = "/api/project/database";
+declare const PROJECT_DATABASE_META_API_PATH = "/api/project/database/meta";
+declare const PROJECT_DATABASES_API_PATH = "/api/project/databases";
+declare const PROJECT_DEVICE_EXPORTS_API_PATH = "/api/project/devices";
+/** @deprecated Use DEVICE_SNAPSHOT_API_PATH */
+declare const SNAPSHOT_API_PATH = "/api/devices";
+declare const REFRESH_TIMEOUT_MS = 60000;
+/** @deprecated Use REFRESH_TIMEOUT_MS */
+declare const SYNC_TIMEOUT_MS = 60000;
+declare const WRITE_TRANSACTION_TIMEOUT_MS: number;
+declare const MAX_SNAPSHOT_BYTES: number;
+declare function createMessage<T extends DevToolsMessageBase>(message: Omit<T, 'timestamp'>): T;
+declare function buildDevToolsHttpUrl(host?: string, port?: number): string;
+declare function buildDevToolsWsUrl(host?: string, port?: number): string;
+declare function buildDeviceSnapshotUrl(httpBaseUrl: string, deviceId: string): string;
+/** @deprecated Use buildDeviceSnapshotUrl */
+declare function buildSnapshotUrl(httpBaseUrl: string, deviceId: string): string;
+declare function wsUrlToHttpUrl(wsUrl: string): string;
+declare function isRegisterMessage(value: unknown): value is RegisterMessage;
+declare function isPongMessage(value: unknown): value is PongMessage;
+declare function isRefreshRequestMessage(value: unknown): value is RefreshRequestMessage;
+declare function isSnapshotUploadRequestedMessage(value: unknown): value is SnapshotUploadRequestedMessage;
+declare function isRefreshStatusMessage(value: unknown): value is RefreshStatusMessage;
+declare function isSnapshotReadyMessage(value: unknown): value is SnapshotReadyMessage;
+declare function isRefreshErrorMessage(value: unknown): value is RefreshErrorMessage;
+declare function isExportSnapshotRequestMessage(value: unknown): value is ExportSnapshotRequestMessage;
+declare function isExportSnapshotErrorMessage(value: unknown): value is ExportSnapshotErrorMessage;
+declare function isBeginTransactionRequestMessage(value: unknown): value is BeginTransactionRequestMessage;
+declare function isCommitTransactionRequestMessage(value: unknown): value is CommitTransactionRequestMessage;
+declare function isRollbackTransactionRequestMessage(value: unknown): value is RollbackTransactionRequestMessage;
+declare function isWriteRequestMessage(value: unknown): value is WriteRequestMessage;
+declare function isTransactionAckMessage(value: unknown): value is TransactionAckMessage;
+declare function isWriteAckMessage(value: unknown): value is WriteAckMessage;
+declare function isClientMessage(value: unknown): value is ClientMessage;
+declare function isPingMessage(value: unknown): value is PingMessage;
+declare function isDeviceStatusMessage(value: unknown): value is DeviceStatusMessage;
+declare function isBroadcastMessage(value: unknown): value is BroadcastMessage;
+declare function isBeginTransactionMessage(value: unknown): value is BeginTransactionMessage;
+declare function isCommitTransactionMessage(value: unknown): value is CommitTransactionMessage;
+declare function isRollbackTransactionMessage(value: unknown): value is RollbackTransactionMessage;
+declare function isExecuteWriteMessage(value: unknown): value is ExecuteWriteMessage;
+declare function isTransactionStatusMessage(value: unknown): value is TransactionStatusMessage;
+declare function isWriteResultMessage(value: unknown): value is WriteResultMessage;
+declare function isWriteErrorMessage(value: unknown): value is WriteErrorMessage;
+declare function isServerMessage(value: unknown): value is ServerMessage;
+
+export { type BeginTransactionMessage, type BeginTransactionRequestMessage, type BroadcastMessage, type BrowserConnectionInfo, type ClientMessage, type CommitTransactionMessage, type CommitTransactionRequestMessage, DEFAULT_DEVTOOLS_HOST, DEFAULT_DEVTOOLS_PORT, DEVICE_SNAPSHOT_API_PATH, DEVTOOLS_WS_PATH, type DevToolsMessage, type DevToolsMessageBase, DevToolsRole, type DeviceMetadata, type DeviceStatusMessage, type DeviceStatusPayload, type ExecuteWriteMessage, type ExportSnapshotErrorMessage, type ExportSnapshotRequestMessage, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, MAX_SNAPSHOT_BYTES, MessageType, type MessageTypeValue, type MobileDeviceInfo, PROJECT_DATABASES_API_PATH, PROJECT_DATABASE_API_PATH, PROJECT_DATABASE_META_API_PATH, PROJECT_DEVICE_EXPORTS_API_PATH, type PingMessage, type PongMessage, REFRESH_TIMEOUT_MS, type RefreshErrorCode, type RefreshErrorMessage, type RefreshInitiator, type RefreshRequestMessage, type RefreshState, type RefreshStatusMessage, type RefreshType, type RegisterMessage, type RollbackTransactionMessage, type RollbackTransactionRequestMessage, SNAPSHOT_API_PATH, SYNC_TIMEOUT_MS, type ServerMessage, type SnapshotReadyMessage, type SnapshotUploadRequestedMessage, type SyncErrorCode, type SyncState, type TransactionAckMessage, type TransactionStatusMessage, type TransactionStatusState, WRITE_TRANSACTION_TIMEOUT_MS, type WriteAckMessage, type WriteErrorCode, type WriteErrorMessage, type WriteRequestMessage, type WriteResultMessage, buildDevToolsHttpUrl, buildDevToolsWsUrl, buildDeviceSnapshotUrl, buildSnapshotUrl, createMessage, isBeginTransactionMessage, isBeginTransactionRequestMessage, isBroadcastMessage, isClientMessage, isCommitTransactionMessage, isCommitTransactionRequestMessage, isDeviceStatusMessage, isExecuteWriteMessage, isExportSnapshotErrorMessage, isExportSnapshotRequestMessage, isPingMessage, isPongMessage, isRefreshErrorMessage, isRefreshRequestMessage, isRefreshStatusMessage, isRegisterMessage, isRollbackTransactionMessage, isRollbackTransactionRequestMessage, isServerMessage, isSnapshotReadyMessage, isSnapshotUploadRequestedMessage, isTransactionAckMessage, isTransactionStatusMessage, isWriteAckMessage, isWriteErrorMessage, isWriteRequestMessage, isWriteResultMessage, wsUrlToHttpUrl };

package/dist/types/protocol.d.ts

@@ -0,0 +1,291 @@
+import { a as WriteOperation } from '../write-C3toEIMs.js';
+
+/** Client and server roles on the WebSocket hub. */
+declare const DevToolsRole: {
+    readonly MOBILE: "mobile";
+    readonly BROWSER: "browser";
+};
+type DevToolsRole = (typeof DevToolsRole)[keyof typeof DevToolsRole];
+/** All wire message type identifiers. */
+declare const MessageType: {
+    readonly REGISTER: "register";
+    readonly PING: "ping";
+    readonly PONG: "pong";
+    readonly DEVICE_STATUS: "deviceStatus";
+    readonly BROADCAST: "broadcast";
+    readonly REFRESH_REQUEST: "refreshRequest";
+    readonly SNAPSHOT_UPLOAD_REQUESTED: "snapshotUploadRequested";
+    readonly REFRESH_STATUS: "refreshStatus";
+    readonly SNAPSHOT_READY: "snapshotReady";
+    readonly REFRESH_ERROR: "refreshError";
+    readonly EXPORT_SNAPSHOT_REQUEST: "exportSnapshotRequest";
+    readonly EXPORT_SNAPSHOT_ERROR: "exportSnapshotError";
+    readonly BEGIN_TRANSACTION_REQUEST: "beginTransactionRequest";
+    readonly COMMIT_TRANSACTION_REQUEST: "commitTransactionRequest";
+    readonly ROLLBACK_TRANSACTION_REQUEST: "rollbackTransactionRequest";
+    readonly WRITE_REQUEST: "writeRequest";
+    readonly BEGIN_TRANSACTION: "beginTransaction";
+    readonly COMMIT_TRANSACTION: "commitTransaction";
+    readonly ROLLBACK_TRANSACTION: "rollbackTransaction";
+    readonly EXECUTE_WRITE: "executeWrite";
+    readonly TRANSACTION_ACK: "transactionAck";
+    readonly WRITE_ACK: "writeAck";
+    readonly TRANSACTION_STATUS: "transactionStatus";
+    readonly WRITE_RESULT: "writeResult";
+    readonly WRITE_ERROR: "writeError";
+};
+type MessageTypeValue = (typeof MessageType)[keyof typeof MessageType];
+/** Shared base for every protocol message. */
+interface DevToolsMessageBase {
+    type: MessageTypeValue;
+    timestamp: number;
+}
+type DeviceMetadata = {
+    platform?: string;
+    appName?: string;
+    [key: string]: string | undefined;
+};
+/** Client → Server: register role on connect. */
+interface RegisterMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REGISTER;
+    role: DevToolsRole;
+    deviceId?: string;
+    metadata?: DeviceMetadata;
+}
+/** Server → Client: heartbeat probe. */
+interface PingMessage extends DevToolsMessageBase {
+    type: typeof MessageType.PING;
+    pingId: string;
+}
+/** Client → Server: heartbeat response. */
+interface PongMessage extends DevToolsMessageBase {
+    type: typeof MessageType.PONG;
+    pingId: string;
+}
+type BrowserConnectionInfo = {
+    connectionId: string;
+    connectedAt: number;
+};
+type MobileDeviceInfo = {
+    deviceId: string;
+    connectionId: string;
+    connectedAt: number;
+    metadata?: DeviceMetadata;
+};
+type DeviceStatusPayload = {
+    browserCount: number;
+    mobileCount: number;
+    browsers: BrowserConnectionInfo[];
+    mobiles: MobileDeviceInfo[];
+};
+/** Server → Client: hub snapshot after connect/disconnect. */
+interface DeviceStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.DEVICE_STATUS;
+    payload: DeviceStatusPayload;
+}
+/** Server → Client: generic routed envelope for future features. */
+interface BroadcastMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BROADCAST;
+    payload: unknown;
+}
+type RefreshType = 'snapshot';
+type RefreshState = 'requested' | 'exporting' | 'uploading' | 'ready' | 'failed' | 'timeout';
+/** @deprecated Use RefreshState */
+type SyncState = RefreshState;
+type RefreshErrorCode = 'DEVICE_OFFLINE' | 'REFRESH_IN_PROGRESS' | 'EXPORT_FAILED' | 'UPLOAD_FAILED' | 'TIMEOUT' | 'SNAPSHOT_NOT_FOUND' | 'INVALID_REQUEST';
+/** @deprecated Use RefreshErrorCode */
+type SyncErrorCode = RefreshErrorCode;
+/** Browser → Server: request a database snapshot from a mobile device. */
+interface RefreshRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_REQUEST;
+    deviceId: string;
+    refreshType: RefreshType;
+}
+/** Server → Mobile: export database and upload via REST. */
+interface SnapshotUploadRequestedMessage extends DevToolsMessageBase {
+    type: typeof MessageType.SNAPSHOT_UPLOAD_REQUESTED;
+    deviceId: string;
+    refreshType: RefreshType;
+}
+/** Server → Browser: refresh progress update. */
+interface RefreshStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_STATUS;
+    deviceId: string;
+    state: RefreshState;
+    message?: string;
+}
+/** Server → Browser: snapshot uploaded and ready to download. */
+interface SnapshotReadyMessage extends DevToolsMessageBase {
+    type: typeof MessageType.SNAPSHOT_READY;
+    deviceId: string;
+    size: number;
+    exportedAt: number;
+    kind: string;
+    mimeType: string;
+    databaseName?: string;
+}
+/** Server → Browser: refresh failed. */
+interface RefreshErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.REFRESH_ERROR;
+    deviceId: string;
+    code: RefreshErrorCode;
+    message: string;
+}
+/** Mobile → Server: push database snapshot to the web inspector. */
+interface ExportSnapshotRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXPORT_SNAPSHOT_REQUEST;
+    refreshType: RefreshType;
+}
+/** Server → Mobile: export request failed before upload. */
+interface ExportSnapshotErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXPORT_SNAPSHOT_ERROR;
+    code: RefreshErrorCode;
+    message: string;
+}
+type RefreshInitiator = 'browser' | 'mobile';
+type TransactionStatusState = 'idle' | 'opening' | 'open' | 'committing' | 'rolling_back' | 'failed';
+type WriteErrorCode = 'DEVICE_OFFLINE' | 'NO_TRANSACTION' | 'TRANSACTION_BUSY' | 'INVALID_OPERATION' | 'WRITE_FAILED' | 'ADAPTER_ERROR' | 'TIMEOUT';
+/** Browser → Server: open a write transaction on a device. */
+interface BeginTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BEGIN_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: commit the active transaction. */
+interface CommitTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.COMMIT_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: roll back the active transaction. */
+interface RollbackTransactionRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.ROLLBACK_TRANSACTION_REQUEST;
+    transactionId: string;
+    deviceId: string;
+}
+/** Browser → Server: execute a structured write inside a transaction. */
+interface WriteRequestMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_REQUEST;
+    writeId: string;
+    transactionId: string;
+    deviceId: string;
+    operation: WriteOperation;
+}
+/** Server → Mobile: begin a transaction on the live database. */
+interface BeginTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.BEGIN_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: commit the open transaction. */
+interface CommitTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.COMMIT_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: roll back the open transaction. */
+interface RollbackTransactionMessage extends DevToolsMessageBase {
+    type: typeof MessageType.ROLLBACK_TRANSACTION;
+    transactionId: string;
+}
+/** Server → Mobile: run a structured write operation. */
+interface ExecuteWriteMessage extends DevToolsMessageBase {
+    type: typeof MessageType.EXECUTE_WRITE;
+    writeId: string;
+    transactionId: string;
+    operation: WriteOperation;
+}
+/** Mobile → Server: transaction lifecycle acknowledgement. */
+interface TransactionAckMessage extends DevToolsMessageBase {
+    type: typeof MessageType.TRANSACTION_ACK;
+    transactionId: string;
+    action: 'begin' | 'commit' | 'rollback';
+    ok: boolean;
+    message?: string;
+}
+/** Mobile → Server: write operation acknowledgement. */
+interface WriteAckMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_ACK;
+    writeId: string;
+    transactionId: string;
+    ok: boolean;
+    rowsAffected?: number;
+    message?: string;
+}
+/** Server → Browser: transaction state update. */
+interface TransactionStatusMessage extends DevToolsMessageBase {
+    type: typeof MessageType.TRANSACTION_STATUS;
+    transactionId: string;
+    deviceId: string;
+    state: TransactionStatusState;
+    message?: string;
+}
+/** Server → Browser: write succeeded. */
+interface WriteResultMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_RESULT;
+    writeId: string;
+    transactionId: string;
+    rowsAffected: number;
+}
+/** Server → Browser: write or transaction failed. */
+interface WriteErrorMessage extends DevToolsMessageBase {
+    type: typeof MessageType.WRITE_ERROR;
+    transactionId: string;
+    writeId?: string;
+    code: WriteErrorCode;
+    message: string;
+}
+type ClientMessage = RegisterMessage | PongMessage | RefreshRequestMessage | ExportSnapshotRequestMessage | BeginTransactionRequestMessage | CommitTransactionRequestMessage | RollbackTransactionRequestMessage | WriteRequestMessage | TransactionAckMessage | WriteAckMessage;
+type ServerMessage = PingMessage | DeviceStatusMessage | BroadcastMessage | SnapshotUploadRequestedMessage | RefreshStatusMessage | SnapshotReadyMessage | RefreshErrorMessage | ExportSnapshotErrorMessage | BeginTransactionMessage | CommitTransactionMessage | RollbackTransactionMessage | ExecuteWriteMessage | TransactionStatusMessage | WriteResultMessage | WriteErrorMessage;
+type DevToolsMessage = ClientMessage | ServerMessage;
+declare const DEVTOOLS_WS_PATH = "/ws";
+declare const DEFAULT_DEVTOOLS_PORT = 3847;
+declare const DEFAULT_DEVTOOLS_HOST = "0.0.0.0";
+declare const HEARTBEAT_INTERVAL_MS = 30000;
+declare const HEARTBEAT_TIMEOUT_MS = 10000;
+declare const DEVICE_SNAPSHOT_API_PATH = "/api/devices";
+declare const PROJECT_DATABASE_API_PATH = "/api/project/database";
+declare const PROJECT_DATABASE_META_API_PATH = "/api/project/database/meta";
+declare const PROJECT_DATABASES_API_PATH = "/api/project/databases";
+declare const PROJECT_DEVICE_EXPORTS_API_PATH = "/api/project/devices";
+/** @deprecated Use DEVICE_SNAPSHOT_API_PATH */
+declare const SNAPSHOT_API_PATH = "/api/devices";
+declare const REFRESH_TIMEOUT_MS = 60000;
+/** @deprecated Use REFRESH_TIMEOUT_MS */
+declare const SYNC_TIMEOUT_MS = 60000;
+declare const WRITE_TRANSACTION_TIMEOUT_MS: number;
+declare const MAX_SNAPSHOT_BYTES: number;
+declare function createMessage<T extends DevToolsMessageBase>(message: Omit<T, 'timestamp'>): T;
+declare function buildDevToolsHttpUrl(host?: string, port?: number): string;
+declare function buildDevToolsWsUrl(host?: string, port?: number): string;
+declare function buildDeviceSnapshotUrl(httpBaseUrl: string, deviceId: string): string;
+/** @deprecated Use buildDeviceSnapshotUrl */
+declare function buildSnapshotUrl(httpBaseUrl: string, deviceId: string): string;
+declare function wsUrlToHttpUrl(wsUrl: string): string;
+declare function isRegisterMessage(value: unknown): value is RegisterMessage;
+declare function isPongMessage(value: unknown): value is PongMessage;
+declare function isRefreshRequestMessage(value: unknown): value is RefreshRequestMessage;
+declare function isSnapshotUploadRequestedMessage(value: unknown): value is SnapshotUploadRequestedMessage;
+declare function isRefreshStatusMessage(value: unknown): value is RefreshStatusMessage;
+declare function isSnapshotReadyMessage(value: unknown): value is SnapshotReadyMessage;
+declare function isRefreshErrorMessage(value: unknown): value is RefreshErrorMessage;
+declare function isExportSnapshotRequestMessage(value: unknown): value is ExportSnapshotRequestMessage;
+declare function isExportSnapshotErrorMessage(value: unknown): value is ExportSnapshotErrorMessage;
+declare function isBeginTransactionRequestMessage(value: unknown): value is BeginTransactionRequestMessage;
+declare function isCommitTransactionRequestMessage(value: unknown): value is CommitTransactionRequestMessage;
+declare function isRollbackTransactionRequestMessage(value: unknown): value is RollbackTransactionRequestMessage;
+declare function isWriteRequestMessage(value: unknown): value is WriteRequestMessage;
+declare function isTransactionAckMessage(value: unknown): value is TransactionAckMessage;
+declare function isWriteAckMessage(value: unknown): value is WriteAckMessage;
+declare function isClientMessage(value: unknown): value is ClientMessage;
+declare function isPingMessage(value: unknown): value is PingMessage;
+declare function isDeviceStatusMessage(value: unknown): value is DeviceStatusMessage;
+declare function isBroadcastMessage(value: unknown): value is BroadcastMessage;
+declare function isBeginTransactionMessage(value: unknown): value is BeginTransactionMessage;
+declare function isCommitTransactionMessage(value: unknown): value is CommitTransactionMessage;
+declare function isRollbackTransactionMessage(value: unknown): value is RollbackTransactionMessage;
+declare function isExecuteWriteMessage(value: unknown): value is ExecuteWriteMessage;
+declare function isTransactionStatusMessage(value: unknown): value is TransactionStatusMessage;
+declare function isWriteResultMessage(value: unknown): value is WriteResultMessage;
+declare function isWriteErrorMessage(value: unknown): value is WriteErrorMessage;
+declare function isServerMessage(value: unknown): value is ServerMessage;
+
+export { type BeginTransactionMessage, type BeginTransactionRequestMessage, type BroadcastMessage, type BrowserConnectionInfo, type ClientMessage, type CommitTransactionMessage, type CommitTransactionRequestMessage, DEFAULT_DEVTOOLS_HOST, DEFAULT_DEVTOOLS_PORT, DEVICE_SNAPSHOT_API_PATH, DEVTOOLS_WS_PATH, type DevToolsMessage, type DevToolsMessageBase, DevToolsRole, type DeviceMetadata, type DeviceStatusMessage, type DeviceStatusPayload, type ExecuteWriteMessage, type ExportSnapshotErrorMessage, type ExportSnapshotRequestMessage, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, MAX_SNAPSHOT_BYTES, MessageType, type MessageTypeValue, type MobileDeviceInfo, PROJECT_DATABASES_API_PATH, PROJECT_DATABASE_API_PATH, PROJECT_DATABASE_META_API_PATH, PROJECT_DEVICE_EXPORTS_API_PATH, type PingMessage, type PongMessage, REFRESH_TIMEOUT_MS, type RefreshErrorCode, type RefreshErrorMessage, type RefreshInitiator, type RefreshRequestMessage, type RefreshState, type RefreshStatusMessage, type RefreshType, type RegisterMessage, type RollbackTransactionMessage, type RollbackTransactionRequestMessage, SNAPSHOT_API_PATH, SYNC_TIMEOUT_MS, type ServerMessage, type SnapshotReadyMessage, type SnapshotUploadRequestedMessage, type SyncErrorCode, type SyncState, type TransactionAckMessage, type TransactionStatusMessage, type TransactionStatusState, WRITE_TRANSACTION_TIMEOUT_MS, type WriteAckMessage, type WriteErrorCode, type WriteErrorMessage, type WriteRequestMessage, type WriteResultMessage, buildDevToolsHttpUrl, buildDevToolsWsUrl, buildDeviceSnapshotUrl, buildSnapshotUrl, createMessage, isBeginTransactionMessage, isBeginTransactionRequestMessage, isBroadcastMessage, isClientMessage, isCommitTransactionMessage, isCommitTransactionRequestMessage, isDeviceStatusMessage, isExecuteWriteMessage, isExportSnapshotErrorMessage, isExportSnapshotRequestMessage, isPingMessage, isPongMessage, isRefreshErrorMessage, isRefreshRequestMessage, isRefreshStatusMessage, isRegisterMessage, isRollbackTransactionMessage, isRollbackTransactionRequestMessage, isServerMessage, isSnapshotReadyMessage, isSnapshotUploadRequestedMessage, isTransactionAckMessage, isTransactionStatusMessage, isWriteAckMessage, isWriteErrorMessage, isWriteRequestMessage, isWriteResultMessage, wsUrlToHttpUrl };

package/dist/types/protocol.js

@@ -0,0 +1,4 @@
+export { DEFAULT_DEVTOOLS_HOST, DEFAULT_DEVTOOLS_PORT, DEVICE_SNAPSHOT_API_PATH, DEVTOOLS_WS_PATH, DevToolsRole, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, MAX_SNAPSHOT_BYTES, MessageType, PROJECT_DATABASES_API_PATH, PROJECT_DATABASE_API_PATH, PROJECT_DATABASE_META_API_PATH, PROJECT_DEVICE_EXPORTS_API_PATH, REFRESH_TIMEOUT_MS, SNAPSHOT_API_PATH, SYNC_TIMEOUT_MS, WRITE_TRANSACTION_TIMEOUT_MS, buildDevToolsHttpUrl, buildDevToolsWsUrl, buildDeviceSnapshotUrl, buildSnapshotUrl, createMessage, isBeginTransactionMessage, isBeginTransactionRequestMessage, isBroadcastMessage, isClientMessage, isCommitTransactionMessage, isCommitTransactionRequestMessage, isDeviceStatusMessage, isExecuteWriteMessage, isExportSnapshotErrorMessage, isExportSnapshotRequestMessage, isPingMessage, isPongMessage, isRefreshErrorMessage, isRefreshRequestMessage, isRefreshStatusMessage, isRegisterMessage, isRollbackTransactionMessage, isRollbackTransactionRequestMessage, isServerMessage, isSnapshotReadyMessage, isSnapshotUploadRequestedMessage, isTransactionAckMessage, isTransactionStatusMessage, isWriteAckMessage, isWriteErrorMessage, isWriteRequestMessage, isWriteResultMessage, wsUrlToHttpUrl } from '../chunk-CPVVIH5G.js';
+import '../chunk-DGUM43GV.js';
+//# sourceMappingURL=protocol.js.map
+//# sourceMappingURL=protocol.js.map

package/dist/types/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"protocol.js"}

package/dist/types-BRLJdBRY.d.cts

@@ -0,0 +1,16 @@
+import { D as DatabaseAdapter } from './adapter-BjJm71wW.cjs';
+import { D as DatabaseKind } from './snapshot-Dhyecgo2.cjs';
+
+type AdapterDefinition = {
+    kind: DatabaseKind;
+    displayName: string;
+    priority: number;
+    detect: (database: unknown) => boolean;
+    create: (database: unknown) => DatabaseAdapter | Promise<DatabaseAdapter>;
+};
+type ResolveAdapterOptions = {
+    adapter?: DatabaseAdapter;
+    type?: DatabaseKind;
+};
+
+export type { AdapterDefinition as A, ResolveAdapterOptions as R };

package/dist/types-CF6qEU-_.d.ts

@@ -0,0 +1,16 @@
+import { D as DatabaseAdapter } from './adapter-DJSjDewg.js';
+import { D as DatabaseKind } from './snapshot-Dhyecgo2.js';
+
+type AdapterDefinition = {
+    kind: DatabaseKind;
+    displayName: string;
+    priority: number;
+    detect: (database: unknown) => boolean;
+    create: (database: unknown) => DatabaseAdapter | Promise<DatabaseAdapter>;
+};
+type ResolveAdapterOptions = {
+    adapter?: DatabaseAdapter;
+    type?: DatabaseKind;
+};
+
+export type { AdapterDefinition as A, ResolveAdapterOptions as R };