@redocly/api-docs 0.0.2

package/lib/services/code-samples/generators/helpers/oauth2-snippets.d.ts

@@ -0,0 +1,21 @@
+import type { CodeBuilder } from './code-builder.js';
+interface BuildCodeSnippetParams {
+    tokenUrl: string;
+    clientId: string;
+    level: number;
+    responseVariable?: string;
+    capitalize?: boolean;
+    short?: boolean;
+}
+export declare function buildJSDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildPythonDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildPHPDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildGoDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildCSharpDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildCSharpNewtonsoftDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildJavaDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildJava8DeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level }: BuildCodeSnippetParams): void;
+export declare function buildRDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level, responseVariable }: BuildCodeSnippetParams): void;
+export declare function buildRubyDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, level, responseVariable, capitalize }: BuildCodeSnippetParams): void;
+export declare function buildShellDeviceAuthorizationCodeSnippet(code: CodeBuilder, { tokenUrl, clientId, short }: BuildCodeSnippetParams): void;
+export {};

package/lib/services/code-samples/generators/helpers/oauth2-snippets.js

@@ -0,0 +1 @@
+function h(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,`const ${s.var("intervalMs")} = ((oAuth2Data.interval ?? 5) * 1000);`),s.push(p,`const ${s.var("deadline")} = Date.now() + (oAuth2Data.expires_in ?? 600) * 1000;`),s.push(p,`let ${s.var("accessToken")} = '';`),s.blank(),s.push(p,`while (Date.now() < ${s.var("deadline")}) {`),s.push(p+1,`await new Promise(resolve => setTimeout(resolve, ${s.var("intervalMs")}));`),s.blank(),s.push(p+1,`const oAuth2PollResponse = await fetch('${t}', {`),s.push(p+2,"method: 'POST',"),s.push(p+2,"headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },"),s.push(p+2,"body: new URLSearchParams({"),s.push(p+3,"'grant_type': 'urn:ietf:params:oauth:grant-type:device_code',"),s.push(p+3,"'device_code': oAuth2Data.device_code,"),s.push(p+3,`'client_id': '${a}',`),s.push(p+2,"}).toString(),"),s.push(p+1,"});"),s.blank(),s.push(p+1,"const oAuth2PollData = await oAuth2PollResponse.json();"),s.push(p+1,"if (oAuth2PollData.access_token) {"),s.push(p+2,"accessToken = oAuth2PollData.access_token;"),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,"if (oAuth2PollData.error === 'slow_down') {"),s.push(p+2,`${s.var("intervalMs")} = Math.min(${s.var("intervalMs")} * 2, 10000);`),s.push(p+1,"}"),s.blank(),s.push(p+1,"if (oAuth2PollData.error === 'access_denied' || oAuth2PollData.error === 'expired_token') {"),s.push(p+2,"throw new Error(`Device flow failed: ${oAuth2PollData.error}`);"),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (!accessToken) throw new Error('Timed out waiting for authorization');"),s.blank()}function o(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,'interval_ms = (oauth2_data.get("interval", 5) * 1000)'),s.push(p,'deadline = time.time() + oauth2_data.get("expires_in", 600)'),s.push(p,'access_token = ""'),s.blank(),s.push(p,"while time.time() < deadline:"),s.push(p+1,"time.sleep(interval_ms / 1000)"),s.blank(),s.push(p+1,"oauth2_poll_response = requests.post("),s.push(p+2,`"${t}",`),s.push(p+2,"data={"),s.push(p+3,'"grant_type": "urn:ietf:params:oauth:grant-type:device_code",'),s.push(p+3,'"device_code": oauth2_data["device_code"],'),s.push(p+3,`"client_id": "${a}"`),s.push(p+2,"},"),s.push(p+2,"headers={"),s.push(p+3,'"Content-Type": "application/x-www-form-urlencoded",'),s.push(p+3,'"Accept": "application/json"'),s.push(p+2,"}"),s.push(p+1,")"),s.blank(),s.push(p+1,"oauth2_poll_data = oauth2_poll_response.json()"),s.blank(),s.push(p+1,'if "access_token" in oauth2_poll_data:'),s.push(p+2,'access_token = oauth2_poll_data["access_token"]'),s.push(p+2,"break"),s.blank(),s.push(p+1,'if oauth2_poll_data.get("error") == "slow_down":'),s.push(p+2,"interval_ms = min(interval_ms * 2, 10000)"),s.blank(),s.push(p+1,'if oauth2_poll_data.get("error") in ["access_denied", "expired_token"]:'),s.push(p+2,`raise Exception(f"Device flow failed: {oauth2_poll_data['error']}")`),s.blank(),s.push(p,"if not access_token:"),s.push(p+1,'raise Exception("Timed out waiting for authorization")'),s.blank()}function _(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,"$intervalMs = ($oAuth2Response->interval ?? 5) * 1000;"),s.push(p,"$deadline = time() + ($oAuth2Response->expires_in ?? 600);"),s.push(p,'$accessToken = "";'),s.blank(),s.push(p,"while (time() < $deadline) {"),s.push(p+1,"usleep($intervalMs * 1000);"),s.blank(),s.push(p+1,"$pollCurl = curl_init();"),s.push(p+1,"curl_setopt_array($pollCurl, ["),s.push(p+2,`CURLOPT_URL => "${t}",`),s.push(p+2,"CURLOPT_RETURNTRANSFER => true,"),s.push(p+2,"CURLOPT_POST => true,"),s.push(p+2,"CURLOPT_POSTFIELDS => http_build_query(["),s.push(p+3,'"grant_type" => "urn:ietf:params:oauth:grant-type:device_code",'),s.push(p+3,'"device_code" => $oAuth2Response->device_code,'),s.push(p+3,`"client_id" => "${a}"`),s.push(p+2,"]),"),s.push(p+2,"CURLOPT_HTTPHEADER => ["),s.push(p+3,'"Content-Type: application/x-www-form-urlencoded",'),s.push(p+3,'"Accept: application/json"'),s.push(p+2,"]"),s.push(p+1,"]);"),s.blank(),s.push(p+1,"$pollResponse = curl_exec($pollCurl);"),s.push(p+1,"curl_close($pollCurl);"),s.push(p+1,"$pollData = json_decode($pollResponse);"),s.blank(),s.push(p+1,"if (isset($pollData->access_token)) {"),s.push(p+2,"$accessToken = $pollData->access_token;"),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (isset($pollData->error) && $pollData->error === "slow_down") {'),s.push(p+2,"$intervalMs = min($intervalMs * 2, 10000);"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (isset($pollData->error) && in_array($pollData->error, ["access_denied", "expired_token"])) {'),s.push(p+2,'throw new Exception("Device flow failed: " . $pollData->error);'),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (empty($accessToken)) {"),s.push(p+1,'throw new Exception("Timed out waiting for authorization");'),s.push(p,"}"),s.blank()}function k(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,"var intervalMs int64"),s.push(p,"if oAuth2ResBody.Interval != 0 {"),s.push(p+1,"intervalMs = oAuth2ResBody.Interval"),s.push(p,"} else {"),s.push(p+1,"intervalMs = 5"),s.push(p,"}"),s.blank(),s.push(p,"var expiresIn int64"),s.push(p,"if oAuth2ResBody.Expires_in != 0 {"),s.push(p+1,"expiresIn = oAuth2ResBody.Expires_in"),s.push(p,"} else {"),s.push(p+1,"expiresIn = 600"),s.push(p,"}"),s.push(p,"deadline := time.Now().Unix() + expiresIn"),s.push(p,"var accessToken string"),s.blank(),s.push(p,"for time.Now().Unix() < deadline {"),s.push(p+1,"time.Sleep(time.Duration(intervalMs) * time.Second)"),s.blank(),s.push(p+1,"pollData := url.Values{}"),s.push(p+1,'pollData.Set("grant_type", "urn:ietf:params:oauth:grant-type:device_code")'),s.push(p+1,'pollData.Set("device_code", oAuth2ResBody.Device_code)'),s.push(p+1,`pollData.Set("client_id", "${a}")`),s.blank(),s.push(p+1,`pollReq, err := http.NewRequest("POST", "${t}", strings.NewReader(pollData.Encode()))`),s.push(p+1,"if err != nil {"),s.push(p+2,"panic(err)"),s.push(p+1,"}"),s.blank(),s.push(p+1,'pollReq.Header.Add("Content-Type", "application/x-www-form-urlencoded")'),s.push(p+1,'pollReq.Header.Add("Accept", "application/json")'),s.push(p+1,'pollReq.Header.Add("Content-Length", strconv.Itoa(len(pollData.Encode())))'),s.blank(),s.push(p+1,"pollRes, err := http.DefaultClient.Do(pollReq)"),s.push(p+1,"if err != nil {"),s.push(p+2,"panic(err)"),s.push(p+1,"}"),s.blank(),s.push(p+1,"var pollResBody struct {"),s.push(p+2,"Access_token string"),s.push(p+2,"Error string"),s.push(p+1,"}"),s.push(p+1,"err = json.NewDecoder(pollRes.Body).Decode(&pollResBody)"),s.push(p+1,"if err != nil {"),s.push(p+2,"panic(err)"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if pollResBody.Access_token != "" {'),s.push(p+2,"accessToken = pollResBody.Access_token"),s.push(p+2,"break"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if pollResBody.Error == "slow_down" {'),s.push(p+2,"if intervalMs*2 < 10 {"),s.push(p+3,"intervalMs = intervalMs * 2"),s.push(p+2,"} else {"),s.push(p+3,"intervalMs = 10"),s.push(p+2,"}"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if pollResBody.Error == "access_denied" || pollResBody.Error == "expired_token" {'),s.push(p+2,'panic("Device flow failed: " + pollResBody.Error)'),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,'if accessToken == "" {'),s.push(p+1,'panic("Timed out waiting for authorization")'),s.push(p,"}"),s.blank()}function w(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,"using JsonDocument oauth2JsonDoc = JsonDocument.Parse(oauth2Response);"),s.blank(),s.push(p,'var intervalMs = oauth2JsonDoc.RootElement.TryGetProperty("interval", out var intervalProp)'),s.push(p+1,"? intervalProp.GetInt32() * 1000"),s.push(p+1,": 5000;"),s.push(p,'var expiresIn = oauth2JsonDoc.RootElement.TryGetProperty("expires_in", out var expiresProp)'),s.push(p+1,"? expiresProp.GetInt32()"),s.push(p+1,": 600;"),s.push(p,"var deadline = DateTime.UtcNow.AddSeconds(expiresIn);"),s.push(p,'var deviceCode = oauth2JsonDoc.RootElement.GetProperty("device_code").GetString();'),s.push(p,"string accessToken = null;"),s.blank(),s.push(p,"while (DateTime.UtcNow < deadline)"),s.push(p,"{"),s.push(p+1,"await Task.Delay(intervalMs);"),s.blank(),s.push(p+1,"List<KeyValuePair<string, string>> pollData = new List<KeyValuePair<string, string>>();"),s.push(p+1,'pollData.Add(new KeyValuePair<string, string>("grant_type", "urn:ietf:params:oauth:grant-type:device_code"));'),s.push(p+1,'pollData.Add(new KeyValuePair<string, string>("device_code", deviceCode));'),s.push(p+1,`pollData.Add(new KeyValuePair<string, string>("client_id", "${a}"));`),s.blank(),s.push(p+1,"using HttpResponseMessage pollResponse = await oauth2Client.PostAsync("),s.push(p+2,`"${t}",`),s.push(p+2,"new FormUrlEncodedContent(pollData));"),s.blank(),s.push(p+1,"string pollJson = await pollResponse.Content.ReadAsStringAsync();"),s.push(p+1,"using JsonDocument pollDoc = JsonDocument.Parse(pollJson);"),s.blank(),s.push(p+1,'if (pollDoc.RootElement.TryGetProperty("access_token", out var tokenProp))'),s.push(p+1,"{"),s.push(p+2,"accessToken = tokenProp.GetString();"),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (pollDoc.RootElement.TryGetProperty("error", out var errorProp))'),s.push(p+1,"{"),s.push(p+2,"string errorValue = errorProp.GetString();"),s.push(p+2,'if (errorValue == "slow_down")'),s.push(p+2,"{"),s.push(p+3,"intervalMs = Math.Min(intervalMs * 2, 10000);"),s.push(p+2,"}"),s.push(p+2,'else if (errorValue == "access_denied" || errorValue == "expired_token")'),s.push(p+2,"{"),s.push(p+3,'throw new Exception($"Device flow failed: {errorValue}");'),s.push(p+2,"}"),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (string.IsNullOrEmpty(accessToken))"),s.push(p,"{"),s.push(p+1,'throw new Exception("Timed out waiting for authorization");'),s.push(p,"}"),s.blank()}function b(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,"JObject oauth2JObject = JObject.Parse(oauth2Response);"),s.blank(),s.push(p,'var intervalMs = oauth2JObject["interval"] != null'),s.push(p+1,'? (int)oauth2JObject["interval"] * 1000'),s.push(p+1,": 5000;"),s.push(p,'var expiresIn = oauth2JObject["expires_in"] != null'),s.push(p+1,'? (int)oauth2JObject["expires_in"]'),s.push(p+1,": 600;"),s.push(p,"var deadline = DateTime.UtcNow.AddSeconds(expiresIn);"),s.push(p,'var deviceCode = oauth2JObject["device_code"].ToString();'),s.push(p,"string accessToken = null;"),s.blank(),s.push(p,"while (DateTime.UtcNow < deadline)"),s.push(p,"{"),s.push(p+1,"await Task.Delay(intervalMs);"),s.blank(),s.push(p+1,"List<KeyValuePair<string, string>> pollData = new List<KeyValuePair<string, string>>();"),s.push(p+1,'pollData.Add(new KeyValuePair<string, string>("grant_type", "urn:ietf:params:oauth:grant-type:device_code"));'),s.push(p+1,'pollData.Add(new KeyValuePair<string, string>("device_code", deviceCode));'),s.push(p+1,`pollData.Add(new KeyValuePair<string, string>("client_id", "${a}"));`),s.blank(),s.push(p+1,"var pollResponse = await client.PostAsync("),s.push(p+2,`"${t}",`),s.push(p+2,"new FormUrlEncodedContent(pollData));"),s.blank(),s.push(p+1,"string pollJson = await pollResponse.Content.ReadAsStringAsync();"),s.push(p+1,"JObject pollJObject = JObject.Parse(pollJson);"),s.blank(),s.push(p+1,'if (pollJObject["access_token"] != null)'),s.push(p+1,"{"),s.push(p+2,'accessToken = pollJObject["access_token"].ToString();'),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (pollJObject["error"] != null)'),s.push(p+1,"{"),s.push(p+2,'string errorValue = pollJObject["error"].ToString();'),s.push(p+2,'if (errorValue == "slow_down")'),s.push(p+2,"{"),s.push(p+3,"intervalMs = Math.Min(intervalMs * 2, 10000);"),s.push(p+2,"}"),s.push(p+2,'else if (errorValue == "access_denied" || errorValue == "expired_token")'),s.push(p+2,"{"),s.push(p+3,'throw new Exception($"Device flow failed: {errorValue}");'),s.push(p+2,"}"),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (string.IsNullOrEmpty(accessToken))"),s.push(p,"{"),s.push(p+1,'throw new Exception("Timed out waiting for authorization");'),s.push(p,"}"),s.blank()}function f(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,"var oauth2JsonObject = new JSONObject(oauth2Response.body());"),s.blank(),s.push(p,'var intervalMs = oauth2JsonObject.has("interval")'),s.push(p+1,'? oauth2JsonObject.getInt("interval") * 1000'),s.push(p+1,": 5000;"),s.push(p,'var expiresIn = oauth2JsonObject.has("expires_in")'),s.push(p+1,'? oauth2JsonObject.getInt("expires_in")'),s.push(p+1,": 600;"),s.push(p,"var deadline = System.currentTimeMillis() + (expiresIn * 1000L);"),s.push(p,'var deviceCode = oauth2JsonObject.getString("device_code");'),s.push(p,"String accessToken = null;"),s.blank(),s.push(p,"while (System.currentTimeMillis() < deadline) {"),s.push(p+1,"Thread.sleep(intervalMs);"),s.blank(),s.push(p+1,"HashMap<String, String> pollParams = new HashMap<>();"),s.push(p+1,'pollParams.put("grant_type", "urn:ietf:params:oauth:grant-type:device_code");'),s.push(p+1,'pollParams.put("device_code", deviceCode);'),s.push(p+1,`pollParams.put("client_id", "${a}");`),s.blank(),s.push(p+1,"var pollForm = pollParams.keySet().stream()"),s.push(p+2,'.map(key -> key + "=" + URLEncoder.encode(pollParams.get(key), StandardCharsets.UTF_8))'),s.push(p+2,'.collect(Collectors.joining("&"));'),s.blank(),s.push(p+1,"var pollRequest = HttpRequest.newBuilder()"),s.push(p+2,".POST(HttpRequest.BodyPublishers.ofString(pollForm))"),s.push(p+2,`.uri(URI.create("${t}"))`),s.push(p+2,'.header("Content-Type", "application/x-www-form-urlencoded")'),s.push(p+2,'.header("Accept", "application/json")'),s.push(p+2,".build();"),s.blank(),s.push(p+1,"var pollResponse = httpClient.send(pollRequest, HttpResponse.BodyHandlers.ofString());"),s.push(p+1,"var pollJsonObject = new JSONObject(pollResponse.body());"),s.blank(),s.push(p+1,'if (pollJsonObject.has("access_token")) {'),s.push(p+2,'accessToken = pollJsonObject.getString("access_token");'),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (pollJsonObject.has("error")) {'),s.push(p+2,'String errorValue = pollJsonObject.getString("error");'),s.push(p+2,'if (errorValue.equals("slow_down")) {'),s.push(p+3,"intervalMs = Math.min(intervalMs * 2, 10000);"),s.push(p+2,"}"),s.push(p+2,'else if (errorValue.equals("access_denied") || errorValue.equals("expired_token")) {'),s.push(p+3,'throw new Exception("Device flow failed: " + errorValue);'),s.push(p+2,"}"),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (accessToken == null) {"),s.push(p+1,'throw new Exception("Timed out waiting for authorization");'),s.push(p,"}"),s.blank()}function m(s,{tokenUrl:t,clientId:a,level:p}){s.push(p,'var intervalMs = oauth2Response.has("interval") ? oauth2Response.getInt("interval") * 1000 : 5000;'),s.push(p,'var expiresIn = oauth2Response.has("expires_in") ? oauth2Response.getInt("expires_in") : 600;'),s.push(p,"var deadline = System.currentTimeMillis() + (expiresIn * 1000L);"),s.push(p,'var deviceCode = oauth2Response.getString("device_code");'),s.push(p,"String accessToken = null;"),s.blank(),s.push(p,"while (System.currentTimeMillis() < deadline) {"),s.push(p+1,"Thread.sleep(intervalMs);"),s.blank(),s.push(p+1,`HttpPost pollRequest = new HttpPost("${t}");`),s.push(p+1,'pollRequest.setHeader("Content-Type", "application/x-www-form-urlencoded");'),s.push(p+1,'pollRequest.setHeader("Accept", "application/json");'),s.blank(),s.push(p+1,"List<NameValuePair> pollParams = new ArrayList<NameValuePair>();"),s.push(p+1,'pollParams.add(new BasicNameValuePair("grant_type", "urn:ietf:params:oauth:grant-type:device_code"));'),s.push(p+1,'pollParams.add(new BasicNameValuePair("device_code", deviceCode));'),s.push(p+1,`pollParams.add(new BasicNameValuePair("client_id", "${a}"));`),s.push(p+1,"pollRequest.setEntity(new UrlEncodedFormEntity(pollParams));"),s.blank(),s.push(p+1,"JSONObject pollResponse = new JSONObject(EntityUtils.toString(httpClient.execute(pollRequest).getEntity()));"),s.blank(),s.push(p+1,'if (pollResponse.has("access_token")) {'),s.push(p+2,'accessToken = pollResponse.getString("access_token");'),s.push(p+2,"break;"),s.push(p+1,"}"),s.blank(),s.push(p+1,'if (pollResponse.has("error")) {'),s.push(p+2,'String errorValue = pollResponse.getString("error");'),s.push(p+2,'if (errorValue.equals("slow_down")) {'),s.push(p+3,"intervalMs = Math.min(intervalMs * 2, 10000);"),s.push(p+2,"}"),s.push(p+2,'else if (errorValue.equals("access_denied") || errorValue.equals("expired_token")) {'),s.push(p+3,'throw new RuntimeException("Device flow failed: " + errorValue);'),s.push(p+2,"}"),s.push(p+1,"}"),s.push(p,"}"),s.blank(),s.push(p,"if (accessToken == null) {"),s.push(p+1,'throw new RuntimeException("Timed out waiting for authorization");'),s.push(p,"}"),s.blank()}function R(s,{tokenUrl:t,clientId:a,level:p,responseVariable:u}){const i=u||"oauth2_data_req";s.push(`oauth2_response = content(${i}, "parsed")`),s.blank(),s.push("interval_ms = if (!is.null(oauth2_response$interval)) oauth2_response$interval * 1000 else 5000"),s.push("expires_in = if (!is.null(oauth2_response$expires_in)) oauth2_response$expires_in else 600"),s.push("deadline = as.numeric(Sys.time()) + expires_in"),s.push("device_code = oauth2_response$device_code"),s.push("access_token = NULL"),s.blank(),s.push("while (as.numeric(Sys.time()) < deadline) {"),s.push(p+1,"Sys.sleep(interval_ms / 1000)"),s.blank(),s.push(p+1,"poll_body <- list("),s.push(p+2,'grant_type = "urn:ietf:params:oauth:grant-type:device_code",'),s.push(p+2,"device_code = device_code,"),s.push(p+2,`client_id = "${a}"`),s.push(p+1,")"),s.blank(),s.push(p+1,"poll_response <- POST("),s.push(p+2,`"${t}",`),s.push(p+2,'add_headers("Content-Type" = "application/x-www-form-urlencoded", "Accept" = "application/json"),'),s.push(p+2,"body = poll_body,"),s.push(p+2,'encode = "form",'),s.push(p+2,"verbose()"),s.push(p+1,")"),s.blank(),s.push(p+1,'poll_data = content(poll_response, "parsed")'),s.blank(),s.push(p+1,"if (!is.null(poll_data$access_token)) {"),s.push(p+2,"access_token = poll_data$access_token"),s.push(p+2,"break"),s.push(p+1,"}"),s.blank(),s.push(p+1,"if (!is.null(poll_data$error)) {"),s.push(p+2,'if (poll_data$error == "slow_down") {'),s.push(p+3,"interval_ms = min(interval_ms * 2, 10000)"),s.push(p+2,'} else if (poll_data$error %in% c("access_denied", "expired_token")) {'),s.push(p+3,'stop(paste("Device flow failed:", poll_data$error))'),s.push(p+2,"}"),s.push(p+1,"}"),s.push("}"),s.blank(),s.push("if (is.null(access_token)) {"),s.push(p+1,'stop("Timed out waiting for authorization")'),s.push("}"),s.blank()}function g(s,{tokenUrl:t,clientId:a,level:p,responseVariable:u,capitalize:i}){const r=u||"oAuth2Response",n=i?"OAuth2Data":"oauth2_data";s.push(`${n} = JSON.parse(${r}.body)`),s.blank(),s.push(`interval_ms = (${n}['interval'] || 5) * 1000`),s.push(`expires_in = ${n}['expires_in'] || 600`),s.push("deadline = Time.now.to_i + expires_in"),s.push(`device_code = ${n}['device_code']`),s.push("access_token = nil"),s.blank(),s.push("while Time.now.to_i < deadline"),s.push(p+1,"sleep(interval_ms / 1000.0)"),s.blank(),s.push(p+1,`poll_url = URI('${t}')`),s.push(p+1,"poll_http = Net::HTTP.new(poll_url.host, poll_url.port)"),s.push(p+1,"poll_request = Net::HTTP::Post.new(poll_url)"),s.push(p+1,"poll_request['Content-Type'] = 'application/x-www-form-urlencoded'"),s.push(p+1,"poll_request['Accept'] = 'application/json'"),s.push(p+1,"poll_request.body = URI.encode_www_form({"),s.push(p+2,"grant_type: 'urn:ietf:params:oauth:grant-type:device_code',"),s.push(p+2,"device_code: device_code,"),s.push(p+2,`client_id: '${a}'`),s.push(p+1,"})"),s.blank(),s.push(p+1,"poll_response = poll_http.request(poll_request)"),s.push(p+1,"poll_data = JSON.parse(poll_response.body)"),s.blank(),s.push(p+1,"if poll_data['access_token']"),s.push(p+2,"access_token = poll_data['access_token']"),s.push(p+2,"break"),s.push(p+1,"end"),s.blank(),s.push(p+1,"if poll_data['error']"),s.push(p+2,"if poll_data['error'] == 'slow_down'"),s.push(p+3,"interval_ms = [interval_ms * 2, 10000].min"),s.push(p+2,"elsif ['access_denied', 'expired_token'].include?(poll_data['error'])"),s.push(p+3,`raise "Device flow failed: #{poll_data['error']}"`),s.push(p+2,"end"),s.push(p+1,"end"),s.push("end"),s.blank(),s.push("raise 'Timed out waiting for authorization' if access_token.nil?"),s.blank()}function y(s,{tokenUrl:t,clientId:a,short:p}){s.push(""),s.push("# Parse device code response"),s.push(`DEVICE_CODE=$(echo "$OAUTH2_RESPONSE" | jq -r '.device_code')`),s.push(`INTERVAL=$(echo "$OAUTH2_RESPONSE" | jq -r '.interval // 5')`),s.push(`EXPIRES_IN=$(echo "$OAUTH2_RESPONSE" | jq -r '.expires_in // 600')`),s.push("DEADLINE=$(($(date +%s) + EXPIRES_IN))"),s.push('ACCESS_TOKEN=""'),s.push(""),s.push("# Poll for access token"),s.push("while [ $(date +%s) -lt $DEADLINE ]; do"),s.push("  sleep $INTERVAL"),s.push(""),s.push(`  POLL_RESPONSE=$(curl -s ${p?"-X":"--request"} POST \\`),s.push(`    ${t} \\`),s.push(`    ${p?"-H":"--header"} 'Content-Type: application/x-www-form-urlencoded' \\`),s.push(`    ${p?"-H":"--header"} 'Accept: application/json' \\`),s.push(`    ${p?"-d":"--data"} grant_type=urn:ietf:params:oauth:grant-type:device_code \\`),s.push(`    ${p?"-d":"--data"} device_code=$DEVICE_CODE \\`),s.push(`    ${p?"-d":"--data"} client_id=${a})`),s.push(""),s.push(`  ACCESS_TOKEN=$(echo "$POLL_RESPONSE" | jq -r '.access_token // empty')`),s.push('  [ ! -z "$ACCESS_TOKEN" ] && break'),s.push(""),s.push(`  ERROR=$(echo "$POLL_RESPONSE" | jq -r '.error // empty')`),s.push('  if [ "$ERROR" = "slow_down" ]; then'),s.push("    INTERVAL=$((INTERVAL * 2))"),s.push("    [ $INTERVAL -gt 10 ] && INTERVAL=10"),s.push('  elif [ "$ERROR" = "access_denied" ] || [ "$ERROR" = "expired_token" ]; then'),s.push('    echo "Device flow failed: $ERROR" >&2'),s.push("    exit 1"),s.push("  fi"),s.push("done"),s.push(""),s.push('if [ -z "$ACCESS_TOKEN" ]; then'),s.push('  echo "Timed out waiting for authorization" >&2'),s.push("  exit 1"),s.push("fi"),s.push("")}export{w as buildCSharpDeviceAuthorizationCodeSnippet,b as buildCSharpNewtonsoftDeviceAuthorizationCodeSnippet,k as buildGoDeviceAuthorizationCodeSnippet,h as buildJSDeviceAuthorizationCodeSnippet,m as buildJava8DeviceAuthorizationCodeSnippet,f as buildJavaDeviceAuthorizationCodeSnippet,_ as buildPHPDeviceAuthorizationCodeSnippet,o as buildPythonDeviceAuthorizationCodeSnippet,R as buildRDeviceAuthorizationCodeSnippet,g as buildRubyDeviceAuthorizationCodeSnippet,y as buildShellDeviceAuthorizationCodeSnippet};

package/lib/services/code-samples/generators/helpers/php-array.d.ts

@@ -0,0 +1,6 @@
+export interface ObjectToPhpArrayOptions {
+    indent?: string;
+    inlineCharacterLimit?: number;
+    singleQuotes?: boolean;
+}
+export declare function objectToPhpArray(input: unknown, options?: ObjectToPhpArrayOptions): string;

package/lib/services/code-samples/generators/helpers/php-array.js

@@ -0,0 +1,5 @@
+const h=new Set(["number","boolean","function","symbol"]);function y(e,t={}){return u(e,t,"",[])}function u(e,t,a,i){const o=t.indent||"	",n={newLine:`
+`,newLineOrSpace:`
+`,pad:a,indent:a+o},L=r=>{if(t.inlineCharacterLimit===void 0)return r;const c=r.replace(new RegExp(n.newLine,"g"),"").replace(new RegExp(n.newLineOrSpace,"g")," ").replace(new RegExp(f(n.pad)+"|"+f(n.indent),"g"),"");return c.length<=t.inlineCharacterLimit?c:r.replace(new RegExp(n.newLine+"|"+n.newLineOrSpace,"g"),`
+`).replace(new RegExp(f(n.pad),"g"),a).replace(new RegExp(f(n.indent),"g"),a+o)};if(i.includes(e))return'"Circular"';if(e===null)return"NULL";if(e===void 0||h.has(typeof e))return String(e);if(Array.isArray(e)){if(e.length===0)return"array()";i.push(e);const r="array("+n.newLine+e.map((c,w)=>{const g=e.length-1===w?n.newLine:","+n.newLineOrSpace,s=u(c,t,a+o,i);return n.indent+s+g}).join("")+n.pad+")";return i.pop(),L(r)}if(typeof e=="object"){const r=e,c=Object.keys(r);if(c.length===0)return"(object)[]";i.push(e);const w="array("+n.newLine+c.map((g,s)=>{const p=c.length-1===s?n.newLine:","+n.newLineOrSpace,d=u(r[g],t,a+o,i);return`${n.indent}"${g}" => ${d}${p}`}).join("")+n.pad+")";return i.pop(),L(w)}let l=String(e).replace(/[\r\n]/g,r=>r===`
+`?"\\n":"\\r");return t.singleQuotes===!1?(l=l.replace(/"/g,'\\"'),`"${l}"`):(l=l.replace(/\\?'/g,"\\'"),`"${l}"`)}function f(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}export{y as objectToPhpArray};

package/lib/services/code-samples/generators/helpers/r-utils.d.ts

@@ -0,0 +1,7 @@
+import type * as HAR from '../../har.js';
+export declare function objectToRString(input?: Record<string, unknown> | unknown[] | string, options?: {
+    indent?: string;
+}): string;
+export declare function postDataToRListBody(input: HAR.Param[], options: {
+    indent?: string;
+}): string;

package/lib/services/code-samples/generators/helpers/r-utils.js

@@ -0,0 +1,6 @@
+function i(n,t){return n==null||n===""?"":typeof n=="string"?JSON.stringify(n):JSON.stringify(n,null,1).split(`
+`).map((o,r,e)=>r===e.length-1?o:(t?.indent??" ")+o).join(`
+`).trim()}function f(n,t){return`
+`+n.map(({name:r,value:e})=>(t?.indent??"")+`${r} = "${e??""}"`).join(`,
+`)+`
+`}export{i as objectToRString,f as postDataToRListBody};

package/lib/services/code-samples/generators/helpers/shell.d.ts

@@ -0,0 +1,8 @@
+export declare const shellHelpers: {
+    /**
+     * Strong single-quote shell quoting. Matches bash's single-quote rules: only
+     * single quotes need escaping, everything else is literal.
+     */
+    quote(value: string): string;
+    escape(value: string): string;
+};

package/lib/services/code-samples/generators/helpers/shell.js

@@ -0,0 +1 @@
+const n=/^[a-z0-9-_/.@%^=:]+$/i;function c(e,...r){let t=0;return e.replace(/%s/g,()=>t<r.length?String(r[t++]):"%s")}const s={quote(e){return n.test(e)?e:c("'%s'",e.replace(/'/g,"'\\''"))},escape(e){return e.replace(/\r/g,"\\r").replace(/\n/g,"\\n")}};export{s as shellHelpers};

package/lib/services/code-samples/generators/helpers/string-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function camelCase(s: string): string;
+export declare function snakeCase(s: string): string;
+export declare function pascalCase(s: string): string;
+export declare function escapeSingleQuoted(value: string): string;

package/lib/services/code-samples/generators/helpers/string-utils.js

@@ -0,0 +1 @@
+const S=RegExp.prototype.test.bind(/[a-z][A-Z]|[A-Z]{2}[a-z]|[0-9][a-zA-Z]|[a-zA-Z][0-9]|[^a-zA-Z0-9 ]/),Z=/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g,n="\\ud800-\\udfff",k="\\u0300-\\u036f",D="\\ufe20-\\ufe2f",W="\\u20d0-\\u20ff",H="\\u1ab0-\\u1aff",N="\\u1dc0-\\u1dff",$=k+D+W+H+N,i="\\u2700-\\u27bf",p="a-z\\xdf-\\xf6\\xf8-\\xff",T="\\xac\\xb1\\xd7\\xf7",V="\\x00-\\x2f\\x3a-\\x40\\x5b-\\x60\\x7b-\\xbf",_="\\u2000-\\u206f",y=" \\t\\x0b\\f\\xa0\\ufeff\\n\\r\\u2028\\u2029\\u1680\\u180e\\u2000\\u2001\\u2002\\u2003\\u2004\\u2005\\u2006\\u2007\\u2008\\u2009\\u200a\\u202f\\u205f\\u3000",x="A-Z\\xc0-\\xd6\\xd8-\\xde",g="\\ufe0e\\ufe0f",b=T+V+_+y,R="['\u2019]",C=`[${b}]`,c=`[${$}]`,l="\\d",B=`[${i}]`,m=`[${p}]`,U=`[^${n}${b+l+i+p+x}]`,a="\\ud83c[\\udffb-\\udfff]",F=`(?:${c}|${a})`,A=`[^${n}]`,u="(?:\\ud83c[\\udde6-\\uddff]){2}",f="[\\ud800-\\udbff][\\udc00-\\udfff]",e=`[${x}]`,L="\\u200d",M=`(?:${m}|${U})`,J=`(?:${e}|${U})`,h=`(?:${R}(?:d|ll|m|re|s|t|ve))?`,w=`(?:${R}(?:D|LL|M|RE|S|T|VE))?`,j=`${F}?`,z=`[${g}]?`,P=`(?:${L}(?:${[A,u,f].join("|")})${z+j})*`,q="\\d*(?:1st|2nd|3rd|(?![123])\\dth)(?=\\b|[A-Z_])",v="\\d*(?:1ST|2ND|3RD|(?![123])\\dTH)(?=\\b|[a-z_])",E=z+j+P,Q=`(?:${[B,u,f].join("|")})${E}`,G=RegExp([`${e}?${m}+${h}(?=${[C,e,"$"].join("|")})`,`${J}+${w}(?=${[C,e+M,"$"].join("|")})`,`${e}?${M}+${h}`,`${e}+${w}`,v,q,`${l}+`,Q].join("|"),"g"),I=RegExp(`[${L+n+$+g}]`),K=s=>I.test(s),X=RegExp(`${a}(?=${a})|(?:${[`${A}${c}?`,c,u,f,`[${n}]`].join("|")})${E}`,"g");function d(s){const o=s.replace(/['\u2019]/g,"");return(S(o)?o.match(G):o.match(Z))||[]}function O(s){if(!s)return"";if(K(s)){const o=s.match(X)||[];return(o[0]||"").toUpperCase()+o.slice(1).join("")}return s[0].toUpperCase()+s.slice(1)}function Y(s){return d(s).reduce((o,r,t)=>o+(t?O(r.toLowerCase()):r.toLowerCase()),"")}function ss(s){return d(s).reduce((o,r,t)=>o+(t?"_":"")+r.toLowerCase(),"")}function os(s){return d(s).reduce((o,r)=>o+O(r.toLowerCase()),"")}function rs(s){return s.replace(/\\/g,"\\\\").replace(/'/g,"\\'")}export{Y as camelCase,rs as escapeSingleQuoted,os as pascalCase,ss as snakeCase};

package/lib/services/code-samples/generators/helpers/stringify-js.d.ts

@@ -0,0 +1,11 @@
+export type TransformFn = (input: Record<string, unknown>, key: string, originalResult: string) => string;
+export interface StringifyOptions {
+    indent?: string;
+    inlineCharacterLimit?: number;
+    transform?: TransformFn;
+}
+export declare function stringifyJSObject(value: unknown, options?: StringifyOptions): string;
+export declare function getPreserveTransformer({ body, authorizationHeader, }: {
+    body?: boolean;
+    authorizationHeader?: boolean;
+}): TransformFn;

package/lib/services/code-samples/generators/helpers/stringify-js.js

@@ -0,0 +1,8 @@
+const j=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function A(n,r={}){return $(n,r,0,void 0,void 0)}function $(n,r,t,s,d){const{indent:u="	",inlineCharacterLimit:y,transform:b}=r;let e;if(n==null)e=String(n);else if(typeof n=="string")e=h(n);else if(typeof n=="number"||typeof n=="boolean")e=String(n);else if(Array.isArray(n))if(n.length===0)e="[]";else{const f=n.map(o=>$(o,r,t+1,void 0,void 0)),c=`[${f.join(", ")}]`;if(l(c,y))e=c;else{const o=u.repeat(t+1),g=u.repeat(t);e=`[
+${f.map(i=>o+i).join(`,
+`)}
+${g}]`}}else if(typeof n=="object"){const f=n,c=Object.entries(f);if(c.length===0)e="{}";else{const o=c.map(([i,a])=>{const p=j.test(i)?i:h(i),m=$(a,r,t+1,f,i);return`${p}: ${m}`}),g=`{${o.join(", ")}}`;if(l(g,y))e=g;else{const i=u.repeat(t+1),a=u.repeat(t);e=`{
+${o.map(p=>i+p).join(`,
+`)}
+${a}}`}}}else e=String(n);return b&&s!==void 0&&d!==void 0?b(s,d,e):e}function h(n){return`'${n.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(/\n/g,"\\n").replace(/\r/g,"\\r")}'`}function l(n,r){return r===void 0||n.includes(`
+`)?!1:n.length<=r}function z({body:n,authorizationHeader:r}){return function(t,s,d){return n&&s==="body"&&typeof t.body=="string"?t.body:r&&s==="Authorization"&&typeof t.Authorization=="string"?t.Authorization:d}}export{z as getPreserveTransformer,A as stringifyJSObject};

package/lib/services/code-samples/generators/helpers/sub-request.d.ts

@@ -0,0 +1,2 @@
+import type { CodeSampleHAR, OAuth2PreRequest } from '../../sample-har.js';
+export declare function toCodeSampleHAR(preReq: OAuth2PreRequest): CodeSampleHAR;

package/lib/services/code-samples/generators/helpers/sub-request.js

@@ -0,0 +1 @@
+function n(a){const o={};for(const t of a.headers)o[t.name]=t.value;const s={};for(const t of a.queryString??[])s[t.name]=t.value;const r=a.postData?.params?.length?a.postData.params.reduce((t,e)=>(t[e.name]=e.value??"",t),{}):void 0;return{method:a.method.toUpperCase(),url:a.url,httpVersion:a.httpVersion??"HTTP/1.1",cookies:a.cookies??[],headers:a.headers,queryString:a.queryString??[],postData:a.postData,headersSize:a.headersSize??-1,bodySize:a.bodySize??-1,fullUrl:a.url,headersObj:o,allHeaders:{...o},queryObj:s,paramsObj:r,pathParameters:{},serverVariables:{}}}export{n as toCodeSampleHAR};

package/lib/services/code-samples/generators/helpers/url-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { CodeSampleHAR } from '../../sample-har.js';
+import type { CodeBuilder } from './code-builder.js';
+export type CodeOperand = {
+    type: 'string';
+    value: string;
+} | {
+    type: 'variable';
+    name: string;
+};
+export declare function parseUrlIntoOperands(url: string, params: Record<string, unknown>): CodeOperand[];
+export declare function buildUrlExpression(har: CodeSampleHAR, code: CodeBuilder, url?: string): string;
+export declare function printUrlVariablesDeclarations(har: CodeSampleHAR, code: CodeBuilder, indentationLevel?: number): void;
+export declare function addIndentation(str: string, { level, indent, firstLine }?: {
+    firstLine?: boolean | undefined;
+    indent?: string | undefined;
+    level?: number | undefined;
+}): string;

package/lib/services/code-samples/generators/helpers/url-helpers.js

@@ -0,0 +1,2 @@
+import{VariableType as b}from"./code-builder.js";function m(e,n){const i=Object.keys(n).map(r=>({name:r,idx:e.indexOf(`{${r}}`)})).filter(({idx:r})=>r>-1).sort((r,s)=>r.idx-s.idx),t=[];let a=0;for(const{name:r,idx:s}of i)s>a&&t.push({type:"string",value:e.substring(a,s)}),t.push({type:"variable",name:r}),a=s+r.length+2;return a<e.length&&t.push({type:"string",value:e.substring(a)}),t}function f(e,n,l){const{joinSymbol:i,variableWrapperFn:t,stringLiteral:a,urlFieldName:r,rawName:s}=n.langOptions,c={...e.pathParameters,...e.serverVariables},p=l??e[r]??"";return m(p,c).map(o=>{if(o.type==="variable"){const u=c[o.name],v=s?o.name:n.var(o.name,b.PATH);return t(v,u)}return a(o.value)}).join(i)}function g(e,n,l){const i={...e.pathParameters,...e.serverVariables};for(const[t,a]of Object.entries(i)){if(t==="server")continue;const r=a!=null&&a!==""?String(a):`YOUR_${t}_PARAMETER`,s=n.var(t,b.PATH),p=m(r,i).some(u=>u.type==="variable"),o=f(e,n,r);l!==void 0?n.push(l,n.langOptions.variableDeclaration(s,{hasVariableInterpolation:p}),o):n.push(n.langOptions.variableDeclaration(s,{hasVariableInterpolation:p}),o)}}function d(e,{level:n=0,indent:l="  ",firstLine:i=!0}={}){const t=l.repeat(n),a=e.replace(/(\r\n|\n|\r)/gm,`
+${t}`);return i?t.concat(a):a}export{d as addIndentation,f as buildUrlExpression,m as parseUrlIntoOperands,g as printUrlVariablesDeclarations};

package/lib/services/code-samples/generators/index.d.ts

@@ -0,0 +1,16 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+export type { GeneratorOptions } from './types.js';
+export declare function isSupportedLanguage(languageKey: string): boolean;
+export type CodeSampleResult = {
+    kind: 'ok';
+    source: string;
+} | {
+    kind: 'unsupported-language';
+    language: string;
+} | {
+    kind: 'error';
+    error: unknown;
+};
+export declare function tryGenerateCodeSample(languageKey: string, har: CodeSampleHAR, options?: GeneratorOptions): CodeSampleResult;
+export declare function generateCodeSample(languageKey: string, har: CodeSampleHAR, options?: GeneratorOptions): string;

package/lib/services/code-samples/generators/index.js

@@ -0,0 +1 @@
+import{generateCurl as s}from"./curl.js";import{generateJavaScript as m}from"./javascript.js";import{generateNode as a}from"./node.js";import{generatePython as p}from"./python.js";import{generateJava as i}from"./java.js";import{generateJava8 as u}from"./java8.js";import{generateCSharp as f}from"./csharp.js";import{generateCSharpNewtonsoft as c}from"./csharp-newtonsoft.js";import{generateGo as w}from"./go.js";import{generatePHP as h}from"./php.js";import{generateRuby as l}from"./ruby.js";import{generateR as C}from"./r.js";const n={curl:{withImports:!0,withComments:!1,short:!0},javascript:{withImports:!1,withComments:!1},node:{withImports:!0,withComments:!1},python:{withImports:!0,withComments:!1},java:{withImports:!0,withComments:!1},java8:{withImports:!0,withComments:!1},csharp:{withImports:!0,withComments:!1},csharpnewtonsoft:{withImports:!0,withComments:!1},go:{withImports:!0,withComments:!1},php:{withImports:!0,withComments:!1},ruby:{withImports:!0,withComments:!1},r:{withImports:!0,withComments:!1}};function g(r){return r in n}function N(r,t,o){if(!g(r))return{kind:"unsupported-language",language:r};try{return{kind:"ok",source:d(r,t,o)}}catch(e){return{kind:"error",error:e}}}function d(r,t,o){const e={...n[r],...o};switch(r){case"curl":return s(t,e);case"javascript":return m(t,e);case"node":return a(t,e);case"python":return p(t,e);case"java":return i(t,e);case"java8":return u(t,e);case"csharp":return f(t,e);case"csharpnewtonsoft":return c(t,e);case"go":return w(t,e);case"php":return h(t,e);case"ruby":return l(t,e);case"r":return C(t,e);default:return`// Unsupported language: ${r}`}}export{d as generateCodeSample,g as isSupportedLanguage,N as tryGenerateCodeSample};

package/lib/services/code-samples/generators/java.d.ts

@@ -0,0 +1,9 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type JavaOptions = GeneratorOptions & {
+    indent?: string;
+    withWrapper?: boolean;
+    variablesPrefix?: string;
+};
+export declare function generateJava(har: CodeSampleHAR, options?: JavaOptions): string;
+export {};

package/lib/services/code-samples/generators/java.js

@@ -0,0 +1,3 @@
+import{CodeBuilder as g,Lang as v}from"./helpers/code-builder.js";import{addIndentation as k,buildUrlExpression as D,printUrlVariablesDeclarations as S}from"./helpers/url-helpers.js";import{buildJavaDeviceAuthorizationCodeSnippet as j}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as m}from"./helpers/mime.js";import{MediaTypes as p}from"../../../constants/openapi.js";import{toCodeSampleHAR as R}from"./helpers/sub-request.js";function C(e){const n=e.match(/^([a-z][a-z0-9+.-]*:)\/\/([^/?#]+)(\/[^?#]*)?/i);return n?{protocol:n[1],host:n[2],pathname:n[3]??"/"}:{protocol:"http:",host:"localhost",pathname:"/"}}function h(e){return e.postData&&m(e.postData.mimeType)===p.URL_ENCODED?"HttpRequest.BodyPublishers.ofString(form)":!e.postData?.params?.length&&e.postData?.text&&m(e.postData.mimeType)===p.MULTIPART?"body":e.postData?"HttpRequest.BodyPublishers.ofString(payload)":["POST","PUT","PATCH"].includes(e.method.toUpperCase())?'HttpRequest.BodyPublishers.ofString("some body text")':""}function T(e,n){const r={indent:"  ",withWrapper:!0,...n},t=new g({indentation:r.indent,variablesPrefix:r.variablesPrefix,capitalize:!0,lang:v.JAVA}),a=e.oAuth2PreRequests?.[0],u=Object.keys(e.queryObj??{}).length>0,l=m(e.postData?.mimeType);r.withComments&&(t.push("/**"),t.push(" * Requires JDK >= 11"),a&&(t.push(" *"),t.push(' * Requires package "org.json" >= 20201115'),t.push(" * See here for installation details:"),t.push(" *  https://search.maven.org/artifact/org.json/json")),t.push(" */"),t.blank()),r.withImports&&(t.push("import java.net.*;"),t.push("import java.net.http.*;"),t.push("import java.util.*;"),(l===p.URL_ENCODED&&e.postData?.params||a||u)&&(t.push("import java.nio.charset.StandardCharsets;"),t.push("import java.util.stream.Collectors;")),a&&t.push("import org.json.JSONObject;"),!e.postData?.params?.length&&e.postData?.text&&l===p.MULTIPART&&t.push("import java.nio.file.Path;"),t.blank()),r.withWrapper&&(t.push("public class App {"),t.push(1,"public static void main(String[] args) throws Exception {"),t.push(2,"var httpClient = HttpClient.newBuilder().build();"),t.blank());const i={...e.allHeaders??e.headersObj};if(a){const s=T(R(a),{...r,withImports:!1,withWrapper:!1,withComments:!1,variablesPrefix:"oauth2"});t.push(s),t.blank(),t.push(2,"var oauth2Response = httpClient.send(oauth2Request, HttpResponse.BodyHandlers.ofString());"),a.flowType==="deviceAuthorization"?j(t,{tokenUrl:a.tokenUrl??"YOUR_TOKEN_URL",clientId:a.clientId??"YOUR_CLIENT_ID",level:2}):(t.push(2,'var accessToken = new JSONObject(oauth2Response.body()).getString("access_token");'),t.blank()),i.Authorization='"Bearer " + accessToken'}if(e.postData)switch(l){case p.URL_ENCODED:if(e.postData.params?.length){t.push(2,"HashMap<String, String> params = new HashMap<>();");for(const s of e.postData.params)t.push(2,'params.put("%s", "%s");',s.name,s.value??"");t.blank(),t.push(2,"var form = params.keySet().stream()"),t.push(3,'.map(key -> key + "=" + URLEncoder.encode(params.get(key), StandardCharsets.UTF_8))'),t.push(3,'.collect(Collectors.joining("&"));'),t.blank()}else e.postData.text&&(t.push(2,'var form = "%s";',e.postData.text),t.blank());break;case p.JSON:e.jsonObj&&(t.push(2,`var payload = String.join("\\n"
+      ${k(JSON.stringify(e.jsonObj,null,1).replace(/"/g,'\\"').replace(/^/gm,', "').replace(/$/gm,'"'),{level:3,indent:r.indent,firstLine:!1})}`),t.push(2,");"),t.blank());break;case p.XML:if(e.postData.text){t.push(2,'var payload = String.join("\\n"');for(const s of e.postData.text.trim().split(`
+`)){const o=s.replace(/"/g,'\\"');t.push(3,`"${o}", `)}t.push(2,");"),t.blank()}break;case p.OCTET_STREAM:e.postData.text&&(t.push(2,'var payload = "%s";',e.postData.text),t.blank());break;case p.MULTIPART:if(e.postData.params&&e.postData.params.length>0){t.push(2,"var multipartBody = MultipartBodyPublisher.newBuilder();");for(const s of e.postData.params)s.fileName?t.push(2,'multipartBody.append("%s", Path.of("%s"));',s.name,s.fileName):t.push(2,'multipartBody.append("%s", "%s");',s.name,s.value??"");t.push(2,"var body = multipartBody.build();"),t.blank()}else e.postData.text&&(t.push(2,'var payload = "%s";',e.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"')),t.blank());break}if(u){t.push(2,"HashMap<String, String> params = new HashMap<>();");for(const[s,o]of Object.entries(e.queryObj))t.push(2,'params.put("%s", "%s");',s,Array.isArray(o)?o.join(","):o);t.blank(),t.push(2,"var query = params.keySet().stream()"),t.push(3,'.map(key -> key + "=" + URLEncoder.encode(params.get(key), StandardCharsets.UTF_8))'),t.push(3,'.collect(Collectors.joining("&"));'),t.blank()}const{protocol:c,host:d,pathname:f}=C(e.fullUrl??"");t.push(2,`var ${t.var("host")} = "%s";`,c+"//"+d),S(e,t,2);const b=f.replace(/\{/g,"%7B").replace(/\}/g,"%7D"),y={...e,pathname:b};t.push(2,`var ${t.var("pathname")} = %s;`,D(y,t)),t.push(2,`var ${t.var("request")} = HttpRequest.newBuilder()`),e.method.toUpperCase()==="PATCH"?t.push(3,'.method("PATCH", %s)',h(e)):t.push(3,".%s(%s)",e.method.toUpperCase(),h(e)),t.push(3,`.uri(URI.create(${t.var("host")} + ${t.var("pathname")} %s))`,u?"+ '?' + query":"");for(const s of Object.keys(i)){const o=s==="Authorization"&&a;t.push(3,'.header("%s", %s)',s,o?i[s]:`"${i[s]}"`)}if(e.basicAuth){const{username:s,password:o}=e.basicAuth;t.push(3,`.header("Authorization", "Basic " + Base64.getEncoder().encodeToString(("${s}:${o}").getBytes()))`)}return t.push(3,".build();"),r.withWrapper&&(t.blank(),t.push(2,"var response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());"),t.blank(),t.push(2,"System.out.println(response.body());"),t.push(1,"}"),t.push("}")),t.join()}export{T as generateJava};

package/lib/services/code-samples/generators/java8.d.ts

@@ -0,0 +1,9 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type Java8Options = GeneratorOptions & {
+    indent?: string;
+    withWrapper?: boolean;
+    variablesPrefix?: string;
+};
+export declare function generateJava8(har: CodeSampleHAR, options?: Java8Options): string;
+export {};

package/lib/services/code-samples/generators/java8.js

@@ -0,0 +1,2 @@
+import{CodeBuilder as j,Lang as w}from"./helpers/code-builder.js";import{buildUrlExpression as A,printUrlVariablesDeclarations as k}from"./helpers/url-helpers.js";import{buildJava8DeviceAuthorizationCodeSnippet as v}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as D}from"./helpers/mime.js";import{MediaTypes as r}from"../../../constants/openapi.js";import{toCodeSampleHAR as N}from"./helpers/sub-request.js";function C(e){return e.charAt(0).toUpperCase()+e.slice(1)}function g(e){return"Http"+C(e.toLowerCase())}function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)&&Object.keys(e).length===0}function b(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function S(e){return typeof e=="string"}function c(e){return S(e)?JSON.stringify(e):e==null?"JSONObject.NULL":String(e)}function q(e,E){const p={indent:"  ",withWrapper:!0,...E},t=new j({indentation:p.indent,variablesPrefix:p.variablesPrefix,capitalize:!0,lang:w.JAVA8}),l=g(e.method),a=e.oAuth2PreRequests?.[0],m=D(e.postData?.mimeType);p.withComments&&(t.push("/**"),t.push(" * Requires JDK >= 8"),t.push(" *"),t.push(" * Requires Apache HttpComponents Client >= 4.3.5"),t.push(" * See here for installation details:"),t.push(" *   https://search.maven.org/artifact/org.apache.httpcomponents/httpcomponents-client"),t.push(" *"),t.push(' * Requires package "junit4"'),t.push(" * See here for installation details:"),t.push(" *   https://junit.org/junit4"),t.push(" *"),t.push(' * Requires package "org.json" >= 20180130'),t.push(" * See here for installation details:"),t.push(" *   https://search.maven.org/artifact/org.json/json"),t.push(" */"),t.blank()),p.withImports&&(t.push("import org.apache.http.util.EntityUtils;"),t.push("import org.apache.http.NameValuePair;"),t.push("import org.apache.http.client.HttpClient;"),t.push("import org.apache.http.client.entity.UrlEncodedFormEntity;"),e.method&&t.push(`import org.apache.http.client.methods.${l};`),a&&a.method.toLowerCase()!==e.method.toLowerCase()&&t.push(`import org.apache.http.client.methods.${g(a.method)};`),t.push("import org.apache.http.impl.client.HttpClientBuilder;"),t.push("import org.apache.http.message.BasicNameValuePair;"),t.push("import org.apache.http.entity.StringEntity;"),t.push("import org.json.JSONObject;"),t.push("import org.json.JSONArray;"),t.push("import java.util.ArrayList;"),t.push("import java.util.List;"),t.push("import org.apache.http.entity.mime.MultipartEntity;"),t.push("import org.apache.http.entity.mime.content.StringBody;"),!e.postData?.params?.length&&e.postData?.text&&m===r.MULTIPART&&(t.push("import org.apache.http.entity.mime.content.FileBody;"),t.push("import java.io.File;")),e.basicAuth&&t.push("import java.util.Base64;"),t.blank()),p.withWrapper&&(t.push("public class App {"),t.push(1,"public static void main(String[] args ) throws java.io.IOException {"),t.push(2,"HttpClient httpClient = HttpClientBuilder.create().build();"),t.blank());const f={...e.allHeaders??e.headersObj};if(a){const s=q(N(a),{...p,withImports:!1,withWrapper:!1,withComments:!1,variablesPrefix:"oauth2"});t.push(s),t.push(2,"JSONObject %s = new JSONObject(EntityUtils.toString(httpClient.execute(%s).getEntity()));","oauth2Response","oauth2Request"),a.flowType==="deviceAuthorization"?v(t,{tokenUrl:a.tokenUrl??"YOUR_TOKEN_URL",clientId:a.clientId??"YOUR_CLIENT_ID",level:2}):(t.push(2,'String accessToken = %s.getString("access_token");',"oauth2Response"),t.blank())}k(e,t,2);const O=A(e,t);t.push(2,`%s ${t.var("request")} = new %s(%s);`,l,l,O);const y=Object.keys(f);if(y.length&&!(e.postData&&e.postData.mimeType===r.MULTIPART))for(const s of y){const i=s.toLowerCase()==="authorization";t.push(2,'%s.setHeader("%s", %s);',t.var("request"),s,a&&i?'"Bearer " + accessToken':`"${f[s]}"`)}if(e.basicAuth){const{username:s,password:i}=e.basicAuth;t.push(2,`String encodedString = Base64.getEncoder().encodeToString("${s}:${i}".getBytes());`),t.push(2,'%s.setHeader("%s", "%s"+encodedString);',t.var("request"),"Authorization","Basic ")}const h=(s,i)=>{const n=Array.isArray(s)?s.map((u,o)=>[String(o),u]):Object.entries(s);for(const[u,o]of n)o!==null&&typeof o=="object"?(t.push(i,'.put("%s", new JSONObject()',u),h(o,i+1),t.push(i,")")):t.push(i,'.put("%s", %s)',u,c(o))};if(e.postData)switch(m){case r.URL_ENCODED:if(e.postData.params?.length){t.blank(),t.push(2,"List<NameValuePair> params = new ArrayList<NameValuePair>();");for(const s of e.postData.params)t.push(2,'params.add(new BasicNameValuePair("%s", "%s"));',s.name,s.value??"");t.push(2,"%s.setEntity(new UrlEncodedFormEntity(params));",t.var("request")),t.blank()}else e.postData.text&&(t.blank(),t.push(2,'%s.setEntity(new StringEntity("%s"));',t.var("request"),e.postData.text),t.blank());break;case r.MULTIPART:if(e.postData.params&&e.postData.params.length>0){t.push(2,"MultipartEntity reqEntity = new MultipartEntity();");for(const s of e.postData.params)s.fileName?t.push(2,'reqEntity.addPart("%s", new FileBody(new File("%s")));',s.name,s.fileName):t.push(2,'reqEntity.addPart("%s", %s);',s.name,S(s.value)?`new StringBody("${s.value}")`:s.value);t.push(2,"%s.setEntity(reqEntity);",t.var("request"))}else e.postData.text&&t.push(2,'%s.setEntity(new StringEntity("%s"));',t.var("request"),e.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"'));break;case r.JSON:if(e.jsonObj){t.push(2,"JSONObject payload = new JSONObject();");for(const[s,i]of Object.entries(e.jsonObj))if(Array.isArray(i)){t.push(2,'payload.put("%s", new JSONArray()',s);for(const n of i)b(n)?(t.push(3,".put(new JSONObject()"),h(n,4),t.push(3,")")):t.push(3,".put(%s)",c(n));t.push(2,");")}else b(i)?(t.push(2,'payload.put("%s", new JSONObject()%s',s,d(i)?");":""),h(i,3),d(i)||t.push(2,");")):t.push(2,'payload.put("%s", %s);',s,c(i));t.push(2,"%s.setEntity(new StringEntity(payload.toString()));",t.var("request"))}break;case r.XML:if(e.postData.text){t.push(2,'String payload = String.join("\\n"');for(const s of e.postData.text.trim().split(`
+`)){const i=s.replace(/"/g,'\\"');t.push(3,`"${i}", `)}t.push(2,");"),t.push(2,"%s.setEntity(new StringEntity(payload));",t.var("request"))}break;case r.OCTET_STREAM:e.postData.text&&t.push(2,'%s.setEntity(new StringEntity("%s"));',t.var("request"),e.postData.text);break}return p.withWrapper&&(t.push(2,`String ${t.var("response")} = EntityUtils.toString(httpClient.execute(request).getEntity());`),t.blank(),t.push(2,"System.out.println(response);"),t.push(1,"}"),t.push("}")),t.join()}export{q as generateJava8};

package/lib/services/code-samples/generators/javascript.d.ts

@@ -0,0 +1,9 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type JavaScriptOptions = GeneratorOptions & {
+    indent?: string;
+    variablesPrefix?: string;
+    credentials?: 'omit' | 'same-origin' | 'include' | null;
+};
+export declare function generateJavaScript(har: CodeSampleHAR, options?: JavaScriptOptions): string;
+export {};

package/lib/services/code-samples/generators/javascript.js

@@ -0,0 +1 @@
+import{CodeBuilder as O,Lang as $}from"./helpers/code-builder.js";import{addIndentation as l,buildUrlExpression as S,printUrlVariablesDeclarations as g}from"./helpers/url-helpers.js";import{buildJSDeviceAuthorizationCodeSnippet as D}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as m}from"./helpers/mime.js";import{escapeSingleQuoted as h}from"./helpers/string-utils.js";import{MediaTypes as n}from"../../../constants/openapi.js";import{stringifyJSObject as p,getPreserveTransformer as j}from"./helpers/stringify-js.js";import{toCodeSampleHAR as A}from"./helpers/sub-request.js";function C(t,b){const a={indent:"  ",credentials:null,...b},i=a.indent,e=new O({indentation:i,variablesPrefix:a.variablesPrefix,capitalize:!0,lang:$.JAVASCRIPT});a.withComments&&(e.push("/**"),e.push(" * Requires ES8-compatible browser: https://caniuse.com/async-functions"),e.push(" */"),e.blank());const s={method:t.method.toUpperCase()};Object.keys(t.headersObj).length&&(s.headers={...t.headersObj});let c=!1;const o=t.oAuth2PreRequests?.[0];if(o){const r=C(A(o),{...a,withImports:!1,withComments:!1,variablesPrefix:"oAuth2"});e.push(r),e.blank(),o.flowType==="deviceAuthorization"&&D(e,{tokenUrl:o.tokenUrl??"YOUR_TOKEN_URL",clientId:o.clientId??"YOUR_CLIENT_ID",level:0}),s.headers=s.headers||{},s.headers.Authorization="'Bearer ' + accessToken",c=!0}a.credentials!==null&&a.credentials!==void 0&&(s.credentials=a.credentials);const u=Object.keys(t.queryObj??{}).length>0;u&&e.push(`const ${e.var("query")} = new URLSearchParams(${p(t.queryObj,{indent:i,inlineCharacterLimit:25})}).toString();`).blank();const d=m(t.postData?.mimeType);if(t.postData)switch(d){case n.URL_ENCODED:t.paramsObj?(e.push(`const ${e.var("formData")} = ${l(p(t.paramsObj,{indent:i,inlineCharacterLimit:25}),{level:0,firstLine:!1})};`).blank(),s.body=`new URLSearchParams(${e.var("formData")}).toString()`):s.body=`"${t.postData.text??""}"`;break;case n.JSON:t.jsonObj&&(s.body=`JSON.stringify(${l(p(t.jsonObj,{indent:i,inlineCharacterLimit:25}),{level:1,firstLine:!1})})`);break;case n.MULTIPART:if(e.push(`const ${e.var("form")} = new FormData();`),s.headers&&delete s.headers["Content-Type"],t.postData.params&&t.postData.params.length>0)for(const r of t.postData.params)e.push(`${e.var("form")}.append(%s, %s);`,JSON.stringify(r.name),JSON.stringify(r.value||r.fileName||""));else t.postData.text&&e.push(`${e.var("form")}.append('data', %s);`,JSON.stringify(t.postData.text));s.body=e.var("form"),e.blank();break;default:t.postData.text&&(s.body=`\`${l(t.postData.text,{level:2,indent:i,firstLine:!1}).trim()}\``)}const f=s.headers?.Accept&&m(s.headers.Accept)===n.JSON||d===n.JSON;if(t.basicAuth){const{username:r,password:y}=t.basicAuth;s.headers=s.headers||{},s.headers.Authorization=`'Basic ' + btoa('${h(r)}:${h(y)}')`,c=!0}g(t,e);const v=S(t,e);return e.push(`const ${e.var("resp")} = await fetch(`).push(1,"`"+v+(u?"?${"+e.var("query")+"}":"")+"`,").push(l(p(s,{indent:i,inlineCharacterLimit:25,transform:j({body:!0,authorizationHeader:c})}),{level:1,indent:i})).push(");").blank(),t.allResponseCodes?.includes("204")||t.responseCodes?.includes("204")?e.push("if (resp.status === 204) {").push(1,"console.log('success');").push("} else {").push(1,`const ${e.var("data")} = await ${e.var("resp")}.${f?"json()":"text()"};`).push(1,`console.log(${e.var("data")});`).push("}"):e.push(`const ${e.var("data")} = await ${e.var("resp")}.${f?"json()":"text()"};`).push(`console.log(${e.var("data")});`),e.join()}export{C as generateJavaScript};

package/lib/services/code-samples/generators/node.d.ts

@@ -0,0 +1,10 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type NodeOptions = GeneratorOptions & {
+    indent?: string;
+    variablesPrefix?: string;
+    showBoilerplate?: boolean;
+    level?: number;
+};
+export declare function generateNode(har: CodeSampleHAR, options?: NodeOptions): string;
+export {};

package/lib/services/code-samples/generators/node.js

@@ -0,0 +1 @@
+import{CodeBuilder as w,Lang as k}from"./helpers/code-builder.js";import{addIndentation as p,buildUrlExpression as y,printUrlVariablesDeclarations as S}from"./helpers/url-helpers.js";import{buildJSDeviceAuthorizationCodeSnippet as j}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as $}from"./helpers/mime.js";import{MediaTypes as l}from"../../../constants/openapi.js";import{stringifyJSObject as m,getPreserveTransformer as D}from"./helpers/stringify-js.js";import{toCodeSampleHAR as g}from"./helpers/sub-request.js";function R(t,v){const r={indent:"  ",showBoilerplate:!0,level:1,...v},i=r.indent,s=r.level;let c=!1;const e=new w({indentation:i,variablesPrefix:r.variablesPrefix,capitalize:!0,lang:k.NODEJS});r.withComments&&(e.push("/**"),e.push(" * Requires Node.js >= 14"),e.push(" *"),e.push(' * Requires module "node-fetch" >= 2.6.1'),e.push(" * See here for installation details:"),e.push(" *   https://www.npmjs.com/package/node-fetch"),e.push(" */"),e.blank()),r.withImports&&(e.push("import fetch from 'node-fetch';"),e.blank()),r.showBoilerplate&&e.push("async function run() {");const a={method:t.method.toUpperCase()};Object.keys(t.headersObj).length&&(a.headers={...t.headersObj});let u=!1;const n=t.oAuth2PreRequests?.[0];if(n){const o=R(g(n),{...r,withImports:!1,withComments:!1,variablesPrefix:"oAuth2",showBoilerplate:!1,level:1});e.push(o),e.blank(),n.flowType==="deviceAuthorization"&&j(e,{tokenUrl:n.tokenUrl??"YOUR_TOKEN_URL",clientId:n.clientId??"YOUR_CLIENT_ID",level:s}),a.headers=a.headers||{},a.headers.Authorization="'Bearer ' + accessToken",u=!0}const d=Object.keys(t.queryObj??{}).length>0;d&&e.push(s,`const ${e.var("query")} = new URLSearchParams(${p(m(t.queryObj,{indent:i,inlineCharacterLimit:25}),{level:s,indent:i,firstLine:!1})}).toString();`).blank();const h=$(t.postData?.mimeType);if(t.postData)switch(h){case l.URL_ENCODED:a.body=t.paramsObj?`new URLSearchParams(${e.var("formData")}).toString()`:`"${t.postData.text??""}"`,t.paramsObj&&e.push(s,`const ${e.var("formData")} = ${p(m(t.paramsObj,{indent:i,inlineCharacterLimit:25}),{level:s,firstLine:!1})};`).blank();break;case l.JSON:t.jsonObj&&(a.body=`JSON.stringify(${p(m(t.jsonObj,{indent:i,inlineCharacterLimit:25}),{level:s,firstLine:!1})})`);break;case l.MULTIPART:if(a.headers&&delete a.headers["Content-Type"],r.withImports&&e.unshift("import FormData from 'form-data';"),e.push(s,`const ${e.var("form")} = new FormData();`),t.postData.params&&t.postData.params.length>0)for(const o of t.postData.params){if(!o.fileName&&!o.contentType){e.push(s,`${e.var("form")}.append('${o.name}', '${o.value??""}');`);continue}o.fileName&&(c=!0,e.blank(),e.push(s,`${e.var("form")}.append('${o.name}', fs.createReadStream('${o.fileName}'));`))}else t.postData.text&&e.push(s,`${e.var("form")}.append('data', ${JSON.stringify(t.postData.text)});`);a.body=e.var("form"),e.blank();break;default:t.postData.text&&(a.body=`\`${p(t.postData.text,{level:s+1,indent:i,firstLine:!1}).trim()}\``)}if(t.cookies.length){const o=t.cookies.map(f=>`${encodeURIComponent(f.name)}=${encodeURIComponent(f.value)}`).join("; ");a.headers=a.headers||{},a.headers.cookie=o}if(t.basicAuth){const{username:o,password:f}=t.basicAuth;a.headers=a.headers||{},a.headers.Authorization=`'Basic ' + Buffer.from('${o}:${f}').toString('base64')`,u=!0}c&&r.withImports&&e.unshift("import fs from 'fs';");const b=a.headers?.Accept&&$(a.headers.Accept)===l.JSON||h===l.JSON;S(t,e,s);const O=y(t,e);return e.push(s,`const ${e.var("resp")} = await fetch(`).push(s+1,"`"+O+(d?"?${"+e.var("query")+"}":"")+"`,").push(s+1,p(m(a,{indent:i,inlineCharacterLimit:25,transform:D({body:!0,authorizationHeader:u})}),{level:s+1,indent:i,firstLine:!1})).push(s,");").blank(),t.allResponseCodes?.includes("204")||t.responseCodes?.includes("204")?e.push(s,"if (resp.status === 204) {").push(s+1,"console.log('success');").push(s,"} else {").push(s+1,`const ${e.var("data")} = await ${e.var("resp")}.${b?"json()":"text()"};`).push(s+1,`console.log(${e.var("data")});`).push(s,"}"):e.push(s,`const ${e.var("data")} = await ${e.var("resp")}.${b?"json()":"text()"};`).push(s,`console.log(${e.var("data")});`),r.showBoilerplate&&e.push("}").blank().push("run();"),e.join().replace(/"fs\.createReadStream\(\\"(.+)\\"\)"/,'fs.createReadStream("$1")')}export{R as generateNode};

package/lib/services/code-samples/generators/php.d.ts

@@ -0,0 +1,13 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type PHPOptions = GeneratorOptions & {
+    indent?: string;
+    showBoilerplate?: boolean;
+    noTags?: boolean;
+    shortTags?: boolean;
+    closingTag?: boolean;
+    namedErrors?: boolean;
+    variablesPrefix?: string;
+};
+export declare function generatePHP(har: CodeSampleHAR, options?: PHPOptions): string;
+export {};

package/lib/services/code-samples/generators/php.js

@@ -0,0 +1,6 @@
+import{CodeBuilder as O,Lang as g}from"./helpers/code-builder.js";import{buildUrlExpression as D,printUrlVariablesDeclarations as L}from"./helpers/url-helpers.js";import{buildPHPDeviceAuthorizationCodeSnippet as x}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as A}from"./helpers/mime.js";import{MediaTypes as P}from"../../../constants/openapi.js";import{objectToPhpArray as v}from"./helpers/php-array.js";import{pascalCase as E}from"./helpers/string-utils.js";import{toCodeSampleHAR as j}from"./helpers/sub-request.js";function $(e,...n){let a=0;return e.replace(/%s/g,()=>a<n.length?String(n[a++]):"%s")}function h(e,n){return n?`$${n}${E(e)}`:`$${e}`}function z(e){const n=e.match(/^[a-z][a-z0-9+.-]*:\/\/[^/:]+:(\d+)/i);return n?n[1]:void 0}function N(e,n){const a={showBoilerplate:!0,indent:"  ",noTags:!0,shortTags:!1,namedErrors:!1,closingTag:!1,...n};let r,c=!1;const s=new O({indentation:a.indent,capitalize:!0,lang:g.PHP}),i=e.oAuth2PreRequests?.[0],l=h("curl",a.variablesPrefix),R=h("response",a.variablesPrefix),d=h("error",a.variablesPrefix);a.noTags||s.push(a.shortTags?"<?":"<?php").blank();const _={...e.headersObj};let b;if(i){const t="oAuth2",o=N(j(i),{...a,showBoilerplate:!1,variablesPrefix:t});s.push(o),s.blank(),i.flowType==="deviceAuthorization"&&x(s,{tokenUrl:i.tokenUrl??"YOUR_TOKEN_URL",clientId:i.clientId??"YOUR_CLIENT_ID",level:0}),b=`Bearer " . ${i.flowType==="deviceAuthorization"?"$accessToken":`${h("response",t)}->access_token`}`}const T=Object.keys(_).sort().map(t=>t==="Authorization"&&b?$('"%s: %s',t,b):$('"%s: %s"',t,_[t]));if(e.basicAuth){const{username:t,password:o}=e.basicAuth;T.push(`"Authorization: Basic " . base64_encode("${t}:${o}")`)}a.showBoilerplate&&s.push("/**").push(" * Requires libcurl").push(" */").blank(),L(e,s);let p="";if(Object.keys(e.queryObj||{}).length){const t=v(e.queryObj,{indent:a.indent});p="$query",s.push(`${p} = ${t};`).blank()}if(s.push(`${l} = curl_init();`),s.blank(),e.postData)switch(A(e.postData.mimeType)){case P.JSON:{const t=v(e.jsonObj||{},{indent:a.indent});c=!0,r="json_encode($payload)",s.push(`$payload = ${t};`).blank();break}case P.MULTIPART:{if(e.postData.params&&e.postData.params.length>0){const t=e.postData.params.map(({name:o,value:m,fileName:y})=>y?`${a.indent}"${o}" => new CURLFile("${y}"),
+`:`${a.indent}"${o}" => "${m??""}",
+`).join("");c=!0,r="$payload",s.push(`$payload = array(
+${t});`).blank()}else e.postData.text&&(r=`"${e.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`);break}case P.URL_ENCODED:{const t=e.postData.params?.length?e.postData.params.map(({name:o,value:m})=>`${o}=${m}`).join("&"):`${e.postData.text??""}`;c=!0,r="$payload",s.push(`$payload = "${t}";`).blank();break}default:r=e.postData.text}let u=D(e,s);p&&(u.endsWith('"')?u=u.slice(0,-1)+`?" . http_build_query(${p})`:u+=` . "?" . http_build_query(${p})`);const k=z(e.fullUrl??""),C=[{escape:!c,name:"CURLOPT_POSTFIELDS",value:r},{escape:!0,name:"CURLOPT_PORT",value:k},{escape:!1,name:"CURLOPT_URL",value:u},{escape:!1,name:"CURLOPT_RETURNTRANSFER",value:"true"},{escape:!0,name:"CURLOPT_CUSTOMREQUEST",value:e.method.toUpperCase()}];s.push(`curl_setopt_array(${l}, [`);const f=new O({indentation:a.indent,lineJoin:`
+${a.indent}`,variablesPrefix:a.variablesPrefix,capitalize:!0,lang:g.PHP});T.length&&f.push("CURLOPT_HTTPHEADER => [").push(1,T.join(`,
+`+a.indent+a.indent)).push("],");for(const t of C)t.value===null||t.value===void 0||t.value===""||f.push($("%s => %s,",t.name,t.escape?JSON.stringify(t.value):t.value));const U=e.cookies.map(t=>`${encodeURIComponent(t.name)}=${encodeURIComponent(t.value)}`);return U.length&&f.push($('CURLOPT_COOKIE => "%s",',U.join("; "))),s.push(1,f.join()).push("]);").blank().push(`${R} = curl_exec(${l});`).push(`${d} = curl_error(${l});`).blank().push(`curl_close(${l});`).blank().push(`if (${d}) {`),a.namedErrors?s.push(1,`echo array_flip(get_defined_constants(true)["curl"])[${d}];`):s.push(1,`echo "cURL Error #:" . ${d};`),s.push("} else {").push(1,`echo ${R};`).push("}"),!a.noTags&&a.closingTag&&s.blank().push("?>"),s.join()}export{N as generatePHP};

package/lib/services/code-samples/generators/python.d.ts

@@ -0,0 +1,3 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+export declare function generatePython(har: CodeSampleHAR, options?: GeneratorOptions): string;

package/lib/services/code-samples/generators/python.js

@@ -0,0 +1,9 @@
+import{CodeBuilder as j,Lang as v}from"./helpers/code-builder.js";import{addIndentation as b,buildUrlExpression as D,printUrlVariablesDeclarations as R}from"./helpers/url-helpers.js";import{buildPythonDeviceAuthorizationCodeSnippet as T}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as g}from"./helpers/mime.js";import{escapeSingleQuoted as w}from"./helpers/string-utils.js";import{MediaTypes as f}from"../../../constants/openapi.js";import{toCodeSampleHAR as q}from"./helpers/sub-request.js";function A(t,i){const l=i?.level??0,e=new j({indentation:"  ",lang:v.PYTHON}),p=t.oAuth2PreRequests?.[0],y=p?.flowType==="deviceAuthorization";i?.withComments&&(e.push('"""'),e.push("Requires python >= 3"),e.blank(),e.push('Requires module "requests" >= 2.25.1'),e.push("See here for installation details:"),e.push("  https://requests.readthedocs.io/"),e.push('"""'),e.blank()),i?.withImports!==!1&&(e.push("import requests"),y&&e.push("import time"),e.blank());let L=!1,n={...t.allHeaders};if(p){const s=A(q(p),{...i,withImports:!1,withComments:!1});e.push(s),e.blank(),p.flowType==="deviceAuthorization"&&T(e,{tokenUrl:p.tokenUrl??"YOUR_TOKEN_URL",clientId:p.clientId??"YOUR_CLIENT_ID",level:l}),n={...n},n.Authorization='"Bearer " + access_token',L=!0}R(t,e),e.push(`${e.var("url").toLowerCase()} = %s`,D(t,e)).blank();let m;Object.keys(t.queryObj??{}).length&&(m="query = "+C(t.queryObj,"  "),e.push(m).blank());let u,d;const h=g(t.postData?.mimeType);if(t.postData)switch(h){case f.URL_ENCODED:u=t.paramsObj?b(C(t.paramsObj,"  "),{level:0,firstLine:!1}):`"${t.postData.text}"`;break;case f.JSON:t.jsonObj&&(u=b(C(t.jsonObj,"  "),{level:0,firstLine:!1}));break;case f.MULTIPART:{const s=[],a=[];if(t.postData.params&&t.postData.params.length>0)for(const o of t.postData.params)o.fileName?a.push(`"${o.name}": ("${o.fileName}", open("${o.fileName}", "rb"))`):s.push(`"${o.name}": "${o.value??""}"`);else if(t.postData.text){const o=t.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"');s.push(`"data": "${o}"`)}if(a.length){const o=a.map($=>`  ${$}`).join(`,
+`);e.push(`files = {
+${o}
+}`).blank()}s.length&&(d=`data = {
+${s.map($=>`  ${$}`).join(`,
+`)}
+}`),d&&e.push(d).blank();break}default:t.postData.text&&(u=`'''
+${b(t.postData.text.trim(),{level:1,indent:"  ",firstLine:!0})}
+'''`)}u&&e.push(`${e.var("payload").toLowerCase()} = %s`,u).blank();const c=Object.keys(n).length,_=(s,a)=>s==="Authorization"&&L?a:`"${a}"`;if(c===1)for(const s of Object.keys(n))e.push(`${e.var("headers").toLowerCase()} = {"${s}": ${_(s,n[s])}}`).blank();else if(c>1){let s=1;e.push(`${e.var("headers").toLowerCase()} = {`);for(const a of Object.keys(n)){const o=s++===c;e.push(1,`"${a}": ${_(a,n[a])}${o?"":","}`)}e.push(0,"}").blank()}const k=t.method.toLowerCase();let r=`${e.var("response").toLowerCase()} = requests.${k}(${e.var("url").toLowerCase()}`;if(h===f.MULTIPART&&(d&&(r+=", data=data"),e.join().includes("files = {")&&(r+=", files=files")),u){const s=h===f.JSON?"json":"data";r+=`, ${s}=${e.var("payload").toLowerCase()}`}return c>0&&(r+=`, headers=${e.var("headers").toLowerCase()}`),m&&(r+=`, params=${e.var("query").toLowerCase()}`),t.basicAuth&&(r+=`, auth=('${w(t.basicAuth.username)}','${w(t.basicAuth.password)}')`),r+=")",e.push(r).blank(),t.allResponseCodes?.includes("204")||t.responseCodes?.includes("204")?e.push("if response.status_code == 204:").push(l+1,'print("success")').push("else:").push(l+1,`${e.var("data").toLowerCase()} = ${e.var("response").toLowerCase()}.json()`).push(l+1,`print(${e.var("data").toLowerCase()})`):e.push(`${e.var("data").toLowerCase()} = ${e.var("response").toLowerCase()}.json()`).push(`print(${e.var("data").toLowerCase()})`),e.join()}function C(t,i){return JSON.stringify(t,function(l,e){return l&&typeof e=="boolean"?e?"__REDOCLY_<True>__":"__REDOCLY_<False>__":e===null?"__REDOCLY_<None>__":e},i).replace(/"__REDOCLY_<(\w+)>__"/g,"$1")}export{A as generatePython};

package/lib/services/code-samples/generators/r.d.ts

@@ -0,0 +1,10 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type ROptions = GeneratorOptions & {
+    indent?: string;
+    showBoilerplate?: boolean;
+    printBody?: boolean;
+    variablesPrefix?: string;
+};
+export declare function generateR(har: CodeSampleHAR, options?: ROptions): string;
+export {};

package/lib/services/code-samples/generators/r.js

@@ -0,0 +1,7 @@
+import{CodeBuilder as R,Lang as _}from"./helpers/code-builder.js";import{buildUrlExpression as T,printUrlVariablesDeclarations as j}from"./helpers/url-helpers.js";import{buildRDeviceAuthorizationCodeSnippet as A}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as U}from"./helpers/mime.js";import{MediaTypes as m}from"../../../constants/openapi.js";import{objectToRString as k,postDataToRListBody as C}from"./helpers/r-utils.js";import{toCodeSampleHAR as N}from"./helpers/sub-request.js";function O(t,y){const o={indent:"  ",showBoilerplate:!0,printBody:!0,...y},e=new R({indentation:o.indent,variablesPrefix:o.variablesPrefix,lang:_.R}),x=t.method.toUpperCase(),c=t.oAuth2PreRequests?.[0];o.showBoilerplate&&e.push("library(httr)").blank();const u={...t.allHeaders??t.headersObj};if(c){const p="oauth2_",s=O(N(c),{...o,variablesPrefix:p,showBoilerplate:!1}),n=`${p}data_req`;e.push(s),c.flowType==="deviceAuthorization"?A(e,{tokenUrl:c.tokenUrl??"YOUR_TOKEN_URL",clientId:c.clientId??"YOUR_CLIENT_ID",level:0,responseVariable:n}):(e.push(`access_token = content(${n}, "parsed")$access_token`),e.blank()),u.Authorization='paste("Bearer", access_token)'}let r,a="";if(t.postData)switch(U(t.postData.mimeType)){case m.URL_ENCODED:{if(a=e.var("body"),t.postData.params?.length){r="form";const s=C(t.postData.params,{indent:o.indent});e.push(`${a} <- list(${s})`).blank()}else t.postData.text&&(r="raw",e.push(`${a} <- "${t.postData.text}"`).blank());break}case m.JSON:{r="json",a=e.var("body");const s=k(t.jsonObj,{indent:o.indent});e.push(`${a} = '${s}'`).blank();break}case m.MULTIPART:{if(r="multipart",a=e.var("body"),t.postData.params?.length){const s=[];for(const i of t.postData.params)i.fileName?s.push(`${o.indent}${i.name} = upload_file("${i.fileName}")`):s.push(`${o.indent}${i.name} = "${i.value??""}"`);const n=`
+`+s.join(`,
+`)+`
+`;e.push(`${a} <- list(${n})`).blank()}else if(t.postData.text){const s=t.postData.text,n=s.match(/^--([^\r\n]+)/);if(n){const i=n[1],w=s.split(new RegExp(`--${i.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(?:--)?`,"g")).filter(l=>l.trim().length>0),d=[];for(const l of w){const f=l.match(/Content-Disposition:\s*form-data;\s*name="([^"]+)"(?:;\s*filename="([^"]+)")?/i);if(f){const h=f[1],D=f[2],g=l.match(/\r?\n\r?\n([\s\S]*?)(?:\r?\n)?$/),P=(g?g[1].trim():"").replace(/\\/g,"\\\\").replace(/"/g,'\\"');D?d.push(`${o.indent}${h} = upload_file("${D}")`):d.push(`${o.indent}${h} = "${P}"`)}}if(d.length>0){const l=`
+`+d.join(`,
+`)+`
+`;e.push(`${a} <- list(${l})`).blank()}else{r="raw";const l=t.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"');e.push(`${a} <- "${l}"`).blank()}}else{r="raw";const i=t.postData.text.replace(/\\/g,"\\\\").replace(/"/g,'\\"');e.push(`${a} <- "${i}"`).blank()}}break}default:t.postData.text&&(a=e.var("body"),r="raw",e.push(`${a} = ${k(t.postData.text)}`).blank())}j(t,e),Object.keys({...t.pathParameters,...t.serverVariables}).length&&e.blank().push("# create you own operator").push('"%&%" <- function(x, y)paste0(x,y)').blank();const v=T(t,e);e.push(`url = ${v}`).blank();const $=e.var("data_req");if(e.push(`${$} <- ${x}(`),e.push(1,"url,"),t.basicAuth){const{username:p,password:s}=t.basicAuth;e.push(1,`authenticate("${p}", "${s}")`)}const b=Object.keys(u);if(b.length){const p=b.map(s=>{const n=u[s],i=n.startsWith("paste")?n:`"${n}"`;return`"${s}" = ${i}`}).join(", ");p&&e.push(1,`add_headers(${p}),`)}return a&&(e.push(1,`body = ${a},`),e.push(1,`encode = "${r}",`)),e.push(1,"verbose()"),e.push(")"),o.printBody&&e.blank().push(`content(${$}${r==="raw"?', "text"':""})`),e.join()}export{O as generateR};

package/lib/services/code-samples/generators/ruby.d.ts

@@ -0,0 +1,10 @@
+import type { CodeSampleHAR } from '../sample-har.js';
+import type { GeneratorOptions } from './types.js';
+type RubyOptions = GeneratorOptions & {
+    indent?: string;
+    capitalize?: boolean;
+    showBoilerplate?: boolean;
+    variablesPrefix?: string;
+};
+export declare function generateRuby(har: CodeSampleHAR, options?: RubyOptions): string;
+export {};

package/lib/services/code-samples/generators/ruby.js

@@ -0,0 +1 @@
+import{CodeBuilder as h,Lang as v}from"./helpers/code-builder.js";import{buildUrlExpression as T,printUrlVariablesDeclarations as O}from"./helpers/url-helpers.js";import{buildRubyDeviceAuthorizationCodeSnippet as D}from"./helpers/oauth2-snippets.js";import{normalizeMimeType as d}from"./helpers/mime.js";import{escapeSingleQuoted as b}from"./helpers/string-utils.js";import{MediaTypes as i}from"../../../constants/openapi.js";import{stringifyJSObject as l}from"./helpers/stringify-js.js";import{toCodeSampleHAR as y}from"./helpers/sub-request.js";const $=1,_=new Set(["GET","POST","HEAD","DELETE","PATCH","PUT","OPTIONS","COPY","LOCK","UNLOCK","MOVE","TRACE"]);function q(t){if(t.jsonObj!==void 0)return t.jsonObj;if(t.postData?.text)try{return JSON.parse(t.postData.text)}catch{}return{}}function P(t){const p=(t??"").match(/^([a-z][a-z0-9+.-]*):/i);return p?`${p[1].toLowerCase()}:`:"http:"}function R(t,p){const r={capitalize:!0,showBoilerplate:!0,indent:"  ",...p},u=t.method.toUpperCase(),o=t.oAuth2PreRequests?.[0],c=P(t.fullUrl),e=new h({indentation:r.indent,variablesPrefix:r.variablesPrefix,capitalize:r.capitalize,lang:v.RUBY});r.showBoilerplate&&(e.push("require 'uri'").push("require 'net/http'"),c==="https:"&&e.push("require 'openssl'"),(d(t.postData?.mimeType)===i.JSON||o)&&e.unshift("require 'json'"),e.blank());const n={};for(const[s,a]of Object.entries(t.allHeaders??t.headersObj??{}))n[s]=`'${a}'`;const f=u.charAt(0)+u.substring(1).toLowerCase();if(_.has(u)||e.push("class Net::HTTP::%s < Net::HTTPRequest",f).push("  METHOD = '%s'",u).push("  REQUEST_HAS_BODY = '%s'",t.postData?.text?"true":"false").push("  RESPONSE_HAS_BODY = true").push("end").blank(),o){const s="oAuth2",a=R(y(o),{...r,variablesPrefix:s,showBoilerplate:!1}),m=`${s}${r.capitalize?"Response":"response"}`;e.push(a),o.flowType==="deviceAuthorization"?D(e,{tokenUrl:o.tokenUrl??"YOUR_TOKEN_URL",clientId:o.clientId??"YOUR_CLIENT_ID",level:0,responseVariable:m,capitalize:r.capitalize}):(e.push(`access_token = JSON.parse(${m}.body)['access_token']`),e.blank()),n.Authorization='"Bearer " + access_token'}O(t,e),e.push(`${e.var("url")} = URI(${T(t,e)})`),Object.keys(t.queryObj??{}).length>0&&(e.push(`${e.var("params")} = ${l(t.queryObj,{indent:r.indent,inlineCharacterLimit:25})}`),e.push(`${e.var("url")}.query = URI.encode_www_form(${e.var("params")})`)),e.blank().push(`${e.var("http")} = Net::HTTP.new(${e.var("url")}.host, ${e.var("url")}.port)`),c==="https:"&&e.push(`${e.var("http")}.use_ssl = true`),e.blank().push(`${e.var("request")} = Net::HTTP::%s.new(${e.var("url")})`,f);for(const s of Object.keys(n))n[s]!==`'${i.MULTIPART}'`&&e.push(`${e.var("request")}['%s'] = %s`,s,n[s]);if(t.postData)switch(d(t.postData.mimeType)){case i.URL_ENCODED:{if(t.postData.params?.length){const s={};for(const a of t.postData.params)s[a.name]=a.value??"";e.push(`${e.var("request")}.body = URI.encode_www_form(${l(s,{indent:r.indent,inlineCharacterLimit:25})})`)}else t.postData.text&&e.push(`${e.var("request")}.body = "${t.postData.text}"`);break}case i.JSON:e.push(`${e.var("request")}.body = ${l(q(t),{indent:r.indent,inlineCharacterLimit:25}).replace(/null/g,"nil")}.to_json`);break;case i.MULTIPART:{let s=!1;if(t.postData.params&&t.postData.params.length>0){e.push(`${e.var("form_data")} = [`);for(const a of t.postData.params)a.fileName?e.push($,`['${a.name}', File.open('${a.fileName}', 'rb')],`):e.push($,`['${a.name}', '${a.value??""}'],`);e.push("]"),s=!0}else if(t.postData.text){const a=t.postData.text.replace(/\\/g,"\\\\").replace(/'/g,"\\'");e.push(`${e.var("request")}.body = '${a}'`);break}s&&e.push(`${e.var("request")}.set_form(${e.var("form_data")}, '${i.MULTIPART}')`);break}default:t.postData.text&&e.push(`${e.var("request")}.body = ${JSON.stringify(t.postData.text)}`)}if(t.basicAuth){const{username:s,password:a}=t.basicAuth;e.push(`${e.var("request")}.basic_auth('${b(s)}', '${b(a)}')`)}return e.blank().push(`${e.var("response")} = ${e.var("http")}.request(${e.var("request")})`).push(`puts ${e.var("response")}.read_body`).blank(),e.join()}export{R as generateRuby};

package/lib/services/code-samples/generators/types.d.ts

@@ -0,0 +1,6 @@
+export type GeneratorOptions = {
+    withImports?: boolean;
+    withComments?: boolean;
+    short?: boolean;
+    level?: number;
+};

package/lib/services/code-samples/har.d.ts

@@ -0,0 +1,45 @@
+export interface Request {
+    method: string;
+    url: string;
+    httpVersion: string;
+    cookies: Cookie[];
+    headers: Header[];
+    queryString: QueryString[];
+    postData?: PostData;
+    headersSize: number;
+    bodySize: number;
+    comment?: string;
+}
+export interface Cookie {
+    name: string;
+    value: string;
+    path?: string;
+    domain?: string;
+    expires?: string | Date | null;
+    httpOnly?: boolean;
+    secure?: boolean;
+    comment?: string;
+}
+export interface Header {
+    name: string;
+    value: string;
+    comment?: string;
+}
+export interface QueryString {
+    name: string;
+    value: string;
+    comment?: string;
+}
+export interface PostData {
+    mimeType: string;
+    params: Param[];
+    text: string;
+    comment?: string;
+}
+export interface Param {
+    name: string;
+    value?: string;
+    fileName?: string;
+    contentType?: string;
+    comment?: string;
+}

package/lib/services/code-samples/index.d.ts

@@ -0,0 +1,8 @@
+export type * from './source.js';
+export { buildCodeSampleHAR, type HARBuildOptions, type HARBuildResolvers, type HARBuildSelections, } from './builder.js';
+export { createCodeSampleResolvers } from './resolvers.js';
+export { useCodeSampleResolvers } from './use-resolvers.js';
+export { generateCodeSample, tryGenerateCodeSample, isSupportedLanguage, type CodeSampleResult, } from './generators/index.js';
+export { mapReplayAtomValuesToHarRequestValues } from './utils/map-request-values.js';
+export { convertSampleToString } from './convertSampleToString.js';
+export * from './replay/index.js';

package/lib/services/code-samples/index.js

@@ -0,0 +1 @@
+import{buildCodeSampleHAR as r}from"./builder.js";import{createCodeSampleResolvers as a}from"./resolvers.js";import{useCodeSampleResolvers as m}from"./use-resolvers.js";import{generateCodeSample as s,tryGenerateCodeSample as S,isSupportedLanguage as d}from"./generators/index.js";import{mapReplayAtomValuesToHarRequestValues as u}from"./utils/map-request-values.js";import{convertSampleToString as n}from"./convertSampleToString.js";export*from"./replay/index.js";export{r as buildCodeSampleHAR,n as convertSampleToString,a as createCodeSampleResolvers,s as generateCodeSample,d as isSupportedLanguage,u as mapReplayAtomValuesToHarRequestValues,S as tryGenerateCodeSample,m as useCodeSampleResolvers};

package/lib/services/code-samples/replay/embedded-replay-converter.d.ts

@@ -0,0 +1,6 @@
+import type { ReplayNormalizedOpenAPIOperation } from './replay-types.js';
+import type { ApiDocsOptions } from '../../../types/options.js';
+import type { ExampleEntry } from '../../../types/store.js';
+import type { CodeSampleSource } from '../source.js';
+import type { HARBuildResolvers } from '../builder.js';
+export declare function createEmbeddedReplayConvertOperation(operationSourceMap: Map<string, CodeSampleSource>, resolvers: HARBuildResolvers, options: ApiDocsOptions, exampleStore: Record<string, ExampleEntry>, requestValues: Record<string, unknown>, activeMimeName?: string): (path: string, method: string) => ReplayNormalizedOpenAPIOperation | undefined;

package/lib/services/code-samples/replay/embedded-replay-converter.js

@@ -0,0 +1 @@
+import{registerExample as u}from"../../../adapters/helpers.js";import{appendUndeclaredConfigureParameters as b,mergeConfigureIntoSourceForReplay as g,pickRuntimeConfigureRequestValues as h}from"./merge-configure-into-source.js";import{toReplayOperation as k}from"./replay-adapter.js";function B(e){const o={};return e.path&&typeof e.path=="object"&&(o.path=e.path),e.query&&typeof e.query=="object"&&(o.query=e.query),e.header&&typeof e.header=="object"&&(o.headers=e.header),e.cookie&&typeof e.cookie=="object"&&(o.cookie=e.cookie),o}function R(e,o,t,y){if(o===void 0||!e.requestBody||Object.keys(e.requestBody).length===0)return e;const n=t&&e.requestBody[t]?t:Object.keys(e.requestBody)[0],i=e.requestBody[n];if(!i)return e;const p=u(y,{value:o,summary:void 0});return{...e,requestBody:{...e.requestBody,[n]:{...i,exampleIds:[p]}}}}function x(e,o,t,y,n,i){const p=B(n),c=n.body,f=h(t,p);return(m,a)=>{try{const r=e.get(`${a.toLowerCase()}:${m}`);if(!r)return;let d=f?g(r,f):r;return f&&(d=b(d,f)),c!==void 0&&(d=R(d,c,i,y)),k(d,o)}catch(r){console.error("[Replay] embedded convertOperationToReplayValue error:",r);return}}}export{x as createEmbeddedReplayConvertOperation};

package/lib/services/code-samples/replay/from-openapi-document.d.ts

@@ -0,0 +1,12 @@
+import type { OperationInfo } from '../../../types/openapi.js';
+import type { ApiDocsOptions } from '../../../types/options.js';
+import type { StoreContext } from '../../../types/store.js';
+import type { CodeSampleSource } from '../source.js';
+import type { OpenAPIDefinition } from '../../../types/openapi.js';
+/** Hook to apply adapter-time `configure()` results to a fallback-built `OperationInfo`. */
+export type ApplyConfigureToOperationInfo = (operationInfo: OperationInfo, storeCtx: StoreContext, doc: OpenAPIDefinition) => void;
+/**
+ * Build a {@link CodeSampleSource} from a raw OpenAPI document for a given path/method.
+ * Fallback path used by the Replay overlay when the prebuilt source map misses.
+ */
+export declare function buildCodeSampleSourceFromDocument(pathName: string, method: string, doc: OpenAPIDefinition, options: ApiDocsOptions, applyConfigure?: ApplyConfigureToOperationInfo): CodeSampleSource | undefined;

package/lib/services/code-samples/replay/from-openapi-document.js

@@ -0,0 +1 @@
+import{createStoreContext as S,toRecord as b}from"../../../adapters/helpers.js";import{populateOpenApiStore as O}from"../../../adapters/openapi/store.js";import{buildCodeSampleSource as $}from"../../../adapters/openapi/build-code-sample-source.js";function q(e,t){if(!e.length&&!t?.length||!e.length)return t;if(!t?.length)return e;const r=new Set(t.map(a=>{const n=a;return`${n.in}:${n.name}`})),u=[...t];for(const a of e){const n=a,o=`${n.in}:${n.name}`;r.has(o)||u.push(a)}return u}let m=null;function v(e,t){if(m?.doc===e)return m.ctx;const r=S(b(e));return O(e,r,t),m={doc:e,ctx:r},r}function K(e,t,r,u,a){const n=r.paths;if(!n||typeof n!="object")return;const o=n[e];if(!o||typeof o!="object")return;const c=t.toLowerCase(),d=o;let p=c,s=d[c],f=!1;if(!s&&c==="query"&&d["x-query"]&&(s=d["x-query"],p="x-query"),!s&&c!=="query"&&o.additionalOperations){const l=o.additionalOperations,y=t in l?t:Object.keys(l).find(C=>C.toLowerCase()===c);y&&(s=l[y],p=y,f=!0)}if(!s||typeof s!="object")return;const i=s,x=o.parameters??[],h={pointer:f?`/paths/${e}/additionalOperations/${p}`:`/paths/${e}/${p}`,pathName:e,httpVerb:t.toUpperCase(),operationId:i.operationId,summary:typeof i.summary=="string"?i.summary:void 0,isWebhook:!1,isAdditionalOperation:f,tags:[],parameters:q(x,i.parameters),requestBody:i.requestBody,servers:i.servers??o.servers,security:i.security},g=v(r,u);return a?.(h,g,r),$(h,g,u,u.ignoreNamedSchemas)}export{K as buildCodeSampleSourceFromDocument};