@utoo/pack-shared 1.3.0 → 1.3.2-alpha.0

package/cjs/config.d.ts

@@ -69,6 +69,45 @@ export type TurbopackRuleConfigCollection = TurbopackRuleConfigItem | (Turbopack
 export interface ModuleOptions {
     rules?: Record<string, TurbopackRuleConfigCollection>;
 }
+/**
+ * Path rewrite: object form applies first matching regex→replacement;
+ * function form receives path and returns new path (sync only).
+ */
+export type PathRewrite = {
+    [regexp: string]: string;
+} | ((path: string) => string);
+/**
+ * Proxy rule for dev server HTTP/WS proxying.
+ * Mostly aligned with webpack-dev-server / http-proxy-middleware options.
+ */
+export interface ProxyRule {
+    /**
+     * Path(s) to match for proxying.
+     * When starts with `^`, will be treated as RegExp source.
+     * Otherwise, simple prefix match is used.
+     */
+    context: string | string[];
+    /** Target server URL. */
+    target: string;
+    /**
+     * Path rewrite. Object: first matching regex is replaced (http-proxy-middleware style).
+     * Function: (path) => new path.
+     */
+    pathRewrite?: PathRewrite;
+    /**
+     * Whether to change the Host header to match the target.
+     * Defaults to true.
+     */
+    changeOrigin?: boolean;
+    /**
+     * Whether to verify the SSL certificate of the target.
+     * Set to false to accept self-signed certificates.
+     */
+    secure?: boolean;
+}
+export type DevServerProxy = ProxyRule[];
+/** Object style proxy options without `context`. */
+export type ProxyOptions = Omit<ProxyRule, "context">;
 export interface ResolveOptions {
     alias?: Record<string, string | string[] | Record<string, string | string[]>>;
     extensions?: string[];
@@ -108,6 +147,8 @@ export interface DevServerConfig {
     host?: string;
     /** Use HTTPS; when true without a certificate, a self-signed cert may be generated. */
     https?: boolean;
+    /** HTTP proxy rules for Hono dev server (HTTP only; no generic WS proxy in this layer). */
+    proxy?: DevServerProxy;
 }
 export interface ConfigComplete {
     entry: EntryOptions[];

package/cjs/utils.d.ts

@@ -1,4 +1,4 @@
-import { RustifiedEnv } from "./config";
+import { DevServerProxy, ProxyOptions, RustifiedEnv } from "./config";
 import { Issue } from "./issue";
 export declare class ModuleBuildError extends Error {
     name: string;
@@ -9,6 +9,19 @@ export interface ResultWithIssues {
 export declare function processIssues(result: ResultWithIssues, throwIssue: boolean, logErrors: boolean): void;
 export declare function isWellKnownError(issue: Issue): boolean;
 export declare function rustifyEnv(env: Record<string, string>): RustifiedEnv;
+/**
+ * Convert object-style proxy config into DevServerProxy array.
+ * Object keys become context; string value → target + default changeOrigin; object value merged into ProxyRule.
+ *
+ * @example
+ * proxy: [
+ *   ...proxyFromObject({
+ *     "/api": "http://localhost:3000",
+ *     "/auth": { target: "http://localhost:5000", changeOrigin: true },
+ *   }),
+ * ];
+ */
+export declare function proxyFromObject(obj: Record<string, string | ProxyOptions>): DevServerProxy;
 type AnyFunc<T> = (this: T, ...args: any) => any;
 export declare function debounce<T, F extends AnyFunc<T>>(fn: F, ms: number, maxWait?: number): (this: T, ...passedArgs: Parameters<F>) => void;
 export {};

package/cjs/utils.js

@@ -4,6 +4,7 @@ exports.ModuleBuildError = void 0;
 exports.processIssues = processIssues;
 exports.isWellKnownError = isWellKnownError;
 exports.rustifyEnv = rustifyEnv;
+exports.proxyFromObject = proxyFromObject;
 exports.debounce = debounce;
 const issue_1 = require("./issue");
 const styledString_1 = require("./styledString");
@@ -55,6 +56,40 @@ function rustifyEnv(env) {
         value,
     }));
 }
+/**
+ * Convert object-style proxy config into DevServerProxy array.
+ * Object keys become context; string value → target + default changeOrigin; object value merged into ProxyRule.
+ *
+ * @example
+ * proxy: [
+ *   ...proxyFromObject({
+ *     "/api": "http://localhost:3000",
+ *     "/auth": { target: "http://localhost:5000", changeOrigin: true },
+ *   }),
+ * ];
+ */
+function proxyFromObject(obj) {
+    const rules = [];
+    for (const [context, value] of Object.entries(obj)) {
+        if (!value)
+            continue;
+        if (typeof value === "string") {
+            rules.push({
+                context,
+                target: value,
+                changeOrigin: true,
+            });
+        }
+        else {
+            rules.push({
+                context,
+                changeOrigin: true,
+                ...value,
+            });
+        }
+    }
+    return rules;
+}
 function debounce(fn, ms, maxWait = Infinity) {
     let timeoutId;
     // The time the debouncing function was first called during this debounce queue.

package/esm/config.d.ts

@@ -69,6 +69,45 @@ export type TurbopackRuleConfigCollection = TurbopackRuleConfigItem | (Turbopack
 export interface ModuleOptions {
     rules?: Record<string, TurbopackRuleConfigCollection>;
 }
+/**
+ * Path rewrite: object form applies first matching regex→replacement;
+ * function form receives path and returns new path (sync only).
+ */
+export type PathRewrite = {
+    [regexp: string]: string;
+} | ((path: string) => string);
+/**
+ * Proxy rule for dev server HTTP/WS proxying.
+ * Mostly aligned with webpack-dev-server / http-proxy-middleware options.
+ */
+export interface ProxyRule {
+    /**
+     * Path(s) to match for proxying.
+     * When starts with `^`, will be treated as RegExp source.
+     * Otherwise, simple prefix match is used.
+     */
+    context: string | string[];
+    /** Target server URL. */
+    target: string;
+    /**
+     * Path rewrite. Object: first matching regex is replaced (http-proxy-middleware style).
+     * Function: (path) => new path.
+     */
+    pathRewrite?: PathRewrite;
+    /**
+     * Whether to change the Host header to match the target.
+     * Defaults to true.
+     */
+    changeOrigin?: boolean;
+    /**
+     * Whether to verify the SSL certificate of the target.
+     * Set to false to accept self-signed certificates.
+     */
+    secure?: boolean;
+}
+export type DevServerProxy = ProxyRule[];
+/** Object style proxy options without `context`. */
+export type ProxyOptions = Omit<ProxyRule, "context">;
 export interface ResolveOptions {
     alias?: Record<string, string | string[] | Record<string, string | string[]>>;
     extensions?: string[];
@@ -108,6 +147,8 @@ export interface DevServerConfig {
     host?: string;
     /** Use HTTPS; when true without a certificate, a self-signed cert may be generated. */
     https?: boolean;
+    /** HTTP proxy rules for Hono dev server (HTTP only; no generic WS proxy in this layer). */
+    proxy?: DevServerProxy;
 }
 export interface ConfigComplete {
     entry: EntryOptions[];

package/esm/utils.d.ts

@@ -1,4 +1,4 @@
-import { RustifiedEnv } from "./config";
+import { DevServerProxy, ProxyOptions, RustifiedEnv } from "./config";
 import { Issue } from "./issue";
 export declare class ModuleBuildError extends Error {
     name: string;
@@ -9,6 +9,19 @@ export interface ResultWithIssues {
 export declare function processIssues(result: ResultWithIssues, throwIssue: boolean, logErrors: boolean): void;
 export declare function isWellKnownError(issue: Issue): boolean;
 export declare function rustifyEnv(env: Record<string, string>): RustifiedEnv;
+/**
+ * Convert object-style proxy config into DevServerProxy array.
+ * Object keys become context; string value → target + default changeOrigin; object value merged into ProxyRule.
+ *
+ * @example
+ * proxy: [
+ *   ...proxyFromObject({
+ *     "/api": "http://localhost:3000",
+ *     "/auth": { target: "http://localhost:5000", changeOrigin: true },
+ *   }),
+ * ];
+ */
+export declare function proxyFromObject(obj: Record<string, string | ProxyOptions>): DevServerProxy;
 type AnyFunc<T> = (this: T, ...args: any) => any;
 export declare function debounce<T, F extends AnyFunc<T>>(fn: F, ms: number, maxWait?: number): (this: T, ...passedArgs: Parameters<F>) => void;
 export {};

package/esm/utils.js

@@ -47,6 +47,40 @@ export function rustifyEnv(env) {
         value,
     }));
 }
+/**
+ * Convert object-style proxy config into DevServerProxy array.
+ * Object keys become context; string value → target + default changeOrigin; object value merged into ProxyRule.
+ *
+ * @example
+ * proxy: [
+ *   ...proxyFromObject({
+ *     "/api": "http://localhost:3000",
+ *     "/auth": { target: "http://localhost:5000", changeOrigin: true },
+ *   }),
+ * ];
+ */
+export function proxyFromObject(obj) {
+    const rules = [];
+    for (const [context, value] of Object.entries(obj)) {
+        if (!value)
+            continue;
+        if (typeof value === "string") {
+            rules.push({
+                context,
+                target: value,
+                changeOrigin: true,
+            });
+        }
+        else {
+            rules.push({
+                context,
+                changeOrigin: true,
+                ...value,
+            });
+        }
+    }
+    return rules;
+}
 export function debounce(fn, ms, maxWait = Infinity) {
     let timeoutId;
     // The time the debouncing function was first called during this debounce queue.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/pack-shared",
-  "version": "1.3.0",
+  "version": "1.3.2-alpha.0",
   "main": "cjs/index.js",
   "module": "esm/index.js",
   "types": "esm/index.d.ts",