@relayfile/client 0.10.17 → 0.10.20

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 = 2;
 /**
  * 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,10 @@ 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 interface RelayfileClientOptions {
     /** Socket to connect to. Defaults to defaultRelayfileSocketPath(). */
     socketPath?: string;
@@ -85,6 +88,8 @@ export declare class RelayfileControlPlaneClient {
     providerStatus(provider: string): Promise<ProviderStatusResult | null>;
     connect(input: ConnectRequestBody): Promise<ConnectResult>;
     writebackSecret(channel: string, workspace?: string): Promise<WritebackSecretResult>;
+    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 = 2;
 /**
  * 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,20 @@ export class RelayfileControlPlaneClient {
             body: { channel, ...(workspace ? { 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,24 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/integrations/webhook-subscriptions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a server-side relayfile webhook subscription */
+        post: operations["createWebhookSubscription"];
+        /** Delete a server-side relayfile webhook subscription */
+        delete: operations["deleteWebhookSubscription"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -267,6 +285,24 @@ export interface components {
             url: string;
             secret: string;
         };
+        WebhookSubscriptionRequest: {
+            workspace?: string;
+            /** Format: uri */
+            url: string;
+            pathGlobs: string[];
+            secret: string;
+        };
+        WebhookSubscriptionResponse: {
+            subscriptionId: string;
+            secret?: string;
+        };
+        DeleteWebhookSubscriptionRequest: {
+            workspace?: string;
+            subscriptionId: string;
+        };
+        DeleteWebhookSubscriptionResponse: {
+            ok: boolean;
+        };
         ErrorEnvelope: {
             error: {
                 /** @enum {string} */
@@ -305,7 +341,7 @@ export interface components {
         };
     };
     parameters: {
-        ApiVersionHeader: 1;
+        ApiVersionHeader: 2;
         ApiVersionQuery: number;
     };
     requestBodies: never;
@@ -598,4 +634,56 @@ export interface operations {
             };
         };
     };
+    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 */
+            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.17",
+  "version": "0.10.20",
   "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",
@@ -29,6 +29,10 @@
     "typescript": "^5.7.3",
     "vitest": "^3.0.0"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/AgentWorkforce/relayfile",