@openvcs/sdk 0.4.2 → 0.4.3-beta.145

package/lib/runtime/vcs-delegate-base.d.ts

@@ -125,5 +125,9 @@ export declare abstract class VcsDelegateBase<TDeps, TContext = PluginRuntimeCon
     cherryPick(_params: VcsTypes.VcsCherryPickParams, _context: TContext): VcsHandlerResult<null>;
     /** Handles `vcs.revert_commit`. */
     revertCommit(_params: VcsTypes.VcsRevertCommitParams, _context: TContext): VcsHandlerResult<null>;
+    /** Handles `vcs.validate_url`. */
+    validateUrl(_params: VcsTypes.VcsValidateUrlParams, _context: TContext): VcsHandlerResult<VcsTypes.VcsValidationResult>;
+    /** Handles `vcs.validate_path`. */
+    validatePath(_params: VcsTypes.VcsValidatePathParams, _context: TContext): VcsHandlerResult<VcsTypes.VcsValidationResult>;
 }
 export {};

package/lib/runtime/vcs-delegate-base.js

@@ -253,5 +253,13 @@ class VcsDelegateBase {
     revertCommit(_params, _context) {
         return this.unimplemented('revertCommit');
     }
+    /** Handles `vcs.validate_url`. */
+    validateUrl(_params, _context) {
+        return this.unimplemented('validateUrl');
+    }
+    /** Handles `vcs.validate_path`. */
+    validatePath(_params, _context) {
+        return this.unimplemented('validatePath');
+    }
 }
 exports.VcsDelegateBase = VcsDelegateBase;

package/lib/runtime/vcs-delegate-metadata.d.ts

@@ -54,6 +54,8 @@ export type VcsDelegateBindings<TContext> = {
     stashShow: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.stash_show']>;
     cherryPick: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.cherry_pick']>;
     revertCommit: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.revert_commit']>;
+    validateUrl: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.validate_url']>;
+    validatePath: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.validate_path']>;
 };
 /** Enumerates the class-friendly method names recognized by `VcsDelegateBase`. */
 export type VcsDelegateMethodName = keyof VcsDelegateBindings<PluginRuntimeContext>;
@@ -111,6 +113,8 @@ export declare const VCS_DELEGATE_METHOD_MAPPINGS: {
     readonly stashShow: "vcs.stash_show";
     readonly cherryPick: "vcs.cherry_pick";
     readonly revertCommit: "vcs.revert_commit";
+    readonly validateUrl: "vcs.validate_url";
+    readonly validatePath: "vcs.validate_path";
 };
 /** Resolves the RPC method implemented by one class-friendly delegate method. */
 export type VcsDelegateRpcMethodName<TMethodName extends VcsDelegateMethodName> = (typeof VCS_DELEGATE_METHOD_MAPPINGS)[TMethodName];

package/lib/runtime/vcs-delegate-metadata.js

@@ -57,4 +57,6 @@ exports.VCS_DELEGATE_METHOD_MAPPINGS = {
     stashShow: 'vcs.stash_show',
     cherryPick: 'vcs.cherry_pick',
     revertCommit: 'vcs.revert_commit',
+    validateUrl: 'vcs.validate_url',
+    validatePath: 'vcs.validate_path',
 };

package/lib/types/vcs.d.ts

@@ -395,6 +395,23 @@ export interface VcsRevertCommitParams extends VcsSessionParams {
     /** Indicates whether the editor should be skipped. */
     no_edit?: boolean;
 }
+/** Describes the result returned by URL or path validation. */
+export interface VcsValidationResult {
+    /** Indicates whether the URL or path is valid for this backend. */
+    ok: boolean;
+    /** Stores an optional human-readable reason when validation fails. */
+    reason?: string;
+}
+/** Describes params for `vcs.validate_url`. */
+export interface VcsValidateUrlParams extends RequestParams {
+    /** Stores the repository URL to validate. */
+    url: string;
+}
+/** Describes params for `vcs.validate_path`. */
+export interface VcsValidatePathParams extends RequestParams {
+    /** Stores the local path to validate. */
+    path: string;
+}
 /** Describes the delegate map supported by the SDK runtime for `vcs.*`. */
 export interface VcsDelegates<TContext = unknown> {
     /** Handles `vcs.get_caps`. */
@@ -501,4 +518,8 @@ export interface VcsDelegates<TContext = unknown> {
     'vcs.cherry_pick'?: RpcMethodHandler<VcsCherryPickParams, null, TContext>;
     /** Handles `vcs.revert_commit`. */
     'vcs.revert_commit'?: RpcMethodHandler<VcsRevertCommitParams, null, TContext>;
+    /** Handles `vcs.validate_url`. */
+    'vcs.validate_url'?: RpcMethodHandler<VcsValidateUrlParams, VcsValidationResult, TContext>;
+    /** Handles `vcs.validate_path`. */
+    'vcs.validate_path'?: RpcMethodHandler<VcsValidatePathParams, VcsValidationResult, TContext>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvcs/sdk",
-  "version": "0.4.2",
+  "version": "0.4.3-beta.145",
   "description": "OpenVCS SDK CLI for plugin scaffolding and runtime asset builds",
   "license": "GPL-3.0-or-later",
   "homepage": "https://openvcs.app/",

package/src/lib/runtime/vcs-delegate-base.ts

@@ -494,4 +494,20 @@ export abstract class VcsDelegateBase<
   ): VcsHandlerResult<null> {
     return this.unimplemented('revertCommit');
   }
+
+  /** Handles `vcs.validate_url`. */
+  validateUrl(
+    _params: VcsTypes.VcsValidateUrlParams,
+    _context: TContext,
+  ): VcsHandlerResult<VcsTypes.VcsValidationResult> {
+    return this.unimplemented('validateUrl');
+  }
+
+  /** Handles `vcs.validate_path`. */
+  validatePath(
+    _params: VcsTypes.VcsValidatePathParams,
+    _context: TContext,
+  ): VcsHandlerResult<VcsTypes.VcsValidationResult> {
+    return this.unimplemented('validatePath');
+  }
 }

package/src/lib/runtime/vcs-delegate-metadata.ts

@@ -89,6 +89,8 @@ export type VcsDelegateBindings<TContext> = {
   stashShow: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.stash_show']>;
   cherryPick: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.cherry_pick']>;
   revertCommit: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.revert_commit']>;
+  validateUrl: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.validate_url']>;
+  validatePath: NonNullable<VcsTypes.VcsDelegates<TContext>['vcs.validate_path']>;
 };
 
 /** Enumerates the class-friendly method names recognized by `VcsDelegateBase`. */
@@ -148,6 +150,8 @@ export const VCS_DELEGATE_METHOD_MAPPINGS = {
   stashShow: 'vcs.stash_show',
   cherryPick: 'vcs.cherry_pick',
   revertCommit: 'vcs.revert_commit',
+  validateUrl: 'vcs.validate_url',
+  validatePath: 'vcs.validate_path',
 } as const satisfies Record<
   VcsDelegateMethodName,
   keyof VcsTypes.VcsDelegates<PluginRuntimeContext>

package/src/lib/types/vcs.ts

@@ -455,6 +455,26 @@ export interface VcsRevertCommitParams extends VcsSessionParams {
   no_edit?: boolean;
 }
 
+/** Describes the result returned by URL or path validation. */
+export interface VcsValidationResult {
+  /** Indicates whether the URL or path is valid for this backend. */
+  ok: boolean;
+  /** Stores an optional human-readable reason when validation fails. */
+  reason?: string;
+}
+
+/** Describes params for `vcs.validate_url`. */
+export interface VcsValidateUrlParams extends RequestParams {
+  /** Stores the repository URL to validate. */
+  url: string;
+}
+
+/** Describes params for `vcs.validate_path`. */
+export interface VcsValidatePathParams extends RequestParams {
+  /** Stores the local path to validate. */
+  path: string;
+}
+
 /** Describes the delegate map supported by the SDK runtime for `vcs.*`. */
 export interface VcsDelegates<TContext = unknown> {
   /** Handles `vcs.get_caps`. */
@@ -629,4 +649,8 @@ export interface VcsDelegates<TContext = unknown> {
   'vcs.cherry_pick'?: RpcMethodHandler<VcsCherryPickParams, null, TContext>;
   /** Handles `vcs.revert_commit`. */
   'vcs.revert_commit'?: RpcMethodHandler<VcsRevertCommitParams, null, TContext>;
+  /** Handles `vcs.validate_url`. */
+  'vcs.validate_url'?: RpcMethodHandler<VcsValidateUrlParams, VcsValidationResult, TContext>;
+  /** Handles `vcs.validate_path`. */
+  'vcs.validate_path'?: RpcMethodHandler<VcsValidatePathParams, VcsValidationResult, TContext>;
 }

package/test/vcs-delegate-base.test.js

@@ -254,3 +254,30 @@ test('all VcsDelegateBase stubs throw method-specific errors', () => {
     );
   }
 });
+
+test('VcsDelegateBase maps validateUrl and validatePath to rpc delegates', () => {
+  class ValidationDelegates extends VcsDelegateBase {
+    validateUrl(params) {
+      return { ok: params.url.includes('.git') };
+    }
+
+    validatePath(params) {
+      return { ok: params.path.endsWith('.git') };
+    }
+  }
+
+  const delegates = new ValidationDelegates({}).toDelegates();
+  assert.deepEqual(Object.keys(delegates).sort(), ['vcs.validate_path', 'vcs.validate_url']);
+
+  const urlResult = delegates['vcs.validate_url']({ url: 'https://example.com/repo.git' }, {});
+  assert.strictEqual(urlResult.ok, true);
+
+  const urlResultFail = delegates['vcs.validate_url']({ url: 'https://example.com/repo' }, {});
+  assert.strictEqual(urlResultFail.ok, false);
+
+  const pathResult = delegates['vcs.validate_path']({ path: '/repo/.git' }, {});
+  assert.strictEqual(pathResult.ok, true);
+
+  const pathResultFail = delegates['vcs.validate_path']({ path: '/repo' }, {});
+  assert.strictEqual(pathResultFail.ok, false);
+});

package/test/vcs-delegate-base.types.ts

@@ -1,7 +1,7 @@
 // Copyright © 2025-2026 OpenVCS Contributors
 // SPDX-License-Identifier: GPL-3.0-or-later
 
-import type { RequestParams, VcsCapabilities } from '../src/lib/types';
+import type { RequestParams, VcsCapabilities, VcsValidationResult } from '../src/lib/types';
 
 import {
   VcsDelegateBase,
@@ -42,3 +42,12 @@ class InvalidVcsDelegates extends VcsDelegateBase<{}> {
 }
 
 new InvalidVcsDelegates({});
+
+class InvalidValidateOverride extends VcsDelegateBase<{}> {
+  // @ts-expect-error `validateUrl` must return `VcsValidationResult`.
+  override validateUrl(): string {
+    return 'invalid';
+  }
+}
+
+new InvalidValidateOverride({});