@relayfile/sdk 0.9.3 → 0.9.5

package/dist/client.js

@@ -1,4 +1,4 @@
-import { RelayFileSync } from "./sync.js";
+import { RelayFileSync, normalizeFilesystemEvent } from "./sync.js";
 import { InvalidStateError, PayloadTooLargeError, QueueFullError, RelayFileApiError, RevisionConflictError } from "./errors.js";
 /** Default base URL for the hosted Relayfile API */
 export const DEFAULT_RELAYFILE_BASE_URL = "https://api.relayfile.dev";
@@ -12,6 +12,7 @@ const DEFAULT_CHANGE_COALESCE_MS = 200;
 const DEFAULT_CHANGE_LOG_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
 const DEFAULT_CHANGE_LOG_MAX_ENTRIES = 10_000;
 const CLIENT_TOKEN_STREAM_KEY = "__client__";
+const STABLE_FALLBACK_CHANGE_TIMESTAMP = "1970-01-01T00:00:00.000Z";
 const changeStreamManagers = new WeakMap();
 const changeLogCaches = new WeakMap();
 const changeLogSettings = new WeakMap();
@@ -161,7 +162,7 @@ class RelayFileWebSocketConnection {
                 if (raw.path !== undefined && typeof raw.path !== "string") {
                     throw new Error("Invalid WebSocket event: 'path' must be a string.");
                 }
-                parsed = raw;
+                parsed = normalizeFilesystemEvent(raw);
             }
             catch (error) {
                 const parseError = error instanceof Error ? error : new Error("Failed to parse WebSocket event payload.");
@@ -882,23 +883,66 @@ function toChangeEvent(client, record, contextOverride) {
         }
     };
 }
-function normalizeWireChangeEvent(payload) {
+function normalizeWireChangeEvent(payload, workspaceId) {
     const data = (payload ?? {});
     const resource = (data.resource ?? {});
     const summary = (data.summary ?? {});
+    const path = typeof resource.path === "string"
+        ? resource.path
+        : typeof data.path === "string"
+            ? data.path
+            : "";
+    const inferredResource = inferResourceMetadata(path, resource);
+    const occurredAt = typeof data.occurredAt === "string"
+        ? data.occurredAt
+        : typeof data.timestamp === "string"
+            ? data.timestamp
+            : typeof data.ts === "string"
+                ? data.ts
+                : STABLE_FALLBACK_CHANGE_TIMESTAMP;
+    const eventId = typeof data.id === "string"
+        ? data.id
+        : typeof data.eventId === "string"
+            ? data.eventId
+            : [
+                "relayfile",
+                workspaceId ?? "",
+                typeof data.type === "string" ? data.type : "relayfile.changed",
+                path,
+                typeof data.revision === "string" ? data.revision : "",
+                occurredAt
+            ].join(":");
+    const provider = typeof resource.provider === "string"
+        ? resource.provider
+        : typeof data.provider === "string"
+            ? data.provider
+            : inferredResource.provider;
     return {
-        id: typeof data.id === "string" ? data.id : "",
-        workspace: typeof data.workspace === "string" ? data.workspace : "",
+        id: eventId,
+        workspace: typeof data.workspace === "string" ? data.workspace : workspaceId ?? "",
         agentId: typeof data.agentId === "string" ? data.agentId : undefined,
         type: "relayfile.changed",
-        occurredAt: typeof data.occurredAt === "string" ? data.occurredAt : new Date().toISOString(),
+        occurredAt,
         resource: {
-            path: typeof resource.path === "string" ? resource.path : "",
-            kind: typeof resource.kind === "string" ? resource.kind : "relayfile.resource",
-            id: typeof resource.id === "string" ? resource.id : "",
-            provider: typeof resource.provider === "string" ? resource.provider : "relayfile"
+            path,
+            kind: typeof resource.kind === "string"
+                ? resource.kind
+                : typeof data.kind === "string"
+                    ? data.kind
+                    : typeof data.resourceType === "string"
+                        ? data.resourceType
+                        : inferredResource.kind,
+            id: typeof resource.id === "string"
+                ? resource.id
+                : typeof data.resourceId === "string"
+                    ? data.resourceId
+                    : typeof data.providerObjectId === "string"
+                        ? data.providerObjectId
+                        : inferredResource.id,
+            provider
         },
         summary: {
+            ...buildChangeSummary(path, data),
             ...(typeof summary.title === "string" ? { title: summary.title } : {}),
             ...(typeof summary.status === "string" ? { status: summary.status } : {}),
             ...(typeof summary.priority === "string" ? { priority: summary.priority } : {}),
@@ -1167,12 +1211,16 @@ export class RelayFileClient {
             cursor: options.cursor,
             limit: options.limit
         });
-        return this.request({
+        const response = await this.request({
             method: "GET",
             path: `/v1/workspaces/${encodeURIComponent(workspaceId)}/fs/events${query}`,
             correlationId: options.correlationId,
             signal: options.signal
         });
+        return {
+            events: (response.events ?? []).map((event) => normalizeFilesystemEvent(event)),
+            nextCursor: response.nextCursor ?? null
+        };
     }
     subscribe(globs, onChange, options) {
         const setup = this.resolveWorkspaceId(options?.aclToken)
@@ -1241,7 +1289,7 @@ export class RelayFileClient {
             });
             records = mergeChangeRecords([
                 ...cached,
-                ...(payload.events ?? []).map((event) => this.cacheWireChangeEvent(workspaceId, normalizeWireChangeEvent(event), effectiveContext))
+                ...(payload.events ?? []).map((event) => this.cacheWireChangeEvent(workspaceId, normalizeWireChangeEvent(event, workspaceId), effectiveContext))
             ]);
         }
         catch (error) {
@@ -1271,7 +1319,7 @@ export class RelayFileClient {
             });
             records = mergeChangeRecords([
                 ...cached,
-                ...(payload.events ?? []).map((event) => this.cacheWireChangeEvent(workspaceId, normalizeWireChangeEvent(event), effectiveContext))
+                ...(payload.events ?? []).map((event) => this.cacheWireChangeEvent(workspaceId, normalizeWireChangeEvent(event, workspaceId), effectiveContext))
             ]).slice(-safeLimit);
         }
         catch (error) {

package/dist/sync.d.ts

@@ -1,5 +1,5 @@
 import type { RelayFileClient } from "./client.js";
-import type { FilesystemEvent } from "./types.js";
+import type { EventOrigin, FilesystemEvent } from "./types.js";
 /**
  * WebSocket auth source for {@link RelayFileSyncOptions.token}.
  *
@@ -73,6 +73,26 @@ type RelayFileSyncHandlerMap = {
     close: (event: CloseEvent) => void;
     pong: (event: RelayFileSyncPong) => void;
 };
+interface RelayFileSyncWireEvent {
+    type: string;
+    id?: string;
+    eventId?: string;
+    path?: string;
+    revision?: string;
+    digest?: string;
+    contentHash?: string;
+    origin?: EventOrigin;
+    provider?: string;
+    correlationId?: string;
+    timestamp?: string;
+    ts?: string;
+    occurredAt?: string;
+    resource?: {
+        path?: unknown;
+        provider?: unknown;
+    };
+}
+export declare function normalizeFilesystemEvent(message?: RelayFileSyncWireEvent | null): FilesystemEvent;
 export declare function normalizeError(event: unknown): unknown;
 export declare class RelayFileSync {
     private readonly client;

package/dist/sync.js

@@ -54,6 +54,7 @@ const DEFAULT_RECONNECT_MAX_DELAY_MS = 5000;
 // for long-running consumers like the factory daemon.
 const DEFAULT_WS_REPROBE_MIN_DELAY_MS = 5000;
 const DEFAULT_WS_REPROBE_MAX_DELAY_MS = 300000;
+const STABLE_FALLBACK_TIMESTAMP = "1970-01-01T00:00:00.000Z";
 // Cap on the dedupe cache used in polling mode. Sized large enough that no
 // realistic workspace burst can churn through it within one poll interval
 // (the events API is itself capped at ~1000 per page), small enough to keep
@@ -122,25 +123,51 @@ function createAbortError() {
     return err;
 }
 function buildEventId(message) {
+    const path = readWirePath(message);
+    const timestamp = readWireTimestamp(message);
+    const type = readWireString(message?.type) ?? "file.updated";
     return [
         "ws",
-        message.type,
-        message.path ?? "",
-        message.revision ?? "",
-        message.timestamp ?? message.ts ?? ""
+        normalizeFilesystemEventType(type),
+        path,
+        readWireString(message?.revision) ?? "",
+        timestamp
     ].join(":");
 }
-function normalizeFilesystemEvent(message) {
+function readWireString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function readWirePath(message) {
+    return readWireString(message?.path) ?? readWireString(message?.resource?.path) ?? "";
+}
+function readWireProvider(message) {
+    return readWireString(message?.provider) ?? readWireString(message?.resource?.provider);
+}
+function readWireTimestamp(message) {
+    return readWireString(message?.timestamp)
+        ?? readWireString(message?.ts)
+        ?? readWireString(message?.occurredAt)
+        ?? STABLE_FALLBACK_TIMESTAMP;
+}
+function normalizeFilesystemEventType(type) {
+    return type === "relayfile.changed" || type === "relayfile.changed.summary"
+        ? "file.updated"
+        : type;
+}
+export function normalizeFilesystemEvent(message) {
+    const path = readWirePath(message);
+    const type = readWireString(message?.type) ?? "file.updated";
+    const digest = readWireString(message?.digest);
     return {
-        eventId: message.eventId ?? buildEventId(message),
-        type: message.type,
-        path: message.path ?? "",
-        revision: message.revision ?? "",
-        contentHash: message.contentHash,
-        origin: message.origin,
-        provider: message.provider,
-        correlationId: message.correlationId,
-        timestamp: message.timestamp ?? message.ts ?? new Date().toISOString()
+        eventId: readWireString(message?.eventId) ?? readWireString(message?.id) ?? buildEventId(message),
+        type: normalizeFilesystemEventType(type),
+        path,
+        revision: readWireString(message?.revision) ?? digest ?? "",
+        contentHash: readWireString(message?.contentHash) ?? digest,
+        origin: message?.origin,
+        provider: readWireProvider(message),
+        correlationId: readWireString(message?.correlationId),
+        timestamp: readWireTimestamp(message)
     };
 }
 // Exported for testing. `ErrorEvent` is a DOM/browser global that is not
@@ -684,6 +711,14 @@ export class RelayFileSync {
             this.emit("error", new Error("Invalid WebSocket payload: 'revision' must be a string."));
             return;
         }
+        if (parsed.resource !== undefined && (typeof parsed.resource !== "object" || parsed.resource === null)) {
+            this.emit("error", new Error("Invalid WebSocket payload: 'resource' must be an object."));
+            return;
+        }
+        if (parsed.resource?.path !== undefined && typeof parsed.resource.path !== "string") {
+            this.emit("error", new Error("Invalid WebSocket payload: 'resource.path' must be a string."));
+            return;
+        }
         if (parsed.timestamp !== undefined && typeof parsed.timestamp !== "string") {
             this.emit("error", new Error("Invalid WebSocket payload: 'timestamp' must be a string."));
             return;
@@ -701,8 +736,8 @@ export class RelayFileSync {
             return;
         }
         const normalized = normalizeFilesystemEvent(parsed);
-        if (parsed.eventId) {
-            this.cursor = parsed.eventId;
+        if (normalized.eventId) {
+            this.cursor = normalized.eventId;
         }
         debugLog("event", { type: normalized.type, path: normalized.path, revision: normalized.revision });
         this.emitFilesystemEvent(normalized);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -59,15 +59,15 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.9.3",
+    "@relayfile/core": "0.9.5",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.9.3",
-    "@relayfile/mount-darwin-x64": "0.9.3",
-    "@relayfile/mount-linux-arm64": "0.9.3",
-    "@relayfile/mount-linux-x64": "0.9.3"
+    "@relayfile/mount-darwin-arm64": "0.9.5",
+    "@relayfile/mount-darwin-x64": "0.9.5",
+    "@relayfile/mount-linux-arm64": "0.9.5",
+    "@relayfile/mount-linux-x64": "0.9.5"
   },
   "peerDependencies": {},
   "devDependencies": {