@dxos/protocols 0.8.4-main.dedc0f3 → 0.8.4-main.e00bdcdb52

package/dist/src/buf/proto/gen/dxos/value_pb.d.ts

@@ -1,4 +1,4 @@
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file dxos/value.proto.

package/dist/src/buf/proto/gen/dxos/value_pb.js

@@ -1,7 +1,7 @@
 //
 // Copyright 2021 DXOS.org
 //
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 /**
  * Describes the file dxos/value.proto.
  */

package/dist/src/buf/proto/gen/example/testing/data_pb.d.ts

@@ -1,4 +1,4 @@
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file example/testing/data.proto.

package/dist/src/buf/proto/gen/example/testing/data_pb.js

@@ -1,7 +1,7 @@
 //
 // Copyright 2020 DXOS.org
 //
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 /**
  * Describes the file example/testing/data.proto.
  */

package/dist/src/buf/proto/gen/example/testing/rpc_pb.d.ts

@@ -1,4 +1,4 @@
-import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
 import type { Any, EmptySchema } from "@bufbuild/protobuf/wkt";
 import type { Message } from "@bufbuild/protobuf";
 /**

package/dist/src/buf/proto/gen/example/testing/rpc_pb.js

@@ -1,7 +1,7 @@
 //
 // Copyright 2020 DXOS.org
 //
-import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_any, file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file example/testing/rpc.proto.

package/dist/src/edge/EdgeFunctionEnv.d.ts

@@ -0,0 +1,108 @@
+import { type SpaceId } from '@dxos/keys';
+import type * as FeedProtocol from '../FeedProtocol';
+import { type QueryRequest, type QueryResponse } from '../proto/gen/dxos/echo/query';
+import { type CreateDocumentResponse } from '../proto/gen/dxos/echo/service';
+/**
+ * Environment available to the function running on Cloudflare.
+ */
+export interface Env {
+    QUEUE_SERVICE: QueueService;
+    DATA_SERVICE: DataService;
+    FUNCTIONS_AI_SERVICE: FunctionsAiService;
+}
+/**
+ * Use to trace the execution across multiple services.
+ *
+ * NOTE: Currently unused in functions.
+ */
+export interface TraceContext {
+}
+/**
+ * Database API for other CF services like functions.
+ */
+export interface DataService {
+    getSpaceMeta(ctx: TraceContext, spaceId: SpaceId): Promise<RpcResult<SpaceMeta | undefined>>;
+    getDocument(ctx: TraceContext, spaceId: SpaceId, documentId: string): Promise<RpcResult<RawDocument | undefined>>;
+    execQuery(ctx: TraceContext, request: QueryRequest): Promise<RpcResult<QueryResponse>>;
+    createDocument(ctx: TraceContext, spaceId: SpaceId, initialValue?: Record<string, any>): Promise<RpcResult<CreateDocumentResponse>>;
+    changeDocument(ctx: TraceContext, spaceId: SpaceId, documentId: string, changes: Uint8Array): Promise<void>;
+}
+export interface QueueService {
+    queryQueue: (ctx: TraceContext, request: FeedProtocol.QueryQueueRequest) => Promise<RpcResult<FeedProtocol.QueryResult>>;
+    insertIntoQueue: (ctx: TraceContext, request: FeedProtocol.InsertIntoQueueRequest) => Promise<RpcResult<RpcDisposable>>;
+    deleteFromQueue: (ctx: TraceContext, request: FeedProtocol.DeleteFromQueueRequest) => Promise<RpcResult<RpcDisposable>>;
+}
+/**
+ * FunctionsAiService API for other CF services like functions.
+ */
+export interface FunctionsAiService {
+    /**
+     * Enables proxying HTTP requests to the AI service from other workers.
+     */
+    fetch(request: Request): Promise<RpcResult<Response>>;
+}
+export type ObjectDocumentJson = {
+    type?: string;
+    objectId: string;
+    documentId: string;
+    /** Base64 encoding of a document. */
+    document: string;
+};
+export type SpaceMeta = {
+    spaceKey: string;
+    rootDocumentId: string;
+};
+/**
+ * TODO(yaroslav): make Indexer return EchoObject after create() can properly reconstruct an object
+ *   from this structure (meta, id and type aren't handled properly)
+ */
+export type ObjectSnapshot = {
+    type?: string;
+    documentId: string;
+    objectId: string;
+    object: unknown;
+};
+export type ObjectReference = {
+    fromId: string;
+    toId: string;
+    fieldName: string;
+};
+export type QueryDocumentsResponse = {
+    results: RawObject[];
+    cursor?: string;
+};
+export type RawDocument = {
+    documentId: string;
+    data: Uint8Array;
+};
+export type RawObject = {
+    type?: string;
+    objectId: string;
+    document: RawDocument;
+};
+export type QueryReferencesRequest = {
+    spaceId: string;
+    objectId: string;
+    referenceType: 'from' | 'to';
+};
+export type QueryReferencesResponse = {
+    references: ObjectReference[];
+};
+/**
+ * Cloudflare Workers RPC returns objects/arrays/stubs that may need to be explicitly disposed.
+ *
+ * See: https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/
+ */
+export interface RpcDisposable {
+    /**
+     * Disposes the RPC stub / returned value and releases any server-side resources it references.
+     */
+    [Symbol.dispose](): void;
+}
+/**
+ * Wraps a return type so that any non-primitive value is marked as disposable.
+ *
+ * This models Workers RPC behavior where any returned object (including arrays) gets a disposer added.
+ */
+export type RpcResult<T> = T extends object ? T & RpcDisposable : T;
+//# sourceMappingURL=EdgeFunctionEnv.d.ts.map

package/dist/src/edge/EdgeFunctionEnv.d.ts.map

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

package/dist/src/edge/EdgeFunctionEnv.js

@@ -0,0 +1,4 @@
+//
+// Copyright 2025 DXOS.org
+//
+//# sourceMappingURL=EdgeFunctionEnv.js.map

package/dist/src/edge/EdgeFunctionEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeFunctionEnv.js","sourceRoot":"","sources":["../../../src/edge/EdgeFunctionEnv.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE"}

package/dist/src/edge/edge.d.ts

@@ -0,0 +1,517 @@
+import * as Schema from 'effect/Schema';
+import { SpaceId } from '@dxos/keys';
+/**
+ * HTTP header sent on every Edge request to classify traffic for metering.
+ */
+export declare const EDGE_CLIENT_TAG_HEADER = "X-DXOS-Client-Tag";
+export declare enum EdgeService {
+    AUTOMERGE_REPLICATOR = "automerge-replicator",
+    /**
+     * Control feed replicator (hypercore append only logs) for the space.
+     */
+    FEED_REPLICATOR = "feed-replicator",
+    /**
+     * Feed replicator (ordered data list) for the space.
+     */
+    QUEUE_REPLICATOR = "queue-replicator",
+    SWARM = "swarm",
+    SIGNAL = "signal",
+    STATUS = "status"
+}
+export type EdgeSuccess<T> = {
+    success: true;
+    data: T;
+};
+declare const _SerializedError: Schema.Struct<{
+    name: Schema.optional<typeof Schema.String>;
+    message: Schema.optional<typeof Schema.String>;
+    context: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Any>>;
+    stack: Schema.optional<typeof Schema.String>;
+    cause: Schema.optional<Schema.suspend<SerializedError, SerializedError, never>>;
+}>;
+export interface SerializedError extends Schema.Schema.Type<typeof _SerializedError> {
+}
+export declare const SerializedError: Schema.Schema<SerializedError, SerializedError, never>;
+export type EdgeErrorData = {
+    type: string;
+} & Record<string, any>;
+/**
+ * This is the shape of the error response from the Edge service,
+ * when the error is gracefully handled, the Response will be an object with this shape and have status code 200.
+ */
+export type EdgeFailure = {
+    /**
+     * Branded Type.
+     */
+    success: false;
+    /**
+     * An explanation of why the call failed. Used mostly for logging and monitoring.
+     */
+    message: string;
+    /**
+     * Cause Error captured on the EDGE service to aid debugging on the client.
+     */
+    error?: SerializedError;
+    /**
+     * Information that can be used to retry the request such that it will succeed, for example:
+     * 1. { type: 'auth_required', challenge: string }
+     *    Requires retrying the request with challenge signature included.
+     * 2. { type: 'user_confirmation_required', dialog: { title: string, message: string, confirmation_payload: string } }
+     *    Requires showing a confirmation dialog to a user and retrying the request with confirmation_payload included
+     *    if the user confirms.
+     * When data is returned simply retrying the request won't have any effect.
+     * EdgeHttpClient should parse well-known data into Error types and throw.
+     */
+    data?: EdgeErrorData;
+};
+/**
+ * Represents a body response from the Edge service.
+ */
+export type EdgeEnvelope<T> = EdgeSuccess<T> | EdgeFailure;
+/**
+ * Use this to create a response from the Edge service.
+ */
+export declare const EdgeResponse: Readonly<{
+    success: <T>(data: T, status?: number) => Response;
+    failure: ({ message, error, errorEncoded, data, shouldRetryAfter, status, }: {
+        /**
+         * An explanation of why the call failed. Used mostly for logging and monitoring.
+         */
+        message: string;
+        /**
+         * Error that caused the failure.
+         * Useful for debugging.
+         *
+         * Use only one of the fields `error` or `errorEncoded`.s
+         */
+        error?: Error;
+        /**
+         * Encoded Error that caused the failure.
+         * Useful for debugging.
+         *
+         * Use only one of the fields `error` or `errorEncoded`.
+         */
+        errorEncoded?: SerializedError;
+        /**
+         * Information that can be used to retry the request such that it will succeed, for example:
+         * 1. { type: 'auth_required', challenge: string }
+         *    Requires retrying the request with challenge signature included.
+         * 2. { type: 'user_confirmation_required', dialog: { title: string, message: string, confirmation_payload: string } }
+         *    Requires showing a confirmation dialog to a user and retrying the request with confirmation_payload included
+         *    if the user confirms.
+         * When data is returned simply retrying the request won't have any effect.
+         * EdgeHttpClient should parse well-known data into Error types and throw.
+         */
+        data?: EdgeErrorData;
+        /**
+         * If provided, this request will be marked as retryable and the client will wait for the specified number of milliseconds before retrying.
+         * If not provided, the client will not retry the request.
+         */
+        shouldRetryAfter?: number;
+        /**
+         * Status code of the response.
+         * @default 500
+         */
+        status?: number;
+    }) => Response;
+}>;
+export type GetNotarizationResponseBody = {
+    awaitingNotarization: {
+        credentials: string[];
+    };
+};
+export type ExecuteWorkflowResponseBody = {
+    success: boolean;
+    reason?: string;
+    output?: any;
+};
+export type PostNotarizationRequestBody = {
+    credentials: string[];
+};
+export type JoinSpaceRequest = {
+    invitationId: string;
+    identityKey: string;
+    /**
+     * Base64 encoded signed challenge.
+     * Used to verify the IdentityKey in case of `invitation.authMethod === Invitation.AuthMethod.KNOWN_PUBLIC_KEY`
+     */
+    signature?: string;
+};
+export type JoinSpaceResponseBody = {
+    spaceMemberCredential: string;
+    spaceGenesisFeedKey: string;
+};
+export type RecoverIdentitySignature = string | {
+    signature: string;
+    clientDataJson: string;
+    authenticatorData: string;
+};
+export type RecoverIdentityRequest = {
+    deviceKey: string;
+    controlFeedKey: string;
+    lookupKey?: string;
+    signature?: RecoverIdentitySignature;
+    token?: string;
+};
+export type RecoverIdentityResponseBody = {
+    identityKey: string;
+    haloSpaceKey: string;
+    genesisFeedKey: string;
+    deviceAuthCredential: string;
+};
+export type CreateAgentRequestBody = {
+    identityKey: string;
+    haloSpaceId: SpaceId;
+    haloSpaceKey: string;
+};
+export type CreateAgentResponseBody = {
+    deviceKey: string;
+    feedKey: string;
+};
+export type GetAgentStatusResponseBody = {
+    agent: {
+        deviceKey?: string;
+        status: EdgeAgentStatus;
+    };
+};
+export type UploadFunctionRequest = {
+    name?: string;
+    version: string;
+    ownerPublicKey: string;
+    entryPoint: string;
+    assets: Record<string, Uint8Array>;
+    /**
+     * Runtime in Edge that will be used to run the function.
+     * Runtime cannot be changed once the function was deployed.
+     * @default Runtime.WORKERS_FOR_PLATFORMS
+     */
+    runtime?: FunctionRuntimeKind;
+};
+/**
+ * Note: Do not change the values of these enums, this values are stored in the FunctionVersions database.
+ */
+export declare const FunctionRuntimeKind: Schema.Enums<{
+    WORKERS_FOR_PLATFORMS: string;
+    WORKER_LOADER: string;
+}>;
+export type FunctionRuntimeKind = Schema.Schema.Type<typeof FunctionRuntimeKind>;
+export type UploadFunctionResponseBody = {
+    functionId: string;
+    version: string;
+    meta: {
+        key?: string;
+        name?: string;
+        description?: string;
+        /**
+         * JSON Schema for the input of the function.
+         */
+        inputSchema?: object;
+        /**
+         * JSON Schema for the output of the function.
+         */
+        outputSchema?: object;
+    };
+};
+export type CreateSpaceRequest = {
+    /**
+     * HEX encoded public key of the agent.
+     */
+    agentKey: string;
+};
+export type CreateSpaceResponseBody = {
+    /**
+     * HEX encoded public key of the space.
+     */
+    spaceKey: string;
+    spaceId: SpaceId;
+    automergeRoot: string;
+};
+export declare enum EdgeAgentStatus {
+    ACTIVE = "active",
+    INACTIVE = "inactive",
+    NOT_FOUND = "not_found"
+}
+export type EdgeAuthChallenge = {
+    type: 'auth_challenge';
+    challenge: string;
+};
+export declare enum OAuthProvider {
+    ATPROTO = "atproto",
+    /** @deprecated Use ATPROTO instead. */
+    BLUESKY = "bluesky",
+    GITHUB = "github",
+    GOOGLE = "google",
+    LINEAR = "linear",
+    SLACK = "slack",
+    TRELLO = "trello"
+}
+export declare const InitiateOAuthFlowRequestSchema: Schema.Struct<{
+    provider: Schema.Enums<typeof OAuthProvider>;
+    spaceId: Schema.refine<string & {
+        __SpaceId: true;
+    }, Schema.Schema<unknown, string, never>>;
+    accessTokenId: typeof Schema.String;
+    scopes: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+    noRefresh: Schema.optional<typeof Schema.Boolean>;
+    loginHint: Schema.optional<typeof Schema.String>;
+}>;
+export type InitiateOAuthFlowRequest = Schema.Schema.Type<typeof InitiateOAuthFlowRequestSchema>;
+export type InitiateOAuthFlowResponse = {
+    authUrl: string;
+};
+export type OAuthFlowResult = {
+    success: true;
+    accessToken: string;
+    accessTokenId: string;
+} | {
+    success: false;
+    reason: string;
+};
+export declare enum EdgeWebsocketProtocol {
+    V0 = "edge-ws-v0",
+    /**
+     * Enables message framing and muxing by service-id.
+     */
+    V1 = "edge-ws-v1"
+}
+export type EdgeStatus = {
+    problems: string[];
+    agent: {
+        agentStatus?: string;
+        agentKey?: string;
+        haloSpaceId?: SpaceId;
+        fetchError?: string;
+    };
+    router: {
+        connectedDevices?: {
+            peerKey: string;
+            topics: string[];
+        }[];
+        metrics?: {
+            sentMessages: number;
+            receivedMessages: number;
+            sentBytes: number;
+            receivedBytes: number;
+            failedMessages: number;
+            failedBytes: number;
+        };
+        fetchError?: string;
+    };
+    spaces: {
+        data: Record<SpaceId, {
+            diagnostics?: any & {
+                redFlags: string[];
+            };
+            fetchError?: string;
+        }>;
+        fetchError?: string;
+    };
+};
+export type ImportBundleRequest = {
+    bundle: {
+        /**
+         * DocumentId.
+         */
+        documentId: string;
+        /**
+         * Encoded mutation.
+         */
+        mutation: string;
+        /**
+         * Heads of the document.
+         */
+        heads: string[];
+    }[];
+};
+export type ExportBundleRequest = {
+    /**
+     * DocumentId -> Heads (decoded heads since which we want to export).
+     */
+    docHeads: Record<string, string[]>;
+};
+export type ExportBundleResponse = {
+    bundle: {
+        /**
+         * DocumentId.
+         */
+        documentId: string;
+        /**
+         * Encoded mutation.
+         */
+        mutation: string;
+    }[];
+};
+export declare const DocumentCodec: Readonly<{
+    encode: (doc: Uint8Array) => string;
+    decode: (doc: string) => Uint8Array<ArrayBuffer>;
+}>;
+/**
+ * Codec for serializing and deserializing Edge Errors.
+ */
+export declare const ErrorCodec: Readonly<{
+    encode: (err: Error, depth?: number) => SerializedError;
+    decode: (serializedError: SerializedError, depth?: number) => Error;
+}>;
+/**
+ * Codec for serializing and deserializing Edge unhandled HTTP errors.
+ */
+export declare const EdgeHttpErrorCodec: Readonly<{
+    encode: (err: Error) => Response;
+    decode: (response: Response) => Promise<Error | undefined>;
+}>;
+export type ListSpacesRequest = {
+    limit?: number;
+    cursor?: string;
+    order?: 'asc' | 'desc';
+};
+export type ListSpacesResponse = {
+    spaces: SpaceActivityEntry[];
+    cursor?: string;
+    limit: number;
+};
+export type ListActiveIdentitiesRequest = {
+    cursor?: string;
+    limit?: number;
+};
+export type ListActiveIdentitiesResponse = {
+    identities: {
+        identityKey: string;
+        haloSpaceId: string | null;
+        createdAt: string | null;
+        agentKey: string | null;
+        hasRecovery: boolean;
+    }[];
+    cursor?: string;
+    complete: boolean;
+    totalCount: number;
+};
+export type InspectSpaceRequest = {
+    spaceId: string;
+};
+export type InspectSpaceResponse = {
+    spaceId: string;
+    metadata: {
+        createdAt: string;
+        identityKey?: string;
+        status?: 'active' | 'deleting';
+    } | null;
+    members: {
+        count: number;
+        list: {
+            identityKey: string;
+            role?: string;
+            agentKey?: string;
+        }[];
+    };
+    controlFeeds: {
+        replicationProgress: {
+            [feedKey: string]: {
+                replicated: number;
+                processed: number;
+            };
+        };
+    };
+    echo: {
+        dataFeeds: {
+            count: number;
+            totalBlocks: number;
+            byNamespace: {
+                namespace: string;
+                feeds: {
+                    feedId: string;
+                    blockCount: number;
+                }[];
+            }[];
+        };
+        documentCount: number;
+        objectCount: number;
+        deletedObjectCount: number;
+        indexedDocumentCount: number;
+        objectsByType: {
+            typeDxn: string;
+            count: number;
+        }[];
+        indexerStatus: {
+            indexingInProgress: boolean;
+            cursors: {
+                indexName: string;
+                sourceName: string;
+                resourceId: string | null;
+                cursor: string | number;
+            }[];
+            totalChanges: number;
+        };
+    };
+    usageInLast30Days: {
+        lastActivity: string | null;
+        wsEvents: number;
+        httpEvents: number;
+        totalEvents: number;
+    } | null;
+    durableObjects: {
+        type: string;
+        doId: string;
+    }[];
+};
+export type InspectIdentityRequest = {
+    identityKey: string;
+};
+export type InspectIdentityResponse = {
+    identityKey: string;
+    agentKey: string | null;
+    haloSpaceId: string | null;
+    hasRecovery: boolean;
+    routerDoId: string;
+    agentDoId: string | null;
+    ownedFunctions: {
+        id: string;
+        name: string;
+        versionCount: number;
+    }[];
+    spaces: InspectSpaceResponse[];
+};
+/** Matches the SerializedSpace format from @dxos/echo-db, extended with spaceId. */
+export type SpaceExportPayload = {
+    version: number;
+    timestamp: string;
+    spaceId: string;
+    objects: Record<string, unknown>[];
+};
+export type SpaceActivityEntry = {
+    spaceId: string;
+    lastActivity: string;
+    totalEvents: number;
+    metadata: {
+        createdAt: string;
+        identityKey?: string;
+        status?: 'active' | 'deleting';
+    } | null;
+};
+export type SpaceExportResult = {
+    spaceId: string;
+    downloadPath: string;
+    downloadUrl: string;
+    expiresAt: string;
+    objectCount: number;
+    sizeBytes: number;
+};
+export type ExportSpaceRequest = {
+    spaceId: string;
+    origin: string;
+};
+export type DeleteSpaceRequest = {
+    spaceId: string;
+};
+export type DeleteSpaceResponse = {
+    status: string;
+    spaceId: string;
+};
+export type DeleteIdentityRequest = {
+    identityKey: string;
+};
+export type DeleteIdentityResponse = {
+    status: string;
+    identityKey: string;
+};
+export {};
+//# sourceMappingURL=edge.d.ts.map