@dxos/protocols 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

package/src/proto/index.ts

@@ -2,5 +2,5 @@
 // Copyright 2020 DXOS.org
 //
 
-export { schema, schemaJson, type TYPES } from './gen/index.js';
-export type * from './types.js';
+export { schema, schemaJson, type TYPES } from './gen/index.ts';
+export type * from './types.ts';

package/src/proto/types.ts

@@ -4,7 +4,7 @@
 
 import { type TypedProtoMessage } from '@dxos/codec-protobuf';
 
-import { type TYPES } from './gen/index.js';
+import { type TYPES } from './gen/index.ts';
 
 // TODO(burdon): Rename ProtocolMessage.
 export type TypedMessage = TypedProtoMessage<TYPES>;

package/src/space-archive.ts

@@ -11,8 +11,13 @@ import type { IdentityDid, SpaceId } from '@dxos/keys';
  *
  * A tar archive with files:
  *  - metadata.json -- JSON-encoded {@link SpaceArchiveMetadata} file.
- *  - documents
+ *  - documents/
  *    - <document-id>.bin -- Automerge document.
+ *  - feeds/
+ *    - <feed-id>/
+ *      - metadata.json -- JSON-encoded {@link FeedArchiveMetadata} file.
+ *      - blocks-0.json -- JSON array of {@link FeedArchiveBlock} (chunks of 100).
+ *      - blocks-1.json -- ...
  */
 
 /**
@@ -60,7 +65,71 @@ export interface SpaceArchiveMetadata {
   };
 }
 
+/**
+ * Feed metadata stored in `feeds/<feed-id>/metadata.json`.
+ */
+export interface FeedArchiveMetadata {
+  /**
+   * Feed identifier.
+   */
+  id: string;
+
+  /**
+   * Feed namespace (e.g., 'data', 'trace').
+   */
+  namespace: string;
+}
+
+/**
+ * Feed block stored in `feeds/<feed-id>/blocks-N.json`.
+ * Represents a single block from the feed.
+ */
+export interface FeedArchiveBlock {
+  /**
+   * Actor that produced this block.
+   */
+  actorId: string;
+
+  /**
+   * Per-feed monotonic sequence assigned by the actor.
+   */
+  sequence: number;
+
+  /**
+   * Actor of the immediate predecessor block, if any.
+   */
+  prevActorId: string | null;
+
+  /**
+   * Sequence of the immediate predecessor block, if any.
+   */
+  prevSequence: number | null;
+
+  /**
+   * Globally ordered position assigned by a position authority.
+   */
+  position: number | null;
+
+  /**
+   * Milliseconds since Unix epoch when the block was created.
+   */
+  timestamp: number;
+
+  /**
+   * Base64-encoded serialized application payload.
+   */
+  data: string;
+}
+
+/**
+ * Number of blocks per chunk file.
+ */
+export const FEED_ARCHIVE_BLOCKS_PER_CHUNK = 100;
+
 export const SpaceArchiveFileStructure = {
   metadata: 'metadata.json',
   documents: 'documents',
+  feeds: 'feeds',
+  feedMetadata: 'metadata.json',
+  feedBlocksPrefix: 'blocks-',
 } as const;

package/src/types.ts

@@ -5,8 +5,8 @@
 import { type PublicKey } from '@dxos/keys';
 import { type Timeframe } from '@dxos/timeframe';
 
-import { type CredentialsMessage, type FeedMessage } from './proto/gen/dxos/echo/feed.js';
-import { type EchoObjectBatch } from './proto/gen/dxos/echo/object.js';
+import { type CredentialsMessage, type FeedMessage } from './proto/gen/dxos/echo/feed.ts';
+import { type EchoObjectBatch } from './proto/gen/dxos/echo/object.ts';
 
 // TODO(burdon): Replace with proto definition.
 export type FeedMeta = {

package/dist/src/queue.d.ts

@@ -1,3 +0,0 @@
-export { type QueueService, type QueueQuery, type QueueQueryResult as QueryResult, type QueryQueueRequest, type InsertIntoQueueRequest, type DeleteFromQueueRequest, } from './proto/gen/dxos/client/services.js';
-export declare const KEY_QUEUE_POSITION = "dxos.org/key/queue-position";
-//# sourceMappingURL=queue.d.ts.map

package/dist/src/queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/queue.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,IAAI,WAAW,EACpC,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,qCAAqC,CAAC;AAE7C,eAAO,MAAM,kBAAkB,gCAAgC,CAAC"}

package/dist/src/queue.js

@@ -1,5 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-export const KEY_QUEUE_POSITION = 'dxos.org/key/queue-position';
-//# sourceMappingURL=queue.js.map

package/dist/src/queue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/queue.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAWF,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC"}

package/src/queue.ts

@@ -1,14 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-
-export {
-  type QueueService,
-  type QueueQuery,
-  type QueueQueryResult as QueryResult,
-  type QueryQueueRequest,
-  type InsertIntoQueueRequest,
-  type DeleteFromQueueRequest,
-} from './proto/gen/dxos/client/services.js';
-
-export const KEY_QUEUE_POSITION = 'dxos.org/key/queue-position';