PipedreamHQ · jverce · Oct 24, 2025 · Oct 24, 2025 · Oct 24, 2025 · Oct 24, 2025
diff --git a/.npmignore b/.npmignore
@@ -4,6 +4,7 @@ tests
 .gitignore
 .github
 .fernignore
+.prettierrc.yml
 biome.json
 tsconfig.json
 yarn.lock

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@pipedream/sdk",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "private": false,
     "repository": "github:PipedreamHQ/pipedream-sdk-typescript",
     "type": "commonjs",
@@ -71,6 +71,9 @@
     ],
     "scripts": {
         "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "format:check": "biome format --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint": "biome lint --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint:fix": "biome lint --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
         "check": "biome check --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
         "check:fix": "biome check --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
         "build": "pnpm build:cjs && pnpm build:esm",
@@ -86,8 +89,8 @@
         "vitest": "^3.2.4",
         "msw": "2.11.2",
         "@types/node": "^18.19.70",
-        "@biomejs/biome": "2.2.5",
-        "typescript": "~5.7.2"
+        "typescript": "~5.7.2",
+        "@biomejs/biome": "2.2.5"
     },
     "browser": {
         "./dist/cjs/wrapper/utils/getBaseUrl.js": "./dist/cjs/wrapper/utils/getBaseUrl.browser.js",

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/api/resources/accounts/client/Client.ts b/src/api/resources/accounts/client/Client.ts
@@ -86,7 +86,7 @@ export class Accounts {
                         (await core.Supplier.get(this._options.baseUrl)) ??
                             (await core.Supplier.get(this._options.environment)) ??
                             environments.PipedreamEnvironment.Prod,
-                        `v1/connect/${encodeURIComponent(this._options.projectId)}/accounts`,
+                        `v1/connect/${core.url.encodePathParam(this._options.projectId)}/accounts`,
                     ),
                     method: "GET",
                     headers: _headers,
@@ -203,7 +203,7 @@ export class Accounts {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/accounts`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/accounts`,
             ),
             method: "POST",
             headers: _headers,
@@ -309,7 +309,7 @@ export class Accounts {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/accounts/${encodeURIComponent(accountId)}`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/accounts/${core.url.encodePathParam(accountId)}`,
             ),
             method: "GET",
             headers: _headers,
@@ -395,7 +395,7 @@ export class Accounts {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/accounts/${encodeURIComponent(accountId)}`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/accounts/${core.url.encodePathParam(accountId)}`,
             ),
             method: "DELETE",
             headers: _headers,
@@ -472,7 +472,7 @@ export class Accounts {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/apps/${encodeURIComponent(appId)}/accounts`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/apps/${core.url.encodePathParam(appId)}/accounts`,
             ),
             method: "DELETE",
             headers: _headers,

diff --git a/src/api/resources/actions/client/Client.ts b/src/api/resources/actions/client/Client.ts
@@ -78,7 +78,7 @@ export class Actions {
                         (await core.Supplier.get(this._options.baseUrl)) ??
                             (await core.Supplier.get(this._options.environment)) ??
                             environments.PipedreamEnvironment.Prod,
-                        `v1/connect/${encodeURIComponent(this._options.projectId)}/actions`,
+                        `v1/connect/${core.url.encodePathParam(this._options.projectId)}/actions`,
                     ),
                     method: "GET",
                     headers: _headers,
@@ -148,24 +148,35 @@ export class Actions {
      * Get detailed configuration for a specific action by its key
      *
      * @param {string} componentId - The key that uniquely identifies the component (e.g., 'slack-send-message')
+     * @param {Pipedream.ActionsRetrieveRequest} request
      * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pipedream.TooManyRequestsError}
      *
      * @example
-     *     await client.actions.retrieve("component_id")
+     *     await client.actions.retrieve("component_id", {
+     *         version: "1.2.3"
+     *     })
      */
     public retrieve(
         componentId: string,
+        request: Pipedream.ActionsRetrieveRequest = {},
         requestOptions?: Actions.RequestOptions,
     ): core.HttpResponsePromise<Pipedream.GetComponentResponse> {
-        return core.HttpResponsePromise.fromPromise(this.__retrieve(componentId, requestOptions));
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(componentId, request, requestOptions));
     }
 
     private async __retrieve(
         componentId: string,
+        request: Pipedream.ActionsRetrieveRequest = {},
         requestOptions?: Actions.RequestOptions,
     ): Promise<core.WithRawResponse<Pipedream.GetComponentResponse>> {
+        const { version } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        if (version != null) {
+            _queryParams.version = version;
+        }
+
         const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
             this._options?.headers,
             mergeOnlyDefinedHeaders({
@@ -179,11 +190,11 @@ export class Actions {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/actions/${encodeURIComponent(componentId)}`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/actions/${core.url.encodePathParam(componentId)}`,
             ),
             method: "GET",
             headers: _headers,
-            queryParameters: requestOptions?.queryParams,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -272,7 +283,7 @@ export class Actions {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/actions/configure`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/actions/configure`,
             ),
             method: "POST",
             headers: _headers,
@@ -370,7 +381,7 @@ export class Actions {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/actions/props`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/actions/props`,
             ),
             method: "POST",
             headers: _headers,
@@ -468,7 +479,7 @@ export class Actions {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/actions/run`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/actions/run`,
             ),
             method: "POST",
             headers: _headers,

diff --git a/src/api/resources/actions/client/requests/ActionsRetrieveRequest.ts b/src/api/resources/actions/client/requests/ActionsRetrieveRequest.ts
@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         version: "1.2.3"
+ *     }
+ */
+export interface ActionsRetrieveRequest {
+    /** Optional semantic version of the component to retrieve (for example '1.0.0') */
+    version?: string;
+}
diff --git a/src/api/resources/actions/client/requests/RunActionOpts.ts b/src/api/resources/actions/client/requests/RunActionOpts.ts
@@ -12,6 +12,8 @@ import type * as Pipedream from "../../../../index.js";
 export interface RunActionOpts {
     /** The action component ID */
     id: string;
+    /** Optional action component version (in SemVer format, for example '1.0.0'), defaults to latest */
+    version?: string;
     /** The external user ID */
     externalUserId: string;
     configuredProps?: Pipedream.ConfiguredProps;

diff --git a/src/api/resources/actions/client/requests/index.ts b/src/api/resources/actions/client/requests/index.ts
@@ -1,2 +1,3 @@
 export type { ActionsListRequest } from "./ActionsListRequest.js";
+export type { ActionsRetrieveRequest } from "./ActionsRetrieveRequest.js";
 export type { RunActionOpts } from "./RunActionOpts.js";
diff --git a/src/api/resources/appCategories/client/Client.ts b/src/api/resources/appCategories/client/Client.ts
@@ -133,7 +133,7 @@ export class AppCategories {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/app_categories/${encodeURIComponent(id)}`,
+                `v1/connect/app_categories/${core.url.encodePathParam(id)}`,
             ),
             method: "GET",
             headers: _headers,

diff --git a/src/api/resources/apps/client/Client.ts b/src/api/resources/apps/client/Client.ts
@@ -183,7 +183,7 @@ export class Apps {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/apps/${encodeURIComponent(appId)}`,
+                `v1/connect/apps/${core.url.encodePathParam(appId)}`,
             ),
             method: "GET",
             headers: _headers,

diff --git a/src/api/resources/components/client/Client.ts b/src/api/resources/components/client/Client.ts
@@ -85,7 +85,7 @@ export class Components {
                         (await core.Supplier.get(this._options.baseUrl)) ??
                             (await core.Supplier.get(this._options.environment)) ??
                             environments.PipedreamEnvironment.Prod,
-                        `v1/connect/${encodeURIComponent(this._options.projectId)}/components`,
+                        `v1/connect/${core.url.encodePathParam(this._options.projectId)}/components`,
                     ),
                     method: "GET",
                     headers: _headers,
@@ -155,24 +155,35 @@ export class Components {
      * Get detailed configuration for a specific component by its key
      *
      * @param {string} componentId - The key that uniquely identifies the component (e.g., 'slack-send-message')
+     * @param {Pipedream.ComponentsRetrieveRequest} request
      * @param {Components.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pipedream.TooManyRequestsError}
      *
      * @example
-     *     await client.components.retrieve("component_id")
+     *     await client.components.retrieve("component_id", {
+     *         version: "1.2.3"
+     *     })
      */
     public retrieve(
         componentId: string,
+        request: Pipedream.ComponentsRetrieveRequest = {},
         requestOptions?: Components.RequestOptions,
     ): core.HttpResponsePromise<Pipedream.GetComponentResponse> {
-        return core.HttpResponsePromise.fromPromise(this.__retrieve(componentId, requestOptions));
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(componentId, request, requestOptions));
     }
 
     private async __retrieve(
         componentId: string,
+        request: Pipedream.ComponentsRetrieveRequest = {},
         requestOptions?: Components.RequestOptions,
     ): Promise<core.WithRawResponse<Pipedream.GetComponentResponse>> {
+        const { version } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        if (version != null) {
+            _queryParams.version = version;
+        }
+
         const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
             this._options?.headers,
             mergeOnlyDefinedHeaders({
@@ -186,11 +197,11 @@ export class Components {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/components/${encodeURIComponent(componentId)}`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/components/${core.url.encodePathParam(componentId)}`,
             ),
             method: "GET",
             headers: _headers,
-            queryParameters: requestOptions?.queryParams,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -279,7 +290,7 @@ export class Components {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/components/configure`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/components/configure`,
             ),
             method: "POST",
             headers: _headers,
@@ -377,7 +388,7 @@ export class Components {
                 (await core.Supplier.get(this._options.baseUrl)) ??
                     (await core.Supplier.get(this._options.environment)) ??
                     environments.PipedreamEnvironment.Prod,
-                `v1/connect/${encodeURIComponent(this._options.projectId)}/components/props`,
+                `v1/connect/${core.url.encodePathParam(this._options.projectId)}/components/props`,
             ),
             method: "POST",
             headers: _headers,

diff --git a/src/api/resources/components/client/requests/ComponentsRetrieveRequest.ts b/src/api/resources/components/client/requests/ComponentsRetrieveRequest.ts
@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         version: "1.2.3"
+ *     }
+ */
+export interface ComponentsRetrieveRequest {
+    /** Optional semantic version of the component to retrieve (for example '1.0.0') */
+    version?: string;
+}
diff --git a/src/api/resources/components/client/requests/index.ts b/src/api/resources/components/client/requests/index.ts
@@ -1 +1,2 @@
 export type { ComponentsListRequest } from "./ComponentsListRequest.js";
+export type { ComponentsRetrieveRequest } from "./ComponentsRetrieveRequest.js";
Original file line number	Diff line number	Diff line change
		@@ -1 +1,2 @@
		export type { ComponentsListRequest } from "./ComponentsListRequest.js";
		export type { ComponentsRetrieveRequest } from "./ComponentsRetrieveRequest.js";