@dxos/protocols 0.8.4-main.f9ba587 → 0.8.4-main.fcc0d83b33

package/src/edge-error.ts

@@ -1,79 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type EdgeErrorData, type EdgeHttpFailure } from './edge';
-
-export class EdgeCallFailedError extends Error {
-  public static fromProcessingFailureCause(cause: Error): EdgeCallFailedError {
-    return new EdgeCallFailedError({
-      reason: 'Error processing request.',
-      isRetryable: true,
-      cause,
-    });
-  }
-
-  public static fromHttpFailure(response: Response): EdgeCallFailedError {
-    return new EdgeCallFailedError({
-      reason: `HTTP code ${response.status}: ${response.statusText}.`,
-      isRetryable: isRetryableCode(response.status),
-      retryAfterMs: getRetryAfterMillis(response),
-    });
-  }
-
-  public static fromUnsuccessfulResponse(response: Response, body: EdgeHttpFailure): EdgeCallFailedError {
-    return new EdgeCallFailedError({
-      reason: body.reason,
-      errorData: body.errorData,
-      isRetryable: body.errorData == null && response.headers.has('Retry-After'),
-      retryAfterMs: getRetryAfterMillis(response),
-    });
-  }
-
-  readonly reason: string;
-  readonly errorData?: EdgeErrorData;
-  readonly isRetryable?: boolean;
-  readonly retryAfterMs?: number;
-
-  constructor(args: {
-    reason: string;
-    isRetryable?: boolean;
-    errorData?: EdgeErrorData;
-    retryAfterMs?: number;
-    cause?: Error;
-  }) {
-    super(args.reason, { cause: args.cause });
-    this.reason = args.reason;
-    this.errorData = args.errorData;
-    this.retryAfterMs = args.retryAfterMs;
-    this.isRetryable = Boolean(args.isRetryable);
-  }
-}
-
-export class EdgeAuthChallengeError extends EdgeCallFailedError {
-  constructor(
-    public readonly challenge: string,
-    errorData: EdgeErrorData,
-  ) {
-    super({ reason: 'Auth challenge.', errorData, isRetryable: false });
-  }
-}
-
-const getRetryAfterMillis = (response: Response) => {
-  const retryAfter = Number(response.headers.get('Retry-After'));
-  return Number.isNaN(retryAfter) || retryAfter === 0 ? undefined : retryAfter * 1000;
-};
-
-export const createRetryableHttpFailure = (args: { reason: any; retryAfterSeconds: number }) => {
-  return new Response(JSON.stringify({ success: false, reason: args.reason }), {
-    headers: { 'Retry-After': String(args.retryAfterSeconds) },
-  });
-};
-
-const isRetryableCode = (status: number) => {
-  if (status === 501) {
-    // Not Implemented
-    return false;
-  }
-  return !(status >= 400 && status < 500);
-};

package/src/edge.ts

@@ -1,222 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { Schema } from 'effect';
-
-import { SpaceId } from '@dxos/keys';
-
-// TODO(burdon): Rename EdgerRouterEndpoint?
-export enum EdgeService {
-  AUTOMERGE_REPLICATOR = 'automerge-replicator',
-  FEED_REPLICATOR = 'feed-replicator',
-  SWARM = 'swarm',
-  SIGNAL = 'signal',
-}
-
-export type EdgeHttpSuccess<T> = {
-  success: true;
-  data: T;
-};
-
-export type EdgeErrorData = { type: string } & Record<string, any>;
-
-export type EdgeHttpFailure = {
-  // TODO(burdon): Why is this required?
-  success: false;
-  /**
-   * An explanation of why the call failed. Used mostly for logging and monitoring.
-   */
-  reason: string;
-  /**
-   * 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 errorData is returned simply retrying the request won't have any effect.
-   * EdgeHttpClient should parse well-known errorData into Error types and throw.
-   */
-  errorData?: EdgeErrorData;
-};
-
-export type EdgeHttpResponse<T> = EdgeHttpSuccess<T> | EdgeHttpFailure;
-
-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
-  // This is the format of the signature from the WebAuthn authenticator.
-  | {
-      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;
-  script: string;
-  version: string;
-  ownerPublicKey: string;
-};
-
-export type UploadFunctionResponseBody = {
-  functionId: string;
-  version: string;
-  meta: {
-    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 = {
-  agentKey: string;
-};
-
-export type CreateSpaceResponseBody = {
-  spaceKey: string;
-  spaceId: string; // TODO(burdon): Use SpaceId.
-  automergeRoot: string;
-};
-
-export enum EdgeAgentStatus {
-  ACTIVE = 'active',
-  INACTIVE = 'inactive',
-  NOT_FOUND = 'not_found',
-}
-
-export type EdgeAuthChallenge = {
-  type: 'auth_challenge';
-  challenge: string;
-};
-
-export enum OAuthProvider {
-  GOOGLE = 'google',
-  BLUESKY = 'bluesky',
-}
-
-export const InitiateOAuthFlowRequestSchema = Schema.Struct({
-  provider: Schema.Enums(OAuthProvider),
-  spaceId: Schema.String.pipe(Schema.filter(SpaceId.isValid)), // TODO(burdon): Use SpaceId.
-  accessTokenId: Schema.String,
-  scopes: Schema.mutable(Schema.Array(Schema.String)),
-  // Set to true if we don't want periodic token refreshes in background, for cases like account connect
-  noRefresh: Schema.optional(Schema.Boolean),
-  // Provider-specific (user handle or did for bluesky) hint for auth server resolution
-  loginHint: Schema.optional(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 enum EdgeWebsocketProtocol {
-  V0 = 'edge-ws-v0',
-  /**
-   * Enables message framing and muxing by service-id.
-   */
-  V1 = 'edge-ws-v1',
-}
-
-// TODO(mykola): Reconcile with type in EDGE repo.
-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;
-  };
-};

package/src/query.ts

@@ -1,8 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-/**
- * Channel name that will be used to query spaces from agent.
- */
-export const QUERY_CHANNEL = 'dxos.org/agent/plugin/query';

package/src/queue.ts

@@ -1,33 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import type { ObjectId } from './types.js';
-
-export type QueueCursor = string & { __QueueCursor: never };
-
-export type QueueQuery = {
-  queueId: ObjectId;
-
-  after?: QueueCursor;
-  before?: QueueCursor;
-  limit?: number;
-  reverse?: boolean;
-  objectIds?: ObjectId[];
-};
-
-// TODO(dmaretskyi): Rename QueueQueryResult.
-export type QueryResult = {
-  // TODO(dmaretskyi): HasId & HasTypename.
-
-  objects: unknown[];
-
-  /**
-   * Cursor at the end of the range.
-   */
-  nextCursor: QueueCursor | null;
-  /**
-   * Cursor at the start of the range.
-   */
-  prevCursor: QueueCursor | null;
-};

package/src/tracing.ts

@@ -1,86 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-export type Command = 'begin' | 'end' | 'update';
-
-export type TraceStatus = 'ok' | 'error';
-
-export type DataType = Record<string, any>;
-
-export type TracingContext = {
-  span?: {
-    id: string;
-    command?: Command;
-    parent?: string;
-    status?: TraceStatus;
-    data?: DataType;
-  };
-};
-
-export type Trace = {
-  begin: (opts: { id: string; parentId?: string; data?: DataType }) => TracingContext;
-  end: (opts: { id: string; status?: 'ok' | 'error'; data?: DataType }) => TracingContext;
-  update: (opts: { id: string; data: DataType }) => TracingContext;
-  error: (opts: { id: string; error: Error; data?: DataType }) => TracingContext;
-};
-
-export const trace: Trace = {
-  begin: ({ id, parentId, data }) => {
-    return {
-      span: {
-        command: 'begin',
-        id,
-        parent: parentId,
-        data,
-      },
-    };
-  },
-
-  end: ({ id, status, data }) => {
-    return {
-      span: {
-        command: 'end',
-        id,
-        status: status ?? 'ok',
-        data,
-      },
-    };
-  },
-
-  update: ({ id, data }) => {
-    return {
-      span: {
-        command: 'update',
-        id,
-        data,
-      },
-    };
-  },
-
-  error: ({ id, error, data }) => {
-    return {
-      span: {
-        command: 'end',
-        id,
-        status: 'error',
-        data: {
-          errorMessage: error.message,
-          errorName: error.name,
-          errorStack: error.stack,
-          ...data,
-        },
-      },
-    };
-  },
-};
-
-//
-// Domain-specific tracing
-//
-
-export type DataPipelineProcessed = {
-  spaceKey: string;
-  feedKey: string;
-  seq: number;
-};