@forklaunch/universal-sdk 0.5.3 → 0.6.0

package/lib/index.d.mts

@@ -17,7 +17,7 @@ type RegistryOptions = {
     url: string;
     static?: boolean;
 } | {
-    raw: OpenAPIObject;
+    raw: OpenAPIObject | Record<string, OpenAPIObject>;
 };
 
 /**

package/lib/index.d.ts

@@ -17,7 +17,7 @@ type RegistryOptions = {
     url: string;
     static?: boolean;
 } | {
-    raw: OpenAPIObject;
+    raw: OpenAPIObject | Record<string, OpenAPIObject>;
 };
 
 /**

package/lib/index.js

@@ -170,11 +170,16 @@ function mapContentType(contentType) {
   }
 }
 
+// src/guards/isOpenApiObject.ts
+function isOpenAPIObject(obj) {
+  return typeof obj === "object" && obj !== null && "openapi" in obj;
+}
+
 // src/core/openApi.ts
 function getSdkPathMap(registryOpenApiJson) {
   const sdkPathMap = {};
-  Object.entries(registryOpenApiJson?.paths || {}).forEach(
-    ([path, pathItem]) => {
+  Object.entries(registryOpenApiJson).forEach(([version, openApi]) => {
+    Object.entries(openApi?.paths || {}).forEach(([path, pathItem]) => {
       const methods = [
         "get",
         "post",
@@ -185,16 +190,18 @@ function getSdkPathMap(registryOpenApiJson) {
         "head",
         "trace"
       ];
+      const versionedPath = version === "latest" ? void 0 : version.substring(1);
       methods.forEach((method) => {
         if (pathItem[method]?.operationId) {
-          sdkPathMap[pathItem[method].operationId] = {
+          sdkPathMap[`${pathItem[method].operationId}${versionedPath ? `.${versionedPath}` : ""}`] = {
             method,
-            path
+            path,
+            version
           };
         }
       });
-    }
-  );
+    });
+  });
   return sdkPathMap;
 }
 async function refreshOpenApi(host, registryOptions, existingRegistryOpenApiHash) {
@@ -204,11 +211,14 @@ async function refreshOpenApi(host, registryOptions, existingRegistryOpenApiHash
     };
   }
   if ("raw" in registryOptions) {
+    const rawVersionedOpenApi = isOpenAPIObject(registryOptions.raw) ? {
+      latest: registryOptions.raw
+    } : registryOptions.raw;
     return {
       updateRequired: true,
-      registryOpenApiJson: registryOptions.raw,
+      registryOpenApiJson: rawVersionedOpenApi,
       registryOpenApiHash: "static",
-      sdkPathMap: getSdkPathMap(registryOptions.raw)
+      sdkPathMap: getSdkPathMap(rawVersionedOpenApi)
     };
   }
   const registry = "path" in registryOptions ? `${host}/${registryOptions.path}` : "url" in registryOptions ? registryOptions.url : null;
@@ -394,7 +404,12 @@ var UniversalSdk = class _UniversalSdk {
       this.registryOpenApiHash = refreshResult.registryOpenApiHash;
       this.sdkPathMap = refreshResult.sdkPathMap;
     }
-    return this.execute(path, request?.method ?? "get", request);
+    return this.execute(
+      path,
+      request?.method ?? "get",
+      request?.version ? `v${request.version}` : "latest",
+      request
+    );
   }
   async executeSdkCall(sdkPath, request) {
     if (!this.host) {
@@ -425,8 +440,8 @@ var UniversalSdk = class _UniversalSdk {
     if (fullSdkPath.length === 0) {
       throw new Error(`Sdk path not found: ${sdkPath}`);
     }
-    const { method, path } = this.sdkPathMap?.[fullSdkPath.join(".")] || {};
-    return this.execute(path, method, request);
+    const { method, path, version } = this.sdkPathMap?.[fullSdkPath.join(".")] || {};
+    return this.execute(path, method, version, request);
   }
   /**
    * Executes an HTTP request.
@@ -436,12 +451,14 @@ var UniversalSdk = class _UniversalSdk {
    * @param {RequestType} [request] - The request object.
    * @returns {Promise<ResponseType>} - The response object.
    */
-  async execute(path, method, request) {
+  async execute(path, method, version, request) {
     const { params, body, query, headers } = request || {};
     let url = getSdkPath(this.host + path);
     if (params) {
       for (const key in params) {
-        url = url.replace(`:${key}`, encodeURIComponent(params[key]));
+        const paramValue = encodeURIComponent(params[key]);
+        url = url.replace(`:${key}`, paramValue);
+        url = url.replace(`{${key}}`, paramValue);
       }
     }
     let defaultContentType = "application/json";
@@ -509,7 +526,7 @@ var UniversalSdk = class _UniversalSdk {
       },
       body: parsedBody
     });
-    const responseOpenApi = path != null && method != null ? this.registryOpenApiJson?.paths?.[(0, import_common2.openApiCompliantPath)(path)]?.[method?.toLowerCase()]?.responses?.[response.status] : null;
+    const responseOpenApi = path != null && method != null ? this.registryOpenApiJson?.[version]?.paths?.[(0, import_common2.openApiCompliantPath)(path)]?.[method?.toLowerCase()]?.responses?.[response.status] : null;
     if (responseOpenApi == null) {
       throw new Error(
         `Response ${response.status} not found in OpenAPI spec for ${path} with method ${method}`

package/lib/index.mjs

@@ -138,11 +138,16 @@ function mapContentType(contentType) {
   }
 }
 
+// src/guards/isOpenApiObject.ts
+function isOpenAPIObject(obj) {
+  return typeof obj === "object" && obj !== null && "openapi" in obj;
+}
+
 // src/core/openApi.ts
 function getSdkPathMap(registryOpenApiJson) {
   const sdkPathMap = {};
-  Object.entries(registryOpenApiJson?.paths || {}).forEach(
-    ([path, pathItem]) => {
+  Object.entries(registryOpenApiJson).forEach(([version, openApi]) => {
+    Object.entries(openApi?.paths || {}).forEach(([path, pathItem]) => {
       const methods = [
         "get",
         "post",
@@ -153,16 +158,18 @@ function getSdkPathMap(registryOpenApiJson) {
         "head",
         "trace"
       ];
+      const versionedPath = version === "latest" ? void 0 : version.substring(1);
       methods.forEach((method) => {
         if (pathItem[method]?.operationId) {
-          sdkPathMap[pathItem[method].operationId] = {
+          sdkPathMap[`${pathItem[method].operationId}${versionedPath ? `.${versionedPath}` : ""}`] = {
             method,
-            path
+            path,
+            version
           };
         }
       });
-    }
-  );
+    });
+  });
   return sdkPathMap;
 }
 async function refreshOpenApi(host, registryOptions, existingRegistryOpenApiHash) {
@@ -172,11 +179,14 @@ async function refreshOpenApi(host, registryOptions, existingRegistryOpenApiHash
     };
   }
   if ("raw" in registryOptions) {
+    const rawVersionedOpenApi = isOpenAPIObject(registryOptions.raw) ? {
+      latest: registryOptions.raw
+    } : registryOptions.raw;
     return {
       updateRequired: true,
-      registryOpenApiJson: registryOptions.raw,
+      registryOpenApiJson: rawVersionedOpenApi,
       registryOpenApiHash: "static",
-      sdkPathMap: getSdkPathMap(registryOptions.raw)
+      sdkPathMap: getSdkPathMap(rawVersionedOpenApi)
     };
   }
   const registry = "path" in registryOptions ? `${host}/${registryOptions.path}` : "url" in registryOptions ? registryOptions.url : null;
@@ -362,7 +372,12 @@ var UniversalSdk = class _UniversalSdk {
       this.registryOpenApiHash = refreshResult.registryOpenApiHash;
       this.sdkPathMap = refreshResult.sdkPathMap;
     }
-    return this.execute(path, request?.method ?? "get", request);
+    return this.execute(
+      path,
+      request?.method ?? "get",
+      request?.version ? `v${request.version}` : "latest",
+      request
+    );
   }
   async executeSdkCall(sdkPath, request) {
     if (!this.host) {
@@ -393,8 +408,8 @@ var UniversalSdk = class _UniversalSdk {
     if (fullSdkPath.length === 0) {
       throw new Error(`Sdk path not found: ${sdkPath}`);
     }
-    const { method, path } = this.sdkPathMap?.[fullSdkPath.join(".")] || {};
-    return this.execute(path, method, request);
+    const { method, path, version } = this.sdkPathMap?.[fullSdkPath.join(".")] || {};
+    return this.execute(path, method, version, request);
   }
   /**
    * Executes an HTTP request.
@@ -404,12 +419,14 @@ var UniversalSdk = class _UniversalSdk {
    * @param {RequestType} [request] - The request object.
    * @returns {Promise<ResponseType>} - The response object.
    */
-  async execute(path, method, request) {
+  async execute(path, method, version, request) {
     const { params, body, query, headers } = request || {};
     let url = getSdkPath(this.host + path);
     if (params) {
       for (const key in params) {
-        url = url.replace(`:${key}`, encodeURIComponent(params[key]));
+        const paramValue = encodeURIComponent(params[key]);
+        url = url.replace(`:${key}`, paramValue);
+        url = url.replace(`{${key}}`, paramValue);
       }
     }
     let defaultContentType = "application/json";
@@ -477,7 +494,7 @@ var UniversalSdk = class _UniversalSdk {
       },
       body: parsedBody
     });
-    const responseOpenApi = path != null && method != null ? this.registryOpenApiJson?.paths?.[openApiCompliantPath(path)]?.[method?.toLowerCase()]?.responses?.[response.status] : null;
+    const responseOpenApi = path != null && method != null ? this.registryOpenApiJson?.[version]?.paths?.[openApiCompliantPath(path)]?.[method?.toLowerCase()]?.responses?.[response.status] : null;
     if (responseOpenApi == null) {
       throw new Error(
         `Response ${response.status} not found in OpenAPI spec for ${path} with method ${method}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/universal-sdk",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Cross runtime fetch library for forklaunch router sdks",
   "keywords": [
     "fetch",
@@ -33,18 +33,18 @@
   "dependencies": {
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "@forklaunch/common": "0.4.5"
+    "@forklaunch/common": "0.5.0"
   },
   "devDependencies": {
-    "@types/node": "^24.0.13",
-    "@typescript/native-preview": "7.0.0-dev.20250712.1",
+    "@types/node": "^24.3.0",
+    "@typescript/native-preview": "7.0.0-dev.20250820.1",
     "fetch-mock": "^12.5.3",
-    "jest": "^30.0.4",
+    "jest": "^30.0.5",
     "openapi3-ts": "^4.5.0",
     "prettier": "^3.6.2",
-    "ts-jest": "^29.4.0",
+    "ts-jest": "^29.4.1",
     "tsup": "^8.5.0",
-    "typedoc": "^0.28.7"
+    "typedoc": "^0.28.10"
   },
   "scripts": {
     "build": "tsgo --noEmit && tsup index.ts --format cjs,esm --no-splitting --dts --tsconfig tsconfig.json --out-dir lib --clean",