@zuplo/cli 7.9.17 → 7.9.19

package/node_modules/@zuplo/runtime/out/esm/mocks/index.js

@@ -22,5 +22,5 @@
  *  DEALINGS IN THE SOFTWARE.
  *--------------------------------------------------------------------------------------------*/
     
-import{E as p,J as c,M as u}from"../chunk-UJ56MYSD.js";import"../chunk-VTO3F6DK.js";import{a as d}from"../chunk-QGAJTUPE.js";import"../chunk-A3QGJZO7.js";import"../chunk-YJ2BHVUH.js";import{aa as i}from"../chunk-PBDT4FDO.js";import{a as o}from"../chunk-TYV53J3B.js";function w(l={request:new Request("https://api.example.com")}){let e=[];function t(s){e.push(Promise.resolve(s))}return o(t,"waitUntil"),{context:new a({event:{waitUntil:t},route:l.route,originalRequest:l.request}),invokeResponse:o(async()=>{await Promise.all(e)},"invokeResponse")}}o(w,"createMockContext");var g={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:o(()=>({}),"raw")},a=class extends EventTarget{static{o(this,"MockZuploContext")}#e;#t;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:t=g,parentContext:n,originalRequest:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:i.console.info,log:i.console.log,debug:i.console.debug,warn:i.console.warn,error:i.console.error,setLogProperties:o(()=>{},"setLogProperties")},this.custom={},this.route=t,this.incomingRequestProperties={ip:"203.0.113.7",asn:1234,asOrganization:"ORGANIZATION",city:"Seattle",region:"Washington",regionCode:"WA",colo:"SEA",continent:"NA",country:"US",postalCode:"98004",metroCode:"SEA",latitude:void 0,longitude:void 0,timezone:void 0,httpProtocol:void 0,clientCert:void 0,clientMtlsVerificationStatus:void 0,clientMtlsVerificationReason:void 0,clientCertFingerprintSha256:void 0,clientCertNotBefore:void 0,clientCertNotAfter:void 0,clientCertIssuerDn:void 0,clientCertSubjectDn:void 0},this.parentContext=n,this.#e=e,this.#t=r,this.analyticsContext=new c(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,t){throw new Error("Not implemented")}invokeOutboundPolicy(e,t,n){throw new Error("Not implemented")}invokeRoute(e,t){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addPreRequestHandler(e,t){let n;try{n=u.getContextExtensions(this)}catch{n=u.initialize(this,new d(this.#t??new Request("https://api.example.com")))}n.preRequestPhase??="active",p(this,n,e,t)}get preRequestHandlers(){let e;try{e=u.getContextExtensions(this)}catch{return[]}return(e.preRequestState?.entries??[]).map(t=>({policyName:t.policyName,name:t.name}))}addEventListener(e,t,n){let r=o(s=>{try{typeof t=="function"?t(s):t.handleEvent(s)}catch(m){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),m}},"wrapped");super.addEventListener(e,r,n)}};export{a as MockZuploContext,w as createMockContext};
+import{E as p,J as c,M as u}from"../chunk-6YPRGG62.js";import"../chunk-VTO3F6DK.js";import{a as d}from"../chunk-QGAJTUPE.js";import"../chunk-A3QGJZO7.js";import"../chunk-YJ2BHVUH.js";import{aa as i}from"../chunk-PBDT4FDO.js";import{a as o}from"../chunk-TYV53J3B.js";function w(l={request:new Request("https://api.example.com")}){let e=[];function t(s){e.push(Promise.resolve(s))}return o(t,"waitUntil"),{context:new a({event:{waitUntil:t},route:l.route,originalRequest:l.request}),invokeResponse:o(async()=>{await Promise.all(e)},"invokeResponse")}}o(w,"createMockContext");var g={path:"/",methods:["GET"],handler:{module:{},export:"default"},raw:o(()=>({}),"raw")},a=class extends EventTarget{static{o(this,"MockZuploContext")}#e;#t;contextId;requestId;log;route;custom;incomingRequestProperties;parentContext;analyticsContext;constructor({event:e,route:t=g,parentContext:n,originalRequest:r}){super(),this.requestId=crypto.randomUUID(),this.contextId=crypto.randomUUID(),this.log={info:i.console.info,log:i.console.log,debug:i.console.debug,warn:i.console.warn,error:i.console.error,setLogProperties:o(()=>{},"setLogProperties")},this.custom={},this.route=t,this.incomingRequestProperties={ip:"203.0.113.7",asn:1234,asOrganization:"ORGANIZATION",city:"Seattle",region:"Washington",regionCode:"WA",colo:"SEA",continent:"NA",country:"US",postalCode:"98004",metroCode:"SEA",latitude:void 0,longitude:void 0,timezone:void 0,httpProtocol:void 0,clientCert:void 0,clientMtlsVerificationStatus:void 0,clientMtlsVerificationReason:void 0,clientCertFingerprintSha256:void 0,clientCertNotBefore:void 0,clientCertNotAfter:void 0,clientCertIssuerDn:void 0,clientCertSubjectDn:void 0},this.parentContext=n,this.#e=e,this.#t=r,this.analyticsContext=new c(this.requestId)}waitUntil(e){this.#e.waitUntil(e)}invokeInboundPolicy(e,t){throw new Error("Not implemented")}invokeOutboundPolicy(e,t,n){throw new Error("Not implemented")}invokeRoute(e,t){throw new Error("Not implemented")}addResponseSendingHook(e){throw new Error("Not implemented")}addResponseSendingFinalHook(e){throw new Error("Not implemented")}addPreRequestHandler(e,t){let n;try{n=u.getContextExtensions(this)}catch{n=u.initialize(this,new d(this.#t??new Request("https://api.example.com")))}n.preRequestPhase??="active",p(this,n,e,t)}get preRequestHandlers(){let e;try{e=u.getContextExtensions(this)}catch{return[]}return(e.preRequestState?.entries??[]).map(t=>({policyName:t.policyName,name:t.name}))}addEventListener(e,t,n){let r=o(s=>{try{typeof t=="function"?t(s):t.handleEvent(s)}catch(m){throw this.log.error(`Error invoking event ${e}. See following logs for details.`),m}},"wrapped");super.addEventListener(e,r,n)}};export{a as MockZuploContext,w as createMockContext};
 //# sourceMappingURL=index.js.map

package/node_modules/@zuplo/runtime/out/types/index.d.ts

@@ -540,6 +540,61 @@ export declare const AIGatewayInternalOnlyInboundPolicy: typeof InternalOnlyInbo
 export declare type AIGatewayInternalOnlyInboundPolicyOptions =
   InternalOnlyInboundPolicyOptions;
 
+/**
+ * Spreads AI requests across a list of models. The policy cycles through the
+ * list, or keeps requests that share a key, such as a user or a conversation,
+ * on the same model. Most requests also get a retry model from the list. A
+ * request moves there when the chosen model stays rate limited. Chat
+ * completions and embeddings requests also move there when the model returns a
+ * server error, can't be reached, or times out.
+ *
+ * The policy picks the model for every request it handles and ignores the
+ * request's own `model`, so the list also limits which models clients can
+ * reach. An earlier policy's model selection is never overwritten.
+ *
+ * @title Model Load Balancing
+ * @product ai-gateway
+ * @requiresAI
+ * @param request - The ZuploRequest
+ * @param context - The ZuploContext
+ * @param options - The policy options set in policies.json
+ * @param policyName - The name of the policy as set in policies.json
+ * @returns The request with model routing stored in context, or a refusal
+ * @example
+ * ```json
+ * {
+ *   "strategy": "round-robin",
+ *   "models": {
+ *     "completions": [
+ *       "azure-eastus/gpt-5",
+ *       "azure-westus/gpt-5",
+ *       "openai/gpt-5"
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export declare class AIGatewayLoadBalancingInboundPolicy extends InboundPolicy<AIGatewayLoadBalancingInboundPolicyOptions> {
+  #private;
+  static readonly policyType = "ai-gateway-load-balancing";
+  handler(
+    request: ZuploRequest,
+    context: ZuploContext
+  ): Promise<ZuploRequest | Response>;
+}
+
+/**
+ * Options for spreading AI Gateway requests across a list of models.
+ * @public
+ */
+export declare interface AIGatewayLoadBalancingInboundPolicyOptions {
+  strategy?: Strategy;
+  stickyBy?: StickyBy;
+  expression?: Expression;
+  models: Models;
+  fallbackTimeoutSeconds?: FallbackTimeoutSeconds_2;
+}
+
 /* Excluded from this release type: AIGatewayMeterIncrements */
 
 /**
@@ -721,7 +776,7 @@ export { AIGatewayModelFilteringInboundPolicy as AIGatewayModelFilteringV2Inboun
  * @public
  */
 declare interface AIGatewayModelFilteringInboundPolicyOptions {
-  models: Models;
+  models: Models_2;
 }
 export { AIGatewayModelFilteringInboundPolicyOptions };
 export { AIGatewayModelFilteringInboundPolicyOptions as AIGatewayModelFilteringV2InboundPolicyOptions };
@@ -799,7 +854,7 @@ export declare class AIGatewayModelOverrideInboundPolicy extends InboundPolicy<A
  * @public
  */
 export declare interface AIGatewayModelOverrideInboundPolicyOptions {
-  models: Models_2;
+  models: Models_3;
 }
 
 /**
@@ -1608,13 +1663,13 @@ export declare interface AkamaiFirewallForAiOutboundPolicyOptions {
  * @minItems 1
  * @public
  */
-declare type AllowedModels = [ProviderAndModel, ...ProviderAndModel[]];
+declare type AllowedModels = [ProviderAndModel_2, ...ProviderAndModel_2[]];
 
 /**
  * @minItems 1
  * @public
  */
-declare type AllowedModels1 = [ProviderAndModel, ...ProviderAndModel[]];
+declare type AllowedModels1 = [ProviderAndModel_2, ...ProviderAndModel_2[]];
 
 /**
  * Amberflo is a usage metering and billing service. This policy allows
@@ -3203,13 +3258,13 @@ declare interface BatchDispatcherOptions {
  * @minItems 1
  * @public
  */
-declare type BlockedModels = [ProviderAndModel, ...ProviderAndModel[]];
+declare type BlockedModels = [ProviderAndModel_2, ...ProviderAndModel_2[]];
 
 /**
  * @minItems 1
  * @public
  */
-declare type BlockedModels1 = [ProviderAndModel, ...ProviderAndModel[]];
+declare type BlockedModels1 = [ProviderAndModel_2, ...ProviderAndModel_2[]];
 
 /**
  * The brownout policy allows performing scheduled downtime on your API
@@ -4179,11 +4234,20 @@ declare interface CompletionsFallbacks {
   quotaFallback?: QuotaFallbackModel;
 }
 
+/**
+ * Models for chat completions, Responses, Messages, and System One requests, as `providerName/model`. From 1 through 32 models, each listed once. Provider names aren't case-sensitive, so `openai/gpt-5` and `OpenAI/gpt-5` are the same model. Write each model ID exactly as your provider spells it.
+ *
+ * @minItems 1
+ * @maxItems 32
+ * @public
+ */
+declare type CompletionsModels = [ProviderAndModel, ...ProviderAndModel[]];
+
 /**
  * Rules for chat completions, Responses, and Anthropic Messages requests.
  * @public
  */
-declare type CompletionsModels =
+declare type CompletionsModels_2 =
   | {
       allowList: AllowedModels;
     }
@@ -5321,11 +5385,20 @@ declare interface EmbeddingsFallbacks {
   quotaFallback?: QuotaFallbackModel;
 }
 
+/**
+ * Models for embeddings requests, as `providerName/model`. From 1 through 32 models, each listed once. Provider names aren't case-sensitive. Write each model ID exactly as your provider spells it. Every entry must be the same embedding model, such as one model on several accounts.
+ *
+ * @minItems 1
+ * @maxItems 32
+ * @public
+ */
+declare type EmbeddingsModels = [ProviderAndModel, ...ProviderAndModel[]];
+
 /**
  * Rules for embedding requests.
  * @public
  */
-declare type EmbeddingsModels =
+declare type EmbeddingsModels_2 =
   | {
       allowList: AllowedModels1;
     }
@@ -5429,6 +5502,12 @@ declare type EventType = (typeof EventType)[keyof typeof EventType];
  */
 declare type Execution = "sequential" | "parallel";
 
+/**
+ * The value to key on, written like a {@link https://zuplo.com/docs/policies/ai-gateway-metering-inbound#budget-expressions|Metering budget expression}, such as `request.headers.get("x-end-user-id")`. Required when `stickyBy` is `expression`, and not allowed otherwise.
+ * @public
+ */
+declare type Expression = string;
+
 /**
  * Best-effort flatten of ALL human/assistant text in a request OR response body,
  * across every shape — the one sanctioned cross-shape helper. Intended for
@@ -5492,6 +5571,12 @@ declare interface FallbackModels {
  */
 declare type FallbackTimeoutSeconds = number;
 
+/**
+ * How long to wait for a model to start responding before retrying the request on another model. Applies to chat completions and embeddings. The timeout ends when the response starts, so it doesn't cut off a long streaming response. A response that doesn't stream starts only when it's complete, so the timeout covers the whole response. From 1 through 300.
+ * @public
+ */
+declare type FallbackTimeoutSeconds_2 = number;
+
 declare interface FetchOptions<T> {
   method?: HttpMethod_2;
   data?: T;
@@ -10681,7 +10766,7 @@ declare interface ModelConfiguration {
 }
 
 /**
- * Model filtering rules grouped by AI Gateway capability.
+ * The models to spread requests across, by request type. Set at least one list.
  * @public
  */
 declare interface Models {
@@ -10690,10 +10775,19 @@ declare interface Models {
 }
 
 /**
- * Override rules grouped by AI Gateway capability.
+ * Model filtering rules grouped by AI Gateway capability.
  * @public
  */
 declare interface Models_2 {
+  completions?: CompletionsModels_2;
+  embeddings?: EmbeddingsModels_2;
+}
+
+/**
+ * Override rules grouped by AI Gateway capability.
+ * @public
+ */
+declare interface Models_3 {
   completions?: CompletionsOverride;
   embeddings?: EmbeddingsOverride;
 }
@@ -12686,6 +12780,12 @@ export declare interface PropelAuthJwtInboundPolicyOptions {
  */
 declare type ProviderAndModel = string;
 
+/**
+ * A model reference in providerName/model form, split on the first slash.
+ * @public
+ */
+declare type ProviderAndModel_2 = string;
+
 /**
  * Extracts a query parameter and sets it as a header in the request.
  *
@@ -14445,6 +14545,18 @@ declare interface StartsWithRule {
   startsWith: string;
 }
 
+/**
+ * The key that `sticky` uses. `user` uses the authenticated caller, `request.user.sub`. `conversation` uses the conversation's system prompt and its first user message with text. `expression` uses the value that `expression` selects. Required when `strategy` is `sticky`, and not allowed with `round-robin`.
+ * @public
+ */
+declare type StickyBy = "user" | "conversation" | "expression";
+
+/**
+ * How the policy picks a model for each request. `round-robin` cycles through the list in order. `sticky` sends every request with the same key to the same model.
+ * @public
+ */
+declare type Strategy = "round-robin" | "sticky";
+
 /**
  * Configuration for accumulating and validating streaming responses.
  * @public

package/node_modules/@zuplo/runtime/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "7.9.17",
+  "version": "7.9.19",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {

package/node_modules/content-disposition/README.md

@@ -17,17 +17,17 @@ $ npm install content-disposition
 ## API
 
 ```js
-const contentDisposition = require('content-disposition')
+import { create, parse, format } from 'content-disposition';
 ```
 
-### contentDisposition(filename, options)
+### create(filename, options)
 
 Create an attachment `Content-Disposition` header value using the given file name,
 if supplied. The `filename` is optional and if no file name is desired, but you
 want to specify `options`, set `filename` to `undefined`.
 
 ```js
-res.setHeader('Content-Disposition', contentDisposition('∫ maths.pdf'))
+res.setHeader('Content-Disposition', create('∫ maths.pdf'));
 ```
 
 **note** HTTP headers are of the ISO-8859-1 character set. If you are writing this
@@ -40,73 +40,139 @@ the `'binary'` encoding in Node.js.
 
 ##### fallback
 
-If the `filename` option is outside ISO-8859-1, then the file name is actually
+If the `filename` option is outside US-ASCII, then the file name is actually
 stored in a supplemental field for clients that support Unicode file names and
-a ISO-8859-1 version of the file name is automatically generated.
+a US-ASCII version of the file name is automatically generated.
 
-This specifies the ISO-8859-1 file name to override the automatic generation or
+This specifies the US-ASCII file name to override the automatic generation or
 disables the generation all together, defaults to `true`.
 
-  - A string will specify the ISO-8859-1 file name to use in place of automatic
-    generation.
-  - `false` will disable including a ISO-8859-1 file name and only include the
-    Unicode version (unless the file name is already ISO-8859-1).
-  - `true` will enable automatic generation if the file name is outside ISO-8859-1.
+- A string will specify the US-ASCII file name to use in place of automatic
+  generation.
+- `false` will disable including a US-ASCII file name and only include the
+  Unicode version (unless the file name is already US-ASCII).
+- `true` will enable automatic generation if the file name is outside US-ASCII.
 
-If the `filename` option is ISO-8859-1 and this option is specified and has a
+If the `filename` option is US-ASCII and this option is specified and has a
 different value, then the `filename` option is encoded in the extended field
-and this set as the fallback field, even though they are both ISO-8859-1.
+and this set as the fallback field, even though they are both US-ASCII.
 
 ##### type
 
 Specifies the disposition type, defaults to `"attachment"`. This can also be
 `"inline"`, or any other value (all values except inline are treated like
 `attachment`, but can convey additional information if both parties agree to
-it). The type is normalized to lower-case.
+it).
 
-### contentDisposition.parse(string)
+### parse(string, options)
 
 ```js
-const disposition = contentDisposition.parse('attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt')
+const disposition = parse(
+  'attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt',
+);
 ```
 
 Parse a `Content-Disposition` header string. This automatically handles extended
 ("Unicode") parameters by decoding them and providing them under the standard
-parameter name. This will return an object with the following properties (examples
-are shown for the string `'attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt'`):
+parameter name. This will return an object with the following properties:
 
- - `type`: The disposition type (always lower case). Example: `'attachment'`
+- `type`: The disposition type (always lower case). Example: `'attachment'`
 
- - `parameters`: An object of the parameters in the disposition (name of parameter
-   always lower case and extended versions replace non-extended versions). Example:
-   `{filename: "€ rates.txt"}`
+- `parameters`: An object of the parameters in the disposition (name of parameter
+  always lower case and extended versions replace non-extended versions). Example:
+  `{filename: "€ rates.txt"}`
+
+#### Options
+
+##### multipart
+
+Parse parameters using browser `multipart/form-data` behavior.
+
+```js
+parse('form-data; name="file"; filename="the %22plans%22.pdf"', {
+  multipart: true,
+});
+```
+
+##### extended
+
+Parse RFC 5987 extended header parameters automatically when decoding
+parameters, defaults to `true`.
+
+### format(obj, options)
+
+```js
+const disposition = format({
+  type: 'attachment',
+  parameters: {
+    filename: '€ rates.txt',
+  },
+});
+```
+
+Formats an object to a `Content-Disposition` header string. This automatically
+handles extended ("Unicode") parameters and returns a string. Example:
+`'attachment; filename*=UTF-8''%E2%82%AC%20rates.txt'`
+
+#### Options
+
+##### multipart
+
+Format parameters using browser `multipart/form-data` behavior. This quotes
+parameter values, escapes `"` as `%22`, and writes Unicode values directly
+instead of using extended parameters.
+
+```js
+format(
+  {
+    type: 'form-data',
+    parameters: { name: 'file', filename: '€ rates.txt' },
+  },
+  { multipart: true },
+);
+```
+
+##### extended
+
+Encode Unicode parameter values using RFC 5987 extended header parameters,
+e.g. `filename*=`, defaults to `true`.
 
 ## Examples
 
 ### Send a file for download
 
 ```js
-const contentDisposition = require('content-disposition')
-const fs = require('fs')
-const http = require('http')
-const onFinished = require('on-finished')
+const contentDisposition = require('content-disposition');
+const fs = require('fs');
+const http = require('http');
+const onFinished = require('on-finished');
 
-const filePath = '/path/to/public/plans.pdf'
+const filePath = '/path/to/public/plans.pdf';
 
-http.createServer(function onRequest (req, res) {
+http.createServer(function onRequest(req, res) {
   // set headers
-  res.setHeader('Content-Type', 'application/pdf')
-  res.setHeader('Content-Disposition', contentDisposition(filePath))
+  res.setHeader('Content-Type', 'application/pdf');
+  res.setHeader('Content-Disposition', contentDisposition(filePath));
 
   // send file
-  const stream = fs.createReadStream(filePath)
-  stream.pipe(res)
+  const stream = fs.createReadStream(filePath);
+  stream.pipe(res);
   onFinished(res, function () {
-    stream.destroy()
-  })
-})
+    stream.destroy();
+  });
+});
 ```
 
+## Local demo
+
+Run the upload inspector locally:
+
+```sh
+npm run demo
+```
+
+Then open `http://127.0.0.1:3000` in your browser. The demo lets you upload files, inspect the multipart upload part headers sent by the browser, and compare them with the download `Content-Disposition` header generated by this package.
+
 ## Testing
 
 ```sh
@@ -118,11 +184,15 @@ $ npm test
 - [RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1][rfc-2616]
 - [RFC 5987: Character Set and Language Encoding for Hypertext Transfer Protocol (HTTP) Header Field Parameters][rfc-5987]
 - [RFC 6266: Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP)][rfc-6266]
+- [RFC 8187: Indicating Character Encoding and Language for HTTP Header Field Parameters][rfc-8187]
+- [HTML Living Standard: Multipart form data][html-form]
 - [Test Cases for HTTP Content-Disposition header field (RFC 6266) and the Encodings defined in RFCs 2047, 2231 and 5987][tc-2231]
 
 [rfc-2616]: https://datatracker.ietf.org/doc/html/rfc2616
 [rfc-5987]: https://datatracker.ietf.org/doc/html/rfc5987
 [rfc-6266]: https://datatracker.ietf.org/doc/html/rfc6266
+[rfc-8187]: https://datatracker.ietf.org/doc/html/rfc8187
+[html-form]: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#multipart-form-data
 [tc-2231]: http://greenbytes.de/tech/tc2231/
 
 ## License

package/node_modules/content-disposition/dist/index.d.ts

@@ -0,0 +1,72 @@
+/*!
+ * content-disposition
+ * Copyright(c) 2014-2017 Douglas Christopher Wilson
+ * MIT Licensed
+ */
+export interface ContentDisposition {
+    /**
+     * Content-Disposition type, such as "attachment" or "inline"
+     */
+    type: string;
+    /**
+     * Content-Disposition parameters, such as "filename"
+     */
+    parameters: Record<string, string>;
+}
+export interface CreateOptions {
+    /**
+     * Content-Disposition type, defaults to "attachment"
+     * @default "attachment"
+     */
+    type?: string;
+    /**
+     * Fallback filename for non-US-ASCII strings. If true, a fallback will be generated by replacing non-US-ASCII characters with "?". If false, no fallback will be generated.
+     * @default true
+     */
+    fallback?: string | boolean;
+}
+/**
+ * Create an attachment Content-Disposition header.
+ */
+export declare function create(filename?: string, options?: CreateOptions): string;
+export interface ParseOptions {
+    /**
+     * Whether to decode RFC 8187 encoded parameters.
+     * @default true
+     */
+    extended?: boolean;
+    /**
+     * Parse parameters as sent by browsers in `multipart/form-data`.
+     * @default false
+     */
+    multipart?: boolean;
+}
+/**
+ * Parse Content-Disposition header string.
+ */
+export declare function parse(header: string, options?: ParseOptions): ContentDisposition;
+/**
+ * Decode a RFC 8187 field value (gracefully).
+ */
+export declare function decodeExtended(str: string): string | undefined;
+export interface FormatOptions {
+    /**
+     * Whether to use extended parameter encoding for non-ISO-8859-1 strings.
+     * If false, an error will be thrown when formatting such strings.
+     * @default true
+     */
+    extended?: boolean;
+    /**
+     * Format parameters as sent by browsers in `multipart/form-data`.
+     * @default false
+     */
+    multipart?: boolean;
+}
+/**
+ * Format object to Content-Disposition header.
+ */
+export declare function format(obj: Partial<ContentDisposition>, options?: FormatOptions): string;
+/**
+ * Encode a Unicode string for HTTP (RFC 8187).
+ */
+export declare function encodeExtended(str: string): string;