@relayfile/client 0.10.20 → 0.10.22

package/dist/client.d.ts

@@ -11,7 +11,7 @@ import type { components } from './generated/control-plane.js';
  * rename in the contract is a compile error here.
  */
 /** Control-plane API version this client speaks. Bump when adding required endpoint support. */
-export declare const RELAYFILE_API_VERSION = 2;
+export declare const RELAYFILE_API_VERSION = 3;
 /**
  * Minimum `relayfile` daemon version this client requires. The control-plane
  * first shipped in 0.10.17, so anything that answers `/v1/hello` is already >=
@@ -50,6 +50,8 @@ export type WebhookSubscriptionRequestBody = Schemas['WebhookSubscriptionRequest
 export type WebhookSubscriptionResult = Schemas['WebhookSubscriptionResponse'];
 export type DeleteWebhookSubscriptionRequestBody = Schemas['DeleteWebhookSubscriptionRequest'];
 export type DeleteWebhookSubscriptionResult = Schemas['DeleteWebhookSubscriptionResponse'];
+export type ListWebhookSubscriptionsResult = Schemas['ListWebhookSubscriptionsResponse'];
+export type WebhookSubscriptionSummary = Schemas['WebhookSubscriptionSummary'];
 export interface RelayfileClientOptions {
     /** Socket to connect to. Defaults to defaultRelayfileSocketPath(). */
     socketPath?: string;
@@ -88,6 +90,12 @@ export declare class RelayfileControlPlaneClient {
     providerStatus(provider: string): Promise<ProviderStatusResult | null>;
     connect(input: ConnectRequestBody): Promise<ConnectResult>;
     writebackSecret(channel: string, workspace?: string): Promise<WritebackSecretResult>;
+    /**
+     * Lists the workspace's inbound webhook subscriptions so callers can
+     * reconcile subscriptions created by runs that crashed before persisting
+     * the server-assigned id.
+     */
+    listWebhookSubscriptions(workspace?: string): Promise<ListWebhookSubscriptionsResult>;
     createWebhookSubscription(input: WebhookSubscriptionRequestBody): Promise<WebhookSubscriptionResult>;
     deleteWebhookSubscription(subscriptionId: DeleteWebhookSubscriptionRequestBody['subscriptionId'], workspace?: DeleteWebhookSubscriptionRequestBody['workspace']): Promise<DeleteWebhookSubscriptionResult>;
     /** Endpoint request that ensures the daemon is up + version-compatible first. */

package/dist/client.js

@@ -14,7 +14,7 @@ import { join } from 'node:path';
  * rename in the contract is a compile error here.
  */
 /** Control-plane API version this client speaks. Bump when adding required endpoint support. */
-export const RELAYFILE_API_VERSION = 2;
+export const RELAYFILE_API_VERSION = 3;
 /**
  * Minimum `relayfile` daemon version this client requires. The control-plane
  * first shipped in 0.10.17, so anything that answers `/v1/hello` is already >=
@@ -285,6 +285,18 @@ export class RelayfileControlPlaneClient {
             body: { channel, ...(workspace ? { workspace } : {}) },
         });
     }
+    /**
+     * Lists the workspace's inbound webhook subscriptions so callers can
+     * reconcile subscriptions created by runs that crashed before persisting
+     * the server-assigned id.
+     */
+    listWebhookSubscriptions(workspace) {
+        return this.request({
+            method: 'GET',
+            path: '/v1/integrations/webhook-subscriptions',
+            ...(workspace ? { query: { workspace } } : {}),
+        });
+    }
     createWebhookSubscription(input) {
         return this.request({
             method: 'POST',

package/dist/generated/control-plane.d.ts

@@ -165,11 +165,18 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /**
+         * List server-side relayfile webhook subscriptions
+         * @description Lists the workspace's inbound webhook subscriptions so callers can reconcile subscriptions created by runs that crashed before persisting the server-assigned id.
+         */
+        get: operations["listWebhookSubscriptions"];
         put?: never;
         /** Create a server-side relayfile webhook subscription */
         post: operations["createWebhookSubscription"];
-        /** Delete a server-side relayfile webhook subscription */
+        /**
+         * Delete a server-side relayfile webhook subscription
+         * @description Idempotent: deleting a subscription that no longer exists succeeds, so retried cleanups of a known-deleted id observe progress instead of an error.
+         */
         delete: operations["deleteWebhookSubscription"];
         options?: never;
         head?: never;
@@ -248,6 +255,8 @@ export interface components {
             webhookId: string;
             webhookToken: string;
             subscriptionId?: string;
+            webhookSubscriptionId?: string;
+            webhookSubscriptionWorkspaceId?: string;
         };
         BindResponse: {
             binding: components["schemas"]["Binding"];
@@ -261,6 +270,8 @@ export interface components {
             webhookId: string;
             webhookToken: string;
             subscriptionId?: string;
+            webhookSubscriptionId?: string;
+            webhookSubscriptionWorkspaceId?: string;
             createdAt?: string;
             updatedAt?: string;
         };
@@ -282,6 +293,7 @@ export interface components {
             channel: string;
         };
         WritebackSecret: {
+            workspaceId?: string;
             url: string;
             secret: string;
         };
@@ -293,6 +305,8 @@ export interface components {
             secret: string;
         };
         WebhookSubscriptionResponse: {
+            /** @description Workspace the subscription was created in, so callers can pin later delete/list calls to the same workspace. */
+            workspaceId?: string;
             subscriptionId: string;
             secret?: string;
         };
@@ -303,6 +317,16 @@ export interface components {
         DeleteWebhookSubscriptionResponse: {
             ok: boolean;
         };
+        ListWebhookSubscriptionsResponse: {
+            workspaceId?: string;
+            subscriptions: components["schemas"]["WebhookSubscriptionSummary"][];
+        };
+        WebhookSubscriptionSummary: {
+            subscriptionId: string;
+            /** Format: uri */
+            url: string;
+            pathGlobs: string[];
+        };
         ErrorEnvelope: {
             error: {
                 /** @enum {string} */
@@ -341,7 +365,7 @@ export interface components {
         };
     };
     parameters: {
-        ApiVersionHeader: 2;
+        ApiVersionHeader: 3;
         ApiVersionQuery: number;
     };
     requestBodies: never;
@@ -634,6 +658,30 @@ export interface operations {
             };
         };
     };
+    listWebhookSubscriptions: {
+        parameters: {
+            query?: {
+                workspace?: string;
+            };
+            header?: {
+                "X-Relayfile-API-Version"?: components["parameters"]["ApiVersionHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Webhook subscriptions for the workspace */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListWebhookSubscriptionsResponse"];
+                };
+            };
+        };
+    };
     createWebhookSubscription: {
         parameters: {
             query?: never;
@@ -675,7 +723,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Subscription deleted */
+            /** @description Subscription deleted (or already absent) */
             200: {
                 headers: {
                     [name: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/client",
-  "version": "0.10.20",
+  "version": "0.10.22",
   "description": "Typed client for the relayfile local control-plane (unix-socket HTTP/JSON), generated from the authoritative OpenAPI contract",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",