@relayfile/sdk 0.2.2 → 0.3.1

package/dist/client.js

@@ -214,7 +214,7 @@ export class RelayFileClient {
         });
     }
     async writeFile(input) {
-        const { workspaceId, path, correlationId, baseRevision, content, contentType, encoding, semantics, signal } = input;
+        const { workspaceId, path, correlationId, baseRevision, content, contentType, encoding, contentIdentity, signal } = input;
         const query = buildQuery({ path });
         return this.request({
             method: "PUT",
@@ -228,7 +228,8 @@ export class RelayFileClient {
                 contentType: contentType ?? "text/markdown",
                 content,
                 encoding,
-                semantics: input.semantics
+                semantics: input.semantics,
+                ...(contentIdentity ? { contentIdentity } : {})
             },
             signal
         });

package/dist/index.d.ts

@@ -4,7 +4,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, AckWritebackResponse, AdminIngressAlert, AdminIngressAlertProfile, AdminIngressEffectiveAlertProfile, AdminIngressAlertSeverity, AdminIngressAlertThresholds, AdminIngressAlertTotals, AdminIngressAlertType, AdminIngressStatusResponse, AdminSyncAlert, AdminSyncAlertSeverity, AdminSyncAlertThresholds, AdminSyncAlertTotals, AdminSyncAlertType, AdminSyncStatusResponse, BackendStatusResponse, BulkWriteFile, BulkWriteInput, BulkWriteResponse, ConflictErrorResponse, DeleteFileInput, DeadLetterFeedResponse, DeadLetterItem, ErrorResponse, EventFeedResponse, ExportFormat, ExportJsonResponse, ExportOptions, FileQueryItem, FileQueryResponse, FileReadResponse, FileSemantics, FileWriteRequest, FilesystemEvent, FilesystemEventType, EventOrigin, GetEventsOptions, GetAdminSyncStatusOptions, GetAdminIngressStatusOptions, GetOperationsOptions, GetSyncDeadLettersOptions, GetSyncIngressStatusOptions, GetSyncStatusOptions, IngestWebhookInput, ListTreeOptions, OperationFeedResponse, OperationStatus, OperationStatusResponse, QueuedResponse, QueryFilesOptions, RelayFileJwtClaims, SyncIngressStatusResponse, SyncProviderStatus, SyncProviderStatusState, SyncRefreshRequest, SyncStatusResponse, TreeEntry, TreeResponse, WritebackActionType, WritebackState, WritebackItem, WriteFileInput, WriteQueuedResponse } from "./types.js";
+export type { AckResponse, AckWritebackInput, AckWritebackResponse, AdminIngressAlert, AdminIngressAlertProfile, AdminIngressEffectiveAlertProfile, AdminIngressAlertSeverity, AdminIngressAlertThresholds, AdminIngressAlertTotals, AdminIngressAlertType, AdminIngressStatusResponse, AdminSyncAlert, AdminSyncAlertSeverity, AdminSyncAlertThresholds, AdminSyncAlertTotals, AdminSyncAlertType, AdminSyncStatusResponse, BackendStatusResponse, BulkWriteFile, BulkWriteInput, BulkWriteResponse, ConflictErrorResponse, ContentIdentity, DeleteFileInput, DeadLetterFeedResponse, DeadLetterItem, ErrorResponse, EventFeedResponse, ExportFormat, ExportJsonResponse, ExportOptions, FileQueryItem, FileQueryResponse, FileReadResponse, FileSemantics, FileWriteRequest, FilesystemEvent, FilesystemEventType, EventOrigin, GetEventsOptions, GetAdminSyncStatusOptions, GetAdminIngressStatusOptions, GetOperationsOptions, GetSyncDeadLettersOptions, GetSyncIngressStatusOptions, GetSyncStatusOptions, IngestWebhookInput, ListTreeOptions, OperationFeedResponse, OperationStatus, OperationStatusResponse, QueuedResponse, QueryFilesOptions, RelayFileJwtClaims, SyncIngressStatusResponse, SyncProviderStatus, SyncProviderStatusState, SyncRefreshRequest, SyncStatusResponse, TreeEntry, TreeResponse, WritebackActionType, WritebackState, WritebackItem, WriteFileInput, WriteQueuedResponse } from "./types.js";
 export { WritebackConsumer } from "./writeback-consumer.js";
 export type { WritebackHandler, WritebackConsumerOptions } from "./writeback-consumer.js";
 export * from "./integration-adapter.js";

package/dist/types.d.ts

@@ -44,6 +44,17 @@ export interface FileSemantics {
     permissions?: string[];
     comments?: string[];
 }
+/**
+ * Stable identity for an idempotent write, used by the server to coalesce
+ * duplicate deliveries (webhook retries, cross-product fan-in). Two writes
+ * with equal `(kind, key)` in the same workspace within the dedup window
+ * resolve to the same op. Callers typically derive `key` from the upstream
+ * event id, e.g. `github:push:<sha>`.
+ */
+export interface ContentIdentity {
+    kind: string;
+    key: string;
+}
 export interface FileReadResponse {
     path: string;
     revision: string;
@@ -60,12 +71,14 @@ export interface FileWriteRequest {
     content: string;
     encoding?: "utf-8" | "base64";
     semantics?: FileSemantics;
+    contentIdentity?: ContentIdentity;
 }
 export interface BulkWriteFile {
     path: string;
     contentType?: string;
     content: string;
     encoding?: "utf-8" | "base64";
+    contentIdentity?: ContentIdentity;
 }
 export interface BulkWriteInput {
     workspaceId: string;
@@ -435,6 +448,7 @@ export interface WriteFileInput {
     contentType?: string;
     encoding?: "utf-8" | "base64";
     semantics?: FileSemantics;
+    contentIdentity?: ContentIdentity;
     correlationId?: string;
     signal?: AbortSignal;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",