@relayfile/sdk 0.8.28 → 0.8.30

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type AdminIngressStatusResponse, type AdminSyncStatusResponse, type BulkWriteInput, type BulkWriteResponse, type BackendStatusResponse, type AckResponse, type CommitForkInput, type CommitForkResponse, type CreateForkInput, type DeleteFileInput, type DeadLetterItem, type DeadLetterFeedResponse, type DiscardForkInput, type EventFeedResponse, type ExportJsonResponse, type ExportOptions, type FileQueryResponse, type FileReadResponse, type FilesystemEvent, type GetEventsOptions, type GetAdminIngressStatusOptions, type GetAdminSyncStatusOptions, type GetOperationsOptions, type GetSyncDeadLettersOptions, type GetSyncIngressStatusOptions, type GetSyncStatusOptions, type ListTreeOptions, type OperationFeedResponse, type OperationStatusResponse, type QueuedResponse, type ResourceAtEventResult, type ReadFileInput, type QueryFilesOptions, type Subscription, type SyncIngressStatusResponse, type SyncStatusResponse, type TreeResponse, type WriteFileInput, type WriteQueuedResponse, type IngestWebhookInput, type WritebackItem, type AckWritebackInput, type AckWritebackResponse, type SweepWritebackDraftsInput, type SweepWritebackDraftsResponse, type ChangeEvent, type ChangeLogQueryResult, type ChangeStreamConnection, type ChangeStreamConnectionOptions, type SubscribeOptions } from "./types.js";
+import { type AdminIngressStatusResponse, type AdminSyncStatusResponse, type BulkWriteInput, type BulkWriteResponse, type BackendStatusResponse, type AckResponse, type CommitForkInput, type CommitForkResponse, type CreateForkInput, type DeleteFileInput, type DeadLetterItem, type DeadLetterFeedResponse, type DeleteWebhookOptions, type DiscardForkInput, type EventFeedResponse, type ExportJsonResponse, type ExportOptions, type FileQueryResponse, type FileReadResponse, type FilesystemEvent, type GetEventsOptions, type GetAdminIngressStatusOptions, type GetAdminSyncStatusOptions, type GetOperationsOptions, type GetSyncDeadLettersOptions, type GetSyncIngressStatusOptions, type GetSyncStatusOptions, type GetWebhookDeadLettersOptions, type ListWebhooksOptions, type ListTreeOptions, type OperationFeedResponse, type OperationStatusResponse, type QueuedResponse, type ResourceAtEventResult, type ReadFileInput, type QueryFilesOptions, type RegisterWebhookInput, type RegisterWebhookResponse, type Subscription, type SyncIngressStatusResponse, type SyncStatusResponse, type TreeResponse, type WriteFileInput, type WriteQueuedResponse, type IngestWebhookInput, type WritebackItem, type WebhookDeliveryDeadLetterFeedResponse, type WebhookSubscription, type AckWritebackInput, type AckWritebackResponse, type SweepWritebackDraftsInput, type SweepWritebackDraftsResponse, type ChangeEvent, type ChangeLogQueryResult, type ChangeStreamConnection, type ChangeStreamConnectionOptions, type SubscribeOptions } from "./types.js";
 import type { ForkHandle } from "@relayfile/core";
 /**
  * Bearer token or token factory used for Relayfile API requests.
@@ -125,6 +125,11 @@ export declare class RelayFileClient {
     ackSyncDeadLetter(workspaceId: string, envelopeId: string, correlationId?: string, signal?: AbortSignal): Promise<AckResponse>;
     triggerSyncRefresh(workspaceId: string, provider: string, reason?: string, correlationId?: string, signal?: AbortSignal): Promise<QueuedResponse>;
     ingestWebhook(input: IngestWebhookInput): Promise<QueuedResponse>;
+    registerWebhook(input: RegisterWebhookInput): Promise<RegisterWebhookResponse>;
+    listWebhooks(workspaceId: string, options?: ListWebhooksOptions): Promise<WebhookSubscription[]>;
+    deleteWebhook(workspaceId: string, subscriptionId: string, options?: DeleteWebhookOptions): Promise<void>;
+    getWebhookDeadLetters(workspaceId: string, options?: GetWebhookDeadLettersOptions): Promise<WebhookDeliveryDeadLetterFeedResponse>;
+    replayWebhookDeadLetter(workspaceId: string, deliveryId: string, correlationId?: string, signal?: AbortSignal): Promise<QueuedResponse>;
     listPendingWritebacks(workspaceId: string, correlationId?: string, signal?: AbortSignal): Promise<WritebackItem[]>;
     ackWriteback(input: AckWritebackInput): Promise<AckWritebackResponse>;
     /**

package/dist/client.js

@@ -1508,6 +1508,79 @@ export class RelayFileClient {
             signal: input.signal
         });
     }
+    async registerWebhook(input) {
+        if (!input.workspaceId) {
+            throw new Error("workspaceId is required");
+        }
+        if (!input.url) {
+            throw new Error("url is required");
+        }
+        return this.request({
+            method: "POST",
+            path: `/v1/workspaces/${encodeURIComponent(input.workspaceId)}/webhooks`,
+            correlationId: input.correlationId,
+            body: {
+                url: input.url,
+                pathGlobs: input.pathGlobs,
+                secret: input.secret
+            },
+            signal: input.signal
+        });
+    }
+    async listWebhooks(workspaceId, options = {}) {
+        if (!workspaceId) {
+            throw new Error("workspaceId is required");
+        }
+        return this.request({
+            method: "GET",
+            path: `/v1/workspaces/${encodeURIComponent(workspaceId)}/webhooks`,
+            correlationId: options.correlationId,
+            signal: options.signal
+        });
+    }
+    async deleteWebhook(workspaceId, subscriptionId, options = {}) {
+        if (!workspaceId) {
+            throw new Error("workspaceId is required");
+        }
+        if (!subscriptionId) {
+            throw new Error("subscriptionId is required");
+        }
+        await this.performRequest({
+            method: "DELETE",
+            path: `/v1/workspaces/${encodeURIComponent(workspaceId)}/webhooks/${encodeURIComponent(subscriptionId)}`,
+            correlationId: options.correlationId,
+            signal: options.signal
+        });
+    }
+    async getWebhookDeadLetters(workspaceId, options = {}) {
+        if (!workspaceId) {
+            throw new Error("workspaceId is required");
+        }
+        const query = buildQuery({
+            cursor: options.cursor,
+            limit: options.limit
+        });
+        return this.request({
+            method: "GET",
+            path: `/v1/workspaces/${encodeURIComponent(workspaceId)}/webhooks/dlq${query}`,
+            correlationId: options.correlationId,
+            signal: options.signal
+        });
+    }
+    async replayWebhookDeadLetter(workspaceId, deliveryId, correlationId, signal) {
+        if (!workspaceId) {
+            throw new Error("workspaceId is required");
+        }
+        if (!deliveryId) {
+            throw new Error("deliveryId is required");
+        }
+        return this.request({
+            method: "POST",
+            path: `/v1/workspaces/${encodeURIComponent(workspaceId)}/webhooks/dlq/${encodeURIComponent(deliveryId)}/replay`,
+            correlationId,
+            signal
+        });
+    }
     async listPendingWritebacks(workspaceId, correlationId, signal) {
         return this.request({
             method: "GET",

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { InvalidStateError, PayloadTooLargeError, QueueFullError, RelayFileApiEr
 export { IntegrationProvider, computeCanonicalPath } from "./provider.js";
 export type { WebhookInput, ListProviderFilesOptions, WatchProviderEventsOptions } from "./provider.js";
 export type { ConnectionProvider, NormalizedWebhook, ProxyHeaders, ProxyMethod, ProxyQuery, ProxyRequest, ProxyResponse, } from "./connection.js";
-export type { AckResponse, AckWritebackInput, AckWritebackDraftDisposition, AckWritebackResponse, AdminIngressAlert, AdminIngressAlertProfile, AdminIngressEffectiveAlertProfile, AdminIngressAlertSeverity, AdminIngressAlertThresholds, AdminIngressAlertTotals, AdminIngressAlertType, AdminIngressStatusResponse, AdminSyncAlert, AdminSyncAlertSeverity, AdminSyncAlertThresholds, AdminSyncAlertTotals, AdminSyncAlertType, AdminSyncStatusResponse, BackendStatusResponse, BulkWriteFile, BulkWriteInput, BulkWriteResponse, ChangeLogQueryResult, ChangeEvent, ChangeEventActor, ChangeEventResource, ChangeEventSummary, ChangeStreamConnection, ChangeStreamConnectionOptions, CommitForkInput, CommitForkResponse, ConflictErrorResponse, CreateForkInput, ContentIdentity, DeleteFileInput, DeadLetterFeedResponse, DeadLetterItem, DigestBullet, DigestContext, DigestHandler, DigestSection, DigestWindow, DiscardForkInput, ErrorResponse, EventSummary, EventFeedResponse, ExportFormat, ExportJsonResponse, ExportOptions, FileQueryItem, FileQueryResponse, FileReadResponse, FileSemantics, FileWriteRequest, FilesystemEvent, FilesystemEventType, EventOrigin, Expansion, ExpansionLevel, GetEventsOptions, GetAdminSyncStatusOptions, GetAdminIngressStatusOptions, GetOperationsOptions, GetSyncDeadLettersOptions, GetSyncIngressStatusOptions, GetSyncStatusOptions, IngestWebhookInput, LayoutManifest, LayoutManifestAlias, LayoutManifestResource, ListTreeOptions, OperationFeedResponse, OperationStatus, OperationStatusResponse, QueuedResponse, QueryFilesOptions, ReadFileInput, ReplayOptions, ResourceAtEventResult, SummaryExpansion, FullExpansion, DiffExpansion, ThreadExpansion, RelayFileJwtClaims, SubscribeOptions, Subscription, SyncIngressStatusResponse, SyncProviderStatus, SyncProviderStatusState, SyncRefreshRequest, SyncStatusResponse, SweepWritebackDraftsInput, SweepWritebackDraftsResponse, TreeEntry, TreeResponse, WritebackActionType, WritebackDeadLetterError, WritebackDeadLetterErrorCode, WritebackListState, WritebackState, WritebackItem, WritebackItemDetail, WritebackSchemaRef, WriteFileInput, WriteQueuedResponse } from "./types.js";
+export type { AckResponse, AckWritebackInput, AckWritebackDraftDisposition, AckWritebackResponse, AdminIngressAlert, AdminIngressAlertProfile, AdminIngressEffectiveAlertProfile, AdminIngressAlertSeverity, AdminIngressAlertThresholds, AdminIngressAlertTotals, AdminIngressAlertType, AdminIngressStatusResponse, AdminSyncAlert, AdminSyncAlertSeverity, AdminSyncAlertThresholds, AdminSyncAlertTotals, AdminSyncAlertType, AdminSyncStatusResponse, BackendStatusResponse, BulkWriteFile, BulkWriteInput, BulkWriteResponse, ChangeLogQueryResult, ChangeEvent, ChangeEventActor, ChangeEventResource, ChangeEventSummary, ChangeStreamConnection, ChangeStreamConnectionOptions, CommitForkInput, CommitForkResponse, ConflictErrorResponse, CreateForkInput, ContentIdentity, DeleteFileInput, DeleteWebhookOptions, DeadLetterFeedResponse, DeadLetterItem, DigestBullet, DigestContext, DigestHandler, DigestSection, DigestWindow, DiscardForkInput, ErrorResponse, EventSummary, EventFeedResponse, ExportFormat, ExportJsonResponse, ExportOptions, FileQueryItem, FileQueryResponse, FileReadResponse, FileSemantics, FileWriteRequest, FilesystemEvent, FilesystemEventType, EventOrigin, Expansion, ExpansionLevel, GetEventsOptions, GetAdminSyncStatusOptions, GetAdminIngressStatusOptions, GetOperationsOptions, GetSyncDeadLettersOptions, GetSyncIngressStatusOptions, GetSyncStatusOptions, GetWebhookDeadLettersOptions, IngestWebhookInput, LayoutManifest, LayoutManifestAlias, LayoutManifestResource, ListWebhooksOptions, ListTreeOptions, OperationFeedResponse, OperationStatus, OperationStatusResponse, QueuedResponse, QueryFilesOptions, ReadFileInput, RegisterWebhookInput, RegisterWebhookResponse, ReplayOptions, ResourceAtEventResult, SummaryExpansion, FullExpansion, DiffExpansion, ThreadExpansion, RelayFileJwtClaims, SubscribeOptions, Subscription, SyncIngressStatusResponse, SyncProviderStatus, SyncProviderStatusState, SyncRefreshRequest, SyncStatusResponse, SweepWritebackDraftsInput, SweepWritebackDraftsResponse, TreeEntry, TreeResponse, WebhookDeliveryDeadLetterFeedResponse, WebhookDeliveryDeadLetterItem, WebhookSubscription, WebhookSubscriptionHealth, WritebackActionType, WritebackDeadLetterError, WritebackDeadLetterErrorCode, WritebackListState, WritebackState, WritebackItem, WritebackItemDetail, WritebackSchemaRef, WriteFileInput, WriteQueuedResponse } from "./types.js";
 export type { ForkHandle, ForkOptions } from "@relayfile/core";
 export type { WriteEvent, WriteEventActor, WriteEventOperation, WriteEventSource } from "@relayfile/core";
 export { WritebackConsumer } from "./writeback-consumer.js";

package/dist/sync.js

@@ -136,6 +136,7 @@ function normalizeFilesystemEvent(message) {
         type: message.type,
         path: message.path ?? "",
         revision: message.revision ?? "",
+        contentHash: message.contentHash,
         origin: message.origin,
         provider: message.provider,
         correlationId: message.correlationId,

package/dist/types.d.ts

@@ -144,6 +144,7 @@ export interface FilesystemEvent {
     type: FilesystemEventType;
     path: string;
     revision: string;
+    contentHash?: string;
     origin?: EventOrigin;
     provider?: string;
     correlationId?: string;
@@ -616,6 +617,66 @@ export interface DeadLetterFeedResponse {
     items: DeadLetterItem[];
     nextCursor: string | null;
 }
+export interface WebhookSubscriptionHealth {
+    lastDeliveryAt: string | null;
+    lastSuccessAt: string | null;
+    lastError: string | null;
+    consecutiveFailures: number;
+}
+export interface WebhookSubscription {
+    id: string;
+    url: string;
+    pathGlobs: string[];
+    createdAt: string;
+    updatedAt: string;
+    health: WebhookSubscriptionHealth;
+}
+export interface RegisterWebhookInput {
+    workspaceId: string;
+    url: string;
+    pathGlobs: string[];
+    /**
+     * Optional HMAC secret. If omitted, relayfile generates a secret and returns
+     * it once from the registration response.
+     */
+    secret?: string;
+    correlationId?: string;
+    signal?: AbortSignal;
+}
+export interface RegisterWebhookResponse {
+    subscriptionId: string;
+    secret?: string;
+}
+export interface ListWebhooksOptions {
+    correlationId?: string;
+    signal?: AbortSignal;
+}
+export interface DeleteWebhookOptions {
+    correlationId?: string;
+    signal?: AbortSignal;
+}
+export interface GetWebhookDeadLettersOptions {
+    cursor?: string;
+    limit?: number;
+    correlationId?: string;
+    signal?: AbortSignal;
+}
+export interface WebhookDeliveryDeadLetterItem {
+    deliveryId: string;
+    workspaceId: string;
+    subscriptionId: string;
+    eventId: string;
+    url: string;
+    failedAt: string;
+    attemptCount: number;
+    lastError: string;
+    replayCount: number;
+    status: "dead_lettered" | "queued" | "delivered";
+}
+export interface WebhookDeliveryDeadLetterFeedResponse {
+    items: WebhookDeliveryDeadLetterItem[];
+    nextCursor: string | null;
+}
 export interface WriteFileInput {
     workspaceId: string;
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.8.28",
+  "version": "0.8.30",
   "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.8.28",
+    "@relayfile/core": "0.8.30",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.8.28",
-    "@relayfile/mount-darwin-x64": "0.8.28",
-    "@relayfile/mount-linux-arm64": "0.8.28",
-    "@relayfile/mount-linux-x64": "0.8.28"
+    "@relayfile/mount-darwin-arm64": "0.8.30",
+    "@relayfile/mount-darwin-x64": "0.8.30",
+    "@relayfile/mount-linux-arm64": "0.8.30",
+    "@relayfile/mount-linux-x64": "0.8.30"
   },
   "peerDependencies": {},
   "devDependencies": {