@dxos/functions-runtime-cloudflare 0.8.4-main.fcfe5033a5 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/functions-runtime-cloudflare",
-  "version": "0.8.4-main.fcfe5033a5",
+  "version": "0.9.0",
   "description": "Functions runtime for Cloudflare.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,7 +8,7 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "info@dxos.org",
   "sideEffects": false,
   "type": "module",
@@ -27,23 +27,23 @@
     "src"
   ],
   "dependencies": {
-    "effect": "3.20.0",
-    "@dxos/context": "0.8.4-main.fcfe5033a5",
-    "@dxos/codec-protobuf": "0.8.4-main.fcfe5033a5",
-    "@dxos/debug": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo-protocol": "0.8.4-main.fcfe5033a5",
-    "@dxos/invariant": "0.8.4-main.fcfe5033a5",
-    "@dxos/errors": "0.8.4-main.fcfe5033a5",
-    "@dxos/keys": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo-db": "0.8.4-main.fcfe5033a5",
-    "@dxos/protocols": "0.8.4-main.fcfe5033a5",
-    "@dxos/util": "0.8.4-main.fcfe5033a5",
-    "@dxos/log": "0.8.4-main.fcfe5033a5"
+    "effect": "3.21.3",
+    "@dxos/codec-protobuf": "0.9.0",
+    "@dxos/context": "0.9.0",
+    "@dxos/debug": "0.9.0",
+    "@dxos/errors": "0.9.0",
+    "@dxos/echo-protocol": "0.9.0",
+    "@dxos/echo-client": "0.9.0",
+    "@dxos/invariant": "0.9.0",
+    "@dxos/keys": "0.9.0",
+    "@dxos/log": "0.9.0",
+    "@dxos/protocols": "0.9.0",
+    "@dxos/echo": "0.9.0",
+    "@dxos/util": "0.9.0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260302.0",
-    "@dxos/types": "0.8.4-main.fcfe5033a5"
+    "@dxos/types": "0.9.0"
   },
   "publishConfig": {
     "access": "public"

package/src/functions-client.ts

@@ -3,7 +3,7 @@
 //
 
 import { Resource } from '@dxos/context';
-import { EchoClient } from '@dxos/echo-db';
+import { EchoClient } from '@dxos/echo-client';
 import { invariant } from '@dxos/invariant';
 import { type SpaceId } from '@dxos/keys';
 import { type EdgeFunctionEnv } from '@dxos/protocols';
@@ -80,9 +80,3 @@ export const createClientFromEnv = async (env: any): Promise<FunctionsClient> =>
   await client.open();
   return client;
 };
-
-/**
- - Provides data access capabilities for user functions.
- - No real-time replication or reactive queries -- function receives a snapshot.
- - Function event contains the metadata but doesn't need to include the data.
- */

package/src/internal/data-service-impl.ts

@@ -97,6 +97,11 @@ export class DataServiceImpl implements DataServiceProto {
     // TODO(dmaretskyi): Batch.
     try {
       for (const update of updates ?? []) {
+        // Mutation-less updates (e.g. `requesting: true` transition signals from the worker) carry no
+        // bytes to apply; this runtime only forwards real document writes.
+        if (!update.mutation) {
+          continue;
+        }
         await this._dataService.changeDocument(this._executionContext, sub.spaceId, update.documentId, update.mutation);
       }
     } catch (error) {
@@ -131,7 +136,7 @@ export class DataServiceImpl implements DataServiceProto {
   }
 
   async updateIndexes(): Promise<void> {
-    log.error('updateIndexes is not available in EDGE env.');
+    log.verbose('updateIndexes called, but it is a no-op in EDGE env.');
     // No-op.
   }
 

package/src/internal/queue-service-impl.ts

@@ -63,4 +63,8 @@ export class QueueServiceImpl implements FeedProtocol.QueueService {
   async syncQueue(_: FeedProtocol.SyncQueueRequest): Promise<void> {
     // No-op in Cloudflare runtime.
   }
+
+  async getSyncState(_: FeedProtocol.GetSyncStateRequest): Promise<FeedProtocol.GetSyncStateResponse> {
+    return { namespaces: [] };
+  }
 }

package/src/internal/service-container.ts

@@ -2,11 +2,11 @@
 // Copyright 2024 DXOS.org
 //
 
-import { type AnyEntity } from '@dxos/echo/internal';
-import { type DXN, type SpaceId } from '@dxos/keys';
+import { type AnyEntity } from '@dxos/echo/Type';
+import { EID, type SpaceId } from '@dxos/keys';
 import { type EdgeFunctionEnv, type FeedProtocol } from '@dxos/protocols';
 import { type QueryService as QueryServiceProto } from '@dxos/protocols/proto/dxos/echo/query';
-import type { DataService as DataServiceProto } from '@dxos/protocols/proto/dxos/echo/service';
+import { type DataService as DataServiceProto } from '@dxos/protocols/proto/dxos/echo/service';
 
 import { DataServiceImpl } from './data-service-impl';
 import { QueryServiceImpl } from './query-service-impl';
@@ -53,19 +53,19 @@ export class ServiceContainer {
     };
   }
 
-  async queryQueue(queue: DXN): Promise<FeedProtocol.QueryResult> {
-    const parts = queue.asQueueDXN();
-    if (!parts) {
-      throw new Error('Invalid queue DXN');
+  async queryQueue(queue: EID.EID): Promise<FeedProtocol.QueryResult> {
+    const spaceId = EID.getSpaceId(queue);
+    const queueId = EID.getEntityId(queue);
+    if (!spaceId || !queueId) {
+      throw new Error('Invalid queue EID');
     }
-    const { subspaceTag, spaceId, queueId } = parts;
     const result = await this._queueService.queryQueue(this._executionContext, {
       query: {
         spaceId,
-        queuesNamespace: subspaceTag,
         queueIds: [queueId],
       },
     });
+
     return {
       objects: structuredClone(result.objects),
       nextCursor: result.nextCursor ?? null,
@@ -73,17 +73,18 @@ export class ServiceContainer {
     };
   }
 
-  async insertIntoQueue(queue: DXN, objects: AnyEntity[]): Promise<void> {
-    const parts = queue.asQueueDXN();
-    if (!parts) {
-      throw new Error('Invalid queue DXN');
+  async insertIntoQueue(queue: EID.EID, objects: AnyEntity[]): Promise<void> {
+    const spaceId = EID.getSpaceId(queue);
+    const queueId = EID.getEntityId(queue);
+    if (!spaceId || !queueId) {
+      throw new Error('Invalid queue EID');
     }
-    const { subspaceTag, spaceId, queueId } = parts;
+    // TODO(dmaretskyi): EID does not encode the subspaceTag — defaulting to 'data'.
     await this._queueService.insertIntoQueue(this._executionContext, {
-      subspaceTag,
+      subspaceTag: 'data',
       spaceId,
       queueId,
-      objects: objects as FeedProtocol.InsertIntoQueueRequest['objects'],
+      objects: objects.map((obj) => JSON.stringify(obj)),
     });
   }
 }

package/src/logger.ts

@@ -16,27 +16,29 @@ const functionLogProcessor: LogProcessor = (config, entry) => {
     return;
   }
 
+  const context = entry.computedContext;
+  const error = entry.computedError;
+  const extras = [Object.keys(context).length > 0 ? context : undefined, error].filter((value) => value !== undefined);
+
   switch (entry.level) {
     case LogLevel.DEBUG:
-      console.debug(entry.message, entry.context);
-      break;
     case LogLevel.TRACE:
-      console.debug(entry.message, entry.context);
+      console.debug(entry.message, ...extras);
       break;
     case LogLevel.VERBOSE:
-      console.log(entry.message, entry.context);
+      console.log(entry.message, ...extras);
       break;
     case LogLevel.INFO:
-      console.info(entry.message, entry.context);
+      console.info(entry.message, ...extras);
       break;
     case LogLevel.WARN:
-      console.warn(entry.message, entry.context);
+      console.warn(entry.message, ...extras);
       break;
     case LogLevel.ERROR:
-      console.error(entry.message, entry.context);
+      console.error(entry.message, ...extras);
       break;
     default:
-      console.log(entry.message, entry.context);
+      console.log(entry.message, ...extras);
       break;
   }
 };

package/src/queues-api.ts

@@ -2,20 +2,26 @@
 // Copyright 2025 DXOS.org
 //
 
-import { type AnyEntity } from '@dxos/echo/internal';
-import type { DXN, SpaceId } from '@dxos/keys';
+import { type AnyEntity } from '@dxos/echo/Type';
+import { type EID, type SpaceId } from '@dxos/keys';
 import { type FeedProtocol } from '@dxos/protocols';
 
 import type { ServiceContainer } from './internal';
 
+export interface QueuesQueryResult {
+  objects: AnyEntity[];
+  nextCursor: string | null;
+  prevCursor: string | null;
+}
+
 // TODO(dmaretskyi): Temporary API to get the queues working.
 // TODO(dmaretskyi): To be replaced with integrating queues into echo.
 /**
  * @deprecated
  */
 export interface QueuesAPI {
-  queryQueue(queue: DXN, options?: {}): Promise<FeedProtocol.QueryResult>;
-  insertIntoQueue(queue: DXN, objects: AnyEntity[]): Promise<void>;
+  queryQueue(queue: EID.EID, options?: {}): Promise<FeedProtocol.QueryResult>;
+  insertIntoQueue(queue: EID.EID, objects: AnyEntity[]): Promise<void>;
 }
 
 /**
@@ -27,11 +33,11 @@ export class QueuesAPIImpl implements QueuesAPI {
     private readonly _spaceId: SpaceId,
   ) {}
 
-  queryQueue(queue: DXN, options?: {}): Promise<FeedProtocol.QueryResult> {
+  queryQueue(queue: EID.EID, options?: {}): Promise<FeedProtocol.QueryResult> {
     return this._serviceContainer.queryQueue(queue);
   }
 
-  insertIntoQueue(queue: DXN, objects: AnyEntity[]): Promise<void> {
+  insertIntoQueue(queue: EID.EID, objects: AnyEntity[]): Promise<void> {
     // TODO(dmaretskyi): Ugly.
     return this._serviceContainer.insertIntoQueue(queue, JSON.parse(JSON.stringify(objects)));
   }

package/src/space-proxy.ts

@@ -4,7 +4,7 @@
 
 import { Resource } from '@dxos/context';
 import { type Database } from '@dxos/echo';
-import { type CoreDatabase, type EchoClient, type EchoDatabaseImpl } from '@dxos/echo-db';
+import { type DatabaseImpl, type EchoClient } from '@dxos/echo-client';
 import { invariant } from '@dxos/invariant';
 import { PublicKey, type SpaceId } from '@dxos/keys';
 
@@ -15,7 +15,7 @@ import { type QueuesAPI, QueuesAPIImpl } from './queues-api';
  * @deprecated
  */
 export class SpaceProxy extends Resource {
-  private _db?: EchoDatabaseImpl = undefined;
+  private _db?: DatabaseImpl = undefined;
   private _queuesApi: QueuesAPIImpl;
 
   constructor(
@@ -36,14 +36,6 @@ export class SpaceProxy extends Resource {
     return this._db;
   }
 
-  /**
-   * @deprecated Use db API.
-   */
-  get crud(): CoreDatabase {
-    invariant(this._db);
-    return this._db.coreDatabase;
-  }
-
   get queues(): QueuesAPI {
     return this._queuesApi;
   }
@@ -61,6 +53,7 @@ export class SpaceProxy extends Resource {
       owningObject: this,
     });
 
-    await this._db.coreDatabase.open(this._ctx, { rootUrl: meta.rootDocumentId });
+    await this._db.setSpaceRoot(meta.rootDocumentId);
+    await this._db.open(this._ctx);
   }
 }

package/src/types.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import type { JsonSchemaType } from '@dxos/echo/internal';
+import type { JsonSchema as JsonSchemaType } from '@dxos/echo/JsonSchema';
 
 /**
  * Is used for to route the request to the metadata handler instead of the main handler.

package/src/wrap-handler-for-cloudflare.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import type { JsonSchemaType } from '@dxos/echo/internal';
+import type { JsonSchema as JsonSchemaType } from '@dxos/echo/JsonSchema';
 import { invariant } from '@dxos/invariant';
 import { SpaceId } from '@dxos/keys';
 import { log } from '@dxos/log';
@@ -97,7 +97,7 @@ const handleFunctionMetaCall = (functionDefinition: FunctionProtocol.Func, reque
   });
 };
 
-const createFunctionContext = async ({
+export const createFunctionContext = async ({
   serviceContainer,
   contextSpaceId,
 }: {