@useragent-kit/sdk 0.0.0 → 0.0.1

package/dist/errors.js

@@ -0,0 +1,41 @@
+/**
+ * Canonical JavaScript error codes for the product-facing host bridge.
+ *
+ * Public callers should prefer matching on `error.code` when present and
+ * continue treating `error.message` as the backward-compatible fallback.
+ */
+export class HostError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = "HostError";
+        this.code = code;
+    }
+}
+export function isHostError(error) {
+    return error instanceof HostError;
+}
+export function bridgeDestroyedError() {
+    return new HostError("ERR_BRIDGE_DESTROYED", "Bridge has been destroyed");
+}
+export function rateLimitError(operation, maxCalls, windowMs) {
+    return new HostError("ERR_RATE_LIMIT", `Rate limit exceeded: max ${maxCalls} ${operation} per ${windowMs / 1000}s`);
+}
+export function unsupportedCapabilityError(capability) {
+    return new HostError("ERR_UNSUPPORTED_CAPABILITY", `${capability} is not supported by this host`);
+}
+export function hostRuntimeUnavailableError(subject) {
+    return new HostError("ERR_HOST_RUNTIME_UNAVAILABLE", `${subject} not available. Are you running inside a host webview?`);
+}
+export function binaryBridgeUnavailableError() {
+    return new HostError("ERR_BINARY_BRIDGE_UNAVAILABLE", "Host binary bridge not available. Are you running inside a host webview?");
+}
+export function invalidArgumentError(message) {
+    return new HostError("ERR_INVALID_ARGUMENT", message);
+}
+export function timeoutError(message) {
+    return new HostError("ERR_TIMEOUT", message);
+}
+export function hostRejectedError(message) {
+    return new HostError("ERR_HOST_REJECTED", message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGlC,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,SAAS,CAAC,sBAAsB,EAAE,2BAA2B,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB,EAAE,QAAgB;IAClF,OAAO,IAAI,SAAS,CAClB,gBAAgB,EAChB,4BAA4B,QAAQ,IAAI,SAAS,QAAQ,QAAQ,GAAG,IAAI,GAAG,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC3D,OAAO,IAAI,SAAS,CAAC,4BAA4B,EAAE,GAAG,UAAU,gCAAgC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,OAAO,IAAI,SAAS,CAClB,8BAA8B,EAC9B,GAAG,OAAO,wDAAwD,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,SAAS,CAClB,+BAA+B,EAC/B,0EAA0E,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,IAAI,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Canonical event names and payload types for `__hostPush` events.
+ *
+ * These are the canonical JS event names and payload shapes for products.
+ * Rust hosts should keep their event definitions aligned with these shared
+ * names and field shapes.
+ *
+ * @example
+ * ```ts
+ * import { DATA_CONNECTED, type DataConnectedPayload } from "@paritytech/host-sdk";
+ *
+ * host.on(DATA_CONNECTED, (payload: DataConnectedPayload) => {
+ *   console.log(`Connected to ${payload.peer} on conn ${payload.connId}`);
+ * });
+ * ```
+ */
+export declare const DATA_CONNECTED: "dataConnected";
+export declare const DATA_MESSAGE: "dataMessage";
+export declare const DATA_BINARY: "dataBinary";
+export declare const DATA_CLOSED: "dataClosed";
+export declare const DATA_ERROR: "dataError";
+export declare const DATA_INCOMING_CALL: "dataIncomingCall";
+export interface DataConnectedPayload {
+    connId: number;
+    peer: string;
+}
+export interface DataMessagePayload {
+    connId: number;
+    data: string;
+}
+export interface DataBinaryPayload {
+    connId: number;
+    dataBase64: string;
+}
+export interface DataClosedPayload {
+    connId: number;
+    reason: string;
+}
+export interface DataErrorPayload {
+    connId: number;
+    error: string;
+}
+export interface DataIncomingCallPayload {
+    connId: number;
+    peer: string;
+}
+export declare const MEDIA_TRACK_READY: "mediaTrackReady";
+export declare const MEDIA_CONNECTED: "mediaConnected";
+export declare const MEDIA_REMOTE_TRACK: "mediaRemoteTrack";
+export declare const MEDIA_CLOSED: "mediaClosed";
+export declare const MEDIA_ERROR: "mediaError";
+export declare const MEDIA_INCOMING_CALL: "mediaIncomingCall";
+export declare const MEDIA_SIGNALING_PROGRESS: "mediaSignalingProgress";
+export declare const MEDIA_TRACK_STOPPED: "mediaTrackStopped";
+export declare const MEDIA_CALL_STATE_CHANGED: "mediaCallStateChanged";
+export interface MediaTrackReadyPayload {
+    trackId: number;
+    kind: string;
+}
+export interface MediaConnectedPayload {
+    sessionId: number;
+    peer: string;
+}
+export interface MediaRemoteTrackPayload {
+    sessionId: number;
+    trackId: number;
+    kind: string;
+}
+export interface MediaClosedPayload {
+    sessionId: number;
+    reason: string;
+}
+export interface MediaErrorPayload {
+    sessionId: number;
+    error: string;
+}
+export interface MediaIncomingCallPayload {
+    peer: string;
+    peerAddress?: string;
+    groupId?: string;
+    groupSize?: number;
+}
+export interface MediaSignalingProgressPayload {
+    sessionId: number;
+    stage: string;
+}
+export interface MediaTrackStoppedPayload {
+    trackId: number;
+    kind: string;
+    sessionId: number;
+}
+/** Call lifecycle state. */
+export type CallStateLabel = "idle" | "ringing" | "connecting" | "connected" | "reconnecting" | "ended";
+/** Payload for `mediaCallStateChanged` events. */
+export interface MediaCallStateChangedPayload {
+    sessionId: number;
+    /** Current call state. */
+    state: CallStateLabel;
+    /** Remote peer identifier. */
+    peer: string;
+    /** Call direction: "outgoing" or "incoming". */
+    direction: "outgoing" | "incoming";
+    /** Reason the call ended (only present when `state === "ended"`). */
+    reason?: string;
+}
+export declare const STATEMENT: "statement";
+/**
+ * Payload delivered to `host.on("statement", ...)`.
+ *
+ * `timestampMs` is the statement-store timestamp in milliseconds since the Unix
+ * epoch. Older bridge adapters may fall back to local receive time when the
+ * upstream transport does not preserve the store timestamp yet.
+ */
+export interface StatementEventPayload {
+    author: string | undefined;
+    channel: string;
+    data: string;
+    timestampMs: number;
+}
+export declare const MESH_TOPIC: "meshTopic";
+export declare const MESH_QUERY: "meshQuery";
+export declare const MESH_REPLY: "meshReply";
+export declare const MESH_SCOPED_QUERY: "meshScopedQuery";
+export declare const MESH_SCOPED_REPLY: "meshScopedReply";
+export declare const MESH_PRESENCE: "meshPresence";
+export declare const MESH_HEARTBEAT: "meshHeartbeat";
+export declare const MESH_PRIVATE_CONTROL: "meshPrivateControl";
+export declare const MESH_PRIVATE_RECEIPT: "meshPrivateReceipt";
+export declare const CRDT_REMOTE_UPDATE: "crdtRemoteUpdate";
+export declare const CRDT_AWARENESS: "crdtAwareness";
+export declare const CRDT_PEER_CHANGE: "crdtPeerChange";
+export interface MeshTopicPayload {
+    topic: string;
+    dataBase64: string;
+    author?: string;
+}
+export interface MeshQueryPayload {
+    requestId: string;
+    path: string;
+    dataBase64: string;
+    author?: string;
+}
+export type MeshObjectReadReason = "expired" | "not_found" | "policy_denied";
+export type MeshOpaqueHandle = string;
+export type MeshCapability = string;
+export interface MeshObjectPolicy {
+    expiresAtMs?: number;
+    suppressPreviews?: boolean;
+}
+export interface MeshObjectResult {
+    dataBase64: string | null;
+    reason?: MeshObjectReadReason;
+    expiresAtMs?: number;
+}
+export interface MeshPrivateObjectRef {
+    handle: MeshOpaqueHandle;
+    capability: MeshCapability;
+    expiresAtMs?: number;
+}
+export interface MeshControlEnvelope {
+    mode: "visible" | "encrypted";
+    dataBase64: string;
+}
+export interface MeshReplyPayload {
+    requestId: string;
+    dataBase64: string | null;
+    reason?: MeshObjectReadReason;
+    expiresAtMs?: number;
+    author?: string;
+}
+export interface MeshScopedQueryPayload {
+    requestId: string;
+    requesterId: string;
+    path: string;
+    dataBase64: string;
+    capabilityId: string;
+    pathPrefix: string;
+    targetId: string;
+    expiresAtMs: number;
+    maxUses: number;
+    author?: string;
+}
+export interface MeshScopedReplyPayload {
+    requestId: string;
+    responderId: string;
+    dataBase64: string;
+    capabilityId: string;
+    author?: string;
+}
+export interface MeshPresencePayload {
+    peerId: string;
+    state: string;
+}
+export interface MeshHeartbeatPayload {
+    streamId: string;
+    authorId: string;
+    earliestRetainedSeq: number;
+    latestAvailableSeq: number;
+}
+export interface MeshPrivateControlPayload {
+    capability: MeshCapability;
+    envelope: MeshControlEnvelope;
+    author?: string;
+}
+export interface MeshPrivateReceiptPayload {
+    capability: MeshCapability;
+    dataBase64: string;
+    author?: string;
+}
+export interface CrdtJoinResult {
+    roomId: string;
+    transport: string;
+}
+export declare const INDEX_EVENT: "indexEvent";
+export declare const INDEX_SYNC_PROGRESS: "indexSyncProgress";
+export declare const INDEX_SCAN_COMPLETED: "indexScanCompleted";
+export interface IndexEventPayload {
+    alias: string;
+    eventName: string;
+    blockNumber: number;
+    blockHash: string;
+    logIndex: number;
+    data: unknown;
+    topics: string[];
+    timestampMs?: number;
+}
+export interface IndexSyncProgressPayload {
+    alias: string;
+    direction: "forward" | "backward";
+    currentBlock: number;
+    targetBlock: number;
+}
+export interface IndexScanCompletedPayload {
+    alias: string;
+    direction: "forward" | "backward";
+    finalBlock: number;
+    reason: string;
+}
+export interface CrdtRemoteUpdatePayload {
+    roomId: string;
+    updateBase64: string;
+}
+export interface CrdtAwarenessPayload {
+    roomId: string;
+    clientId: number;
+    state: string;
+}
+export interface CrdtPeerChangePayload {
+    roomId: string;
+    peers: string[];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,54 @@
+/**
+ * Canonical event names and payload types for `__hostPush` events.
+ *
+ * These are the canonical JS event names and payload shapes for products.
+ * Rust hosts should keep their event definitions aligned with these shared
+ * names and field shapes.
+ *
+ * @example
+ * ```ts
+ * import { DATA_CONNECTED, type DataConnectedPayload } from "@paritytech/host-sdk";
+ *
+ * host.on(DATA_CONNECTED, (payload: DataConnectedPayload) => {
+ *   console.log(`Connected to ${payload.peer} on conn ${payload.connId}`);
+ * });
+ * ```
+ */
+// ── Data events ─────────────────────────────────────────────────────────
+export const DATA_CONNECTED = "dataConnected";
+export const DATA_MESSAGE = "dataMessage";
+export const DATA_BINARY = "dataBinary";
+export const DATA_CLOSED = "dataClosed";
+export const DATA_ERROR = "dataError";
+export const DATA_INCOMING_CALL = "dataIncomingCall";
+// ── Media events ────────────────────────────────────────────────────────
+export const MEDIA_TRACK_READY = "mediaTrackReady";
+export const MEDIA_CONNECTED = "mediaConnected";
+export const MEDIA_REMOTE_TRACK = "mediaRemoteTrack";
+export const MEDIA_CLOSED = "mediaClosed";
+export const MEDIA_ERROR = "mediaError";
+export const MEDIA_INCOMING_CALL = "mediaIncomingCall";
+export const MEDIA_SIGNALING_PROGRESS = "mediaSignalingProgress";
+export const MEDIA_TRACK_STOPPED = "mediaTrackStopped";
+export const MEDIA_CALL_STATE_CHANGED = "mediaCallStateChanged";
+// ── Statement events ────────────────────────────────────────────────────
+export const STATEMENT = "statement";
+// ── Mesh events ─────────────────────────────────────────────────────────
+export const MESH_TOPIC = "meshTopic";
+export const MESH_QUERY = "meshQuery";
+export const MESH_REPLY = "meshReply";
+export const MESH_SCOPED_QUERY = "meshScopedQuery";
+export const MESH_SCOPED_REPLY = "meshScopedReply";
+export const MESH_PRESENCE = "meshPresence";
+export const MESH_HEARTBEAT = "meshHeartbeat";
+export const MESH_PRIVATE_CONTROL = "meshPrivateControl";
+export const MESH_PRIVATE_RECEIPT = "meshPrivateReceipt";
+// ── CRDT events ────────────────────────────────────────────────────────
+export const CRDT_REMOTE_UPDATE = "crdtRemoteUpdate";
+export const CRDT_AWARENESS = "crdtAwareness";
+export const CRDT_PEER_CHANGE = "crdtPeerChange";
+// ── Index events ───────────────────────────────────────────────────────
+export const INDEX_EVENT = "indexEvent";
+export const INDEX_SYNC_PROGRESS = "indexSyncProgress";
+export const INDEX_SCAN_COMPLETED = "indexScanCompleted";
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAE3E,MAAM,CAAC,MAAM,cAAc,GAAG,eAAwB,CAAC;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,aAAsB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAqB,CAAC;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAqB,CAAC;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,WAAoB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAA2B,CAAC;AAgC9D,2EAA2E;AAE3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAyB,CAAC;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,aAAsB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAqB,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAiC,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAgC,CAAC;AAoEzE,2EAA2E;AAE3E,MAAM,CAAC,MAAM,SAAS,GAAG,WAAoB,CAAC;AAgB9C,2EAA2E;AAE3E,MAAM,CAAC,MAAM,UAAU,GAAG,WAAoB,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,WAAoB,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,WAAoB,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,cAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,eAAwB,CAAC;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAA6B,CAAC;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAA6B,CAAC;AAElE,0EAA0E;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,eAAwB,CAAC;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAyB,CAAC;AAkG1D,0EAA0E;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,YAAqB,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAA6B,CAAC"}

package/dist/experimental/file-transfer.d.ts

@@ -0,0 +1,97 @@
+import { type FileTransferTransport } from "./transport.js";
+export interface FileOffer {
+    id: string;
+    name: string;
+    size: number;
+    mime: string;
+    hashAlgo?: string;
+    hashHex?: string;
+}
+export type DataEventType = {
+    type: "connected";
+    connId: number;
+    peer: string;
+} | {
+    type: "fileOffer";
+    offer: FileOffer;
+    connId: number;
+} | {
+    type: "fileCanceled";
+    id: string;
+    name: string;
+    reason: string;
+} | {
+    type: "sendPending";
+    id: string;
+    name: string;
+    size: number;
+} | {
+    type: "sendAccepted";
+    id: string;
+    name: string;
+} | {
+    type: "sendAwaitingAck";
+    id: string;
+    name: string;
+} | {
+    type: "sendRejected";
+    id: string;
+    name: string;
+    reason: string;
+} | {
+    type: "fileRepairing";
+    id: string;
+    name: string;
+    missing: number;
+    slowNetwork: boolean;
+} | {
+    type: "fileProgress";
+    id: string;
+    received: number;
+    total: number;
+    bytesPerSecond: number;
+    slowNetwork: boolean;
+} | {
+    type: "fileComplete";
+    id: string;
+    name: string;
+    blob: Blob;
+} | {
+    type: "sendProgress";
+    id: string;
+    name: string;
+    sent: number;
+    total: number;
+    bytesPerSecond: number;
+    slowNetwork: boolean;
+} | {
+    type: "sendComplete";
+    id: string;
+    name: string;
+} | {
+    type: "closed";
+    reason: string;
+} | {
+    type: "error";
+    message: string;
+};
+type DataEventCallback = (event: DataEventType) => void;
+export declare function onDataEvent(cb: DataEventCallback): void;
+export declare function setFileTransferTransport(transport: FileTransferTransport | null): void;
+export declare function getFileTransferTransport(): FileTransferTransport | null;
+/** Open a data connection to a peer. Resolves only when the dataConnected event fires.
+ *  If a connect attempt is already in flight, returns the existing promise. */
+export declare function connectData(peerAddress: string): Promise<void>;
+/** Start listening for incoming data connections at the given address. */
+export declare function startDataListening(address: string): Promise<void>;
+/** Wire up host data events. Call once on boot. */
+export declare function initDataEvents(): void;
+/** Close the data connection. */
+export declare function closeData(): Promise<void>;
+export declare function isConnected(): boolean;
+export declare function sendFile(file: File): Promise<void>;
+export declare function acceptFileOffer(id: string): Promise<void>;
+export declare function rejectFileOffer(id: string, reason?: string): Promise<void>;
+export declare function cancelFileTransfer(id: string, reason?: string): Promise<void>;
+export {};
+//# sourceMappingURL=file-transfer.d.ts.map

package/dist/experimental/file-transfer.d.ts.map

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