@recursorsdk/sdk 1.0.2 → 1.1.0

package/dist/index.d.ts

@@ -1,8 +1,34 @@
 export * from "./types.js";
 export type { WebSocketMessage, WebSocketEventHandler } from "./websocket.js";
 export { RecursorWebSocket } from "./websocket.js";
+export type { GitHubRepository, GitHubIndexResponse, GitHubAuthResponse, SSOLoginUrlResponse } from "./mixins/github.js";
 import { RecursorBase } from "./base.js";
 declare const RecursorSDK_base: {
+    new (...args: any[]): {
+        githubAuthCallback(code: string): Promise<import("./mixins/github.js").GitHubAuthResponse>;
+        githubListRepositories(token: string): Promise<import("./mixins/github.js").GitHubRepository[]>;
+        githubIndexRepository(fullName: string, token: string): Promise<import("./mixins/github.js").GitHubIndexResponse>;
+        ssoGithubLogin(code: string): Promise<import("./types.js").TokenResponse>;
+        ssoGoogleLogin(idToken: string): Promise<import("./types.js").TokenResponse>;
+        ssoGetLoginUrl(provider: string): Promise<import("./mixins/github.js").SSOLoginUrlResponse>;
+        baseUrl: string;
+        apiKey?: string;
+        accessToken?: string;
+        timeoutMs: number;
+        wsClient?: any;
+        localIndex: Record<string, any>;
+        offlineQueue: any[];
+        setAccessToken(token: string): void;
+        setApiKey(key: string): void;
+        headers(): import("./types.js").HeadersInit;
+        get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+        post<T>(path: string, body?: unknown, method?: string): Promise<T>;
+        put<T>(path: string, body?: unknown): Promise<T>;
+        patch<T>(path: string, body?: unknown): Promise<T>;
+        delete<T>(path: string): Promise<T>;
+        checkHealth(): Promise<boolean>;
+    };
+} & {
     new (...args: any[]): {
         createWebSocket(): Promise<import("./websocket.js").RecursorWebSocket>;
         connectWebSocket(): Promise<import("./websocket.js").RecursorWebSocket>;
@@ -108,11 +134,13 @@ declare const RecursorSDK_base: {
         listCorrections(args: {
             page?: number;
             page_size?: number;
+            project_id?: string;
         }): Promise<any>;
-        searchCorrections(query: string, limit?: number): Promise<any[]>;
+        searchCorrections(query: string, limit?: number, project_id?: string): Promise<any[]>;
         createCorrection(data: {
             input_text: string;
             output_text: string;
+            project_id?: string;
         }): Promise<any>;
         baseUrl: string;
         apiKey?: string;

package/dist/index.js

@@ -7,12 +7,13 @@ import { WorkflowMixin } from "./mixins/workflows.js";
 import { IntelligenceMixin } from "./mixins/intelligence.js";
 import { EnterpriseMixin } from "./mixins/enterprise.js";
 import { WebSocketMixin } from "./mixins/websocket.js";
+import { GitHubMixin } from "./mixins/github.js";
 /**
  * RecursorSDK
  *
  * The main client for the Recursor API.
  * Composed of multiple mixins to provide a modular yet flat API.
  */
-export class RecursorSDK extends WebSocketMixin(EnterpriseMixin(IntelligenceMixin(WorkflowMixin(CodebaseMixin(RecursorBase))))) {
+export class RecursorSDK extends GitHubMixin(WebSocketMixin(EnterpriseMixin(IntelligenceMixin(WorkflowMixin(CodebaseMixin(RecursorBase)))))) {
 }
 export default RecursorSDK;

package/dist/mixins/github.d.ts

@@ -0,0 +1,60 @@
+import { RecursorBase, Constructor } from "../base.js";
+import { TokenResponse } from "../types.js";
+/** GitHub repository object returned from the API */
+export interface GitHubRepository {
+    id: number;
+    name: string;
+    full_name: string;
+    private: boolean;
+    html_url: string;
+    description: string | null;
+    language: string | null;
+    default_branch: string;
+    [key: string]: unknown;
+}
+/** Response from triggering repository indexing */
+export interface GitHubIndexResponse {
+    status: string;
+    repository: string;
+    message: string;
+}
+/** Response from exchanging a GitHub OAuth code */
+export interface GitHubAuthResponse {
+    access_token: string;
+}
+/** Response containing an SSO authorization URL */
+export interface SSOLoginUrlResponse {
+    authorize_url: string;
+}
+export declare function GitHubMixin<TBase extends Constructor<RecursorBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** Exchange a GitHub OAuth code for an access token. */
+        githubAuthCallback(code: string): Promise<GitHubAuthResponse>;
+        /** List repositories for the authenticated GitHub user. */
+        githubListRepositories(token: string): Promise<GitHubRepository[]>;
+        /** Trigger background indexing for a selected GitHub repository. */
+        githubIndexRepository(fullName: string, token: string): Promise<GitHubIndexResponse>;
+        /** Login or register using a GitHub OAuth code. Auto-sets access token. */
+        ssoGithubLogin(code: string): Promise<TokenResponse>;
+        /** Login or register using a Google ID token. Auto-sets access token. */
+        ssoGoogleLogin(idToken: string): Promise<TokenResponse>;
+        /** Get the SSO authorization URL for a given provider. */
+        ssoGetLoginUrl(provider: string): Promise<SSOLoginUrlResponse>;
+        baseUrl: string;
+        apiKey?: string;
+        accessToken?: string;
+        timeoutMs: number;
+        wsClient?: any;
+        localIndex: Record<string, any>;
+        offlineQueue: any[];
+        setAccessToken(token: string): void;
+        setApiKey(key: string): void;
+        headers(): import("../types.js").HeadersInit;
+        get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+        post<T>(path: string, body?: unknown, method?: string): Promise<T>;
+        put<T>(path: string, body?: unknown): Promise<T>;
+        patch<T>(path: string, body?: unknown): Promise<T>;
+        delete<T>(path: string): Promise<T>;
+        checkHealth(): Promise<boolean>;
+    };
+} & TBase;

package/dist/mixins/github.js

@@ -0,0 +1,41 @@
+export function GitHubMixin(Base) {
+    return class extends Base {
+        // ==================== GitHub Sync ====================
+        /** Exchange a GitHub OAuth code for an access token. */
+        async githubAuthCallback(code) {
+            return await this.post("/client/github/auth/callback", { code });
+        }
+        /** List repositories for the authenticated GitHub user. */
+        async githubListRepositories(token) {
+            return await this.get("/client/github/repositories", { token });
+        }
+        /** Trigger background indexing for a selected GitHub repository. */
+        async githubIndexRepository(fullName, token) {
+            return await this.post("/client/github/index", {
+                full_name: fullName,
+                token,
+            });
+        }
+        // ==================== SSO Authentication ====================
+        /** Login or register using a GitHub OAuth code. Auto-sets access token. */
+        async ssoGithubLogin(code) {
+            const response = await this.post("/client/auth/sso/github/login", { code });
+            if (response.access_token) {
+                this.setAccessToken(response.access_token);
+            }
+            return response;
+        }
+        /** Login or register using a Google ID token. Auto-sets access token. */
+        async ssoGoogleLogin(idToken) {
+            const response = await this.post("/client/auth/sso/google/login", { id_token: idToken });
+            if (response.access_token) {
+                this.setAccessToken(response.access_token);
+            }
+            return response;
+        }
+        /** Get the SSO authorization URL for a given provider. */
+        async ssoGetLoginUrl(provider) {
+            return await this.get(`/client/auth/sso/${provider}/login`);
+        }
+    };
+}

package/dist/mixins/intelligence.d.ts

@@ -35,11 +35,13 @@ export declare function IntelligenceMixin<TBase extends Constructor<RecursorBase
         listCorrections(args: {
             page?: number;
             page_size?: number;
+            project_id?: string;
         }): Promise<any>;
-        searchCorrections(query: string, limit?: number): Promise<any[]>;
+        searchCorrections(query: string, limit?: number, project_id?: string): Promise<any[]>;
         createCorrection(data: {
             input_text: string;
             output_text: string;
+            project_id?: string;
         }): Promise<any>;
         baseUrl: string;
         apiKey?: string;

package/dist/mixins/intelligence.js

@@ -82,10 +82,14 @@ export function IntelligenceMixin(Base) {
         }
         // ==================== Corrections ====================
         async listCorrections(args) {
-            return await this.get("/client/corrections", args);
+            const params = { ...args };
+            return await this.get("/client/corrections", params);
         }
-        async searchCorrections(query, limit = 5) {
-            return await this.get("/client/corrections/search", { query, limit });
+        async searchCorrections(query, limit = 5, project_id) {
+            const params = { query, limit };
+            if (project_id)
+                params.project_id = project_id;
+            return await this.get("/client/corrections/search", params);
         }
         async createCorrection(data) {
             return await this.post("/client/corrections", data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recursorsdk/sdk",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Recursor SDK for Node.js",
   "license": "MIT",
   "type": "module",
@@ -33,4 +33,4 @@
     "typescript": "^5.6.3",
     "@types/node": "^20.11.30"
   }
-}
+}