@dxos/protocols 0.8.4-main.c4373fc → 0.8.4-main.c85a9c8dae

package/dist/src/edge/edge.js

@@ -0,0 +1,169 @@
+//
+// Copyright 2024 DXOS.org
+//
+import * as Schema from 'effect/Schema';
+import { BaseError } from '@dxos/errors';
+import { invariant } from '@dxos/invariant';
+import { SpaceId } from '@dxos/keys';
+// TODO(burdon): Rename EdgerRouterEndpoint.
+// If we would rename it, we need to be careful to not break composer production.
+export var EdgeService;
+(function (EdgeService) {
+    EdgeService["AUTOMERGE_REPLICATOR"] = "automerge-replicator";
+    /**
+     * Control feed replicator (hypercore append only logs) for the space.
+     */
+    // TODO(mykola): Remove once we migrate to keyhive for access control.
+    EdgeService["FEED_REPLICATOR"] = "feed-replicator";
+    /**
+     * Feed replicator (ordered data list) for the space.
+     */
+    // TODO(mykola): Rename to FEED_REPLICATOR when we migrate to keyhive for access control.
+    EdgeService["QUEUE_REPLICATOR"] = "queue-replicator";
+    EdgeService["SWARM"] = "swarm";
+    EdgeService["SIGNAL"] = "signal";
+    EdgeService["STATUS"] = "status";
+})(EdgeService || (EdgeService = {}));
+const _SerializedError = Schema.Struct({
+    name: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    context: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Any })),
+    stack: Schema.optional(Schema.String),
+    cause: Schema.optional(Schema.suspend(() => SerializedError)),
+});
+export const SerializedError = _SerializedError;
+/**
+ * Use this to create a response from the Edge service.
+ */
+export const EdgeResponse = Object.freeze({
+    success: (data, status = 200) => {
+        invariant(status >= 200 && status < 300, 'Status code must be in the 2xx range');
+        const headers = new Headers({ 'Content-Type': 'application/json' });
+        return new Response(JSON.stringify({
+            success: true,
+            data,
+        }), {
+            status,
+            headers,
+        });
+    },
+    failure: ({ message, error, errorEncoded, data, shouldRetryAfter, status = 500, }) => {
+        const headers = new Headers({ 'Content-Type': 'application/json' });
+        if (shouldRetryAfter) {
+            headers.set('Retry-After', String(shouldRetryAfter));
+        }
+        return new Response(JSON.stringify({
+            success: false,
+            message,
+            data,
+            error: error ? ErrorCodec.encode(error) : errorEncoded,
+        }), {
+            status,
+            headers,
+        });
+    },
+});
+/**
+ * Note: Do not change the values of these enums, this values are stored in the FunctionVersions database.
+ */
+export const FunctionRuntimeKind = Schema.Enums({
+    // https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/
+    WORKERS_FOR_PLATFORMS: 'WORKERS_FOR_PLATFORMS',
+    // https://developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/
+    WORKER_LOADER: 'WORKER_LOADER',
+});
+export var EdgeAgentStatus;
+(function (EdgeAgentStatus) {
+    EdgeAgentStatus["ACTIVE"] = "active";
+    EdgeAgentStatus["INACTIVE"] = "inactive";
+    EdgeAgentStatus["NOT_FOUND"] = "not_found";
+})(EdgeAgentStatus || (EdgeAgentStatus = {}));
+export var OAuthProvider;
+(function (OAuthProvider) {
+    OAuthProvider["GOOGLE"] = "google";
+    OAuthProvider["BLUESKY"] = "bluesky";
+})(OAuthProvider || (OAuthProvider = {}));
+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 var EdgeWebsocketProtocol;
+(function (EdgeWebsocketProtocol) {
+    EdgeWebsocketProtocol["V0"] = "edge-ws-v0";
+    /**
+     * Enables message framing and muxing by service-id.
+     */
+    EdgeWebsocketProtocol["V1"] = "edge-ws-v1";
+})(EdgeWebsocketProtocol || (EdgeWebsocketProtocol = {}));
+export const DocumentCodec = Object.freeze({
+    encode: (doc) => Buffer.from(doc).toString('base64'),
+    decode: (doc) => new Uint8Array(Buffer.from(doc, 'base64')),
+});
+const MAX_ERROR_DEPTH = 3;
+/**
+ * Codec for serializing and deserializing Edge Errors.
+ */
+export const ErrorCodec = Object.freeze({
+    encode: (err, depth = 0) => ({
+        name: 'name' in err ? err.name : err.code || 'Error',
+        message: err.message,
+        stack: err.stack,
+        cause: err.cause instanceof Error && depth < MAX_ERROR_DEPTH ? ErrorCodec.encode(err.cause, depth + 1) : undefined,
+    }),
+    decode: (serializedError, depth = 0) => {
+        let err;
+        if (typeof serializedError.name === 'string') {
+            err = new BaseError(serializedError.name, {
+                message: serializedError.message ?? 'Unknown error',
+                cause: serializedError.cause && depth < MAX_ERROR_DEPTH
+                    ? ErrorCodec.decode(serializedError.cause, depth + 1)
+                    : undefined,
+                context: serializedError.context,
+            });
+            if (serializedError.stack) {
+                Object.defineProperty(err, 'stack', {
+                    value: serializedError.stack,
+                });
+            }
+        }
+        else {
+            err = new Error(serializedError.message ?? 'Unknown error', {
+                cause: serializedError.cause && depth < MAX_ERROR_DEPTH
+                    ? ErrorCodec.decode(serializedError.cause, depth + 1)
+                    : undefined,
+            });
+            if (serializedError.stack) {
+                Object.defineProperty(err, 'stack', {
+                    value: serializedError.stack,
+                });
+            }
+        }
+        return err;
+    },
+});
+/**
+ * Codec for serializing and deserializing Edge unhandled HTTP errors.
+ */
+export const EdgeHttpErrorCodec = Object.freeze({
+    encode: (err) => new Response(JSON.stringify({
+        error: ErrorCodec.encode(err),
+    }), { status: 500 }),
+    decode: async (response) => {
+        if (response.headers.get('Content-Type') !== 'application/json') {
+            const body = await response.clone().text();
+            return new Error(body.slice(0, 256));
+        }
+        const body = await response.clone().json();
+        if (!('error' in body)) {
+            return undefined;
+        }
+        return ErrorCodec.decode(body.error);
+    },
+});
+//# sourceMappingURL=edge.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { type EdgeErrorData, type EdgeFailure } from './edge.ts';
+/**
+ * Error thrown when a call to the Edge service fails.
+ * There 3 possible sources of failure:
+ * 1. EdgeFailure (JSON body with { success: false }) -> Processing the request failed and was gracefully handled by EDGE service.
+ * 2. Http failure (non-ok code) -> The HTTP request failed (e.g. timeout, network error).
+ *                               -> Unhandled exception on EDGE side, EDGE would provide serialized error in the response body.
+ * 3. Processing failure -> Unhandled exception on client side while processing the response.
+ */
+export declare class EdgeCallFailedError extends Error {
+    static fromUnsuccessfulResponse(response: Response, body: EdgeFailure): EdgeCallFailedError;
+    static fromHttpFailure(response: Response): Promise<EdgeCallFailedError>;
+    static fromProcessingFailureCause(cause: Error): EdgeCallFailedError;
+    readonly data?: EdgeErrorData;
+    readonly isRetryable?: boolean;
+    readonly retryAfterMs?: number;
+    constructor(args: {
+        message: string;
+        isRetryable?: boolean;
+        data?: EdgeErrorData;
+        retryAfterMs?: number;
+        cause?: Error;
+    });
+}
+export declare class EdgeAuthChallengeError extends EdgeCallFailedError {
+    readonly challenge: string;
+    constructor(challenge: string, data: EdgeErrorData);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/edge/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAkC,MAAM,WAAW,CAAC;AAGjG;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;WAC9B,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,mBAAmB;WAY9E,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC;WASvE,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB;IAQ3E,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAOF;AAED,qBAAa,sBAAuB,SAAQ,mBAAmB;aAE3C,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EACjC,IAAI,EAAE,aAAa;CAItB"}

package/dist/src/edge/errors.js

@@ -0,0 +1,69 @@
+//
+// Copyright 2025 DXOS.org
+//
+import { EdgeHttpErrorCodec, ErrorCodec } from "./edge.js";
+// TODO(burdon): Reconcile with @dxos/errors.
+/**
+ * Error thrown when a call to the Edge service fails.
+ * There 3 possible sources of failure:
+ * 1. EdgeFailure (JSON body with { success: false }) -> Processing the request failed and was gracefully handled by EDGE service.
+ * 2. Http failure (non-ok code) -> The HTTP request failed (e.g. timeout, network error).
+ *                               -> Unhandled exception on EDGE side, EDGE would provide serialized error in the response body.
+ * 3. Processing failure -> Unhandled exception on client side while processing the response.
+ */
+export class EdgeCallFailedError extends Error {
+    static fromUnsuccessfulResponse(response, body) {
+        const error = new EdgeCallFailedError({
+            message: body.message,
+            data: body.data,
+            isRetryable: body.data == null && response.headers.has('Retry-After'),
+            retryAfterMs: getRetryAfterMillis(response),
+            cause: body.error ? ErrorCodec.decode(body.error) : undefined,
+        });
+        return error;
+    }
+    static async fromHttpFailure(response) {
+        return new EdgeCallFailedError({
+            message: `HTTP code ${response.status}: ${response.statusText}.`,
+            isRetryable: isRetryableCode(response.status),
+            retryAfterMs: getRetryAfterMillis(response),
+            cause: await EdgeHttpErrorCodec.decode(response),
+        });
+    }
+    static fromProcessingFailureCause(cause) {
+        return new EdgeCallFailedError({
+            message: 'Error processing request.',
+            isRetryable: true,
+            cause,
+        });
+    }
+    data;
+    isRetryable;
+    retryAfterMs;
+    constructor(args) {
+        super(args.message, { cause: args.cause });
+        this.message = args.message;
+        this.data = args.data;
+        this.retryAfterMs = args.retryAfterMs;
+        this.isRetryable = Boolean(args.isRetryable);
+    }
+}
+export class EdgeAuthChallengeError extends EdgeCallFailedError {
+    challenge;
+    constructor(challenge, data) {
+        super({ message: 'Auth challenge.', data, isRetryable: false });
+        this.challenge = challenge;
+    }
+}
+const getRetryAfterMillis = (response) => {
+    const retryAfter = Number(response.headers.get('Retry-After'));
+    return Number.isNaN(retryAfter) || retryAfter === 0 ? undefined : retryAfter * 1000;
+};
+const isRetryableCode = (status) => {
+    if (status === 501) {
+        // Not Implemented
+        return false;
+    }
+    return !(status >= 400 && status < 500);
+};
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,4 @@
+export * from './edge.ts';
+export * as EdgeFunctionEnv from './EdgeFunctionEnv.ts';
+export * from './errors.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/edge/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAC;AACxD,cAAc,aAAa,CAAC"}

package/dist/src/edge/index.js

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+export * from "./edge.js";
+export * as EdgeFunctionEnv from "./EdgeFunctionEnv.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/edge/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAC;AACxD,cAAc,aAAa,CAAC"}

package/dist/src/errors/base-errors.d.ts

@@ -2,26 +2,104 @@
  * NOTE: Messages should be sentences (Start with a capital letter and end with a period).
  * Errors can optionally include a JSON context object.
  */
-export declare class BaseError extends Error {
-    readonly code: string;
-    readonly context?: Record<string, any> | undefined;
-    constructor(code: string, message?: string, context?: Record<string, any> | undefined);
-}
+import { BaseError } from '@dxos/errors';
+declare const ApiError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        name: "ApiError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "ApiError";
+        stack?: string;
+        cause?: unknown;
+    };
+    name: "ApiError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, "cause"> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        name: "ApiError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "ApiError";
+        stack?: string;
+        cause?: unknown;
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    isError(error: unknown): error is Error;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
 /**
  * User facing API Errors.
  * E.g., something was misconfigured.
  */
-export declare class ApiError extends BaseError {
+export declare class ApiError extends ApiError_base {
 }
+declare const SystemError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        name: "SystemError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "SystemError";
+        stack?: string;
+        cause?: unknown;
+    };
+    name: "SystemError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, "cause"> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        name: "SystemError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "SystemError";
+        stack?: string;
+        cause?: unknown;
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    isError(error: unknown): error is Error;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
 /**
  * Internal system errors.
  * E.g., unexpected/unrecoverable runtime error.
  */
-export declare class SystemError extends BaseError {
+export declare class SystemError extends SystemError_base {
 }
+declare const DatabaseError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        name: "DatabaseError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "DatabaseError";
+        stack?: string;
+        cause?: unknown;
+    };
+    name: "DatabaseError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, "cause"> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        name: "DatabaseError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "DatabaseError";
+        stack?: string;
+        cause?: unknown;
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    isError(error: unknown): error is Error;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
 /**
  * Database errors.
  */
-export declare class DatabaseError extends BaseError {
+export declare class DatabaseError extends DatabaseError_base {
 }
+export {};
 //# sourceMappingURL=base-errors.d.ts.map

package/dist/src/errors/base-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/base-errors.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAF7B,IAAI,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;CAQzC;AAKD;;;GAGG;AACH,qBAAa,QAAS,SAAQ,SAAS;CAAG;AAE1C;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;CAAG;AAE7C;;GAEG;AAEH,qBAAa,aAAc,SAAQ,SAAS;CAAG"}
+{"version":3,"file":"base-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/base-errors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;qBAkB6c,CAAC;;;;;;;;;;;;;;;AAhBvf;;;GAGG;AACH,qBAAa,QAAS,SAAQ,aAA4B;CAAG;;;;;;;;;;;;;qBAYyb,CAAC;;;;;;;;;;;;;;;AAVvf;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAA+B;CAAG;;;;;;;;;;;;;qBAMmb,CAAC;;;;;;;;;;;;;;;AAJvf;;GAEG;AACH,qBAAa,aAAc,SAAQ,kBAAiC;CAAG"}

package/dist/src/errors/base-errors.js

@@ -1,42 +1,26 @@
 //
 // Copyright 2021 DXOS.org
 //
-// TODO(dmaretskyi): Reconcile with @dxos/errors
 /**
  * NOTE: Messages should be sentences (Start with a capital letter and end with a period).
  * Errors can optionally include a JSON context object.
  */
-export class BaseError extends Error {
-    code;
-    context;
-    constructor(code, message, context) {
-        // TODO(dmaretskyi): Error.cause.
-        super(message ?? code);
-        this.code = code;
-        this.context = context;
-        this.name = code;
-        // NOTE: Restores prototype chain (https://stackoverflow.com/a/48342359).
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-// TODO(dmaretskyi): Consider common error classes with error codes:
-// throw new SystemError(ERROR_CODE_OUT_OF_MEMORY, 'Out of memory', { a: 1, b: 2 });
+import { BaseError } from '@dxos/errors';
 /**
  * User facing API Errors.
  * E.g., something was misconfigured.
  */
-export class ApiError extends BaseError {
+export class ApiError extends BaseError.extend('ApiError') {
 }
 /**
  * Internal system errors.
  * E.g., unexpected/unrecoverable runtime error.
  */
-export class SystemError extends BaseError {
+export class SystemError extends BaseError.extend('SystemError') {
 }
 /**
  * Database errors.
  */
-// TODO(wittjosiah): Same as ApiError?
-export class DatabaseError extends BaseError {
+export class DatabaseError extends BaseError.extend('DatabaseError') {
 }
 //# sourceMappingURL=base-errors.js.map

package/dist/src/errors/base-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-errors.js","sourceRoot":"","sources":["../../../src/errors/base-errors.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,gDAAgD;AAEhD;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEvB;IAEA;IAHX,YACW,IAAY,EACrB,OAAgB,EACP,OAA6B;QAEtC,iCAAiC;QACjC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QALd,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAsB;QAItC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,yEAAyE;QACzE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,oEAAoE;AACpE,oFAAoF;AAEpF;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,SAAS;CAAG;AAE1C;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;CAAG;AAE7C;;GAEG;AACH,sCAAsC;AACtC,MAAM,OAAO,aAAc,SAAQ,SAAS;CAAG"}
+{"version":3,"file":"base-errors.js","sourceRoot":"","sources":["../../../src/errors/base-errors.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;CAAG;AAE7D;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC;CAAG;AAEnE;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC;CAAG"}

package/dist/src/errors/encoding.d.ts

@@ -1,7 +1,7 @@
-import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.js';
+import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.ts';
 export declare const encodeError: (err: any) => SerializedErrorProto;
 export type DecodeOptions = {
     appendStack?: string;
 };
-export declare const decodeError: (err: SerializedErrorProto, { appendStack }?: DecodeOptions) => Error;
+export declare const decodeError: (err: SerializedErrorProto, { appendStack }?: DecodeOptions) => Error | import("@dxos/errors").BaseError<string>;
 //# sourceMappingURL=encoding.d.ts.map

package/dist/src/errors/encoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/errors/encoding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIhF,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,KAAG,oBAiBtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,oBAAoB,EAAE,kBAAiB,aAAkB,UASzF,CAAC"}
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/errors/encoding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIhF,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,KAAG,oBAiBtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,oBAAoB,EAAE,kBAAiB,aAAkB,qDASzF,CAAC"}

package/dist/src/errors/encoding.js

@@ -1,7 +1,7 @@
 //
 // Copyright 2023 DXOS.org
 //
-import { reconstructError } from './helpers.js';
+import { reconstructError } from "./helpers.js";
 export const encodeError = (err) => {
     if (typeof err === 'object' && err?.message) {
         return {