@vercel/config 0.0.10 → 0.0.12

package/dist/cli.js

@@ -28,7 +28,22 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const fs_2 = require("fs");
 /**
- * Read the user's vercel.ts file (or fallback to router.config.ts for backwards compatibility)
+ * Named exports that should NOT be auto-converted to config
+ * (these are route-based features that compile into the routes array, or internal module properties)
+ */
+const ROUTE_BASED_EXPORTS = new Set([
+    'default',
+    'routes',
+    'redirects',
+    'rewrites',
+    'headers',
+    'crons',
+    'env',
+    'cacheControl',
+    '__esModule' // ES module metadata
+]);
+/**
+ * Read the user's vercel.ts file and collect both default export and export const declarations
  */
 async function configureRouter() {
     var _a;
@@ -36,8 +51,22 @@ async function configureRouter() {
     const routerConfigPath = (0, path_1.resolve)(process.cwd(), "router.config.ts");
     // Prefer vercel.ts, fallback to router.config.ts
     const configPath = (0, fs_2.existsSync)(vercelTsPath) ? vercelTsPath : routerConfigPath;
-    const routerConfig = (await (_a = configPath, Promise.resolve().then(() => __importStar(require(_a))))).default;
-    return routerConfig;
+    // Import the entire module to get both default and named exports
+    const module = await (_a = configPath, Promise.resolve().then(() => __importStar(require(_a))));
+    // Start with the default export (router.getConfig())
+    const routerConfig = module.default || {};
+    // Auto-collect all export const declarations (except route-based ones)
+    const exportedConstants = {};
+    for (const [key, value] of Object.entries(module)) {
+        if (!ROUTE_BASED_EXPORTS.has(key)) {
+            exportedConstants[key] = value;
+        }
+    }
+    // Merge: export const declarations take precedence over default export
+    return {
+        ...routerConfig,
+        ...exportedConstants
+    };
 }
 /**
  * Read existing vercel.json and extract fields to preserve

package/dist/router.d.ts

@@ -215,27 +215,28 @@ export interface Header {
 export interface TransformOptions {
     /**
      * Headers to set/modify on the incoming request.
-     * Use param() for path parameters and runtimeEnv() for environment variables.
+     * Sets the key and value if missing.
      *
      * @example
      * requestHeaders: {
-     *   'x-user-id': param('userId'),
-     *   'authorization': `Bearer ${runtimeEnv('API_TOKEN')}`
+     *   'x-user-id': userId,
+     *   'authorization': `Bearer ${env.API_TOKEN}`
      * }
      */
     requestHeaders?: Record<string, string | string[]>;
     /**
      * Headers to set/modify on the outgoing response.
-     * Use param() for path parameters and runtimeEnv() for environment variables.
+     * Sets the key and value if missing.
      *
      * @example
      * responseHeaders: {
-     *   'x-post-id': param('postId')
+     *   'x-post-id': postId
      * }
      */
     responseHeaders?: Record<string, string | string[]>;
     /**
      * Query parameters to set/modify on the request.
+     * Sets the key and value if missing.
      *
      * @example
      * requestQuery: {
@@ -243,6 +244,60 @@ export interface TransformOptions {
      * }
      */
     requestQuery?: Record<string, string | string[]>;
+    /**
+     * Headers to append to the incoming request.
+     * Appends args to the value of the key, and will set if missing.
+     *
+     * @example
+     * appendRequestHeaders: {
+     *   'x-custom': 'value'
+     * }
+     */
+    appendRequestHeaders?: Record<string, string | string[]>;
+    /**
+     * Headers to append to the outgoing response.
+     * Appends args to the value of the key, and will set if missing.
+     *
+     * @example
+     * appendResponseHeaders: {
+     *   'x-custom': 'value'
+     * }
+     */
+    appendResponseHeaders?: Record<string, string | string[]>;
+    /**
+     * Query parameters to append to the request.
+     * Appends args to the value of the key, and will set if missing.
+     *
+     * @example
+     * appendRequestQuery: {
+     *   'tag': 'value'
+     * }
+     */
+    appendRequestQuery?: Record<string, string | string[]>;
+    /**
+     * Headers to delete from the incoming request.
+     * Deletes the key entirely if args is not provided; otherwise, it will delete the value of args from the matching key.
+     *
+     * @example
+     * deleteRequestHeaders: ['x-remove-this', 'x-remove-that']
+     */
+    deleteRequestHeaders?: string[];
+    /**
+     * Headers to delete from the outgoing response.
+     * Deletes the key entirely if args is not provided; otherwise, it will delete the value of args from the matching key.
+     *
+     * @example
+     * deleteResponseHeaders: ['x-powered-by']
+     */
+    deleteResponseHeaders?: string[];
+    /**
+     * Query parameters to delete from the request.
+     * Deletes the key entirely if args is not provided; otherwise, it will delete the value of args from the matching key.
+     *
+     * @example
+     * deleteRequestQuery: ['debug', 'trace']
+     */
+    deleteRequestQuery?: string[];
 }
 /**
  * HeaderRule defines one or more headers to set for requests
@@ -429,6 +484,8 @@ export declare class Router {
     private extractEnvVars;
     /**
      * Internal helper to convert TransformOptions to Transform array
+     * @param options Transform options to convert
+     * @param trackedEnvVars Optional set of environment variables that were accessed via the env proxy
      */
     private transformOptionsToTransforms;
     /**
@@ -460,6 +517,12 @@ export declare class Router {
         requestHeaders?: Record<string, string | string[]>;
         responseHeaders?: Record<string, string | string[]>;
         requestQuery?: Record<string, string | string[]>;
+        appendRequestHeaders?: Record<string, string | string[]>;
+        appendResponseHeaders?: Record<string, string | string[]>;
+        appendRequestQuery?: Record<string, string | string[]>;
+        deleteRequestHeaders?: string[];
+        deleteResponseHeaders?: string[];
+        deleteRequestQuery?: string[];
     } | ((params: Record<string, string> & {
         env: any;
     }) => {
@@ -468,6 +531,12 @@ export declare class Router {
         requestHeaders?: Record<string, string | string[]>;
         responseHeaders?: Record<string, string | string[]>;
         requestQuery?: Record<string, string | string[]>;
+        appendRequestHeaders?: Record<string, string | string[]>;
+        appendResponseHeaders?: Record<string, string | string[]>;
+        appendRequestQuery?: Record<string, string | string[]>;
+        deleteRequestHeaders?: string[];
+        deleteResponseHeaders?: string[];
+        deleteRequestQuery?: string[];
     })): this;
     /**
      * Loads rewrite rules asynchronously and appends them.
@@ -509,6 +578,12 @@ export declare class Router {
         requestHeaders?: Record<string, string | string[]>;
         responseHeaders?: Record<string, string | string[]>;
         requestQuery?: Record<string, string | string[]>;
+        appendRequestHeaders?: Record<string, string | string[]>;
+        appendResponseHeaders?: Record<string, string | string[]>;
+        appendRequestQuery?: Record<string, string | string[]>;
+        deleteRequestHeaders?: string[];
+        deleteResponseHeaders?: string[];
+        deleteRequestQuery?: string[];
     } | ((params: Record<string, string> & {
         env: any;
     }) => {
@@ -519,6 +594,12 @@ export declare class Router {
         requestHeaders?: Record<string, string | string[]>;
         responseHeaders?: Record<string, string | string[]>;
         requestQuery?: Record<string, string | string[]>;
+        appendRequestHeaders?: Record<string, string | string[]>;
+        appendResponseHeaders?: Record<string, string | string[]>;
+        appendRequestQuery?: Record<string, string | string[]>;
+        deleteRequestHeaders?: string[];
+        deleteResponseHeaders?: string[];
+        deleteRequestQuery?: string[];
     })): this;
     /**
      * Loads redirect rules asynchronously and appends them.

package/dist/router.js

@@ -131,13 +131,26 @@ class Router {
     }
     /**
      * Internal helper to convert TransformOptions to Transform array
+     * @param options Transform options to convert
+     * @param trackedEnvVars Optional set of environment variables that were accessed via the env proxy
      */
-    transformOptionsToTransforms(options) {
+    transformOptionsToTransforms(options, trackedEnvVars) {
         const transforms = [];
-        // Convert requestHeaders
+        // Helper to get env vars for a value
+        const getEnvVars = (value) => {
+            if (trackedEnvVars) {
+                return Array.from(trackedEnvVars).filter(envVar => {
+                    const valueStr = Array.isArray(value) ? value.join(' ') : value;
+                    return valueStr.includes(`$${envVar}`);
+                });
+            }
+            return this.extractEnvVars(value);
+        };
+        // SET operations
+        // Convert requestHeaders (set)
         if (options.requestHeaders) {
             for (const [key, value] of Object.entries(options.requestHeaders)) {
-                const envVars = this.extractEnvVars(value);
+                const envVars = getEnvVars(value);
                 transforms.push({
                     type: 'request.headers',
                     op: 'set',
@@ -147,10 +160,10 @@ class Router {
                 });
             }
         }
-        // Convert responseHeaders
+        // Convert responseHeaders (set)
         if (options.responseHeaders) {
             for (const [key, value] of Object.entries(options.responseHeaders)) {
-                const envVars = this.extractEnvVars(value);
+                const envVars = getEnvVars(value);
                 transforms.push({
                     type: 'response.headers',
                     op: 'set',
@@ -160,10 +173,10 @@ class Router {
                 });
             }
         }
-        // Convert requestQuery
+        // Convert requestQuery (set)
         if (options.requestQuery) {
             for (const [key, value] of Object.entries(options.requestQuery)) {
-                const envVars = this.extractEnvVars(value);
+                const envVars = getEnvVars(value);
                 transforms.push({
                     type: 'request.query',
                     op: 'set',
@@ -173,6 +186,77 @@ class Router {
                 });
             }
         }
+        // APPEND operations
+        // Convert appendRequestHeaders
+        if (options.appendRequestHeaders) {
+            for (const [key, value] of Object.entries(options.appendRequestHeaders)) {
+                const envVars = getEnvVars(value);
+                transforms.push({
+                    type: 'request.headers',
+                    op: 'append',
+                    target: { key },
+                    args: value,
+                    ...(envVars.length > 0 && { env: envVars }),
+                });
+            }
+        }
+        // Convert appendResponseHeaders
+        if (options.appendResponseHeaders) {
+            for (const [key, value] of Object.entries(options.appendResponseHeaders)) {
+                const envVars = getEnvVars(value);
+                transforms.push({
+                    type: 'response.headers',
+                    op: 'append',
+                    target: { key },
+                    args: value,
+                    ...(envVars.length > 0 && { env: envVars }),
+                });
+            }
+        }
+        // Convert appendRequestQuery
+        if (options.appendRequestQuery) {
+            for (const [key, value] of Object.entries(options.appendRequestQuery)) {
+                const envVars = getEnvVars(value);
+                transforms.push({
+                    type: 'request.query',
+                    op: 'append',
+                    target: { key },
+                    args: value,
+                    ...(envVars.length > 0 && { env: envVars }),
+                });
+            }
+        }
+        // DELETE operations
+        // Convert deleteRequestHeaders
+        if (options.deleteRequestHeaders) {
+            for (const key of options.deleteRequestHeaders) {
+                transforms.push({
+                    type: 'request.headers',
+                    op: 'delete',
+                    target: { key },
+                });
+            }
+        }
+        // Convert deleteResponseHeaders
+        if (options.deleteResponseHeaders) {
+            for (const key of options.deleteResponseHeaders) {
+                transforms.push({
+                    type: 'response.headers',
+                    op: 'delete',
+                    target: { key },
+                });
+            }
+        }
+        // Convert deleteRequestQuery
+        if (options.deleteRequestQuery) {
+            for (const key of options.deleteRequestQuery) {
+                transforms.push({
+                    type: 'request.query',
+                    op: 'delete',
+                    target: { key },
+                });
+            }
+        }
         return transforms;
     }
     /**
@@ -202,10 +286,12 @@ class Router {
         this.validateSourcePattern(source);
         (0, validation_1.validateCaptureGroupReferences)(source, destination);
         let options;
+        let trackedEnvVars;
         // Handle callback syntax
         if (typeof optionsOrCallback === 'function') {
             const pathParams = this.extractPathParams(source);
-            const { proxy: envProxy } = this.createEnvProxy();
+            const { proxy: envProxy, accessedVars } = this.createEnvProxy();
+            trackedEnvVars = accessedVars;
             // Create params object with path parameters as $paramName
             const paramsObj = {};
             for (const param of pathParams) {
@@ -219,15 +305,24 @@ class Router {
             options = optionsOrCallback;
         }
         // Extract transform options
-        const { requestHeaders, responseHeaders, requestQuery, has, missing } = options || {};
+        const { requestHeaders, responseHeaders, requestQuery, appendRequestHeaders, appendResponseHeaders, appendRequestQuery, deleteRequestHeaders, deleteResponseHeaders, deleteRequestQuery, has, missing } = options || {};
         const transformOpts = {
             requestHeaders,
             responseHeaders,
             requestQuery,
+            appendRequestHeaders,
+            appendResponseHeaders,
+            appendRequestQuery,
+            deleteRequestHeaders,
+            deleteResponseHeaders,
+            deleteRequestQuery,
         };
         // Convert to transforms if any transform options provided
-        const transforms = requestHeaders || responseHeaders || requestQuery
-            ? this.transformOptionsToTransforms(transformOpts)
+        const hasTransforms = requestHeaders || responseHeaders || requestQuery ||
+            appendRequestHeaders || appendResponseHeaders || appendRequestQuery ||
+            deleteRequestHeaders || deleteResponseHeaders || deleteRequestQuery;
+        const transforms = hasTransforms
+            ? this.transformOptionsToTransforms(transformOpts, trackedEnvVars)
             : undefined;
         this.rewriteRules.push({
             source,
@@ -296,10 +391,12 @@ class Router {
         this.validateSourcePattern(source);
         (0, validation_1.validateCaptureGroupReferences)(source, destination);
         let options;
+        let trackedEnvVars;
         // Handle callback syntax
         if (typeof optionsOrCallback === 'function') {
             const pathParams = this.extractPathParams(source);
-            const { proxy: envProxy } = this.createEnvProxy();
+            const { proxy: envProxy, accessedVars } = this.createEnvProxy();
+            trackedEnvVars = accessedVars;
             // Create params object with path parameters as $paramName
             const paramsObj = {};
             for (const param of pathParams) {
@@ -313,15 +410,24 @@ class Router {
             options = optionsOrCallback;
         }
         // Extract transform options
-        const { requestHeaders, responseHeaders, requestQuery, permanent, statusCode, has, missing, } = options || {};
+        const { requestHeaders, responseHeaders, requestQuery, appendRequestHeaders, appendResponseHeaders, appendRequestQuery, deleteRequestHeaders, deleteResponseHeaders, deleteRequestQuery, permanent, statusCode, has, missing, } = options || {};
         // If transforms are provided, create a route instead of a redirect
-        if (requestHeaders || responseHeaders || requestQuery) {
+        const hasTransforms = requestHeaders || responseHeaders || requestQuery ||
+            appendRequestHeaders || appendResponseHeaders || appendRequestQuery ||
+            deleteRequestHeaders || deleteResponseHeaders || deleteRequestQuery;
+        if (hasTransforms) {
             const transformOpts = {
                 requestHeaders,
                 responseHeaders,
                 requestQuery,
+                appendRequestHeaders,
+                appendResponseHeaders,
+                appendRequestQuery,
+                deleteRequestHeaders,
+                deleteResponseHeaders,
+                deleteRequestQuery,
             };
-            const transforms = this.transformOptionsToTransforms(transformOpts);
+            const transforms = this.transformOptionsToTransforms(transformOpts, trackedEnvVars);
             this.routeRules.push({
                 src: source,
                 dest: destination,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/config",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "A TypeScript SDK for programmatically generating Vercel configuration files",
   "bugs": {
     "url": "https://github.com/vercel/router-sdk/issues"