@vercel/routing-utils 5.0.6 → 5.0.8

package/dist/schemas.js

@@ -162,6 +162,195 @@ const hasSchema = {
     ]
   }
 };
+const transformsSchema = {
+  description: "A list of transform rules to adjust the query parameters of a request or HTTP headers of request or response",
+  type: "array",
+  minItems: 1,
+  items: {
+    type: "object",
+    additionalProperties: false,
+    required: ["type", "op", "target"],
+    properties: {
+      type: {
+        description: "The scope of the transform to apply",
+        type: "string",
+        enum: ["request.headers", "request.query", "response.headers"]
+      },
+      op: {
+        description: "The operation to perform on the target",
+        type: "string",
+        enum: ["append", "set", "delete"]
+      },
+      target: {
+        description: "The target of the transform",
+        type: "object",
+        required: ["key"],
+        properties: {
+          // re is not supported for transforms. Once supported, replace target.key with matchableValueSchema
+          key: {
+            description: "A value to match against. Can be a string or a condition operation object (without regex support)",
+            anyOf: [
+              {
+                description: "A valid header name (letters, numbers, hyphens, underscores)",
+                type: "string",
+                maxLength: 4096
+              },
+              {
+                description: "A condition operation object",
+                type: "object",
+                additionalProperties: false,
+                minProperties: 1,
+                properties: {
+                  eq: {
+                    description: "Equal to",
+                    anyOf: [
+                      {
+                        type: "string",
+                        maxLength: 4096
+                      },
+                      {
+                        type: "number"
+                      }
+                    ]
+                  },
+                  neq: {
+                    description: "Not equal",
+                    type: "string",
+                    maxLength: 4096
+                  },
+                  inc: {
+                    description: "In array",
+                    type: "array",
+                    items: {
+                      type: "string",
+                      maxLength: 4096
+                    }
+                  },
+                  ninc: {
+                    description: "Not in array",
+                    type: "array",
+                    items: {
+                      type: "string",
+                      maxLength: 4096
+                    }
+                  },
+                  pre: {
+                    description: "Starts with",
+                    type: "string",
+                    maxLength: 4096
+                  },
+                  suf: {
+                    description: "Ends with",
+                    type: "string",
+                    maxLength: 4096
+                  },
+                  gt: {
+                    description: "Greater than",
+                    type: "number"
+                  },
+                  gte: {
+                    description: "Greater than or equal to",
+                    type: "number"
+                  },
+                  lt: {
+                    description: "Less than",
+                    type: "number"
+                  },
+                  lte: {
+                    description: "Less than or equal to",
+                    type: "number"
+                  }
+                }
+              }
+            ]
+          }
+        }
+      },
+      args: {
+        description: "The arguments to the operation",
+        anyOf: [
+          {
+            type: "string",
+            maxLength: 4096
+          },
+          {
+            type: "array",
+            minItems: 1,
+            items: {
+              type: "string",
+              maxLength: 4096
+            }
+          }
+        ]
+      }
+    },
+    allOf: [
+      {
+        if: {
+          properties: {
+            op: {
+              enum: ["append", "set"]
+            }
+          }
+        },
+        then: {
+          required: ["args"]
+        }
+      },
+      {
+        if: {
+          allOf: [
+            {
+              properties: {
+                type: {
+                  enum: ["request.headers", "response.headers"]
+                }
+              }
+            },
+            {
+              properties: {
+                op: {
+                  enum: ["set", "append"]
+                }
+              }
+            }
+          ]
+        },
+        then: {
+          properties: {
+            target: {
+              properties: {
+                key: {
+                  if: {
+                    type: "string"
+                  },
+                  then: {
+                    pattern: "^[a-zA-Z0-9_-]+$"
+                  }
+                }
+              }
+            },
+            args: {
+              anyOf: [
+                {
+                  type: "string",
+                  pattern: "^[a-zA-Z0-9_ :;.,\"'?!(){}\\[\\]@<>=+*#$&`|~\\^%/-]+$"
+                },
+                {
+                  type: "array",
+                  items: {
+                    type: "string",
+                    pattern: "^[a-zA-Z0-9_ :;.,\"'?!(){}\\[\\]@<>=+*#$&`|~\\^%/-]+$"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    ]
+  }
+};
 const routesSchema = {
   type: "array",
   maxItems: 2048,
@@ -274,7 +463,8 @@ const routesSchema = {
           },
           has: hasSchema,
           missing: hasSchema,
-          mitigate: mitigateSchema
+          mitigate: mitigateSchema,
+          transforms: transformsSchema
         }
       },
       {

package/dist/types.d.ts

@@ -29,6 +29,25 @@ export type HasField = Array<{
     key: string;
     value?: MatchableValue;
 }>;
+type Transform = {
+    type: 'request.headers' | 'request.query' | 'response.headers';
+    op: 'append' | 'set' | 'delete';
+    target: {
+        key: string | {
+            eq?: string | number;
+            neq?: string;
+            inc?: string[];
+            ninc?: string[];
+            pre?: string;
+            suf?: string;
+            gt?: number;
+            gte?: number;
+            lt?: number;
+            lte?: number;
+        };
+    };
+    args?: string | string[];
+};
 export type RouteWithSrc = {
     src: string;
     dest?: string;
@@ -47,6 +66,7 @@ export type RouteWithSrc = {
     mitigate?: {
         action: MitigateAction;
     };
+    transforms?: Transform[];
     locale?: {
         redirect?: Record<string, string>;
         cookie?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/routing-utils",
-  "version": "5.0.6",
+  "version": "5.0.8",
   "description": "Vercel routing utilities",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",