@readme/httpsnippet 7.1.1 → 8.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022 ReadMe (https://readme.com)
+Copyright (c) 2023 ReadMe (https://readme.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -39,7 +39,7 @@ Type: `object`
 
 Available options:
 
-* `harIsAlreadyEncoded` (`boolean`): In the event of you supplying a `source` HAR that already contains escaped data (query and cookie parameters)strings, this allows you to disable automatic encoding of those parameters to prevent them from being double-escaped.
+- `harIsAlreadyEncoded` (`boolean`): In the event of you supplying a `source` HAR that already contains escaped data (query and cookie parameters)strings, this allows you to disable automatic encoding of those parameters to prevent them from being double-escaped.
 
 ### convert(target [, options])
 
@@ -64,11 +64,11 @@ const snippet = new HTTPSnippet({
 });
 
 // generate Node.js: Native output
-console.log(snippet.convert('node'));
+console.log(await snippet.convert('node'));
 
 // generate Node.js: Native output, indent with tabs
 console.log(
-  snippet.convert('node', {
+  await snippet.convert('node', {
     indent: '\t',
   }),
 );
@@ -104,13 +104,13 @@ const snippet = new HTTPSnippet({
 
 // generate Shell: cURL output
 console.log(
-  snippet.convert('shell', 'curl', {
+  await snippet.convert('shell', 'curl', {
     indent: '\t',
   }),
 );
 
 // generate Node.js: Unirest output
-console.log(snippet.convert('node', 'unirest'));
+console.log(await snippet.convert('node', 'unirest'));
 ```
 
 ### addTarget(target)
@@ -155,32 +155,31 @@ For detailed information on each target, please review the [wiki](https://github
 
 There are some major differences between this library and the [httpsnippet](https://github.com/Kong/httpsnippet) upstream:
 
-* Includes a full integration test suite for a handful of clients and targets.
-* Does not ship with a CLI component.
-* Does not do any HAR schema validation. It's just assumed that the HAR you're supplying to the library is already valid.
-* The main `HTTPSnippet` export contains an `options` argument for an `harIsAlreadyEncoded` option for disabling [escaping](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) of cookies and query strings in URLs.
-  * We added this because all HARs that we interact with already have this data escaped and this option prevents them from being double encoded, thus corrupting the data.
-* Does not support the `insecureSkipVerify` option on `go:native`, `node:native`, `ruby:native`, and `shell:curl` as we don't want snippets generated for our users to bypass SSL certificate verification.
-* Node
-  * `fetch`
-    * Body payloads are treated as an object literal and wrapped within `JSON.stringify()`. We do this to keep those targets looking nicer with those kinds of payloads. This also applies to the JS `fetch` target as well.
-  * `request`
-    * Does not provide query string parameters in a `params` argument due to complexities with query encoding.
-* PHP
-  * `guzzle`
-    * Snippets have `require_once('vendor/autoload.php');` prefixed at the top.
-* Python
-  * `python3`
-    * Does not ship this client due to its incompatibility with being able to support file uploads.
-  * `requests`
-    * Does not provide query string parameters in a `params` argument due to complexities with query encoding.
+- Includes a full integration test suite for a handful of clients and targets.
+- Does not ship with a CLI component.
+- Does not do any HAR schema validation. It's just assumed that the HAR you're supplying to the library is already valid.
+- The main `HTTPSnippet` export contains an `options` argument for an `harIsAlreadyEncoded` option for disabling [escaping](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) of cookies and query strings in URLs.
+  - We added this because all HARs that we interact with already have this data escaped and this option prevents them from being double encoded, thus corrupting the data.
+- Does not support the `insecureSkipVerify` option on `go:native`, `node:native`, `ruby:native`, and `shell:curl` as we don't want snippets generated for our users to bypass SSL certificate verification.
+- Node
+  - `fetch`
+    - Body payloads are treated as an object literal and wrapped within `JSON.stringify()`. We do this to keep those targets looking nicer with those kinds of payloads. This also applies to the JS `fetch` target as well.
+  - `request`
+    - Does not provide query string parameters in a `params` argument due to complexities with query encoding.
+- PHP
+  - `guzzle`
+    - Snippets have `require_once('vendor/autoload.php');` prefixed at the top.
+- Python
+  - `python3`
+    - Does not ship this client due to its incompatibility with being able to support file uploads.
+  - `requests`
+    - Does not provide query string parameters in a `params` argument due to complexities with query encoding.
 
 ## License
 
 [MIT](LICENSE) © [Kong](https://konghq.com)
 
 [license-url]: https://github.com/Kong/httpsnippet/blob/master/LICENSE
-
 [npm-url]: https://www.npmjs.com/package/@readme/httpsnippet
 [npm-license]: https://img.shields.io/npm/l/@readme/httpsnippet.svg?style=flat-square
 [npm-version]: https://img.shields.io/npm/v/@readme/httpsnippet.svg?style=flat-square

package/dist/{chunk-DTZD7L6R.mjs → chunk-IAWYVBVW.js}

@@ -1,4 +1,4 @@
-import { CodeBuilder } from './chunk-UEOS42PC.mjs';
+import { CodeBuilder } from './chunk-Y7NI4MMY.js';
 import stringifyObject9 from 'stringify-object';
 
 // src/helpers/escape.ts
@@ -41,7 +41,8 @@ var libcurl = {
     key: "libcurl",
     title: "Libcurl",
     link: "http://curl.haxx.se/libcurl",
-    description: "Simple REST and HTTP API Client for C"
+    description: "Simple REST and HTTP API Client for C",
+    extname: ".c"
   },
   convert: ({ method, fullUrl, headersObj, allHeaders, postData }) => {
     const { push, blank, join } = new CodeBuilder();
@@ -78,7 +79,6 @@ var c = {
   info: {
     key: "c",
     title: "C",
-    extname: ".c",
     default: "libcurl",
     cli: "c"
   },
@@ -177,7 +177,8 @@ var clj_http = {
     key: "clj_http",
     title: "clj-http",
     link: "https://github.com/dakrone/clj-http",
-    description: "An idiomatic clojure http client wrapping the apache client."
+    description: "An idiomatic clojure http client wrapping the apache client.",
+    extname: ".clj"
   },
   convert: ({ queryObj, method, postData, url, allHeaders }, options) => {
     const { push, join } = new CodeBuilder({ indent: options?.indent });
@@ -270,7 +271,6 @@ var clojure = {
   info: {
     key: "clojure",
     title: "Clojure",
-    extname: ".clj",
     default: "clj_http"
   },
   clientsById: {
@@ -310,7 +310,8 @@ var httpclient = {
     key: "httpclient",
     title: "HttpClient",
     link: "https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient",
-    description: ".NET Standard HTTP Client"
+    description: ".NET Standard HTTP Client",
+    extname: ".cs"
   },
   convert: ({ allHeaders, postData, method, fullUrl }, options) => {
     const opts = {
@@ -429,7 +430,8 @@ var restsharp = {
     key: "restsharp",
     title: "RestSharp",
     link: "http://restsharp.org/",
-    description: "Simple REST and HTTP API Client for .NET"
+    description: "Simple REST and HTTP API Client for .NET",
+    extname: ".cs"
   },
   convert: ({ method, fullUrl, headersObj, cookies, postData, uriObj }) => {
     const { push, join } = new CodeBuilder();
@@ -502,7 +504,6 @@ var csharp = {
   info: {
     key: "csharp",
     title: "C#",
-    extname: ".cs",
     default: "restsharp",
     cli: "dotnet"
   },
@@ -518,7 +519,8 @@ var native = {
     key: "native",
     title: "NewRequest",
     link: "http://golang.org/pkg/net/http/#NewRequest",
-    description: "Golang HTTP client request"
+    description: "Golang HTTP client request",
+    extname: ".go"
   },
   convert: ({ postData, method, allHeaders, fullUrl }, options = {}) => {
     const { blank, push, join } = new CodeBuilder({ indent: "	" });
@@ -606,7 +608,6 @@ var go = {
   info: {
     key: "go",
     title: "Go",
-    extname: ".go",
     default: "native",
     cli: "go"
   },
@@ -622,7 +623,8 @@ var http11 = {
     key: "http1.1",
     title: "HTTP/1.1",
     link: "https://tools.ietf.org/html/rfc7230",
-    description: "HTTP/1.1 request string in accordance with RFC 7230"
+    description: "HTTP/1.1 request string in accordance with RFC 7230",
+    extname: null
   },
   convert: ({ method, fullUrl, uriObj, httpVersion, allHeaders, postData }, options) => {
     const opts = {
@@ -658,8 +660,7 @@ var http = {
   info: {
     key: "http",
     title: "HTTP",
-    extname: null,
-    default: "1.1"
+    default: "http1.1"
   },
   clientsById: {
     "http1.1": http11
@@ -672,7 +673,8 @@ var asynchttp = {
     key: "asynchttp",
     title: "AsyncHttp",
     link: "https://github.com/AsyncHttpClient/async-http-client",
-    description: "Asynchronous Http and WebSocket Client library for Java"
+    description: "Asynchronous Http and WebSocket Client library for Java",
+    extname: ".java"
   },
   convert: ({ method, allHeaders, postData, fullUrl }, options) => {
     const opts = {
@@ -704,7 +706,8 @@ var nethttp = {
     key: "nethttp",
     title: "java.net.http",
     link: "https://openjdk.java.net/groups/net/httpclient/intro.html",
-    description: "Java Standardized HTTP Client API"
+    description: "Java Standardized HTTP Client API",
+    extname: ".java"
   },
   convert: ({ allHeaders, fullUrl, method, postData }, options) => {
     const opts = {
@@ -740,7 +743,8 @@ var okhttp = {
     key: "okhttp",
     title: "OkHttp",
     link: "http://square.github.io/okhttp/",
-    description: "An HTTP Request Client Library"
+    description: "An HTTP Request Client Library",
+    extname: ".java"
   },
   convert: ({ postData, method, fullUrl, allHeaders }, options) => {
     const opts = {
@@ -793,7 +797,8 @@ var unirest = {
     key: "unirest",
     title: "Unirest",
     link: "http://unirest.io/java.html",
-    description: "Lightweight HTTP Request Client Library"
+    description: "Lightweight HTTP Request Client Library",
+    extname: ".java"
   },
   convert: ({ method, allHeaders, postData, fullUrl }, options) => {
     const opts = {
@@ -823,7 +828,6 @@ var java = {
   info: {
     key: "java",
     title: "Java",
-    extname: ".java",
     default: "unirest"
   },
   clientsById: {
@@ -838,7 +842,8 @@ var axios = {
     key: "axios",
     title: "Axios",
     link: "https://github.com/axios/axios",
-    description: "Promise based HTTP client for the browser and node.js"
+    description: "Promise based HTTP client for the browser and node.js",
+    extname: ".js"
   },
   convert: ({ allHeaders, method, url, queryObj, postData }, options) => {
     const opts = {
@@ -913,7 +918,8 @@ var fetch = {
     key: "fetch",
     title: "fetch",
     link: "https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch",
-    description: "Perform asynchronous HTTP requests with the Fetch API"
+    description: "Perform asynchronous HTTP requests with the Fetch API",
+    extname: ".js"
   },
   convert: ({ method, allHeaders, postData, fullUrl }, inputOpts) => {
     const opts = {
@@ -998,7 +1004,8 @@ var jquery = {
     key: "jquery",
     title: "jQuery",
     link: "http://api.jquery.com/jquery.ajax/",
-    description: "Perform an asynchronous HTTP (Ajax) requests with jQuery"
+    description: "Perform an asynchronous HTTP (Ajax) requests with jQuery",
+    extname: ".js"
   },
   convert: ({ fullUrl, method, allHeaders, postData }, options) => {
     const opts = {
@@ -1062,7 +1069,8 @@ var xhr = {
     key: "xhr",
     title: "XMLHttpRequest",
     link: "https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest",
-    description: "W3C Standard API that provides scripted client functionality"
+    description: "W3C Standard API that provides scripted client functionality",
+    extname: ".js"
   },
   convert: ({ postData, allHeaders, method, fullUrl }, options) => {
     const opts = {
@@ -1128,7 +1136,6 @@ var javascript = {
   info: {
     key: "javascript",
     title: "JavaScript",
-    extname: ".js",
     default: "xhr"
   },
   clientsById: {
@@ -1145,7 +1152,8 @@ var native2 = {
     key: "native",
     title: "Native JSON",
     link: "https://www.json.org/json-en.html",
-    description: "A JSON represetation of any HAR payload."
+    description: "A JSON represetation of any HAR payload.",
+    extname: ".json"
   },
   convert: ({ postData }, inputOpts) => {
     const opts = {
@@ -1189,7 +1197,6 @@ var json = {
   info: {
     key: "json",
     title: "JSON",
-    extname: ".json",
     default: "native"
   },
   clientsById: {
@@ -1203,7 +1210,8 @@ var okhttp2 = {
     key: "okhttp",
     title: "OkHttp",
     link: "http://square.github.io/okhttp/",
-    description: "An HTTP Request Client Library"
+    description: "An HTTP Request Client Library",
+    extname: ".kt"
   },
   convert: ({ postData, fullUrl, method, allHeaders }, options) => {
     const opts = {
@@ -1255,7 +1263,6 @@ var kotlin = {
   info: {
     key: "kotlin",
     title: "Kotlin",
-    extname: ".kt",
     default: "okhttp"
   },
   clientsById: {
@@ -1267,7 +1274,8 @@ var axios2 = {
     key: "axios",
     title: "Axios",
     link: "https://github.com/axios/axios",
-    description: "Promise based HTTP client for the browser and node.js"
+    description: "Promise based HTTP client for the browser and node.js",
+    extname: ".cjs"
   },
   convert: ({ method, fullUrl, allHeaders, postData }, options) => {
     const opts = {
@@ -1328,7 +1336,8 @@ var fetch2 = {
     key: "fetch",
     title: "Fetch",
     link: "https://github.com/bitinn/node-fetch",
-    description: "Simplified HTTP node-fetch client"
+    description: "Simplified HTTP node-fetch client",
+    extname: ".cjs"
   },
   convert: ({ method, fullUrl, postData, headersObj, cookies }, options) => {
     const opts = {
@@ -1435,7 +1444,8 @@ var native3 = {
     key: "native",
     title: "HTTP",
     link: "http://nodejs.org/api/http.html#http_http_request_options_callback",
-    description: "Node.js native HTTP interface"
+    description: "Node.js native HTTP interface",
+    extname: ".cjs"
   },
   convert: ({ uriObj, method, allHeaders, postData }, options = {}) => {
     const { indent = "  " } = options;
@@ -1500,7 +1510,8 @@ var request = {
     key: "request",
     title: "Request",
     link: "https://github.com/request/request",
-    description: "Simplified HTTP request client"
+    description: "Simplified HTTP request client",
+    extname: ".cjs"
   },
   convert: ({ method, url, fullUrl, postData, headersObj, cookies }, options) => {
     const opts = {
@@ -1587,7 +1598,8 @@ var unirest2 = {
     key: "unirest",
     title: "Unirest",
     link: "http://unirest.io/nodejs.html",
-    description: "Lightweight HTTP Request Client Library"
+    description: "Lightweight HTTP Request Client Library",
+    extname: ".cjs"
   },
   convert: ({ method, url, cookies, queryObj, postData, headersObj }, options) => {
     const opts = {
@@ -1680,7 +1692,6 @@ var node = {
   info: {
     key: "node",
     title: "Node.js",
-    extname: ".js",
     default: "native",
     cli: "node %s"
   },
@@ -1732,7 +1743,8 @@ var nsurlsession = {
     key: "nsurlsession",
     title: "NSURLSession",
     link: "https://developer.apple.com/library/mac/documentation/Foundation/Reference/NSURLSession_class/index.html",
-    description: "Foundation's NSURLSession request"
+    description: "Foundation's NSURLSession request",
+    extname: ".m"
   },
   convert: ({ allHeaders, postData, method, fullUrl }, options) => {
     const opts = {
@@ -1849,7 +1861,6 @@ var objc = {
   info: {
     key: "objc",
     title: "Objective-C",
-    extname: ".m",
     default: "nsurlsession"
   },
   clientsById: {
@@ -1863,7 +1874,8 @@ var cohttp = {
     key: "cohttp",
     title: "CoHTTP",
     link: "https://github.com/mirage/ocaml-cohttp",
-    description: "Cohttp is a very lightweight HTTP server using Lwt or Async for OCaml"
+    description: "Cohttp is a very lightweight HTTP server using Lwt or Async for OCaml",
+    extname: ".ml"
   },
   convert: ({ fullUrl, allHeaders, postData, method }, options) => {
     const opts = {
@@ -1910,7 +1922,6 @@ var ocaml = {
   info: {
     key: "ocaml",
     title: "OCaml",
-    extname: ".ml",
     default: "cohttp"
   },
   clientsById: {
@@ -1992,7 +2003,8 @@ var curl = {
     key: "curl",
     title: "cURL",
     link: "http://php.net/manual/en/book.curl.php",
-    description: "PHP with ext-curl"
+    description: "PHP with ext-curl",
+    extname: ".php"
   },
   convert: ({ uriObj, postData, fullUrl, method, httpVersion, cookies, headersObj }, options = {}) => {
     const {
@@ -2108,7 +2120,8 @@ var guzzle = {
     key: "guzzle",
     title: "Guzzle",
     link: "http://docs.guzzlephp.org/en/stable/",
-    description: "PHP with Guzzle"
+    description: "PHP with Guzzle",
+    extname: ".php"
   },
   convert: ({ postData, fullUrl, method, cookies, headersObj }, options) => {
     const opts = {
@@ -2206,7 +2219,8 @@ var http1 = {
     key: "http1",
     title: "HTTP v1",
     link: "http://php.net/manual/en/book.http.php",
-    description: "PHP with pecl/http v1"
+    description: "PHP with pecl/http v1",
+    extname: ".php"
   },
   convert: ({ method, url, postData, queryObj, headersObj, cookiesObj }, options = {}) => {
     const { closingTag = false, indent = "  ", noTags = false, shortTags = false } = options;
@@ -2276,7 +2290,8 @@ var http2 = {
     key: "http2",
     title: "HTTP v2",
     link: "http://devel-m6w6.rhcloud.com/mdref/http",
-    description: "PHP with pecl/http v2"
+    description: "PHP with pecl/http v2",
+    extname: ".php"
   },
   convert: ({ postData, headersObj, method, queryObj, cookiesObj, url }, options = {}) => {
     const { closingTag = false, indent = "  ", noTags = false, shortTags = false } = options;
@@ -2381,7 +2396,6 @@ var php = {
   info: {
     key: "php",
     title: "PHP",
-    extname: ".php",
     default: "curl",
     cli: "php %s"
   },
@@ -2441,7 +2455,8 @@ var restmethod = {
     key: "restmethod",
     title: "Invoke-RestMethod",
     link: "https://docs.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Utility/Invoke-RestMethod",
-    description: "Powershell Invoke-RestMethod client"
+    description: "Powershell Invoke-RestMethod client",
+    extname: ".ps1"
   },
   convert: generatePowershellConvert("Invoke-RestMethod")
 };
@@ -2452,7 +2467,8 @@ var webrequest = {
     key: "webrequest",
     title: "Invoke-WebRequest",
     link: "https://docs.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Utility/Invoke-WebRequest",
-    description: "Powershell Invoke-WebRequest client"
+    description: "Powershell Invoke-WebRequest client",
+    extname: ".ps1"
   },
   convert: generatePowershellConvert("Invoke-WebRequest")
 };
@@ -2462,7 +2478,6 @@ var powershell = {
   info: {
     key: "powershell",
     title: "Powershell",
-    extname: ".ps1",
     default: "webrequest"
   },
   clientsById: {
@@ -2530,7 +2545,8 @@ var requests = {
     key: "requests",
     title: "Requests",
     link: "http://docs.python-requests.org/en/latest/api/#requests.request",
-    description: "Requests HTTP library"
+    description: "Requests HTTP library",
+    extname: ".py"
   },
   convert: ({ fullUrl, postData, allHeaders, method }, options) => {
     const opts = {
@@ -2657,7 +2673,6 @@ var python = {
   info: {
     key: "python",
     title: "Python",
-    extname: ".py",
     default: "requests",
     cli: "python3 %s"
   },
@@ -2672,7 +2687,8 @@ var httr = {
     key: "httr",
     title: "httr",
     link: "https://cran.r-project.org/web/packages/httr/vignettes/quickstart.html",
-    description: "httr: Tools for Working with URLs and HTTP"
+    description: "httr: Tools for Working with URLs and HTTP",
+    extname: ".r"
   },
   convert: ({ url, queryObj, queryString, postData, allHeaders, method }) => {
     const { push, blank, join } = new CodeBuilder();
@@ -2757,7 +2773,6 @@ var r = {
   info: {
     key: "r",
     title: "R",
-    extname: ".r",
     default: "httr"
   },
   clientsById: {
@@ -2771,7 +2786,8 @@ var native4 = {
     key: "native",
     title: "net::http",
     link: "http://ruby-doc.org/stdlib-2.2.1/libdoc/net/http/rdoc/Net/HTTP.html",
-    description: "Ruby HTTP client"
+    description: "Ruby HTTP client",
+    extname: ".rb"
   },
   convert: ({ uriObj, method: rawMethod, fullUrl, postData, allHeaders }) => {
     const { push, blank, join } = new CodeBuilder();
@@ -2831,7 +2847,6 @@ var ruby = {
   info: {
     key: "ruby",
     title: "Ruby",
-    extname: ".rb",
     default: "native"
   },
   clientsById: {
@@ -2877,7 +2892,8 @@ var curl2 = {
     key: "curl",
     title: "cURL",
     link: "http://curl.haxx.se/",
-    description: "cURL is a command line tool and library for transferring data with URL syntax"
+    description: "cURL is a command line tool and library for transferring data with URL syntax",
+    extname: ".sh"
   },
   convert: ({ fullUrl, method, httpVersion, headersObj, allHeaders, postData }, options = {}) => {
     const { indent = "  ", short = false, binary = false, globOff = false } = options;
@@ -2990,7 +3006,8 @@ var httpie = {
     key: "httpie",
     title: "HTTPie",
     link: "http://httpie.org/",
-    description: "a CLI, cURL-like tool for humans"
+    description: "a CLI, cURL-like tool for humans",
+    extname: ".sh"
   },
   convert: ({ allHeaders, postData, queryObj, fullUrl, method, url }, options) => {
     const opts = {
@@ -3085,7 +3102,8 @@ var wget = {
     key: "wget",
     title: "Wget",
     link: "https://www.gnu.org/software/wget/",
-    description: "a free software package for retrieving files using HTTP, HTTPS"
+    description: "a free software package for retrieving files using HTTP, HTTPS",
+    extname: ".sh"
   },
   convert: ({ method, postData, allHeaders, fullUrl }, options) => {
     const opts = {
@@ -3123,7 +3141,6 @@ var shell = {
   info: {
     key: "shell",
     title: "Shell",
-    extname: ".sh",
     default: "curl",
     cli: "%s"
   },
@@ -3194,7 +3211,8 @@ var nsurlsession2 = {
     key: "nsurlsession",
     title: "NSURLSession",
     link: "https://developer.apple.com/library/mac/documentation/Foundation/Reference/NSURLSession_class/index.html",
-    description: "Foundation's NSURLSession request"
+    description: "Foundation's NSURLSession request",
+    extname: ".swift"
   },
   convert: ({ allHeaders, postData, fullUrl, method }, options) => {
     const opts = {
@@ -3303,7 +3321,6 @@ var swift = {
   info: {
     key: "swift",
     title: "Swift",
-    extname: ".swift",
     default: "nsurlsession"
   },
   clientsById: {
@@ -3356,9 +3373,6 @@ var isTarget = (target) => {
   if (!target.info.title) {
     throw new Error("target title must be a non-zero-length string");
   }
-  if (!Object.prototype.hasOwnProperty.call(target.info, "extname")) {
-    throw new Error("targets must have an `info` object with the property `extname`");
-  }
   if (!Object.prototype.hasOwnProperty.call(target, "clientsById") || !target.clientsById || Object.keys(target.clientsById).length === 0) {
     throw new Error(
       `No clients provided in target ${target.info.key}.  You must provide the property \`clientsById\` containg your clients.`
@@ -3403,6 +3417,9 @@ var isClient = (client) => {
   if (!Object.prototype.hasOwnProperty.call(client.info, "link")) {
     throw new Error("targets client must have an `info` object with property `link`");
   }
+  if (!Object.prototype.hasOwnProperty.call(client.info, "extname")) {
+    throw new Error("targets client must have an `info` object with the property `extname`");
+  }
   if (!Object.prototype.hasOwnProperty.call(client, "convert") || typeof client.convert !== "function") {
     throw new Error("targets client must have a `convert` property containing a conversion function");
   }
@@ -3423,4 +3440,4 @@ var addTargetClient = (targetId, client) => {
 
 export { addTarget, addTargetClient, getHeaderName, isClient, isTarget, targets };
 //# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-DTZD7L6R.mjs.map
+//# sourceMappingURL=chunk-IAWYVBVW.js.map