@relayfile/sdk 0.7.12 → 0.7.14

package/dist/index.d.ts

@@ -10,7 +10,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, ChangeLogQueryResult, ChangeEvent, ChangeEventActor, ChangeEventResource, ChangeEventSummary, ChangeStreamConnection, ChangeStreamConnectionOptions, CommitForkInput, CommitForkResponse, ConflictErrorResponse, CreateForkInput, ContentIdentity, DeleteFileInput, DeadLetterFeedResponse, DeadLetterItem, 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, ListTreeOptions, OperationFeedResponse, OperationStatus, OperationStatusResponse, QueuedResponse, QueryFilesOptions, ReadFileInput, ReplayOptions, ResourceAtEventResult, SummaryExpansion, FullExpansion, DiffExpansion, ThreadExpansion, RelayFileJwtClaims, SubscribeOptions, Subscription, 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, 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, TreeEntry, TreeResponse, 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/types.d.ts

@@ -115,6 +115,7 @@ export interface FileQueryResponse {
     nextCursor: string | null;
 }
 export type WritebackState = "pending" | "succeeded" | "failed" | "dead_lettered";
+export type WritebackListState = WritebackState | "dead";
 export interface WriteQueuedResponse {
     opId: string;
     status: "queued" | "pending";
@@ -204,6 +205,54 @@ export interface ChangeEvent {
     expand<L extends ExpansionLevel = "summary">(level?: L): Promise<Expansion<L>>;
     digest?: string;
 }
+export interface DigestWindow {
+    /** ISO 8601, inclusive. */
+    readonly from: string;
+    /** ISO 8601, exclusive. */
+    readonly to: string;
+}
+export interface DigestBullet {
+    /** One-line past-tense description, e.g. "AGE-16 moved to in-review". */
+    readonly text: string;
+    /** Mount-relative canonical path the bullet points at. */
+    readonly canonicalPath: string;
+}
+export interface DigestSection {
+    readonly provider: string;
+    readonly bullets: readonly DigestBullet[];
+}
+export interface DigestContext {
+    readonly provider: string;
+    readonly window: DigestWindow;
+    changeEvents(filter?: {
+        providers?: string[];
+        paths?: string[];
+    }): Promise<readonly ChangeEvent[]>;
+}
+export type DigestHandler = (ctx: DigestContext) => Promise<DigestSection | null>;
+export interface WritebackSchemaRef {
+    readonly provider: string;
+    readonly resource: string;
+    /** Mount-relative path to the served `.schema.json` virtual file. */
+    readonly path: string;
+}
+export interface LayoutManifestAlias {
+    /** e.g. "by-title", "by-id", "by-edited". */
+    readonly segment: string;
+    readonly description?: string;
+}
+export interface LayoutManifestResource {
+    readonly name: string;
+    readonly canonicalFilename: string;
+    readonly writebackActions?: readonly string[];
+    readonly writebackSchemas?: readonly WritebackSchemaRef[];
+    readonly aliases?: readonly LayoutManifestAlias[];
+}
+export interface LayoutManifest {
+    readonly provider: string;
+    readonly materialization: "eager" | "lazy";
+    readonly resources: readonly LayoutManifestResource[];
+}
 export interface SubscribeOptions {
     coalesce?: "none" | "fire-once";
     coalesceMs?: number;
@@ -608,12 +657,39 @@ export interface IngestWebhookInput {
     correlationId?: string;
     signal?: AbortSignal;
 }
+export type WritebackDeadLetterErrorCode = "schema_violation" | "provider_4xx" | "provider_5xx_exhausted" | "timeout";
+export interface WritebackDeadLetterError {
+    code: WritebackDeadLetterErrorCode;
+    message: string;
+    providerStatus?: number;
+    providerResponse?: Record<string, unknown>;
+    attempts: number;
+    firstAttemptAt: string;
+    lastAttemptAt: string;
+    opId: string;
+}
 export interface WritebackItem {
     id: string;
     workspaceId: string;
     path: string;
     revision: string;
     correlationId: string;
+    state?: WritebackListState;
+    provider?: string;
+    action?: WritebackActionType;
+    ts?: string;
+    code?: WritebackDeadLetterErrorCode | string;
+    message?: string;
+    providerStatus?: number;
+    providerResponse?: Record<string, unknown>;
+    attempts?: number;
+    firstAttemptAt?: string;
+    enqueuedAt?: string;
+    lastAttemptAt?: string;
+    error?: WritebackDeadLetterError;
+}
+export interface WritebackItemDetail extends WritebackItem {
+    error?: WritebackDeadLetterError;
 }
 export interface AckWritebackInput {
     workspaceId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.7.12",
+  "version": "0.7.14",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.7.12"
+    "@relayfile/core": "0.7.14"
   },
   "devDependencies": {
     "typescript": "^5.7.3",