@relayfile/client 0.10.19 → 0.10.21

package/dist/client.d.ts

@@ -10,13 +10,12 @@ import type { components } from './generated/control-plane.js';
  * authoritative `openapi/relayfile-control-plane-v1.openapi.yaml`, so a field
  * rename in the contract is a compile error here.
  */
-/** Control-plane API version this client speaks. Bump on a breaking wire change. */
-export declare const RELAYFILE_API_VERSION = 1;
+/** Control-plane API version this client speaks. Bump when adding required endpoint support. */
+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 >=
- * this — the check is belt-and-suspenders and the bump point for future
- * contract changes.
+ * this — API compatibility is enforced by RELAYFILE_API_VERSION.
  */
 export declare const MIN_RELAYFILE_VERSION = "0.10.17";
 /** First semver-looking token in a string (tolerates a leading `v` and surrounding words). */
@@ -47,6 +46,12 @@ export type ConnectRequestBody = Schemas['ConnectProviderRequest'];
 export type ConnectResult = Schemas['ConnectProviderResponse'];
 export type ProviderStatusResult = Schemas['ProviderStatus'];
 export type WritebackSecretResult = Schemas['WritebackSecret'];
+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;
@@ -85,6 +90,14 @@ 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. */
     private request;
 }

package/dist/client.js

@@ -13,13 +13,12 @@ import { join } from 'node:path';
  * authoritative `openapi/relayfile-control-plane-v1.openapi.yaml`, so a field
  * rename in the contract is a compile error here.
  */
-/** Control-plane API version this client speaks. Bump on a breaking wire change. */
-export const RELAYFILE_API_VERSION = 1;
+/** Control-plane API version this client speaks. Bump when adding required endpoint support. */
+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 >=
- * this — the check is belt-and-suspenders and the bump point for future
- * contract changes.
+ * this — API compatibility is enforced by RELAYFILE_API_VERSION.
  */
 export const MIN_RELAYFILE_VERSION = '0.10.17';
 const SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
@@ -286,6 +285,32 @@ 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',
+            path: '/v1/integrations/webhook-subscriptions',
+            body: input,
+        });
+    }
+    deleteWebhookSubscription(subscriptionId, workspace) {
+        return this.request({
+            method: 'DELETE',
+            path: '/v1/integrations/webhook-subscriptions',
+            body: { subscriptionId, ...(workspace ? { workspace } : {}) },
+        });
+    }
     /** Endpoint request that ensures the daemon is up + version-compatible first. */
     async request(opts) {
         await this.ensureReady();

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

@@ -158,6 +158,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/integrations/webhook-subscriptions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: 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
+         * @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;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -230,6 +255,8 @@ export interface components {
             webhookId: string;
             webhookToken: string;
             subscriptionId?: string;
+            webhookSubscriptionId?: string;
+            webhookSubscriptionWorkspaceId?: string;
         };
         BindResponse: {
             binding: components["schemas"]["Binding"];
@@ -243,6 +270,8 @@ export interface components {
             webhookId: string;
             webhookToken: string;
             subscriptionId?: string;
+            webhookSubscriptionId?: string;
+            webhookSubscriptionWorkspaceId?: string;
             createdAt?: string;
             updatedAt?: string;
         };
@@ -264,9 +293,40 @@ export interface components {
             channel: string;
         };
         WritebackSecret: {
+            workspaceId?: string;
+            url: string;
+            secret: string;
+        };
+        WebhookSubscriptionRequest: {
+            workspace?: string;
+            /** Format: uri */
             url: string;
+            pathGlobs: string[];
             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;
+        };
+        DeleteWebhookSubscriptionRequest: {
+            workspace?: string;
+            subscriptionId: string;
+        };
+        DeleteWebhookSubscriptionResponse: {
+            ok: boolean;
+        };
+        ListWebhookSubscriptionsResponse: {
+            workspaceId?: string;
+            subscriptions: components["schemas"]["WebhookSubscriptionSummary"][];
+        };
+        WebhookSubscriptionSummary: {
+            subscriptionId: string;
+            /** Format: uri */
+            url: string;
+            pathGlobs: string[];
+        };
         ErrorEnvelope: {
             error: {
                 /** @enum {string} */
@@ -305,7 +365,7 @@ export interface components {
         };
     };
     parameters: {
-        ApiVersionHeader: 1;
+        ApiVersionHeader: 3;
         ApiVersionQuery: number;
     };
     requestBodies: never;
@@ -598,4 +658,80 @@ 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;
+            header?: {
+                "X-Relayfile-API-Version"?: components["parameters"]["ApiVersionHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookSubscriptionRequest"];
+            };
+        };
+        responses: {
+            /** @description Created webhook subscription */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookSubscriptionResponse"];
+                };
+            };
+        };
+    };
+    deleteWebhookSubscription: {
+        parameters: {
+            query?: never;
+            header?: {
+                "X-Relayfile-API-Version"?: components["parameters"]["ApiVersionHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteWebhookSubscriptionRequest"];
+            };
+        };
+        responses: {
+            /** @description Subscription deleted (or already absent) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeleteWebhookSubscriptionResponse"];
+                };
+            };
+        };
+    };
 }

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { RelayfileControlPlaneClient, RelayfileControlPlaneError, RELAYFILE_API_VERSION, MIN_RELAYFILE_VERSION, assertRelayfileVersion, compareSemver, firstSemver, defaultRelayfileSocketPath, } from './client.js';
-export type { RelayfileClientOptions, HelloResponse, RelayfileBindingRecord, ResolvePathResult, BindResult, BindRequestBody, ConnectRequestBody, ConnectResult, ProviderStatusResult, WritebackSecretResult, } from './client.js';
+export type { RelayfileClientOptions, HelloResponse, RelayfileBindingRecord, ResolvePathResult, BindResult, BindRequestBody, ConnectRequestBody, ConnectResult, ProviderStatusResult, WritebackSecretResult, WebhookSubscriptionRequestBody, WebhookSubscriptionResult, DeleteWebhookSubscriptionRequestBody, DeleteWebhookSubscriptionResult, } from './client.js';
 export type { components, paths, operations } from './generated/control-plane.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/client",
-  "version": "0.10.19",
+  "version": "0.10.21",
   "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",