@scalekit-sdk/node 2.4.0 → 2.5.0

package/lib/actions.d.ts

@@ -0,0 +1,154 @@
+import { AxiosResponse } from 'axios';
+import CoreClient from './core';
+import ToolsClient from './tools';
+import ConnectedAccountsClient from './connected-accounts';
+import { CreateConnectedAccount, CreateConnectedAccountResponse, DeleteConnectedAccountResponse, GetConnectedAccountByIdentifierResponse, GetMagicLinkForConnectedAccountResponse, ListConnectedAccountsResponse, UpdateConnectedAccount, UpdateConnectedAccountResponse } from './pkg/grpc/scalekit/v1/connected_accounts/connected_accounts_pb';
+import { ExecuteToolResponse } from './pkg/grpc/scalekit/v1/tools/tools_pb';
+/**
+ * This class is intended to be accessed via `ScalekitClient.actions`.
+ * It composes the existing ToolsClient and ConnectedAccountsClient
+ * without changing their behavior.
+ */
+export default class ActionsClient {
+    private readonly tools;
+    private readonly connectedAccounts;
+    private readonly coreClient;
+    constructor(tools: ToolsClient, connectedAccounts: ConnectedAccountsClient, coreClient: CoreClient);
+    /**
+     * Execute a tool on behalf of a connected account.
+     *
+     * Thin wrapper around ToolsClient.executeTool, reserved for future
+     * pre/post modifier support.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If toolName is missing or an unexpected error occurs.
+     */
+    executeTool(params: {
+        toolName: string;
+        toolInput: Record<string, unknown>;
+        identifier?: string;
+        connectedAccountId?: string;
+        connector?: string;
+        organizationId?: string;
+        userId?: string;
+    }): Promise<ExecuteToolResponse>;
+    /**
+     * Get an authorization magic link for a connected account.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    getAuthorizationLink(params: {
+        connectionName?: string;
+        identifier?: string;
+        connectedAccountId?: string;
+        organizationId?: string;
+        userId?: string;
+    }): Promise<GetMagicLinkForConnectedAccountResponse>;
+    /**
+     * List connected accounts with optional filters.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    listConnectedAccounts(params?: {
+        connectionName?: string;
+        identifier?: string;
+        provider?: string;
+        organizationId?: string;
+        userId?: string;
+        pageSize?: number;
+        pageToken?: string;
+        query?: string;
+    }): Promise<ListConnectedAccountsResponse>;
+    /**
+     * Delete a connected account.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    deleteConnectedAccount(params: {
+        connectionName?: string;
+        identifier?: string;
+        connectedAccountId?: string;
+        organizationId?: string;
+        userId?: string;
+    }): Promise<DeleteConnectedAccountResponse>;
+    /**
+     * Get connected account authorization details.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    getConnectedAccount(params: {
+        connectionName?: string;
+        identifier?: string;
+        connectedAccountId?: string;
+        organizationId?: string;
+        userId?: string;
+    }): Promise<GetConnectedAccountByIdentifierResponse>;
+    /**
+     * Create a new connected account.
+     *
+     * This helper accepts a high-level payload and builds the
+     * underlying CreateConnectedAccount message.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If connectionName or identifier is missing.
+     */
+    createConnectedAccount(params: {
+        connectionName: string;
+        identifier: string;
+        authorizationDetails: CreateConnectedAccount['authorizationDetails'];
+        organizationId?: string;
+        userId?: string;
+        apiConfig?: Record<string, unknown>;
+    }): Promise<CreateConnectedAccountResponse>;
+    /**
+     * Get an existing connected account or create a new one if it doesn't exist.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If connectionName or identifier is missing.
+     */
+    getOrCreateConnectedAccount(params: {
+        connectionName: string;
+        identifier: string;
+        authorizationDetails?: CreateConnectedAccount['authorizationDetails'];
+        organizationId?: string;
+        userId?: string;
+        apiConfig?: Record<string, unknown>;
+    }): Promise<CreateConnectedAccountResponse>;
+    /**
+     * Update an existing connected account.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    updateConnectedAccount(params: {
+        connectionName?: string;
+        identifier?: string;
+        authorizationDetails?: UpdateConnectedAccount['authorizationDetails'];
+        organizationId?: string;
+        userId?: string;
+        connectedAccountId?: string;
+        apiConfig?: UpdateConnectedAccount['apiConfig'];
+    }): Promise<UpdateConnectedAccountResponse>;
+    /**
+     * Make a proxied REST API call on behalf of a connected account.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing or an unexpected error occurs.
+     */
+    request(params: {
+        connectionName: string;
+        identifier: string;
+        path: string;
+        method?: string;
+        queryParams?: Record<string, unknown>;
+        body?: unknown;
+        formData?: Record<string, unknown>;
+        headers?: Record<string, string>;
+        timeoutMs?: number;
+    }): Promise<AxiosResponse<any>>;
+}

package/lib/actions.js

@@ -0,0 +1,270 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const protobuf_1 = require("@bufbuild/protobuf");
+const axios_1 = require("axios");
+const errors_1 = require("./errors");
+const connected_accounts_pb_1 = require("./pkg/grpc/scalekit/v1/connected_accounts/connected_accounts_pb");
+/**
+ * This class is intended to be accessed via `ScalekitClient.actions`.
+ * It composes the existing ToolsClient and ConnectedAccountsClient
+ * without changing their behavior.
+ */
+class ActionsClient {
+    constructor(tools, connectedAccounts, coreClient) {
+        this.tools = tools;
+        this.connectedAccounts = connectedAccounts;
+        this.coreClient = coreClient;
+    }
+    /**
+     * Execute a tool on behalf of a connected account.
+     *
+     * Thin wrapper around ToolsClient.executeTool, reserved for future
+     * pre/post modifier support.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If toolName is missing or an unexpected error occurs.
+     */
+    executeTool(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { toolName, toolInput, identifier, connectedAccountId, connector, organizationId, userId, } = params;
+            if (!(toolName === null || toolName === void 0 ? void 0 : toolName.trim())) {
+                throw new Error('toolName is required');
+            }
+            return this.tools.executeTool({
+                toolName,
+                identifier,
+                params: toolInput,
+                connectedAccountId,
+                connector,
+                organizationId,
+                userId,
+            });
+        });
+    }
+    /**
+     * Get an authorization magic link for a connected account.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    getAuthorizationLink(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, connectedAccountId, organizationId, userId, } = params;
+            return this.connectedAccounts.getMagicLinkForConnectedAccount({
+                connector: connectionName,
+                identifier,
+                organizationId,
+                userId,
+                connectedAccountId,
+            });
+        });
+    }
+    /**
+     * List connected accounts with optional filters.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    listConnectedAccounts(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.connectedAccounts.listConnectedAccounts({
+                organizationId: params === null || params === void 0 ? void 0 : params.organizationId,
+                userId: params === null || params === void 0 ? void 0 : params.userId,
+                connector: params === null || params === void 0 ? void 0 : params.connectionName,
+                identifier: params === null || params === void 0 ? void 0 : params.identifier,
+                provider: params === null || params === void 0 ? void 0 : params.provider,
+                pageSize: params === null || params === void 0 ? void 0 : params.pageSize,
+                pageToken: params === null || params === void 0 ? void 0 : params.pageToken,
+                query: params === null || params === void 0 ? void 0 : params.query,
+            });
+        });
+    }
+    /**
+     * Delete a connected account.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    deleteConnectedAccount(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, connectedAccountId, organizationId, userId, } = params;
+            const trimmedConnectionName = connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim();
+            const trimmedIdentifier = identifier === null || identifier === void 0 ? void 0 : identifier.trim();
+            const trimmedConnectedAccountId = connectedAccountId === null || connectedAccountId === void 0 ? void 0 : connectedAccountId.trim();
+            if (!trimmedConnectedAccountId &&
+                !(trimmedConnectionName && trimmedIdentifier)) {
+                throw new Error('either connectedAccountId or connectionName + identifier is required');
+            }
+            return this.connectedAccounts.deleteConnectedAccount({
+                connector: trimmedConnectionName,
+                identifier: trimmedIdentifier,
+                organizationId,
+                userId,
+                connectedAccountId: trimmedConnectedAccountId,
+            });
+        });
+    }
+    /**
+     * Get connected account authorization details.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    getConnectedAccount(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, connectedAccountId, organizationId, userId, } = params;
+            const trimmedConnectionName = connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim();
+            const trimmedIdentifier = identifier === null || identifier === void 0 ? void 0 : identifier.trim();
+            const trimmedConnectedAccountId = connectedAccountId === null || connectedAccountId === void 0 ? void 0 : connectedAccountId.trim();
+            if (!trimmedConnectedAccountId &&
+                !(trimmedConnectionName && trimmedIdentifier)) {
+                throw new Error('either connectedAccountId or connectionName + identifier is required');
+            }
+            return this.connectedAccounts.getConnectedAccountByIdentifier({
+                connector: trimmedConnectionName,
+                identifier: trimmedIdentifier,
+                organizationId,
+                userId,
+                connectedAccountId: trimmedConnectedAccountId,
+            });
+        });
+    }
+    /**
+     * Create a new connected account.
+     *
+     * This helper accepts a high-level payload and builds the
+     * underlying CreateConnectedAccount message.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If connectionName or identifier is missing.
+     */
+    createConnectedAccount(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, authorizationDetails, organizationId, userId, apiConfig, } = params;
+            if (!(connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim())) {
+                throw new Error('connectionName is required');
+            }
+            if (!(identifier === null || identifier === void 0 ? void 0 : identifier.trim())) {
+                throw new Error('identifier is required');
+            }
+            const connectedAccount = (0, protobuf_1.create)(connected_accounts_pb_1.CreateConnectedAccountSchema, Object.assign({ authorizationDetails }, (apiConfig != null && {
+                apiConfig: apiConfig,
+            })));
+            return this.connectedAccounts.createConnectedAccount({
+                connector: connectionName,
+                identifier,
+                connectedAccount,
+                organizationId,
+                userId,
+            });
+        });
+    }
+    /**
+     * Get an existing connected account or create a new one if it doesn't exist.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If connectionName or identifier is missing.
+     */
+    getOrCreateConnectedAccount(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, authorizationDetails, organizationId, userId, apiConfig, } = params;
+            if (!(connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim())) {
+                throw new Error('connectionName is required');
+            }
+            if (!(identifier === null || identifier === void 0 ? void 0 : identifier.trim())) {
+                throw new Error('identifier is required');
+            }
+            return this.connectedAccounts.getOrCreateConnectedAccount({
+                connector: connectionName.trim(),
+                identifier: identifier.trim(),
+                authorizationDetails,
+                organizationId,
+                userId,
+                apiConfig,
+            });
+        });
+    }
+    /**
+     * Update an existing connected account.
+     * Requires either `connectedAccountId` or both `connectionName` + `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    updateConnectedAccount(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, authorizationDetails, organizationId, userId, connectedAccountId, apiConfig, } = params;
+            const trimmedConnectionName = connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim();
+            const trimmedIdentifier = identifier === null || identifier === void 0 ? void 0 : identifier.trim();
+            const trimmedConnectedAccountId = connectedAccountId === null || connectedAccountId === void 0 ? void 0 : connectedAccountId.trim();
+            if (!trimmedConnectedAccountId &&
+                !(trimmedConnectionName && trimmedIdentifier)) {
+                throw new Error('either connectedAccountId or connectionName + identifier is required');
+            }
+            const connectedAccount = (0, protobuf_1.create)(connected_accounts_pb_1.UpdateConnectedAccountSchema, Object.assign(Object.assign({}, (authorizationDetails && { authorizationDetails })), (apiConfig != null && { apiConfig })));
+            return this.connectedAccounts.updateConnectedAccount({
+                connector: trimmedConnectionName,
+                identifier: trimmedIdentifier,
+                connectedAccount,
+                organizationId,
+                userId,
+                connectedAccountId: trimmedConnectedAccountId,
+            });
+        });
+    }
+    /**
+     * Make a proxied REST API call on behalf of a connected account.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing or an unexpected error occurs.
+     */
+    request(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectionName, identifier, path, method = 'GET', queryParams, body, formData, headers, timeoutMs, } = params;
+            if (!(connectionName === null || connectionName === void 0 ? void 0 : connectionName.trim())) {
+                throw new Error('connectionName is required');
+            }
+            if (!(identifier === null || identifier === void 0 ? void 0 : identifier.trim())) {
+                throw new Error('identifier is required');
+            }
+            if (!(path === null || path === void 0 ? void 0 : path.trim())) {
+                throw new Error('path is required');
+            }
+            const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+            const url = `${this.coreClient.envUrl.replace(/\/$/, '')}/proxy${normalizedPath}`;
+            const timeout = timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : 30000;
+            const proxyHeaders = Object.assign(Object.assign({}, (headers !== null && headers !== void 0 ? headers : {})), { connection_name: connectionName, identifier });
+            try {
+                return yield this.coreClient.axios.request({
+                    url,
+                    method: method.toUpperCase(),
+                    params: queryParams,
+                    data: body !== null && body !== void 0 ? body : formData,
+                    headers: proxyHeaders,
+                    timeout,
+                });
+            }
+            catch (error) {
+                if (error instanceof errors_1.ScalekitException)
+                    throw error;
+                if (error instanceof axios_1.AxiosError) {
+                    if (error.response)
+                        throw errors_1.ScalekitServerException.promote(error.response);
+                    throw new errors_1.ScalekitException(error);
+                }
+                throw new errors_1.ScalekitException(error);
+            }
+        });
+    }
+}
+exports.default = ActionsClient;
+//# sourceMappingURL=actions.js.map

package/lib/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/lib/connected-accounts.d.ts

@@ -0,0 +1,134 @@
+import { type MessageInitShape } from '@bufbuild/protobuf';
+import GrpcConnect from './connect';
+import CoreClient from './core';
+import { AuthorizationDetailsSchema, CreateConnectedAccount, CreateConnectedAccountResponse, DeleteConnectedAccountResponse, GetConnectedAccountByIdentifierResponse, GetMagicLinkForConnectedAccountResponse, ListConnectedAccountsResponse, UpdateConnectedAccount, UpdateConnectedAccountResponse } from './pkg/grpc/scalekit/v1/connected_accounts/connected_accounts_pb';
+/**
+ * Client for managing connected accounts for third-party integrations.
+ *
+ * This mirrors the Python SDK `ConnectedAccountsClient` and exposes a typed,
+ * ergonomic API around the `ConnectedAccountService` to:
+ * - list connected accounts
+ * - create/update/delete connected accounts
+ * - generate magic links for authorization
+ * - fetch full authentication details for a connected account
+ */
+export default class ConnectedAccountsClient {
+    private readonly grpcConnect;
+    private readonly coreClient;
+    private client;
+    constructor(grpcConnect: GrpcConnect, coreClient: CoreClient);
+    /**
+     * Lists connected accounts with optional filters and pagination.
+     *
+     * @param options Optional filtering and pagination parameters
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    listConnectedAccounts(options?: {
+        organizationId?: string;
+        userId?: string;
+        connector?: string;
+        identifier?: string;
+        provider?: string;
+        pageSize?: number;
+        pageToken?: string;
+        query?: string;
+    }): Promise<ListConnectedAccountsResponse>;
+    /**
+     * Creates a new connected account.
+     *
+     * @param params Connected account creation parameters
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    createConnectedAccount(params: {
+        connector: string;
+        identifier: string;
+        connectedAccount: CreateConnectedAccount;
+        organizationId?: string;
+        userId?: string;
+    }): Promise<CreateConnectedAccountResponse>;
+    /**
+     * Gets an existing connected account by connector and identifier, or creates one if none exists.
+     * Mirrors the Python SDK `get_or_create_connected_account`. When creating, the backend may require
+     * valid authorization details; if omitted, a minimal payload is sent and the server may return
+     * a validation error.
+     *
+     * @param params Get-or-create parameters
+     * @param params.connector Connector identifier (required)
+     * @param params.identifier Connected account identifier (required)
+     * @param params.authorizationDetails Optional auth details for the create path (OAuth token or static auth)
+     * @param params.organizationId Optional organization ID
+     * @param params.userId Optional user ID
+     * @param params.apiConfig Optional API config for the create path
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If connector or identifier is missing.
+     */
+    getOrCreateConnectedAccount(params: {
+        connector: string;
+        identifier: string;
+        authorizationDetails?: MessageInitShape<typeof AuthorizationDetailsSchema>;
+        organizationId?: string;
+        userId?: string;
+        apiConfig?: Record<string, unknown>;
+    }): Promise<CreateConnectedAccountResponse>;
+    /**
+     * Updates an existing connected account.
+     *
+     * You can target the account either by `connectedAccountId` alone, or by the
+     * combination of `connector` and `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    updateConnectedAccount(params: {
+        connector?: string;
+        identifier?: string;
+        connectedAccount: UpdateConnectedAccount;
+        organizationId?: string;
+        userId?: string;
+        connectedAccountId?: string;
+    }): Promise<UpdateConnectedAccountResponse>;
+    /**
+     * Deletes a connected account and revokes its credentials.
+     *
+     * You can target the account either by `connectedAccountId` alone, or by the
+     * combination of `connector` and `identifier`.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitException} If required parameters are missing.
+     */
+    deleteConnectedAccount(params: {
+        connector?: string;
+        identifier?: string;
+        organizationId?: string;
+        userId?: string;
+        connectedAccountId?: string;
+    }): Promise<DeleteConnectedAccountResponse>;
+    /**
+     * Generates a time-limited magic link for connecting or re-authorizing a third-party account.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     */
+    getMagicLinkForConnectedAccount(params: {
+        connector?: string;
+        identifier?: string;
+        organizationId?: string;
+        userId?: string;
+        connectedAccountId?: string;
+    }): Promise<GetMagicLinkForConnectedAccountResponse>;
+    /**
+     * Retrieves complete authentication details for a connected account.
+     *
+     * This method returns sensitive credential information, so ensure you protect access
+     * to this in your application.
+     *
+     * @throws {ScalekitServerException} If a network or server error occurs.
+     * @throws {ScalekitNotFoundException} If no matching connected account is found.
+     */
+    getConnectedAccountByIdentifier(params: {
+        connector?: string;
+        identifier?: string;
+        organizationId?: string;
+        userId?: string;
+        connectedAccountId?: string;
+    }): Promise<GetConnectedAccountByIdentifierResponse>;
+}